From Bcontrol
Revision as of 16:54, 6 August 2009 by CarlosBrody (talk | contribs) (Downloading and compiling the Emulator)

FSM Emulator

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

  1. 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.
  2. Make sure you have Qt 4 or higher. You can get this freeware here
  3. Download the Emulator code here ; unzip it after downloading.
  4. In a terminal, cd to YOUR_EMULATOR_DIR/rt-fsm/emulator. Then run
  unix% ./compile.sh clean
  unix% ./compile.sh 

At this point, YOUR_EMULATOR_DIR/rt-fsm/emulator/FSMEmulator.app should be an executable that you can open.