Device Management Specifications for Treon Industrial Node 6

Sep 6, 2023 · 21 minutes to read

Introduction

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

This article covers the Device Management for Treon Industrial Nodes 6 with Treon Aito Release 6.11 for Industrial Node.

Operation Modes

The sensor of the Treon Industrial Node 6 measures vibration by sampling data using specified sampling frequency. How a measurement is triggered depends on the operation mode.

Timed Mode
The Treon Industrial Node 6 makes measurements with intervals specified by the MeasInterval value in the Measurement Control object.

On-Demand Mode
The Treon Industrial Node 6 makes a measurement when requested by by the On-Demand command.

Movement Mode
The Treon Industrial Node 6 makes a measurement when the acceleration sensor detects movement exceeding a set threshold.

Node Configuration

The settings of the Treon Industrial Node 6 are defined in three different groups.

Timed settings
(Measurement control object)
Timed settings are related to how often actions are carried out and how much time passes between actions.

Measurement settings
(Accelerometer control object )
Measurement settings are related to the accelerometer settings and define what calculations are performed with the raw data.

Calculation settings
The calculation settings are related to calculation parameters and what values are calculated.

How to use the interface

The resource ID holds the information of the resource you are accessing and the MeasSet / CalculationID identification.

Value holds the value to be sent to the resource. The Value length is defined in all resources and defines the amount of bytes to send. (As an example ‘5’, ‘005’ and ‘000005’ are all different values for this purpose.)

Example:
In case the value needs to be set to ‘2’, the value length defines what base64 to use.

Sending multiple resources simultaneously

It is possible to send multiple resource set/get requests simultaneously with one command. All resources must be from the same object. In case of measurement settings, all the resources need to be from the sameMeasSet and in case of calculation settings all the resources need to be from the same CalculationID.

In order to send multiple resources simultaneously, these multiple resources and values need to all be contained in the sent JSON DM message. The values index in the “Val” array needs to match its resources id in the “Res” array.

Example:
Set the measSet3 G-range to 8G, then select all axis and select Calculation ID 0:

{"Ver": "2", "Cmd": "set", "T" : [33506, 2],   
"Res":[833, 4145, 6194 ], "Val", ["Ag==", "AA==", "AQA=" ],"I":0}

Timed settings

Object id: 33507

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

Set factory defaults

This command can be used only with the SET dm command. Resetting the Treon Industrial Node 6 configuration to factory defaults will change all timed settings, measurement settings and calculation settings to the factory defaults.

The value parameter is reserved for future use. For the factory default reset to be effective, set it to value 0x0000.

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 6’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 Treon Industrial Node 6’s software image is used.

On Demand Measurement

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

Value: byte selecting the measure to be executed

Range: 8-bit unsigned integer containing bitmask

Set Measure

The SetMeasure resource selects the enabled measurements types. This resource turns the measurement types on, but the needed settings for the measurement types selected need to be defined separately.

Range: 16-bit unsigned integer containing bitmask

Examples:
Set timed1 measurement. SetMeasure bitmask:
(MSB) 0000 0000 0000 0001 (LSB) -> 0x0001 -> ‘AQA=’

Enable timed3 and timed1 measurements: (MSB) 0000 0000 0001 0001 (LSB) -> 0x0011 -> ‘EQA=’

Select Measurements

This feature selects the enabled measurements for for the Timed mode vibration measurements. It is possible to select one to eight measurements to be executed.

Range: 8-bit unsigned integer containing bitmask

Examples:
To select MeasSet0 bitmask:
(MSB) 0000 0001 (LSB) -> 0x01 -> ‘AQ==’

To select MeasSet0, MeasSet3 and MeasSet5:
(MSB) 0010 1001 (LSB) -> 0x29 -> ‘KQ==’

Measurement setting

Object id: 33506

The Treon Industrial Node 6 uses object instance number 2. The target definition for the measurement setting is "T":[33506,2]

G-range

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

The range is given as 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.

Data Axis selection

This resource selects the axis for with the accelerometer is making a measurement.

Axis selection is given as enumeration value:

Data Sample Count

With the data sample count the reported and used data sample amount (32-bit) is selected. The Treon Industrial Node 6 truncates the value in case the value is bigger than the raw data sample count.

This is needed for example when several measurements are needed to detect

Single Axis mode: 0 - 110592 Triaxial mode: Range 0 - 36864

Calculation selection

The calculation selection resource selects the enabled calculations for a measurement. It can select between one and sixteen calculations to be executed for the measured data.

Range: 16-bit unsigned integer containing bit selection

Examples:
Select CalculationID0:
(MSB) 0000 0000 0000 0001 (LSB) -> 0x0001 -> ‘AQA=’

Select CalculationID0, CalculationID3 and CalculationID9:
(MSB) 0000 0010 0000 1001 (LSB) -> 0x0209 -> ‘CQI=’

Calculation setting

Object id: 33506

The Treon Industrial Node 6 uses object instance number 2. The target definition for its calculation settings is "T":[33506,2]

Calculation Feature Setting

Select calculated items for selection.

Note: For versions older than 6.15 bit 25 should be disabled (0).

