README.md

wolfSSL ESP32 Examples

These are wolfSSL TLS 1.3 clients and servers for both wired and wireless Internet.

Note: wolfSSL v5.5.4 or newer is needed to use these examples with ESP-IDF v5.

See the setup scripts to install.

ESP32 TLS 1.3 Server

• Wireless STA server
• Wired ENC28J60 server

coming soon:

• Wireless AP client
• Arduino client

ESP32 TLS 1.3 Client

• Wireless STA client
• Wired ENC28J60 client

coming soon:

• Wireless AP server
• Arduino server

Creating VisualGDB Projects

ESP-IDF

Although the examples were created using VisualGDB extension for Visual Studio, the examples can of course be compiled using the ESP-IDF idf.py.

Once the EDP-IDF is installed, use the setp_win.bat to copy wolfSSL files to the esp-idf\components directory, typically in C:\Users\%username%\esp\esp-idf\components or C:\Users\%username%\Desktop\esp-idf\components. Be sure to run the ESP-IDY X.Y CMD command prompt that has %IDF_PATH% defined.

cd \workspace\
git clone https://github.com/wolfSSL/wolfssl.git
cd wolfssl\IDE\Espressif\ESP-IDF\
.\setup_win.bat

Build with VisualGDB toolchain from WSL

. /mnt/c/SysGCC/esp32/esp-idf/v5.0/export.sh
idf.py -b 115200 -p /dev/ttyS15 build flash monitor

Tips

If JTAG gets into a mode where it is simply always returning an error (app continually resetting) try using serial port to program a basic, operational "hello world". The Arduino IDE or command-line ESP-IDF can be handy here.

Toolchain Switching in VisualGDB

Due to occasional difficulty in switching between toolchains, separate VisualGDB solution files are included for ESP-IDF v4.4.1 and v5.0.

See the ProjectModeSettings of the respective .vgdbproj file:

      <ESPIDFExtension>
        <IDFCheckout>
          <Version>release/v5.0</Version>
          <Subdirectory>esp-idf/v5.0</Subdirectory>
          <Type>ESPIDF</Type>
        </IDFCheckout>
        <COMPort>COM20</COMPort>
        <SuppressTestPrerequisiteChecks>false</SuppressTestPrerequisiteChecks>
        <UseCCache>false</UseCCache>
        <DeviceID>ESP32</DeviceID>
      </ESPIDFExtension>

See also:

• wolfSSL

• Espressif

• wolfSSL Quick Start Guide

• github.com/wolfSSL/wolfssl

• wolfSSL blog: ESP32 Hardware Acceleration Support

• wolfSSL blog: Support for ESP-IDF and ESP32-WROOM-32

• wolfSSL Context and Session Set Up

• wolfSSL Certificates and Keys

• wolfSSL Error Handling and Reporting

• wolfSSL Espressif Support Docs

• wolfSSL Licensing

• wolfssl/IDE/Espressif/ESP-IDF (will be migrating to wolfSSL/wolfssl-examples )

• wolfssl/error-ssl.h

• wolfssl/certs_test.h

• Espressif ESP32 Series of Modules

• Espressif ESP-IDF Programming Guide

• Espressif System Time API

• Espressif Networking API

• linux socket

• linux socket connect

• stackoverflow: What are the differences between .pem, .cer and .der?

• esp32.com: How to check cip version

• VisualGDB Extension for Visual Studio

• Wireshark

• WSL

Support

Please contact wolfSSL at [email protected] with any questions, bug fixes, or suggested feature additions.