{"id":14963112,"url":"https://github.com/espressif/esp-aws-iot","last_synced_at":"2025-04-04T19:13:59.557Z","repository":{"id":36165007,"uuid":"177583670","full_name":"espressif/esp-aws-iot","owner":"espressif","description":"AWS IoT SDK for ESP32 based chipsets","archived":false,"fork":false,"pushed_at":"2024-08-30T11:12:46.000Z","size":738,"stargazers_count":287,"open_issues_count":138,"forks_count":175,"subscribers_count":25,"default_branch":"master","last_synced_at":"2025-03-28T18:16:06.167Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/espressif.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-03-25T12:38:24.000Z","updated_at":"2025-03-20T03:56:13.000Z","dependencies_parsed_at":"2023-02-10T09:45:21.086Z","dependency_job_id":"6769ca07-aa12-4ea9-9f9c-c32745abbfd9","html_url":"https://github.com/espressif/esp-aws-iot","commit_stats":{"total_commits":107,"total_committers":17,"mean_commits":6.294117647058823,"dds":0.794392523364486,"last_synced_commit":"cd1bd3b654f7cf6393bb92100bb7916cf9152c06"},"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/espressif%2Fesp-aws-iot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/espressif%2Fesp-aws-iot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/espressif%2Fesp-aws-iot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/espressif%2Fesp-aws-iot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/espressif","download_url":"https://codeload.github.com/espressif/esp-aws-iot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247234923,"owners_count":20905854,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-09-24T13:31:02.611Z","updated_at":"2025-04-04T19:13:59.529Z","avatar_url":"https://github.com/espressif.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ESP-AWS-IoT\n\n\u003e **IMPORTANT**: Please choose the branch of this repo, based on the [FreeRTOS-LTS release](https://github.com/FreeRTOS/FreeRTOS-LTS/releases) that you would like to base your application on.\n\nIf you are using the older (3.x.x) `aws-iot-device-sdk-embedded-C` release, please checkout the [`release/v3.1.x`](https://github.com/espressif/esp-aws-iot/tree/release/v3.1.x) branch.\n\nThis 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](https://github.com/aws/aws-iot-device-sdk-embedded-C).\n\n## Getting Started\n\n- Please clone this branch of the repository using\n    ```\n    git clone -b \"\u003cname_of_the_release_branch\u003e\" --recursive https://github.com/espressif/esp-aws-iot\n    ```\n  For example: To clone just `release/202406.01-LTS`, you may run:\n  ```\n  git clone -b \"release/202406.01-LTS\" --recursive https://github.com/espressif/esp-aws-iot\n  ```\n- Please refer to https://docs.espressif.com/projects/esp-idf/en/latest/get-started/index.html for setting up ESP-IDF\n  - ESP-IDF can be downloaded from https://github.com/espressif/esp-idf/\n  - This SDK supports `release/v5.2`, `release/v5.1`, `release/v5.0`, and `release/v4.4` of ESP-IDF.\n  - Please set your branch to the IDF release that you would like to use, and pull in the latest changes.\n  \u003e **Note**: Please read [Support Policy](#support-policy) below for more details.\n- Please refer to the [example README](examples/README.md) for more information on setting up examples.\n- For a production-ready starting point for making applications that connect to AWS IoT Core using `esp-aws-iot`, refer to the [reference example](https://github.com/FreeRTOS/iot-reference-esp32c3).\n- Please refer to the [Security Guide](https://github.com/espressif/esp-aws-iot/blob/release/202210.01-LTS/examples/ota/SecurityGuide.md) for steps to enable Security Features on your Espressif chip.\n  - This SDK supports multiple ways to securely store the PKI credentials.\n  - The default method is to use PKI credentials which are embedded in the binary, using the certs from the `certs/` in every example. \n  - For using Secure Element (ATECC608A), you will need to use [esp-cryptoauthlib](https://github.com/espressif/esp-cryptoauthlib#how-to-use-esp-cryptoauthlib-with-esp-idf).\n  - The Security Guide includes detailed steps and pointers to configure and use the Digital Signature Peripheral on supported chips, using [esp_secure_cert_mgr](https://components.espressif.com/components/espressif/esp_secure_cert_mgr).\n\n## Supported SoCs\n\nThe following table shows esp-aws-iot support with the ESP-IDF support of Espressif SoCs:  \nCell marked as ![alt text][supported] denotes supported combination.\n\n\u003ctable\u003e\n\u003cthead\u003e\n   \u003ctr align=\"center\"\u003e\n    \u003cth rowspan=\"2\"\u003eSoC\u003c/th\u003e\n    \u003cth rowspan=\"2\"\u003eSupported IDF Version\u003c/th\u003e\n    \u003cth rowspan=\"2\"\u003e\u003ca href=\"https://github.com/espressif/esp-aws-iot/tree/master\"\u003emaster\u003c/a\u003e\u003c/th\u003e\n    \u003cth colspan=\"2\"\u003eesp-aws-iot Release\u003c/th\u003e\n  \u003c/tr\u003e\n   \u003ctr align=\"center\"\u003e\n    \u003cth\u003e\u003ca href=\"https://github.com/espressif/esp-aws-iot/tree/release/202406.01-LTS\"\u003e202406.01-LTS\u003c/a\u003e\u003c/th\u003e\n    \u003cth\u003e\u003ca href=\"https://github.com/espressif/esp-aws-iot/tree/release/202210.01-LTS\"\u003e202210.01-LTS\u003c/a\u003e\u003c/th\u003e\n  \u003c/tr\u003e\n\u003c/thead\u003e\n\u003ctbody\u003e\n   \u003ctr align=\"center\"\u003e\n    \u003ctd rowspan=\"4\"\u003eESP32\u003c/td\u003e\n    \u003ctd\u003eIDF v4.4\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n   \u003c/tr\u003e\n   \u003ctr align=\"center\"\u003e\n    \u003ctd\u003eIDF v5.0\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n   \u003c/tr\u003e\n   \u003ctr align=\"center\"\u003e\n    \u003ctd\u003eIDF v5.1\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n   \u003c/tr\u003e\n   \u003ctr align=\"center\"\u003e\n    \u003ctd\u003eIDF v5.2\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003c/td\u003e\n   \u003c/tr\u003e\n   \u003ctr align=\"center\"\u003e\n    \u003ctd rowspan=\"4\"\u003eESP32-S2\u003c/td\u003e\n    \u003ctd\u003eIDF v4.4\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n   \u003c/tr\u003e\n   \u003ctr align=\"center\"\u003e\n    \u003ctd\u003eIDF v5.0\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n   \u003c/tr\u003e\n   \u003ctr align=\"center\"\u003e\n    \u003ctd\u003eIDF v5.1\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n   \u003c/tr\u003e\n   \u003ctr align=\"center\"\u003e\n    \u003ctd\u003eIDF v5.2\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003c/td\u003e\n   \u003c/tr\u003e\n   \u003ctr align=\"center\"\u003e\n    \u003ctd rowspan=\"4\"\u003eESP32-C3\u003c/td\u003e\n    \u003ctd\u003eIDF v4.4\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n   \u003c/tr\u003e\n   \u003ctr align=\"center\"\u003e\n    \u003ctd\u003eIDF v5.0\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n   \u003c/tr\u003e\n   \u003ctr align=\"center\"\u003e\n    \u003ctd\u003eIDF v5.1\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr align=\"center\"\u003e\n    \u003ctd\u003eIDF v5.2\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n   \u003ctr align=\"center\"\u003e\n    \u003ctd rowspan=\"4\"\u003eESP32-S3\u003c/td\u003e\n    \u003ctd\u003eIDF v4.4\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n   \u003ctr align=\"center\"\u003e\n    \u003ctd\u003eIDF v5.0\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n   \u003ctr align=\"center\"\u003e\n    \u003ctd\u003eIDF v5.1\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr align=\"center\"\u003e\n    \u003ctd\u003eIDF v5.2\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n   \u003ctr align=\"center\"\u003e\n    \u003ctd rowspan=\"3\"\u003eESP32-C2\u003c/td\u003e\n    \u003ctd\u003eIDF v5.0\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n   \u003ctr align=\"center\"\u003e\n    \u003ctd\u003eIDF v5.1\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr align=\"center\"\u003e\n    \u003ctd\u003eIDF v5.2\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n   \u003ctr align=\"center\"\u003e\n    \u003ctd rowspan=\"2\"\u003eESP32-C6\u003c/td\u003e\n    \u003ctd\u003eIDF v5.1\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr align=\"center\"\u003e\n    \u003ctd\u003eIDF v5.2\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://img.shields.io/badge/-supported-green\" alt=\"Image\" width=\"65\" height=\"20\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/tbody\u003e\n\u003c/table\u003e\n\n[supported]: https://img.shields.io/badge/-supported-green \"supported\"\n\n## Support Policy\n\nIDF version support for esp-aws-iot releases is based on [IDF Release Support Schedule](https://github.com/espressif/esp-idf#esp-idf-release-support-schedule).  \nFor example, support for IDF v4.4 for Release 202406.01-LTS will expire on 31st July 2024.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fespressif%2Fesp-aws-iot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fespressif%2Fesp-aws-iot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fespressif%2Fesp-aws-iot/lists"}