3.2.21. Firmware Update Meta Data Command Class, version 7¶
The Firmware Update Meta Data Command Class may be used to transfer a firmware image to or from a Z-Wave node.
3.2.21.1. Compatibility considerations¶
This version introduces the ability to advertise if subsequent firmware activation is supported or not by a node.
Firmware Update Meta Data Command Class, version 7 is backwards compatible with Firmware Update Meta Data Command Class, version 6.
\requirement{CC:007A.07.00.21.001}{0}
All commands and fields not mentioned in this version MUST remain unchanged from version 6.
3.2.21.2. Firmware Meta Data Report Command¶
This command is used to advertise the status of the current firmware in the device.
7 |
6 |
5 |
4 |
3 |
2 |
1 |
0 |
|---|---|---|---|---|---|---|---|
Command Class = COMMAND_CLASS_FIRMWARE_UPDATE_MD (0x7A) |
|||||||
Command = FIRMWARE_MD_REPORT (0x02) |
|||||||
Manufacturer ID 1 |
|||||||
Manufacturer ID 2 |
|||||||
Firmware 0 ID 1 |
|||||||
Firmware 0 ID 2 |
|||||||
Firmware 0 Checksum 1 |
|||||||
Firmware 0 Checksum 2 |
|||||||
Firmware Upgradable |
|||||||
Number of Firmware Targets |
|||||||
Max Fragment Size 1 |
|||||||
Max Fragment Size 2 |
|||||||
Firmware 1 ID 1 |
|||||||
Firmware 1 ID 2 |
|||||||
… |
|||||||
Firmware N ID 1 |
|||||||
Firmware N ID 2 |
|||||||
Hardware Version |
|||||||
Reserved |
Activation |
CC |
|||||
All fields not described below remain unchanged from version 6.
Activation (1 bits)
This field is used to advertise if the supporting node supports subsequent activation after Firmware Update transfer.
If the sending node supports the subsequent activation of firmware after downloading, this field MUST be set to 1.
If the sending node does not support the subsequent activation of firmware after downloading, this field MUST be set to 0.
3.2.21.3. Firmware Update Meta Data Request Get Command¶
7 |
6 |
5 |
4 |
3 |
2 |
1 |
0 |
|---|---|---|---|---|---|---|---|
Command Class = COMMAND_CLASS_FIRMWARE_UPDATE_MD (0x7A) |
|||||||
Command = FIRMWARE_UPDATE_MD_REQUEST_GET (0x03) |
|||||||
Manufacturer ID 1 |
|||||||
Manufacturer ID 2 |
|||||||
Firmware ID 1 |
|||||||
Firmware ID 2 |
|||||||
Checksum 1 |
|||||||
Checksum 2 |
|||||||
Firmware Target |
|||||||
Fragment Size 1 |
|||||||
Fragment Size 2 |
|||||||
Reserved |
Activation |
||||||
Hardware Version |
|||||||
All fields not described below remain unchanged from version 3.
Activation (1 bit)
The Activation field is used to advertise if the receiving node must delay the actual firmware activation after the file transfer.
A node advertising no support for “activation” in the Firmware Meta Data Report Command MUST ignore this field and activate the Firmware immediately after download.
If the receiving node advertises support for Activation in the Firmware Meta Data Report Command:
The value ’1’ MUST indicate to delay the actual firmware update.
When delaying the firmware activation, the supporting node MUST set the Status code field to 0xFD in the Firmware Update Meta data Status Report Command.
The value ’0’ MUST indicate that the receiving device MUST NOT delay the firmware update and activate the firmware immediately after download.