esp-cryptoauthlib: The port of Microchip CryptoAuthentication Library for ESP-IDF



This is a port of Microchip's [cryptoauthlib]( for ESP-IDF. It contains necessary build support to use cryptoauthlib with ESP-IDF as well as `esp_cryptoauthlib_utility` for configuring and provisiong ATECC608A chip connected to an ESP module. Currently the utility is supported for ESP32, ESP32S3 and ESP32C3. The cryptoauthlib folder which is a subset of Microchip's [cryptoauthlib]( is created with help of script [](

## Requirements

* [ESP-IDF]( version should be `release/v4.3` or newer.
* Environment variable `IDF_PATH` should be set

## How to use esp-cryptoauthlib with ESP-IDF
There are two ways to use `esp-cryptoauthlib` in your project

1) Directly add `esp-cryptoauthlib` as a component in your project with following three commands.

    (First change directory (cd) to your project directory)
    mkdir components
    cd components
    git clone
2) Add `esp-cryptoauthlib` as an extra component in your project.

* Download `esp-cryptoauthlib` with:
    git clone
* Include  `esp-cryptoauthlib` in `ESP-IDF` with setting `EXTRA_COMPONENT_DIRS` in CMakeLists.txt/Makefile of your project.For reference see [Optional Project Variables](

## How to configure and provision ATECC608
The python utilty `esp_cryptoauth_utility` helps to configure, generate resources as well as provision ATECC608A chip connected to an ESP module.
For detailed instructions on how to use the utility please refer utility [](

readme of atecc608_ecdsa example

                                        | Supported Targets | ESP32 | ESP32-S3 | ESP32-C3 |
| ----------------- | ----- | -------- | -------- |

# ECDSA sign/verify Example with ESP32 series SoC interfaced with ATECC608A

## Description

(See the file in the upper level 'examples' directory for more information about examples.)

This example requires ESP32 platform interfaced with Microchip's [ATECC608A]( Secure Element.

For making the hardware connections with `ATECC608A` chip (Secure Element), please refer [this]( for details.

The example performs `ECDSA sign/verify` functions on sample data using hardware private key stored in ATECC608A chip.

## How to use example

Before project configuration and build, be sure to set the correct chip target using ` set-target <chip_name>`.

### Hardware Required

* A development board with ESP32 series based SoC
* `ATECC608A` IC based external module or dev. board.
* A USB cable for Power supply and programming

### Configure the project

Hardware should be configured to run the example, for details on configuration of ATECC608A chip, please refer [esp_cryptoauth_utility](

Open the project configuration menu (` menuconfig`). 

In the `Component config -> esp-cryptoauthlib` menu:

* Use `Choose the type of ATECC608A chip` to set the Crypto IC type [1].
* Use `Enable Hardware ECDSA keys for mbedTLS` Enable Hardware ECDSA.
    * Set `Enable ATECC608A sign operations in mbedTLS` to use Hardware ECDSA sign.
    * Set `Enable ATECC608A verify operations in mbedTLS` to use Hardware ECDSA verify.
* Set `I2C SDA pin used to communicate with the ATECC608A`.
* Set `I2C SCL pin used to communicate with the ATECC608A`.

[1]: for more details refer [Find ATECC608A chip type](

### Build and Flash

Build the project and flash it to the board, then run the monitor tool to view the serial output:

Run ` -p PORT flash monitor` to build, flash and monitor the project.

(To exit the serial monitor, type ``Ctrl-]``.)

See the [Getting Started Guide]( for all the steps to configure and use the ESP-IDF to build projects.

## Troubleshooting

For any technical queries, please open an [issue]( on GitHub. We will get back to you soon.



Supports all targets

License: Custom

To add this component to your project, run: add-dependency "espressif/esp-cryptoauthlib^3.5.1~3"

or download archive


  • ESP-IDF >=4.3
  • Examples:


    more details


    • Downloaded in total
      Downloaded in total 24.6k times
    • Downloaded this version
      This version: 809 times


    espressif/esp-cryptoauthlib version: 3.5.1~3 |