Skip to Content
On this page

TIANXIN flow instruments

TIANXIN instrument protocol address read and write driver

Open the plugin

Enter “Development Configuration → Collection Configuration”, create a device and select “TIANXINMaster” in “Collection Plugin”.

Supported channels and data types

Channel typePre-configuration check
TCP ClientConfirm network reachability of the device IP, port, and gateway to the device.
TCP serverConfirm that the local listening address and port are available, and allow on-site devices to actively connect to the gateway.
Serial PortConfirm that the serial port is not occupied by other programs and maintains the same baud rate, data bits, stop bits and parity bits as the device.
UDPConfirm the local binding address, port and firewall rules, and check the source of the packet.

Optional data types: Boolean, Byte, Int16, UInt16, Int32, UInt32, Int64, UInt64, Float, Double, String, Decimal

This list describes types allowed by the plugin editor. Address width, arrays, string length and read/write restrictions still follow this page; it does not mean that every address supports every type.

Plugin properties

Protocol parameters

SettingDescription
Default station numberDefault: 1; fill in: text input. Set the default station number used when the station number is not specified separately in the variable address.

Connection configuration

SettingDescription
DTU IDFill in: text input. Sets the identifier used to identify the current device connection through the DTU service.

Address rules

  • TIANXIN address format: [S=station number;] data item, when the station number is not filled in, the default station number configured by the device is used.
  • Data items: Time, FlowRate, TotalAmount, Temp, Pressure, A1_7, A1_6, A1_5, A1_4, A1_3, A1_2, A1_1, A1_0, S_7, S_6, S_5, S_4, S_3, S_2, S_1, S_0.
  • Example: FlowRate;S=1;TotalAmount;S=2;A1_7.

Device debug

Enter “Development Configuration → Collection Configuration”, select the current device then open “Protocol Debug” at the top of the workspace.

TIANXINMaster: Read/Write

TIANXINMaster: Messages

Functions

FunctionPurpose
Read and writeRead a confirmed point and write only to an approved test point.
MessagesView sent and received frames, protocol fields, and error details.

Verify the configuration

Compare with the instantaneous-flow display; use instrument-configured units/scaling. Time uses String separately.

Troubleshooting

  • Distinguish FlowRate, TotalAmount and status selectors. Match station and field before choosing a type; one type does not describe every item.
  • The serial port device does not respond: Confirm that the serial port is not occupied, and check the baud rate, data bits, stop bits and parity bits.