Thread Border Router with ESP32

Bullet points

• Supports single ESP32-S31 microcontroller setup

• Supports stable and fast 1 GB/s Ethernet network connection instead of rely on Wi-Fi

Features

Backend

• Thread Border Router with Ethernet-Backhaul, Auto-Attach after Reboot

• REST-API with Setup-Token-Auth (Device-Info, Thread-State, Dataset, Neighbors, Commissioner, OTA)

• OTA with GitHub Releases, including Rollback-Protection

• 16-MB-Partitionslayout incl. prepared nvs_keys for future encryption

• CI: firmware build

Frontend

• Fast Astro SSR with Qwik interactions

• CI: static file generation

• dev-proxy for local development

Prerequisites

• ESP-IDF master-branch installed under ~/.espressif/preview
• Target: esp32s31

Get Started

Flash Thread border router firmware:

. ~/.espressif/preview/export.sh
cd ot_br
idf.py --preview set-target esp32s31
idf.py build flash monitor

Web change

1. Edit frontend

2. Build frontend

cd web && pnpm build

3. Build Firmware incl. UI-Partition and flash

cd ../ot_br && idf.py build flash monitor

4. Browser: (Hard-) Reload

open

http://esp-ot-br.local

Supported Hardware Platforms

Single SoC Module

• ESP32-S31 single SoC (Function-CoreBoard-1, Korvo-1)

Thread end device example

Thread CoAP light

• LED with RGB: https://github.com/mcuw/esp32-thread-coap-light