Command 0Xd801 - Load Firmware File - Magtek DynaFlex II Go Programmer's Manual

6 - Commands

6.6.2 Command 0xD801 - Load Firmware File

The host uses this command to send a firmware image file, signed by MagTek, to the device as the first
step in updating firmware.
The sequence of events is as follows:
1) The host is assumed to have access to a binary file containing a firmware image signed by MagTek.
2) The host composes a command request in the format below, using the binary file as the Payload, and
sends it to the device.
3) The device sends a response to the host in the format below to acknowledge it has received the
request. The device will not allow the Load Firmware File command to execute if the battery charge
is 5 percent or lower.
4) The device validates the request and authenticates the firmware file with the algorithm specified in the
firmware file payload.
5) If the upload was successful, the device sends Notification 0x0905 - Firmware Update Successful to
the host. In this case, the host should continue the firmware update process by sending Command
0xD901 - Commit Firmware from File. If the upload was not successful, the device sends
Notification 0x0906 - Firmware Update Failed to the host. In this case, the host should terminate
the firmware update operation, and take appropriate action based on the response, such as trying again.
Table 6.6-2 - Request Data for Command 0xD801 - Load Firmware File
Tag Len
Beginning of any wrappers, at minimum including Request Message found on page 32
D801 = Command 0xD801 - Load Firmware File
Progress Indicator
81 01
Reserved for future use. Populate with 0x03.
Image Type
•
0x0000 = Boot Loader 1 image
•
85 02 0x0001 = Main App image
•
0x0002 = WiFi Module image
•
0x0003 = BLE Module image
Hash Checksum
86 20
This is a SHA-256 hash of the object being uploaded.
Payload
87 var
This is the binary file or object being loaded into the device.
End of any wrappers, at minimum including Request Message found on page 32
Table 6.6-3 - Response Data for Command 0xD801 - Load Firmware File
Tag Len
Beginning of any wrappers, at minimum including Response Message found on page 33
D801 = Command 0xD801 - Load Firmware File
No parameters.
End of any wrappers, at minimum including Response Message found on page 33
DynaFlex II Go| Secure Card Reader | Programmer's Manual (COMMANDS)
Value / Description
Value / Description
Page 128 of 301 (D998200597-102)
Typ Req Default
B R
B R
B R
B R
Typ Req Default