HOW-TO Setup THRSim11 to Simulate the M68HC11 EVB

Jason Bales, 28 Aug 2006

ECE 447, Fall 2006
George Mason University

This document will guide you through setting up THRSim11 to properly simulate the
Motorola 68HC11 Evaluation Board (EVB) that comes in the lab kit for ECE 447 offered
at George Mason University in Fall of 2006. It assumes you have already correctly
installed THRSim11 and you have access to the buffalo.h header file.

1. Start Programs THRSim11 68HC11 Simulator THRSim11

You should get a screen similar to [Figure 1] with the MASON splash in the background.

Figure 1, THRSim11 Startup Screen

Now we need to setup the memory map in THRSim11. Because we are simulating the
Evaluation Board (EVB), the simulation setup will actually need to write data in what is
normally ROM on the EVB. THRSim11 will stop us from writing to memory that is
designated as ROM, so for simplicity, we will set everything to RAM.

2. View Memory Memory configuration

Verify you are selecting the correct menu item by referring to [Figure 2].
 Figure 2, Memory Configuration menu item

THRSim11 will tell you that it needs to close.

3. Click YES

THRSim11 will nicely ask you if you are sure you want to exit

4. Click EXIT

The THRSim11 Memory Configuration Tool will now open. Follow this procedure to set
the address space to RAM. Afterwards verify that your configuration matches [Figure 3].

5. Select User defined from the drop down box in the top left of the window
6. Uncheck all ROMx enabled sections in the second row
7. Set the Ram sections according to this table:

RAM0 RAM1 enabled RAM2 enabled RAM3 enabled

RAM Start $0000 $2000 $0000 $0000
RAM End $01FF $FFFF $0000 $0000

RAM0 is by default always enabled. We are using the RAM1 section to make the rest of
memory RAM. Note that this covers all of memory space except for a small section
$01FF-$1FFF. This is fine. Some of that area is for memory mapped I/O. Ensure that
the remaining RAM and ROM sections are unchecked. It is also OK to leave the LCD
enabled checked if you like, but do not change any of the addresses in the third row (IO
and LCD).
 Figure 3, Memory Configuration Tool

8. Click OK in the top right of the window

THRSim11 will reload and is now ready to simulate your code. If all you are doing is
setting THRSim11 up to simulate, you are done. If you are ready to simulate actual
program code then follow the remaining steps.

We need to include a single header file in our application for our code to simulate
properly.

9. Copy buffalo.h to your source code folder

10. Include it in your main.c file
11. Call buffalo_thrsim_setup() right after you have declared any variables in your
main() function in main.c

Now you are almost ready to simulate the EVB with Buffalo running on it. Compile your
code as normal in the SciTE editor and run it.

12. Tools Build

13. Tools Go

THRSim11 will open if it isn t already running and bring your code up. You are now
ready to start the simulation.