Skip to main content

TIANXINMaster

Purpose

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

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.

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.

Device debug

Enter "Development Configuration → Collection Configuration", select the current device and click "More Functions", then open "Debug".

Dedicated debugging page

Open Development Configuration → Collection Configuration, select the device, and open More Functions → Debug. The following image shows the plugin-specific debug page.

TIANXINMaster debug subpage 1

TIANXINMaster debug subpage 2

Verify the configuration

Use a confirmed on-site address to perform reading. The return value, data type and byte order should be consistent with the point list; after the writable point is written, it should be read back according to on-site requirements.

Troubleshooting

  • Address reading failed: Check the station number, register or node ID one by one according to the address rules on this page, and confirm that the data type is consistent with the device point list.
  • 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.