The simulator will continue executing the provided program until either the
user hit Ctrl-C or the program completion condition is met. The program
completion condition can be set by defining a macro PROGRAM_COMPLETION
located in i8051.h to indicate the program
completion condition, e.g., RAM[P0] == 0x01.
The program's output can be controlled through the macros PORTS, DEBUG, DEBUG_PC and DETAIL located in i8051.h. If PORTS is defined, anytime one of the output ports of the 8051 changes all ports will be printed out. If DEBUG is defined, a trace of all instructions executed by the simulator will be outputted to the output file specified by the user. If DEBUG is defined and DEBUG_PC is defined the PC for each instruction executed will be outputted to the output file. Finally, if DETAIL is defined, more information regarding each instruction will outputted to the output file.
NOTE: DEBUG_PC and DETAIL are not available in version 1.0.
To use the simulator, edit i8051.h and uncomment
the PORTS, DEBUG, DEBUG_PC, and/or DETAIL macros to enable the respective
output. Modify the
macro PROGRAM_COMPLETION to the appropriate completion condition. If
there is no program completion condition do not define PROGRAM_COMPLETION.
Make the executable using the supplied Makefile.
The program can be invoked by the following command
An archive of previous versions of the simulator can be found here.
Please direct any problems and comments to dalton@cs.ucr.edu. We will respond to all inquiries as quick as possible.
Last Updated 1/5/2001