From 1854d0ec377d6032617c09d2bd31fa0866764744 Mon Sep 17 00:00:00 2001 From: drdani Date: Mon, 7 Feb 2000 08:07:02 +0000 Subject: [PATCH] ucsim-0.2.37-pre3 into cvs git-svn-id: https://sdcc.svn.sourceforge.net/svnroot/sdcc/trunk/sdcc@79 4a8a32a2-be11-0410-ad9d-d568d2c75423 --- sim/ucsim/cmd.src/(c).1 | 25 + sim/ucsim/cmd.src/Makefile.in | 117 ++++ sim/ucsim/cmd.src/bp.cc | 119 ++++ sim/ucsim/cmd.src/clean.mk | 23 + sim/ucsim/cmd.src/cmdset.cc | 467 ++++++++++++++ sim/ucsim/cmd.src/cmdsetcl.h | 340 ++++++++++ sim/ucsim/cmd.src/cmdutil.cc | 286 ++++++++ sim/ucsim/cmd.src/cmdutil.h | 50 ++ sim/ucsim/cmd.src/conf.mk | 10 + sim/ucsim/cmd.src/get.cc | 79 +++ sim/ucsim/cmd.src/info.cc | 156 +++++ sim/ucsim/cmd.src/infocl.h | 73 +++ sim/ucsim/cmd.src/newcmd.cc | 1112 ++++++++++++++++++++++++++++++++ sim/ucsim/cmd.src/newcmdcl.h | 229 +++++++ sim/ucsim/cmd.src/set.cc | 73 +++ sim/ucsim/cmd.src/syntax.cc | 31 + sim/ucsim/cmd.src/syntaxcl.h | 33 + sim/ucsim/cmd.src/timer.cc | 266 ++++++++ sim/ucsim/doc/Makefile.in | 79 +++ sim/ucsim/doc/UCsim.jpg | Bin 0 -> 5540 bytes sim/ucsim/doc/analyzer.html | 35 + sim/ucsim/doc/burst.gif | Bin 0 -> 235 bytes sim/ucsim/doc/clean.mk | 22 + sim/ucsim/doc/cmd.html | 90 +++ sim/ucsim/doc/cmd_bp.html | 206 ++++++ sim/ucsim/doc/cmd_dump.html | 390 +++++++++++ sim/ucsim/doc/cmd_exec.html | 227 +++++++ sim/ucsim/doc/cmd_general.html | 659 +++++++++++++++++++ sim/ucsim/doc/cmd_set.html | 203 ++++++ sim/ucsim/doc/commref.html | 83 +++ sim/ucsim/doc/conf.mk | 10 + sim/ucsim/doc/cpu.gif | Bin 0 -> 12757 bytes sim/ucsim/doc/cpu.html | 59 ++ sim/ucsim/doc/cpu_types.html | 184 ++++++ sim/ucsim/doc/index.html | 156 +++++ sim/ucsim/doc/interrupt.gif | Bin 0 -> 12432 bytes sim/ucsim/doc/interrupt.html | 27 + sim/ucsim/doc/invoke.html | 124 ++++ sim/ucsim/doc/mulcons.html | 115 ++++ sim/ucsim/doc/new.gif | Bin 0 -> 161 bytes sim/ucsim/doc/obsolete.html | 25 + sim/ucsim/doc/post.jpg | Bin 0 -> 1016 bytes sim/ucsim/doc/serial.html | 135 ++++ sim/ucsim/doc/serial1.fig | 53 ++ sim/ucsim/doc/serial1.gif | Bin 0 -> 3078 bytes sim/ucsim/doc/serial2.fig | 97 +++ sim/ucsim/doc/serial2.gif | Bin 0 -> 6260 bytes sim/ucsim/doc/term_cpuopt.gif | Bin 0 -> 9601 bytes sim/ucsim/doc/term_cpuopt.html | 27 + sim/ucsim/doc/timers.gif | Bin 0 -> 13166 bytes sim/ucsim/doc/timers.html | 22 + sim/ucsim/doc/wins.gif | Bin 0 -> 18016 bytes sim/ucsim/doc/wins.html | 21 + sim/ucsim/gui.src/(c).1 | 25 + sim/ucsim/gui.src/Makefile.in | 141 ++++ sim/ucsim/gui.src/a.cc | 87 +++ sim/ucsim/gui.src/app.cc | 171 +++++ sim/ucsim/gui.src/appcl.h | 54 ++ sim/ucsim/gui.src/bg.cc | 63 ++ sim/ucsim/gui.src/bgcl.h | 47 ++ sim/ucsim/gui.src/clean.mk | 45 ++ sim/ucsim/gui.src/conf.mk | 12 + sim/ucsim/gui.src/desk.cc | 58 ++ sim/ucsim/gui.src/deskcl.h | 42 ++ sim/ucsim/gui.src/event.cc | 126 ++++ sim/ucsim/gui.src/eventcl.h | 96 +++ sim/ucsim/gui.src/frame.cc | 76 +++ sim/ucsim/gui.src/framecl.h | 48 ++ sim/ucsim/gui.src/group.cc | 393 +++++++++++ sim/ucsim/gui.src/groupcl.h | 70 ++ sim/ucsim/gui.src/label.cc | 74 +++ sim/ucsim/gui.src/labelcl.h | 50 ++ sim/ucsim/gui.src/palette.h | 44 ++ sim/ucsim/gui.src/view.cc | 356 ++++++++++ sim/ucsim/gui.src/viewcl.h | 118 ++++ sim/ucsim/gui.src/win.cc | 111 ++++ sim/ucsim/gui.src/wincl.h | 55 ++ 77 files changed, 8900 insertions(+) create mode 100644 sim/ucsim/cmd.src/(c).1 create mode 100644 sim/ucsim/cmd.src/Makefile.in create mode 100644 sim/ucsim/cmd.src/bp.cc create mode 100644 sim/ucsim/cmd.src/clean.mk create mode 100644 sim/ucsim/cmd.src/cmdset.cc create mode 100644 sim/ucsim/cmd.src/cmdsetcl.h create mode 100644 sim/ucsim/cmd.src/cmdutil.cc create mode 100644 sim/ucsim/cmd.src/cmdutil.h create mode 100644 sim/ucsim/cmd.src/conf.mk create mode 100644 sim/ucsim/cmd.src/get.cc create mode 100644 sim/ucsim/cmd.src/info.cc create mode 100644 sim/ucsim/cmd.src/infocl.h create mode 100644 sim/ucsim/cmd.src/newcmd.cc create mode 100644 sim/ucsim/cmd.src/newcmdcl.h create mode 100644 sim/ucsim/cmd.src/set.cc create mode 100644 sim/ucsim/cmd.src/syntax.cc create mode 100644 sim/ucsim/cmd.src/syntaxcl.h create mode 100644 sim/ucsim/cmd.src/timer.cc create mode 100644 sim/ucsim/doc/Makefile.in create mode 100644 sim/ucsim/doc/UCsim.jpg create mode 100644 sim/ucsim/doc/analyzer.html create mode 100644 sim/ucsim/doc/burst.gif create mode 100644 sim/ucsim/doc/clean.mk create mode 100644 sim/ucsim/doc/cmd.html create mode 100644 sim/ucsim/doc/cmd_bp.html create mode 100644 sim/ucsim/doc/cmd_dump.html create mode 100644 sim/ucsim/doc/cmd_exec.html create mode 100644 sim/ucsim/doc/cmd_general.html create mode 100644 sim/ucsim/doc/cmd_set.html create mode 100644 sim/ucsim/doc/commref.html create mode 100644 sim/ucsim/doc/conf.mk create mode 100644 sim/ucsim/doc/cpu.gif create mode 100644 sim/ucsim/doc/cpu.html create mode 100644 sim/ucsim/doc/cpu_types.html create mode 100644 sim/ucsim/doc/index.html create mode 100644 sim/ucsim/doc/interrupt.gif create mode 100644 sim/ucsim/doc/interrupt.html create mode 100644 sim/ucsim/doc/invoke.html create mode 100644 sim/ucsim/doc/mulcons.html create mode 100644 sim/ucsim/doc/new.gif create mode 100644 sim/ucsim/doc/obsolete.html create mode 100644 sim/ucsim/doc/post.jpg create mode 100644 sim/ucsim/doc/serial.html create mode 100644 sim/ucsim/doc/serial1.fig create mode 100644 sim/ucsim/doc/serial1.gif create mode 100644 sim/ucsim/doc/serial2.fig create mode 100644 sim/ucsim/doc/serial2.gif create mode 100644 sim/ucsim/doc/term_cpuopt.gif create mode 100644 sim/ucsim/doc/term_cpuopt.html create mode 100644 sim/ucsim/doc/timers.gif create mode 100644 sim/ucsim/doc/timers.html create mode 100644 sim/ucsim/doc/wins.gif create mode 100644 sim/ucsim/doc/wins.html create mode 100644 sim/ucsim/gui.src/(c).1 create mode 100644 sim/ucsim/gui.src/Makefile.in create mode 100644 sim/ucsim/gui.src/a.cc create mode 100644 sim/ucsim/gui.src/app.cc create mode 100644 sim/ucsim/gui.src/appcl.h create mode 100644 sim/ucsim/gui.src/bg.cc create mode 100644 sim/ucsim/gui.src/bgcl.h create mode 100644 sim/ucsim/gui.src/clean.mk create mode 100644 sim/ucsim/gui.src/conf.mk create mode 100644 sim/ucsim/gui.src/desk.cc create mode 100644 sim/ucsim/gui.src/deskcl.h create mode 100644 sim/ucsim/gui.src/event.cc create mode 100644 sim/ucsim/gui.src/eventcl.h create mode 100644 sim/ucsim/gui.src/frame.cc create mode 100644 sim/ucsim/gui.src/framecl.h create mode 100644 sim/ucsim/gui.src/group.cc create mode 100644 sim/ucsim/gui.src/groupcl.h create mode 100644 sim/ucsim/gui.src/label.cc create mode 100644 sim/ucsim/gui.src/labelcl.h create mode 100644 sim/ucsim/gui.src/palette.h create mode 100644 sim/ucsim/gui.src/view.cc create mode 100644 sim/ucsim/gui.src/viewcl.h create mode 100644 sim/ucsim/gui.src/win.cc create mode 100644 sim/ucsim/gui.src/wincl.h diff --git a/sim/ucsim/cmd.src/(c).1 b/sim/ucsim/cmd.src/(c).1 new file mode 100644 index 00000000..d673f9fd --- /dev/null +++ b/sim/ucsim/cmd.src/(c).1 @@ -0,0 +1,25 @@ +/* + * Simulator of microcontrollers (@@F@@) + * + * Copyright (C) @@S@@,@@Y@@ Drotos Daniel, Talker Bt. + * + * To contact author send email to drdani@mazsola.iit.uni-miskolc.hu + * + */ + +/* This file is part of microcontroller simulator: ucsim. + +UCSIM is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. + +UCSIM is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with UCSIM; see the file COPYING. If not, write to the Free +Software Foundation, 59 Temple Place - Suite 330, Boston, MA +02111-1307, USA. */ diff --git a/sim/ucsim/cmd.src/Makefile.in b/sim/ucsim/cmd.src/Makefile.in new file mode 100644 index 00000000..09344f23 --- /dev/null +++ b/sim/ucsim/cmd.src/Makefile.in @@ -0,0 +1,117 @@ +# +# S51 mcs51/Makefile +# +# (c) Drotos Daniel, Talker Bt. 1997 +# + +STARTYEAR = 1997 + +SHELL = /bin/sh +CXX = @CXX@ +CPP = @CPP@ +CXXCPP = @CXXCPP@ +RANLIB = @RANLIB@ +INSTALL = @INSTALL@ + +PRJDIR = .. + +DEFS = $(subs -DHAVE_CONFIG_H,,@DEFS@) +CPPFLAGS = @CPPFLAGS@ -I. -I$(PRJDIR) \ + -I$(PRJDIR)/sim.src +CFLAGS = @CFLAGS@ -Wall +CXXFLAGS = @CXXFLAGS@ -Wall +M_OR_MM = @M_OR_MM@ + +prefix = @prefix@ +exec_prefix = @exec_prefix@ +bindir = @bindir@ +libdir = @libdir@ +datadir = @datadir@ +includedir = @includedir@ +mandir = @mandir@ +man1dir = $(mandir)/man1 +man2dir = $(mandir)/man2 +infodir = @infodir@ +srcdir = @srcdir@ + +OBJECTS = newcmd.o cmdutil.o cmdset.o syntax.o \ + get.o set.o timer.o bp.o info.o + + +# Compiling entire program or any subproject +# ------------------------------------------ +all: checkconf cmdlib + +cmd.src: all + + +# Compiling and installing everything and runing test +# --------------------------------------------------- +install: all installdirs + + +# Deleting all the installed files +# -------------------------------- +uninstall: + + +# Performing self-test +# -------------------- +check: + + +# Performing installation test +# ---------------------------- +installcheck: + + +# Creating installation directories +# --------------------------------- +installdirs: + + +# Creating dependencies +# --------------------- +dep: Makefile.dep + +Makefile.dep: *.cc *.h + $(CXXCPP) $(CPPFLAGS) $(M_OR_MM) *.cc >Makefile.dep + +include Makefile.dep +include clean.mk + +#parser.cc: parser.y + +#plex.cc: plex.l + +# My rules +# -------- + +cmdlib: $(PRJDIR)/libcmd.a + +$(PRJDIR)/libcmd.a: $(OBJECTS) + ar -rcu $*.a $(OBJECTS) + $(RANLIB) $*.a + +.cc.o: + $(CXX) $(CXXFLAGS) $(CPPFLAGS) $(TARGET_ARCH) -c $< -o $@ + +.y.cc: + rm -f $*.cc $*.h + $(YACC) -d $< + mv y.tab.c $*.cc + mv y.tab.h $*.h + +.l.cc: + rm -f $*.cc + $(LEX) -t $< >$*.cc + + +# Remaking configuration +# ---------------------- +checkconf: + @if [ -f $(PRJDIR)/devel ]; then\ + $(MAKE) -f conf.mk srcdir="$(srcdir)" PRJDIR="$(PRJDIR)" freshconf;\ + fi + +# End of mcs51/Makefile.in diff --git a/sim/ucsim/cmd.src/bp.cc b/sim/ucsim/cmd.src/bp.cc new file mode 100644 index 00000000..e2d6fd13 --- /dev/null +++ b/sim/ucsim/cmd.src/bp.cc @@ -0,0 +1,119 @@ +/* + * Simulator of microcontrollers (bp.cc) + * + * Copyright (C) 1999,99 Drotos Daniel, Talker Bt. + * + * To contact author send email to drdani@mazsola.iit.uni-miskolc.hu + * + */ + +/* This file is part of microcontroller simulator: ucsim. + +UCSIM is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. + +UCSIM is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with UCSIM; see the file COPYING. If not, write to the Free +Software Foundation, 59 Temple Place - Suite 330, Boston, MA +02111-1307, USA. */ +/*@1@*/ + +#include "ddconfig.h" + +#include "stdlib.h" + +// sim +#include "brkcl.h" +#include "argcl.h" +#include "simcl.h" + +// cmd +#include "cmdsetcl.h" + + +/* + * BREAK command + */ + +int +cl_break_cmd::do_work(class cl_cmdline *cmdline, class cl_console *con) +{ + long addr; + int hit= 1; + class cl_cmd_arg *params[2]= { cmdline->param(0), + cmdline->param(1) }; + + if (params[0] == 0) + { + con->printf("Address is missing.\n"); + return(FALSE); + } + addr= (params[0])->get_address(); + if (params[1]) + hit= (params[1])->get_ivalue(); + if (hit > 99999) + { + con->printf("Hit value %d is too big.\n", hit); + return(0); + } + if (sim->uc->fbrk->bp_at(addr)) + con->printf("Breakpoint at 0x%06x is already set.\n", addr); + else + { + class cl_brk *b= new cl_fetch_brk(sim->uc->fbrk->make_new_nr(), + addr, perm, hit); + b->init(); + sim->uc->fbrk->add_bp(b); + char *s= sim->uc->disass(addr, NULL); + con->printf("Breakpoint %d at 0x%06x: %s\n", b->nr, addr, s); + free(s); + } + return(0); +} + + +/* + * CLEAR address + */ + +int +cl_clear_cmd::do_work(class cl_cmdline *cmdline, class cl_console *con) +{ + uint addr; + int idx; + class cl_brk *brk= sim->uc->fbrk->get_bp(sim->uc->PC, &idx); + + if (cmdline->param(0) == 0) + { + if (!brk) + { + con->printf("No breakpoint at this address.\n"); + return(0); + } + sim->uc->fbrk->del_bp(sim->uc->PC); + return(0); + } + + int i= 0; + class cl_cmd_arg *param; + while ((param= cmdline->param(i++))) + { + addr= param->get_ivalue(); + if (sim->uc->fbrk->bp_at(addr) == 0) + sim->cmd->printf("No breakpoint at 0x%06x\n", addr); + else + sim->uc->fbrk->del_bp(addr); + } + + return(0); +} + + +/* End of bp.cc */ diff --git a/sim/ucsim/cmd.src/clean.mk b/sim/ucsim/cmd.src/clean.mk new file mode 100644 index 00000000..68b48723 --- /dev/null +++ b/sim/ucsim/cmd.src/clean.mk @@ -0,0 +1,23 @@ +# Deleting all files created by building the program +# -------------------------------------------------- +clean: + rm -f *core *[%~] *.[oa] + rm -f .[a-z]*~ + + +# Deleting all files created by configuring or building the program +# ----------------------------------------------------------------- +distclean: clean + rm -f config.cache config.log config.status + rm -f Makefile *.dep + + +# Like clean but some files may still exist +# ----------------------------------------- +mostlyclean: clean + + +# Deleting everything that can reconstructed by this Makefile. It deletes +# everything deleted by distclean plus files created by bison, etc. +# ----------------------------------------------------------------------- +realclean: distclean diff --git a/sim/ucsim/cmd.src/cmdset.cc b/sim/ucsim/cmd.src/cmdset.cc new file mode 100644 index 00000000..8a659f68 --- /dev/null +++ b/sim/ucsim/cmd.src/cmdset.cc @@ -0,0 +1,467 @@ +/* + * Simulator of microcontrollers (cmdset.cc) + * + * Copyright (C) 1999,99 Drotos Daniel, Talker Bt. + * + * To contact author send email to drdani@mazsola.iit.uni-miskolc.hu + * + */ + +/* This file is part of microcontroller simulator: ucsim. + +UCSIM is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. + +UCSIM is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with UCSIM; see the file COPYING. If not, write to the Free +Software Foundation, 59 Temple Place - Suite 330, Boston, MA +02111-1307, USA. */ +/*@1@*/ + +#include "ddconfig.h" + +#include "i_string.h" + +#include "globals.h" +#include "utils.h" + +// sim +#include "simcl.h" + +// local +#include "cmdsetcl.h" + + +/* + * Command: conf + *---------------------------------------------------------------------------- + */ + +int +cl_conf_cmd::do_work(class cl_cmdline *cmdline, class cl_console *con) +{ + int i; + + con->printf("ucsim version %s\n", VERSIONSTR); + con->printf("Type of microcontroller: %s\n", sim->uc->id_string()); + con->printf("Controller has %d hardware element(s).\n", + sim->uc->hws->count); + for (i= 0; i < sim->uc->hws->count; i++) + { + class cl_hw *hw= (class cl_hw *)(sim->uc->hws->at(i)); + con->printf(" %s[%d]\n", hw->id_string, hw->id); + } + con->printf("Memories:\n"); + for (i= MEM_ROM; i < MEM_TYPES; i++) + { + class cl_mem *mem= (class cl_mem *)(sim->uc->mems->at(i)); + if (mem) + con->printf(" %s size= 0x%06x %d\n", + mem->id_string(), mem->size, mem->size); + } + return(0); +} + + +/* + * Command: state + *---------------------------------------------------------------------------- + */ + +int +cl_state_cmd::do_work(class cl_cmdline *cmdline, class cl_console *con) +{ + //con->printf("sim state= %d\n", sim->state); + con->printf("CPU state= %s PC= 0x%06x XTAL= %g\n", + get_id_string(cpu_states, sim->uc->state), + sim->uc->PC, + sim->uc->xtal); + con->printf("Total time since last reset= %g sec (%lu clks)\n", + sim->uc->get_rtime(), sim->uc->ticks->ticks); + con->printf("Time in isr = %g sec (%lu clks) %3.2g%%\n", + sim->uc->isr_ticks->get_rtime(sim->uc->xtal), + sim->uc->isr_ticks->ticks, + (sim->uc->ticks->ticks == 0)?0.0: + (100.0*((double)(sim->uc->isr_ticks->ticks)/ + (double)(sim->uc->ticks->ticks)))); + con->printf("Time in idle= %g sec (%lu clks) %3.2g%%\n", + sim->uc->idle_ticks->get_rtime(sim->uc->xtal), + sim->uc->idle_ticks->ticks, + (sim->uc->ticks->ticks == 0)?0.0: + (100.0*((double)(sim->uc->idle_ticks->ticks)/ + (double)(sim->uc->ticks->ticks)))); + con->printf("Max value of stack pointer= 0x%06x, avg= 0x%06x\n", + sim->uc->sp_max, sim->uc->sp_avg); + return(0); +} + + +/* + * Command: file + *---------------------------------------------------------------------------- + */ + +int +cl_file_cmd::do_work(class cl_cmdline *cmdline, class cl_console *con) +{ + char *fname; + long l; + + if ((cmdline->param(0) == 0) || + ((fname= cmdline->param(0)->get_svalue()) == NULL)) + { + con->printf("File name is missing.\n"); + return(0); + } + if ((l= sim->uc->read_hex_file(fname)) >= 0) + con->printf("%ld words read from %s\n", l, fname); + + return(0); +} + + +/* + * Command: download + *---------------------------------------------------------------------------- + */ + +int +cl_dl_cmd::do_work(class cl_cmdline *cmdline, class cl_console *con) +{ + long l; + + if ((l= sim->uc->read_hex_file(NULL)) >= 0) + con->printf("%ld words loaded\n", l); + + return(0); +} + + +/* + * Command: get + *---------------------------------------------------------------------------- + */ + +int +cl_get_cmd::do_work(class cl_cmdline *cmdline, class cl_console *con) +{ + char *s; + + if (cmdline->param(0) == 0) + { + con->printf("Get what?\n"); + return(0); + } + if ((s= cmdline->param(0)->get_svalue())) + { + if (strstr(s, "t") == s) + return(timer(cmdline, con)); + else + con->printf("Unknow keyword of get command\n"); + } + return(0); +} + + +/* + * Command: set + *---------------------------------------------------------------------------- + */ + + +int +cl_set_cmd::do_work(class cl_cmdline *cmdline, class cl_console *con) +{ + char *s; + + if (cmdline->param(0) == 0) + { + con->printf("Set what?\n"); + return(0); + } + if ((s= cmdline->param(0)->get_svalue())) + { + if (strstr(s, "t") == s) + return(timer(cmdline, con)); + else + con->printf("Unknow keyword of set command\n"); + } + return(0); +} + + +/* + * Command: run + *---------------------------------------------------------------------------- + */ + + +int +cl_run_cmd::do_work(class cl_cmdline *cmdline, class cl_console *con) +{ + sim->start(con); + return(0); +} + + +/* + * Command: step + *---------------------------------------------------------------------------- + */ + + +int +cl_step_cmd::do_work(class cl_cmdline *cmdline, class cl_console *con) +{ + sim->uc->do_inst(1); + sim->uc->print_regs(con); + return(0); +} + + +/* + * Command: reset + *---------------------------------------------------------------------------- + */ + + +int +cl_reset_cmd::do_work(class cl_cmdline *cmdline, class cl_console *con) +{ + sim->uc->reset(); + return(0); +} + + +/* + * Command: dump + *---------------------------------------------------------------------------- + */ + +int +cl_dump_cmd::do_work(class cl_cmdline *cmdline, class cl_console *con) +{ + class cl_mem *mem; + char *s; + long l, start= -1, end= 10*8-1, bpl= 8; + class cl_cmd_arg *params[4]= { cmdline->param(0), + cmdline->param(1), + cmdline->param(2), + cmdline->param(3) }; + + if (params[0] == 0) + { + con->printf("Memory type missing\n"); + return(0); + } + if ((s= params[0]->get_svalue())) + { + if (strstr(s, "i") == s) + mem= sim->uc->mem(MEM_IRAM); + else if (strstr(s, "x") == s) + mem= sim->uc->mem(MEM_XRAM); + else if (strstr(s, "r") == s) + mem= sim->uc->mem(MEM_ROM); + else if (strstr(s, "s") == s) + mem= sim->uc->mem(MEM_SFR); + else + { + con->printf("Unknown memory type\n"); + return(0); + } + if (!mem) + { + con->printf("No such memory\n"); + return(0); + } + } + else + { + con->printf("Wrong memory type\n"); + return(0); + } + + if (params[1]) + { + if ((start= params[1]->get_address()) >= 0) + { + end+= start; + if (params[2]) + { + if ((l= params[2]->get_address()) >= 0) + end= l; + else + { + con->printf("End address is wrong\n"); + return(0); + } + } + } + else + { + con->printf("Start address is wrong\n"); + return(0); + } + } + if (params[3] && + (l= params[3]->get_address()) >= 0) + bpl= l; + mem->dump(start, end, bpl, con); + return(0); +} + + +/* + * Command: di + *---------------------------------------------------------------------------- + */ + +int +cl_di_cmd::do_work(class cl_cmdline *cmdline, class cl_console *con) +{ + cmdline->insert_param(0, new cl_cmd_sym_arg("i")); + cl_dump_cmd::do_work(cmdline, con); + return(0); +} + + +/* + * Command: dx + *---------------------------------------------------------------------------- + */ + +int +cl_dx_cmd::do_work(class cl_cmdline *cmdline, class cl_console *con) +{ + cmdline->insert_param(0, new cl_cmd_sym_arg("x")); + cl_dump_cmd::do_work(cmdline, con); + return(0); +} + + +/* + * Command: dch + *---------------------------------------------------------------------------- + */ + +int +cl_dch_cmd::do_work(class cl_cmdline *cmdline, class cl_console *con) +{ + cmdline->insert_param(0, new cl_cmd_sym_arg("r")); + cl_dump_cmd::do_work(cmdline, con); + return(0); +} + + +/* + * Command: ds + *---------------------------------------------------------------------------- + */ + +int +cl_ds_cmd::do_work(class cl_cmdline *cmdline, class cl_console *con) +{ + cmdline->insert_param(0, new cl_cmd_sym_arg("s")); + cl_dump_cmd::do_work(cmdline, con); + return(0); +} + + +/* + * Command: dc + *---------------------------------------------------------------------------- + */ + +int +cl_dc_cmd::do_work(class cl_cmdline *cmdline, class cl_console *con) +{ + long i, l, start= last, end= -1; + class cl_cmd_arg *params[2]= { cmdline->param(0), + cmdline->param(1) }; + + if (params[0]) + { + if ((start= params[0]->get_address()) >= 0) + { + if (params[1]) + { + if ((l= params[1]->get_address()) >= 0) + end= l; + else + { + con->printf("End address is wrong\n"); + return(0); + } + } + } + else + { + con->printf("Start address is wrong\n"); + return(0); + } + } + i= 0; + for (l= start; + (end < 0 && i < 20) || l <= end; + l+= sim->uc->inst_length(sim->uc->get_mem(MEM_ROM, l)), i++) + sim->uc->print_disass(l, con); + last= l; + return(0); +} + + +/* + * Command: help + *---------------------------------------------------------------------------- + */ + +int +cl_help_cmd::do_work(class cl_cmdline */*cmdline*/, class cl_console *con) +{ + class cl_cmd *c; + int i; + + for (i= 0; i < sim->cmdset->count; i++) + { + c= (class cl_cmd *)(sim->cmdset->at(i)); + if (c->short_help) + con->printf("%s\n", c->short_help); + else + con->printf("%s\n", (char*)(c->names->at(0))); + } + return(0); +} + + +/* + * Command: quit + *---------------------------------------------------------------------------- + */ + +int +cl_quit_cmd::do_work(class cl_cmdline */*cmdline*/, class cl_console */*con*/) +{ + return(1); +} + +/* + * Command: kill + *---------------------------------------------------------------------------- + */ + +int +cl_kill_cmd::do_work(class cl_cmdline */*cmdline*/, class cl_console */*con*/) +{ + sim->state|= SIM_QUIT; + return(1); +} + + +/* End of cmdset.cc */ diff --git a/sim/ucsim/cmd.src/cmdsetcl.h b/sim/ucsim/cmd.src/cmdsetcl.h new file mode 100644 index 00000000..b6202693 --- /dev/null +++ b/sim/ucsim/cmd.src/cmdsetcl.h @@ -0,0 +1,340 @@ +/* + * Simulator of microcontrollers (cmdsetcl.h) + * + * Copyright (C) 1999,99 Drotos Daniel, Talker Bt. + * + * To contact author send email to drdani@mazsola.iit.uni-miskolc.hu + * + */ + +/* This file is part of microcontroller simulator: ucsim. + +UCSIM is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. + +UCSIM is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with UCSIM; see the file COPYING. If not, write to the Free +Software Foundation, 59 Temple Place - Suite 330, Boston, MA +02111-1307, USA. */ +/*@1@*/ + +#ifndef CMDSETCL_HEADER +#define CMDSETCL_HEADER + +#include "newcmdcl.h" + + +// CONF +class cl_conf_cmd: public cl_cmd +{ +public: + cl_conf_cmd(class cl_sim *asim, + char *aname, + int can_rep, + char *short_hlp, + char *long_hlp): + cl_cmd(asim, aname, can_rep, short_hlp, long_hlp) {} + virtual int do_work(class cl_cmdline *cmdline, class cl_console *con); +}; + +// STATE +class cl_state_cmd: public cl_cmd +{ +public: + cl_state_cmd(class cl_sim *asim, + char *aname, + int can_rep, + char *short_hlp, + char *long_hlp): + cl_cmd(asim, aname, can_rep, short_hlp, long_hlp) {} + virtual int do_work(class cl_cmdline *cmdline, class cl_console *con); +}; + +// FILE +class cl_file_cmd: public cl_cmd +{ +public: + cl_file_cmd(class cl_sim *asim, + char *aname, + int can_rep, + char *short_hlp, + char *long_hlp): + cl_cmd(asim, aname, can_rep, short_hlp, long_hlp) {} + virtual int do_work(class cl_cmdline *cmdline, class cl_console *con); +}; + +// DOWNLOAD +class cl_dl_cmd: public cl_cmd +{ +public: + cl_dl_cmd(class cl_sim *asim, + char *aname, + int can_rep, + char *short_hlp, + char *long_hlp): + cl_cmd(asim, aname, can_rep, short_hlp, long_hlp) {} + virtual int do_work(class cl_cmdline *cmdline, class cl_console *con); +}; + +// GET +class cl_get_cmd: public cl_cmd +{ +public: + cl_get_cmd(class cl_sim *asim, + char *aname, + int can_rep, + char *short_hlp, + char *long_hlp): + cl_cmd(asim, aname, can_rep, short_hlp, long_hlp) {} + virtual int do_work(class cl_cmdline *cmdline, class cl_console *con); + virtual int timer(class cl_cmdline *cmdline, class cl_console *con); +}; + +// SET +class cl_set_cmd: public cl_cmd +{ +public: + cl_set_cmd(class cl_sim *asim, + char *aname, + int can_rep, + char *short_hlp, + char *long_hlp): + cl_cmd(asim, aname, can_rep, short_hlp, long_hlp) {} + virtual int do_work(class cl_cmdline *cmdline, class cl_console *con); + virtual int timer(class cl_cmdline *cmdline, class cl_console *con); +}; + +// TIMER +class cl_timer_cmd: public cl_cmd +{ +public: + class cl_ticker *ticker; + int what; + char *name; + + cl_timer_cmd(class cl_sim *asim, + char *aname, + int can_rep, + char *short_hlp, + char *long_hlp): + cl_cmd(asim, aname, can_rep, short_hlp, long_hlp) {} + virtual int do_work(class cl_cmdline *cmdline, class cl_console *con); + void set_ticker(class cl_cmd_arg *param); + virtual int add(class cl_cmdline *cmdline, class cl_console *con); + virtual int del(class cl_cmdline *cmdline, class cl_console *con); + virtual int get(class cl_cmdline *cmdline, class cl_console *con); + virtual int run(class cl_cmdline *cmdline, class cl_console *con); + virtual int stop(class cl_cmdline *cmdline, class cl_console *con); + virtual int val(class cl_cmdline *cmdline, class cl_console *con); +}; + +// RUN +class cl_run_cmd: public cl_cmd +{ +public: + cl_run_cmd(class cl_sim *asim, + char *aname, + int can_rep, + char *short_hlp, + char *long_hlp): + cl_cmd(asim, aname, can_rep, short_hlp, long_hlp) {} + virtual int do_work(class cl_cmdline *cmdline, class cl_console *con); +}; + +// STEP +class cl_step_cmd: public cl_cmd +{ +public: + cl_step_cmd(class cl_sim *asim, + char *aname, + int can_rep, + char *short_hlp, + char *long_hlp): + cl_cmd(asim, aname, can_rep, short_hlp, long_hlp) {} + virtual int do_work(class cl_cmdline *cmdline, class cl_console *con); +}; + +// RESET +class cl_reset_cmd: public cl_cmd +{ +public: + cl_reset_cmd(class cl_sim *asim, + char *aname, + int can_rep, + char *short_hlp, + char *long_hlp): + cl_cmd(asim, aname, can_rep, short_hlp, long_hlp) {} + virtual int do_work(class cl_cmdline *cmdline, class cl_console *con); +}; + +// DUMP +class cl_dump_cmd: public cl_cmd +{ +public: + cl_dump_cmd(class cl_sim *asim, + char *aname, + int can_rep, + char *short_hlp, + char *long_hlp): + cl_cmd(asim, aname, can_rep, short_hlp, long_hlp) {} + //cl_dump_cmd(class cl_sim *asim): cl_cmd(asim) {} + virtual int do_work(class cl_cmdline *cmdline, class cl_console *con); +}; + +// DI +class cl_di_cmd: public cl_dump_cmd +{ +public: + cl_di_cmd(class cl_sim *asim, + char *aname, + int can_rep, + char *short_hlp, + char *long_hlp): + cl_dump_cmd(asim, aname, can_rep, short_hlp, long_hlp) {} + virtual int do_work(class cl_cmdline *cmdline, class cl_console *con); +}; + +// DX +class cl_dx_cmd: public cl_dump_cmd +{ +public: + cl_dx_cmd(class cl_sim *asim, + char *aname, + int can_rep, + char *short_hlp, + char *long_hlp): + cl_dump_cmd(asim, aname, can_rep, short_hlp, long_hlp) {} + virtual int do_work(class cl_cmdline *cmdline, class cl_console *con); +}; + +// DCH +class cl_dch_cmd: public cl_dump_cmd +{ +public: + cl_dch_cmd(class cl_sim *asim, + char *aname, + int can_rep, + char *short_hlp, + char *long_hlp): + cl_dump_cmd(asim, aname, can_rep, short_hlp, long_hlp) {} + virtual int do_work(class cl_cmdline *cmdline, class cl_console *con); +}; + +// DS +class cl_ds_cmd: public cl_dump_cmd +{ +public: + cl_ds_cmd(class cl_sim *asim, + char *aname, + int can_rep, + char *short_hlp, + char *long_hlp): + cl_dump_cmd(asim, aname, can_rep, short_hlp, long_hlp) {} + virtual int do_work(class cl_cmdline *cmdline, class cl_console *con); +}; + +// DC +class cl_dc_cmd: public cl_cmd +{ +public: + int last; +public: + cl_dc_cmd(class cl_sim *asim, + char *aname, + int can_rep, + char *short_hlp, + char *long_hlp): + cl_cmd(asim, aname, can_rep, short_hlp, long_hlp) {last=0;} + virtual int do_work(class cl_cmdline *cmdline, class cl_console *con); +}; + +// BREAK +class cl_break_cmd: public cl_cmd +{ +public: + enum brk_perm perm; +public: + cl_break_cmd(class cl_sim *asim, + char *aname, + int can_rep, + char *short_hlp, + char *long_hlp): + cl_cmd(asim, aname, can_rep, short_hlp, long_hlp) { perm= brkFIX; } + virtual int do_work(class cl_cmdline *cmdline, class cl_console *con); +}; + +// TBREAK +class cl_tbreak_cmd: public cl_break_cmd +{ +public: + cl_tbreak_cmd(class cl_sim *asim, + char *aname, + int can_rep, + char *short_hlp, + char *long_hlp): + cl_break_cmd(asim, aname, can_rep, short_hlp, long_hlp) {perm=brkDYNAMIC;} +}; + +// CLEAR +class cl_clear_cmd: public cl_cmd +{ +public: + cl_clear_cmd(class cl_sim *asim, + char *aname, + int can_rep, + char *short_hlp, + char *long_hlp): + cl_cmd(asim, aname, can_rep, short_hlp, long_hlp) {} + virtual int do_work(class cl_cmdline *cmdline, class cl_console *con); +}; + +// HELP +class cl_help_cmd: public cl_cmd +{ +public: + cl_help_cmd(class cl_sim *asim, + char *aname, + int can_rep, + char *short_hlp, + char *long_hlp): + cl_cmd(asim, aname, can_rep, short_hlp, long_hlp) {} + virtual int do_work(class cl_cmdline *cmdline, class cl_console *con); +}; + +// QUIT +class cl_quit_cmd: public cl_cmd +{ +public: + cl_quit_cmd(class cl_sim *asim, + char *aname, + int can_rep, + char *short_hlp, + char *long_hlp): + cl_cmd(asim, aname, can_rep, short_hlp, long_hlp) {} + virtual int do_work(class cl_cmdline *cmdline, class cl_console *con); +}; + +// KILL +class cl_kill_cmd: public cl_cmd +{ +public: + cl_kill_cmd(class cl_sim *asim, + char *aname, + int can_rep, + char *short_hlp, + char *long_hlp): + cl_cmd(asim, aname, can_rep, short_hlp, long_hlp) {} + virtual int do_work(class cl_cmdline *cmdline, class cl_console *con); +}; + + +#endif + +/* End of cmdsetcl.h */ diff --git a/sim/ucsim/cmd.src/cmdutil.cc b/sim/ucsim/cmd.src/cmdutil.cc new file mode 100644 index 00000000..083b8456 --- /dev/null +++ b/sim/ucsim/cmd.src/cmdutil.cc @@ -0,0 +1,286 @@ +/* + * Simulator of microcontrollers (cmdutil.cc) + * + * Copyright (C) 1999,99 Drotos Daniel, Talker Bt. + * + * To contact author send email to drdani@mazsola.iit.uni-miskolc.hu + * + */ + +/* This file is part of microcontroller simulator: ucsim. + +UCSIM is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. + +UCSIM is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with UCSIM; see the file COPYING. If not, write to the Free +Software Foundation, 59 Temple Place - Suite 330, Boston, MA +02111-1307, USA. */ +/*@1@*/ + +#include "ddconfig.h" + +#include +#include +#include +#include +#ifdef HAVE_SYS_SOCKET_H +# include +# include +# include +#endif +#include "i_string.h" + +#include "stypes.h" +#include "globals.h" +#include "uccl.h" + + +/* + * Making a socket which can be used to listen for a specified port + */ + +#ifdef SOCKET_AVAIL +int +make_server_socket(unsigned short int port) +{ + int sock, i; + struct sockaddr_in name; + + /* Create the socket. */ + sock= socket(PF_INET, SOCK_STREAM, 0); + if (sock < 0) + { + perror("socket"); + return(0); + } + + /* Give the socket a name. */ + i= 1; + if (setsockopt(sock, SOL_SOCKET, SO_REUSEADDR, (char*)&i, sizeof(i)) < 0) + { + perror("setsockopt"); + } + name.sin_family = AF_INET; + name.sin_port = htons(port); + name.sin_addr.s_addr= htonl(INADDR_ANY); + if (bind(sock, (struct sockaddr *)&name, sizeof(name)) < 0) + { + perror("bind"); + return(0); + } + + return(sock); +} +#endif + + +/* + * Printing out an integer in binary format + */ + +void +print_bin(long data, int bits, FILE *f) +{ + long mask= 1; + + mask= mask << ((bits >= 1)?(bits-1):0); + while (bits--) + { + fprintf(f, "%c", (data&mask)?'1':'0'); + mask>>= 1; + } +} + + +/* + * Searching for a name in the specified table + */ + +struct name_entry * +get_name_entry(struct name_entry tabl[], char *name, class cl_uc *uc) +{ + int i= 0; + char *p; + + for (p= name; *p; *p= toupper(*p), p++); + while (tabl[i].name && + (!(tabl[i].cpu_type & uc->type) || + (strcmp(tabl[i].name, name) != 0))) + i++; + if (tabl[i].name != NULL) + return(&tabl[i]); + else + return(NULL); +} + + +/* + * Interpreting a bitname + */ + +bool +interpret_bitname(char *name, class cl_uc *uc, + uchar **cell, uchar *celladdr, + uchar *bitaddr, uchar *bitmask, + char **symname) +{ + char *dot, *p; + char *sym, bitnumstr[2]; + struct name_entry *ne; + int bitnum, i; + + if ((dot= strchr(name, '.')) != NULL) + { + *dot++= '\0'; + if ((ne= get_name_entry(uc->sfr_tbl(), name, uc)) == NULL) + { + *celladdr= strtol(name, &p, 0); + if (p && *p) + { + dot--; + *dot= '.'; + return(FALSE); + } + } + else + *celladdr= ne->addr; + if ((*celladdr < 0x20) || + ((*celladdr > 0x2f) && (*celladdr < 0x80)) || + ((*celladdr > 0x7f) && (*celladdr & 0x07))) + return(FALSE); + bitnum= strtol(dot, &p, 0); + if ((p && *p) || + (bitnum < 0) || + (bitnum > 7)) + return(FALSE); + if (*celladdr > 0x7f) + *bitaddr= *celladdr + bitnum; + else + *bitaddr= (*celladdr - 0x20)*8 + bitnum; + dot--; + *dot= '.'; + } + else + { + if ((ne= get_name_entry(uc->bit_tbl(), name, uc)) == NULL) + { + *bitaddr= strtol(name, &p, 0); + if ((p && *p) || + (*bitaddr > 0xff)) + return(FALSE); + } + else + *bitaddr= ne->addr; + if (*bitaddr > 0x7f) + *celladdr= *bitaddr & 0xf8; + else + *celladdr= (*bitaddr >> 3) + 0x20; + } + // *bitaddr, *celladdr now OK + *cell= uc->get_bit/*FIXME*/(*bitaddr); + *bitmask= BIT_MASK(*bitaddr); + // making symbolic name + if (!symname) + return(TRUE); + i= 0; + while (uc->bit_tbl()[i].name && + (uc->bit_tbl()[i].addr != *bitaddr)) + i++; + if (uc->bit_tbl()[i].name) + { + sym= strdup(uc->bit_tbl()[i].name); + *symname= sym; + return(TRUE); + } + i= 0; + while (uc->sfr_tbl()[i].name && + (uc->sfr_tbl()[i].addr != *celladdr)) + i++; + if (uc->sfr_tbl()[i].name) + sym= strdup(uc->sfr_tbl()[i].name); + else + { + sym= (char *)malloc(3); + sprintf(sym, "%02x", *celladdr); + } + sym= (char *)realloc(sym, strlen(sym)+2); + strcat(sym, "."); + sprintf(bitnumstr, "%1d", *bitaddr & 0x07); + strcat(sym, bitnumstr); + *symname= sym; + return(TRUE); +} + + +/* + * Processing escape sequencies in a string + */ + +char * +proc_escape(char *string, int *len) +{ + char spec_chars[]= "fnrtvab"; + char spec[]= "\f\n\r\t\v\a\b"; + char *s, *str, *p; + + s = string; + str= (char *)malloc(strlen(string)+1); + p = str; + while (*s) + { + char *spec_c; + + if (*s == '\\' && + *(s+1)) + { + s++; + if (*s == '0') + { + if (!isdigit(*(s+1))) + { + *p++= '\0'; + s++; + } + else + { + char *octal, *chk, data; + int i, j; + i= strspn(s, "01234567"); + octal= (char *)malloc(i+1); + j= 0; + while (*s && + (j < i)) + octal[j++]= *s++; + octal[j]= '\0'; + data= strtol(octal, &chk, 8); + if (!chk || !(*chk)) + *p++= data; + } + } + else + if ((spec_c= strchr(spec_chars, *s)) != NULL) + { + *p++= spec[spec_c-spec_chars]; + s++; + } + else + *p++= *s++; + } + else + *p++= *s++; + } + *p= '\0'; + *len= p-str; + return(str); +} + + +/* End of cmdutil.cc */ diff --git a/sim/ucsim/cmd.src/cmdutil.h b/sim/ucsim/cmd.src/cmdutil.h new file mode 100644 index 00000000..8bc02d2a --- /dev/null +++ b/sim/ucsim/cmd.src/cmdutil.h @@ -0,0 +1,50 @@ +/* + * Simulator of microcontrollers (cmdutil.h) + * + * Copyright (C) 1999,99 Drotos Daniel, Talker Bt. + * + * To contact author send email to drdani@mazsola.iit.uni-miskolc.hu + * + */ + +/* This file is part of microcontroller simulator: ucsim. + +UCSIM is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. + +UCSIM is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with UCSIM; see the file COPYING. If not, write to the Free +Software Foundation, 59 Temple Place - Suite 330, Boston, MA +02111-1307, USA. */ +/*@1@*/ + +#ifndef CMDUTIL_HEADER +#define CMDUTIL_HEADER + +#include "ddconfig.h" + +#include "uccl.h" + + +extern int make_server_socket(unsigned short int port); +extern void print_bin(long data, int bits, FILE *f); +extern struct name_entry *get_name_entry(struct name_entry tabl[], + char *name, + class cl_uc *uc); +extern bool interpret_bitname(char *name, class cl_uc *uc, + uchar **cell, uchar *celladdr, + uchar *bitaddr, uchar *bitmask, + char **symname); +extern char *proc_escape(char *string, int *len); + + +#endif + +/* End of cmdutil.h */ diff --git a/sim/ucsim/cmd.src/conf.mk b/sim/ucsim/cmd.src/conf.mk new file mode 100644 index 00000000..879e9bc8 --- /dev/null +++ b/sim/ucsim/cmd.src/conf.mk @@ -0,0 +1,10 @@ +# +# Makefile targets to remake configuration +# + +freshconf: Makefile + +Makefile: $(srcdir)/Makefile.in $(PRJDIR)/configure.in + cd $(PRJDIR) && $(SHELL) ./config.status + +# End of conf.mk diff --git a/sim/ucsim/cmd.src/get.cc b/sim/ucsim/cmd.src/get.cc new file mode 100644 index 00000000..ab2888bc --- /dev/null +++ b/sim/ucsim/cmd.src/get.cc @@ -0,0 +1,79 @@ +/* + * Simulator of microcontrollers (get.cc) + * + * Copyright (C) 1999,99 Drotos Daniel, Talker Bt. + * + * To contact author send email to drdani@mazsola.iit.uni-miskolc.hu + * + */ + +/* This file is part of microcontroller simulator: ucsim. + +UCSIM is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. + +UCSIM is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with UCSIM; see the file COPYING. If not, write to the Free +Software Foundation, 59 Temple Place - Suite 330, Boston, MA +02111-1307, USA. */ +/*@1@*/ + +#include "ddconfig.h" + +// sim +#include "simcl.h" + +// local +#include "cmdsetcl.h" + + +/* + * GET TIMER + */ + +int +cl_get_cmd::timer(class cl_cmdline *cmdline, class cl_console *con) +{ + class cl_cmd_arg *params[4]= { cmdline->param(0), + cmdline->param(1), + cmdline->param(2), + cmdline->param(3) }; + int what; + class cl_ticker *ticker; + + if (params[1] != 0) + { + what= (params[1])->get_ivalue(); + if ((ticker= sim->uc->get_counter(what)) == 0) + { + con->printf("Timer %d does not exist\n", what); + return(0); + } + con->printf("timer #%d: %g sec (%lu clks)\n", what, + ticker->get_rtime(sim->uc->xtal), ticker->ticks); + } + else + { + con->printf("time: %g sec (%lu clks)\n", + sim->uc->get_rtime(), sim->uc->ticks->ticks); + for (what= 0; what < sim->uc->counters->count; what++) + { + ticker= sim->uc->get_counter(what); + if (ticker) + con->printf("timer #%d: %g sec (%lu clks)\n", what, + ticker->get_rtime(sim->uc->xtal), ticker->ticks); + } + } + + return(0); +} + + +/* End of get.cc */ diff --git a/sim/ucsim/cmd.src/info.cc b/sim/ucsim/cmd.src/info.cc new file mode 100644 index 00000000..f53f8701 --- /dev/null +++ b/sim/ucsim/cmd.src/info.cc @@ -0,0 +1,156 @@ +/* + * Simulator of microcontrollers (info.cc) + * + * Copyright (C) 1999,99 Drotos Daniel, Talker Bt. + * + * To contact author send email to drdani@mazsola.iit.uni-miskolc.hu + * + */ + +/* This file is part of microcontroller simulator: ucsim. + +UCSIM is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. + +UCSIM is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with UCSIM; see the file COPYING. If not, write to the Free +Software Foundation, 59 Temple Place - Suite 330, Boston, MA +02111-1307, USA. */ +/*@1@*/ + +#include +#include "i_string.h" + +// sim.src +#include "simcl.h" + +// local +#include "infocl.h" + + +/* + * INFO BREAKPOINTS command + */ + +int +cl_info_bp_cmd::do_work(class cl_cmdline *cmdline, class cl_console *con) +{ + int i; + char *s; + + con->printf("Num Type Disp Hit Cnt Address What\n"); + for (i= 0; i < sim->uc->fbrk->count; i++) + { + class cl_brk *fb= (class cl_brk *)(sim->uc->fbrk->at(i)); + s= sim->uc->disass(fb->addr, NULL); + con->printf("%-3d %-10s %s %-5d %-5d 0x%06x %s\n", fb->nr, + "fetch", (fb->perm==brkFIX)?"keep":"del ", + fb->hit, fb->cnt, + fb->addr, s); + free(s); + } + for (i= 0; i < sim->uc->ebrk->count; i++) + { + class cl_ev_brk *eb= (class cl_ev_brk *)(sim->uc->ebrk->at(i)); + con->printf("%-3d %-10s %s %-5d %-5d 0x%06x %s\n", eb->nr, + "event", (eb->perm==brkFIX)?"keep":"del ", + eb->hit, eb->cnt, + eb->addr, eb->id); + } + /*t_addr a; + class cl_rom *r= (class cl_rom *)(sim->uc->mem(MEM_ROM)); + for (a= 0; a < sim->uc->get_mem_size(MEM_ROM); a++) + { + if (r->bp_map->get(a)) + con->printf("0x%06x\n", a); + }*/ + return(0); +} + + +/* + * INFO REGISTERS command + */ + +int +cl_info_reg_cmd::do_work(class cl_cmdline *cmdline, class cl_console *con) +{ + sim->uc->print_regs(con); + return(0); +} + + +/* + * INFO HW command + */ + +int +cl_info_hw_cmd::do_work(class cl_cmdline *cmdline, class cl_console *con) +{ + class cl_cmd_arg *params[4]= { cmdline->param(0), + cmdline->param(1), + cmdline->param(2), + cmdline->param(3) }; + char *p0; + enum hw_cath cath; + class cl_hw *hw; + int i= 0; + + if (params[0] == 0) + { + con->printf("Cathegory missing\n"); + return(0); + } + p0= (params[0])->get_svalue(); + if (strstr(p0, "t") == p0) + cath= HW_TIMER; + else if (strstr(p0, "u") == p0) + cath= HW_UART; + else if (strstr(p0, "po") == p0) + cath= HW_PORT; + else if (strstr(p0, "pc") == p0) + cath= HW_PCA; + else if (strstr(p0, "i") == p0) + cath= HW_INTERRUPT; + else if (strstr(p0, "w") == p0) + cath= HW_WDT; + else + { + con->printf("Unknown cathegory\n"); + return(0); + } + if (params[1] == 0) + { + // no ID + hw= sim->uc->get_hw(cath, &i); + while (hw) + { + hw->print_info(con); + i++; + hw= sim->uc->get_hw(cath, &i); + } + } + else + { + // ID given + int id= (params[1])->get_ivalue(); + hw= sim->uc->get_hw(cath, id, &i); + while (hw) + { + hw->print_info(con); + i++; + hw= sim->uc->get_hw(cath, id, &i); + } + } + return(0); +} + + +/* End of info.cc */ diff --git a/sim/ucsim/cmd.src/infocl.h b/sim/ucsim/cmd.src/infocl.h new file mode 100644 index 00000000..5b3af267 --- /dev/null +++ b/sim/ucsim/cmd.src/infocl.h @@ -0,0 +1,73 @@ +/* + * Simulator of microcontrollers (infocl.h) + * + * Copyright (C) 1999,99 Drotos Daniel, Talker Bt. + * + * To contact author send email to drdani@mazsola.iit.uni-miskolc.hu + * + */ + +/* This file is part of microcontroller simulator: ucsim. + +UCSIM is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. + +UCSIM is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with UCSIM; see the file COPYING. If not, write to the Free +Software Foundation, 59 Temple Place - Suite 330, Boston, MA +02111-1307, USA. */ +/*@1@*/ + +#ifndef INFOCL_HEADER +#define INFOCL_HEADER + +#include "newcmdcl.h" + + +class cl_info_bp_cmd: public cl_cmd +{ +public: + cl_info_bp_cmd(class cl_sim *asim, + char *aname, + int can_rep, + char *short_hlp, + char *long_hlp): + cl_cmd(asim, aname, can_rep, short_hlp, long_hlp) {} + virtual int do_work(class cl_cmdline *cmdline, class cl_console *con); +}; + +class cl_info_reg_cmd: public cl_cmd +{ +public: + cl_info_reg_cmd(class cl_sim *asim, + char *aname, + int can_rep, + char *short_hlp, + char *long_hlp): + cl_cmd(asim, aname, can_rep, short_hlp, long_hlp) {} + virtual int do_work(class cl_cmdline *cmdline, class cl_console *con); +}; + +class cl_info_hw_cmd: public cl_cmd +{ +public: + cl_info_hw_cmd(class cl_sim *asim, + char *aname, + int can_rep, + char *short_hlp, + char *long_hlp): + cl_cmd(asim, aname, can_rep, short_hlp, long_hlp) {} + virtual int do_work(class cl_cmdline *cmdline, class cl_console *con); +}; + + +#endif + +/* End of infocl.h */ diff --git a/sim/ucsim/cmd.src/newcmd.cc b/sim/ucsim/cmd.src/newcmd.cc new file mode 100644 index 00000000..90e4b028 --- /dev/null +++ b/sim/ucsim/cmd.src/newcmd.cc @@ -0,0 +1,1112 @@ +/* + * Simulator of microcontrollers (newcmd.cc) + * + * Copyright (C) 1999,99 Drotos Daniel, Talker Bt. + * + * To contact author send email to drdani@mazsola.iit.uni-miskolc.hu + * + */ + +/* This file is part of microcontroller simulator: ucsim. + +UCSIM is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. + +UCSIM is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with UCSIM; see the file COPYING. If not, write to the Free +Software Foundation, 59 Temple Place - Suite 330, Boston, MA +02111-1307, USA. */ +/*@1@*/ + +#include "ddconfig.h" + +#include +#include +#include +#include +#include +#ifdef HAVE_SYS_SOCKET_H +# include +# include +# include +# include +#endif +#include +#if FD_HEADER_OK +# include HEADER_FD +#endif +#include +#include "i_string.h" + +// prj +#include "globals.h" + +// sim +#include "simcl.h" +#include "argcl.h" + +// local +#include "newcmdcl.h" +#include "cmdutil.h" + + +extern "C" int vasprintf(); +extern "C" int vsnprintf(); + +static int +cmd_do_print(FILE *f, char *format, va_list ap) +{ + int ret; +#ifdef HAVE_VASPRINTF + char *msg= NULL; + vasprintf(&msg, format, ap); + ret= fprintf(f, "%s", msg); + free(msg); +#else +# ifdef HAVE_VSNPRINTF + char msg[80*25]; + vsnprintf(msg, 80*25, format, ap); + ret= fprintf(f, "%s", msg); +# else +# ifdef HAVE_VPRINTF + char msg[80*25]; + vsprintf(msg, format, ap); /* Dangerous */ + ret= fprintf(f, "%s", msg); +# else +# ifdef HAVE_DOPRNT + /* ??? */ + /*strcpy(msg, "Unimplemented printf has called.\n");*/ +# else + /*strcpy(msg, "printf can not be implemented, upgrade your libc.\n");*/ +# endif +# endif +# endif +#endif + fflush(f); + return(ret); +} + + +/* + * Command line + *____________________________________________________________________________ + */ + +cl_cmdline::cl_cmdline(char *acmd) +{ + cmd= strdup(acmd); + params= new cl_list(2, 2); + tokens= new cl_ustrings(2, 2); + name= 0; +} + +cl_cmdline::~cl_cmdline(void) +{ + if (cmd) + free(cmd); + if (name) + free(name); + delete params; + delete tokens; +} + +int +cl_cmdline::init(void) +{ + split(); + return(0); +} + +char * +cl_cmdline::skip_delims(char *start) +{ + while (*start && + strchr(" \t\v\r,", *start)) + start++; + return(start); +} + +int +cl_cmdline::split(void) +{ + char *start= cmd; + int i; + + name= 0; + if (!cmd || + !*cmd) + return(0); + start+= strspn(start, " \t\v\r,"); + if (start && + *start == '\n') + { + name= (char*)malloc(2); + strcpy(name, "\n"); + return(0); + } + if (!*start) + return(0); + i= strcspn(start, " \t\v\r,"); + if (i) + { + name= (char*)malloc(i+1); + strncpy(name, start, i); + name[i]= '\0'; + } + start+= i; + start= skip_delims(start); + // skip delimiters + while (*start) + { + char *end, *param_str; + if (*start == '"') + { + // string + start++; + end= start; + while (*end && + *end != '"') + end++; + if (*end == '"') + end--; + else + simulator->cmd->printf("Unterminated string\n"); + param_str= (char *)malloc(end-start+2); + strncpy(param_str, start, 1+end-start); + param_str[1+end-start]= '\0'; + tokens->add(strdup(param_str)); + params->add(simulator->mk_cmd_str_arg(param_str)); + free(param_str); + if (*end) + end++; + if (*end == '"') + end++; + } + else + { + char *dot; + i= strcspn(start, " \t\v\r,"); + end= start+i; + param_str= (char *)malloc(i+1); + strncpy(param_str, start, i); + param_str[i]= '\0'; + tokens->add(strdup(param_str)); + if ((dot= strchr(param_str, '.')) != NULL) + { + // bit + class cl_cmd_arg *sfr, *bit; + *dot= '\0'; + dot++; + if (strchr("0123456789", *param_str) != NULL) + sfr= simulator->mk_cmd_int_arg((long long) + strtol(param_str, 0, 0)); + else + sfr= simulator->mk_cmd_sym_arg(param_str); + if (*dot == '\0') + { + bit= 0; + simulator->cmd->printf("Uncomplete bit address\n"); + } + else + { + if (strchr("0123456789", *dot) != NULL) + bit= simulator->mk_cmd_int_arg((long long) + strtol(dot, 0, 0)); + else + bit= simulator->mk_cmd_sym_arg(dot); + } + params->add(simulator->mk_cmd_bit_arg(sfr, bit)); + } + else if (strchr("0123456789", *param_str) != NULL) + { + // number + params->add(simulator->mk_cmd_int_arg((long long) + strtol(param_str, 0, 0))); + } + else + { + // symbol + params->add(simulator->mk_cmd_sym_arg(param_str)); + } + free(param_str); + } + start= end; + start= skip_delims(start); + } + return(0); +} + +int +cl_cmdline::shift(void) +{ + char *s= skip_delims(cmd); + + free(name); + name= NULL; + if (s && *s) + { + while (*s && + strchr(" \t\v\r,", *s) == NULL) + s++; + s= skip_delims(s); + char *p= strdup(s); + free(cmd); + cmd= p; + delete params; + params= new cl_list(2, 2); + split(); + } + return(name && *name); +} + +int +cl_cmdline::repeat(void) +{ + return(name && + *name == '\n'); +} + +class cl_cmd_arg * +cl_cmdline::param(int num) +{ + if (num >= params->count) + return(0); + return((class cl_cmd_arg *)(params->at(num))); +} + +void +cl_cmdline::insert_param(int pos, class cl_cmd_arg *param) +{ + if (pos >= params->count) + params->add(param); + else + params->add_at(pos, param); +} + + +/* + * Command + *____________________________________________________________________________ + */ + +cl_cmd::cl_cmd(class cl_sim *asim, + char *aname, + int can_rep, + char *short_hlp, + char *long_hlp): + cl_base() +{ + sim= asim; + names= new cl_strings(1, 1); + names->add(aname?strdup(aname):strdup("unknown")); + can_repeat= can_rep; + short_help= short_hlp?strdup(short_hlp):NULL; + long_help= long_hlp?strdup(long_hlp):NULL; +} + +/*cl_cmd::cl_cmd(class cl_sim *asim): + cl_base() +{ + sim= asim; + name= short_help= long_help= 0; + can_repeat= 0; +}*/ + +cl_cmd::~cl_cmd(void) +{ + delete names; + if (short_help) + free(short_help); + if (long_help) + free(long_help); +} + +void +cl_cmd::add_name(char *name) +{ + if (name) + names->add(strdup(name)); +} + +int +cl_cmd::name_match(char *aname, int strict) +{ + int i; + + if (names->count == 0 && + !aname) + return(1); + if (!aname) + return(0); + if (strict) + { + for (i= 0; i < names->count; i++) + { + char *n= (char*)(names->at(i)); + if (strcmp(aname, n) == 0) + return(1); + } + } + else + { + for (i= 0; i < names->count; i++) + { + char *n= (char*)(names->at(i)); + if (strstr(n, aname) == n) + return(1); + } + } + return(0); +} + +int +cl_cmd::name_match(class cl_cmdline *cmdline, int strict) +{ + return(name_match(cmdline->name, strict)); +} + +int +cl_cmd::syntax_ok(class cl_cmdline *cmdline) +{ + return(1); +} + +int +cl_cmd::work(class cl_cmdline *cmdline, class cl_console *con) +{ + if (!syntax_ok(cmdline)) + return(0); + return(do_work(cmdline, con)); +} + +int +cl_cmd::do_work(class cl_cmdline *cmdline, class cl_console *con) +{ + con->printf("Command \"%s\" does nothing.\n", (char*)(names->at(0))); + return(0); +} + + +/* + * Set of commands + *____________________________________________________________________________ + */ + +cl_cmdset::cl_cmdset(class cl_sim *asim): + cl_list(5, 5) +{ + sim= asim; + last_command= 0; +} + +class cl_cmd * +cl_cmdset::get_cmd(class cl_cmdline *cmdline) +{ + int i; + + if (cmdline->repeat()) + { + if (last_command) + return(last_command); + else + return(0); + } + // exact match + for (i= 0; i < count; i++) + { + class cl_cmd *c= (class cl_cmd *)at(i); + if (c->name_match(cmdline, 1)) + return(c); + } + // not exact match + class cl_cmd *c_matched= 0; + for (i= 0; i < count; i++) + { + class cl_cmd *c= (class cl_cmd *)at(i); + if (c->name_match(cmdline, 0)) + { + if (!c_matched) + c_matched= c; + else + return(0); + } + } + return(c_matched); + //return(0); +} + +void +cl_cmdset::del(char *name) +{ + int i; + + if (!name) + return; + for (i= 0; i < count; i++) + { + class cl_cmd *cmd= (class cl_cmd *)(at(i)); + if (cmd->name_match(name, 1)) + free_at(i); + } +} + +void +cl_cmdset::replace(char *name, class cl_cmd *cmd) +{ + int i; + + if (!name) + return; + for (i= 0; i < count; i++) + { + class cl_cmd *c= (class cl_cmd *)(at(i)); + if (c->name_match(name, 1)) + { + delete c; + put_at(i, cmd); + } + } +} + + +/* + * Composed command: subset of commands + *____________________________________________________________________________ + */ + +cl_super_cmd::cl_super_cmd(class cl_sim *asim, + char *aname, + int can_rep, + char *short_hlp, + char *long_hlp, + class cl_cmdset *acommands): + cl_cmd(asim, aname, can_rep, short_hlp, long_hlp) +{ + commands= acommands; +} + +cl_super_cmd::~cl_super_cmd(void) +{ + if (commands) + delete commands; +} + +int +cl_super_cmd::work(class cl_cmdline *cmdline, class cl_console *con) +{ + class cl_cmd *cmd; + + if (!commands) + return(0); + + if (!cmdline->shift()) + { + int i; + con->printf("\"%s\" must be followed by the name of a subcommand\n" + "List of subcommands:\n", (char*)(names->at(0))); + for (i= 0; i < commands->count; i++) + { + cmd= (class cl_cmd *)(commands->at(i)); + con->printf("%s\n", cmd->short_help); + } + return(0); + } + if ((cmd= commands->get_cmd(cmdline)) == NULL) + { + con->printf("Undefined subcommand: \"%s\". Try \"help %s\".\n", + cmdline->name, (char*)(names->at(0))); + return(0); + } + return(cmd->work(cmdline, con)); +} + + +/* + * Command console + *____________________________________________________________________________ + */ + +cl_console::cl_console(char *fin, char *fout, class cl_sim *asim): + cl_base() +{ + FILE *f; + + last_command= NULL; + sim= asim; + in= stdin; + if (fin) + if (f= fopen(fin, "r+"), in= f?f:stdin, !f) + fprintf(stderr, "Can't open `%s': %s\n", fin, strerror(errno)); + out= stdout; + if (fout) + if (f= fopen(fout, "w+"), out= f?f:stdout, !f) + fprintf(stderr, "Can't open `%s': %s\n", fout, strerror(errno)); + prompt= 0; +} + +cl_console::cl_console(FILE *fin, FILE *fout, class cl_sim *asim): + cl_base() +{ + last_command= NULL; + sim= asim; + in = fin; + out= fout; +} + +/* + * use the port number supplied to connect to localhost for + * (by Sandeep) + */ + +#ifdef SOCKET_AVAIL +static int +connect_to_port(int portnum) +{ + int sock= socket(AF_INET,SOCK_STREAM,0); + struct sockaddr_in sin; + + sin.sin_family = AF_INET; + sin.sin_port = htons(portnum); + sin.sin_addr.s_addr = inet_addr("127.0.0.1"); + + if (connect(sock, (struct sockaddr *)&sin, sizeof(sin))) { + fprintf(stderr, "Connect to port %d: %s\n", portnum, strerror(errno)); + return -1; + } + return sock; +} + +cl_console::cl_console(int portnumber, class cl_sim *asim) +{ + int sock= connect_to_port(portnumber); + + last_command= NULL; + sim= asim; + if (!(in= fdopen(sock, "r+"))) + fprintf(stderr, "cannot open port for input\n"); + if (!(out= fdopen(sock, "w+"))) + fprintf(stderr, "cannot open port for output\n"); + //fprintf(stderr, "init socket done\n"); +} +#endif + +int +cl_console::init(void) +{ + cl_base::init(); + welcome(); + flags&= ~CONS_PROMPT; + print_prompt(); + return(0); +} + +cl_console::~cl_console(void) +{ + if (in) + fclose(in); + if (out) + { + fprintf(out, "\n"); + fflush(out); + fclose(out); + } +#ifdef SOCKET_AVAIL + /* if (sock) + { + shutdown(sock, 2); + close(sock); + }*/ +#endif +} + + +/* + * Output functions + */ + +void +cl_console::welcome(void) +{ + fprintf(out, + "ucsim %s, Copyright (C) 1997 Daniel Drotos, Talker Bt.\n" + "ucsim comes with ABSOLUTELY NO WARRANTY; for details type " + "`show w'.\n" + "This is free software, and you are welcome to redistribute it\n" + "under certain conditions; type `show c' for details.\n", + VERSIONSTR); + fflush(out); +} + +void +cl_console::print_prompt(void) +{ + char *p; + + if (flags & (CONS_PROMPT|CONS_FROZEN)) + return; + flags|= CONS_PROMPT; + if (sim->arg_avail('P')) + putc('\0', out); + else + fprintf(out, "%s", prompt?prompt: + ((p= sim->get_sarg(0, "prompt"))?p:"> ")); + fflush(out); +} + +int +cl_console::printf(char *format, ...) +{ + va_list ap; + int ret= 0; + + if (out) + { + va_start(ap, format); + ret= cmd_do_print(out, format, ap); + va_end(ap); + } + return(ret); +} + +void +cl_console::print_bin(long data, int bits) +{ + long mask= 1; + + if (!out) + return; + mask= mask << ((bits >= 1)?(bits-1):0); + while (bits--) + { + fprintf(out, "%c", (data&mask)?'1':'0'); + mask>>= 1; + } +} + +/* + * Input functions + */ + +int +cl_console::match(int fdnum) +{ + if (in && + fileno(in) == fdnum) + return(1); + return(0); +} + +int +cl_console::get_in_fd(void) +{ + return(in?fileno(in):-1); +} + +int +cl_console::input_avail(void) +{ + struct timeval tv; + int i; + + if ((i= get_in_fd()) < 0) + return(0); + fd_set s; + FD_ZERO(&s); + FD_SET(i, &s); + tv.tv_sec= tv.tv_usec= 0; + i= select(i+1, &s, NULL, NULL, &tv); + return(i); +} + +char * +cl_console::read_line(void) +{ + char *s= NULL; + +#ifdef HAVE_GETLINE + if (getline(&s, 0, in) < 0) + return(0); +#else + +# ifdef HAVE_GETDELIM + size_t n= 30; + s= (char *)malloc(n); + if (getdelim(&s, &n, '\n', in) < 0) + { + free(s); + return(0); + } +# else + +# ifdef HAVE_FGETS + s= (char *)malloc(300); + if (fgets(s, 300, in) == NULL) + { + free(s); + return(0); + } +# endif +# endif +#endif + s[strlen(s)-1]= '\0'; + if (s[strlen(s)-1] == '\r') + s[strlen(s)-1]= '\0'; + flags&= ~CONS_PROMPT; + return(s); +} + +int +cl_console::proc_input(void) +{ + int retval; + + if (feof(in)) + { + fprintf(out, "End\n"); + return(1); + } + char *cmd= read_line(); + if (!cmd) + return(1); + if (flags & CONS_FROZEN) + { + sim->stop(resUSER); + flags&= ~CONS_FROZEN; + retval= 0; + } + else + retval= sim->do_cmd(cmd, this); + if (!retval) + print_prompt(); + free(cmd); + return(retval); +} + +/* + * Old version, sim->do_cmd() falls into this if it doesn't find a new + * command object which can handle enetered command + */ + +int +cl_console::interpret(char *cmd) +{ + fprintf(out, "New interpreter does not known this command\n"); + return(0); +} + + +/* + * This console listen on a socket and can accept connection requests + */ +#ifdef SOCKET_AVAIL + +cl_listen_console::cl_listen_console(int serverport, class cl_sim *asim) +{ + last_command= NULL; + sim= asim; + if ((sock= make_server_socket(serverport)) >= 0) + { + if (listen(sock, 10) < 0) + fprintf(stderr, "Listen on port %d: %s\n", + serverport, strerror(errno)); + } + in= out= 0; +} + +int +cl_listen_console::match(int fdnum) +{ + return(sock == fdnum); +} + +int +cl_listen_console::get_in_fd(void) +{ + return(sock); +} + +int +cl_listen_console::proc_input(void) +{ + int newsock; + uint size; + struct sockaddr_in sock_addr; + + size= sizeof(struct sockaddr); + newsock= accept(sock, (struct sockaddr*)&sock_addr, &size); + if (newsock < 0) + { + perror("accept"); + return(0); + } + if (!(in= fdopen(newsock, "r+"))) + fprintf(stderr, "cannot open port for input\n"); + if (!(out= fdopen(newsock, "w+"))) + fprintf(stderr, "cannot open port for output\n"); + sim->cmd->add_console(sim->cmd->mk_console(in, out, sim)); + in= out= 0; + return(0); +} + +#endif /* SOCKET_AVAIL */ + + +/* + * Command interpreter + *____________________________________________________________________________ + */ + +cl_commander::cl_commander(class cl_sim *asim): + cl_base() +{ + cons= new cl_list(1, 1); + actual_console= frozen_console= 0; + sim= asim; +} + +int +cl_commander::init(void) +{ + cl_base::init(); + if (!sim) + return(1); + if (sim->arg_avail('c')) + { + add_console(mk_console(sim->get_sarg('c', 0), + sim->get_sarg('c', 0), sim)); + } +#ifdef SOCKET_AVAIL + if (sim->arg_avail('Z')) + { + add_console(mk_console(sim->get_iarg(0, "Zport"), sim)); + } + if (sim->arg_avail('r')) + { + add_console(mk_console(sim->get_iarg('r', 0), sim)); + } +#endif + if (cons->get_count() == 0) + { + add_console(mk_console(stdin, stdout, sim)); + } + return(0); +} + +cl_commander::~cl_commander(void) +{ + delete cons; +} + +class cl_console * +cl_commander::mk_console(char *fin, char *fout, class cl_sim *asim) +{ + return(new cl_console(fin, fout, asim)); +} + +class cl_console * +cl_commander::mk_console(FILE *fin, FILE *fout, class cl_sim *asim) +{ + return(new cl_console(fin, fout, asim)); +} + +#ifdef SOCKET_AVAIL +class cl_console * +cl_commander::mk_console(int portnumber, class cl_sim *asim) +{ + return(new cl_listen_console(portnumber, asim)); +} +#endif + +void +cl_commander::add_console(class cl_console *console) +{ + console->init(); + cons->add(console); + set_fd_set(); +} + +void +cl_commander::del_console(class cl_console *console) +{ + cons->disconn(console); + set_fd_set(); +} + +void +cl_commander::set_fd_set(void) +{ + int i; + + FD_ZERO(&read_set); + fd_num= 0; + for (i= 0; i < cons->count; i++) + { + int fd; + class cl_console *c= (class cl_console*)(cons->at(i)); + if ((fd= c->get_in_fd()) >= 0) + { + if (fd > fd_num) + fd_num= fd; + FD_SET(fd, &read_set); + } + } + fd_num++; +} + + +/* + * Printing to all consoles + */ + +int +cl_commander::all_printf(char *format, ...) +{ + va_list ap; + int i, ret= 0; + + for (i= 0; i < cons->count; i++) + { + class cl_console *c= (class cl_console*)(cons->at(i)); + if (c->out) + { + va_start(ap, format); + ret= cmd_do_print(c->out, format, ap); + va_end(ap); + } + } + return(ret); +} + +/* + * Printing to actual_console + */ + +int +cl_commander::printf(char *format, ...) +{ + va_list ap; + int ret= 0; + + if (actual_console && + actual_console->out) + { + va_start(ap, format); + ret= cmd_do_print(actual_console->out, format, ap); + va_end(ap); + } + return(ret); +} + +/* + * Printing to consoles which have CONS_DEBUG flag set + */ + +int +cl_commander::debug(char *format, ...) +{ + va_list ap; + int i, ret= 0; + + for (i= 0; i < cons->count; i++) + { + class cl_console *c= (class cl_console*)(cons->at(i)); + if (c->out && + c->flags & CONS_DEBUG) + { + va_start(ap, format); + ret= cmd_do_print(c->out, format, ap); + va_end(ap); + } + } + return(ret); +} + +int +cl_commander::flag_printf(int iflags, char *format, ...) +{ + va_list ap; + int i, ret= 0; + + for (i= 0; i < cons->count; i++) + { + class cl_console *c= (class cl_console*)(cons->at(i)); + if (c->out && + (c->flags & iflags) == iflags) + { + va_start(ap, format); + ret= cmd_do_print(c->out, format, ap); + va_end(ap); + } + } + return(ret); +} + +int +cl_commander::input_avail(void) +{ + struct timeval tv; + int i; + + tv.tv_sec= tv.tv_usec= 0; + active_set= read_set; + i= select(fd_num/*FD_SETSIZE*/, &active_set, NULL, NULL, &tv); + return(i); +} + +int +cl_commander::input_avail_on_frozen(void) +{ + if (!frozen_console) + return(0); + return(frozen_console->input_avail()); +} + +int +cl_commander::wait_input(void) +{ + int i; + + active_set= read_set; + i= select(fd_num/*FD_SETSIZE*/, &active_set, NULL, NULL, NULL); + return(i); +} + +int +cl_commander::proc_input(void) +{ + int i; + + for (i= 0; i < fd_num/*FD_SETSIZE*/; i++) + if (FD_ISSET(i, &active_set)) + { + class cl_console *c; + int j; + for (j= 0; j < cons->count; j++) + { + c= (class cl_console*)(cons->at(j)); + if (c->match(i)) + { + actual_console= c; + int retval= c->proc_input(); + if (retval) + { + del_console(c); + delete c; + } + actual_console= 0; + return(cons->count == 0); + } + } + } + return(0); +} + + +/* End of newcmd.cc */ diff --git a/sim/ucsim/cmd.src/newcmdcl.h b/sim/ucsim/cmd.src/newcmdcl.h new file mode 100644 index 00000000..d384e7fe --- /dev/null +++ b/sim/ucsim/cmd.src/newcmdcl.h @@ -0,0 +1,229 @@ +/* + * Simulator of microcontrollers (cmdcl.h) + * + * Copyright (C) 1999,99 Drotos Daniel, Talker Bt. + * + * To contact author send email to drdani@mazsola.iit.uni-miskolc.hu + * + */ + +/* This file is part of microcontroller simulator: ucsim. + +UCSIM is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. + +UCSIM is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with UCSIM; see the file COPYING. If not, write to the Free +Software Foundation, 59 Temple Place - Suite 330, Boston, MA +02111-1307, USA. */ +/*@1@*/ + +#ifndef CMDCL_HEADER +#define CMDCL_HEADER + + +#include "ddconfig.h" + +#include +#if FD_HEADER_OK +# include HEADER_FD +#endif + +#include "pobjcl.h" + + +/* + * Command line with parameters + */ + +class cl_cmdline: cl_base +{ +public: + char *cmd; + char *name; + class cl_list *params; + class cl_ustrings *tokens; + +public: + cl_cmdline(char *cmd); + virtual ~cl_cmdline(void); + virtual int init(void); + + virtual int split(void); + virtual int shift(void); + virtual int repeat(void); + virtual class cl_cmd_arg *param(int num); + virtual void insert_param(int pos, class cl_cmd_arg *param); +private: + char *skip_delims(char *start); +}; + + +/* + * Command and container + */ + +// simple command +class cl_cmd: public cl_base +{ +public: + class cl_sim *sim; + class cl_strings *names; + int can_repeat; + char *short_help; + char *long_help; + +public: + cl_cmd(class cl_sim *asim, + char *aname, + int can_rep, + char *short_hlp, + char *long_hlp); + ~cl_cmd(void); + + virtual void add_name(char *name); + virtual int name_match(char *aname, int strict); + virtual int name_match(class cl_cmdline *cmdline, int strict); + virtual int syntax_ok(class cl_cmdline *cmdline); + virtual int work(class cl_cmdline *cmdline, class cl_console *con); + virtual int do_work(class cl_cmdline *cmdline, class cl_console *con); +}; + +// Command set is list of cl_cmd objects +class cl_cmdset: public cl_list +{ +public: + class cl_sim *sim; + class cl_cmd *last_command; + +public: + cl_cmdset(class cl_sim *asim); + + virtual class cl_cmd *get_cmd(class cl_cmdline *cmdline); + virtual void del(char *name); + virtual void replace(char *name, class cl_cmd *cmd); +}; + +// subset of commands +class cl_super_cmd: public cl_cmd +{ +public: + class cl_cmdset *commands; + +public: + cl_super_cmd(class cl_sim *asim, + char *aname, + int can_rep, + char *short_hlp, + char *long_hlp, + class cl_cmdset *acommands); + ~cl_super_cmd(void); + + virtual int work(class cl_cmdline *cmdline, class cl_console *con); +}; + + +/* + * Command console + */ + +class cl_console: public cl_base +{ +public: + class cl_sim *sim; + FILE *in, *out; + char *last_command; + int flags; // See CONS_XXXX + char *prompt; + +public: + cl_console(): cl_base() {} + cl_console(char *fin, char *fout, class cl_sim *asim); + cl_console(FILE *fin, FILE *fout, class cl_sim *asim); +#ifdef SOCKET_AVAIL + cl_console(int portnumber, class cl_sim *asim); +#endif + ~cl_console(void); + virtual int init(void); + + virtual void welcome(void); + virtual void print_prompt(void); + virtual int printf(char *format, ...); + virtual void print_bin(long data, int bits); + virtual int match(int fdnum); + virtual int get_in_fd(void); + virtual int input_avail(void); + virtual char *read_line(void); + virtual int proc_input(void); + virtual bool interpret(char *cmd); + virtual bool old_command(class cl_cmdline *cmdline) { return(FALSE); } +}; + +#ifdef SOCKET_AVAIL +class cl_listen_console: public cl_console +{ +public: + int sock; +public: + cl_listen_console(int serverport, class cl_sim *asim); + + virtual void welcome(void) {} + virtual void prompt(void) {} + + virtual int match(int fdnum); + virtual int get_in_fd(void); + virtual int proc_input(void); +}; +#endif + + +/* + * Command interpreter + */ + +class cl_commander: public cl_base +{ +public: + class cl_list *cons; + fd_set read_set, active_set; + int fd_num; + class cl_sim *sim; + class cl_console *actual_console, *frozen_console; + +public: + cl_commander(class cl_sim *asim); + ~cl_commander(void); + virtual int init(void); + + virtual class cl_console *mk_console(char *fin, char *fout, + class cl_sim *asim); + virtual class cl_console *mk_console(FILE *fin, FILE *fout, + class cl_sim *asim); +#ifdef SOCKET_AVAIL + virtual class cl_console *mk_console(int portnumber, class cl_sim *asim); +#endif + void add_console(class cl_console *console); + void del_console(class cl_console *console); + void set_fd_set(void); + + int all_printf(char *format, ...); // print to all consoles + int printf(char *format, ...); // print to actual_console + int debug(char *format, ...); // print consoles with debug flag set + int flag_printf(int iflags, char *format, ...); + int input_avail(void); + int input_avail_on_frozen(void); + int wait_input(void); + int proc_input(void); +}; + + +#endif + +/* End of cmdcl.h */ diff --git a/sim/ucsim/cmd.src/set.cc b/sim/ucsim/cmd.src/set.cc new file mode 100644 index 00000000..26ed424b --- /dev/null +++ b/sim/ucsim/cmd.src/set.cc @@ -0,0 +1,73 @@ +/* + * Simulator of microcontrollers (set.cc) + * + * Copyright (C) 1999,99 Drotos Daniel, Talker Bt. + * + * To contact author send email to drdani@mazsola.iit.uni-miskolc.hu + * + */ + +/* This file is part of microcontroller simulator: ucsim. + +UCSIM is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. + +UCSIM is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with UCSIM; see the file COPYING. If not, write to the Free +Software Foundation, 59 Temple Place - Suite 330, Boston, MA +02111-1307, USA. */ +/*@1@*/ + +#include "ddconfig.h" + +// sim +#include "simcl.h" + +// local +#include "cmdsetcl.h" + + +/* + * SET TIMER + */ + +int +cl_set_cmd::timer(class cl_cmdline *cmdline, class cl_console *con) +{ + class cl_cmd_arg *params[4]= { cmdline->param(0), + cmdline->param(1), + cmdline->param(2), + cmdline->param(3) }; + int what, dir; + class cl_ticker *ticker; + + if (params[1] == 0) + { + con->printf("Timer number is missing\n"); + return(0); + } + what= (params[1])->get_ivalue(); + if ((ticker= sim->uc->get_counter(what)) != 0) + { + con->printf("Timer %d already exists\n", what); + return(0); + } + if (params[2] != 0) + dir= (params[2])->get_ivalue(); + else + dir= 1; + ticker= new cl_ticker(dir, 0, 0); + sim->uc->add_counter(ticker, what); + + return(0); +} + + +/* End of set.cc */ diff --git a/sim/ucsim/cmd.src/syntax.cc b/sim/ucsim/cmd.src/syntax.cc new file mode 100644 index 00000000..76841e25 --- /dev/null +++ b/sim/ucsim/cmd.src/syntax.cc @@ -0,0 +1,31 @@ +/* + * Simulator of microcontrollers (syntax.cc) + * + * Copyright (C) 1999,99 Drotos Daniel, Talker Bt. + * + * To contact author send email to drdani@mazsola.iit.uni-miskolc.hu + * + */ + +/* This file is part of microcontroller simulator: ucsim. + +UCSIM is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. + +UCSIM is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with UCSIM; see the file COPYING. If not, write to the Free +Software Foundation, 59 Temple Place - Suite 330, Boston, MA +02111-1307, USA. */ +/*@1@*/ + +// local +#include "syntaxcl.h" + +/* End of syntax.cc */ diff --git a/sim/ucsim/cmd.src/syntaxcl.h b/sim/ucsim/cmd.src/syntaxcl.h new file mode 100644 index 00000000..57a2e015 --- /dev/null +++ b/sim/ucsim/cmd.src/syntaxcl.h @@ -0,0 +1,33 @@ +/* + * Simulator of microcontrollers (syntaxcl.h) + * + * Copyright (C) 1999,99 Drotos Daniel, Talker Bt. + * + * To contact author send email to drdani@mazsola.iit.uni-miskolc.hu + * + */ + +/* This file is part of microcontroller simulator: ucsim. + +UCSIM is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. + +UCSIM is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with UCSIM; see the file COPYING. If not, write to the Free +Software Foundation, 59 Temple Place - Suite 330, Boston, MA +02111-1307, USA. */ +/*@1@*/ + +#ifndef SYNTAXCL_HEADER +#define SYNTAXCL_HEADER + +#endif + +/* End of syntaxcl.h */ diff --git a/sim/ucsim/cmd.src/timer.cc b/sim/ucsim/cmd.src/timer.cc new file mode 100644 index 00000000..51f88748 --- /dev/null +++ b/sim/ucsim/cmd.src/timer.cc @@ -0,0 +1,266 @@ +/* + * Simulator of microcontrollers (timer.cc) + * + * Copyright (C) 1999,99 Drotos Daniel, Talker Bt. + * + * To contact author send email to drdani@mazsola.iit.uni-miskolc.hu + * + */ + +/* This file is part of microcontroller simulator: ucsim. + +UCSIM is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. + +UCSIM is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with UCSIM; see the file COPYING. If not, write to the Free +Software Foundation, 59 Temple Place - Suite 330, Boston, MA +02111-1307, USA. */ +/*@1@*/ + +#include "ddconfig.h" + +#include "stdio.h" +#include "i_string.h" + +// sim +#include "simcl.h" + +// local +#include "cmdsetcl.h" +#include "newcmdcl.h" + + +/* + * Command: timer + *---------------------------------------------------------------------------- + */ + +int +cl_timer_cmd::do_work(class cl_cmdline *cmdline, class cl_console *con) +{ + char *s; + + if (cmdline->param(0) == 0) + { + if (long_help) + con->printf("%s\n", long_help); + else + con->printf("What to do?\n"); + return(0); + } + if ((s= cmdline->param(0)->get_svalue())) + { + if (cmdline->param(1) == 0) + { + con->printf("Timer number is missing\n"); + return(0); + } + set_ticker(cmdline->param(1)); + if (strstr(s, "c") == s || + strstr(s, "m") == s || + strstr(s, "a") == s) + return(add(cmdline, con)); + else if (strstr(s, "d") == s) + return(del(cmdline, con)); + else if (strstr(s, "g") == s) + return(get(cmdline, con)); + else if (strstr(s, "r") == s) + return(run(cmdline, con)); + else if (strstr(s, "s") == s) + return(stop(cmdline, con)); + else if (strstr(s, "v") == s) + return(val(cmdline, con)); + else + con->printf("Undefined timer command: \"%s\". Try \"help timer\"\n", + s); + } + return(0); +} + +void +cl_timer_cmd::set_ticker(class cl_cmd_arg *param) +{ + if ((name= param->get_svalue()) == 0) + what= param->get_ivalue(); + if (name) + ticker= sim->uc->get_counter(name); + else + ticker= sim->uc->get_counter(what); +} + +/* + * Add a new timer to the list + */ + +int +cl_timer_cmd::add(class cl_cmdline *cmdline, class cl_console *con) +{ + class cl_cmd_arg *params[4]= { cmdline->param(0), + cmdline->param(1), + cmdline->param(2), + cmdline->param(3) }; + int dir= +1, in_isr= 0; + + if (!name && + what < 1) + { + con->printf("Timer id must be greater then zero or a string\n"); + return(0); + } + if (ticker) + { + if (name) + con->printf("Timer \"%s\" already exists\n", name); + else + con->printf("Timer %d already exists\n", what); + return(0); + } + if (params[2] != 0) + dir= (params[2])->get_ivalue(); + if (params[3] != 0) + in_isr= (params[3])->get_ivalue(); + + if (name) + { + ticker= new cl_ticker(dir, in_isr, name); + sim->uc->add_counter(ticker, name); + } + else + { + ticker= new cl_ticker(dir, in_isr, 0); + sim->uc->add_counter(ticker, what); + } + + return(0); +} + +/* + * Delete a timer from the list + */ + +int +cl_timer_cmd::del(class cl_cmdline *cmdline, class cl_console *con) +{ + if (!ticker) + { + if (name) + con->printf("Timer \"%s\" does not exist\n", name); + else + con->printf("Timer %d does not exist\n", what); + return(0); + } + if (name) + sim->uc->del_counter(name); + else + sim->uc->del_counter(what); + + return(0); +} + +/* + * Get the value of just one timer or all of them + */ + +int +cl_timer_cmd::get(class cl_cmdline *cmdline, class cl_console *con) +{ + if (ticker) + ticker->dump(what, sim->uc->xtal, con); + else + { + sim->uc->ticks->dump(0, sim->uc->xtal, con); + sim->uc->isr_ticks->dump(0, sim->uc->xtal, con); + sim->uc->idle_ticks->dump(0, sim->uc->xtal, con); + for (what= 0; what < sim->uc->counters->count; what++) + { + ticker= sim->uc->get_counter(what); + if (ticker) + ticker->dump(what, sim->uc->xtal, con); + } + } + + return(0); +} + +/* + * Allow a timer to run + */ + +int +cl_timer_cmd::run(class cl_cmdline *cmdline, class cl_console *con) +{ + if (!ticker) + { + if (name) + con->printf("Timer %d does not exist\n", name); + else + con->printf("Timer %d does not exist\n", what); + return(0); + } + ticker->options|= TICK_RUN; + + return(0); +} + +/* + * Stop a timer + */ + +int +cl_timer_cmd::stop(class cl_cmdline *cmdline, class cl_console *con) +{ + if (!ticker) + { + if (name) + con->printf("Timer %d does not exist\n", name); + else + con->printf("Timer %d does not exist\n", what); + return(0); + } + ticker->options&= ~TICK_RUN; + + return(0); +} + + +/* + * Set a timer to a specified value + */ + +int +cl_timer_cmd::val(class cl_cmdline *cmdline, class cl_console *con) +{ + class cl_cmd_arg *params[4]= { cmdline->param(0), + cmdline->param(1), + cmdline->param(2), + cmdline->param(3) }; + + if (!ticker) + { + if (name) + con->printf("Timer %d does not exist\n", name); + else + con->printf("Timer %d does not exist\n", what); + return(0); + } + if (params[2] == 0) + { + con->printf("Value is missing\n"); + return(0); + } + long val= (params[2])->get_ivalue(); + ticker->ticks= val; + + return(0); +} + + +/* End of timer.cc */ diff --git a/sim/ucsim/doc/Makefile.in b/sim/ucsim/doc/Makefile.in new file mode 100644 index 00000000..37486cb5 --- /dev/null +++ b/sim/ucsim/doc/Makefile.in @@ -0,0 +1,79 @@ +# +# uCsim doc/Makefile +# +# (c) Drotos Daniel, Talker Bt. 1997 +# + +STARTYEAR = 1997 + +SHELL = /bin/sh +INSTALL = @INSTALL@ + +PRJDIR = .. + +prefix = @prefix@ +exec_prefix = @exec_prefix@ +bindir = @bindir@ +libdir = @libdir@ +datadir = @datadir@ +includedir = @includedir@ +mandir = @mandir@ +man1dir = $(mandir)/man1 +man2dir = $(mandir)/man2 +infodir = @infodir@ +srcdir = @srcdir@ +docdir = $(prefix)/doc/ucsim + + +# Compiling entire program or any subproject +# ------------------------------------------ +all: doc + +doc: checkconf + +# Compiling and installing everything and runing test +# --------------------------------------------------- +install: all installdirs + cp *.html $(docdir) + cp *.gif $(docdir) + cp *.jpg $(docdir) + cp *.fig $(docdir) + + +# Deleting all the installed files +# -------------------------------- +uninstall: + rm -f $(docdir)/* + + +# Performing self-test +# -------------------- +check: + + +# Performing installation test +# ---------------------------- +installcheck: + + +# Creating installation directories +# --------------------------------- +installdirs: + test -d $(docdir) || $(INSTALL) -d $(docdir) + + +# Creating dependencies +# --------------------- +include clean.mk + +# My rules +# -------- + +# Remaking configuration +# ---------------------- +checkconf: + @if [ -f $(PRJDIR)/devel ]; then\ + $(MAKE) -f conf.mk srcdir="$(srcdir)" PRJDIR="$(PRJDIR)" freshconf;\ + fi + +# End of s51.src/Makefile.in diff --git a/sim/ucsim/doc/UCsim.jpg b/sim/ucsim/doc/UCsim.jpg new file mode 100644 index 0000000000000000000000000000000000000000..57ee188eefb850026a1aa5f83bf27f200b8f5db7 GIT binary patch literal 5540 zcmbW4XHXMdm&X%YATZJ)AWeD+z4sZ$9Gj?^u$Zi{tOOgcp@9~guVWy>jZIWY zjE{}YD9G`NdtexwBAc`%l+D=7$0yLu-P`rf7Xja*0qOu^A|enGAu$L9A|W9LlhJ_5 zNJ+^UsHn+lm>F4Fm>HRv*f@oF*w~>QOiaAed{7Zl2?+^S9$7^hF$E!U39)~Q07*zl z$VkZ`U@%1N0n-Dq|Fdqp0hGi5Gr%A|kR5XpDg4q3N#Nx7wi8<8jduZX) z2b|(g{_!MWI(i5LBNsOhFCV{zq?ELbtepBo4NWa=9bID+Q!{f5ODlx4%VSqJcaMO; zpx}_uu<)k|iAl-No~LBzynL0L_d36zt!=%1{R4wT!y}_J zvvczci%ZKZ7%XmMb8Gv@&hFvS@yY4g`Nf~hf4G1E{C{KJ?f(Y*A6%4oTzCWo_ynMT zxPW*ecMG4AfbfAR5tXVD$kC6QT`Z26MlGwjzK4WE9DYFS0$ebM+y%RAg&~8xZMm9Qozs@_iUj z4pbcfXqzmm@)RKIOt`GGsjt*JMI9PHrnYo0P0HZ+ir}0e=vu(oVBv|RwMJ`Gs}2W; zET~K#7@d-~&z`0(kph%qn!i60qgT(mLtpoCz5-aL5pWAQD7Xk6wDB-p5BgK34qKF1 zHNH{U$GyDdn*g{OsmL-Jseo6nCSLCq&Q`uX`J#>734pJ;E^>mMZ z&?qdXJxPK~Q@njH+H^OX?9fDs`|Em}jyU%>nJGX0n&PM@K_;foFPq{OjvzOt@-jBA zU4ZZz;9No?K~5|m%fmE=)mYPAm`A+eBB$=Inds<)-KYtGL8@gy>b>QXw;BK%I2~9l z+?4OsQ{D}!pOO=sqM(h#-9$4si1KTOsRc(?(nCo5~zi#^Z}b z+?61yHlHUu%=ZYNWfqA_ThB-(jXYlQ{M9_uD*{1w*@v%lUicnaYgB@xxMwoM1~>b_ z&r0Lb+EYe5*E2Y?!3o)av~1fID!-JdzGYM;+wFqKt9+>icQNp3;L{D zq%UNQbeqcMM3s=pCf@I+b-IzYui6{*s&r1S?B$NTXH(u!koIkPCAP`jy;P>g_b`YR0P!yVc6%*wa1Jeb<(SQt4dre%;;;mkb9I4x$W(UGmZk(O+0n zf<#=qe{NjzVcKfiod4y>DmiX<;b<@TgXP}a zz&B~;CJSh7RBDyxzRtJmZW*RiHq#Gv(_HdsEYTLTC{qyzzSCq?O<(^rhOWawB7-yz zAtpcG?QL8bP;fNiY1CGKP?KNo*?i;?uuC;u%n|_6Fcb-8+Lok2f};%ZBLc92d1~6@ zMV`QvRH+&8DM)he#T4*6dU+tGe942_TCJY50a~fTpa^2tsZ52U#NX0~D`H{D{OQLxA5_1m7dxU^F8$#$P4drI0pyD7Ua8}!=>4wm=mYft5VIp|8f z`%dWu86%W`Cij`tfKj$(;}qoD^Yz@dIELZWQb-vinrH@Rm>rFL`aP3>lW-I@ml9MY zKdWw!o&THu5vwnCGxNu4{>^As&fC}n*oMAKD9^z0#l4$ty*a_{RA`x{GyGFRFvlX~ z<1L`KI>)^6%05{#;R}iiv)rQr8G4is<3LvjvG68i&Z^75NiIHvlm3=v+!UE)G#TxZ z!O1WTm2rWgOS&zcp;hPH%FKceb1QDub`~jwh}3(XF=e)gjV zT75+3yj_dYnQ1W^q7EvVJMBug6K*{$YrJ3n%4)TKvsR$JUG#T`?nxq$o?)s&^7s}I z7o>5(U0(3;oD!9IB-k(QL3}U48KEc!jv%vRZ)yiO!^`^9dMle_sP`;&JP{v+cDKIe zkuU(Vb$$`Km4CwUmaVpEe-G<=cUF?6@oCe)lvVdQ=K19~qfoN)Td%rFa0Q5g=QDe& z%ngU<7rKL}uCv5;ov;VJjfME9CpA2S%2dMF*2RCbZvh6PP5N2Z!IRG{?hpawQ5M+hT@@&2-gEaMeM|q~)nL_!fW1@+=mif-Wq-*@5alE@cl0(Mh8>)^5ljN?m{rnoHG;B9zkfL9&V(i`xAxy3T8O)z@ zeJCPaixVpH>rj>8=2;rBCP2i?{;X->D$docvOQtEebOGC+tpbU+9^ae}!-rbRj&m)boL_O`@A5SFm&(s&s)$hh> zTwUoA5vz(&Ql9>}gN?fMt`)ZJ+54$lyC9q$d^<@Nafry5#* zUv;FW4E3o^ZUG4%i+xssgHukl1)E{~Vg{hajP8PC`JyBa-Noqc<4?B$wy529EyXU~ zOS+l)C!Z`=FNO42x9!B~>Q<6d_jA|OLI^7SV6SPx5^58Hxrg}t*0QI}P0VUFz4&#satv{Rkjkcvy+DnDL z?=wf@EzY5*c$RbZr}e0Dp7@K*B(T=9)6uRlRsU~*<)+Iki{v28u;G#n)4fyS-l`CksvNIi3)7+iwyG-V zz&`23M>H1~+OAy`Ao?uHaI-#LH=lJY;T6&WGT@BD#?9wCbxHr}5$EU5SBu^Qp$O>bWB3vQVTW#RT?m3$Qy zqfwi;0P1MYAslz}?8y?dM5ri#ReZKM4ipS|n(lX66QO(Pb@sG!Ct%5Dvfi3`MoVyvUwi>%+gnuc@#KQpD%LL-k@|;V?3s$o*TA8G z#X!J~M9wBFe?@hE)h&Q{J7Hh)M_`(4kbCZWWf``1U)Axuj0~$TjDG2xn-cSEAhQfz zlGc^;qTdGddYjiU4kBAcwPA8*@m+AntJd?|Nej?z$M+rX~MC2u{ z`+y2({9$VIvI63BOjN9(n`&V(aD6BmJy=YTdk|yLwXDmmC&Et>BSjGNebM;3vp90Td zot(Tt;!v4W+2R3vzd^W>H@Zkm>Z8PYEp5jFc4bs6>7oHgP$}nt#08TZEv|Hs_rRoz zYd#${ims7BqjsCi4(*M*W}4c0DG6Uny&yYlh{d`-s_$fWfT27s3SEYYu10;T{+QrjZUYui&|9v z`EI57rE!NAP9HJwlg9i7Q}A^2X1ZkeRJF&2=J<&3YrCWmLH8xfG*q8NBq#Yer;k4< zU{^cd;xoSV)3BH>32ZbR%Sy+ljDOojbs9-{aYrn|*Q~N>LL`supLf`XU?(EicC}~K zYM*)0WOadJ{idTLkZbRMf;GQiX}HuIWwGz&s>!6m9Dmz1=O5(tS=m+neb;>B9J{H0 zL@4n~&;0A5J`A3ZYnY4F!sNSrP9jW_MFgikbjT)}?jFRMD5&DXf~p`V?RxahvoBd+ zigGQTjGRmg{I~^Bxt}dAfbr4q@5Or6LKh=xq{PtZSa}Ci{`B()(=W^v;PU2g$LgTJ zM_5j4-7(ha&9(JkMsYt=ew}ZcdlN*CxnXIQwYq3QFWcFkV<+b7VY1(&FOq2-{A-r zTgpDS8}gu)0g@AJ8`_?@>X_a2t5bWFyumZIR-^7}u4auNgzOpObJv_{3}^_5<<)lh zR9{|!c|L92KFH5rOUEr;7O$!~hZGN-uE~qPHGECN>Cn$E-#9V^Fh*kvM%M!9x|uG) zm-lRmh;f{}oTo}CI5QtZT;Ly&#*lr0#sFeFqKI&mqEgc|j9Ipv9<$dIJN)J)f=sdM z$DcrA7q3ClDMh|y_0)%lmG?B|j6YlaneX6$f<}*y`r-z(k$7P}P9HhSnFZF^55^xo zoGeoM#<~eh)=1&zaM(_NDMi9UFC1U6G+4#3@`oe+loLsKOr!iN9hY)0UrlH=Vn0TR zeUPMeHw;;oF>>lr+$WM}HPYze=*1k^WPlsAhKCi*T`J8~f ze%_K;k&n~wTH4GE#cU{tR6->^?z^NrfU0SX@x5i}9X>RvF!Gk-O@L8V6(>`h6Q-Zz zoJqNfw24yq;yk8<^KSX C&s~)O literal 0 HcmV?d00001 diff --git a/sim/ucsim/doc/analyzer.html b/sim/ucsim/doc/analyzer.html new file mode 100644 index 00000000..08c91d97 --- /dev/null +++ b/sim/ucsim/doc/analyzer.html @@ -0,0 +1,35 @@ + + +UCSIM: Code Analyzer + + + + +

