Device Management Specifications for Treon Industrial Node

Sep 6, 2023 · 9 minutes to read

Introduction

The Treon Industrial Node measures vibration and temperature of the machine or structure it is attached to. The behaviour of the sensor can be modified by device management commands using Treon JSON DM messages.

This article covers the device management for the Treon Industrial Nodes with Treon Aito Release 1.3.0 for Industrial Node firmware and higher.

Modes

The sensor of the Treon Industrial Node measures vibration by sampling data using a specified sampling frequency. A measurement is triggered at a time depending on the operation mode.

Each mode can have unique parameters called resource IDs. For example, the resource ID for setting the G-range is different for Timed mode and for the On-Demand mode.

The Treon Industrial Node has the following modes:

Timed Mode

In Timed Mode the sensor makes all measurements with a specific interval in between.

The duration of the interval is specified by the MeasInterval-value in the Measurement Control object.

On-Demand Mode

In this mode, a measurement is executed only when specifically requested.

To trigger a measurement, the on-demand command is used. When executed, all parameters for taking the measurement are set the same as in Timed mode. It is possible to modify these parameters with on-demand specific resource IDs.

Please be aware that these modified parameters for the On-Demand mode are reset again whenever the Industrial Node is restarted.

Movement Mode

In the Movement mode the measurement is triggered when the sensor in the Treon Industrial Node detects an acceleration exceeding a set acceleration threshold. The triggered measurement is done using the parameters of Timed Mode.

The sequence of the measurement:

1. The Industrial Node detects movement exceeding the specified G-range and threshold values.

2. A measurement is now executed after a delay defined by the ActionDelay parameter.

3. The Industrial Node transfers the collected measurement data.

4. After the data transfer is completed, the Industrial Node waits for a specific amount of time before starting detection of movement again. It cannot be triggered before. This waiting time is specified by the BlankTime parameter.

Detection phase uses parameters from Timed Mode if not set specifically for this mode. Actual measurement is done using settings for Timed mode.

Example:
The G-range set for Timed Mode is 4G and only raw data is enabled. The G-range set for Movement Mode is 2G. The detection threshold needs to be calculated using the 2G range. After it has been triggered, the measurement of the vibration value is still executed using the 4G range and only raw acceleration data is sent.

Treon Industrial Node Resources & Data Content

Data Formatting

The Val field in JSON DM messages is presented as base64-encoded little-endian values. The contents are specific to the addressed resource.

Example: The value ‘260’ presented as little endian bytes is ‘0x04,0x01’. Encoding these bytes to base64 results in the string ‘BAE=’

With python:

>>> struct.pack('<H',260)
'\x04\x01'
>>> base64.b64encode('\x04\x01')
'BAE='

Accelerometer

Object id: 33506

The Treon Industrial Node uses object instance number 1. The target definition for the Treon Industrial Node acceleration sensor is "T":[33506,1]

Set Feature Bits

The feature bits consist of 16 different 0s and 1s that define parameters in the measurement.

16 bit (2 bytes) bitmask value describing enabled features in the sensor.

If RawDataReporting is enabled, the acceleration data is always sent for all axis.

Please Note: These parameters are valid only for embedded software version 1.4.0 and later.

Example:
The Treon Industrial Node acceleration sensor is supposed to measure only RMS, Velocity and Kurtosis for the X,Y and Z axis:

Conversion from Bitmap to int to base64: (MSB) 000 0 000 111 111 111 000 (LSB)
to 4088 to
'+A8='

Example:
The Treon Industrial Node acceleration sensor is supposed to measure only raw data (raw acceleration values):

Conversion from Bitmap to int to base64:
(MSB) 000 001 000 000 000 000 (LSB) to
4096 to
‘ABA='

G-Range

The GRange resource defines the measuring range for acceleration of the Treon Industrial Node.

The G-range is given as an enumeration value:

If you do not know the G-range to set for your specific measurement usage, it might be good approach to start with a higher range (but lower accuracy) in order to get data to determine the ideal G-range.

WakeUp Threshold

The WakeUp threshold resource sets a threshold value for a starting event. The starting event is specified in the WakeUpAction parameter.

Value range: 0 - 64

