Caution! Article for developersInformation on this page is intended particularly for users with advanced technical knowledge.
Update your Treon Gateway via DM Commands
Mar 1, 2023 · 3 minutes to read
This article describes how to update your Treon Aito Release for Gateway via DM commands.
Please Note: In case you have a custom Treon Aito Release for Gateway configuration, or you are not sure which Treon Aito Release for Gateway version to install, please contact Treon Customer Support.
For a full guide on working with DM Commands on the Treon Gateway, please read this article.
Treon Gateway Firmware Update
The update is performed by setting an update URI which will initiate the download. After the download has completed, the actual update can be performed. The Treon Gateway has a so called A/B partition update, meaning that during the last part of the update the gateway will reboot and is not able to respond.
Supported access protocols are http and https. Treon hosts images at https server which does mutual authentication using device and server certificates.
Result of the update should be checked finally by reading FW image version (Object: 3, Resource : 3)
Firmware Update Object (ID:5)
The Treon Gateway firmware can be updated by using this object.
|Package URI||1||string||Set||Firmware package download URI|
|Update||2||string||Execute||Updates the downloaded software|
|State||3||string||Get||Firmware update status|
|Update result||5||string||Get||Firmware update status|
|0||Idle (before downloading or after successful update)|
|0||Initial value. Once the updating process is initiated (download/update)|
|1||Firmware updated successfully|
|2||Not enough memory for the new firmware package|
|3||Out of RAM during downloading process|
|4||Connection lost during downloading process|
|5||Integrity check failure for new downloaded package|
|6||Unsupported package type|
|8||Firmware update failed|
These are additional error codes returned with the
E:[<Error code>] field.
|16||CMD_FAILED||Package download failed or exec update failed|
|17||CMD_FAILED_UPDATE_ACTIVE||Trying to set uri while updating|
|18||CMD_FAILED_SSL_ERROR||Verification of SSL-certificates failed|
|20||CMD_FAILED_INCORRECT_STATE||State is incorrect to perform given operation|
Software Management Object (ID:9)
This object is used to manage single software packages in the Treon Gateway.
|Package URI||3||string||Set||URI for fetching FW image|
|Install||4||N/A||Execute||Start installation of downloaded FW image|
|Update state||7||uint16||Get||FW update status|
Firmware Update Status:
|0||Initial state, before downloading|
|1||The downloading process has started and is on-going|
|2||The package has been completely downloaded|
|3||The package has been correctly downloaded and is ready to be installed|
If executing the Install Resource failed, the state remains at 3.
If executing the Install Resource was successful, the state changes from 3 to 4.
Treon Customer Support
If you have further questions, please contact Treon Customer Support.