DFU

dfu.logs_enabled

Abbreviation

df l

Access

get/set

Description

This variable enables/disables verbose DFU log messages.

Notes

Arguments

0|false|off/1|true|on

Default

0

Platforms

Gecko OS Plugin

Get example

> get df l
0

Set example

> get df l 1
Set OK

dfu.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

Gecko OS Plugin

Get example

> get df s
1