Code analyzer

+ +This feature is included into both DOS and UNIX versions. Code +analyzer analyzes the code of the simulated program and tries to +figure out which address contains valid instruction. Analyzer starts +analyzing of the code with address 0 which always must contain an +instruction because reset of the device sets zero into program +counter. So, analyzer marks address 0 that it contains an +instruction. Then it marks the address of the next instruction and so +on. If the analyzer finds a jump instruction it continues with +destination address of the jump instruction. If it finds a +call instruction, it recursively analyzes destination address +as well as next instruction follows the call one. Analyzator +stops if it finds an address which is already marked or if it finds a +return instruction or an indirect jump which is +impossible to follow. All these mean that it is impossible to discover +all instructions of the program. + +

This problem is solved in very simple way in UNIX version. If the +execution reaches an umarked address, the analyzer is called to +analyze the code starting at actual address pointed by the PC. This +method is not included into DOS version but this re-analyzation can be +requested by pressing Ctrl-F7 at any time. + +

+ + + diff --git a/sim/ucsim/doc/burst.gif b/sim/ucsim/doc/burst.gif new file mode 100644 index 0000000000000000000000000000000000000000..fbdcf575f78a5ebbd3eeac5bbd9f963962ab664f GIT binary patch literal 235 zcmZ?wbhEHb6k!l!IK;s49|+DEpZWiPW*S3UTAH!3F#{MV{__jT$ShV!EGkg|Qki)Q zB^jv-1*J(jnaK(%`MHUid3p-osbxS3kJ9vv)M6clY!ENQAvLo^FF8L~MXn zDYZz!(9+VBLGdRGBLf2ygAT}iknIf2aT>es{4+SUl4tW3o}3LYCJ5%-`ZlvqY)y_i zON{zvlk8Qc_r#nUUz;+oS7*8wAfNp1ThKa>J&QI6cbF|deBP(?&CiC}j@vi=I#{!y ctx@66$5l65-@mTg36FLd3o%#&030@6>Hq)$ literal 0 HcmV?d00001 diff --git a/sim/ucsim/doc/clean.mk b/sim/ucsim/doc/clean.mk new file mode 100644 index 00000000..74b12cbe --- /dev/null +++ b/sim/ucsim/doc/clean.mk @@ -0,0 +1,22 @@ +# Deleting all files created by building the program +# -------------------------------------------------- +clean: + rm -f *core *[%~] *.[oa] + rm -f .[a-z]*~ + + +# Deleting all files created by configuring or building the program +# ----------------------------------------------------------------- +distclean: clean + rm -f Makefile *.dep + + +# Like clean but some files may still exist +# ----------------------------------------- +mostlyclean: clean + + +# Deleting everything that can reconstructed by this Makefile. It deletes +# everything deleted by distclean plus files created by bison, etc. +# ----------------------------------------------------------------------- +realclean: distclean diff --git a/sim/ucsim/doc/cmd.html b/sim/ucsim/doc/cmd.html new file mode 100644 index 00000000..84e7ec23 --- /dev/null +++ b/sim/ucsim/doc/cmd.html @@ -0,0 +1,90 @@ + + +Commands of s51 + + + + +