Example:
To select FFT, RMS and aRMS for all axis:
(MSB)0000 0000 0000 0111 0000 0001 1100 0111 (LSB) -> 0x000701C7 -> ‘xwEHAA==’

Filter Selection

This feature allows to select a filter for a calculation session.

Possible values can be:

• None: No filter is used on the data.
• High pass: Data higher than a certain value is cut off.
• Low pass: Data lower than a certain value is cut off.
• Band pass: Data lower than a certain value and higher than a certain value is cut off.

Which of the following filters are selected defines the frequencies cut off:

Examples:

Filter number 11 is a low pass filter that cuts off frequencies lower than 6666.7 Hz.

Filter number 14 is a high pass filter that cuts off all frequencies exceeding 3000 Hz.

Filter number 5 is a band pass filter that cuts off all frequencies lower than 10 Hz and higher than 740.7 Hz.

Decimation

Note: Decimation is a feature only for Calculated values not Raw Data.

Decimation is a feature that allows that not every data sample data is kept and transmitted. Decimation reduces the amount of data sent by the node. e.g. if the node takes samples with approximately 26667 Hz frequency and you are interested ONLY in some low frequency, then it is enough that you send every second or every fourth value because you will still be able to catch the frequency of interest

Decimation by the given factor of n means keeping only every nth sample of the data.

Example: The Industrial Node 6 is set to take samples with approximately 26667 Hz frequency and you are interested ONLY in some low frequency, then it is enough that you send every second or every fourth value because you will still be able to catch the frequency of interest

Value range: 1 - 10

FFT Average

The FFT Average defines the maximum amount of the FFTs (Fast Fourier Transform) to be used for calculating the average. It might be smaller if there are not enough samples for an average.

Range: 1 - 16

FFT Overlap

The FFT Overlap defines the amount of FFT (Fast Fourier Transform) overlap with 1 % resolution.

The sample amount has to be big enough for the selected FFT Overlap. For example, for one selected FFT Overlap, two blocks of at least 4096 samples each are needed.

Example: With an FFT Overlap of ‘4’, at least 4 blocks of 4096 data samples are needed. For an overlap of 50 %, the first FFT block will be calculated from sample 1 to 4096. The second FFT block starts in the middle of the first sample block at sample 2049 and reaches until the middle of the third sample block to sample 6144, and so on.

Value range: 1 - 100

FFT Number of lines

The FFT Number of Lines determines how many individual amplitude values will be taken in the final FFT plot. The frequency resolution of the vibration spectrum is equal to the Fmax divided by the number of lines.

Value range: 1 - 1600

FFT Data Format

The FFT data format defines the data format used by the Industrial Node 6.

The format is given as an enumeration value:

Please note: The Industrial Node 6 does not support complete Delta encoded data format yet. The device will choose the ideal format to minimize data. This can but does not necessarily have to be Delta encoding.

Wake-Up Setting

Object ID: 33506

The Wake-up function of the Industrial Node 6 uses object instance number 3. The target definition for the wake-up settings is "T":[33506,3]

Wake-Up G-Range

The Wake-up G-range sets the G-range for the accelerometer wake-up settings.

The Industrial Node 6 has two built-in accelerometers. One is used for the actual data measurement, the second one is used for the measurements for the Wake-up event.

The range is given as enumeration value:

Wake-Up Maximum ODR Value

This resource sets the maximum value for the wake-up accelerometer ODR (Output Data Rate = sampling rate). The real values depend on the device specification.

Please note: The ODR value (sampling rate) will affect the battery lifetime of your Industrial Node 6. The setting should remain on a low value as a high sampling rate will drain the built-in battery of the device quickly. The ideal setting is at a sampling rate of ‘12.5’ which gives an effective 13 Hz measurement rate.

The value is given in Hz.

Wake-Up Threshold

This resource sets the threshold for the Wake-up event that is specified in the WakeUpAction resource.

Value range: 0 - 64

This value is used to calculate the threshold with this formula:
ThresholdValue = (GRange * Threshold ) / 64G

The unit of the ThresholdValue is ‘g’. The GRange is the value of the G-range as defined for Movement mode.

Examples:

1. When the G-range is set to 2G, the threshold value 2 means 62,5 milli-g.
   Calculation: (2 * 2) / 64)= 0,0625 g = 62,5 milli-g

2. When the G-range is set to 8G, the threshold value 2 means 250 milli-g.
   Calculation: (8 * 2) / 64)= 0,250 g = 250 milli-g

Wake-Up Action Timing

This resource sets the ActionDelay and the BlankTime values for the Wake-up event.

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.

The ActionDelay value is a 16-bit unsigned integers: 0 - 65535 (s)
The BlankTime value is a 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=='

MovementAction

The resource defines what happens when movement exceeding the threshold is detected.

Value: 8-bit unsigned integer, bitmap:

Please note: for the ActIndication parameter to function, ActMeasurement needs to be enabled as well.

Movement Measurements

The Movement Measurements resource selects the enabled measurements to be triggered after the Wake-up threshold has been exceeded.

It is possible to define 1 to 8 measurements to be executed when the movement threshold has been exceeded.

Range: 8-bit unsigned integer containing bitmask

Changing the specifications of the Treon Industrial Node 6 can change the functionality and battery lifetime of this 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!