Amazon FreeRTOS
User Guide

OTA Tutorial

This section contains a tutorial for updating firmware on devices running Amazon FreeRTOS using OTA updates. You can, however, use OTA updates to send files to any devices connected to AWS IoT.

You can create an OTA update using the AWS IoT console or the AWS CLI. The console is the easiest way to get started with OTA because it does a lot of the work for you. The AWS CLI is useful when you are automating OTA update jobs, working with a large number of devices, or are using devices that have not been qualified for Amazon FreeRTOS. For more information about the Amazon FreeRTOS qualification program see, Amazon FreeRTOS Qualification Program.

To create a OTA update:

  1. Deploy an initial version of your firmware to one or more devices.

  2. Verify the firmware is running correctly.

  3. When a firmware update is required, make the code changes and build the new image.

  4. If you are manually signing your firmware, sign it and then upload the signed firmare image to your Amazon S3 bucket.

  5. If you are using Code Signing for Amazon FreeRTOS upload your unsigned firmware image into an Amazon S3 bucket.

  6. Create an OTA update.

The Amazon FreeRTOS OTA agent on the device receives the updated firmware image and verifies the digital signature, checksum, and version number of the new image. If the firmware update is verified, the device is reset and, based on application-defined logic, commits the update. If your devices are not running Amazon FreeRTOS you must implement an OTA agent that runs on your devices.