Caution! Article for developers

Information on this page is intended particularly for users with advanced technical knowledge.

Treon Industrial Node 6 Device Management

Sep 29, 2022 · 20 minutes to read

Treon Industrial Node 6

The Treon Industrial Node 6 measures vibration and temperature on a machine. The behavior of the sensor can be modified by device management commands using Treon JSON DM messages. <!— add link when available —>

This article coves the Device Management for Treon Industrial Nodes 6 with embedded software version 6.11.

 

Operation Modes

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

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

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

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

 

Node Configuration

The settings of the 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.)

Value lengthValue in hex“Val”
10x02Ag==
20x0002AgA=
40x00000002AgAAAA==

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 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 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.

Resource IDValue lengthModeDescription
30742N/AFactory defaults

 

Meas Interval

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

Resource IDValue lengthModeDescription
22Timed1Measuring interval (minutes)
17942Timed2Measuring interval (minutes)
20502Timed3Measuring interval (minutes)

Range: 0 - 1441 minutes

If the MeasInterval value is set to ‘0’, the default value as set in the 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.

Resource IDValue lengthModeDescription
2582N/AStatus reporting interval (minutes)

Range: 0 - 1441 minutes

If the StatusInterval value is set to ‘0’, the default value as set in the 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

ParameterValueDescription
MeasSet71bit (7)Select Vibration measurement Set7
MeasSet61bit (6)Select Vibration measurement Set6
MeasSet51bit (5)Select Vibration measurement Set5
MeasSet41bit (4)Select Vibration measurement Set4
MeasSet31bit (3)Select Vibration measurement Set3
MeasSet21bit (2)Select Vibration measurement Set2
MeasSet11bit (1)Select Vibration measurement Set1
MeasSet01bit (0) LSBSelect Vibration measurement Set0
Resource IDValue lengthModeDescription
7691N/ATrigger measurement

 

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 seperately.

Resource IDValue lengthModeDescription
10262N/ASets measurement types

Range: 16-bit unsigned integer containing bitmask

ParameterValueDescription
unused11 bits (15-5)Reserved for future use
TimedVibration31bit (4)Enable timed3 measurements
TimedVibration21bit (3)Enable timed2 measurements
Internal1bit (2)Reserved
MovementAlert1bit (1)Enable movement detection
TimedVibration11bit (0) LSBEnable timed1 measurements

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.

Resource IDValue lengthModeDescription
23051Timed1Measure selection for timed 1 vibration measurement
25611Timed2Measure selection for timed 2 vibration measurement
28171Timed3Measure selection for timed 3 vibration measurement

Range: 8-bit unsigned integer containing bitmask

ParameterValueDescription
MeasSet71bit (7)Select Vibration measurement Set7
MeasSet61bit (6)Select Vibration measurement Set6
MeasSet51bit (5)Select Vibration measurement Set5
MeasSet41bit (4)Select Vibration measurement Set4
MeasSet31bit (3)Select Vibration measurement Set3
MeasSet21bit (2)Select Vibration measurement Set2
MeasSet11bit (1)Select Vibration measurement Set1
MeasSet01bit (0) LSBSelect Vibration measurement Set0

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 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 Industrial Node 6.

Resource IDMeasSetValue length
76901
78511
80121
81731
83341
84951
86561
88171

The range is given as enumeration value:

Valueresult
02G
14G
28G
316G

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.

Resource IDMeasSetValue length
409701
411311
412921
414531
416141
417751
419361
420971

Axis selection is given as enumeration value:

ValueAxis
0All axis
1X-axis
2Y-axis
3Z-axis

 

Data Sample Count

With the data sample count the reported and used data sample amount (32-bit) is selected. The 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

Resource IDMeasSetValue length
435604
437214
438824
440434
442044
443654
445264
446874

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.

Resource IDMeasSetValue length
614602
616212
617822
619432
621042
622652
624262
625872

Range: 16-bit unsigned integer containing bit selection

ParameterValueDescription
unused1bit (15)Set to 0
Calculation ID 141bit (14)Select Calculation ID 14 in use
Calculation ID 131bit (13)Select Calculation ID 13 in use
Calculation ID 121bit (12)Select Calculation ID 12 in use
Calculation ID 111bit (11)Select Calculation ID 11 in use
Calculation ID 101bit (10)Select Calculation ID 10 in use
Calculation ID 91bit (9)Select Calculation ID 9 in use
Calculation ID 81bit (8)Select Calculation ID 8 in use
Calculation ID 71bit (7)Select Calculation ID 7 in use
Calculation ID 61bit (6)Select Calculation ID 6 in use
Calculation ID 51bit (5)Select Calculation ID 5 in use
Calculation ID 41bit (4)Select Calculation ID 4 in use
Calculation ID 31bit (3)Select Calculation ID 3 in use
Calculation ID 21bit (2)Select Calculation ID 2 in use
Calculation ID 11bit (1)Select Calculation ID 1 in use
Calculation ID 01bit (0) LSBSelect Calculation ID 0 in use

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 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.

