JMRI: RailDriver Throttle

This page is under construction. JMRI's RailDriver support was first available in JMRI 2.1.7. It is evolving rapidly, so check back here or on the jmriusers mailing list for changes.

JMRI allows you to use a RailDriver from PI Engineering as a throttle to run locomotives with your DCC system.

First, connect your computer to your DCC system and make sure that the regular JMRI throttles are working fine. (Unless you do this first, debugging possible problems connecting the RailDriver is very difficult)

Next, plug the RailDriver into a USB port on your computer while your JMRI application (PanelPro or DecoderPro) isn't running.

Finally, start the JMRI program and select "RailDriver Throttle" from the Debug menu. (It's temporarily there while we develop the support) A Throttle window with the title "RailDriver" should open.
throttle window

Type the address of your locomotive (DCC address) into the address box, just like a regular JMRI throttle, and click "Set". This connects both the throttle window and the RailDriver console through the DCC system to the decoder. You should now be able to operate the locomotive from the RailDriver.

The top row of buttons across the front edge control the decoder functions. The left most (1 in the figure) is F0, usually the headlight. The next button to the right (2 in the figure) is F1, etc. When you press the button, the function toggles: From off to on, or on to off. Try pressing one, and see if the throttle function buttons on the screen and the functions in the locomotive respond.

The "Bell" button (37 in the figure) drives F3 (this can be changed by editting a file in the JMRI distribution if your DCC system uses something different). It's momentary, so F3 is set on when the button is pressed, and off when it's released.

The horn lever (38 in the figure) operates F2. Push it forward or back to turn F2 on, and release or center it to turn F2 off.

The left-most large handle, labeled "Forward N Reverse" (39 in the figure) serves to control direction. Since (most) DCC decoders don't have a neutral position, the N position isn't used.

The next lever, labelled "Dyn Brake Throttle" (40 in the figure), controls the decoder speed setting. For now, zero speed is (roughly) the center, and higher speeds are when the lever is pulled back.

Eventually, we'd like to make a more detailed simulation available by connecting the rest of the controls, and adding a detailed model of the trains braking and accelaration.

For technical information, please see the details page.