Command reference of ucsim

+ +General commands and information + + + +Execution + + + +Breakpoints + + + +Dump commands + + + +Set commands + + + +
+ + + diff --git a/sim/ucsim/doc/cmd_bp.html b/sim/ucsim/doc/cmd_bp.html new file mode 100644 index 00000000..ca7cefec --- /dev/null +++ b/sim/ucsim/doc/cmd_bp.html @@ -0,0 +1,206 @@ + + +Breakpoints commands of uCsim + + + + + + +

Commands of uCsim to manage breakpoints

+ +Two kind of breakpoints can be used: fetch and event +breakpoint. Fetch breakpoints are classical breakpoints. They +can be placed at any instruction in the code memory. Breakpoint will +be hit if CPU fetches instruction code from the memory location +specified by the breakpoint. Only fetching of first byte of the +instruction hits the breakpoint. If the execution reaches a breakpoint +it stops before the instruction at location specified by the +breakpoint would be executed. + +

Event breakpoints are special onces. They cause stop of +execution if event specified by the breakpoint occures. Events are: + +

wi
writing into internal RAM at specified location; + +
ri
reading from internal RAM at specified address; + +
wx
writing into external RAM at specified location +(MOVX instruction); + +
rx
reading from external RAM at specified address (MOVX +instruction); + +
ws
writing into SFR area at specified location; + +
rs
reading from SFR area at specified address; + +
rc
reading from code memory at specified location (MOVC +instruction).
+ +Event breakpoint stops execution after specified event occured. + +

