NOTICE: These Espressif examples have been created and tested with the latest stable release branch of ESP-IDF V4 and have not yet been upgraded to the master branch V5. See the latest migration guides.

Overview

ESP-IDF development framework with wolfSSL by setting WOLFSSL_ESPIDF definition

Including the following examples:

Simple TLS client/server
Cryptographic test
Cryptographic benchmark

The user_settings.h file enables some of the hardened settings.

Requirements

ESP-IDF development framework

Setup for Linux

Run setup.sh at /path/to/wolfssl/IDE/Espressif/ESP-IDF/ to deploy files into ESP-IDF tree
Find Wolfssl files at /path/to/esp/esp-idf/components/wolfssl/
Find Example Programs under /path/to/esp/esp-idf/examples/protocols/wolfssl_xxx (where xxx is the project name)

Setup for Windows

Run ESP-IDF Command Prompt (cmd.exe) or Run ESP-IDF PowerShell Environment
Run setup_win.bat at .\IDE\Espressif\ESP-IDF\
Find Wolfssl files at /path/to/esp/esp-idf/components/wolfssl/
Find Example programs under /path/to/esp/esp-idf/examples/protocols/wolfssl_xxx (where xxx is the project name)

Setup for VisualGDB

Clone a specific version:

C:\SysGCC\esp32\esp-idf>git clone -b v5.0.2 --recursive https://github.com/espressif/esp-idf.git v5.0.2

Configuration

The user_settings.h can be found in /path/to/esp/esp-idf/components/wolfssl/include/user_settings.h

Build examples

See README in each example folder

Support

For question please email [support@wolfssl.com]

Note: This is tested with :

OS: Ubuntu 20.04.3 LTS
Microsoft Windows 10 Pro 10.0.19041
WSL Ubuntu
ESP-IDF: ESP-IDF v4.3.2
Module : ESP32-WROOM-32

JTAG Debugging

All of the examples are configured to use either the on-board JTAG (when available) or the open source Tigard multi-protocol tool for hardware hacking.

VisualGDB users should find the configuration file in the interface\ftdi directory:

C:\Users\%USERNAME%\AppData\Local\VisualGDB\EmbeddedDebugPackages\com.sysprogs.esp32.core\share\openocd\scripts\interface\ftdi