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:

CodeBriefDescription
0noneNo status, default value on power-up
1successDFU successfully completed
2first pass successDFU successfully completed the 'first pass'
3up to dateDFU successfully completed, firmware already up-to-date
4pendingDFU 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
11dms connection errorError while issuing DMS HTTP request
12dms read timeout errorTimed-out while receiving DMS HTTP response
13network not foundThe configured network was not found
14network join failedFailed to connect to network
15max request attemptsMax attempts at issuing OTA DFU requests to DMS exceeded
16xmodem init timeoutMax attempts at initializing Xmodem interface exceeded
17xmodem read timeoutTimeout out while trying to receive Xmodem packet
18xmodem max retriesMax attempts at retransmitting an Xmodem packet exceeded
- recoverable errors end -For errors below, DFU mode is aborted
100kernel errorUnknown Kernel error occurred
101max faults
102application file invalidThe application file on internal flash is invalid
103dms product auth key sig invalidThe product auth key was improperly signed by the current platform auth key
105application signature invalidThe application's signature on bootload is not valid against the product auth key
106invalid command
107network ssid not setNo network SSID is set
108network passkey not setNo network password is set
109network security not supportedThe configured network security is not supported
110max update attemptsMax Kernel attempts of updating firmware exceeded
111no device certificateNo device DMS certificate was found in the device's internal memory
116devcreds finalize failedFailed to finalize the device credentials update on internal memory
117dms no authorizationThe device does not have access to the firmware on the DMS
118application signature check failedApplication signature in internal memory is not valid during DFU
119dfu counter exceededThe DFU NVM counter has been exceeded. Serial DFUs are now prohibited
120devcreds corruptDevice credential memory corrupted
121second stage bootloader errorUnknown error in SSB (Second Stage Bootloader)
122extended flash init failedFailed to initialize flash in SSB
123extended flash not enabledExtended flash is required but not enabled in SSB, likely a chip select was not specified in the DFU package
124flash erase errorError while erasing flash in SSB
125flash write errorError while writing flash in SSB
126flash read errorError while reading flash in SSB
127cache verify failedFailed to verify CRC of encrypted image in SSB
128decrypt verify failedFailed to verify CRC of decrypted image in SSB
129dms bundle not foundRequested bundle not found on DMS
130update devcreds copy failedFailed to copy device credentials from extended to internal flash
131update devcreds sig invalidDevice credentials signature is invalid against current product auth key
132update devcreds crc sig invalidFailed to verify CRC when copying device credentials from extended to internal flash
133update devcreds dms server cert invalidServer cert in device credentials is invalid
134update devcreds dms device cert invalidDevice cert in device credentials is invalid
135update devcreds dms device key invalidDevice cert key in device credentials is invalid
136update devcreds bundle version invalidBundle version is invalid in device credentials
137update devcreds product key sig invalidProduct auth key signature in device credentials is not valid against platform auth key
138update devcreds missing entryDevice credentials is missing one or more required entries
139update kernel sig invalidKernel's signature is invalid against platform auth key
140update kernel copy failedFailed to copy kernel from extended to internal flash
141update ssb crc invalidCRC verification of SSB failed (i.e. CRC appended to SSB binary does not match calculated value)
142update ssb sig invalidSSB's signature is invalid against current product auth key
143update ssb copy failedError while copying SSB from extended to internal flash
144update application sig invalidApplication's signature is invalid against product auth key
145update application copy failedError while copying application from extended to internal flash
147device not provisionedThe device has not been provisioned and does not have a provisioning token. See DMS Provisioning
148provisioning errorError occurred while attempting to provision device. See DMS Provisioning
- package codes start -The following codes are errors in the given DFU package
150malformed packageThe sections within the package are not valid
151invalid package signatureThe signature of the package data is not valid against the product auth key
152invalid package crcThe package's CRC is not valid
153malformed package manifestThe package's manifest is not valid
153malformed package metadataThe package's metadata field is not valid
154is production deviceGiven package with 'development' credentials, but device has 'production' credentials
155is development deviceGiven package with 'production' credentials, but device has 'development' credentials
156package version not allowedThe device's current version is not allowed by the package's 'allowed versions' field
157package product not allowedThe device's current product is not allowed by the package's 'allowed product' field
158package interface not allowed
159package uuid not allowedThe device's UUID does not match the package's 'uuid' field
160bulk fs not enabledThe package's has files destined to bulk flash, but the manifest does not specify the bulk flash
161bulk fs init failedFailed to initialize the bulk flash based on the chip select configuration in the package manifest
162no roomThere isn't enough room on extended/bulk flash to cache the package (even with multi-pass updates enabled)
163no multi pass updatesThe package requires 'multi-pass' updates to perform the update, but 'multi-pass' was not enabled
164package data overflowThe package body contains more files than what was specified in the manifest
165package header invalidThe factory DFU image contains an invalid header
166package invalid product aes keyCannot decrypt the package with the device's current product AES key

Platforms

Gecko OS Plugin

Get example

> get df s
1