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
XA family is simulated by sxa
HC08 processor is simulated by shc08
ST7 family is simulated by sst7
STM8 family is simulated by sstm8
TLCS90 family is simulated by stlcs
Padauk family is simulated by spdk
p1516 family is simulated by sp1516
Motorola MC6809 family is simulated by sm6809

The simulator can be started in the following way:

$ s51 [-hHVvPgGwlbB] [-p prompt] [-t CPU] [-X freq[k|M]] [-R seed] [-C cfg_file] [-e command] [-c file] [-s file] [-S optionlist] [-I if_optionlist] [-a nr] [-Z portnum] [-k portnum] [-o colorlist] [files...]

Specified files must be names of Intel hex files. Simulator loads them in the specified order into the ROM of the simulated system. If the file is specified without extension, the simulator will try to find intel hex file (filename extended with .hex), omf file (with .omf) and cdb file (with .cdb extension). Simulator can interpret content of these SDCC output files and reads information from them.


-t CPU
Type of CPU. Recognized types are different for different simulators, for example MCS51 simulator recognizes 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, DS390, DS390F. Note that recognition of a CPU type as option does not mean that the simulator can simulate that kind of CPU. Default type is C51.
DS390 supports Dallas DS80C390 24 bit flat mode, dual-dptr operations, etc. DS390F is the same as DS390, but it starts already in 24 bit flat mode (ACON = 0xFA instead of 0xF8). DS390F is needed to run programs compiled with sdcc -mds390.
-H option can be used to list all of recognized CPU types.
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.
-R seed
Set seed value for the random number generator.
-C cfg_file
Read and execute initial commands from specified file.
-e command
Execute command at program startup (before config file).
-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 μCsim can serve multiple consoles. You can get a console by simply telnet into machine running μCsim to port portnumber. This option is not available on platforms which doesn't support BSD networking.
See how to use multiple consoles.
-k portnum
Listen for incoming connections on port portnum. When this port connected, the connection will be attached to simulated UART0.This option is not useful for other UARTs, so it is better to use the more general -S option.
-s file
Connect serial interface (UART0) 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 terminal with -s option.
-S uart=nr,in=file,out=file,port=nr,iport=nr,oport=nr
Using this option you can specify different files for input and output streams that μCsim uses to simulate microprocessor's serial interface.
See more about serial interface simulation.
-I if=memory[address],in=file,out=file
Specify options (as comma separated list) for the simulator interface. if option turns on the interface and specifies address space and location for use by the interface. in and out can be used to specify file names to use for file IO.
See more about simulator interface.
-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.
Prompt will be a null ('\0') character. This feature can be useful for programs which controls simulator through a pipe.
-o colorsetting,...
List of color settings in form: what=colspec,... where what specifies object to be colored and colspec is : separated list of color options e.g.: prompt=b:white:black (bold white on black).
what can be:
colspec can be a rendering option, or a color name. First color name is used for foreground color and the last one will be the color of background. Rendering options are:
Color name can be a predefined name, or an RGB value. Known names are:
How the named colors appear on the screen depends on the terminal emulator program.
RGB values can be specified as #RRGGBB where components are two character hexadecimal values of the red, green and blue.
Example (set prompt to blinking bold white on green, and set command to underlined bright green on black):
-o prompt=lb:white:green,command=u:bgreen:black
Use colors of light theme (default is dark)
Black & white (non-color) console.
Beep on breakpoints. Print out a beep character to the console when a breakpoint hits.
Go, start simulation when the program is loaded.
Start simulation when the program is loaded and terminate the simulator when the simulation stops (maybe on breakpoint).
-a nr
Set size of variable space. Default is 256.
Writable flash.
Verbose mode. The simulator notifies you about some kind of internal actions for example interrupts. Messages are printed on command console.
Print out version number and stop.
Print out types of known CPUs. Names printed out by this option can be used to determine CPU type using -t option.
Print out a short help about the options and stop.