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