ESP-AWS-IoT

IMPORTANT: Please choose the branch of this repo, based on the FreeRTOS-LTS release that you would like to base your application on.

If you are using the older (3.x.x) aws-iot-device-sdk-embedded-C release, please checkout the release/v3.1.x branch.

This SDK enables AWS IoT cloud connectivity with ESP32-based platforms using the libraries provided as a part of the AWS IoT Device Embedded C SDK.

Getting Started

• Please clone this branch of the repository using

  git clone -b "<name_of_the_release_branch>" --recursive https://github.com/espressif/esp-aws-iot
  

  For example: To clone just release/202406.05-LTS, you may run:

  git clone -b "release/202406.05-LTS" --recursive https://github.com/espressif/esp-aws-iot
  

• Please refer to https://docs.espressif.com/projects/esp-idf/en/latest/get-started/index.html for setting up ESP-IDF
  • ESP-IDF can be downloaded from https://github.com/espressif/esp-idf/
  • This SDK supports release/v6.0, release/v5.5, release/v5.4, release/v5.3 and release/v5.2 of ESP-IDF.
  • The corePKCS11 library is not supported on release/v6.0 as support for mbedTLS v4.x is not available in corePKCS11 yet.
    Consequently, the fleet_provisioning_with_csr example, which depends on corePKCS11 is incompatible with release/v6.0.
  • Please set your branch to the IDF release that you would like to use, and pull in the latest changes.

    Note: Please read Support Policy below for more details.

• Please refer to the example README for more information on setting up examples.
• For a production-ready starting point for making applications that connect to AWS IoT Core using esp-aws-iot, refer to the reference example.
• Please refer to the Security Guide for steps to enable Security Features on your Espressif chip.
  • This SDK supports multiple ways to securely store the PKI credentials.
  • The default method is to use PKI credentials which are embedded in the binary, using the certs from the certs/ in every example.
  • ATECC608A credentials use the legacy mbedTLS ALT integration on ESP-IDF v5.x and the unified key interface with a PSA opaque-key driver on supported ESP-IDF v6.x checkouts.
  • The Security Guide includes detailed steps and pointers to configure and use the Digital Signature Peripheral on supported chips, using esp_secure_cert_mgr.

Supported SoCs

The following table shows esp-aws-iot support with the ESP-IDF support of Espressif SoCs:
Cell marked as denotes supported combination.
Cell marked as denotes expired combination.
Cell marked as - denotes a release/IDF combination that was not available in that release.

SoC	Supported IDF Version	esp-aws-iot Release
		master	202406.05-LTS	202406.03-LTS 202406.01-LTS
ESP32	IDF v5.1
	IDF v5.2
	IDF v5.3
	IDF v5.4
	IDF v5.5
	IDF v6.0			-
ESP32-S2	IDF v5.1
	IDF v5.2
	IDF v5.3
	IDF v5.4
	IDF v5.5
	IDF v6.0			-
ESP32-C3	IDF v5.1
	IDF v5.2
	IDF v5.3
	IDF v5.4
	IDF v5.5
	IDF v6.0			-
ESP32-S3	IDF v5.1
	IDF v5.2
	IDF v5.3
	IDF v5.4
	IDF v5.5
	IDF v6.0			-
ESP32-C2	IDF v5.1
	IDF v5.2
	IDF v5.3
	IDF v5.4
	IDF v5.5
	IDF v6.0			-
ESP32-C6	IDF v5.1
	IDF v5.2
	IDF v5.3
	IDF v5.4
	IDF v5.5
	IDF v6.0			-
ESP32-C5	IDF v5.5
	IDF v6.0			-

Support Policy

Support for esp-aws-iot release branches is based on a combination of the IDF Release Support Schedule and the FreeRTOS Long Term Support Maintenance Period.

Examples:

1. IDF v5.2 in esp-aws-iot 202406.05-LTS → expires 16 August 2026, when IDF v5.2 reaches End-of-Life.

2. IDF v5.1 in esp-aws-iot 202406.03-LTS → expired December 2025, when IDF v5.1 reached End-of-Life.

3. Complete support for esp-aws-iot 202210.01-LTS → expired 31st October 2024, when FreeRTOS-LTS 202210.01-LTS reached End-of-Life.