JMRI: MERGCBUS Event Capture Tool

Event Capture Tool screenshot

The MERGCBUS Event Capture tool can simplify configuring JMRI to work well with your CBUS installation.

To configure JMRI Sensors and Turnouts, you need to identify the associated MERGCBUS events. There are several ways to do this.

The rest of this page goes through the alternatives, using configuring a Sensor as an example. Similar methods work for Turnouts.

Examine Multiple Events

The upper part of the screen can capture multiple MERGCBUS Events, which you can then use to create Sensors and Turnouts.

When a new MERGCBUS message comes it, it will be captured in the highest line that has the "Capture" box checked. The box will then be unchecked so the captured message is not overwritten by later MERGCBUS messages. If you check a series of boxes, you can capture a series of messages.

Once you've captured the Event you want, you can copy and paste it into the boxes in the lower part of the window. If your computer allows it, you can also just drag and drop the value into the lower field.

Provide the Event ID

You can just type an Event ID in the field next to "Active On", and then press "Create". A Sensor will be created that goes Active when the Event is seen, and Inactive when the opposite Event (ON vs OFF) is seen.

If you want to associate Active and Inactive with completely separate Events, you can enter the Event IDs in the two fields and click "Create".

Capture the Next Event

If you can make the layout emit the desired Event, for example by pressing a fascia switch or throwing a turnout, you can capture that Event and use it.

If you press the "Capture Next" button next to one of the Event fields, it will stay down (activated) until the next MERGCBUS Event (CAN frame) is seen by the program. That Event is captured into the neighboring field for later use.

You can separately capture the two Events for a Sensor if desired.


Once you've created a MERGCBUS Sensor or Turnout, you can use the Sensor Table or Turnout Table to adjust the details.

The MERGCBUS Console can help you figure out what events are happening on your layout.

You can view this help page within JMRI by selecting Help > Window Help in the top bar of the MERGCBUS Event Capture window.

Main JMRI MERGCBUS Support page.