The commands in this section facilitate over-the-air (OTA) client of the application operating on the Module. These commands have been implemented per the ZigBee HA 1.2 guidelines.
OTA Query Configuration Request Command - ( PH:0x0B, SH:0x20 )
The OTA Query Configuration Request frame is sent from the Host to the Module to request the intervals at which the Module queries the OTA server for data. The Module will respond with an OTA Query Configuration Response frame. The command has no payload.
Allowed Context | Sent By Host/Module |
---|---|
All Contexts | Host |
OTA Query Configuration Response Command - ( PH:0x0B, SH:0x21 )
The OTA Query Configuration Response frame is sent from the Module to the Host in response to an OTA Query Configuration Request.
Payload for OTA Query Configuration Response Command
Byte Index | Field Name | Notes |
---|---|---|
0,1 | Discovery Retry Rate | The rate, in minutes, at which the Module performs discovery for an OTA server when it has knowledge of none. Default = 15 minutes |
2..5 | First Image Query Delay | The delay, in milliseconds, after discovery of an OTA server and prior to the first Next Image Request (i.e., querying the server to determine if a new image is available). Default = 1 minute. |
6..9 | Image Query Rate | The delay, in milliseconds, between consecutive Next Image Request queries (i.e., querying the server to determine if a new image is available). Default = 15 minutes. |
10..13 | Block Request Rate | The delay, in milliseconds, between Image Block Requests (i.e., the rate at which a new image will be retrieved from the server). Default = 1 millisecond. |
Allowed Context | Sent By Host/Module |
---|---|
All Contexts | Module |
OTA Query Configuration Write Command - ( PH:0x0B, SH:0x22 )
The OTA Query Configuration Write frame is sent from the Host to the Module to set the various intervals at which the Module queries the OTA server for data. These settings may not be modified during an OTA upgrade and will persist in non-volatile memory.
Payload for OTA Query Configuration Write Command
Byte Index | Field Name | Notes |
---|---|---|
0,1 | Discovery Retry Rate | The rate, in minutes, at which the Module performs discovery for an OTA server when it has knowledge of none. Set to 0xFFFF to retain default (15 minutes). |
2..5 | First Image Query Delay | The delay, in milliseconds, after discovery of an OTA server and prior to the first Next Image Request (i.e. querying the server to determine if a new image is available). Set to 0xFFFFFFFF to retain default (1 minute). |
6..9 | Image Query Rate | The delay, in milliseconds, between consecutive Next Image Request queries (i.e. querying the server to determine if a new image is available). Set to 0xFFFFFFFF to retain default (15 minutes). |
10..13 | Block Request Rate | The delay, in milliseconds, between Image Block Requests (i.e. the rate at which a new image will be retrieved from the server). Set to 0xFFFFFFFF to retain default (1 millisecond). |
Allowed Context | Sent By Host/Module |
---|---|
All Contexts | Host |
Image Progress Notification Command - ( PH:0x0B, SH:0x23 )
The Image Progress Notification frame is sent from the Module to the Host to notify the Host of the reception of every 512 bytes of firmware downloaded through the OTA Bootload cluster. The frame is also sent on completion of the download.
Payload for Image Progress Notification Command
Byte Index | Field Name | Notes |
---|---|---|
0 | Status | Maps to ZCL Status codes: 0x00 = Success See /wiki/spaces/SPRHA17/pages/37093554 for all ZCL Status values. |
1,2 | Manufacturer Code | |
3,4 | Image Type | Unused - for backwards compatibility. Set to 0x0000 |
5..8 | File Version | Will contain the value initially set in the Query Next Image Response / OTA Query Next Image Response frames by the Host. |
9..12 | File Offset | |
13..16 | File Size |
Allowed Context | Sent By Host/Module |
---|---|
All Contexts | Module |
OTA Version Configuration Request Command - ( PH:0x0B, SH:0x24 )
The OTA Version Configuration Request frame is sent from the Host to the Module to query the version and image type information used to verify a new OTA image. The Module will respond with an OTA Version Configuration Response frame. The command has no payload.
Allowed Context | Sent By Host/Module |
---|---|
All Contexts | Host |
OTA Version Configuration Response Command - ( PH:0x0B, SH:0x25 )
The OTA Version Configuration Response frame is sent from the Module to the Host in response to an OTA Version Configuration Request.
Payload for OTA Version Configuration Response Command
Byte Index | Field Name | Notes |
---|---|---|
0,1 | Image Type | Unused - for backwards compatibility. Set to 0x0000 |
2..5 | Firmware Version | Default value corresponds to that of the Application Version attribute of the Basic cluster. |
6,7 | Hardware Version | 0x00 = Reserved |
8..15 | Signer EUI | Default 0x0024460000078074 |
Allowed Context | Sent By Host/Module |
---|---|
All Contexts | Module |
OTA Version Configuration Write Command - ( PH:0x0B, SH:0x26 )
The OTA Version Configuration Write frame is sent from the Host to the Module to configure the version and image type information used to verify an OTA image.
Payload for OTA Version Configuration Write Command
Byte Index | Field Name | Notes |
---|---|---|
0,1 | Image Type | Unused - for backwards compatibility. Set to 0x0000 |
2..5 | Firmware Version | Set to 0xFFFFFFFF to retain default. |
6,7 | Hardware Version | Set to 0xFFFF to retain default (EM357) 0x00 = Reserved |
8..15 | Signer EUI | Set to 0xFFFFFFFF to retain default (0x0024460000078074). |
Allowed Context | Sent By Host/Module |
---|---|
All Contexts | Host |