[ 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:

- CPU window
- Different kind of windows
- Timer/Counters
- Interrupt system
- Terminal window and CPU option dialog box

#### 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 syntax and command reference. (Now updated up to 0.2.38)
  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