Amazon FreeRTOS
User Guide

The AWS Documentation website is getting a new look!
Try it now and let us know what you think. Switch to the new look >>

You can return to the original look by selecting English in the language selector above.

Download, Build, Flash, and Run the Amazon FreeRTOS OTA demo on the Espressif ESP32

  1. Download the Amazon FreeRTOS source from GitHub. Create a project in your IDE that includes all required sources and libraries.

  2. Follow the instructions in Getting Started with Espressif to set up the required GCC-based toolchain.

  3. Open <amazon-freertos>/vendors/<vendor>/boards/<board>/aws_demos/config_files/aws_demo_config.h, comment out #define CONFIG_MQTT_DEMO_ENABLED, and define CONFIG_OTA_UPDATE_DEMO_ENABLED.

  4. Build the demo project by running makein the vendors/espressif/boards/esp32/aws_demos/make directory. You can flash the demo program and verify its output by running make flash monitor, as described in Getting Started with Espressif.

  5. Before running the OTA Update demo:

    • Open <amazon-freertos>/vendors/<vendor>/boards/<board>/aws_demos/config_files/aws_demo_config.h, comment out #define CONFIG_MQTT_DEMO_ENABLED, and define CONFIG_OTA_UPDATE_DEMO_ENABLED.

    • Make sure that your SHA-256/ECDSA code-signing certificate is copied into the demos/include/aws_ota_codesigner_certificate.h.