Modbus digital input and output points
- Last UpdatedApr 22, 2025
- 1 minute read
Modbus digital point syntax
Telem_Server_<ScopeName>:%<OutstationFullName>;<PointType>;<PointAddress>;<BitOffset>;<BitCount>{;[<PointName>]}
-
PointType: DI or DO
-
PointAddress: a 5 or 6 digit decimal number, depending on the Point Address Range setting of the outstation, which is set through the Telemetry Server dashboard. The default setting is 5 digits. The range of valid addresses vary by point type and maps to the "Address" field in the Telemetry Server dashboard.
-
BitOffset: a decimal number between 0 and 15. This number maps to the "BitOffset" field in the Telemetry Server dashboard. The maximum offset varies and depends on the bit count.
-
BitCount: a decimal number between 1 and 3. This number maps to the "BitCount" field in the Telemetry Server dashboard.
-
PointName (optional): a descriptive name for the point, for example, LiftStationPump_01. If specified, the PointName must be enclosed in brackets. If point name is not specified, the point is assigned a default name that uses point type and point address, in the format PointType_PointAddress, for example, DI_30001.
-
If PointName is not specified, the point is assigned a default name that uses point type and number, in the format PointType_PointAddress, for example, DI_30001.
-
If you want to create the new point in a different group than the Outstation group, include the group name: GroupName.PointName.
-
Digital reference examples
Without optional PointName:
Telem_Server_<ScopeName>:%Group.Modbus_RTU;DI;30001;0;1
References the 1-bit digital input point mapped to the least significant bit of input register 30001, which is given the name DI_30001
With optional PointName:
Telem_Server_<ScopeName>:%Group.Modbus_RTU;DI;30001;0;1;[Tag_Name]
References the 1-bit digital input point mapped to the least significant bit of input register 30001, which is named Tag_Name