DFU
dfu.logs_enabled
Abbreviation
df l
Access
get/set
Description
This variable enables/disables verbose DFU log messages.
Notes
- This variable is immune to factory resets.
- If the DFU requires the UART for the updates (e.g. UART wired DFU) then the logs are disabled.
Arguments
0|false|off/1|true|on
Default
0
Platforms
- WGM160P
Gecko OS Plugin
Get example
> get df l
0Set example
> get df l 1
Set OKdfu.status
Abbreviation
df s
Access
get
Description
Returns the device's current DFU status code.
Arguments
None
Default
0
where status code may be one of the following:
| Code | Brief | Description |
|---|---|---|
| 0 | none | No status, default value on power-up |
| 1 | success | DFU successfully completed |
| 2 | first pass success | DFU successfully completed the 'first pass' |
| 3 | up to date | DFU successfully completed, firmware already up-to-date |
| 4 | pending | DFU currently active |
| - errors start - | All codes below here are considered DFU failures. | |
| - recoverable errors start - | For recoverable errors, the device does NOT abort DFU mode | |
| 11 | dms connection error | Error while issuing DMS HTTP request |
| 12 | dms read timeout error | Timed-out while receiving DMS HTTP response |
| 13 | network not found | The configured network was not found |
| 14 | network join failed | Failed to connect to network |
| 15 | max request attempts | Max attempts at issuing OTA DFU requests to DMS exceeded |
| 16 | xmodem init timeout | Max attempts at initializing Xmodem interface exceeded |
| 17 | xmodem read timeout | Timeout out while trying to receive Xmodem packet |
| 18 | xmodem max retries | Max attempts at retransmitting an Xmodem packet exceeded |
| - recoverable errors end - | For errors below, DFU mode is aborted | |
| 100 | kernel error | Unknown Kernel error occurred |
| 101 | max faults | |
| 102 | application file invalid | The application file on internal flash is invalid |
| 103 | dms product auth key sig invalid | The product auth key was improperly signed by the current platform auth key |
| 105 | application signature invalid | The application's signature on bootload is not valid against the product auth key |
| 106 | invalid command | |
| 107 | network ssid not set | No network SSID is set |
| 108 | network passkey not set | No network password is set |
| 109 | network security not supported | The configured network security is not supported |
| 110 | max update attempts | Max Kernel attempts of updating firmware exceeded |
| 111 | no device certificate | No device DMS certificate was found in the device's internal memory |
| 116 | devcreds finalize failed | Failed to finalize the device credentials update on internal memory |
| 117 | dms no authorization | The device does not have access to the firmware on the DMS |
| 118 | application signature check failed | Application signature in internal memory is not valid during DFU |
| 119 | dfu counter exceeded | The DFU NVM counter has been exceeded. Serial DFUs are now prohibited |
| 120 | devcreds corrupt | Device credential memory corrupted |
| 121 | second stage bootloader error | Unknown error in SSB (Second Stage Bootloader) |
| 122 | extended flash init failed | Failed to initialize flash in SSB |
| 123 | extended flash not enabled | Extended flash is required but not enabled in SSB, likely a chip select was not specified in the DFU package |
| 124 | flash erase error | Error while erasing flash in SSB |
| 125 | flash write error | Error while writing flash in SSB |
| 126 | flash read error | Error while reading flash in SSB |
| 127 | cache verify failed | Failed to verify CRC of encrypted image in SSB |
| 128 | decrypt verify failed | Failed to verify CRC of decrypted image in SSB |
| 129 | dms bundle not found | Requested bundle not found on DMS |
| 130 | update devcreds copy failed | Failed to copy device credentials from extended to internal flash |
| 131 | update devcreds sig invalid | Device credentials signature is invalid against current product auth key |
| 132 | update devcreds crc sig invalid | Failed to verify CRC when copying device credentials from extended to internal flash |
| 133 | update devcreds dms server cert invalid | Server cert in device credentials is invalid |
| 134 | update devcreds dms device cert invalid | Device cert in device credentials is invalid |
| 135 | update devcreds dms device key invalid | Device cert key in device credentials is invalid |
| 136 | update devcreds bundle version invalid | Bundle version is invalid in device credentials |
| 137 | update devcreds product key sig invalid | Product auth key signature in device credentials is not valid against platform auth key |
| 138 | update devcreds missing entry | Device credentials is missing one or more required entries |
| 139 | update kernel sig invalid | Kernel's signature is invalid against platform auth key |
| 140 | update kernel copy failed | Failed to copy kernel from extended to internal flash |
| 141 | update ssb crc invalid | CRC verification of SSB failed (i.e. CRC appended to SSB binary does not match calculated value) |
| 142 | update ssb sig invalid | SSB's signature is invalid against current product auth key |
| 143 | update ssb copy failed | Error while copying SSB from extended to internal flash |
| 144 | update application sig invalid | Application's signature is invalid against product auth key |
| 145 | update application copy failed | Error while copying application from extended to internal flash |
| 147 | device not provisioned | The device has not been provisioned and does not have a provisioning token. See DMS Provisioning |
| 148 | provisioning error | Error occurred while attempting to provision device. See DMS Provisioning |
| - package codes start - | The following codes are errors in the given DFU package | |
| 150 | malformed package | The sections within the package are not valid |
| 151 | invalid package signature | The signature of the package data is not valid against the product auth key |
| 152 | invalid package crc | The package's CRC is not valid |
| 153 | malformed package manifest | The package's manifest is not valid |
| 153 | malformed package metadata | The package's metadata field is not valid |
| 154 | is production device | Given package with 'development' credentials, but device has 'production' credentials |
| 155 | is development device | Given package with 'production' credentials, but device has 'development' credentials |
| 156 | package version not allowed | The device's current version is not allowed by the package's 'allowed versions' field |
| 157 | package product not allowed | The device's current product is not allowed by the package's 'allowed product' field |
| 158 | package interface not allowed | |
| 159 | package uuid not allowed | The device's UUID does not match the package's 'uuid' field |
| 160 | bulk fs not enabled | The package's has files destined to bulk flash, but the manifest does not specify the bulk flash |
| 161 | bulk fs init failed | Failed to initialize the bulk flash based on the chip select configuration in the package manifest |
| 162 | no room | There isn't enough room on extended/bulk flash to cache the package (even with multi-pass updates enabled) |
| 163 | no multi pass updates | The package requires 'multi-pass' updates to perform the update, but 'multi-pass' was not enabled |
| 164 | package data overflow | The package body contains more files than what was specified in the manifest |
| 165 | package header invalid | The factory DFU image contains an invalid header |
| 166 | package invalid product aes key | Cannot decrypt the package with the device's current product AES key |
Platforms
- WGM160P
Gecko OS Plugin
Get example
> get df s
1