Every breakpoint can be fix (permanent) or dynamic +(temporary). Dynamic breakpoints are automatically removed when they +reached. Some commands place dynamic fetch breakpoints into the code, +for example go or next. + +

A hit number can be associated to any breakpoint. This hit +number specifies how many times the breakpoint must be hit before it +causes the execution to stop. This hit number is 1 by default. + + +

break addr [hit]

+

tbreak addr [hit]

 + +Set fetch breakpoint. The command specifies if the breakpoint will be +fix (break) or dynamic (temporary) (tbreak). First +parameter specifies address where the breakpoint must be placed to. It +should be address of an instruction. + +

Second parameter is optional and it specifies the hit number. It is +1 by default. + +

+$ s51 remoansi.hex
+ucsim 0.2.24, Copyright (C) 1997 Daniel Drotos, Talker Bt.
+ucsim comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+This is free software, and you are welcome to redistribute it
+under certain conditions; type `show c' for details.
+58659 bytes read from remoansi.hex
+> dc 0 0x10
+   000000 02 01 60 LJMP  0160
+ * 000003 02 00 3c LJMP  003c
+ * 000006 ff       MOV   R7,A
+ * 000007 ff       MOV   R7,A
+ * 000008 ff       MOV   R7,A
+ * 000009 ff       MOV   R7,A
+ * 00000a ff       MOV   R7,A
+ * 00000b 02 3b e0 LJMP  3be0
+ * 00000e ff       MOV   R7,A
+ * 00000f ff       MOV   R7,A
+ * 000010 ff       MOV   R7,A
+> break 0x160
+Breakpoint 1 at 0x000160: CLR   P1.0
+> tbreak 8 2
+Breakpoint 2 at 0x000008: MOV   R7,A
+> g
+Simulation started, PC=0x000000
+Stop at 000160: (4) Breakpoint
+F 000160
+>
+ + +

bse wi|ri|wx|rx|ws|rs|rc f|d addr [hit]

 + +Set event breakpoint. First parameter specifies type of event. See general description of event breakpoints above +about meaning of event identifiers. Second parameter specify if the +breakpoint will be fix (f) or dynamic (d). Third +parameter specifies address. Remember that this is not an instruction +address, it is address of the memory cell where specified event should +occur. + +

Forth parameter is optional and it specifies the hit number. It is +1 by default. + +

+$ s51 remoansi.hex
+ucsim 0.2.12, Copyright (C) 1997 Daniel Drotos, Talker Bt.
+ucsim comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+This is free software, and you are welcome to redistribute it
+under certain conditions; type `show c' for details.
+58659 bytes read from remoansi.hex
+> dis
+   00d47e 22       RET
+   000000 02 01 60 LJMP  0160
+   000160 c2 90    CLR   P1.0
+   000162 c2 97    CLR   P1.7
+   000164 d2 b5    SETB  P3.5
+   000166 d2 b4    SETB  P3.4
+   000168 75 81 22 MOV   SP,#22
+   00016b 75 d0 00 MOV   PSW,#00
+   00016e 7e 00    MOV   R6,#00
+   000170 7f 00    MOV   R7,#00
+   000172 79 04    MOV   R1,#04
+   000174 12 0d b8 LCALL 0db8
+   000177 0f       INC   R7
+   000178 d9 fa    DJNZ  R1,0174
+   00017a 75 0b 00 MOV   0b,#00
+   00017d 75 0c 00 MOV   0c,#00
+   000180 02 02 2a LJMP  022a
+   000183 78 22    MOV   R0,#22
+   000185 76 00    MOV   @R0,#00
+   000187 d8 fc    DJNZ  R0,0185
+> bse wi f 6
+> g
+4
+   000170 7f 00    MOV   R7,#00
+>
+ + +

clear [addr...]

 + +Delete fetch breakpoint. Parameter specifies address of breakpoint. If +there is no breakpoint specified at given address this command prints +out a warning message. + +

If parameter is not given then breakpoint at current PC will be +deleted if it exists. If more than one address is specified then all +breakpoints at specified addresses will be deleted. + +

+> i b
+Num Type       Disp Hit   Cnt   Address  What
+1   fetch      keep 1     1     0x000160 CLR   P1.0
+2   fetch      del  1     1     0x000180 LJMP  022a
+1   event      keep 1     1     0x000006 wi
+> clear 160
+No breakpoint at 0000a0
+> clear 0x160
+> i b
+Num Type       Disp Hit   Cnt   Address  What
+2   fetch      del  1     1     0x000180 LJMP  022a
+1   event      keep 1     1     0x000006 wi
+>
+ + +

bde wi|ri|wx|rx|ws|rs|rc addr

 + +Delete event breakpoint. First parameter must be given to specify type +of event. Second parameter is address of memory cell which the +breakpoint is associated to. Continuing example given above: + +
+> bl
+D 2(2) 000180 02 LJMP  022a
+F 1(1) 000006 wi
+> bde ri 6
+No ri breakpoint at 000006
+> bde wi 6
+> bl
+D 2(2) 000180 02 LJMP  022a
+>
+ + +

ba

 + +Delete all breakpoints. This command deletes all fetch as well as +event breakpoints. Be carefull because it does not ask you to confirm +your intention. + +
+> bl
+F 1(1) 000160 c2 CLR   P1.0
+D 2(2) 000180 02 LJMP  022a
+F 1(1) 000006 wi
+> ba
+> bl
+>
+ + +
+ + + diff --git a/sim/ucsim/doc/cmd_dump.html b/sim/ucsim/doc/cmd_dump.html new file mode 100644 index 00000000..3859e1e2 --- /dev/null +++ b/sim/ucsim/doc/cmd_dump.html @@ -0,0 +1,390 @@ + + +Dump commands of uCsim + + + + + + +

Dump commands of uCsim

+ +

[Repeatable] dis +[start [offset [lines]]]

 + +Disassemble code. This command can be used to list disassembled +instructions which discovered by the code analyzer. First two +parameters specify the address where the list starts. First parameter +is address where the command starts to search an instruction. This +search goes forward. When the first instruction marked by code +analyzer found the simulator skips as many instructions as you specify +in second parameter. If offset is negative the simulator goes +backward and skips specified number of instructions. Default value of +start parameter is last address which was listed by previous +dis command and default value of offset is -1. It means +you can make continuous list repeating parameterless dis +command. + +

In third parameter you can specify how many instructions you want +to list. Default value is 20. + +

+$ s51 remoansi.hex
+ucsim 0.2.12, Copyright (C) 1997 Daniel Drotos, Talker Bt.
+ucsim comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+This is free software, and you are welcome to redistribute it
+under certain conditions; type `show c' for details.
+58659 bytes read from remoansi.hex
+> dis
+   00d47e 22       RET
+   000000 02 01 60 LJMP  0160
+   000160 c2 90    CLR   P1.0
+   000162 c2 97    CLR   P1.7
+   000164 d2 b5    SETB  P3.5
+   000166 d2 b4    SETB  P3.4
+   000168 75 81 22 MOV   SP,#22
+   00016b 75 d0 00 MOV   PSW,#00
+   00016e 7e 00    MOV   R6,#00
+   000170 7f 00    MOV   R7,#00
+   000172 79 04    MOV   R1,#04
+   000174 12 0d b8 LCALL 0db8
+   000177 0f       INC   R7
+   000178 d9 fa    DJNZ  R1,0174
+   00017a 75 0b 00 MOV   0b,#00
+   00017d 75 0c 00 MOV   0c,#00
+   000180 02 02 2a LJMP  022a
+   000183 78 22    MOV   R0,#22
+   000185 76 00    MOV   @R0,#00
+   000187 d8 fc    DJNZ  R0,0185
+> bs f 0x180
+> bs d 0x189
+> dis 0x180 -3 10
+   000178 d9 fa    DJNZ  R1,0174
+   00017a 75 0b 00 MOV   0b,#00
+   00017d 75 0c 00 MOV   0c,#00
+F  000180 02 02 2a LJMP  022a
+   000183 78 22    MOV   R0,#22
+   000185 76 00    MOV   @R0,#00
+   000187 d8 fc    DJNZ  R0,0185
+D  000189 22       RET
+   00018a 90 09 ec MOV   DPTR,#09ec
+   00018d ae 83    MOV   R6,DPH
+>
+ +If there is an F or D character at the beginning of the +line, it means that there is a fix or dynamic fetch breakpoint at +listed address. Next element on the list can be an asterix (*) +which means that the listed address is not marked by the code +analyzer. dis lists marked instructions only so asterix never +appears in the list. Next element of the list is address displayed as +six digit hexadecimal number. Address is followed by hexadecimal dump +of instruction's code. Last element of the list is disassembled +instruction. Every number appeared on the list is hexadecimal number. + + +

[Repeatable] dc +[start [stop]]

 + +Disassembled dump of code memory area. This command simply produces +disassambled list of memory area specified by the parameters. Default +value of start parameter is last address listed by previous +dc command. If stop parameter is not given 20 lines are +listed. + +
+$ s51 remoansi.hex 
+ucsim 0.2.12, Copyright (C) 1997 Daniel Drotos, Talker Bt.
+ucsim comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+This is free software, and you are welcome to redistribute it
+under certain conditions; type `show c' for details.
+58659 bytes read from remoansi.hex
+> dc
+   000000 02 01 60 LJMP  0160
+ * 000003 02 00 3c LJMP  003c
+ * 000006 ff       MOV   R7,A
+ * 000007 ff       MOV   R7,A
+ * 000008 ff       MOV   R7,A
+ * 000009 ff       MOV   R7,A
+ * 00000a ff       MOV   R7,A
+ * 00000b 02 3b e0 LJMP  3be0
+ * 00000e ff       MOV   R7,A
+ * 00000f ff       MOV   R7,A
+ * 000010 ff       MOV   R7,A
+ * 000011 ff       MOV   R7,A
+ * 000012 ff       MOV   R7,A
+ * 000013 02 00 ac LJMP  00ac
+ * 000016 ff       MOV   R7,A
+ * 000017 ff       MOV   R7,A
+ * 000018 ff       MOV   R7,A
+ * 000019 ff       MOV   R7,A
+ * 00001a ff       MOV   R7,A
+ * 00001b ff       MOV   R7,A
+ * 00001c ff       MOV   R7,A
+>
+ + +

[Repeatable] dch +[start [stop]]

 + +Hexadecimal dump of code memory area from address start to +address stop. Default value of start address is address of +following memory cell which was dumped by previous dch +command. If stop parameter is not given dch command +lists 10 lines 8 bytes per line. + +
+$ s51 remo.hex
+ucsim 0.2.24, Copyright (C) 1997 Daniel Drotos, Talker Bt.
+ucsim comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+This is free software, and you are welcome to redistribute it
+under certain conditions; type `show c' for details.
+58659 bytes read from remoansi.hex
+> wc remo
+0013da 52 65 6d 6f             Remo
+> dch 0x13da
+0013da 52 65 6d 6f 20 00 56 65 Remo .Ve
+0013e2 72 73 69 6f 6e 20 31 2e rsion 1.
+0013ea 30 20 00 43 6f 70 79 72 0 .Copyr
+0013f2 69 67 68 74 20 28 63 29 ight (c)
+0013fa 20 00 31 39 39 34 2c 39  .1994,9
+001402 35 20 00 54 61 6c 6b 65 5 .Talke
+00140a 72 20 42 74 2e 00 53 75 r Bt..Su
+001412 6e 64 61 79 2e 00 4d 6f nday..Mo
+00141a 6e 64 61 79 2e 00 54 68 nday..Th
+001422 75 65 73 64 61 79 2e 00 uesday..
+>
+ +First element in every lines is address of first byte dumped out in +the line. Next elements are hexadecimal values of bytes followed by +ASCII charactes of bytes dumped out in the line. If value of the +memory cell is not printable than a dot is dumped out. + + +

[Repeatable] di +[start [stop]]

 + +Hexadecimal dump of internal RAM area from address start to +address stop. Default value of start address is address of +following memory cell which was dumped by previous di +command. If stop parameter is not given di command +lists 10 lines 8 bytes per line. + +
+$ s51 remoansi.hex
+ucsim 0.2.24, Copyright (C) 1997 Daniel Drotos, Talker Bt.
+ucsim comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+This is free software, and you are welcome to redistribute it
+under certain conditions; type `show c' for details.
+58659 bytes read from remoansi.hex
+> sopt stopit 1
+> g
+Simulation started, PC=0x000000
+Stop at 000023: (5) Interrupt
+F 000023
+> di
+000000 18 02 16 ba 00 02 00 0a ........
+000008 00 00 00 00 00 00 00 00 ........
+000010 00 00 00 00 00 00 00 00 ........
+000018 4a 00 00 00 00 00 00 00 J.......
+000020 bc 27 06 2d 02 ee 35 8f .'.-..5.
+000028 31 e7 42 01 0e 01 0b 00 1.B.....
+000030 ec 0b 7f 10 7f a9 7e 08 ......~.
+000038 fe 03 09 00 00 00 af 08 ........
+000040 af 08 00 00 00 00 00 00 ........
+000048 00 00 00 00 00 00 00 00 ........
+>
+ + +

[Repeatable] dx +[start [stop]]

 + +Hexadecimal dump of external RAM area from address start to +address stop. Default value of start address is address of +following memory cell which was dumped by previous dx +command. If stop parameter is not given dx command +lists 10 lines 8 bytes per line. + +
+$ s51 remoansi.hex
+ucsim 0.2.24, Copyright (C) 1997 Daniel Drotos, Talker Bt.
+ucsim comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+This is free software, and you are welcome to redistribute it
+under certain conditions; type `show c' for details.
+58659 bytes read from remoansi.hex
+> sopt stopit 1
+> g
+Simulation started, PC=0x000000
+Stop at 000023: (5) Interrupt
+F 000023
+> dx 0x100
+000100 00 00 00 00 00 00 00 00 ........
+000108 00 00 00 00 00 00 00 00 ........
+000110 00 00 00 00 00 00 00 00 ........
+000118 00 00 00 00 00 00 00 00 ........
+000120 00 00 00 00 00 00 00 00 ........
+000128 00 00 00 00 00 00 00 44 .......D
+000130 61 6e 69 00 00 00 02 02 ani.....
+000138 07 00 00 ff 00 00 07 cb ........
+000140 08 0c 32 00 07 cb 06 05 ..2.....
+000148 02 00 24 00 00 00 00 00 ..$.....
+>
+ + +

dp

 + +Dump out ports. This command shows actual value of ports. + +
+$ s51 remoansi.hex 
+ucsim 0.2.12, Copyright (C) 1997 Daniel Drotos, Talker Bt.
+ucsim comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+This is free software, and you are welcome to redistribute it
+under certain conditions; type `show c' for details.
+58659 bytes read from remoansi.hex
+> sopt stopit 1
+> g
+5
+ * 000023 02 01 1c LJMP  011c
+> dp
+P0    11111111 0xff 255 .    P1    11111110 0xfe 254 .
+Pin0  11111111 0xff 255 .    Pin1  11111111 0xff 255 .
+Port0 11111111 0xff 255 .    Port1 11111110 0xfe 254 .
+
+P2    11111111 0xff 255 .    P3    11111111 0xff 255 .
+Pin2  11111111 0xff 255 .    Pin3  11111111 0xff 255 .
+Port2 11111111 0xff 255 .    Port3 11111111 0xff 255 .
+>
+ +First lines on the list (labeled with Px) are value of SFRs which are +internal latch registers. Second lines (labeled with Pinx) are outputs +of external devices connected to port pins of the +microcontroller. These values can be set by you using sp command. Third lines (labeled with Portx) +show actual values can be measured on pins of the device. These values +are calculated with following pseudo formula: + +

Portx= Px AND Pinx + +

All three values are displayed in binary, hexadecimal, decimal form +and then the ASCII character of the value is shown. + + +

ds [addr...]

+ +Print out SFR. This command can be used to get value of all or some +SFRs. If you do not specify any parameter the ds command simply +dumps out full SFR area 16 bytes per line. + +
+$ s51 remoansi.hex 
+ucsim 0.2.12, Copyright (C) 1997 Daniel Drotos, Talker Bt.
+ucsim comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+This is free software, and you are welcome to redistribute it
+under certain conditions; type `show c' for details.
+58659 bytes read from remoansi.hex
+> sopt stopit 1
+> g
+5
+ * 000023 02 01 1c LJMP  011c
+> ds
+000080 ff 2a ba 16 00 00 00 00 55 a1 d7 fe 50 fd 00 00 .*......U...P...
+000090 fe 00 00 00 00 00 00 00 7e 00 00 00 00 00 00 00 ........~.......
+0000a0 ff 00 00 00 00 00 00 00 97 00 00 00 00 00 00 00 ................
+0000b0 ff 00 00 00 00 00 00 00 15 00 00 00 00 00 00 00 ................
+0000c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
+0000d0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
+0000e0 0a 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
+0000f0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
+> ds p1 0x87
+    P1 fe 254 .
+000087 00   0 .
+> ds p2 ip scon
+    P2 ff 255 .
+    IP 15  21 .
+  SCON 7e 126 ~
+>
+ +If you specify one or more parameter the ds command prints out +value of registers specified by parameters. Parameter can be an +address or a symbolic name of the register. Note that the simulator +implements a register at all address in the address space which is not +true in real microcontroller where reading of an unimplemented +register gets undefined value. Value of the registers printed out in +hexadecimal, decimal, and ASCII form. + +

Note that different type of controllers can implement different +registers: + +

+$ s51
+ucsim 0.2.12, Copyright (C) 1997 Daniel Drotos, Talker Bt.
+ucsim comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+This is free software, and you are welcome to redistribute it
+under certain conditions; type `show c' for details.
+> ds rcap2l
+> q
+$ s51 -t 52
+ucsim 0.2.12, Copyright (C) 1997 Daniel Drotos, Talker Bt.
+ucsim comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+This is free software, and you are welcome to redistribute it
+under certain conditions; type `show c' for details.
+> ds rcap2l
+RCAP2L 00   0 .
+>
+ + +

[Repeatable] db +addr...

 + +Dump bits. This command can be used to get value of bits. At least one +parameter must be given. Bit address can be specified in three +forms. First of all name of the bit can be used if it has any. Direct +bit address is accepted too and it can be specified by address of IRAM +or SFR which contains the bit and bit number within the byte separated +by a dot. If the requested bit is in an SFR the address of the +register can be specified by its name. + +
+$ s51
+ucsim 0.2.12, Copyright (C) 1997 Daniel Drotos, Talker Bt.
+ucsim comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+This is free software, and you are welcome to redistribute it
+under certain conditions; type `show c' for details.
+> db it1 0x20.3 0x43 p2.5
+000088    IT1 0
+000020   20.3 0
+000028   28.3 0
+0000a0   P2.5 1
+>
+ +Value of bits are printed out one per line. The list starts direct +address of the bit followed by bit name or address of the memory cell +or SFR which contains the displayed bit and bit number within the byte +separated by a dot. At last the value of the bit is shown. Displaying +a port bit you get value of SFR latch: + +
+> sp 1 0x0f
+> ss p1 0x55
+000090 55                                              U
+> dp
+P0    11111111 0xff 255 .    P1    01010101 0x55  85 U
+Pin0  11111111 0xff 255 .    Pin1  00001111 0x0f  15 .
+Port0 11111111 0xff 255 .    Port1 00000101 0x05   5 .
+
+P2    11111111 0xff 255 .    P3    11111111 0xff 255 .
+Pin2  11111111 0xff 255 .    Pin3  11111111 0xff 255 .
+Port2 11111111 0xff 255 .    Port3 11111111 0xff 255 .
+> db p1.2 p1.3 p1.4 p1.5 p1.6
+000090   P1.2 1
+000090   P1.3 0
+000090   P1.4 1
+000090   P1.5 0
+000090   P1.6 1
+>
+ + +
+ + + diff --git a/sim/ucsim/doc/cmd_exec.html b/sim/ucsim/doc/cmd_exec.html new file mode 100644 index 00000000..624daa46 --- /dev/null +++ b/sim/ucsim/doc/cmd_exec.html @@ -0,0 +1,227 @@ + + +Execution commands of uCsim + + + + + +

