Skip to main content

JMRI: Quantum Programmer

This page describes Quantum Programmer support that first became available in JMRI version 2.1.5. Previous versions of JMRI do not contain it.

JMRI can now use a Quantum Programmer module to read and write CVs in DCC decoders.

JMRI cannot (yet) download sounds to QSI decoders.

Note that when using JMRI with the Quantum Programmer, the Quantum CV Manager program must not be running. If it is, you'll get obscure errors and JMRI won't be able to access the decoder.

Driver Installation

To access the Quantum Programmer, you need to install a driver on your computer. This section describes how to do that for several popular computer types.

Windows

This is still being worked on.

For JMRI to talk to the Quantum Programmer, drivers have to be installed so that the Quantum Programmer appears to be a serial port (a Virtual Comm Port, or VCP). These drivers are different from the ones that the QSI software uses, so have to be downloaded and installed separately.

There are VCP drivers available from the SiLabs web site. Download and install them. That seems to involve two parts:

Unfortunately, we have not yet managed to get all those pieces together in the right way to make this work. If you'd like to work on this, it would be greatly appreciated.

The Quantum Programmer web site has different instructions, which might give a clue to somebody who wants to work on this.

The problem may be that the standard driver doesn't understand the custom VID/PID pair 0x10C4/0x8208 that the Quantum Programmer uses.

Mac OS X

  1. Download the installation file for the Mac OS X driver. This is a disk image (.dmg) file that should open as a new Finder window. If not, double click on it.
  2. Double-click on the installer and follow the directions.
  3. Restart your computer.
You should now be able to start a JMRI application and access the Quantum Programmer. It will appear as "Quantum Programmer" in the preferences windows.

Linux

This is still being worked on.
  1. Download the installation file for the Linux driver. This is a .tar archive file.
  2. Expand the archive to somewhere convenient, and change directory to there.
  3. Try running the installer via either 
    ./load_qsi_prog
    or 
    sudo ./load_qsi_prog

Configure the Quantum Programmer Support

You configure JMRI to use a Quantum Programmer similarly to the way all other connection types are configured.
  1. Start the program
  2. Select the "Preferences..." item from the "Edit" menu on the main window.
  3. Select "Quantum Programmer" as the connection type.
  4. Select "QSIProgrammer" as the port to use.
  5. The rest of the options are fixed, and can't be changed.
  6. Click the "Save" button. When prompted, allow the program to quit.
The program is now configured. Restart it, and it should be ready to use.

Features and Limitations

The Quantum Programmer hardware is capable of driving one (low-current) locomotive in "Ops Mode". This lets the user run the engine, test the lights, etc. JMRI does not yet have code to do this, but if there's enough interest we can certainly add it.

We currently don't have enough information to download sounds to the decoder through the Quantum Programmer. If we get the information, we'll certainly write this code.