Skip to main content

JMRI® connects to...
DCC++
Supported Hardware
Devices, command stations, networks, and protocols:
Applications
By the community of JMRI.org:
Tools
JMRI tools for working with your layout:
Layout Automation
Use JMRI to automate parts of your layout and operations:

JMRI Help:

Contents Index
Glossary FAQ

Donate to JMRI.org

Hardware Support: DCC++

Overview

Note: DCC++ is no longer updated or supported by the DCC-EX development team or the original author.
It has been replaced by the EX-CommandStation by the DCC-EX team. although it will continue to function with JMRI. However it is recommended by the DCC-EX team that you upgrade DCC++ systems to EX-CommandStation, which will work on the existing hardware.

DCC++ is an Open Source Arduino-based Do-it-Yourself DCC Command Station.

Note: DCC++ is a separate project from JMRI. If you have questions about building a DCC++ system, operating it, etc, you should get help via the DCC++ TrainBoard thread and the the DCC++ Documentation TrainBoard thread. There's also information on the DCC++ GitHub repository and associated documentation and the DCC++ Trainboard discussion. The DCC-EX team no longer provide any support for DCC++. The JMRI discussion groups can only provide limited support for DCC++ itself.

Features include:

Supported Hardware

Command Stations

Currently DCC++ Base Stations can be built from either the Arduino Uno or Arduino Mega platforms. JMRI should support either platform via USB or Network connection.

Computer Interfaces

Currently, four interfaces are supported:

Simulator

To use the Simulator, simply choose that option in the JMRI Preferences. Note that some features do not work in the Simulator. For example, the Simulator does not (yet) support assigning, storing, and remembering Sensor and Turnout assignments. The Simulator interface is functional enough to keep JMRI "happy" while working on offline projects such as Operations or Panel and Logix design, but is not intended to be a full-fledged Base Station Emulator.

DCC++ Over TCP

For the DCC++ Over TCP, a host computer must be connected to the Base Station over a Serial or Network connection (or a simulator). This host computer then runs the DCC++ Over TCP Server. A remote computer (or several remote computers) can then use the DCC++ Over TCP (Server) interface to remotely access and control the Base Station.

Limitations

JMRI

JMRI currently supports the V1.1 Base Station Interface. Some V1.0 commands may not work.

Connecting

Configuring an Arduino for use as a DCC++ Base Station

In order to use an Arduino as a Base Station, you must first assemble the device and download the Base Station firmware to it. Please follow the instructional videos linked below under Other Info.

Connecting to a DCC++ Base Station via USB

  1. To connect your computer to a DCC++ Base Station, first install the appropriate drivers.
    • For the DCC++ Base Station with JMRI, you may need to install a device driver on your computer. Please refer to the Arduino Getting Started pages for instructions.
      • Windows (See Step 4)
      • Mac: No drivers should be required
      • Linux
      page

    Note: If you have already installed the Arduino IDE software, the device drivers should already be installed.

    When the device drivers are installed, connect the Arduino Base Station to your computer using a standard USB cable.

  3. Once the drivers are installed, you are ready to configure JMRI. Start one of the JMRI-based programs, Then go to the preferences panel. This opens automatically the first time a program is run, or you can select it from the "Edit" menu.
  4. Select "DCC++" from the top selection box ("System Manufacturer").
  5. Select "DCC++ Serial Port" from the second selection box ("System Connection")
  6. Select the appropriate USB/Serial port from the third selection box ("Serial Port")
  7. Click "Save". You'll be asked if it's OK for the program to quit, click "Yes".
  8. Restart the program. You should be up and running.

Connecting to a DCC++ System using Network

  1. First, connect the DCC++ Base Station to wired or WiFi network and record the IP Address and Port number. You may need to connect the Arduino to a host computer temporarily and use the Arduino Serial Monitor to get this information.
  2. Now you are ready to configure JMRI. Start one of the JMRI-based programs, then go to the Preferences panel. This opens automatically the first time a JMRI program is run, or you can select it from the "Edit" menu (from the Application menu on OS X).
  3. Select "DCC++" from the top selection box ("System Manufacturer").
  4. Select "DCC++ Ethernet" from the second selection box ("System Connection").
  5. Input the IP Address and Port Number of the DCC++ Base Station.
  6. Click "Save". You'll be asked if it's OK for the program to quit, click "Yes".
  7. Restart the program. You should be up and running.

Connecting to a DCC++ System using DCC++ Over TCP

  1. First, connect the DCC++ Base Station to the host computer via the Serial or Network interface as described above.
  2. On the host computer select "Load DCC++ Over TCP Server" from the DCC++ Menu. Check the settings, then press the "Start Server" button. If you want the server to automatically start when JMRI is launched, click the checkbox provided.
  3. The Host computer must be running with the DCC++ Server active before launching the Client computer.
  4. On the client computer, launch JMRI on the Client computer.
  5. In the Connection Preferences, select DCC++ as the System Manufacturer.
  6. Select "DCC++ Server" as the System Connection Type.
  7. Enter the network name or IP address of the host computer and verify that the port number is the same as on the host computer.
  8. Save your Preferences and restart.

Once both the Host and Client instances of JMRI are configured, you can use the Client JMRI just the same as if it were directly connected to the Base Station. The client JMRI instance can be on the same computer, in the same house, or across the country from the host.

Connecting to the DCC++ Simulator

  1. Start one of the JMRI-based programs, Then go to the preferences panel. This opens automatically the first time a program is run, or you can select it from the "Edit" menu.
  2. Select "DCC++ Simulator" from the top selection box. There are no additional configuration steps required to use the DCC++ Simulator.
  3. Click "Save". You'll be asked if it's OK for the program to quit, click "Yes".
  4. Restart the program. You should be up and running.

JMRI DCC++ Tools

menu

The DCC++ menu contains 5 tools:

generate packet track current config to tcp/ip

Documentation

JMRI Help

Additional documentation will be provided on other pages linked here:

Third Party info

For more information on how to construct and program a DCC++ Base Station, refer to the following: