The Emulator shares most of its source code with the actual RT Linux source code, but runs on your laptop. It is thus a good place to start and learn to write protocols, interact with the state machine, and so on: you don't need an RT Linux machine for this, you just need your laptop. Instead of physical pokes, there are buttons that you click on with your mouse.
(Note: One currently very confusing thing about the Emulator's graphical interface: Ch. 00 is the Center poke; Ch. 01 is the Left poke, and Ch. 02 is the right poke. That is, they are ordered C,L,R, instead of L,C,R. We'll get around to changing that at some point.)
Downloading and compiling the Emulator
The following has been tested on a Mac, not yet on Windows (although it should work for Windows also, previous Emulator versions worked on Windows.) To download and compile the Emulator, you need to
- On the Mac, make sure you have installed all the XCode Tools in full. These come with your OS disks. If in doubt, put the first OS disk into your drive, and options to install XCode tools will then come up.
- Make sure you have Qt 4 or higher. You can get this freeware here
- Download the Emulator code here (You will need an svn client to download it, see below); unzip it after downloading.
- In a terminal, cd to YOUR_EMULATOR_DIR/rt-fsm/emulator. Then run
unix_prompt% ./compile.sh clean unix_prompt% ./compile.sh
- Windows: Tortoise SVN Download here
- Mac: It comes with the Developer's Tools on a Mac. So, install the Developer's Tools, if you haven't yet. They can be found on the CD/DVD that comes with the Mac's purchase.
sudo apt-get install svn
At this point, YOUR_EMULATOR_DIR/rt-fsm/emulator/FSMEmulator.app should be an executable that you can open.
Latest FSM Emulator (binary only) for Windows XP/Vista/7
- Download the Emulator binary here ; unzip it after downloading to a folder.
- Open the folder, and double-click on FSMEmulator.exe to launch.
- On Windows Vista and higher, right-click on FSMEmulator.exe and select "Run as Administrator" to launch.