Files
Z8C-Homebrew-Computer/OperatingSystem/.unused/cmon/sdcc/share/doc/ucsim/index.html
2024-06-24 20:38:02 +02:00

119 lines
5.8 KiB
HTML

<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>Mikrocontroller Simulator</title>
</head>
<body style=" background-color: white;"> [ <a href="news.html">News</a> ]
[ <a href="#download">Download</a> ] [ <a href="#install">Installation</a>
] [ <a href="#use">Usage</a> ] [ <a href="mailto:drdani@mazsola.iit.uni-miskolc.hu">Mail
to developer</a> ]
<p> </p>
<pre><tt><font size="+1">
_____ _
/ ____| (_)
_ _| | ___ _ _ __ ___
| | | | | / __| | '_ ` _ \
| |_| | |____\__ \ | | | | | |
\ ._,_|\_____|___/_|_| |_| |_|
| |
|_|
</font></tt></pre>
<h1>Software simulator for microcontrollers</h1>
<b><i>μCsim</i></b> can be used to simulate microcontrollers. It supports
MCS51 family, AVR core, Z80, HC08, ST7, STM8, TLCS90, XA51 and Padauk. It can
run on Linux, Windows, OSX, BSD, and other systems.<br>
<br>
See <a href="news.html">what's new</a> in current version.<br>
<h2><a name="download">Download</a></h2>
There are two places where you can download <i>μCsim</i> from:<br>
<ol>
<li>SDCC homepage. <i>μCsim</i> is part of the SDCC (Small Device C
Compiler) project. You can download source of SDCC and precompiled
binaries from <a href="http://sdcc.sf.net">http://sdcc.sf.net</a>.</li>
<li><i>μCsim</i> site. Standalone source package is available on the <i>μCsim</i>
web site:<br>
<a href="http://mazsola.iit.uni-miskolc.hu/ucsim/download">http://mazsola.iit.uni-miskolc.hu/ucsim/download</a>
</li>
</ol>
<p><!-- INSTALL --></p>
<h2><a name="install">How to install</a></h2>
UNIX version is distributed in source.
<ol>
<li>Get archive file, uncompress and untar it. These steps will produce a
directory <b>ucsim-X.Y.Z</b> where X.Y.Z is the version number. </li>
<li>Make sure, that following packages are installed on your system: <b>make</b>,
<b>bison</b> (or yacc), <b>flex</b> (or lex), <b>libncurses-dev</b>.
You will need a C and a C++ compiler as well.</li>
<li>Go to the directory and configure the package. Issue <tt><b>configure</b></tt>
command. It will determine your system and produce <b>Makefile</b>.
Installation directory can be specified with <b><tt>--prefix=<i>dir</i></tt></b><!-- -- -->
option to the <tt><b>configure</b></tt>. Default directory is <tt>/usr/local</tt>.
Executable file will be placed in <tt>bin</tt> subdirectory. </li>
<li>Compile the package with <tt><b>make</b></tt> command. </li>
<li>Install executables <b>ucsim_51</b>, <b>ucsim_avr</b>, <b>ucsim_hc08</b>, <b>ucsim_xa</b>,
<b>ucsim_z80, etc.</b> to any directory you want. It can be done with <tt><b>make
install</b></tt> command which will place files in installation
directory specified with <tt><b>--prefix=<i>dir</i></b><!-- --
--></tt> option of <tt><b>configure</b></tt>. Note that you may have to have
special privilege to do this if installation directory is not writable
by you. </li>
</ol>
<!-- USE -->
<h2><a name="use">How to use</a></h2>
<ul>
<li> <a href="invoke.html">Invocation</a>.<br>
Starting the simulator program. </li>
</ul>
<p><b>Features of the simulator</b> </p>
<ul>
<li><a href="analyzer.html">Code analyzer</a>. <br>
The simulator tries to figure out places of valid instructions in code
area.</li>
<li><a href="cpu_types.html">Processor types</a>. <br>
The simulator can simulate different type of microcontrollers. </li>
<li><a href="mulcons.html">Multiple consoles</a>. <br>
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. </li>
<li><a href="serial.html">Serial interfaces</a>. <br>
The simulator can virtually connect a terminal to serial interface of
the simulated CPU. </li>
<li><a href="memory.html">Memory simulation</a>. <br>
Simulated CPU provides address spaces, storage is simulated by memory
chips, address decoders connects them together. </li>
<li><a href="simif.html">Simulator interface</a>.<br>
This is a special interface which provides services for the simulated
program. This services can be used to control the simulator (for example
run/stop) and access some host features (print, file I/O).</li>
<li><a href="vcd.html">VCD file I/O</a>.<br>
This is a special virtual hardware peripheral which can monitor changes
of a memory location (or a bit in MCS51 where bit address space is
available) and write out changes to a VCD file. It can also be used to
replay events from a VCD file in order to simulate external events.</li>
<li><a href="syntax.html">Command syntax</a> and <a href="cmd.html">command
reference</a>. <br>
The simulator can be controlled via a command line interface. It accepts
simple commands. </li>
</ul>
<p><b>Microcontroller specific features</b> </p>
<ul>
<li><a href="stm8/index.html">STM8</a></li>
</ul>
<h2><a name="dev">Developers</a></h2>
<ul>
<li><a href="testing.html">Regression Testing</a></li>
</ul>
<hr>
<table border="0">
<tbody>
<tr>
<td><a href="mailto:drdani@mazsola.iit.uni-miskolc.hu"><img src="post.jpg"
border="0" align="top"></a></td>
<td><i>© 1997,99 Dániel Drótos, Talker Bt.</i> <br>
<a href="mailto:drdani@mazsola.iit.uni-miskolc.hu">drdani@mazsola.iit.uni-miskolc.hu</a></td>
</tr>
</tbody>
</table>
</body>
</html>