Execution commands of uCsim

+ + +

g [start [stop]]

 + +Go, start execution. Parameters are optional. First parameter +specifies start address of the execution. By default execution starts +at address specified by actual value of the PC. This can be overridden +by first parameter. If second parameter is specified it places a +dynamic breakpoint at specified address which stops the execution. If +stop address is not given the simulator stops if it reaches a +breakpoint, or the CPU accepts an interrupt and stopit option +is TRUE, or fatal error occures or stop command is +used. Note that first instruction is executed without effect of +breakpoints. It means that if there is a breakpoint at start address +then it will not be hit. + +
+$ s51 remoansi.hex
+ucsim 0.2.24, Copyright (C) 1997 Daniel Drotos, Talker Bt.
+ucsim comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+This is free software, and you are welcome to redistribute it
+under certain conditions; type `show c' for details.
+55755 bytes read from remoansi.hex
+> b 0x187
+> sopt stopit y
+> g
+Simulation started, PC=0x000000
+Stop at 000187: (4) Breakpoint
+F 000187
+>
+ +After execution is started the Simulaton started message +appears with value of PC where the execution started and the simulator +is ready to accept other commands while the simulation is running in +background. + + + + +

stop

 + +This command stops the simulation, it freezes the CPU and all the +peripherials. + +
+$ s51 remoansi.hex
+ucsim 0.2.24, Copyright (C) 1997 Daniel Drotos, Talker Bt.
+ucsim comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+This is free software, and you are welcome to redistribute it
+under certain conditions; type `show c' for details.
+58659 bytes read from remoansi.hex
+> g
+Simulation started
+> dr
+000000 00 01 00 14 00 00 5a 47 ......ZG
+000000 00 .  ACC= 0x47  71 G  B= 0x01   DPTR= 0x001c @DPTR= 0x47  71 G
+000001 01 .  PSW= 0x00 CY=0 AC=0 OV=0 P=0
+   006f02 90 00 1e MOV   DPTR,#001e
+> stop
+   006ac5 24 a5    ADD   A,#a5
+> 
+
+ +Simulated program is executed in background and the simulator accepts +commands. If it stopped by the stop command the instruction pointed by +PC is dissassembled, see the dis command for +description of disassembled form. + + +

[Repeatable] s +[step]

 + +Step command. It executes one instruction without effect of +breakpoints. Optional parameter can specify number of requested +steps. + +
+$ s51 remoansi.hex
+ucsim 0.2.12, Copyright (C) 1997 Daniel Drotos, Talker Bt.
+ucsim comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+This is free software, and you are welcome to redistribute it
+under certain conditions; type `show c' for details.
+58659 bytes read from remoansi.hex
+> s
+000000 00 00 00 00 00 00 00 00 ........
+000000 00 .  ACC= 0x00   0 .  B= 0x00   DPTR= 0x0000 @DPTR= 0x00   0 .
+000000 00 .  PSW= 0x00 CY=0 AC=0 OV=0 P=0
+   000160 c2 90    CLR   P1.0
+> s 2
+000000 00 00 00 00 00 00 00 00 ........
+000000 00 .  ACC= 0x00   0 .  B= 0x00   DPTR= 0x0000 @DPTR= 0x00   0 .
+000000 00 .  PSW= 0x00 CY=0 AC=0 OV=0 P=0
+   000162 c2 97    CLR   P1.7
+000000 00 00 00 00 00 00 00 00 ........
+000000 00 .  ACC= 0x00   0 .  B= 0x00   DPTR= 0x0000 @DPTR= 0x00   0 .
+000000 00 .  PSW= 0x00 CY=0 AC=0 OV=0 P=0
+   000164 d2 b5    SETB  P3.5
+>
+ +After execution of actual instruction pointed by PC the step +command executes dr command. + + +

[Repeatable] n +[step]

 + +Execute until next instruction is reached. This command is similar to +step command described above but if actual +instruction to execute is a subroutine call the next command +places a dynamic breakpoint after the call instruction and starts to +execute the subroutine. If the subroutine is infinite the breakpoint +set by next will never reached. It can be a dangerous situation +because the executeion started by the next command can not be +stopped interactively. But it can be stopped by other breakpoints. + +
+$ s51 remoansi.hex
+ucsim 0.2.12, Copyright (C) 1997 Daniel Drotos, Talker Bt.
+ucsim comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+This is free software, and you are welcome to redistribute it
+under certain conditions; type `show c' for details.
+58659 bytes read from remoansi.hex
+> g 0 0x172
+4
+   000172 79 04    MOV   R1,#04
+> dis 0x172 0 5
+   000170 7f 00    MOV   R7,#00
+   000172 79 04    MOV   R1,#04
+   000174 12 0d b8 LCALL 0db8
+   000177 0f       INC   R7
+   000178 d9 fa    DJNZ  R1,0174
+   00017a 75 0b 00 MOV   0b,#00
+> n 3
+000000 00 04 00 00 00 00 00 00 ........
+000000 00 .  ACC= 0x00   0 .  B= 0x00   DPTR= 0x0000 @DPTR= 0x00   0 .
+000004 00 .  PSW= 0x00 CY=0 AC=0 OV=0 P=0
+   000174 12 0d b8 LCALL 0db8
+000000 00 04 00 00 00 00 00 00 ........
+000000 00 .  ACC= 0x00   0 .  B= 0x00   DPTR= 0x0167 @DPTR= 0x00   0 .
+000004 00 .  PSW= 0x00 CY=0 AC=0 OV=0 P=0
+   000177 0f       INC   R7
+000000 00 04 00 00 00 00 00 01 ........
+000000 00 .  ACC= 0x00   0 .  B= 0x00   DPTR= 0x0167 @DPTR= 0x00   0 .
+000004 00 .  PSW= 0x00 CY=0 AC=0 OV=0 P=0
+   000178 d9 fa    DJNZ  R1,0174
+>
+ + +

pc [address]

 + +Using this command without any parameter it simply dumps out +instruction pointed by the PC. Specify address if you want to set the +PC. + +
+$ s51
+S51 0.1.5, Copyright (C) 1997 Daniel Drotos, Talker Bt.
+S51 comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+This is free software, and you are welcome to redistribute it
+under certain conditions; type `show c' for details.
+> pc
+ * 000000 ff       MOV   R7,A
+> pc 123
+ * 00007b ff       MOV   R7,A
+> sopt debug t  
+> pc 32
+Warning: maybe not instruction at 000020
+ * 000020 ff       MOV   R7,A
+>
+ + +

run

 + +This command starts the execution of the simulated program. + + +
+ + + diff --git a/sim/ucsim/doc/cmd_general.html b/sim/ucsim/doc/cmd_general.html new file mode 100644 index 00000000..b7031cc7 --- /dev/null +++ b/sim/ucsim/doc/cmd_general.html @@ -0,0 +1,659 @@ + + +General commands of uCsim + + + + +

General commands of uCsim

+ + + +Some commands can be repeated by entering an empty command (just +pressing ENTER if command console is interactive). This repeats the +full command entered previously precisely including parameters +of the command. Repeatable commands are signed with [Repeatable] icon. + +

Some commands accept parameters which in most cases can be +numbers. Numbers can be entered in C-style form. If the number begins +whith 0x or 0X it is interpreted as a +hexadecimal number. If it begins with 0 followed by +digits it is interpreted as octal number. In other cases it is +interpreted as decimal number. + +

Every command which changes content of ROM area such as l, dl or sc deletes result of code analyzer and causes to +re-analyze the code. + + +

show c|w

+ +This command can be used to list licensing information. If c +option has given, the license is listed. It is first 10 point of the +version 2 of GNU Genral Public License. Using w parameter the +command prints out last 2 point of the license ("NO WARRANTY" +message). If you do not accept GPL simply do not use the program. + + +

download,dl

 + +Download command. It is same as load above but it +reads information from command console which is standard input by +default. This command stops read records when it detects an "END" +record which is normaly the last record. This command has two +equivalent forms download and dl. + +
+$ s51 -V
+ucsim 0.2.24, Copyright (C) 1997 Daniel Drotos, Talker Bt.
+ucsim comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+This is free software, and you are welcome to redistribute it
+under certain conditions; type `show c' for details.
+> do
+:03000000020003F8
+:1000030075812078207600D8FC900000AE83AF8203
+:100013009000001200416005E4F0A380F690009F79
+:1000230012004A9000A312004A9000A712006890A1
+:1000330000AD12006875D0001200B50200B3EF6581
+:10004300827003EE658322E493F8740193F97402DA
+:1000530093FE740393F5828E83E869700122E4931F
+:10006300F6A30880F4E493FC740193FD740293FEF9
+:10007300740393FF740493F8740593F582888312D1
+:100083000041700122E493A3A883A9828C838D820B
+:10009300F0A3AC83AD828883898280E3212100B5FC
+:1000A300212100B5000000B500B5000000B500B582
+:0200B30080FECD
+:1000B5007520117501AA850120750102850120228F
+:00000001FF
+197 bytes loaded
+>
+ + +

quit

 + +Quit. This command terminates actual console, it does not ask you to +confirm your intention. Simulator always reads commands from a file so +end of file condition finishes too. If command console is on standard +input/output, pressing the CTRL-D will quit just like the quit +command. + +

Note that if -Z option was used at +invokation then the quit command does not terminate the simulator +program. In this case kill command can be used to +terminate the simulator. See for more information about using multiple consoles. + +

$ s51
+ucsim 0.2.24, Copyright (C) 1997 Daniel Drotos, Talker Bt.
+ucsim comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+This is free software, and you are welcome to redistribute it
+under certain conditions; type `show c' for details.
+> q
+$
+ + +

kill

 + +This kommand terminates the simulator. It does not ask for +confirmation. It doesn't matter how many consoles are used and what +commands are running on them. + + +

help,?

 + +Help command. It prints out short description of the commands. + + +

reset

 + +Reset command. It resets the microcontroller. It has same effect as +active signal on the RST pin. + +
+$ s51 -V remoansi.hex
+ucsim 0.2.24, Copyright (C) 1997 Daniel Drotos, Talker Bt.
+ucsim comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+This is free software, and you are welcome to redistribute it
+under certain conditions; type `show c' for details.
+58659 bytes read from remoansi.hex
+> dr
+000000 00 00 00 00 00 00 00 00 ........
+000000 00 .  ACC= 0x00   0 .  B= 0x00   DPTR= 0x0000 @DPTR= 0x00   0 .
+000000 00 .  PSW= 0x00 CY=0 AC=0 OV=0 P=0
+   000000 02 01 60 LJMP  0160
+> s 2
+000000 00 00 00 00 00 00 00 00 ........
+000000 00 .  ACC= 0x00   0 .  B= 0x00   DPTR= 0x0000 @DPTR= 0x00   0 .
+000000 00 .  PSW= 0x00 CY=0 AC=0 OV=0 P=0
+   000160 c2 90    CLR   P1.0
+000000 00 00 00 00 00 00 00 00 ........
+000000 00 .  ACC= 0x00   0 .  B= 0x00   DPTR= 0x0000 @DPTR= 0x00   0 .
+000000 00 .  PSW= 0x00 CY=0 AC=0 OV=0 P=0
+   000162 c2 97    CLR   P1.7
+> res
+> dr
+000000 00 00 00 00 00 00 00 00 ........
+000000 00 .  ACC= 0x00   0 .  B= 0x00   DPTR= 0x0000 @DPTR= 0x00   0 .
+000000 00 .  PSW= 0x00 CY=0 AC=0 OV=0 P=0
+   000000 02 01 60 LJMP  0160
+>
+ + +

wi,Wi string

 + +Searching for specified string in internal RAM area. String is +interpreted from first non-space sharacter until end of the command +including spaces. wi command makes case insensitive search and +Wi can be used to make case sensitive search. Result is a hexa +dump of memory areas that match with specified string. Most of C-style +escape sequences can be used in the string: \f, \n, +\r, \t, \v, \a, \b, +\0, and \0xxx where xxx is an octadecimal +number of the code of the character. + +
+$ s51 remoansi.hex
+ucsim 0.2.24, Copyright (C) 1997 Daniel Drotos, Talker Bt.
+ucsim comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+This is free software, and you are welcome to redistribute it
+under certain conditions; type `show c' for details.
+58659 bytes read from remoansi.hex
+> g
+Simulation started, PC=0x000000
+
+Stop at 00019c: (7) User stopped
+F 00019c
+> si 20 Dani DAni
+000014 44 61 6e 69 44 41 6e 69                         DaniDAni
+> wi dani
+000014 44 61 6e 69             Dani
+000018 44 41 6e 69             DAni
+> Wi Dani
+000014 44 61 6e 69             Dani
+> wi dani\0
+000018 44 41 6e 69 00          DAni.
+>
+ + +

wx,Wx string

 + +Search commands. These commands are similar to wi, +Wi commands the only difference is that wx,Wx are used +to search for a string in external memory. + + +

wc,Wc string

 + +Search commands. These commands are similar to wi, +Wi commands the only difference is that wx,Wx are used +to search for a string in code memory area. + + +

gopt [opt]

 + +Get actual value of option(s). Some options can be set by sopt to modify behavior of the +simulator. Using gopt you can get actual value of these +options. If you use this command without parameter you get list of all +options known by the program. In this way you can figure out which +options can be used. + +
+$ s51 -V
+ucsim 0.2.24, Copyright (C) 1997 Daniel Drotos, Talker Bt.
+ucsim comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+This is free software, and you are welcome to redistribute it
+under certain conditions; type `show c' for details.
+> gopt
+verbose TRUE Verbose flag.
+stopit FALSE Stop if interrupt accepted.
+debug FALSE Debug flag.
+> gopt stopit
+stopit FALSE Stop if interrupt accepted.
+>
+ +This version of the simulator knows about three options. First element +of the list is name of the option (verbose, debug and +stopit). This name can be used to identify the option in +gopt and sopt command. Second +element of the list is the value of the option. In this case type of +both options is boolean, their value can be TRUE or FALSE. Third +element is a short description of the option. + +
verbose
? + +
debug
Debug flag can be set by -V option of the +program to TRUE otherwise its default value is FALSE. If it is TRUE, +the simulator prints out short messages about important events. + +
stopit
Setting this option to TRUE (default value is +FALSE) forces execution to stop every time when CPU accepts an +interrupt. You do not have to use breakpoints to inspect interrupts. + +
+ + +

sopt opt value

 + +Set option value. Options described at previous command (gopt) can be set using this command. First +parameter must be an option name and second the new +value. Interpretation of the value depends on type of the +option. Value for a boolean type of option interpreted as follows: if +first character of the value is one of 1, t, +T, y, Y then value will be TRUE otherwise +it will be FALSE. + +
+$ s51 -V
+ucsim 0.2.24, Copyright (C) 1997 Daniel Drotos, Talker Bt.
+ucsim comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+This is free software, and you are welcome to redistribute it
+under certain conditions; type `show c' for details.
+> gopt
+verbose TRUE Verbose flag.
+stopit FALSE Stop if interrupt accepted.
+debug FALSE Debug messages appears on this console.
+> sopt debug t
+> gopt
+verbose TRUE Verbose flag.
+stopit FALSE Stop if interrupt accepted.
+debug TRUE Debug messages appears on this console.
+>
+ + +

conf

+ +This command prints out configuration of the simulator: + +
+> conf
+ucsim version 0.2.37
+Type of microcontroller: 51 CMOS
+Controller has 8 hardware element(s).
+  timer0[0]
+  timer1[1]
+  uart[0]
+  port[0]
+  port[1]
+  port[2]
+  port[3]
+  irq[0]
+Memories:
+  ROM  size= 0x010000 65536
+  XRAM size= 0x010000 65536
+  IRAM size= 0x000100 256
+  SFR  size= 0x000100 256
+> 
+
+ +First line contains version number of the program. Second line informs +about type of the simulated microcontroller. Third line prints out how +many hardware elements are simulated. Following lines contain +information about memories. Note that size of the simulated memory +segment can be bigger than size of addressable part of the memory as +you see above SFR type of the memory has bigger simulated than +addressable size. + + +

state

 + +State of the simulator and the simulated microcontroller: + +
+> state
+CPU state= OK PC= 0x004349 XTAL= 1.10592e+07
+Total time since last reset= 0.614873 sec (6800004 clks)
+Time in isr = 0.0144227 sec (159504 clks) 2.3%
+Time in idle= 0 sec (0 clks)   0%
+Max value of stack pointer= 0x000049, avg= 0x000026
+> 
+
+ +The "CPU state" in the first line is an internal information. PC is +value of the program counter. First line shows XTAL frequency too. + +

Following lines contain information about simulated time. First, +full simulated time (elapsed from last reset) is printed out in +seconds and number of clock periods then same data is printed out +about time spent in interrupt service routines as well as in idle +mode. Last data in lines of ISR and IDLE time shows ratio of ISRs, +Idle times and main program. + +

Last line infroms about maximum value of the stack pointer and a +"not very well" calculated average value of it. + + +

file,load "FILE"

+ +Loads file named FILE into the simulated code memory. File must +contain data in Intel HEX format. + +
+> file "../../remo.hex"
+55470 words read from ../../remo.hex
+> 
+
+ +Don't forget to enclose file name in quotes to make the parameter to +be a string. + + +

info

 + +This command prints out information about different things which must +be specified as paramater to the command. Following subcommands are +known: + +

info breakpoints +
info registers +
info hardware + + +

info breakpoints

+ +This subcommand prints out information about breakpoints: + +
+> b 12
+Breakpoint 1 at 0x00000c: MOV   R7,A
+> tb 43
+Breakpoint 2 at 0x00002b: MOV   R7,A
+> bse ws f 0x80
+> i b
+Num Type       Disp Hit   Cnt   Address  What
+1   fetch      keep 1     1     0x00000c MOV   R7,A
+2   fetch      del  1     1     0x00002b MOV   R7,A
+1   event      keep 1     1     0x000080 ws
+> 
+
+ +As you see above, the command can be shortened to "i b". The list of +breakpoints contains 7 columns: + +
Num
Number of the breakpoint. Normal and event +breakpoints are numbered separately. + +
Type
This column shows type of the breakpoint. It can +be fetch for normal breakpoints or event for event +breakpoints. First the normal breakpoints are listed and then the +event breakpoints. + +
Disp
This shows if the breakpoint is temporary +(del) or not (keep). + +
Hit
How many times the breakpoint must be hit before it +really stops the program. + +
Cnt
Counter of breakpint hits. This counter decrements +and the breakpoint is activated if it reaches zero. + +
Address
Address where the breakpoint is set. + +
What
For normal breakpoints this field contains +disassembled instruction where the breakpoint is set. For event +breakpoints it contains type of event. + +
+ +

info registers

 + +This subcommand prints out full register set of the CPU. Output of +this command depends of type of CPU. + +
Registers of MCS51 family
+ +
+$ s51 remoansi.hex 
+ucsim 0.2.12, Copyright (C) 1997 Daniel Drotos, Talker Bt.
+ucsim comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+This is free software, and you are welcome to redistribute it
+under certain conditions; type `show c' for details.
+58659 bytes read from remoansi.hex
+> sopt stopit 1
+> g
+5
+ * 000023 02 01 1c LJMP  011c
+> i r
+000000 18 02 16 ba 00 02 00 0a ........
+000018 4a J  ACC= 0x0a  10 .  B= 0x00   DPTR= 0x16ba @DPTR= 0x00   0 .
+000002 16 .  PSW= 0x00 CY=0 AC=0 OV=0 P=0
+ * 000023 02 01 1c LJMP  011c
+>
+ +In first line the actual register bank is dumped out. Register banks +reside in internal RAM, address at the begining of the line shows +start address of actual register bank selected by RS0 and RS1 bits of +PSW register. + +

Next two lines begin with value of indirectly addressed internal +RAM cells. Second line shows IRAM cell pointed by R0 while third line +shows IRAM addressed by R1. + +

Second line displays some important registers. First one is the +accumulator. Its value dumped out in hexadecimal, decimal form and +then the ASCII character of its value. It is followed by value of the +B register which is dumped out in hexadecimal form only. Next is DPTR +register in hexadecimal and then external RAM cell which is addressed +by DPTR. This is dumped out in hexadecimal, decimal and ASCII too. + +

In third line you find program status word in hexadecimal and then +some flag bits of PSW register. Last line is disassembled instruction +at PC. + +

Registers of AVR family
+ +
+$ savr test_arith.hex
+ucsim 0.2.37, Copyright (C) 1997 Daniel Drotos, Talker Bt.
+ucsim comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+This is free software, and you are welcome to redistribute it
+under certain conditions; type `show c' for details.
+> 83 words read from test_arith.hex
+83 words read from test_arith.hex
+> run
+
+Stop at 0x000047: (105) User stopped
+F 0x000047
+> i r
+000000 00 2c 21 23 20 35 19 14 03 00 00 00 00 00 00 00 .,!# 5..........
+000010 00 01 1e 89 01 00 10 e2 14 00 01 10 00 00 00 00 ................
+ITHSVNZC  SREG= 0x03   3 .
+00000011  SP  = 0x000000
+X= 0x1001 [X]= 0x00   0 .  Y= 0x0000 [Y]= 0x00   0 .  Z= 0x0000 [Z]= 0x00   0 .
+ * 000047 940c 0047 jmp   0x000047
+> 
+
+ +First two lines show first 32 bytes of internal RAM which is the +register set of AVR controllers. + +

At the beginning of next two lines bits of status register are +printed. These lines present hexadecimal, decimal and ASCII values of +the status register too, and value of the stack pointer. + +

Following line shows indirect addressing registers X, Y, and Z as +well as pointed memory values. + +

Last line is disassembled instruction ap PC. + +

info hardware|hw cathegory [id]

+ +This subcommand prints out information about a unit of the +controller. Cathegory can be: + +
  • timer +
  • uart +
  • port +
  • pca +
  • interrupt +
  • wdt +
+ +Ouput format of this command depends on CPU family and type of the CPU +too because requested unit can be different in different type of +controller even in the same CPU family. + +
+$ s51 -t 51
+ucsim 0.2.36, Copyright (C) 1997 Daniel Drotos, Talker Bt.
+ucsim comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+This is free software, and you are welcome to redistribute it
+under certain conditions; type `show c' for details.
+> i h t
+timer0[0] 0x0000 13 bit timer OFF irq=0 dis prio=0
+timer1[1] 0x0000 13 bit timer OFF irq=0 dis prio=0
+> 
+
+ +Timer #2 differs a little bit from other timers of MCS51: + +
+$ s51 -t 52
+ucsim 0.2.36, Copyright (C) 1997 Daniel Drotos, Talker Bt.
+ucsim comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+This is free software, and you are welcome to redistribute it
+under certain conditions; type `show c' for details.
+> i h t
+timer0[0] 0x0000 13 bit timer OFF irq=0 dis prio=0
+timer1[1] 0x0000 13 bit timer OFF irq=0 dis prio=0
+timer2[2] 0x0000 reload 0x0000 timer OFF irq=0 dis prio=0
+> 
+
+ +

If the controller contains more than one unit of a cathegory, then +optional id parameter can be used to select a specific one. If +id is not used then information is printed about all units +belonging to specified cathegory. + +

+> i h t 1
+timer1[1] 0x0000 13 bit timer OFF irq=0 dis prio=0
+> 
+
+ +It is possible that there is no unit belonging to some cathegory. It +is also possible that the specific unit exists but information command +of that unit is not implemented, in this case you have to check SFRs +of the unit... + +
+> i h pca
+> 
+
+ +Information you can get about units of MCS51 controllers: + +
+$ s51 -t 251 
+ucsim 0.2.37, Copyright (C) 1997 Daniel Drotos, Talker Bt.
+ucsim comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+This is free software, and you are welcome to redistribute it
+under certain conditions; type `show c' for details.
+> g
+Simulation started, PC=0x000000
+
+Stop at 0x000023: (105) User stopped
+F 0x000023
+> i h t
+timer0[0] 0xaa8d 16 bit timer ON irq=0 en prio=0
+timer1[1] 0xfdff 8 bit autoreload timer ON irq=1 dis prio=0
+timer2[2] 0x0000 reload 0x0000 timer OFF irq=0 dis prio=0
+> i h u
+uart[0] 8 bit UART timer clocked MultiProc=none irq=en prio=1
+Receiver ON RB8=1 irq=0
+Transmitter TB8=1 irq=1
+> i h po
+port[0]
+P0    11111111 0xff 255 . (Value in SFR register)
+Pin0  11111111 0xff 255 . (Output of outside circuits)
+Port0 11111111 0xff 255 . (Value on the port pins)
+port[1]
+P1    11111111 0xff 255 . (Value in SFR register)
+Pin1  11111111 0xff 255 . (Output of outside circuits)
+Port1 11111111 0xff 255 . (Value on the port pins)
+port[2]
+P2    11111111 0xff 255 . (Value in SFR register)
+Pin2  11111111 0xff 255 . (Output of outside circuits)
+Port2 11111111 0xff 255 . (Value on the port pins)
+port[3]
+P3    11111111 0xff 255 . (Value in SFR register)
+Pin3  11111111 0xff 255 . (Output of outside circuits)
+Port3 11111111 0xff 255 . (Value on the port pins)
+> i h i
+Interrupts are enabled. Interrupt sources:
+  Handler  En  Pr Req Act Name
+  0x000003 en   1 no  act external #0
+  0x00000b en   0 no  act timer #0
+  0x000013 en   1 no  act external #1
+  0x00001b dis  0 YES act timer #1
+  0x000033 dis  0 no  act PCA counter
+  0x000033 dis  0 no  act PCA module #0
+  0x000033 dis  0 no  act PCA module #1
+  0x000033 dis  0 no  act PCA module #2
+  0x000033 dis  0 no  act PCA module #3
+  0x000033 dis  0 no  act PCA module #4
+  0x000023 en   1 YES act serial transmit
+  0x000023 en   1 no  act serial receive
+  0x00002b dis  0 no  act timer #2 TF2
+  0x00002b dis  0 no  act timer #2 EXF2
+Active interrupt service(s):
+  Pr Handler  PC       Source
+   1 0x000023 0x003672 serial transmit
+>
+
+ + +

timer a|d|g|r|s|v id [value]

 + +Handling of timers. First parameter of timer command determines the +operation which can be + +
add (or simply a)
to create a new timer. New timers +are turned ON by default and initialized to value 0. + +
del (or simply d)
to remove a timer if you don't need +it any more. + +
get (or simply g)
to get value of timers. See comment +below. + +
run (or simply r)
to turn a timer ON. + +
stop (or simply s)
to turn a timer OFF. It still exist +but doesn't count xtal periods. + +
value (or simply v)
to set value of the timer (number +of xtal periods). `param' is the new value. + +
+ +id can be a number or a string. Timers are numbered from 1. You +can use any number greater than 0 to identify a timer. Or you can use +a simbolic name, in this case simulator uses the first unused number +to allocate a new timer: + +
+> tim a 3
+> tim g 0
+timer #0("time") ON: 0.463255 sec (5123232 clks)
+timer #0("isr") ON: 0.0051888 sec (57384 clks)
+timer #3("unnamed") ON: 0 sec (0 clks)
+> tim a "a"
+> tim g 0
+timer #0("time") ON: 0.463255 sec (5123232 clks)
+timer #0("isr") ON: 0.0051888 sec (57384 clks)
+timer #1("a") ON: 0 sec (0 clks)
+timer #3("unnamed") ON: 0 sec (0 clks)
+> 
+
+ +If you use 0 as timer id in "get" operation, simulator prints out +value of all timers including predefined ones. + +
+ + + diff --git a/sim/ucsim/doc/cmd_set.html b/sim/ucsim/doc/cmd_set.html new file mode 100644 index 00000000..e062d772 --- /dev/null +++ b/sim/ucsim/doc/cmd_set.html @@ -0,0 +1,203 @@ + + +Set commands of uCsim + + + + + + +

Set commands

+ +Set commands can be used to set value of memory cells, bits, or port +pins. Those commands that set value of memory interpret their command +lines a litle bit different than other commands. First parameter is +always the start address of the memory area which is being set. This +parameter is followed by a list of data parameters. Data can be +specified by a number. Numbers must begin with a digit. Each number +specifies one byte of data. If the parameter begins with a non-digit +character, it is interpreted as string of characters and this kind of +parameter specifies as many bytes as many characters the string +has. Strings can contain escape sequencies (see description of wi command where escape +sequencies are discussed) but they can not contain spaces because +space characters (space, tabulator and vertical tabulator) separates +parameters. Spaces can be specified as escape sequences or separated +number parameters if needed. Only space characters separate data +parameters while normaly comma (,) and semicolon (;) +are interpreted as separator characters too. + +

si addr data...

 + +Write data into internal RAM area. First parameter specifies start +address of memory area to set and other parameters are data to set. + +
+$ s51
+ucsim 0.2.12, Copyright (C) 1997 Daniel Drotos, Talker Bt.
+ucsim comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+This is free software, and you are welcome to redistribute it
+under certain conditions; type `show c' for details.
+> si 10 dani\040hej-ho
+00000a 64 61 6e 69 20 68 65 6a 2d 68 6f                dani hej-ho
+>
+ +Result of the command is a memory dump of area which has been modified +by the command. If there is syntax error in a data parameter then +remaining parameters are dropped out. + +
+> si 20 1 2 0xi 3 4
+Bad data 0xi
+000014 01 02                                           ..
+>
+ + +

sx addr data...

 + +This command is similar to si command +described above but it is used to modify external RAM. + + +

sc addr data...

 + +This command is similar to si command +described above but it is used to modify code memory area (ROM). + + +

ss addr data...

 + +This command is similar to si command +described above but it is used to modify SFR. Other difference is that +first parameter (start address) can be specified by name of SFR +not by address only. + +
+$ s51
+ucsim 0.2.12, Copyright (C) 1997 Daniel Drotos, Talker Bt.
+ucsim comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+This is free software, and you are welcome to redistribute it
+under certain conditions; type `show c' for details.
+> ss p1 0
+000090 00                                              .
+>
+ + +

sb addr data...

 + +Modify bit(s). First parameter is address of first bit to modify. See +description of db command how bit address can +be specified. If first character of data parameter is 0 it +means zero otherwise it means one. + +
+$ s51
+ucsim 0.2.12, Copyright (C) 1997 Daniel Drotos, Talker Bt.
+ucsim comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+This is free software, and you are welcome to redistribute it
+under certain conditions; type `show c' for details.
+> sb 0x23.5 1
+> db 0x23.5
+000023   23.5 1
+> sb p3.3 0
+> dp
+P0    11111111 0xff 255 .    P1    11111111 0xff 255 .
+Pin0  11111111 0xff 255 .    Pin1  11111111 0xff 255 .
+Port0 11111111 0xff 255 .    Port1 11111111 0xff 255 .
+
+P2    11111111 0xff 255 .    P3    11110111 0xf7 247 .
+Pin2  11111111 0xff 255 .    Pin3  11111111 0xff 255 .
+Port2 11111111 0xff 255 .    Port3 11110111 0xf7 247 .
+> sb tr1 0
+> db tr1
+000088    TR1 0
+> sb tr1 1
+> db tr1
+000088    TR1 1
+>
+ + +

