Setup JMRI

• Preparing to Install

Getting Started

• What is DCC?
• What DCC systems will DecoderPro work with?
• What hardware do I need?
• How do I start the program?
• How do I set up my Preferences?

Using DecoderPro

• How do I set up to program a decoder?

DecoderPro® Programming Modes

• What are the Programming Modes?
• Single CV Programmer
• Service Mode Programmer
• Ops Mode Programming
• Multi Decoder Control (Programming)

The Basic Programmer

• Entering Locomotives in the "Roster"
• The basic programmer
• Reading the data from the decoder
• Entering and editing new data
• Writing the new data to the decoder
• Saving the new data to a file
• What if I need to do more?

The Comprehensive Programmer

• Setup and Roster Panes
• Expanded Basic Pane
• Motor Control Pane
• Speed Control Pane
• Speed Table Pane
• Function Mapping Pane
• Lights Pane
• Consisting Pane
• Advanced Features Pane
• Analog Controls Pane
• Sound Pane
• Sound Levels Pane
• Global CV Pane
• Manufacturer-Specific Pane
• Printing the Decoder Data

DecoderPro® Debug Menu

Virtual Sound Decoder

VSD headless mode

Since JMRI 4.15.2 you can run VSD in a so called "headless" mode, i.e. running JMRI (and VSD) without a graphical user interface.
VSD headless is tested to work with JMRI webThrottle.

Please follow these setup steps for the "headless" mode:

• Consider the creation of a new JMRI Profile
• Configure a throttle key for every one of the VSD files to start/stop the engine or activate the "Auto Start Engine" option

  See the details how to do this configuration.
  Alternatively or additionally you can activate the VSD Preference option "Auto Start Engine". Though, I recommend to use the "engine-startstop" option.
  The number of VSDecoders is limited to 4.

• Create a Roster Entry for every one of the VSDecoders

  Launch PanelPro >> Roster >> Roster to add the Roster Entries.

• Create a Roster Group named VSD and assign every one of the Roster Entries to the new Roster Group

  You can use Settings >> Roster Group Table Association to achieve this.

  Then close the "Roster: All Entries" window to get back to PanelPro.

• Save the path and the profile name of every one of the VSDecoders to their Roster

  Please check the path to the folder of your VSD files in VSDecoder Preferences, before you start!

  Navigate to Tools->Virtual Sound Decoder->VSDecoder Manager

  1. Add Decoder
  2. Select a Roster Entry
  3. Load a VSD File
  4. Select the Profile
  5. Click the "Save to Roster" button and confirm with "Yes"
  6. Click the "OK" button
  Repeat the above steps for every one of the VSDecoders (up to 4).

  It's recommended to check the path and the profile name and (as may be the case) label the function key for Start/Stop.
  To do this navigate to Roster >> Roster >> select a Roster entry >> click the "Labels & Media" button.
  Make your changes in the "Function Labels" tab and check the data in the "Roster Media" tab.

• Set the Actions at JMRI Start Up

  In PanelPro navigate to Edit >> Preferences >> Start Up

  Add >> Perform Action >> select "Start Virtual Sound Decoder Manager"

  Note: Do not add the Action "Open JMRI System Console"!

• Create a "JmriFacelessConfig3.properties" file

          <?xml version="1.0" encoding="UTF-8" standalone="no"?>
          <!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
          <properties>
          <comment>Active profile configuration (saved at Wed Jan 09 09:05:26 CET 2019)</comment>
          <entry key="autoStart">true</entry>
          <entry key="autoStartTimeout">10</entry>
          <entry key="activeProfile">x.yyyyyyyy</entry>
          </properties>
          

  Replace the profile.id "x.yyyyyyyy" with the correct one (see profile/profile.properties in your headless Profile).

  Store the new file to your "Settings Location" (JMRI folder).

• JMRI/VSD starting in headless mode

  The following was tested under Windows 10.

  If you are using "Apache Ant" you can enter "ant jmrifaceless". To quit the headless mode do Ctrl+c.

  For Windows you can use "C:\Program Files (x86)\JMRI\LaunchJMRI.exe" /profile x.yyyyyyyy apps.JmriFaceless.
  To end the headless mode I use a throttle function key to trigger a Jython script with the line "jmri.InstanceManager.getDefault(jmri.ShutDownManager).shutdown()".
  See ThrottleSound.py as a starting point to create such a script. Don't forget to include the script to your JMRI Preferences Start Up.

For further explanations how to use web access please see JMRI Web Access.