Hardware Support: Digitrax "Meters"

Introduction to JMRI Volt and Current Meters with Digitrax Hardware
Hardware which supports Digitrax "Meters"
Limitations

Introduction to JMRI Volt and Current Meters with Digitrax Hardware

Under certain configurations, JMRI provides a "Voltage/Current Meter" tool under the "Tools" menu item. This tool may be used to display information reported by certain Digitrax hardware.

The Voltage/Current Meter tool can report voltage or current data from any LocoNet device which reports voltage and current information using special Loconet messages. In order to help differentiate the possible sources, each source's data is identified by a name which includes the device type and the device serial number. Each is individually selectable in the Voltage/Current Meter tool.

It is helpful to re-configure the Voltage/Current Meter tool's "Settings" for displaying "2 integer digits" and "1 decimal digit". This matches the tool's display to the precision of the data reported on LocoNet.

Note that the current reported by modern Digitrax boosters and command stations tends to be the "power input" current, not the "DCC Track Current". See Limitations, below.

Hardware which supports Digitrax "Meters"

The JMRI's LocoNet functionality supports the voltage and current reporting from the following Digitrax devices:

Device		Typical "name" of voltage meter	Typical "name" of current meter
DCS210	TVDCS210(s/n130)Voltage	TVDCS210(s/n130)InputCurrent
DCS240	TVDCS240(s/n4567)Voltage	TVDCS240(s/n4567)InputCurrent
DCS52	TVDCS52(s/n100)Voltage	TVDCS52(s/n100)InputCurrent
DCS210+ *	TVDCS210+(s/n93)Voltage	TVDCS210+(s/n93)InputCurrent
DB210 **	TVDB210(s/n435)Voltage	TVDB210(s/n435)InputCurrent
DB220 **	TVDB220(s/n2117)Voltage	TVDB220(s/n2117)InputCurrent
DB210Opto **	TVDB210Opto(s/n435)Voltage	TVDB210Opto(s/n435)InputCurrent
* At least some DCS210+ devices report inconsistent data.
** It is suspected that these devices report voltage and current data that is compatible with this tool, but this has not yet been confirmed.

Other Digitrax devices which include the appropriate capabilities are automatically supported. However, where a specific device type is not understood by JMRI, the associated voltage meter and current meter data will be available, via names which include a device number instead of a device name.

Limitations

The LocoNet implementation which supports reporting of voltage and current has the following limitations:

The JMRI implementation of voltage and current measurement capabilities applies to those devices which support "Query Mode" reporting of voltage and current mesurements.
At least some versions of DCS210+ command stations seem to have problems in reporting reliable data.
Proper reporting of voltage and current measurements may only be available with certain firmware versions. Be sure to update your LocoNet device firmware to help ensure proper measurement reporting.
When displaying LocoNet-reported Voltage and/or Current values, the tools will generally receive new data about every 30 seconds.
While the tool linked in the "Tools" menu calls one tool "Track Current", the LocoNet implementation does not report DCC track current exactly. Instead, the LocoNet implementation reports the "input power's current consumption". This will generally be the DCC track current plus some "overhead" current which is consumed by the command station circuitry.
The LocoNet implementation relies upon the information reported by the "Query Mode" reporting of "Vtrk" (for the data used by the "Track Voltage" tool) and "Query Mode" reporting of "Iin" (for the data used by the "Track Current" tool).

LocoNet® is a registered trademark of Digitrax, Inc.

Thanks and congratulations to all who contributed! Contact us via the JMRI users Groups.io group.

Copyright © 1997 - 2022 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.

View the