A value from 0 to 64 is then used to calculate the WakeUp threshold with the formula:
Movement = (GRange * Threshold )/64 m/s²

Which gives us:
Threshold = (Movement * 64) / GRange

In this formula, GRange is the G-range value set for Movement mode. Movement is the intended acceleration threshold value in g ranging from 1/32G to 16G. Threshold is the result which needs to be set as Wakeup threshold for the Treon Industrial Node.

Example: The Treon Industrial Node should execute an action when a movement with an acceleration of 1G or more is detected. The G-range is set as 2 for Movement mode. You need to calculate the WakeUp threshold.

Movement = 1
GRange = 2

Threshold = (1 * 64) / 2
Threshold = 32

In order to have a WakeUp threshold of 1G, you have to set the threshold parameter to 32.

WakeUp Action Timing

The WakeUpActionTiming resource sets time delays for the ActionDelay and the BlankTime parameters in Movement mode. The ActionDelay defines the time that passes between the when a measurement is triggered by movement exceeding the WakeUp threshold and when the measurement is executed. The BlankTime defines a waiting time after the measurement, during which no new measurement can be triggered for the Industrial Node.

Both values are 16-bit unsigned integers: 0 - 65535 (s)

Example:
ActionDelay = 30s
BlankTime = 150s

Code:

>>>import struct
>>>import base64
>>>base64.b64encode(struct.pack('<H', 30) + struct.pack('<H', 150))
b'HgCWAA=='

Movement Action

The MovementAction resource defines what happens after a movement exceeding the defined WakeUp threshold value is detected.

There are 3 different types of actions that can be triggered.

The ActMeasurement setting starts a measurement when the defined ActionDelay time has passed after a movement measurement has exceeded the defined WakeUp threshold.

The ActIndication setting initiates a data message from the Treon Industrial Node with indication that the WakeUp threshold has been exceeded. (No measurement is taken and no status report sent.)

The ActLed setting triggers no measurement but triggers the led light of the Treon Industrial Node to blink.

Value: 8-bit unsigned integer, bitmap:

Measurement Control

Object id: 33507

The Industrial Node uses object instance number 1. The target definition for the Treon Industrial Node measurement control is "T":[33507,1]

Meas Interval

The MeasInterval resource defines the interval time between vibration measurements when Timed mode is activated.

Range: 0 - 1441 minutes

If the MeasInterval value is set to ‘0’, the default value as set in the Treon Industrial Node’s software image is used.

Status Interval

The StatusInterval resource defines the interval time between status messages. These are messages containing information other than vibration measurements, e.g. temperature.

Range: 0 - 1441 minutes

If the StatusInterval value is set to ‘0’, the default value as set in the Industrial Node’s software image is used.

On Demand Measurement

The OnDemandMeasurement resource triggers an immediate on-demand vibration measurement.

Value: byte
(Any value from 0-255 can be used. The exact value has no effect on the measurement.)

Set Measure

The SetMeasure resource selects the enabled measurements types.

Range: 16-bit unsigned integer containing bitmask

Example:
Set Timed measurement
SetMeasure bitmask:
(MSB) 0 000 000 000 000 000 001 (LSB) -> 1 -> ‘AQA=’

Enable movement detection and timed measurements:
(MSB) 0 000 000 000 000 000 011 (LSB) -> 3 -> ‘CwA=’

Sending multiple resources simultaneously

It is possible to send multiple resource set/get requests simultaneously with one command. All resources sent in one command must be from the same object though.

{"Ver": "2", "Cmd": "set", "T" : [33507, 1],    
"Res":[1026, 2], "Val", ["AQA", "MAA="],"I":0}

To send multiple resources simultaneously you just need to have multiple resources (and values) in the JSON message you send. The values index in the “Val” array needs to match its resources ID in the “Res” array.

Changing the specifications of the Treon Industrial Node can change the functionality and battery lifetime of the Treon product. If you are at any point not sure, please contact Treon Support.

Treon Support

You still have questions? Our dedicated team of experts is happy to help you! Please contact Treon Support directly by e-mail.

Did you know? Treon offers Premium Support and Maintenance Packages for our customers. Get even more out of Treon and boost your sales - inquire now about features and prices!