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 reference integration is hosted on the Amazon-FreeRTOS repository which is deprecated. We recommend that you start here when you create a new project. If you already have an existing FreeRTOS project based on the now deprecated Amazon-FreeRTOS repository, see the Amazon-FreeRTOS Github Repository Migration 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_CORE_MQTT_MUTUAL_AUTH_DEMO_ENABLED, and define CONFIG_OTA_MQTT_UPDATE_DEMO_ENABLED or CONFIG_OTA_HTTP_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_CORE_MQTT_MUTUAL_AUTH_DEMO_ENABLED, and define CONFIG_OTA_MQTT_UPDATE_DEMO_ENABLED or CONFIG_OTA_HTTP_UPDATE_DEMO_ENABLED.

    • Open vendors/vendor/boards/board/aws_demos/config_files/ota_demo_config.h, and copy your SHA-256/ECDSA code-signing certificate in:

      #define otapalconfigCODE_SIGNING_CERTIFICATE [] = "your-certificate-key";