JMRI® connects to...
Roco
Supported Hardware
Devices, command stations, networks, and protocols:
Applications
By the community of JMRI.org:
Tools
JMRI tools for working with your layout:
Layout Automation
Use JMRI to automate parts of your layout and operations:

JMRI Help:

Contents Index
Glossary FAQ

Donate to JMRI.org

Hardware Support: Fleischmann/Roco z21/Z21

The Roco z21/Z21 is a command station with support for LocoNet, R-Bus and XPressNet devices and it includes a built in Ethernet port. The Z21 device is also sold under the Fleischmann name.

For connecting to the device via the LocoNet or XPressNet interface, please see the LocoNet and XPressNet connection pages.

This page specifies connecting to the z21/Z21 via the Ethernet port as documented on the Z21 website.

Supported Hardware

Roco has two devices it sells as the White Z21 and the Black Z21. The White Z21 is also sometimes referred to as the z21. Both devices support connections via the Ethernet Port, to R-Bus Devices, and to XPressNet devices. The Black Z21 also supports connections via LocoNet and Zimo's CAN bus.

Limitations

JMRI

JMRI Currently supports the Z21 XPressNet over Ethernet implementation. JMRI also provides support for configuring connection flags and the Z21 RailCom interface.

White Z21

The White z21 does not provide access to the LocoNet interface.

The White z21 does not include a seperate programming track output. It is unclear as to whether or not reading decoder values in service mode is possible.

Black Z21

There are no known limitations of the Black Z21 at this time.

Connecting

Connecting to the Roco z21 or Z21 via the Ethernet connection

Note: The first JMRI release supporting the Lenz LIUSB Ethernet connection was v 3.11.7.

  1. To connect your computer to either the z21 or Z21 via Ethernet port, connect your z21/Z21 to your computer Network using the supplied Ethernet cable.
  2. Once the device is connected, refer to the device documentation for information on setting the IP address. The default IP address is 192.168.0.111. Make note of the IP address for use when configuring the device.
  3. Start one of the JMRI-based programs, Then go to the preferences panel. This opens automatically the first time a program is run, or you can select it from the "Edit" menu.
  4. Select "Roco" from the system manufacturer selection box and "Roco Z21" from the top selection box. There are two configuration options available for the LIUSB-Ethernet.
  5. Enter the IP address you saved earlier into the box labeled "IP Address/Host Name"
  6. Click "Save". You'll be asked if it's OK for the program to quit, click "Yes".
  7. Restart the program.
  8. Open Preferences ⇒ Defaults. Check the default connection and correct it as shown. Click "Save".
  9. Restart the program. You should be up and running.
Z21 Defaults

Connecting to the Roco Z21 Simulator

  1. Start one of the JMRI-based programs, Then go to the preferences panel. This opens automatically the first time a program is run, or you can select it from the "Edit" menu.
  2. Select "Roco" from the system manufacturer selection box and "Z21 Simulator" from the system connection selection box. There are no additional configuration steps required to use the Z21 Simulator.
  3. Click "Save". You'll be asked if it's OK for the program to quit, click "Yes".
  4. Restart the program. You should be up and running.

JMRI z21/Z21 Tools

The following tools are available from the menu when this connection is active:

In addition to the Z21 specific menu, you will also find the Z21XPressNet menu, which contains the same XPressNet tools found on any XPressNet system.

Documentation

JMRI Help

Third Party info

Credits

Thanks to Paul Bender and others for implementing Z21 Support in JMRI.