JMRI Hardware Support - Maple Systems
Keywords: JMRI help Maple hardware

# Hardware Support: Maple Systems

Maple Systems makes several series of touchscreen panels that can be very useful on model railroads.

The following information is based on the orignal devices running EZWare. The current devices use EPBro. The detail links do not work but are shown for reference.

Each panel is really a standalone (Windows) computer. It is configured and loaded using the EZware configuration program (http://www.maplesystems.com/products/graphic-hmi/tabmenu-features/faq/index.html#collapse-1-5) provided by Maple Systems. That configuration defines the displays, button labels and locations, etc.

## Limitations

This is still in the very early stages, so details are changing rapidly. If you want to use these devices, please contact the JMRI developers.

## Connecting

### Settings

JMRI interacts with the Maple panel through input and output bits (called "coils", as in relay coils) within the panel. The panel configuration can set these in response to various events. JMRI provides Sensor objects that make them available for triggering actions within JMRI. JMRI can defines Turnout objects which can set them, in which case the panel configuration can change what's being displayed.

You have to configure a Maple Systems Node into JMRI with the "Configure Nodes" button on the JMRI Preferences pane. On the pane that opens, enter the Node number (e.g. 1 or 2, etc) into the "UA" field, and click "Add". Leave all the rest alone; the Maple Support was created from the JMRI C/MRI support, and as of JMRI version 2.3.7 the migration is not complete.

#### Naming

The default system letter for Maple connections in JMRI is "K".

You configure the Maple Systems device to use one of the supported speeds (set on the JMRI Preferences pane for Maple connections), and to use the "Simple ASCII Protocol". More information on the protocol and how to configure the Maple Systems device is on Maple PDF data sheet (http://www.maplesystems.com/1033/10330073.PDF).

JMRI communicates with the Maple Systems device by reading and writing "discrete memory" locations, otherwise known as "LB" registers.

LB registers 1 through 48 are available to JMRI as input "Sensors" 1 to 48.

LB registers 1001 through 1048 are available to JMRI as output "Turnouts" 1 through 48.

The Maple Systems node number (programmed into "Parameter 5", the "HMI station ID #") can be 1 through 99. It appears as the thousands digit of JMRI Sensors and Turnouts System Names. For example, KS3001 is the 1st sensor on node 3, and would therefore be LB 1 in that Maple Systems unit. KT3001 is the 1st turnout on that node, and would therefore be LB 101 in that unit.

Here's a summary of the options per Connection, split up for outputs (eg. Turnouts) and inputs (eg. Sensors):

In/Out | Entry | Meaning | makes System Name | Mask | Equivalent | Minimum | Maximum
--- | --- | --- | --- | --- | --- | --- | ---
i | 2010 | Node 2 Input bit 10 | KS2010 |  |  | 1 | 1000
o | 1016 | Node 1 Output (Turnout) 16 | KT1016 |  |  | 1 | 8000

It is very likely that we will rework and improve the addressing soon.

## JMRI Maple Systems Tools

- Maple network traffic can be viewed with Maple Monitor
- The Maple List Tool lets you assign Maple Inputs and Outputs
- Nodes can be configured with the Configure Nodes tool

## Documentation

### Third Party info

Maple Systems website