Hardware Support: OpenLCB Signal Masts
JMRI support for OpenLCB is rapidly evolving; the actual code might be ahead or behind
the documentation on any given day.
This page describes JMRI's support for OpenLCB-native Signal Masts. It's part of JMRI's
documentation of its OpenLCB support.
OpenLCB Signal Masts
A technical summary on masts is available as a PDF document.
Names
Valid OpenLCB Signal Mast system names look like:
- MF$olm:basic:one-searchlight($1)
where the parts are
- M - The system connection; these need a specific connection ID to use
- F - Indicates signal mast
- $olm - indicates an OpenLCB mast
- basic - signal system
- one-searchlight - mast type
- $1 - 1st mast (The $ indicates automatically assigned)
Adding and Editing OpenLCB Signal Masts
You add and/or edit OpenLCB Signal Masts via the Signal Mast Table using the usual "Add" and
"Edit" buttons. For adding, select "OpenLCB Event Mast" as the mast driver type. You'll then
get a pane that will let you configure a specific mast:
Starting from the top of the pane, the options are:
- "This Mast can be unlit" - same as for other mast types, this tells the signal logic
that it's OK for this mast to be unlit (set to dark).
- A scrolling set of aspects to configure: For each one, enter the OpenLCB EventID that
sets the mast to this aspect. You can use any of the EventID formats
that JMRI understands such as "x1234567890ABCDEF" or "00.01.02.03.04.05.06.07" or
"0.1.2.3.4.5.6.7". Whatever format you enter will be retained for when you later edit the
mast.
- A box for the EventIDs that tell the mast to be lit or unlit.
- A box for the EventIDs that tell the mast that it's held or not held.
- Cancel and Create or Apply buttons that do what's expected of them.
If you format one of those EventID entries improperly, you'll get a not-particularly specific
error message dialog. (Perhaps somebody will improve this some day)
JMRI Help
Back to the main OpenLCB Help page