OTA Support Checklist
Use this checklist when a device reports a failed OTA update.
Cloud Checks
- Confirm
/v1/ota/latestreturns the expected version. - Confirm the published firmware metadata record has the expected
sha256andtarget_hardware. - Confirm the stored firmware object exists for the published key.
- Confirm
GET /v1/ota/firmware/:firmwareIdreturns:200 OKX-Firmware-VersionX-Firmware-TargetX-Firmware-SHA256
Device Checks
- Confirm the device has a valid token.
- Confirm OTA is enabled in device settings.
- Confirm the installed firmware version is older than the published version.
- Review the device-reported OTA runtime fields:
- last result
- offered version
- last check timestamp
Decision
- If checksum headers and the stored firmware object are correct, investigate device connectivity or storage.
- If metadata is wrong, stop rollout and correct the published metadata before more devices poll.