sp port data

 + +This command can be used to sep up output values of external circuits +connected to port pins. If a port bit is used as output to drive +external circuits, do not set corresponding pin bit to zero because +read back value of the port can be false. First parameter must be +number of the port between 0 and 3. + +
+$ s51
+ucsim 0.2.12, Copyright (C) 1997 Daniel Drotos, Talker Bt.
+ucsim comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+This is free software, and you are welcome to redistribute it
+under certain conditions; type `show c' for details.
+> dp
+P0    11111111 0xff 255 .    P1    11111111 0xff 255 .
+Pin0  11111111 0xff 255 .    Pin1  11111111 0xff 255 .
+Port0 11111111 0xff 255 .    Port1 11111111 0xff 255 .
+
+P2    11111111 0xff 255 .    P3    11111111 0xff 255 .
+Pin2  11111111 0xff 255 .    Pin3  11111111 0xff 255 .
+Port2 11111111 0xff 255 .    Port3 11111111 0xff 255 .
+> ss p1 0x55
+000090 55                                              U
+> sp 1 0x0f
+> dp
+P0    11111111 0xff 255 .    P1    01010101 0x55  85 U
+Pin0  11111111 0xff 255 .    Pin1  00001111 0x0f  15 .
+Port0 11111111 0xff 255 .    Port1 00000101 0x05   5 .
+
+P2    11111111 0xff 255 .    P3    11111111 0xff 255 .
+Pin2  11111111 0xff 255 .    Pin3  11111111 0xff 255 .
+Port2 11111111 0xff 255 .    Port3 11111111 0xff 255 .
+>
+ + +

fi start stop data

 + +Fill command. It can be used to fill up an area of internal RAM with a +specified data. + +
+$ s51
+ucsim 0.2.12, Copyright (C) 1997 Daniel Drotos, Talker Bt.
+ucsim comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+This is free software, and you are welcome to redistribute it
+under certain conditions; type `show c' for details.
+> fi 11 0x34 44
+> di
+000000 00 00 00 00 00 00 00 00 ........
+000008 00 00 00 2c 2c 2c 2c 2c ...,,,,,
+000010 2c 2c 2c 2c 2c 2c 2c 2c ,,,,,,,,
+000018 2c 2c 2c 2c 2c 2c 2c 2c ,,,,,,,,
+000020 2c 2c 2c 2c 2c 2c 2c 2c ,,,,,,,,
+000028 2c 2c 2c 2c 2c 2c 2c 2c ,,,,,,,,
+000030 2c 2c 2c 2c 2c 00 00 00 ,,,,,...
+000038 00 00 00 00 00 00 00 00 ........
+000040 00 00 00 00 00 00 00 00 ........
+000048 00 00 00 00 00 00 00 00 ........
+>
+ + +

fx start stop data

 + +Fill command. It works similar to fi but it +puts data into external RAM instead of internal RAM. + + +

fs start stop data

 + +Fill command. It works similar to fi but it +puts data into SFR instead of internal RAM. + + +

fc start stop data

 + +Fill command. It works similar to fi but it +puts data into code memory (ROM) instead of internal RAM. + + +
+ + + diff --git a/sim/ucsim/doc/commref.html b/sim/ucsim/doc/commref.html new file mode 100644 index 00000000..f50252cc --- /dev/null +++ b/sim/ucsim/doc/commref.html @@ -0,0 +1,83 @@ + + +UCSIM: Command Reference + + + + +

Command reference

+ + +

The simulator can be controlled with a simple monitor program which +uses the command console to read commands and print out results. After +starting the program you see a prompt on the command console and you +can write in commands after the prompt: + +

+g [start [stop]]   Go
+stop               Stop
+pc [address]       Get/set content of PC
+s [step]           Step
+n [step]           Next
+bse wi|ri|wx|rx|ws|rs|rc f|d addr [hit]
+                   Set EVENT Breakpoint
+bde wi|ri|wx|rx|ws|rs|rc addr
+                   Delete EVENT Breakpoint
+ba                 Delete all breakpoints
+dis [start [offset [lines]]]
+                   Disassemble code
+dp                 Dump ports
+ds [addr...]       Dump SFR
+db addr...         Dump bit
+si addr data...    Set Internal RAM
+sx addr data...    Set External RAM
+sc addr data...    Set code (ROM)
+ss addr data...    Set SFR area
+sb addr data...    Set bit
+sp port data       Set port pins
+fi start stop data Fill IRAM area with `data'
+fx start stop data Fill XRAM area with `data'
+fs start stop data Fill SFR area with `data'
+fc start stop data Fill ROM area with `data'
+wi,Wi string       Search for `string' in IRAM (Wi case sensitive)
+wx,Wx string       Search for `string' in XRAM (Wx case sensitive)
+wc,Wc string       Search for `string' in ROM (Wc case sensitive)
+sopt opt value     Set value of option
+gopt [opt]         Get value of option(s)
+show c|w           Show licensing information
+----
+Set of new commands:
+conf               Configuration
+state              State of simulator
+file,load "FILE"   Load FILE into ROM
+download,dl        Download (intel hex) data
+info               Information
+get                Get
+set                Set
+timer a|d|g|r|s|v id [value]
+                   Timer add|del|get|run|stop|value
+run                Go
+step               Step
+reset              Reset
+dump i|x|r|s [start [stop]]
+                   Dump memory
+di [start [stop]]  Dump Internal RAM
+dx [start [stop]]  Dump External RAM
+dch [start [stop]] Dump code in hex form
+dc [start [stop]]  Dump code in disass form
+break addr [hit]   Set fix breakpoint
+tbreak addr [hit]  Set temporary breakpoint
+clear [addr...]    Clear fix breakpoint
+help,?             Help about commands
+quit               Quit
+kill               Shut down the simulator
+
+ +In command reference you can find more +information about breakpoints and execution of the simulated program. + + +
+ + + diff --git a/sim/ucsim/doc/conf.mk b/sim/ucsim/doc/conf.mk new file mode 100644 index 00000000..879e9bc8 --- /dev/null +++ b/sim/ucsim/doc/conf.mk @@ -0,0 +1,10 @@ +# +# Makefile targets to remake configuration +# + +freshconf: Makefile + +Makefile: $(srcdir)/Makefile.in $(PRJDIR)/configure.in + cd $(PRJDIR) && $(SHELL) ./config.status + +# End of conf.mk diff --git a/sim/ucsim/doc/cpu.gif b/sim/ucsim/doc/cpu.gif new file mode 100644 index 0000000000000000000000000000000000000000..a14fbb66f6425fd2ee295069ca78feca2e1ef97a GIT binary patch literal 12757 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 bsmV=pvXh?tBq&2E%2ATCl%^DA1ONa# + +Simulator for MCS51 + + + + +

Software simulator for MCS51

+ +This screeshot demonstrates CPU window of the simulator. The CPU +window contains five different panes. Active pane can be changed by +pressing TAB and Shift-TAB keys. First pane contains disassembled code +of the program. Instructions found by the code analyzer appear on the +list only. Some of instructions can be highlighted in different +ways. First highlighted instruction on the list (instruction at +0x4386) is highlighted because there is a breakpoint specified at that +address. Second highlighted instruction (at 0x438A) shows a dynamic +breakpoint. Third highlighted line contains the cursor which can be +moved by pressing up and down arrow keys. Because the pane lists +analyzed instructions only, the list can be scrolled backward as well +as forward. + +

+ +

Second pane which is under disass pane is a memory dump pane which +shows content of internal RAM. Activating this pane the cursor appears +in the pane and the memory content can be changed simply by entering +new value at requested location. Cursor can be moved by cursor keys. + +

Next pane shows content of registers: accumulators, program status +word, general purpose registers, indirectly addressed memory +locations, data pointer, and stack pointer, program counter. Note that +changing content of PC can be dangerous. If you set new value to PC +and this address is not found by code analyzer as instruction, +disassembled list disappears from disass pane and an error message `PC +is at invalid address' appears. If you are sure that PC is at an +instruction (remember that code analyzer is unable to locate every +instructions of the program) you can "validate" actual address by +pressing Ctrl-F7 keys. + +

Next pane shows values of ports. P0 and P2 is disabled if simulated +microcontroller is a 8X31 which needs P0 and P2 for multiplexed +address/data bus. + +

Last pane is a passive pane, it can not be activated. It shows time +elapsed since last reset. First line contains number of number of +cycles (in hex) and second line the cycles that the CPU spent in +interrupt routines. Last line is calculated dependent of specified +XTAL frequency and it shows `real time' (symulated time) elapsed since +reset (in microseconds). + +

At right side of menu bar there is an indicator which shows status +of the simulation (CPU Stopped, Symulation Running). The screenshot +shows some menus as well. + +

+ + + diff --git a/sim/ucsim/doc/cpu_types.html b/sim/ucsim/doc/cpu_types.html new file mode 100644 index 00000000..d546f37f --- /dev/null +++ b/sim/ucsim/doc/cpu_types.html @@ -0,0 +1,184 @@ + + +UCSIM: CPU types + + + + +

Select type of CPU

+ +The simulator supports following type of microprocessors from MCS51 +family: + +

8051/8031 + +
8052/8032 + +
8051R + +
89C51R + +
80251 + + +

8051/8031

+ +You can select this type of microcontroller using one of the following +parameter for -t option: + +
  • 51 (HMOS type) + +
  • 8051 (HMOS type) + +
  • 8751 (HMOS type) + +
  • C51 (CMOS type) + +
  • 80C51 (CMOS type) + +
  • 87C51 (CMOS type) + +
  • 31 (HMOS type) + +
  • 8031 (HMOS type) + +
  • C31 (CMOS type) + +
  • 80C31 (CMOS type) + +
+ +It includes core 51 features: + +
  • 64k external RAM + +
  • 64k ROM + +
  • 128 byte internal RAM + +
  • 2 timers (timer #0, timer #1) + +
  • Serial interface + +
  • 4 8-bit quazi bi-directional ports + +
+ +CMOS types also include: + +
  • Idle mode + +
  • Power down mode + +
+ + +

8052/8032

 + +You can select this type of microcontroller using one of the following +parameter for -t option: + +
  • 52 (HMOS type) + +
  • 8052 (HMOS type) + +
  • 8752 (HMOS type) + +
  • C52 (CMOS type) + +
  • 80C52 (CMOS type) + +
  • 87C52 (CMOS type) + +
  • 32 (HMOS type) + +
  • 8032 (HMOS type) + +
  • C32 (CMOS type) + +
  • 80C32 (CMOS type) + +
+ +It includes same features as 8051/8031 +microcontrollers and additionaly: + +
  • 3 timers (timer #0, timer #1, timer #2) + +
  • 256 bytes of internal RAM + +
+ + +

8051R

 + +You can select this type of microcontroller using one of the following +parameter for -t option (all are CMOS types): + +
  • 51R + +
  • 51RA + +
  • 51RB + +
  • 51RC + +
  • C51RA + +
  • C51RB + +
  • C51RC + +
+ +It includes all features that 8052/8032 does and +additionaly: + +
  • Extended interrupt priority system (4 priority levels) + +
  • Extended serial line interface (automatic address recognition) + +
  • Watchdog timer + +
+ + +

89C51R

 + +You can select this type of microcontroller using 89C51R +parameter for -t option (this CPU is always CMOS). This is a Philips +clone, excluding duplicated DPTR it is similar to 8051XR from Intel. + +

It includes all features that 8051R does and +additionaly: + +

  • PCA (Programmable Counter Array): 5 16-bit counter, one of +them can act as watchdog timer. + +
  • Duplicated DPTR. + +
+ + +

80251

 + +You can select this type of microcontroller using one of the following +parameter for -t option (all are CMOS types): + +
  • 251 + +
  • C251 + +
+ +

It includes all features that 89C51R does +and additionaly: + +

  • Nothing implemented yet. + +
+ +
+ + + diff --git a/sim/ucsim/doc/index.html b/sim/ucsim/doc/index.html new file mode 100644 index 00000000..61ffb9c5 --- /dev/null +++ b/sim/ucsim/doc/index.html @@ -0,0 +1,156 @@ + + +Mikrocontroller Simulator + + + + +[ Download ] + +[ Installation ] + +[ Usage ] + +[ Mail to +developer ] + +

+ +

Software simulator for microcontrollers

+ +uCsim can be used to simulate microcontrollers. It +supports MCS51 family. AVR and Z80 support is under development. + +

Download

 + +Simulator is available for two platforms: DOS and UNIX but DOS version +is not supported any more. DOS version is not finished so I call it +demo version and it is available in binary only. Limitations of DOS +version are: + +
  • There is no built in help available; + +
  • Some of the utilities are not working, for example calculator, bit +simulator; + +
  • Serial line works in mode 1 independently of mode bits.
+ +I used this simulator to verify my applications and I never used +missing feautres mentioned above, so I think that this "demo" version +can be usefull anyway. + +

Download +now + + + + +

How to install

+ +DOS version + +

Get the ZIP file and unzip it. ZIP file contains three files: +s51.exe the executable itself, dpmi16bi.ovl and +rtm.exe. Last two files are required because s51.exe is +a DOS protected mode program. Put these files in a directory which is +in the PATH or keep them together with the s51.exe. + +

UNIX version + +

UNIX version is distributed in source. + +

  1. Get archive file, uncompress and untar it. These steps will +produce a directory ucsim-X.Y.Z where X.Y.Z is the version +number. + +
  2. Go to the directory and configure the package. Issue +configure command. It will determine your system and +make Makefile. Installation directory can be specified with +--prefix=dir option to the +configure. Default directory is +/usr/local. Executable file will be placed in bin +subdirectory. + +
  3. Compile the package with make command. + +
  4. Install executable s51 to any directory you want. It can be +done with make install command which will place files +in installation directory specified with --prefix=dir option of +configure. Note that you may have to have special +privilege to do this if installation directory is not writable by you. + +
+ + + + +

How to use

 + +

DOS version

+ +S51 for DOS has been written in Borland Pascal using Turbo Vision to +produce menu driven, multiwindow user interface which is very easy to +use. The program can be started using following command: + +

C:\> s51 [input file] + +

Parameter is optional. If it specified it must be the name of an +Intel hex file. Some screenshots of the program and short descriptions +of them: + +

+ + +

UNIX version

+ +Invokation.
Starting the simulator +program. + +

Features of the simulator + +

    + +
  • Code analyzer.
    The simulator tries +to figure out places of valid instructions in code area. This feature +included in both DOS and UNIX versions. + +
  • Processor types.
    The simulator can +simulate different type of microcontrollers. + +
  • Multiple consoles.
    The simulator can +handle more than one command consoles and accepts command from +multiple sources. It also can be driven by other programs such as +debugger interfaces. + +
  • Serial interfaces.
    The simulator can +virtually connect a terminal to serial interface of the simulated CPU. + +
  • Command reference. (Now updated up to +0.2.37)
    The simulator can be controlled via a command line +interface. It accepts simple commands. + +
+ +
+ + + + + +
© 1997,99 Dániel Drótos, Talker Bt.
drdani@mazsola.iit.uni-miskolc.hu
+ + + diff --git a/sim/ucsim/doc/interrupt.gif b/sim/ucsim/doc/interrupt.gif new file mode 100644 index 0000000000000000000000000000000000000000..4e146f5dcc0380b921d27dbb2b4678fd5c763410 GIT binary patch literal 12432 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 + +Simulator for MCS51 + + + + +

Software simulator for MCS51

+ +This screenshot demonstrates window which displays interrupt system of +the microcontroller. Interrupt enable register and priority register +as well as interrupt request bits are displayed in this window. Note +that if you set some request bit during simulation and interrupt is +enabled, the CPU will accept the interrupt and responding to it by +starting the service routine. + +

+ +

The `Interrupt/program rate' pane shows ratio of execution time of +main program and interrupt service routines. Content of this pane is +not saved if you close tha window which means that measure of the +ratio is restarted every time you reopen the window. + +

+ + + diff --git a/sim/ucsim/doc/invoke.html b/sim/ucsim/doc/invoke.html new file mode 100644 index 00000000..ff6cceb9 --- /dev/null +++ b/sim/ucsim/doc/invoke.html @@ -0,0 +1,124 @@ + + +UCSIM: Invokation + + + + +

Starting the simulator

+ +There are separate programs to simulate different microcontroller +families: + +

MCS51 family is simulated by s51 +
AVR family is simulated by savr +
Z80 processor is simulated by sz80 + +

You can select + +

The simulator can be started in the following way: + +

$ s51 [-hHVvP] [-p prompt] [-t CPU] +[-X freq[k|M]] [-c file] [-s file] [-S optionlist] [-Z portnum] +[files...] + +

Specified files must be names of Intel hex files. Simulator loads +them in specified order into the ROM of the simulated system. + +

Options: + +

-t CPU + +
Type of CPU. Recognized types are: 51, 8051, 8751, C51, 80C51, +87C51, 31, 8031, C31, 80C31, 52, 8052, 8752, C52, 80C52, 87C52, 32, +8032, C32, 80C32, 51R, 51RA, 51RB, 51RC, C51R, C51RA, C51RB, C51RC, +89C51R, 251, C251. Note that recongition of a CPU type as option does +not mean that the simulator can simulate that kind of CPU. Default +type is C51. + +
See how to select CPU type. + +
-X freq[k|M] + +
XTAL frequency is freq Hertz. k or M can be +used to specify frequency in kHZ or MHz. Space is not allowed between +the number and the k or M. Default value is 11059200 Hz. + +
-c file + +
Open command console on file. Command consoles are on +standard input and output by default. Using this option the console +can be opened on any file for example on the serial interface of the +computer. + +
-Z portnum + +
Listen for incoming connections on port portnum. Using this +option uCsim can serve multiple consoles. You can get a console +by simply telnet into machine running uCsim to port +portnumber. This option is not available on platforms which +doesn't support BSD networking. + +
See how to use multiple consoles. + +
-s file + +
Connect serial interface of the simulated microcontroller to the +file. Nothing is used by default which means that characters +transmitted by serial interface of the simulated microcontroller go to +nowhere and it will never receive anything. If you are going to +communicate with serial interface interactively the best idea is to +specify a teminal with -s option. + +
-S in=file,out=file + +
Using this option you can specify different files for input and +output streams that uCsim uses to simulate microprocessor's +serial interface. + +
See more about serial interface +simulation. + +
-p prompt + +
Using this option you can specify any string to be the prompt of +command interpreter, for example: + +
$ s51 -p "s51> "
+ucsim 0.2.12, Copyright (C) 1997 Daniel Drotos, Talker Bt.
+ucsim comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+This is free software, and you are welcome to redistribute it
+under certain conditions; type `show c' for details.
+s51>
+ +
-P + +
Prompt will be a null ('\0') character. This feature can be +useful for programs which controlls simulator through a pipe. + +
-V + +
Verbose mode. The simulator notifies you about some kind of +internal actions for example interrupts. Messages are printed on +command console. + +
-v + +
Print out version number and stop. + +
-H + +
Print out types of known CPUs. Names printed out by this option +can be used to determine CPU type using -t option. + +
-h + +
Print out a short help about the options and stop. + +
+ + +
+ + + diff --git a/sim/ucsim/doc/mulcons.html b/sim/ucsim/doc/mulcons.html new file mode 100644 index 00000000..771c47c5 --- /dev/null +++ b/sim/ucsim/doc/mulcons.html @@ -0,0 +1,115 @@ + + +UCSIM: Multiple Consoles + + + + +

Using multiple consoles

+ +

Why?

+ +Using more than one console can be useful if you want to issue a +command during the simulated program is executed. + + +

How?

+ +

To get multiple consoles you have to execute the simulator in the +background like daemons run in UNIX systems. The simulator +then will listen and wait for network connection requests and provide +console functions for network connections. + +

To run uCsim in the background you have to use -Z option for the simulator: + +

+pigmy$ s51 -Z 5555 foo.hex
+
+ +In this case s51 runs in forground in your command interpreters point +of view. Of course you can run the program really in the background: + +
+pigmy$ s51 -Z 5555 foo.hex &
+
+ +The parameter of the -Z option is a +port number. This can be number of any unused port of your machine. If +the specified port is already occupied then following message appears: + +
+pigmy$ s51 -Z 5555
+bind: Address already in use
+
+ +In this case you have to use an other number. + +

Let's suppose you have found a free port number and the simulator +listens on it. Now go to somewhere else, at least to an other window +and connect to the simulator: + +

+other_machine$ telnet pigmy 5555
+
+ +First parameter to the telnet command is the name of the machine where +the simulator is running on. It can be localhost if you are +on the same machine or the fully qualified host name if you are at the +other end of the world. Second parameter is the number of the port +where the simulator is listening. It must be the same number which was +specified as parameter of the -Z +option when the simulator was started (see above). + +

Connecting to the simulator you get a command console: + +

+pigmy$ telnet pigmy 5555
+Trying 127.0.0.1...
+Connected to pigmy.talker.bt.
+Escape character is '^]'.
+ucsim 0.2.21, Copyright (C) 1997 Daniel Drotos, Talker Bt.
+ucsim comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+This is free software, and you are welcome to redistribute it
+under certain conditions; type `show c' for details.
+>
+ 
+
+ + +

What to do with it?

+ +Obviously you can telnet into the simulator as many times as many +command consoles you want. You can start the execution using one +console and while the program is executed you can, for example, modify +ports on the other console. + + +

Stop

+ +Using quit (q) command you can not stop the +simulator. It just stops the actual console and the simulator +continues to listen for incoming network connections. + +

To stop the simulator completely you have to use kill command. Note that if you stop the +simulator then all the active network connections (all other consoles) +will stop. + + +

Tricks

+ +You can get a console on the terminal where you started the +simulator. To do this you must explicitly ask the simulator to open a +console on the standard input/output. You can do this using -c option and specify the actual +terminal as parameter for it: + +
+pigmy$ s51 -Z 5555 foo.hex -c /dev/tty
+
+ +
+ + + diff --git a/sim/ucsim/doc/new.gif b/sim/ucsim/doc/new.gif new file mode 100644 index 0000000000000000000000000000000000000000..892616ff04edbf6190f44fbf4b5e3f6fa25f0978 GIT binary patch literal 161 zcmZ?wbhEHblw%NKSjfO|;J|_Z{~3NP)d&pyt@x9LkpT#FKm~nr37EGF@w~v*&A`CBJ2Iyz}1up-gXg!e>F|Us>B! zHFh!yZTEY(ZK|@-e4nRZgYG<=GnHGZwt4ot!{J=n+wPk$n((YyJarQ5RMCj(O9~&j NZ94JdMg#+cH2{9PL*xJe literal 0 HcmV?d00001 diff --git a/sim/ucsim/doc/obsolete.html b/sim/ucsim/doc/obsolete.html new file mode 100644 index 00000000..2afd2280 --- /dev/null +++ b/sim/ucsim/doc/obsolete.html @@ -0,0 +1,25 @@ +

bl

 + +List breakpoints. This command prints out information about every +fetch and then event breakpoints. + +
+> bl
+F 1(1) 000160 c2 CLR   P1.0
+D 2(2) 000180 02 LJMP  022a
+F 1(1) 000006 wi
+>
+ +First character on the list shows permanency of the +breakpoint. F means fix and D means dynamic. Second item +on the list is the hit number associated to breakpoint. After that +between the parentheses there is the actual value of the hit +counter. If hit counter reaches zero, breakpoint is activated and hit +counter is preset with value of hit number. Next item is the +address. Next items are different for fetch and event breakpoints. + +

Fetch breakpoints list hexadecimal code of instruction at +breakpoint's address and then dissassembled instruction. + +

Event breakpoints list identification of the event's type. + diff --git a/sim/ucsim/doc/post.jpg b/sim/ucsim/doc/post.jpg new file mode 100644 index 0000000000000000000000000000000000000000..acd6eba59f7cd46f21fd025cb6c66f5a153d3519 GIT binary patch literal 1016 zcmex=^(PF6}rMnOeST|r4lSw=>~TvNxu(8R<1W=16jCP7AKLB{__803NOWMu>c1}I=;VrF4wW9Q)H;sz?% zD!{d!pzFb!U9xX3zTPI5o8roG<0MW4oqZMDikqloVbuf*=gfJ(V&YTRE(2~ znmD<{#3dx9RMpfqG__1j&CD$#!(;m`U-bo}m%dwG{CBCg(Brp38zWBszAf@D z^yD$8R%Yg&WI?Xvzz<(?OPAi^GD^*T676#^McKN%v9(6v29HFMBlE&jvz|m`7{s_W zoVXqE@TR}>m6eh&j}`aT^WAsxNVyj@kHm0!})1O z4NM_D8*KO@R(jqwepP7EW6P!0vS?dWWa;az->(XP{7Lea5z zmD2yNxViC}TeX4Qg4TpnOH1Z!)SS#-esJZBg6MPc`KKPNV?4*d;^q05*SD6&$$nIu z|FD|%($=$vrS<%pMr+p|$uxFUxcm8-{L|;^+7rKbN?7vWc(tGX{o1_Q{{(N(Hrtf0 zvmws<*abd=g@^XfuzIW@z;H5e%USIQci&!pwY}rrnrkOzjH7Q_@0?RSHC=1AbxMQh z$zzw#7Oyy`cjDI_H)Eakt$X&_g={O|_4)QkEBhZIaY9$>FKwO6b^LAqe+Hd3-qDA- dzPSp%x!?EhaIuj8DYHdW?_Z2%KPmtJCIF3Dl?ea< literal 0 HcmV?d00001 diff --git a/sim/ucsim/doc/serial.html b/sim/ucsim/doc/serial.html new file mode 100644 index 00000000..7707d7cb --- /dev/null +++ b/sim/ucsim/doc/serial.html @@ -0,0 +1,135 @@ + + +UCSIM: Serial Interafces + + + + +

Using serial interfaces

+ +

Connecting a terminal

+ +You can easily connect a terminal to the serial interface of the +simulated microcontroller. This terminal is just a file so it can be +anything which is represented as a file. It can be a real serial line +of the computer: + +
+$ s51 -s/dev/ttyS1
+
+ +Of course you must use the actual device name of your operating +system. Device name ttyS1 above is used in Linux +systems. Your system can use other names. + +

You can use a terminal of your system. It can be a virtual console +if your system provides such as Linux does for example. On X Windows +you can use xterm windows as terminals, one for running the +simulator and one as a terminal on CPU's serial line. Here is a sample +how to do this: + +

  1. Prepare the terminal window which will be connected to the +serial line: + +

    • Check the device name which represents the terminal: + +
      +$ tty
+/dev/ttyp1
+
      + +
    • Disconnect the shell from the terminal. Usualy I use the +tail command and any existing text file: + +
      +$ tail -f $HOME/.profile
+
      + +
    + +
  2. Run the simulator in the other window: + +
    +$ s51 -s/dev/ttyp1 program.hex
+
    + +Use the output of the tty command above as the parameter of the +-s option. + +
+ +Every character sent out by the simulated program +appears in the "terminal" window and every charater you type in there +will be received by the simulated controller's serial line. + + +

Connecting two instances of simulator

+ +Executing two instances of the simulator, serial lines of two +simulators (micros) can be connected together so they can talk to +each other over their serial interface. It is because you can specify +separate files for serial input and output. For example you run two +simulators "1" and "2", here is the sample how to connect them: + +

+ +

  1. Make two FIFOs to represent physical wires in serial cable +connecting two micros: + +
    +$ mkfifo 1-2 2-1 # 1-2: 1->2  and 2-1: 2->1
+
    + +
  2. Start two simulators and specify the FIFOs as input and output of +serial interface: + +
    +term1 $ # start sim "1"
+term1 $ s51 -Sin=2-1,out=1-2 program_1_.hex
+term2 $ # start sim "2"
+term2 $ s51 -Sout=2-1,in=1-2 program_2_.hex
+
    + +Because opening a pipe blocks the program until other direction is +opened, the order of arguments above is important! + +

    + +

  3. Debug programs as usual. + +
+ +Using the most usefull unix commands cat and tee and +just some more FIFOs you can monitor serial communication, here is a +sample: + +

+ +

  1. Make some FIFOs to use between simulators and tee "monitors": + +
    +$ mkfifo 1_tee tee_2 2_tee tee_2
+
    + +
  2. Run monitoring programs (in two xterms for example): + +
    +xterm1 $ cat 1_tee|tee /dev/tty >tee_2 # monitor 1->2
+xterm2 $ cat 2_tee|tee /dev/tty >tee_1 # monitor 2->1
+
    + +
  3. Now you can start simulators (on two other terminals:) + +
    +xterm3 $ s51 -Sin=tee_1,out=1_tee program_1_.hex
+xterm4 $ s51 -Sin=tee_2,out=2_tee program_2_.hex
+
    + +
  4. Start your apps and listen what they are talking about. + +