Resource IDCalculationIDValue length
404
2014
3624
5234
6844
8454
10064
11674
13284
14894
164104
180114
196124
212134
228144
ParameterValueDescription
unused3 bits (29-31)0 (reserved for future use)
DataRate X1bit (28)%-value of current G range used by maximum reading (raw data) for axel X
DataRate Y1bit (27)%-value of current G range used by maximum reading (raw data) for axel Y
DataRate Z1bit (26)%-value of current G range used by maximum reading (raw data) for axel Z
DecimatedAndFilteredDataReporting1bit (25)Decimated and Filtered Data Reporting data sent for measurement
CrestFactor X1bit (24)Crest factor calcultation for axel X
CrestFactor Y1bit (23)Crest factor calcultation for axel Y
CrestFactor Z1bit (22)Crest factor calcultation for axel Z
Acceleration X1bit (21)Acceleration (Pk-Pk, 0-Pk ) calculation for axis X
Acceleration Y1bit (20)Acceleration (Pk-Pk, 0-Pk ) calculation for axis Y
Acceleration Z1bit (19)Acceleration (Pk-Pk, 0-Pk ) calculation for axis Z
a-RMS X1bit (18)a-RMS calculation for axis X
a-RMS Y1bit (17)a-RMS calculation for axis Y
a-RMS Z1bit (16)a-RMS calculation for axis Z
unused1bit (15)reserved for future, must be set to 0
unused1bit (14)reserved for future, must be set to 0
unused1bit (13)reserved for future, must be set to 0
RawDataReporting1bit (12)Raw Data Reporting data sent for measurement
Kurtosis X1bit (11)Kurtosis calculation for axis X
Kurtosis Y1bit (10)Kurtosis calculation for axis Y
Kurtosis Z1bit (9)Kurtosis calculation for axis Z
v-RMS X1bit (8)RMS calculation for axis X
v-RMS Y1bit (7)RMS calculation for axis Y
v-RMS Z1bit (6)RMS calculation for axis Z
Velocity X1bit (5)Velocity (Pk-Pk, 0-Pk ) calculation for axis X
Velocity Y1bit (4)Velocity (Pk-Pk, 0-Pk ) calculation for axis Y
Velocity Z1bit (3)Velocity (Pk-Pk, 0-Pk ) calculation for axis Z
FFT X1bit (2)FFT calculation for axis X
FFT Y1bit (1)FFT calculation for axis Y
FFT Z1bit (0) LSBFFT calculation for axis Z

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:

ValueFilterCut off freq
0Filter None
1unused
2unused
3unused
4Filter Band Pass2,0 Hz - 1333,5 Hz
5Filter Band Pass10,0 Hz - 740,7 Hz
6Filter Band Pass10,0 Hz - 1333,5 Hz
7Filter Band Pass10,0 Hz - 3333,0 Hz
8Filter Band Pass10,0 Hz - 6666,7 Hz
9Filter High Pass10,0 Hz -
10Filter High Pass2000,0 Hz -
11Filter Low Pass- 6666,7 Hz
12Filter Band Pass10,0 Hz - 1000,0 Hz
13Filter Band Pass2,0 Hz - 1000,0 Hz
14Filter High Pass3000,0 Hz -

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 exceeing 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.

Resource IDCalculationIDValue length
460901
462511
464121
465731
467341
468951
470561
472171
473781
475391
4769101
4785111
4801121
4817131
4833141

 

 

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 enougth samples for an average.

Range: 1 - 16

Resource IDCalculationIDValue length
230501
232111
233721
235331
236941
238551
240161
241771
243381
244991
2465101
2481111
2497121
2513131
2529141

 

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

Resource IDCalculationIDValue length
742501
744111
745721
747331
748941
750551
752161
753771
755381
756991
7585101
7601111
7617121
7633131
7649141

 

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

Resource IDCalculationIDValue length
665802
667412
669022
670632
672242
673852
675462
677072
678682
680292
6818102
6834112
6850122
6866132
6882142

 

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:

ValueResult
0Auto selection between Delta encoded or Raw values multiplied by 100
1Raw values multiplied by 100
(2)(Delta encoded)
3Raw values multiplier from Measurement Details

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.

Resource IDCalculationIDValue length
204901
206511
208121
209731
211341
212951
214561
216171
217781
219391
2209101
2225111
2241121
2257131
2273141
2289151

 

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 measuerements for the Wake-up event.

The range is given as enumeration value:

Valueresult
02G
14G
28G
316G
Resource IDValue length
7691

 

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.

Resource IDValue length
10262

 

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

Resource IDValue length
30731

 

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)

Resource IDValue length
38444

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.

Resource IDValue length
35851

Value: 8-bit unsigned integer, bitmap:

ParameterValueDescription
unused5 bits (7-3)reserved for future
ActMeasurement1bit (2)start measurement after ActionDelay
ActIndication1bit (1)send movement indication (status report, no measurement values)

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.

Resource IDValue lengthDescription
76811Measure selection for movement vibration measurement

Range: 8-bit unsigned integer containing bitmask

ParameterValueDescription
MeasSet71bit (7)Select Vibration measurement Set7
MeasSet61bit (6)Select Vibration measurement Set6
MeasSet51bit (5)Select Vibration measurement Set5
MeasSet41bit (4)Select Vibration measurement Set4
MeasSet31bit (3)Select Vibration measurement Set3
MeasSet21bit (2)Select Vibration measurement Set2
MeasSet11bit (1)Select Vibration measurement Set1
MeasSet01bit (0) LSBSelect Vibration measurement Set0

 

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

 
 


Was this article helpful? Let us know.
Previous