Recover the system software

  • Article

Recovery is the process of replacing the system software on the device using a special recovery bootloader instead of cloud update. The recovery process erases the contents of flash, replaces the system software, and reboots the device. As a result, application software and configuration data, including Wi-Fi credentials, are erased from the device. After you recover, you must reinstate the credentials (if any) and reconnect the device to the internet.

Important

Perform the recovery procedure only if instructed to do so by Microsoft. Recovery is required only when cloud updates are not available.

To recover the system software:

  1. Ensure that your device is connected by USB to your computer.

  2. Run the az sphere device recover command:

    az sphere device recover

    You should see output similar to the following, although the number of images may differ.

     Downloading recovery images...
 Download complete.
 Starting device recovery. Please note that this may take up to 10 minutes.
 Board found. Sending recovery bootloader.
 Erasing flash.
 Sending 16 images. (5558148 bytes to send)
 Sent 1 of 16 images. (5527016 of 5558148 bytes remaining)
 Sent 2 of 16 images. (5411124 of 5558148 bytes remaining)
 Sent 3 of 16 images. (5410732 of 5558148 bytes remaining)
 Sent 4 of 16 images. (5123332 of 5558148 bytes remaining)
 Sent 5 of 16 images. (5106976 of 5558148 bytes remaining)
 Sent 6 of 16 images. (5074876 of 5558148 bytes remaining)
 Sent 7 of 16 images. (2508048 of 5558148 bytes remaining)
 Sent 8 of 16 images. (820260 of 5558148 bytes remaining)
 Sent 9 of 16 images. (795684 of 5558148 bytes remaining)
 Sent 10 of 16 images. (680784 of 5558148 bytes remaining)
 Sent 11 of 16 images. (152180 of 5558148 bytes remaining)
 Sent 12 of 16 images. (78240 of 5558148 bytes remaining)
 Sent 13 of 16 images. (41164 of 5558148 bytes remaining)
 Sent 14 of 16 images. (32768 of 5558148 bytes remaining)
 Sent 15 of 16 images. (16384 of 5558148 bytes remaining)
 Sent 16 of 16 images. (0 of 5558148 bytes remaining)
 Finished writing images; rebooting board.
 Using selected capability file 'fieldservicing-218bef7c.cap'.
 Device ID: 6a06x8x8cxdxa8ed4223a267656cxd59x99a0ced693a2446884a236d925aaaex9axdd0550438595658addc66723x32decx5494x7a20d067c6c8x77a6020c9a46
 Device recovered successfully.

  3. To continue using your device for development, run az sphere device enable-development to re-enable application sideload and debugging.

  4. To reconnect your device to Wi-Fi, replace the Wi-Fi credentials on the device.