(0x0B) Serial Bootload Frames
The commands in this section facilitate serial bootload upgrade of the application operating on the Module. These commands have been implemented per HA 1.2 guidelines.
(PH:0x0B, SH:0x01) - Trigger Bootloader Request Command
Overview
The Trigger Bootloader Request is sent from the Host to the Module. The request payload is empty.
Payload
This command has no payload
Effect on Receipt
The module shall respond with a Status Response of Success and will subsequently reboot the module and initiate the bootloader CLI.
Allowed Context
All contexts
Sent By Host/Module
Host
( PH:0x0B, SH:0x02 ) - Query Next Image Response Command
Overview
The Query Next Image Response frame is sent from the Host to the Module and prompts the Module to prepare its external flash memory to receive a new image.
Payload
Byte Index | Field Name | Notes |
|---|---|---|
0,1 | Node ID | 0xFFFF indicates that the EUI64 is used. |
2..9 | EUI64 Address | |
10 | Endpoint ID | 0xFF indicates a request on all endpoints. |
11 | Status | 8-bit Enumeration: 0x00 = Success |
12,13 | Manufacturer Code | For local bootloading, this field must be 0x109A. |
14,15 | Image Type | Unused - for backwards compatibility. Set to 0x0000 |
16..19 | File Version | Optional. Number used here will be echoed back in all subsequent frames for the transaction. For example, this field can be used by the Host to differentiate multiple concurrent updates, or for any other purpose the Host requires. |
20..23 | Image Size |
Effect on Receipt
Any existing firmware image in flash is erased.
Allowed Context
All contexts.
Sent By Host/Module
Host.
( PH:0x0B, SH:0x03 ) - Image Block Request Command
Overview
The Image Block Request frame is sent from the Module to the Host.
Payload
Byte Index | Field Name | Notes |
|---|---|---|
0,1 | Node ID | 0xFFFF indicates that the EUI64 is used. |
2..9 | EUI64 Address | |
10 | Endpoint ID | 0xFF indicates a request on all endpoints. |
11 | Field Control | Bit 0 – Request node’s IEEE address present |
12,13 | Manufacturer Code | |
14,15 | Image Type | Unused - for backwards compatibility. Set to 0x0000 |
16..19 | File Version | Will contain the value initially set in the Query Next Image Response / OTA Query Next Image Response frames by the Host. |
20..23 | File Offset | |
24 | Maximum Data Size | N <= 128, where N is data size in octets. |
Effect on Receipt
The Module expects to receive an Image Block Response from the Host in return.
Allowed Context
All contexts.
Sent By Host/Module
Module.