mirror of
https://github.com/espressif/esp-idf.git
synced 2024-10-05 20:47:46 -04:00
da471dfcd1
Updated main examples README to add missing examples folders and Getting Started links Updated wifi/fastscan example README Updated wifi examples README Updated wifi main examples README Added instructions and removed obviousness from examples README Updates on example README in peripherals, system and wifi Updates on example README in peripherals and added wave form pictures on wave_gen example Updates and review on example README Revision on unit style convention Added the getting started link for each supported version Readme review and recommended enhancements Added the default note on the wave form option info Added the ESP32-C3 support information on the temperature sensor example README Added Getting Started information for ESP32-S2 and ESP32-C3 Issue fixed on the supported target on README Resolved merge conflict
55 lines
2.9 KiB
Markdown
55 lines
2.9 KiB
Markdown
| Supported Targets | ESP32 |
|
||
| ----------------- | ----- |
|
||
|
||
# ECDSA sign/verify Example with ESP32-WROOM-32SE
|
||
|
||
## Description
|
||
|
||
(See the README.md file in the upper level 'examples' directory for more information about examples.)
|
||
|
||
This example requires [ESP32-WROOM-32SE](https://www.espressif.com/sites/default/files/documentation/esp32-wroom-32se_datasheet_en.pdf) which has Microchip's [ATECC608A](https://www.microchip.com/wwwproducts/en/ATECC608A) (Secure Element) integrated on the module.
|
||
|
||
The example performs `ECDSA sign/verify` functions on sample data using hardware private key stored in ATECC608A chip. If you want to use bare `ATECC608A` chip (Secure Element) with `ESP32-WROOM-32` module by making external connections, please refer [this](https://github.com/espressif/esp-cryptoauthlib/blob/master/esp_cryptoauth_utility/README.md#using-atecc608a-with-esp32-wroom-32) for details.
|
||
|
||
## How to use example
|
||
|
||
Before project configuration and build, be sure to set the correct chip target using `idf.py set-target <chip_name>`.
|
||
|
||
### Hardware Required
|
||
|
||
To get started you will need a `ESP32-WROOM-32SE` development board which integrates Microchip’s ATECC608A CryptoAuth chip in the module.
|
||
|
||
* A development board with ESP32-WROOM-32SE SoC or an custom board with the `ATECC608A` IC.
|
||
* A USB cable for Power supply and programming
|
||
|
||
### Configure the project
|
||
|
||
ATECC608A chip on ESP32-WROOM-32SE should be configured to run the example, for details on configuration of ATECC608A chip, please refer [esp_cryptoauth_utility](https://github.com/espressif/esp-cryptoauthlib/blob/master/esp_cryptoauth_utility/README.md#esp_cryptoauth_utility)
|
||
|
||
Open the project configuration menu (`idf.py 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](https://github.com/espressif/esp-cryptoauthlib/blob/master/esp_cryptoauth_utility/README.md#find-type-of-atecc608a-chip-connected-to-esp32-wroom32-se).
|
||
|
||
### Build and Flash
|
||
|
||
Build the project and flash it to the board, then run the monitor tool to view the serial output:
|
||
|
||
Run `idf.py -p PORT flash monitor` to build, flash and monitor the project.
|
||
|
||
(To exit the serial monitor, type ``Ctrl-]``.)
|
||
|
||
See the [Getting Started Guide](https://docs.espressif.com/projects/esp-idf/en/latest/get-started/index.html) for all the steps to configure and use the ESP-IDF to build projects.
|
||
|
||
## Troubleshooting
|
||
|
||
For any technical queries, please open an [issue](https://github.com/espressif/esp-idf/issues) on GitHub. We will get back to you soon.
|