From Bcontrol
Revision as of 22:17, 5 November 2010 by Pkarri (talk | contribs)

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_prompt% ./compile.sh clean
  unix_prompt% ./compile.sh 

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

Latest FSM Emulator for Windows XP/Vista/7

  1. Download the Emulator binary here ; unzip it after downloading to a folder.
  2. Open the folder, and double-click on FSMEmulator.exe to launch.
  3. On Windows Vista and higher, right-click on FSMEmulator.exe and select "Run as Administrator" to launch.