JMRI® connects to...
OpenLCB
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: OpenLCB - Naming

This page discusses how JMRI uses System Names to access OpenLCB-attached resources.

JMRI's Use of Names

JMRI provides an interface to the real layout via internal objects such as Turnouts, Sensors, etc. that are closely mapped to corresponding physical devices. This mapping is done via "System Names", which both identify how to access a particular device, and are the key to looking up the corresponding object in JMRI.

OpenLCB Events

OpenLCB communicates events via messages with a fixed format: eight bytes of content. We convert this to a 16 hexadecimal digit code with a leading "x" character, e.g. "x1234567890ABCDEF". We recommend you use upper case for the A-F letters. You can also enter it with periods separating the bytes: "12.34.56.78.90.AB.CD.EF". In this case only, one leading zero per byte can be omitted when typing the event; JMRI will insert them automatically in names. For example, "00.01.02.03.04.05.06.07" can be typed as "0.1.2.3.4.5.6.7".

JMRI also allows you to associate your own names with LCC events. These can then be used instead of the numeric Event IDs where you enter information. For example, instead of typing "02.01.00.44.00.00.01.A2", you could enter "Select Yard Track 5". You associate these names and event ID numbers in the Event Table. Locate a particular event number in the Event Table, type a name for it in the "Event Name" (2nd) column, and hit return. That's persistant across runs; you don't have to explicitly store it.

Places where names appear:

OpenLCB Signal Masts

See the OpenLCB Signal Mast page for more information on OpenLCB Signal Mast names.

Back to the main OpenLCB Help page