+ +
+ + + diff --git a/sim/ucsim/doc/serial1.fig b/sim/ucsim/doc/serial1.fig new file mode 100644 index 00000000..ad24a87f --- /dev/null +++ b/sim/ucsim/doc/serial1.fig @@ -0,0 +1,53 @@ +#FIG 3.2 +Landscape +Center +Inches +Letter +100.00 +Single +-2 +1200 2 +6 3750 2250 5175 2550 +5 1 0 1 0 7 0 0 -1 0.000 0 0 0 0 4912.500 2400.000 5025 2250 5100 2400 5025 2550 +1 2 0 1 0 0 0 0 20 0.000 1 0.0000 3825 2400 75 150 3750 2400 3900 2400 +2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2 + 3825 2250 5025 2250 +2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2 + 3825 2550 5025 2550 +-6 +6 3900 5625 5325 5925 +5 1 0 1 0 7 0 0 -1 0.000 0 0 0 0 5062.500 5775.000 5175 5625 5250 5775 5175 5925 +1 2 0 1 0 0 0 0 20 0.000 1 0.0000 3975 5775 75 150 3900 5775 4050 5775 +2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2 + 3975 5625 5175 5625 +2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2 + 3975 5925 5175 5925 +-6 +2 1 0 1 4 7 0 0 -1 0.000 0 0 -1 0 1 2 + 0 0 1.00 60.00 120.00 + 2250 3450 3675 2475 +2 1 0 1 4 7 0 0 -1 0.000 0 0 -1 1 0 2 + 0 0 1.00 60.00 120.00 + 6300 3675 5250 2475 +2 1 0 1 2 7 0 0 -1 0.000 0 0 -1 0 1 2 + 0 0 1.00 60.00 120.00 + 6975 3975 5400 5775 +2 1 0 1 2 7 0 0 -1 0.000 0 0 -1 1 0 2 + 0 0 1.00 60.00 120.00 + 3000 3675 3825 5775 +2 2 0 1 9 7 0 0 -1 0.000 0 0 -1 0 0 5 + 825 3225 3900 3225 3900 2925 825 2925 825 3225 +2 2 0 1 9 7 0 0 -1 0.000 0 0 7 0 0 5 + 825 3225 3900 3225 3900 4875 825 4875 825 3225 +2 2 0 1 9 7 0 0 -1 0.000 0 0 7 0 0 5 + 4800 3600 7875 3600 7875 5250 4800 5250 4800 3600 +2 2 0 1 9 7 0 0 -1 0.000 0 0 7 0 0 5 + 4800 3600 7875 3600 7875 3300 4800 3300 4800 3600 +4 1 0 0 0 16 12 0.0000 4 135 330 4425 2175 2-1\001 +4 1 0 0 0 16 12 0.0000 4 135 330 4575 5550 1-2\001 +4 1 9 0 0 18 12 0.0000 4 135 525 6375 3525 term2\001 +4 1 9 0 0 18 12 0.0000 4 135 525 2325 3150 term1\001 +4 0 1 0 0 12 12 0.0000 4 150 2520 900 3600 $ s51 -Sin=2-1,out=1-2 \\\001 +4 0 1 0 0 12 12 0.0000 4 180 1470 900 3810 program_1_.hex\001 +4 0 1 0 0 12 12 0.0000 4 180 1470 4950 4125 program_2_.hex\001 +4 0 1 0 0 12 12 0.0000 4 150 2520 4950 3900 $ s51 -Sout=2-1,in=1-2 \\\001 diff --git a/sim/ucsim/doc/serial1.gif b/sim/ucsim/doc/serial1.gif new file mode 100644 index 0000000000000000000000000000000000000000..dc8a0c0f651cc3acad439c206ba4379787eea2bd GIT binary patch literal 3078 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 literal 0 HcmV?d00001 diff --git a/sim/ucsim/doc/serial2.fig b/sim/ucsim/doc/serial2.fig new file mode 100644 index 00000000..81beaef7 --- /dev/null +++ b/sim/ucsim/doc/serial2.fig @@ -0,0 +1,97 @@ +#FIG 3.2 +Landscape +Center +Inches +Letter +100.00 +Single +-2 +1200 2 +6 7125 2325 7425 3825 +5 1 0 1 0 7 0 0 -1 0.000 0 0 0 0 7275.000 3563.000 7425 3675 7275 3750 7125 3675 +1 2 0 1 0 0 0 0 20 0.000 1 4.7124 7275 2475 75 150 7275 2400 7275 2550 +2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2 + 7125 2475 7125 3675 +2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2 + 7425 2475 7425 3675 +-6 +6 2475 2400 2775 3900 +5 1 0 1 0 7 0 0 -1 0.000 0 0 0 0 2625.000 3638.000 2775 3750 2625 3825 2475 3750 +1 2 0 1 0 0 0 0 20 0.000 1 4.7124 2625 2550 75 150 2625 2475 2625 2625 +2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2 + 2475 2550 2475 3750 +2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2 + 2775 2550 2775 3750 +-6 +6 5175 6750 6675 7050 +5 1 0 1 0 7 0 0 -1 0.000 0 0 0 0 5437.000 6900.000 5325 7050 5250 6900 5325 6750 +1 2 0 1 0 0 0 0 20 0.000 1 3.1416 6525 6900 75 150 6600 6900 6450 6900 +2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2 + 6525 6750 5325 6750 +2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2 + 6525 7050 5325 7050 +-6 +6 4200 5700 4500 7200 +5 1 0 1 0 7 0 0 -1 0.000 0 0 0 0 4350.000 6938.000 4500 7050 4350 7125 4200 7050 +1 2 0 1 0 0 0 0 20 0.000 1 4.7124 4350 5850 75 150 4350 5775 4350 5925 +2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2 + 4200 5850 4200 7050 +2 1 0 1 0 7 0 0 -1 0.000 0 0 -1 0 0 2 + 4500 5850 4500 7050 +-6 +2 1 0 1 4 7 0 0 -1 0.000 0 0 -1 0 1 2 + 0 0 1.00 60.00 120.00 + 4275 1725 2700 2400 +2 1 0 1 2 7 0 0 -1 0.000 0 0 -1 1 0 2 + 0 0 1.00 60.00 120.00 + 4350 5700 2550 5025 +2 2 0 1 9 7 0 0 -1 0.000 0 0 7 0 0 5 + 4875 4950 7950 4950 7950 6600 4875 6600 4875 4950 +2 2 0 1 9 7 0 0 -1 0.000 0 0 7 0 0 5 + 4875 4950 7950 4950 7950 4650 4875 4650 4875 4950 +2 1 0 1 4 7 0 0 -1 0.000 0 0 -1 1 0 2 + 0 0 1.00 60.00 120.00 + 3450 4725 2625 3900 +2 2 0 1 9 7 0 0 -1 0.000 0 0 -1 0 0 5 + 3450 1350 6525 1350 6525 1050 3450 1050 3450 1350 +2 2 0 1 9 7 0 0 -1 0.000 0 0 7 0 0 5 + 3450 1350 6525 1350 6525 3000 3450 3000 3450 1350 +2 2 0 1 9 7 0 0 -1 0.000 0 0 -1 0 0 5 + 2775 8325 5850 8325 5850 8025 2775 8025 2775 8325 +2 2 0 1 9 7 0 0 -1 0.000 0 0 7 0 0 5 + 2775 8325 5850 8325 5850 9975 2775 9975 2775 8325 +2 2 0 1 9 7 0 0 -1 0.000 0 0 -1 0 0 5 + 900 4575 3975 4575 3975 4275 900 4275 900 4575 +2 2 0 1 9 7 0 0 -1 0.000 0 0 7 0 0 5 + 900 4575 3975 4575 3975 6225 900 6225 900 4575 +2 1 0 1 4 7 0 0 -1 0.000 0 0 -1 1 0 2 + 0 0 1.00 60.00 120.00 + 5550 1875 7200 2325 +2 1 0 1 4 7 0 0 -1 0.000 0 0 -1 1 0 2 + 0 0 1.00 60.00 120.00 + 7275 3825 6375 5100 +2 1 0 1 2 7 0 0 -1 0.000 0 0 -1 1 0 2 + 0 0 1.00 60.00 120.00 + 4575 8700 4350 7275 +2 1 0 1 2 7 0 0 -1 0.000 0 0 -1 0 1 2 + 0 0 1.00 60.00 120.00 + 6675 6900 7500 5325 +2 1 0 1 2 7 0 0 -1 0.000 0 0 -1 0 1 2 + 0 0 1.00 60.00 120.00 + 3675 8475 5175 6900 +4 1 9 0 0 18 12 0.0000 4 135 630 6450 4875 xterm4\001 +4 0 1 0 0 12 12 0.0000 4 180 2940 975 4950 $ s51 -Sin=tee_1,out=1_tee \\\001 +4 0 1 0 0 12 12 0.0000 4 180 1470 975 5160 program_1_.hex\001 +4 1 9 0 0 18 12 0.0000 4 135 630 4950 1275 xterm1\001 +4 1 9 0 0 18 12 0.0000 4 135 630 4275 8250 xterm2\001 +4 1 9 0 0 18 12 0.0000 4 135 630 2400 4500 xterm3\001 +4 0 1 0 0 12 12 0.0000 4 180 2940 4950 5250 $ s51 -Sin=tee_2,out=2_tee \\\001 +4 0 1 0 0 12 12 0.0000 4 180 1470 4950 5475 program_2_.hex\001 +4 0 1 0 0 12 12 0.0000 4 180 1365 3525 1650 $ cat 1_tee|\\\001 +4 0 1 0 0 12 12 0.0000 4 180 1995 3525 1875 tee /dev/tty >tee_2\001 +4 0 1 0 0 12 12 0.0000 4 180 1365 2850 8625 $ cat 2_tee|\\\001 +4 0 1 0 0 12 12 0.0000 4 180 1995 2850 8850 tee /dev/tty >tee_1\001 +4 0 0 0 0 16 12 0.0000 4 165 465 2850 3600 1_tee\001 +4 0 0 0 0 16 12 0.0000 4 165 465 6600 3525 tee_2\001 +4 0 0 0 0 16 12 0.0000 4 165 465 3675 6825 tee_1\001 +4 0 0 0 0 16 12 0.0000 4 165 465 5700 7275 2_tee\001 diff --git a/sim/ucsim/doc/serial2.gif b/sim/ucsim/doc/serial2.gif new file mode 100644 index 0000000000000000000000000000000000000000..6fbb1db144341e210e6363d446fdad46966bc055 GIT binary patch literal 6260 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 literal 0 HcmV?d00001 diff --git a/sim/ucsim/doc/term_cpuopt.html b/sim/ucsim/doc/term_cpuopt.html new file mode 100644 index 00000000..feadb152 --- /dev/null +++ b/sim/ucsim/doc/term_cpuopt.html @@ -0,0 +1,27 @@ + + +Simulator for MCS51 + + + + +

Software simulator for MCS51

+ +This screenshot demonstrates one of option dialog boxes and the +terminal window. Terminal window simulates a terminal which is +connected to the serial interface of the simulated +microcontroller. Every character sent by the CPU is printed out in the +terminal window (it does not matter if it is opened or not) and every +time when you press a key in the terminal window the character will be +received by the serial interface of the CPU (when the simulation is +running obviously). During receiving of the character the cursor +disappears from the terminal window and reappears when receive is +completed. Echo is turned off in the terminal window which means that +only simulated program can "write" into the window. + +

+ +

+ + + diff --git a/sim/ucsim/doc/timers.gif b/sim/ucsim/doc/timers.gif new file mode 100644 index 0000000000000000000000000000000000000000..7fc3931710c27922d3d193c7b8dc549002028057 GIT binary patch literal 13166 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 literal 0 HcmV?d00001 diff --git a/sim/ucsim/doc/timers.html b/sim/ucsim/doc/timers.html new file mode 100644 index 00000000..48753754 --- /dev/null +++ b/sim/ucsim/doc/timers.html @@ -0,0 +1,22 @@ + + +Simulator for MCS51 + + + + +

Software simulator for MCS51

+ +This screenshot demonstrates timer/counter window. The window displays +value of the timer and control bits related to the timer/counter +unit. Different windows can be opened to display information about +different timers. Note that Timer2 of 8X52 is not implemented. Value +of the timer or control bits can be changed using these windows or SFR +window. + +

+ +

+ + + diff --git a/sim/ucsim/doc/wins.gif b/sim/ucsim/doc/wins.gif new file mode 100644 index 0000000000000000000000000000000000000000..086b54fadf0ea15f1c4229f33f56165d30d56094 GIT binary patch literal 18016 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 + +Simulator for MCS51 + + + + +

Software simulator for MCS51

+ +This screenshot demonstrates some kind of windows that can be opened +using commands in View menu. Every windows including CPU window +can be resized and moved on the desktop area. Every windows are active +which means that value of displayed data can be changed at any time +including execution of the simulated program. + +

+ +

