git.gag.com Git - fw/sdcc/blob - sim/ucsim/doc/index.html

   1 <html>
   2 <head>
   3 <title>Mikrocontroller Simulator</title>
   4 </head>
   5
   6 <body bgcolor="white">
   7
   8 [ <a href="#download">Download</a> ]
   9
  10 [ <a href="#install">Installation</a> ]
  11
  12 [ <a href="#use">Usage</a> ]
  13
  14 [ <a href="mailto:drdani@mazsola.iit.uni-miskolc.hu">Mail to
  15 developer</a> ]
  16
  17 <p><img src="UCsim.jpg">
  18
  19 <h1>Software simulator for microcontrollers</h1>
  20
  21 <b><i>&micro;Csim</i></b> can be used to simulate microcontrollers. It
  22 supports MCS51 family. AVR core, Z80, HC08 and XA are supported by
  23 UNIX version only.
  24
  25 <a name="download"><h2>Download</h2></a>
  26
  27 Simulator is available for two platforms: DOS (MCS51 only)
  28 and UNIX but DOS version
  29 is not supported any more. DOS version is not finished so I call it
  30 demo version and it is available in binary only. Limitations of DOS
  31 version are:
  32
  33 <ul><li>There is no built in help available;
  34
  35 <li>Some of the utilities are not working, for example calculator, bit
  36 simulator;
  37
  38 <li>Serial line works in mode 1 independently of mode bits.</ul>
  39
  40 I used this simulator to verify my applications and I never used
  41 missing feautres mentioned above, so I think that this "demo" version
  42 can be usefull anyway.
  43
  44 <p><a
  45 href="http://mazsola.iit.uni-miskolc.hu/~drdani/embedded/s51/download">Download
  46 now</a>
  47
  48
  49 <!-- INSTALL -->
  50
  51 <a name="install"><h2>How to install</h2></a>
  52
  53 <b>DOS version</b>
  54
  55 <p>Get the ZIP file and unzip it. ZIP file contains three files:
  56 <b>s51.exe</b> the executable itself, <b>dpmi16bi.ovl</b> and
  57 <b>rtm.exe</b>. Last two files are required because <b>s51.exe</b> is
  58 a DOS protected mode program. Put these files in a directory which is
  59 in the PATH or keep them together with the <b>s51.exe</b>.
  60
  61 <p><b>UNIX version</b>
  62
  63 <p>UNIX version is distributed in source.
  64
  65 <ol><li>Get archive file, uncompress and untar it. These steps will
  66 produce a directory <b>ucsim-X.Y.Z</b> where X.Y.Z is the version
  67 number.
  68
  69 <li>Go to the directory and configure the package. Issue
  70 <tt><b>configure</b></tt> command. It will determine your system and
  71 make <b>Makefile</b>. Installation directory can be specified with
  72 <b><tt>--<!-- -- -->prefix=<i>dir</i></tt></b> option to the
  73 <tt><b>configure</b></tt>. Default directory is
  74 <tt>/usr/local</tt>. Executable file will be placed in <tt>bin</tt>
  75 subdirectory.
  76
  77 <li>Compile the package with <tt><b>make</b></tt> command.
  78
  79 <li>Install executables <b>s51</b>, <b>savr</b>, <b>shc08</b>,
  80 <b>sxa</b>, <b>sz80</b> to any directory you want. It can be done with
  81 <tt><b>make install</b></tt> command which will place files in
  82 installation directory specified with <tt><b>--<!-- --
  83 -->prefix=<i>dir</i></b></tt> option of
  84 <tt><b>configure</b></tt>. Note that you may have to have special
  85 privilege to do this if installation directory is not writable by you.
  86
  87 </ol>
  88
  89
  90 <!-- USE -->
  91
  92 <a name="use"><h2>How to use</h2></a>
  93
  94 <h4>DOS version</h4>
  95
  96 S51 for DOS has been written in Borland Pascal using Turbo Vision to
  97 produce menu driven, multiwindow user interface which is very easy to
  98 use. The program can be started using following command:
  99
 100 <p><tt>C:\> s51 [input file]</tt>
 101
 102 <p>Parameter is optional. If it specified it must be the name of an
 103 Intel hex file. Some screenshots of the program and short descriptions
 104 of them:
 105
 106 <ul><li><a href="cpu.html">CPU window</a>
 107
 108 <li><a href="wins.html">Different kind of windows</a>
 109
 110 <li><a href="timers.html">Timer/Counters</a>
 111
 112 <li><a href="interrupt.html">Interrupt system</a>
 113
 114 <li><a href="term_cpuopt.html">Terminal window and CPU option dialog
 115 box</a></ul>
 116
 117
 118 <h4>UNIX version</h4>
 119
 120 <a href="invoke.html">Invokation</a>. <br>Starting the simulator
 121 program.
 122
 123 <p><b>Features of the simulator</b>
 124
 125 <ul>
 126
 127 <li><a href="analyzer.html">Code analyzer</a>. <br>The simulator tries
 128 to figure out places of valid instructions in code area. This feature
 129 included in both DOS and UNIX versions.
 130
 131 <li><a href="cpu_types.html">Processor types</a>. <br>The simulator can
 132 simulate different type of microcontrollers.
 133
 134 <li><a href="mulcons.html">Multiple consoles</a>. <br>The simulator can
 135 handle more than one command consoles and accepts command from
 136 multiple sources. It also can be driven by other programs such as
 137 debugger interfaces.
 138
 139 <li><a href="serial.html">Serial interfaces</a>. <br>The simulator can
 140 virtually connect a terminal to serial interface of the simulated CPU.
 141
 142 <li><a href="memory.html">Memory simulation</a>. <br>Simulated CPU
 143 provides address spaces, storage is simulated by memory chips, address
 144 decoders conects them together.
 145
 146 <li><a href="syntax.html">Command syntax</a> and <a
 147 href="cmd.html">command reference</a>. <i>(Now updated up to
 148 0.5.0)</i> <br>The simulator can be controlled via a command line
 149 interface. It accepts simple commands.
 150
 151 </ul>
 152
 153 <hr>
 154
 155 <table border="0">
 156 <tr><td><a href="mailto:drdani@mazsola.iit.uni-miskolc.hu"><img
 157 src="post.jpg" align="top" border="0"></a></td>
 158
 159 <td><i>&copy; 1997,99 Dániel Drótos, Talker Bt.</i> <br><a
 160 href="mailto:drdani@mazsola.iit.uni-miskolc.hu">drdani@mazsola.iit.uni-miskolc.hu</a></td></tr>
 161 </table>
 162
 163 </body>
 164 </html>