ESP-THREAD-BR is the official ESP Thread Border Router SDK. It supports all fundamental network features to build a Thread Border Router and integrates rich product level features for quick productization.
The SDK is built on top of ESP-IDF and OpenThread. The OpenThread port and ESP Border Router implementation is provided as pre-built library in ESP-IDF.
The Wi-Fi based ESP Thread Border Router consists of two SoCs:
The ESP Thread border router board provides an integrated module of an ESP32-S3 SoC and an ESP32-H2 RCP.
The two SoCs are connected with following interfaces:
The SDK also supports manually connecting an ESP32-H2 RCP to an ESP32 series Wi-Fi SoC.
ESP32 pin | ESP32-H2 pin |
---|---|
GND | G |
GPIO17 (UART RX) | TX |
GPIO18 (UART TX) | RX |
GPIO7 | RST |
GPIO8 (SPI INTR) | GPIO9 (BOOT) |
GPIO10 (SPI CS) | GPIO2 |
GPIO11 (SPI MOSI) | GPIO3 |
GPIO12 (SPI CLK) | GPIO0 |
GPIO13 (SPI MISO) | GPIO1 |
Note that the SPI GPIOs are optional, if the UART is selected for communication.
The following image shows an example connection between ESP32 DevKitC and ESP32-H2 DevKitC:
In this setup, only UART interface is connected, so it doesn't support RCP Update or RF Coexistence features. You can refer to ot_br example in esp-idf as a quick start.
Similar to the previous Wi-Fi based Thread Border Router setup, but a device with Ethernet interface is required, such as ESP32-Ethernet-Kit.
These features are currently provided by the SDK:
Documentation for the latest version: https://docs.espressif.com/projects/esp-thread-br/. This documentation is built from the docs directory of this repository.
The esp32.com forum is a place to ask questions and find community resources.
Check the Issues section on github if you find a bug or have a feature request. Please check existing Issues before opening a new one.
If you're interested in contributing to ESP-THREAD-BR, please check the Contributions Guide.