+ + + diff --git a/sim/ucsim/gui.src/(c).1 b/sim/ucsim/gui.src/(c).1 new file mode 100644 index 00000000..d673f9fd --- /dev/null +++ b/sim/ucsim/gui.src/(c).1 @@ -0,0 +1,25 @@ +/* + * Simulator of microcontrollers (@@F@@) + * + * Copyright (C) @@S@@,@@Y@@ Drotos Daniel, Talker Bt. + * + * To contact author send email to drdani@mazsola.iit.uni-miskolc.hu + * + */ + +/* This file is part of microcontroller simulator: ucsim. + +UCSIM is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. + +UCSIM is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with UCSIM; see the file COPYING. If not, write to the Free +Software Foundation, 59 Temple Place - Suite 330, Boston, MA +02111-1307, USA. */ diff --git a/sim/ucsim/gui.src/Makefile.in b/sim/ucsim/gui.src/Makefile.in new file mode 100644 index 00000000..69f892f4 --- /dev/null +++ b/sim/ucsim/gui.src/Makefile.in @@ -0,0 +1,141 @@ +# +# uCsim gui.src/Makefile +# +# (c) Drotos Daniel, Talker Bt. 1999 +# + +SHELL = /bin/sh +CXX = @CXX@ +CPP = @CPP@ +CXXCPP = @CXXCPP@ +RANLIB = @RANLIB@ +INSTALL = @INSTALL@ + +PRJDIR = .. + +DEFS = $(subs -DHAVE_CONFIG_H,,@DEFS@) +CPPFLAGS = @CPPFLAGS@ -I. -I$(PRJDIR) +CFLAGS = @CFLAGS@ -Wall +CXXFLAGS = @CXXFLAGS@ -Wall +M_OR_MM = @M_OR_MM@ + +LIBS = @LIBS@ -L$(PRJDIR) -lutil -lsim -lcmd + +curses_ok = @curses_ok@ + +prefix = @prefix@ +exec_prefix = @exec_prefix@ +bindir = @bindir@ +libdir = @libdir@ +datadir = @datadir@ +includedir = @includedir@ +mandir = @mandir@ +man1dir = $(mandir)/man1 +man2dir = $(mandir)/man2 +infodir = @infodir@ +srcdir = @srcdir@ + +PKGS = serio.src portmon.src + +LOBJECTS = event.o \ + view.o frame.o bg.o label.o \ + group.o win.o desk.o app.o + + +# Compiling entire program or any subproject +# ------------------------------------------ +all: gui.src + +libs: guilib + +ifeq ($(curses_ok),yes) +gui.src: checkconf guilib a +else +gui.src: checkconf guilib +endif + @for pkg in $(PKGS); do\ + $(MAKE) -C $$pkg $$pkg ;\ + done + +a: a.o + $(CXX) $(LDFLAGS) $(LIBS) a.o -o $@ + + +# Compiling and installing everything and runing test +# --------------------------------------------------- +install: + @for pkg in $(PKGS); do\ + cd $$pkg && $(MAKE) install ; cd ..;\ + done + + +# Deleting all the installed files +# -------------------------------- +uninstall: + @for pkg in $(PKGS); do\ + cd $$pkg && $(MAKE) uninstall ; cd ..;\ + done + + +# Performing self-test +# -------------------- +check: + @for pkg in $(PKGS); do\ + cd $$pkg && $(MAKE) check ; cd ..;\ + done + + +# Performing installation test +# ---------------------------- +installcheck: + @for pkg in $(PKGS); do\ + cd $$pkg && $(MAKE) installcheck ; cd ..;\ + done + + +# Creating installation directories +# --------------------------------- +installdirs: + @for pkg in $(PKGS); do\ + cd $$pkg && $(MAKE) installdirs ; cd ..;\ + done + + +# Creating dependencies +# --------------------- +dep: Makefile.dep + +Makefile.dep: *.cc *.h + $(CXXCPP) $(CPPFLAGS) $(M_OR_MM) *.cc >Makefile.dep + +include Makefile.dep +include clean.mk + +#parser.cc: parser.y + +#plex.cc: plex.l + +# My rules +# -------- +ifeq ($(curses_ok),yes) +guilib: libgui.a +else +guilib: +endif + +libgui.a: $(LOBJECTS) + ar -rcu $*.a $(LOBJECTS) + $(RANLIB) $*.a + +.cc.o: + $(CXX) $(CXXFLAGS) $(CPPFLAGS) -c $< -o $@ + + +# Remaking configuration +# ---------------------- +checkconf: + @if [ -f $(PRJDIR)/devel ]; then\ + $(MAKE) -f conf.mk srcdir="$(srcdir)" PRJDIR="$(PRJDIR)" freshconf;\ + fi + +# End of gui.src/Makefile diff --git a/sim/ucsim/gui.src/a.cc b/sim/ucsim/gui.src/a.cc new file mode 100644 index 00000000..81d62c3f --- /dev/null +++ b/sim/ucsim/gui.src/a.cc @@ -0,0 +1,87 @@ +#include +#include + +int sfr[4]; +int port[4]; + +void +init_panel(PANEL *p) +{ + int mask, x, y; + int na, ha; + int cursor= 2; + WINDOW *w= panel_window(p); + + if (has_colors()) + { + na= COLOR_PAIR(1); + ha= COLOR_PAIR(2); + } + else + { + na= A_NORMAL; + ha= A_STANDOUT; + } + //wattron(w, COLOR_PAIR); + x= 0; + for (mask= 1, y= 0; mask < 0x100; mask<<= 1,y++) + { + wattrset(w, (y==cursor)?ha:na); + mvwprintw(w, y,x, "%s", (sfr[0]&mask)?"High":" Low"); + } +} + +wchar_t +wait_input(PANEL *p) +{ + WINDOW *w= panel_window(p); + wchar_t c; + + c= wgetch(w); + printw("%d 0x%x\n",c,c); + return(c); +} + +int +main(int argc, char *argv[]) +{ + wchar_t c; + + initscr(); /* initialize the curses library */ + keypad(stdscr, TRUE); /* enable keyboard mapping */ + nonl(); /* tell curses not to do NL->CR/NL on output */ + cbreak(); /* take input chars one at a time, no wait for \n */ + noecho(); /* don't echo input */ + if (has_colors()) + { + start_color(); + printw("has %d colors and %d pairs\n", COLORS, COLOR_PAIRS); + init_pair(1, COLOR_WHITE, COLOR_BLUE); + init_pair(2, COLOR_WHITE, COLOR_RED); + } + if (has_key(KEY_UP)) + printw("has UP KEY_UP=0x%x\n",KEY_UP); + else + printf("has no UP\n"); + c= getch(); + printw("got %d %x\n",c,c); + + WINDOW *w= newwin(10,10, 3,3); + keypad(w, TRUE); + PANEL *p= new_panel(w); + + sfr[0]= 0x5a; + init_panel(p); + update_panels(); + doupdate(); + c= wait_input(p); + //c= getch(); + + endwin(); + if (c==KEY_UP) + printf("got UP\n"); + else if (c==KEY_DOWN) + printf("got DOWN\n"); + else + printf("got \"%d\"\n", c); +} diff --git a/sim/ucsim/gui.src/app.cc b/sim/ucsim/gui.src/app.cc new file mode 100644 index 00000000..309497b9 --- /dev/null +++ b/sim/ucsim/gui.src/app.cc @@ -0,0 +1,171 @@ +/* + * Simulator of microcontrollers (app.cc) + * + * Copyright (C) 1999,99 Drotos Daniel, Talker Bt. + * + * To contact author send email to drdani@mazsola.iit.uni-miskolc.hu + * + */ + +/* This file is part of microcontroller simulator: ucsim. + +UCSIM is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. + +UCSIM is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with UCSIM; see the file COPYING. If not, write to the Free +Software Foundation, 59 Temple Place - Suite 330, Boston, MA +02111-1307, USA. */ +/*@1@*/ + +#include + +#include "appcl.h" +#include "deskcl.h" + + +cl_app::cl_app(char *iname): + cl_group(iname, this) +{ + drawn= 0; +} + +cl_app::~cl_app(void) +{ + endwin(); +} + +int +cl_app::init(void) +{ + initscr(); + keypad(stdscr, TRUE); + nonl(); + cbreak(); + noecho(); + + pos= new cl_box(0,0, COLS, LINES); + cl_view::init(); + state|= SF_SELECTED;//select(); + class cl_box b(*pos); + //b.move_rel(0,1); + //b.grow(0,-2); + if ((desk= mk_desk(&b))) + insert(desk); + desk->select(); + mk_views(desk); + + //update(); + update_panels(); + doupdate(); + return(0); +} + +class cl_gin * +cl_app::mk_input(void) +{ + class cl_gin *i= new cl_gin(); + i->init(); + i->add_input(stdin, 0); + return(i); +} + +int * +cl_app::mk_palette(void) +{ + int *p, i; + int colors; + + colors= 64; + p= (int*)malloc(colors * sizeof(int)); + if (has_colors()) + { + start_color(); + + init_pair(i= C_WIN+C_WIN_NORMAL, COLOR_YELLOW, COLOR_BLUE); + p[i]= COLOR_PAIR(i)|A_BOLD; + for (i= 1; i < colors; i++) + p[i]= p[C_WIN+C_WIN_NORMAL]; + // desktop + init_pair(i= C_DSK_BG, COLOR_BLACK, COLOR_WHITE); + p[i]= COLOR_PAIR(i); + // menus and status bar + init_pair(i= C_DSK_NORMAL, COLOR_WHITE, COLOR_BLUE); + p[i]= COLOR_PAIR(i)|A_BOLD; + init_pair(i= C_DSK_DISABLED, COLOR_WHITE, COLOR_BLUE); + p[i]= COLOR_PAIR(i); + // window + init_pair(i= C_WIN+C_WIN_FPASSIVE, COLOR_WHITE, COLOR_BLUE); + p[i]= COLOR_PAIR(i); + init_pair(i= C_WIN+C_WIN_FACTIVE, COLOR_WHITE, COLOR_BLUE); + p[i]= COLOR_PAIR(i)|A_BOLD; + init_pair(i= C_WIN+C_WIN_SELECTED, COLOR_YELLOW, COLOR_RED); + p[i]= COLOR_PAIR(i)|A_BOLD; + } + else + { + for (i= 0; i < colors; i++) + p[i]= A_NORMAL; + p[C_WIN+C_WIN_FACTIVE]|= A_BOLD; + p[C_WIN+C_WIN_SELECTED]|= A_REVERSE; + } + return(p); +} + +class cl_group * +cl_app::mk_desk(class cl_box *ipos) +{ + class cl_group *d= new cl_desk(ipos, "desktop", this); + d->init(); + return(d); +} + + +int +cl_app::handle_event(struct t_event *event) +{ + if (!cl_group::handle_event(event)) + { + if (event->what == EV_KEY) + switch (event->event.key) + { + case KEY_BREAK: case KEY_EXIT: + event->what= EV_COMMAND; + event->event.msg.cmd= CMD_QUIT; + break; + } + } + return(0); +} + +int +cl_app::run(void) +{ + struct t_event event; + + drawn= 0; + while (get_event(&event)) + { + if (!handle_event(&event)) + { + if (event.what == EV_COMMAND && + event.event.msg.cmd == CMD_QUIT) + return(0); + unhandled(&event); + } + if (drawn) + update(); + drawn= 0; + } + return(0); +} + + +/* End of gui.src/app.cc */ diff --git a/sim/ucsim/gui.src/appcl.h b/sim/ucsim/gui.src/appcl.h new file mode 100644 index 00000000..92a80c9d --- /dev/null +++ b/sim/ucsim/gui.src/appcl.h @@ -0,0 +1,54 @@ +/* + * Simulator of microcontrollers (appcl.h) + * + * Copyright (C) 1999,99 Drotos Daniel, Talker Bt. + * + * To contact author send email to drdani@mazsola.iit.uni-miskolc.hu + * + */ + +/* This file is part of microcontroller simulator: ucsim. + +UCSIM is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. + +UCSIM is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with UCSIM; see the file COPYING. If not, write to the Free +Software Foundation, 59 Temple Place - Suite 330, Boston, MA +02111-1307, USA. */ +/*@1@*/ + +#ifndef APPCL_HEADER +#define APPCL_HEADER + +#include "groupcl.h" + + +class cl_app: public cl_group +{ +public: + class cl_group *desk; + int drawn; +public: + cl_app(char *iname); + ~cl_app(void); + virtual int init(void); + virtual class cl_gin *mk_input(void); + virtual int *mk_palette(void); + virtual class cl_group *mk_desk(class cl_box *ipos); + + virtual int handle_event(struct t_event *event); + virtual int run(void); +}; + + +#endif + +/* End of gui.src/appcl.h */ diff --git a/sim/ucsim/gui.src/bg.cc b/sim/ucsim/gui.src/bg.cc new file mode 100644 index 00000000..d854d307 --- /dev/null +++ b/sim/ucsim/gui.src/bg.cc @@ -0,0 +1,63 @@ +/* + * Simulator of microcontrollers (bg.cc) + * + * Copyright (C) 1999,99 Drotos Daniel, Talker Bt. + * + * To contact author send email to drdani@mazsola.iit.uni-miskolc.hu + * + */ + +/* This file is part of microcontroller simulator: ucsim. + +UCSIM is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. + +UCSIM is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with UCSIM; see the file COPYING. If not, write to the Free +Software Foundation, 59 Temple Place - Suite 330, Boston, MA +02111-1307, USA. */ +/*@1@*/ + +#include + +#include "bgcl.h" + + +cl_bg::cl_bg(class cl_box *ipos, char *iname, class cl_app *iapp): + cl_view(ipos, iname, iapp) +{ + options&= ~OF_SELECTABLE; +} + +int * +cl_bg::mk_palette(void) +{ + int *p; + + p= (int*)malloc(1*sizeof(int)); + p[0]= C_DSK_BG; + return(p); +} + +int +cl_bg::draw(void) +{ + int x, y, color= get_color(0); + + wmove(window, 0, 0); + wattrset(window, color); + for (y= 0; y < pos->h; y++) + for (x= 0; x < pos->w; x++) + waddch(window, ACS_CKBOARD); + return(0); +} + + +/* End of gui.src/bg.cc */ diff --git a/sim/ucsim/gui.src/bgcl.h b/sim/ucsim/gui.src/bgcl.h new file mode 100644 index 00000000..968ed819 --- /dev/null +++ b/sim/ucsim/gui.src/bgcl.h @@ -0,0 +1,47 @@ +/* + * Simulator of microcontrollers (bgcl.h) + * + * Copyright (C) 1999,99 Drotos Daniel, Talker Bt. + * + * To contact author send email to drdani@mazsola.iit.uni-miskolc.hu + * + */ + +/* This file is part of microcontroller simulator: ucsim. + +UCSIM is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. + +UCSIM is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with UCSIM; see the file COPYING. If not, write to the Free +Software Foundation, 59 Temple Place - Suite 330, Boston, MA +02111-1307, USA. */ +/*@1@*/ + +#ifndef BGCL_HEADER +#define BGCL_HEADER + + +#include "viewcl.h" +#include "appcl.h" + + +class cl_bg: public cl_view +{ +public: + cl_bg(class cl_box *ipos, char *iname, class cl_app *iapp); + virtual int *mk_palette(void); + virtual int draw(void); +}; + + +#endif + +/* End of gui.src/bgcl.h */ diff --git a/sim/ucsim/gui.src/clean.mk b/sim/ucsim/gui.src/clean.mk new file mode 100644 index 00000000..bd548323 --- /dev/null +++ b/sim/ucsim/gui.src/clean.mk @@ -0,0 +1,45 @@ +# uCsim gui.src/clean.mk + +PKGS = serio.src portmon.src + +# Deleting all files created by building the program +# -------------------------------------------------- +clean_local: + rm -f *core *[%~] *.[oa] a + rm -f .[a-z]*~ + +clean: clean_local + @for pkg in $(PKGS); do\ + cd $$pkg && $(MAKE) -f clean.mk clean; cd ..;\ + done + + +# Deleting all files created by configuring or building the program +# ----------------------------------------------------------------- +distclean_local: clean_local + rm -f config.cache config.log config.status + rm -f Makefile *.dep + +distclean: distclean_local + @for pkg in $(PKGS); do\ + cd $$pkg && $(MAKE) -f clean.mk distclean; cd ..;\ + done + + +# Like clean but some files may still exist +# ----------------------------------------- +mostlyclean: clean_local + @for pkg in $(PKGS); do\ + cd $$pkg && $(MAKE) -f clean.mk mostlyclean; cd ..;\ + done + + +# Deleting everything that can reconstructed by this Makefile. It deletes +# everything deleted by distclean plus files created by bison, etc. +# ----------------------------------------------------------------------- +realclean: distclean_local + @for pkg in $(PKGS); do\ + cd $$pkg && $(MAKE) -f clean.mk realclean; cd ..;\ + done + +# End of gui.src/clean.mk diff --git a/sim/ucsim/gui.src/conf.mk b/sim/ucsim/gui.src/conf.mk new file mode 100644 index 00000000..5c33eb3d --- /dev/null +++ b/sim/ucsim/gui.src/conf.mk @@ -0,0 +1,12 @@ +# uCsim gui.src/conf.mk + +# +# Makefile targets to remake configuration +# + +freshconf: Makefile + +Makefile: $(srcdir)/Makefile.in $(PRJDIR)/configure.in + cd $(PRJDIR) && $(SHELL) ./config.status + +# End of gui.src/conf.mk diff --git a/sim/ucsim/gui.src/desk.cc b/sim/ucsim/gui.src/desk.cc new file mode 100644 index 00000000..6808cd7c --- /dev/null +++ b/sim/ucsim/gui.src/desk.cc @@ -0,0 +1,58 @@ +/* + * Simulator of microcontrollers (desk.cc) + * + * Copyright (C) 1999,99 Drotos Daniel, Talker Bt. + * + * To contact author send email to drdani@mazsola.iit.uni-miskolc.hu + * + */ + +/* This file is part of microcontroller simulator: ucsim. + +UCSIM is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. + +UCSIM is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with UCSIM; see the file COPYING. If not, write to the Free +Software Foundation, 59 Temple Place - Suite 330, Boston, MA +02111-1307, USA. */ +/*@1@*/ + +#include "deskcl.h" +#include "bgcl.h" + + +int +cl_desk::handle_event(struct t_event *event) +{ + if (cl_group::handle_event(event)) + return(1); + if (event->what == EV_KEY && + event->event.key == KEY_F(6)) + { + select_next(); + return(1); + } + return(0); +} + +int +cl_desk::mk_views(class cl_group *ins_to) +{ + class cl_box b(*pos); + + b.move_rel(0,1); + b.grow(0,-2); + insert(new cl_bg(&b, "background", app)); + return(0); +} + + +/* End of gui.src/desk.cc */ diff --git a/sim/ucsim/gui.src/deskcl.h b/sim/ucsim/gui.src/deskcl.h new file mode 100644 index 00000000..b3346b72 --- /dev/null +++ b/sim/ucsim/gui.src/deskcl.h @@ -0,0 +1,42 @@ +/* + * Simulator of microcontrollers (deskcl.h) + * + * Copyright (C) 1999,99 Drotos Daniel, Talker Bt. + * + * To contact author send email to drdani@mazsola.iit.uni-miskolc.hu + * + */ + +/* This file is part of microcontroller simulator: ucsim. + +UCSIM is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. + +UCSIM is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with UCSIM; see the file COPYING. If not, write to the Free +Software Foundation, 59 Temple Place - Suite 330, Boston, MA +02111-1307, USA. */ +/*@1@*/ + +#include "groupcl.h" + + +class cl_desk: public cl_group +{ +public: + cl_desk(class cl_box *ipos, char *iname, class cl_app *iapp): + cl_group(ipos, iname, iapp) {} + virtual int mk_views(class cl_group *ins_to); + + virtual int handle_event(struct t_event *event); +}; + + +/* End of gui.src/deskcl.h */ diff --git a/sim/ucsim/gui.src/event.cc b/sim/ucsim/gui.src/event.cc new file mode 100644 index 00000000..32075897 --- /dev/null +++ b/sim/ucsim/gui.src/event.cc @@ -0,0 +1,126 @@ +/* + * Simulator of microcontrollers (event.cc) + * + * Copyright (C) 1999,99 Drotos Daniel, Talker Bt. + * + * To contact author send email to drdani@mazsola.iit.uni-miskolc.hu + * + */ + +/* This file is part of microcontroller simulator: ucsim. + +UCSIM is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. + +UCSIM is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with UCSIM; see the file COPYING. If not, write to the Free +Software Foundation, 59 Temple Place - Suite 330, Boston, MA +02111-1307, USA. */ +/*@1@*/ + +#include "ddconfig.h" + +#include + +//#include + +#include "eventcl.h" + + +cl_input_src::cl_input_src(FILE *ifile, class cl_view *iview) +{ + file= ifile; + view= iview; +} + + +cl_gin::cl_gin(void) +{ + FD_ZERO(&in_set); + max_fdes= 0; + inputs= new cl_list(1, 1); +} + +cl_gin::~cl_gin(void) +{ + delete inputs; +} + + +int +cl_gin::add_input(FILE *ifile, class cl_view *iview) +{ + int d= fileno(ifile); + + inputs->add(new cl_input_src(ifile, iview)); + if (d > max_fdes) + max_fdes= d; + FD_SET(d, &in_set); + return(0); +} + +class cl_input_src * +cl_gin::get_input_src(int fdes) +{ + int i; + + for (i= 0; i < inputs->count; i++) + { + class cl_input_src *s= (class cl_input_src *)(inputs->at(i)); + if (fileno(s->file) == fdes) + return(s); + } + return(0); +} + +int +cl_gin::get_event(struct t_event *event) +{ + fd_set set; + //static struct timeval timeout= {0,0}; + wchar_t c; + + //FD_ZERO(&set); + set= in_set; + //FD_SET(fileno(stdin), &set); + if(::select(/*fileno(stdin)*/max_fdes+1, + &set, NULL, NULL, + NULL/*&timeout*/) > 0) + { + int i; + for (i= 0; i < inputs->count; i++) + { + class cl_input_src *s= (class cl_input_src *)(inputs->at(i)); + if (!s->file || + !(FD_ISSET(fileno(s->file), &set))) + continue; + if (s->view) + { + if (s->file) + { + c= fgetc(s->file); + return(s->view->mk_event(event, s->file, c)); + } + } + else + if ((c= getch()) > 0) + { + event->what= EV_KEY; + event->event.key= c; + return(1); + } + } + } + + return(0); +} + + +/* End of gui.src/event.cc */ diff --git a/sim/ucsim/gui.src/eventcl.h b/sim/ucsim/gui.src/eventcl.h new file mode 100644 index 00000000..4077a72f --- /dev/null +++ b/sim/ucsim/gui.src/eventcl.h @@ -0,0 +1,96 @@ +/* + * Simulator of microcontrollers (eventcl.h) + * + * Copyright (C) 1999,99 Drotos Daniel, Talker Bt. + * + * To contact author send email to drdani@mazsola.iit.uni-miskolc.hu + * + */ + +/* This file is part of microcontroller simulator: ucsim. + +UCSIM is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. + +UCSIM is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with UCSIM; see the file COPYING. If not, write to the Free +Software Foundation, 59 Temple Place - Suite 330, Boston, MA +02111-1307, USA. */ +/*@1@*/ + +#ifndef EVENTCL_HEADER +#define EVENTCL_HEADER + +#include "ddconfig.h" + +#if FD_HEADER_OK +# include HEADER_FD +#endif + +#include "pobjcl.h" + +#include "viewcl.h" + + +#define EV_NOTHING 0x0000 +#define EV_MOUSE_DOWN 0x0001 +#define EV_MOUSE_UP 0x0002 +#define EV_MOUSE_MOVE 0x0004 +#define EV_MOUSE_AUTO 0x0008 +#define EV_KEY 0x0010 +#define EV_COMMAND 0x0100 +#define EV_BROADCAST 0x0200 + +// cathegories +#define EV_MOUSE (EV_MOUSE_DOWN|EV_MOUSE_UP|EV_MOUSE_MOVE|EV_MOUSE_AUTO) +#define EV_KEYBOARD EV_KEY +#define EV_MESSAGE 0xff00 + +#define CMD_QUIT 0 + +struct t_event { + int what; + union { + wchar_t key; + struct { + int cmd; + long param; + } msg; + } event; +}; + + +class cl_input_src: public cl_base +{ +public: + FILE *file; + class cl_view *view; + cl_input_src(FILE *ifile, class cl_view *iview); +}; + +class cl_gin: public cl_base +{ +public: + fd_set in_set; + int max_fdes; + cl_list *inputs; +public: + cl_gin(void); + ~cl_gin(void); + + virtual int add_input(FILE *ifile, class cl_view *iview); + virtual class cl_input_src *get_input_src(int fdes); + virtual int get_event(struct t_event *event); +}; + + +#endif + +/* End of gui.src/eventcl.h */ diff --git a/sim/ucsim/gui.src/frame.cc b/sim/ucsim/gui.src/frame.cc new file mode 100644 index 00000000..b6b00e8d --- /dev/null +++ b/sim/ucsim/gui.src/frame.cc @@ -0,0 +1,76 @@ +/* + * Simulator of microcontrollers (frame.cc) + * + * Copyright (C) 1999,99 Drotos Daniel, Talker Bt. + * + * To contact author send email to drdani@mazsola.iit.uni-miskolc.hu + * + */ + +/* This file is part of microcontroller simulator: ucsim. + +UCSIM is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. + +UCSIM is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with UCSIM; see the file COPYING. If not, write to the Free +Software Foundation, 59 Temple Place - Suite 330, Boston, MA +02111-1307, USA. */ +/*@1@*/ + +#include "ddconfig.h" + +#include +#include "i_string.h" + +#include "framecl.h" +#include "wincl.h" + + +cl_frame::cl_frame(class cl_box *ipos, class cl_view *iwindow, char *iname, + class cl_app *iapp): + cl_view(ipos, iname, iapp) +{ + win= iwindow; + options&= ~OF_SELECTABLE; +} + +int * +cl_frame::mk_palette(void) +{ + int *p; + + p= (int*)malloc(2*sizeof(int)); + p[0]= C_WIN_FPASSIVE; + p[1]= C_WIN_FACTIVE; + return(p); +} + +int +cl_frame::draw(void) +{ + char *t; + int color; + + color= get_color((win && (win->state&SF_SELECTED))?1:0); + wattrset(window, color); + box(window, ACS_VLINE, ACS_HLINE); + if (!(t= strdup(((class cl_win *)win)->get_title()))) + return(0); + if ((signed)strlen(t) > (pos->w)-4) + t[(pos->w)-4]= '\0'; + mvwprintw(window, 0,((pos->w)-strlen(t))/2, "[%s]", t); + free(t); + app->drawn++; + return(0); +} + + +/* End of gui.src/frame.cc */ diff --git a/sim/ucsim/gui.src/framecl.h b/sim/ucsim/gui.src/framecl.h new file mode 100644 index 00000000..6a3c06a1 --- /dev/null +++ b/sim/ucsim/gui.src/framecl.h @@ -0,0 +1,48 @@ +/* + * Simulator of microcontrollers (framecl.h) + * + * Copyright (C) 1999,99 Drotos Daniel, Talker Bt. + * + * To contact author send email to drdani@mazsola.iit.uni-miskolc.hu + * + */ + +/* This file is part of microcontroller simulator: ucsim. + +UCSIM is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. + +UCSIM is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with UCSIM; see the file COPYING. If not, write to the Free +Software Foundation, 59 Temple Place - Suite 330, Boston, MA +02111-1307, USA. */ +/*@1@*/ + +#ifndef FRAMELCL_HEADER +#define FRAMELCL_HEADER + +#include "viewcl.h" +#include "appcl.h" + + +class cl_frame: public cl_view +{ + class cl_view *win; +public: + cl_frame(class cl_box *ipos, class cl_view *iwindow, char *iname, + class cl_app *iapp); + virtual int *mk_palette(void); + virtual int draw(void); +}; + + +#endif + +/* End of gui.src/framecl.h */ diff --git a/sim/ucsim/gui.src/group.cc b/sim/ucsim/gui.src/group.cc new file mode 100644 index 00000000..45bb0e4f --- /dev/null +++ b/sim/ucsim/gui.src/group.cc @@ -0,0 +1,393 @@ +/* + * Simulator of microcontrollers (group.cc) + * + * Copyright (C) 1999,99 Drotos Daniel, Talker Bt. + * + * To contact author send email to drdani@mazsola.iit.uni-miskolc.hu + * + */ + +/* This file is part of microcontroller simulator: ucsim. + +UCSIM is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. + +UCSIM is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with UCSIM; see the file COPYING. If not, write to the Free +Software Foundation, 59 Temple Place - Suite 330, Boston, MA +02111-1307, USA. */ +/*@1@*/ + +#include "groupcl.h" +#include "appcl.h" + + +cl_group::cl_group(class cl_box *ipos, char *iname, class cl_app *iapp): + cl_view(ipos, iname, iapp) +{ + current= 0; +} + +cl_group::cl_group(char *iname, class cl_app *iapp): + cl_view(iname, iapp) +{ + current= 0; +} + +cl_group::~cl_group(void) +{} + +int +cl_group::init(void) +{ + cl_view::init(); + mk_views(this); + return(0); +} + +int +cl_group::mk_views(class cl_group *ins_to) +{ + return(0); +} + + +/* + * Make output by drawing all subviews + */ + +static void do_draw_view(class cl_view *view) +{ + view->draw(); +} + +int +cl_group::draw(void) +{ + /*int i; + + for (i= 0; i < views->count; i++) + { + class cl_view *v= (class cl_view *)(views->at(i)); + v->draw(); + app->drawn++; + }*/ + for_each(do_draw_view); + return(0); +} + +/*int +cl_group::update(void) +{ + draw(); + update_panels(); + doupdate(); +}*/ + + +int +cl_group::handle_event(struct t_event *event) +{ + int handled= 0; + + if (event->what & (EV_KEY|EV_COMMAND)) + { + if (current) + handled= current->handle_event(event); + } + else if (event->what & EV_MESSAGE) + { + class cl_view *v= last; + do + { + handled= v->handle_event(event); + v= v->next; + } + while (! handled && + v != last); + } + return(handled); +} + + +/* + * Managing views + */ + +//class cl_view * +void +cl_group::insert(class cl_view *view) +{ + /*if (view && + view->ok()) + { + views->add_at(0, view); + view->parent= this; + view->select(); + //view->draw(); + return(view); + } + return(0);*/ + insert_before(view, first()); + if (view->options & OF_SELECTABLE) + view->select(); + draw(); +} + +void +cl_group::insert_before(class cl_view *view, class cl_view *target) +{ + unsigned int ss; + + if (view && + !(view->parent) && + (!target || + target->parent == this)) + { + ss= view->state; + //view->hide(); + insert_view(view, target); + /*if (ss & SF_VISIBLE) + view->show();*/ + if (state & SF_ACTIVE) + view->change_state(SF_ACTIVE, 1); + } +} + +void +cl_group::insert_view(class cl_view *view, class cl_view *target) +{ + view->parent= this; + if (target) + { + target= target->prev(); + view->next= target->next; + target->next= view; + } + else + { + if (!last) + view->next= view; + else + { + view->next= last->next; + last->next= view; + } + last= view; + } +} + +class cl_view * +cl_group::first(void) +{ + if (!last) + return(0); + return(last->next); +} + + +/*class cl_view * +cl_group::get_by_state(unsigned int what, int enabled) +{ + int i; + + for (i= 0; i < views->count; i++) + { + class cl_view *v= (class cl_view *)(views->at(i)); + if ((enabled && + (state&what)) + || + (!enabled && + ((~state)&what)) + ) + return(v); + } + return(0); +}*/ + +/*int +cl_group::select(void) +{ +}*/ + +/*int +cl_group::unselect(void) +{ +}*/ + +int +cl_group::select_next() +{ + /* int start, i; + class cl_view *v; + + if (views->count <= 1) + return(1); + if (current) + start= views->index_of(current); + else + if ((v= get_by_state(SF_SELECTED, 1))) + start= views->index_of(v); + else + if ((v= get_by_state(SF_FOCUSED, 1))) + start= views->index_of(v); + else + start= 0; + i= (start+1)%(views->count); + while (i != start) + { + v= (class cl_view *)(views->at(i)); + if ((v->options & OF_SELECTABLE) && + v->select()) + { + //update(); + return(1); + } + i= (i+1)%(views->count); + }*/ + return(0); +} + +int +cl_group::select_prev() +{ + /* int start, i; + class cl_view *v; + + if (views->count <= 1) + return(1); + if (current) + start= views->index_of(current); + else + if ((v= get_by_state(SF_SELECTED, 1))) + start= views->index_of(v); + else + if ((v= get_by_state(SF_FOCUSED, 1))) + start= views->index_of(v); + else + start= 0; + i= start-1; if (i < 0) i= views->count-1; + while (i != start) + { + v= (class cl_view *)(views->at(i)); + if ((v->options & OF_SELECTABLE) && + v->select()) + { + //update(); + return(1); + } + i= start-1; if (i < 0) i= views->count-1; + }*/ + return(0); +} + +class cl_view * +cl_group::current_sub_view(void) +{ + return(current); +} + +void +cl_group::for_each(void (*func)(class cl_view *view)) +{ + class cl_view *v; + + if (!last) + return; + v= last->next; + do + { + func(v); + v= v->next; + } + while (v != last); +} + +void +cl_group::set_current(class cl_view *view) +{ + //current= view; + if (current == view) + return; + //lock(); + /*focus_view(view, 0);*/ + if ((state & SF_FOCUSED) && + (current != 0)) + current->change_state(SF_FOCUSED, 0); + //if (mode!=ENTER_SELECT) select_view(current, 0); + if (current) + current->change_state(SF_SELECTED, 0); + //if (mode!=LEAVE_SELECT) select_view(view, 1); + if (view) + view->change_state(SF_SELECTED, 1); + //focuse_view(view, 1); + if ((state & SF_FOCUSED) && + (view != 0)) + view->change_state(SF_SELECTED, 1); + current= view; + //unlock(); +} + +/*int +cl_group::terminal_view(void) +{ + return(views->count == 0); +}*/ + +static unsigned int grp_what, grp_en; + +static void +do_set_state(class cl_view *v) +{ + v->change_state(grp_what, grp_en); +} + +void +cl_group::change_state(unsigned int what, int enable) +{ + cl_view::change_state(what, enable); + /*if (enable && + (what & SF_SELECTED)) + { + class cl_view *v= get_by_state(SF_SELECTED, 1); + if (v) + { + current= v; + current->change_state(SF_FOCUSED, 1); + current->change_state(SF_SELECTED, 1); + } + else + { + if ((v= get_by_state(SF_FOCUSED, 1))) + { + current= v; + current->change_state(SF_SELECTED, 1); + } + } + }*/ + switch (what) + { + case SF_ACTIVE: + //lock(); + grp_what= what; + grp_en= enable; + for_each(do_set_state); + //unlock(); + break; + case SF_FOCUSED: + if (current) + current->change_state(SF_FOCUSED, enable); + break; + } + draw(); +} + + +/* End of gui.src/group.cc */ diff --git a/sim/ucsim/gui.src/groupcl.h b/sim/ucsim/gui.src/groupcl.h new file mode 100644 index 00000000..87f0ba88 --- /dev/null +++ b/sim/ucsim/gui.src/groupcl.h @@ -0,0 +1,70 @@ +/* + * Simulator of microcontrollers (groupcl.h) + * + * Copyright (C) 1999,99 Drotos Daniel, Talker Bt. + * + * To contact author send email to drdani@mazsola.iit.uni-miskolc.hu + * + */ + +/* This file is part of microcontroller simulator: ucsim. + +UCSIM is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. + +UCSIM is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with UCSIM; see the file COPYING. If not, write to the Free +Software Foundation, 59 Temple Place - Suite 330, Boston, MA +02111-1307, USA. */ +/*@1@*/ + +#ifndef GROUPCL_HEADER +#define GROUPCL_HEADER + +#include "viewcl.h" + +class cl_group: public cl_view +{ +public: + class cl_view *current; + +public: + cl_group(class cl_box *ipos, char *iname, class cl_app *iapp); + cl_group(char *iname, class cl_app *iapp); + ~cl_group(void); + virtual int init(void); + virtual int mk_views(class cl_group *ins_to); + virtual int is_group(void) {return(1);} + + virtual int draw(void); + //virtual int update(void); + + virtual int handle_event(struct t_event *event); + + virtual /*class cl_view **/void insert(class cl_view *view); + virtual void insert_before(class cl_view *view, class cl_view *target); + virtual void insert_view(class cl_view *view, class cl_view *target); + virtual class cl_view *first(void); + virtual void for_each(void (*func)(class cl_view *view)); + //virtual class cl_view *get_by_state(unsigned int what, int enabled); + //virtual int select(void); + //virtual int unselect(void); + virtual int select_next(); + virtual int select_prev(); + virtual class cl_view *current_sub_view(void); + virtual void set_current(class cl_view *view); + //virtual int terminal_view(void); + virtual void change_state(unsigned int what, int enable); +}; + + +#endif + +/* End of gui.src/groupcl.h */ diff --git a/sim/ucsim/gui.src/label.cc b/sim/ucsim/gui.src/label.cc new file mode 100644 index 00000000..90c54a36 --- /dev/null +++ b/sim/ucsim/gui.src/label.cc @@ -0,0 +1,74 @@ +/* + * Simulator of microcontrollers (label.cc) + * + * Copyright (C) 1999,99 Drotos Daniel, Talker Bt. + * + * To contact author send email to drdani@mazsola.iit.uni-miskolc.hu + * + */ + +/* This file is part of microcontroller simulator: ucsim. + +UCSIM is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. + +UCSIM is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with UCSIM; see the file COPYING. If not, write to the Free +Software Foundation, 59 Temple Place - Suite 330, Boston, MA +02111-1307, USA. */ +/*@1@*/ + +#include "ddconfig.h" + +#include +#include "i_string.h" + +#include "labelcl.h" + + +cl_label::cl_label(class cl_box *ipos, class cl_app *iapp, char *ilabel): + cl_view(ipos, "label", iapp) +{ + options&= ~OF_SELECTABLE; + if (!ilabel || + !(*ilabel)) + label= strdup(""); + else + label= strdup(ilabel); +} + +cl_label::~cl_label(void) +{ + free(label); +} + +int * +cl_label::mk_palette(void) +{ + int *p; + + p= (int*)malloc(1*sizeof(int)); + p[0]= C_WIN_NORMAL; + return(p); +} + +int +cl_label::draw(void) +{ + int color= get_color(0); + + cl_view::draw(); + wattrset(window, color); + mvwprintw(window, 0,0, "%s", label); + return(0); +} + + +/* End of gui.src/label.cc */ diff --git a/sim/ucsim/gui.src/labelcl.h b/sim/ucsim/gui.src/labelcl.h new file mode 100644 index 00000000..79d62886 --- /dev/null +++ b/sim/ucsim/gui.src/labelcl.h @@ -0,0 +1,50 @@ +/* + * Simulator of microcontrollers (labelcl.h) + * + * Copyright (C) 1999,99 Drotos Daniel, Talker Bt. + * + * To contact author send email to drdani@mazsola.iit.uni-miskolc.hu + * + */ + +/* This file is part of microcontroller simulator: ucsim. + +UCSIM is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. + +UCSIM is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with UCSIM; see the file COPYING. If not, write to the Free +Software Foundation, 59 Temple Place - Suite 330, Boston, MA +02111-1307, USA. */ +/*@1@*/ + +#ifndef LABELCL_HEADER +#define LABELCL_HEADER + + +#include "viewcl.h" +#include "appcl.h" + + +class cl_label: public cl_view +{ +public: + char *label; +public: + cl_label(class cl_box *ipos, class cl_app *iapp, char *ilabel); + ~cl_label(void); + virtual int *mk_palette(void); + virtual int draw(void); +}; + + +#endif + +/* End of gui.src/labelcl.h */ diff --git a/sim/ucsim/gui.src/palette.h b/sim/ucsim/gui.src/palette.h new file mode 100644 index 00000000..6f9d383f --- /dev/null +++ b/sim/ucsim/gui.src/palette.h @@ -0,0 +1,44 @@ +/* + * Simulator of microcontrollers (palette.h) + * + * Copyright (C) 1999,99 Drotos Daniel, Talker Bt. + * + * To contact author send email to drdani@mazsola.iit.uni-miskolc.hu + * + */ + +/* This file is part of microcontroller simulator: ucsim. + +UCSIM is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. + +UCSIM is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with UCSIM; see the file COPYING. If not, write to the Free +Software Foundation, 59 Temple Place - Suite 330, Boston, MA +02111-1307, USA. */ +/*@1@*/ + +#ifndef PALETTE_HEADER +#define PALETTE_HEADER + + +#define C_DSK_BG 1 +#define C_DSK_NORMAL 2 +#define C_DSK_DISABLED 3 + +#define C_WIN 8 +#define C_WIN_FPASSIVE 0 +#define C_WIN_FACTIVE 1 +#define C_WIN_NORMAL 5 +#define C_WIN_SELECTED 6 + +#endif + +/* End of gui.src/palette.h */ diff --git a/sim/ucsim/gui.src/view.cc b/sim/ucsim/gui.src/view.cc new file mode 100644 index 00000000..9ead6f48 --- /dev/null +++ b/sim/ucsim/gui.src/view.cc @@ -0,0 +1,356 @@ +/* + * Simulator of microcontrollers (view.cc) + * + * Copyright (C) 1999,99 Drotos Daniel, Talker Bt. + * + * To contact author send email to drdani@mazsola.iit.uni-miskolc.hu + * + */ + +/* This file is part of microcontroller simulator: ucsim. + +UCSIM is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. + +UCSIM is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with UCSIM; see the file COPYING. If not, write to the Free +Software Foundation, 59 Temple Place - Suite 330, Boston, MA +02111-1307, USA. */ +/*@1@*/ + +#include "ddconfig.h" + +#include +#include "i_string.h" + +#include "appcl.h" + + +/* + * Box + */ + +cl_box::cl_box(int ix, int iy, int iw, int ih): + cl_base() +{ + x= ix; + y= iy; + w= iw; + h= ih; +} + +void +cl_box::set(int ix, int iy, int iw, int ih) +{ + x= ix; + y= iy; + w= iw; + h= ih; +} + +void +cl_box::move_rel(int dx, int dy) +{ + x+= dx; + y+= dy; +} + +void +cl_box::grow(int dw, int dh) +{ + w+= dw; + h+= dh; +} + + +/* + * Astbract of a viewer + ****************************************************************************** + */ + +cl_view::cl_view(class cl_box *ipos, char *iname, class cl_app *iapp): + cl_base() +{ + pos= new cl_box(ipos->x,ipos->y, ipos->w,ipos->h); + if ((window= newwin(pos->h,pos->w, pos->y,pos->x))) + { + leaveok(window, TRUE); + panel= new_panel(window); + } + else + { + panel= 0; + delwin(window); + window= 0; + } + parent= 0; + next= last= 0; + app= iapp; + state= SF_NOTHING; + options= OF_SELECTABLE; + if (!iname || + !(*iname)) + { + name= (char*)malloc(100); + sprintf(name, "view%p", this); + } + else + name= strdup(iname); +} + +cl_view::cl_view(char *iname, class cl_app *iapp): + cl_base() +{ + window= 0; + panel= 0; + parent= 0; + next= last= 0; + app= iapp; + state= SF_NOTHING; + options= OF_SELECTABLE; + if (!iname || + !(*iname)) + { + name= (char*)malloc(100); + sprintf(name, "view%p", this); + } + else + name= strdup(iname); +} + +cl_view::~cl_view(void) +{ + if (panel) + del_panel(panel); + if (window) + delwin(window); + if (palette) + free(palette); + if (name) + free(name); +} + +int +cl_view::init(void) +{ + input= mk_input(); + palette= mk_palette(); + //draw(); + return(0); +} + +class cl_gin * +cl_view::mk_input(void) +{ + return(0); +} + +int * +cl_view::mk_palette(void) +{ + return(0); +} + +int +cl_view::ok(void) +{ + return(window && panel); +} + + +/* + * Make output into the view + */ + +int +cl_view::draw(void) +{ + int color, x, y; + + color= get_color(palette?0:C_WIN_NORMAL); + + wattrset(window, color); + for (y= 0; y < pos->h; y++) + for (x= 0; x < pos->w; x++) + mvwaddch(window, y,x, ' '); + app->drawn++; + + return(0); +} + +int +cl_view::update(void) +{ + draw(); + update_panels(); + doupdate(); + return(0); +} + +int +cl_view::get_color(int color) +{ + int *p; + class cl_view *v; + + v= this; + while (v) + { + p= v->get_palette(); + if (p) + color= p[color]; + v= v->parent; + } + return(color); +} + +int * +cl_view::get_palette(void) +{ + return(palette); +} + + +/* + * Event handling + */ + +int +cl_view::get_event(struct t_event *event) +{ + if (parent) + return(parent->get_event(event)); + if (input) + return(input->get_event(event)); + return(0); +} + +int +cl_view::handle_event(struct t_event *event) +{ + return(0); +} + +int +cl_view::unhandled(struct t_event *event) +{ + return(0); +} + +int +cl_view::mk_event(struct t_event *event, FILE *f, int key) +{ + event->what= EV_KEY; + event->event.key= key; + return(1); +} + + +class cl_view * +cl_view::prev(void) +{ + class cl_view *v; + + v= next; + while (v != this) + v= v->next; + return(v); +} + +class cl_view * +cl_view::prev_view(void) +{ + if (parent && + parent->first() == this) + return(0); + else + return(prev()); +} + + +int +cl_view::select(void) +{ + /* class cl_view *v; + + if (!(options & OF_SELECTABLE)) + return(0); + if (state & SF_SELECTED) + return(1); + if (parent && + !(parent->select())) + return(0); + if (parent) + { + v= parent->current_sub_view(); + if (v && + v != this) + v->unselect(); + parent->set_current(this); + } + change_state(SF_FOCUSED, 1); + change_state(SF_SELECTED, 1); + draw(); + return(1);*/ + if (options & OF_SELECTABLE) + if (parent) + parent->set_current(this); + return(1); +} + +int +cl_view::unselect(void) +{ + class cl_view *csv= current_sub_view(); + if (csv && + !(csv->unselect())) + return(0); + if (!terminal_view()) + change_state(SF_FOCUSED, 0); + change_state(SF_SELECTED, 0); + draw(); + return(1); +} + +class cl_view * +cl_view::current_sub_view(void) +{ + return(0); +} + +int +cl_view::terminal_view(void) +{ + return(1); +} + +void +cl_view::change_state(unsigned int what, int enable) +{ + if (enable) + state|= what; + else + state&= ~what; + if (parent) + { + switch (what) + { + case SF_FOCUSED: + //reset_cursor(); + /*message(parent, EV_BROADCAST, + (enable)?CM_RECEIVED_FOCUS:CM_RELEASED_FOCUS, this);*/ + break; + } + } + draw(); +} + + +/* End of gui.src/view.cc */ diff --git a/sim/ucsim/gui.src/viewcl.h b/sim/ucsim/gui.src/viewcl.h new file mode 100644 index 00000000..668fee16 --- /dev/null +++ b/sim/ucsim/gui.src/viewcl.h @@ -0,0 +1,118 @@ +/* + * Simulator of microcontrollers (viewcl.h) + * + * Copyright (C) 1999,99 Drotos Daniel, Talker Bt. + * + * To contact author send email to drdani@mazsola.iit.uni-miskolc.hu + * + */ + +/* This file is part of microcontroller simulator: ucsim. + +UCSIM is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. + +UCSIM is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with UCSIM; see the file COPYING. If not, write to the Free +Software Foundation, 59 Temple Place - Suite 330, Boston, MA +02111-1307, USA. */ +/*@1@*/ + +#ifndef VIEWCL_HEADER +#define VIEWCL_HEADER + +#include +#include + +#include "pobjcl.h" + +#include "palette.h" +#include "eventcl.h" + + +// Status flags +#define SF_NOTHING 0x0000 +#define SF_SELECTED 0x0001 +#define SF_FOCUSED 0x0002 +#define SF_ACTIVE 0x0004 + +// Option flags +#define OF_NOTHING 0x0000 +#define OF_SELECTABLE 0x0001 + + +class cl_box: public cl_base +{ +public: + int x, y; + int w, h; +public: + cl_box(int ix, int iy, int iw, int ih); + void set(int ix, int iy, int iw, int ih); + void move_rel(int dx, int dy); + void grow(int dw, int dh); +}; + + +class cl_app; +class cl_group; + +class cl_view: public cl_base +{ +public: + char *name; + WINDOW *window; + PANEL *panel; + class cl_group *parent; + class cl_view *next, *last; + class cl_app *app; + class cl_gin *input; + class cl_box *pos; + int *palette; + unsigned int state; // See SF_XXXX + unsigned int options; // See OF_XXXX +public: + cl_view(class cl_box *ipos, char *iname, class cl_app *iapp); + cl_view(char *name, class cl_app *iapp); + ~cl_view(void); + virtual int init(void); + virtual class cl_gin *mk_input(void); + virtual int *mk_palette(void); + virtual int is_group(void) {return(0);} + + virtual int ok(void); + virtual int draw(void); + virtual int update(void); + virtual int get_color(int color); + virtual int *get_palette(void); + + virtual int get_event(struct t_event *event); + virtual int handle_event(struct t_event *event); + virtual int unhandled(struct t_event *event); + virtual int mk_event(struct t_event *event, FILE *f, int key); + + virtual class cl_view *prev(void); + virtual class cl_view *prev_view(void); + + virtual int select(void); + virtual int unselect(void); + virtual class cl_view *get_by_state(unsigned int what, int enabled) + {return(0);} + virtual int select_next() {return(0);} + virtual class cl_view *current_sub_view(void); + virtual void set_current(class cl_view *view) {} + virtual int terminal_view(void); + virtual void change_state(unsigned int what, int enable); +}; + + +#endif + +/* End of gui.src/viewcl.h */ diff --git a/sim/ucsim/gui.src/win.cc b/sim/ucsim/gui.src/win.cc new file mode 100644 index 00000000..b5a9a927 --- /dev/null +++ b/sim/ucsim/gui.src/win.cc @@ -0,0 +1,111 @@ +/* + * Simulator of microcontrollers (win.cc) + * + * Copyright (C) 1999,99 Drotos Daniel, Talker Bt. + * + * To contact author send email to drdani@mazsola.iit.uni-miskolc.hu + * + */ + +/* This file is part of microcontroller simulator: ucsim. + +UCSIM is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. + +UCSIM is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with UCSIM; see the file COPYING. If not, write to the Free +Software Foundation, 59 Temple Place - Suite 330, Boston, MA +02111-1307, USA. */ +/*@1@*/ + +#include "ddconfig.h" + +#include +#include "i_string.h" + +#include "wincl.h" + + +cl_win::cl_win(class cl_box *ipos, char *ititle, class cl_app *iapp): + cl_group(ipos, 0, iapp) +{ + title= strdup(ititle); + free(name); + if (!ititle || + !(*ititle)) + { + name= (char*)malloc(100); + sprintf(name, "win%p", this); + } + else + name= strdup(ititle); +} + +cl_win::~cl_win(void) +{ + if (frame) + delete frame; + if (title) + free(title); +} + +int +cl_win::init(void) +{ + cl_group::init(); + if ((frame= mk_frame(pos))) + insert(frame); + class cl_box *b= new cl_box(pos->x,pos->y, pos->w,pos->h); + b->move_rel(1,1); + b->grow(-2,-2); + if ((intern= mk_intern(b))) + insert(intern); + //draw(); + delete b; + return(0); +} + +int * +cl_win::mk_palette(void) +{ + int *p= (int*)malloc(8*sizeof(int)), i; + for (i= 0; i < 8; i++) + p[i]= i+C_WIN; + return(p); +} + +class cl_frame * +cl_win::mk_frame(class cl_box *ipos) +{ + char n[100]= ""; + + sprintf(n, "frameof_\"%s\"", name); + class cl_frame *f= new cl_frame(ipos, this, n, app); + f->init(); + return(f); +} + +class cl_view * +cl_win::mk_intern(class cl_box *ipos) +{ + class cl_view *v= new cl_view(ipos, 0, app); + v->init(); + v->options&= ~OF_SELECTABLE; + return(v); +} + +char * +cl_win::get_title(void) +{ + return(title); +} + + +/* End of gui.src/win.cc */ diff --git a/sim/ucsim/gui.src/wincl.h b/sim/ucsim/gui.src/wincl.h new file mode 100644 index 00000000..ddbd0a9e --- /dev/null +++ b/sim/ucsim/gui.src/wincl.h @@ -0,0 +1,55 @@ +/* + * Simulator of microcontrollers (wincl.h) + * + * Copyright (C) 1999,99 Drotos Daniel, Talker Bt. + * + * To contact author send email to drdani@mazsola.iit.uni-miskolc.hu + * + */ + +/* This file is part of microcontroller simulator: ucsim. + +UCSIM is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. + +UCSIM is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with UCSIM; see the file COPYING. If not, write to the Free +Software Foundation, 59 Temple Place - Suite 330, Boston, MA +02111-1307, USA. */ +/*@1@*/ + +#ifndef WINCL_HEADER +#define WINCL_HEADER + +#include "groupcl.h" +#include "framecl.h" + + +class cl_win: public cl_group +{ +public: + class cl_view *frame; + class cl_view *intern; + char *title; +public: + cl_win(class cl_box *ipos, char *ititle, class cl_app *iapp); + ~cl_win(void); + virtual int init(void); + virtual int *mk_palette(void); + virtual class cl_frame *mk_frame(class cl_box *ipos); + virtual class cl_view *mk_intern(class cl_box *ipos); + + virtual char *get_title(void); +}; + + +#endif + +/* End of gui.src/wincl.h */ -- 2.30.2