JMRI is...

General Tools

JMRI provides powerful tools for working with your layout.

LocoNet Tools

A set of Digitrax LocoNet specific tools
  • LocoNet monitor
  • Slot monitor
  • Packet source
  • PM4 programmer
  • BDL16 programmer
  • LocoIO programmer

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: Signal Head Documentation

Signals (or more formally Signal Heads) are how JMRI represents and controls signal heads on a layout. They are a specific kind of output device that can be set to various colors: Red, Yellow, Green, Flashing Yellow, etc.

Much more information about JMRI signaling is available from the JMRI signaling help page.

The Signal Table

Simple Signal Logic panel figure All the signal heads that JMRI knows about can be referenced using the "Signal Head Table" tool in the Tools menu of JMRI programs.

For more information on configuring and operating signals with the Signal Head Table, please see the Signal Head Table help page.

Creating a Signal Head

Simple Signal Logic panel figure

To define a new signal head, click on the Add New Signal Head button in the Signal Table. It will prompt you for the signal head type (controlled by turnout outputs; SE8c; etc), and whatever setup information is needed for your choice. There's more information on the help page on adding signal heads.

Editing an Existing Signal Head

Once a signal head has been defined, you currently can't change it's type directly from the program. This is a requested capability, and someday somebody will probably write it. In the meantime, you can just ignore signal heads that you've defined and don't want to use; they don't hurt anything. Or you can edit your saved configuration files to remove the entire line containing the signal definition; look for the name of the signal to locate the right line. Note that you need to remove the entire line, and not leave any part of it, especially the opening and closing brackets. Save a copy of the file as a backup first!

Controlling a Signal Head

Signal heads can be controlled various ways by JMRI, including
  • Simple Signal Logic, for basic ABS signaling of the North American type
  • Logix, a graphical way of controlling signal heads with simple logic
  • JMRI scripts, using a full programming language to do whatever you'd like

Saving and Reloading Configuration

The signal head information is saved with the configuration in an XML file, along with control panel setup and similar stuff. For more information on creating and displaying panels, including how to show signal heads on your panels, please see the Panels pages.