JMRI is...

Common Tools

JMRI provides powerful tools for working with your layout.

System-specific Tools

Layout Automation

JMRI can be used to automate parts of your layout, from simply controlling a crossing gate to running trains in the background.

JMRI: ID Tags Documentation

What are ID Tags?

An ID Tag is JMRI's way of representing information about ID Tags that can be attached to, for example, various items of rolling stock.

When an ID Tag is read by a suitable reader, this is notified via both a Sensor becoming ACTIVE and a Reporter being set to the value of the ID Tag. The ID Tag will also record both by which Reporter it was last seen by, as well as the time it was last seen.

If an unknown ID Tag is detected by a reader, details of this tag will be automatically entered into the ID Tag Table.

At system shutdown, the details of all ID Tags known to the system are written to a file stored in the "idtags" sub-directory of user Preferences. The storage of details when and where a given ID Tag was last seen is configurable by setting the option at the bottom of the ID Tag Table.

Current implementations are for CORE-ID based readers. These are supported in stand-alone mode via the 'Generic Stand-alone' protocol and as an up-to 8-way Concentrator using MERG hardware via the 'MERG Concentrator' protocol.
Note: The MERG starter kit as supplied should be configured using the 'Generic Stand-alone' protocol - only when extending the kit with the additional concentrator components should the 'MERG Concentrator' protocol be used.

How to setup ID Tags

ID Tag Table

The ID Tag Table provides easy access to the contents of all ID Tags that JMRI knows about.

ID Tag Table Controls

Below the table there's an "Add..." button for creating your own ID Tags; JMRI automatically creates ID Tag objects for tags detected on the layout.

Next to it, two check boxes let you activate:

Displaying ID Tags on Panels

An ID Tag can be displayed on a Panel via the use of the Reporter Icon associated with a given reader. To do this:

More information about Reporters can be found in the Reporters help page.

Saving ID Tags to disk

ID Tags are part of your layout configuration, along with your Turnouts, Sensors, Signal Heads, Lights, control panel setup etc. To store this information on disk, allowing to reload it next time you run JMRI, use Store Configuration... in the File menu at the top of the ID Tag Table (or other tables from the Tools menu), or select Store Panel... in the Panel menu. To open them, open the panel containing the ID Tags. The data is stored in a folder named "idtags". Note that the contents of an ID Tag is not saved in the configuration file.