.. include:: /include/include.rst
.. include:: /include/include-l2.rst
.. include:: /include/include-description.rst
*********
Documents
*********

|conductor| |tinkerer| |engineer|

.. sidebar::

   .. contents:: On this page
     :depth: 1
     :local:

Java Model Railroad Interface JMRI with EX-CommandStation
=========================================================

JMRI 'Java Model Railroad Interface' software suite provides a GUI Graphical User Interface Controller for the |EX-CS|.

The primary |JMRI| software applications are; 
 - DecoderPro to build and maintain DCC Engine Rosters and read, write, compare & maintain decoder CV's
 - PanelPro to create and maintain Panels, Turnouts, Sensors, Signal Lighting & create Routes
 - OperationsPro to run operating sessions on your model railroad.
 
|JMRI| software is supported on Windows & Mac PC's and on Linux Pi microcontrollers.

With experience, |JMRI| users can prepare Routing and Automation sequences for their engines to run either by manual Routing or Autonomously by writing extensive Jython/Python.py scripts and setting them up through a myriad of user-friendly panels and sensors, turnouts & routing tools.  
These scripts can then be placed in GUI buttons on DecoderPro & PanelPro main menus and also displayed as Routing buttons on smartphones with |Engine Driver| or |WiThrottle| and other WiFi Throttle app providers.
 

JMRI Jython.py script to Add Custom DCC-EX Buttons to DecoderPro & PanelPro menus
=================================================================================

Have DCC-EX command references automatically shown through the DecoderPro Script Output Window.

You can also add user defined ATC Automatic Throttle Control Jython.py scripts to GUI buttons on DecoderPro and PanelPro main menus.

.. image:: /_static/images/jmri/DCCEX_JMRI_Script_windows1.jpg
   :alt: DCC-EX JMRI scripts
   :scale: 25%
   :align: left
   
.. rst-class:: dcclink

Download DCC-EX Commands.py script (zip) files for JMRI to display DCC-EX Command Summary Lists through the JMRI Script Output Window. 
   `DCC-EX Commands JMRI Script </_static/documents/DCC-EX_Commands_4.1.zip>`_

.. rst-class:: clearer


How To; Create DCC-EX Buttons on JMRI main menus (PDF)
======================================================

This pdf file provides instruction on how to install our custom scripts in JMRI and assign them to buttons. 
You can have the command references for |DCC-EX| shown through the Script Output Window in DecoderPro as seen above.

.. image:: /_static/images/icons/pdf_logo_sm.png
   :alt: DCC-EX JMRI script install instructions
   :scale: 75%
   :align: left
   
.. rst-class:: dcclink

   `DCC-EX + JMRI Custom GUI Buttons SetUp </_static/documents/DCC-EX_4.1_JMRI_Script+Button_Instructions.pdf>`_

.. rst-class:: clearer


Comprehensive DCC-EX & JMRI DecoderPro Getting Started Guide PDF
================================================================

For a more extensive overview of setting up |EX-CS| with JMRI DecoderPro please download and review

.. image:: /_static/images/icons/pdf_logo_sm.png
   :alt: EX-CS & JMRI Getting Started Guide
   :scale: 75%
   :align: left
   
.. rst-class:: dcclink

   `EX-CommandStation 4.1 & JMRI DecoderPro 5.2 Getting Started Guide.pdf version 4.0 </_static/documents/Updated_DCC-EX_4.1_and_JMRI_DecoderPro_5.2_-_Getting_Started_Guide.pdf>`_

.. rst-class:: clearer

Other Documentation
===================

DCC Shortcuts Card
===================

DCC Manufacture Decoder Identification

.. image:: ../../_static/documents/dcc_shortcuts_card_thumbnail.png
   :alt: DCC Shortcuts Card Thumbnail
   :scale: 26%
   :align: left

.. rst-class:: dcclink

   `DCC Shortcuts Card </_static/documents/DCC_Shortcuts_Card.pdf>`_

.. rst-class:: clearer

Stationary Decoder Address Table (xlsx Spreadsheet)
===================================================

With EX-CommandStation's new linear address function, there is no need to have to convert back and forth between linear addresses and the 2-part address, subaddress format. However, if you use the old format or have a decoder to a switch that uses it, this table can come in handy. Credit to Tom Busza for putting this together for |JMRi| and |DCC-EX| users!

.. image:: ../../_static/documents/acc_conv_sheet_thumbnail.png
   :alt: Accessory conversion sheet thumbnail
   :scale: 30%
   :align: left

.. rst-class:: dcclink

   `Stationary Decoder Address Table </_static/documents/DCCpp-stationary-decoder-addresses.xlsx>`_