Update your Treon Industrial Node via Device Management (DM) interface

Sep 18, 2023 · 5 minutes to read

This article describes the process of updating your Treon Industrial Nodes and Industrial Nodes 6 to the latest Treon Aito Release for Industrial Node via Device Management (DM) interface.

DM commands get, set, and execute are used for this procedure. Val-field content is always in base64 encoded format.

Gateway will acknowledge device management commands with a message containing field “S” (Status). If the status is 0, the command is accepted for execution.

Send the DM messages to:
treon/devices/serialGW/devicebound/#

1 Set URI

Use the following URI provided to you by support@treon.fi

Message:

{"Ver": "2", "Cmd": "set","T": [33581, 0],"Res": [1], "Val": ["<Encoded URI>"], "I": 1 }

Expect reply message with “S”:0 indicating success.

{"I":1,"S":0,"Type":"dm","T":[33581,0]}

2 Check update state

Check update state regularly until update state is completed by sending this DM message:

{"Ver": "2", "Cmd": "get","T": [33581, 0],"Res": [3],"I":2 }

Gateway will reply with status:

{"Val":["Ag=="],"I":2,"Res":[3],"S":0,"T":[33581,0],"Type":"dm"}  

Where Val-field includes base64 encoded update state:

• Downloading 1 (“S”:1)
• Downloaded 2 (“S”:2)

Wait for status 2 downloaded. Status 2 indicates that the download is completed, and you can proceed to the next step.

3 Execute update

After the firmware package has been downloaded, the actual update process can be started. Execute command requires a set of parameters, see details below.

Firmware update command is sent:

{"Ver": "2", "Cmd": "execute","T": [33581, 0],"Res": [2], "Val": ["<ENCODED PARAMETER SET>"], "I": 3 }

Example parameter setting for small networks:

• Using value 0 selects the default value.
• All data is presented in little‐endian format.

Example parameter setting for big networks

• Depending on the network size, different parameters should be used.
• For bigger networks, the following parameters are recommend.

Gateway will acknowledge the command with status reply:

{"I":3,"S":0,"Type":"dm","T":[33581,0]}

4 Check update state regularly until update state is completed

The update process may take several hours, depending on used parameters. Meanwhile, you can check the progress by sending this command:

{"Ver": "2", "Cmd": "get","T": [33581, 0],"Res": [3],"I":4 }

Reply:

{"Val":["AwDYn2y0"],"I":4,"Res":[3],"S":0,"T":[33581,0],"Type":"dm"}  

Base64 value: AwDYn2y0 decodes to bytes: 0300d89f6cb4
03 ‐ state (updating)
00 ‐ progress percentage
d89f6cb4 ‐ sensor serial number of nodes that have acknowledged the start message, (bytes are in little-endian format)

Wait for state 0 (Idle). State 0 indicates that the installation is completed, and you can proceed to the next step.

5 Check update result

You can check the result by sending this command:

{"Ver": "2", "Cmd": "get","T": [33581, 0],"Res": [5],"I":5 }

Reply:

{"Val":["AdifbLQ="],"I":5,"Res":[5],"S":0,"T":[33581,0],"Type":"dm"}

Base64 value AdifbLQ= decodes to bytes: 01d89f6cb4
01 ‐ state (firmware upgraded successfully)
d89f6cb4 ‐ sensor serial number (bytes are in little-endian format)

The reply will contain serial numbers of all sensors that successfully updated its firmware. The serial numbers of sensors which were not successfully updated are not included in the reply.

6 Check the firmware version of the updated sensor

Send this command:

{"Ver": "2", "Cmd": "get","T": [3, 0],"Res": [3], "Nid":["BROADCAST"],"I":6 }

Reply:

{"Val":["AQMBbWk2YA=="],"I":6,"Res":[3],"Nid":"b46c9fd8","S":0,"T":[3,0],"Type":"dm"}

Base64 value AQMBbWk2YA== decodes to bytes: 060f0036903962 The first 3 bytes correspond to version number 6.15.0
The last 4 bytes are an encoded date

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!