How do I update Device Firmware?

Update Device Firmware to the latest version.

To perform a firmware update for your device, fetch the latest firmware version number from the NexStem Firmware Repository.

Then turn on the device, wait for the LED to turn solid pink. Once the LED is glowing solid pink, send this cURL request to the device -

curl --location --request POST '${DEVICEID}.local/firmware_update' \
--header 'Content-Type: application/json' \
--data-raw '{"version":"${VERSION NUMBER}"}'

Remember to replace the DEVICEID and the VERSION NUMBER in the request.

Once you get a successful response to the above request, turn off your device and turn it back on. It will start flashing cyan, indicating that the device is now updating it's firmware.

Do not turn off the device in middle of a firmware update (while the LED is flashing cyan), this may brick your device.

Handy Tips

  • The device firmware version would always follow the following nomenclature - YYYYMMDD_REV-TYPE.  For example: 20220219_4-main.
  • In case the request doesn't go through make sure that you are in the same network as the device (i.e. you are connected to the same router to which you configured the device to connect to) and the device LED was solid pink when you sent the request.
  • You can also use Postman to make the firmware update API call.
  • You can try the dev firmware versions as well, but make sure to read the changelog, as a dev firmware might cause lead to instability.