Skip to main content
The node manager comprises a Node Table, along with node configuration abilities.
Apart from being a setup tool, this table is used by JMRI to locate DC / DCC Command stations, enabling features for the command stations which support them.
You can open multiple manager windows, these will all use the same node database.
The top half of the screen displays a Node table, while the bottom half displays details about the selected node.
Nodes will be added to the table when a node admin operation OPC is heard for the node number.
Nodes ( and command stations ) will also be added following a node or command station search.
There is one row in the table for each node number.
The manager will query any node added to the table for its properties.
If enabled, this will trigger the background fetch of the full node configuration.
When a node is selected in the table, any background fetching will be prioritised to that node.
Pre-fetching enables quick node editing, and may be the basis for any future node backup integration.
Node data bytes are calculated as the sum of :
You can click into the Node Name cell to edit the node name.
You can remove a node from the table via the Node Setup tab.
Import Node Names from FCU File ( node names not currently maintained between sessions )
Restore Node From FCU File - see Restore from FCU
You can select Options > Search for Nodes and Command Stations whereby the
manager will request each node on the CBUS network to report back.
Each node which reports itself is sent a message to take it out of any existing learn event mode.
A message identifying nodes in setup mode, ie requesting a node number will also be sent to the network.
The background fetch attempts to use low traffic periods on the CBUS network to
refresh Node details.
If Fast is selected, the system will check every 20ms for any traffic on the CBUS network.
If no traffic is observed, and there is no current data fetch, a data request to the node will be made.
If slow is selected, this is reduced to every 50ms.
Options are saved between sessions on a per-profile basis.
Additional node information including, if available
This is a tool for Node Variable and Node Event editing.
Other tools may be more appropriate for full node configuration.
JMRI does not save node configuration changes, this is all saved on the node.
It is sensible to make regular backups of your node configurations using appropriate software.
Do not blindly change NVs to see what happens! Use in conjunction with the individual module documentation.
These are displayed in a table form.
Table columns include the NV number, along with the NV value in decimal, hex and binary forms.
Click edit to edit the NVs, the edit screen will open in a new window.
The generic node variable tab displays the raw node variable values for any CBUS node.
Columns on the left are the current values, columns on the right show proposed.
If the values have been changed, the row is highlighted yellow.
To write the new NV's, the save button is enabled when a variable has been changed.
Click on this button for a confirmation before writing, after which the window will close.
The Edit tab presents a more user friendly view of Node Variables for those nodes that are supported. Physical quantities such as delays and currents will be scaled to display the physical value, rather that the raw node variable value shown in the generic tab. Hover over individual objects for tool tips or refer to the node documentation for full details.
Changes in the edit tab will be reflected in the generic tab, and vice-versa.
You can create new node events by dragging an event from the CBUS event table to the Node Manager window.
If the event is new to the node it will open in a new event window.
If the event is already on the node, it will open in an edit event window.
Click on the Edit button in the event list, or the new event button to bring up the edit event window.
The event and node combination are set at the top of the list
The node and event names are looked up from the CBUS Event Table when the spinners are changed.
The action buttons will be enabled or disabled depending on how the event number has changed.
Do not blindly change Event Variables to see what happens! Use in conjunction with the individual node documentation.
Any existing values are shown on the left of the table, proposed values on the right.
Zero values are not displayed for binary columns to help identify populated values.
Use the spinners or enter a value in the cell to edit the value.
Any changed variables will have their rows highlighted yellow.
The number of variables per event will depend on the node specific event settings and firmware.
Click on edit or new event to save this to the node.
Copying an event will also copy the event variables into a new event ready for editing.
If deleting an event from the node you will be asked to confirm this.
The edit event window will remain open after teach or edit event operations.
At present, only the generic tab is available. Templates may be available in due course.
The node setup tab contains some lesser used node setup functionality.
The node JMRI user name is used to refer to the node in the CBUS Console and other CBUS applications.
CAN Self-enumeration sends an enumeration request to the node, which should then sort itself out with a good CAN ID.
The CAN can also be set manually by clicking on the force set button.
A popup dialogue will ask for the new CAN ID, min 1, max 99.
Clear All Events from Node button
Remove from table button
Node Number : Each individual module in FLIM operation has a node number.
A node number is requested by the holding down the FLiM button on a node.
JMRI can listen for modules requesting a node number.
This is enabled by default, though can be disabled in the Node Manager options menu.
On hearing a node number request, an allocation popup window will be displayed.
Using the number spinner or keyboard, enter the numerical Node number you would like for the node.
It is suggested that you allocate node numbers above 256, the maximum non-reserved number is 65,533
If a reserved OpCode is used, the background will turn yellow with explanation.
If an existing node number being used is selected, the background will turn red.
Open the restore window via the Node Manager File Menu > Restore Node from FCU xml
Select an FCU xml file from the button at top of the screen.
Nodes within the file will appear in the top table.
There are tabs for viewing the information on the selected node, node variables and node events in the centre of the window.
If the JMRI CBUS Event Table is running, the button to import event names will be
An event name will be added to an existing event table entry if it has no event name.
Node names are imported to the main node table, updating the node name if unset.
If a node number is not present in the table, a new row will be created enabling the node name to be used within other JMRI CBUS applications.
Restore options are towards the bottom of the screen.
Nodes from the main Node Table are listed toward the bottom left of the restore screen.
Both NV and event transfer can be independently selected.
There is also an option to clear any existing events on the node.
When a matching FCU node and a node table node have both been selected, the Update Node button will become active.
The donor node and the target node require the same amount of NVs or Event Variables.
Once clicked, there's a confirmation popup confirming the options which are set.
Click OK, the busy icon will appear and the write process will commence.
Any unchanged values will NOT be written to the node.
As with other operations, the node being taught will update in real time via the main node table.
On teach completion, the busy icon will dissapear and a teach failure popup will display should any issues be detected.
All nodes are referred to by both Manufacturer and Node Type.
It cannot be guaranteed that another program within the JMRI suite will not send any normal operational OPC to a module which is in learn mode.
You can view this help page within JMRI by selecting Help > Window Help in the top bar of the CBUS Node Manager window.
The methods to teach nodes are accessible via Jython script, and include single commands which take care of all of the loops.
CBUS® is a registered trade mark of Dr Michael Bolton
Copyright © 1997 - 2023 JMRI Community. JMRI®, DecoderPro®, PanelPro™, DispatcherPro™, OperationsPro™, SignalPro™, SoundPro™, TrainPro™, Logix™, LogixNG™ and associated logos are our trademarks. Additional information on copyright, trademarks and licenses is linked here.