Collectors and data formats
Modbus TCP Collector
basic settings these settings are used by the collector to successfully connect to the modbus server endpoint description the location of the modbus server required yes example tcp\ //localhost 502 this configures the ip address and port on which the modbus server is listening byteorderdefault description the default modbus byte order to interpret the register bytes and register sequence required yes default ab (cd) (ef gh) options ab (cd) (ef gh) | ba (dc) (fe hg) | (hg fe) (dc) ba | (gh ef) (cd) ab this defines how bytes and registers are ordered when decoding multi register values you can override this per measurement with a custom order (for example, ab cd fe hg ) advanced settings readtimeout description the modbus read timeout in milliseconds required no default 5000 measurement settings the measurement settings reflect the configuration possibilities for mapping a measurement to a modbus address range and function code address description the modbus address to start reading registers from required yes default 0 collectiontype description the way this measurement should be collected from the modbus server required yes default polled options polled | monitored checkout the data collection methods section for more information slaveid description the slave id is a string of two hexadecimal characters referring to the modbus slave to request data from (for example, broadcast is ff ) required yes default ff collectioninterval description the interval in milliseconds at which this measurement should be collected required no default 5000 collectionoffset description the offset in milliseconds, relative to the 0th second of a minute, at which this measurement should be collected only relevant for polled measurements required no default 0 registertype description the modbus register type to read required yes default input register options coil | discrete input | input register | holding register modbusdatatype description the datatype of the modbus registers to read if the register type is discrete input or coil , only boolean is allowed required yes options boolean | uint16 | int16 | uint32 | int32 | float32 | uint64 | int64 | float64 byteorder description the modbus byte order to interpret the register bytes optional and overrides the collector’s byteorderdefault required no default default options default | ab (cd) (ef gh) | ba (dc) (fe hg) | (hg fe) (dc) ba | (gh ef) (cd) ab data collection methods the modbus collector has 2 methods to collect measurement data, which are referred to as the collection type of a measurement polling polled measurements are read every x milliseconds (minimum of 1000 ms), which is the collection interval this data collection method should be used for measurements whose value changes regularly over time configure the interval depending on how frequently you want to collect data points for this measurement monitoring monitored measurements collect data on every change of the measurement’s value this data collection method polls the measurement at the minimum interval and notifies the collector whenever a change occurs typically, monitored measurements are configured for boolean or string data types that indicate an equipment’s state, for example, a valve that opens or closes only a few times per hour collector health error connecting to slave an error occurred while trying to initialize the modbus slave this indicates that a collector setting hasn’t been configured correctly or that the modbus server isn’t reachable during initialization disconnected from slave the modbus client lost connection with the modbus slave