View a markdown version of this page

Download, build, flash, and run the FreeRTOS OTA demo on the Espressif ESP32 - FreeRTOS
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Download, build, flash, and run the FreeRTOS OTA demo on the Espressif ESP32

Important

This is an archived version of the FreeRTOS User Guide for use with FreeRTOS release 202012.00. For the latest version of this document, see the FreeRTOS User Guide.

  1. Download the FreeRTOS source from GitHub. See the README.md file for instructions. 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 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 make in the vendors/espressif/boards/esp32/aws_demos 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 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.