RecoveryGateway

Hardware

ESP32-S3 N16R8 or N8R8 board with USB-C power, optional microSD and optional W5500 SPI Ethernet.
Reference target and optional modules.

The firmware runs on an ESP32-S3 with 8 MB octal PSRAM and at least 8 MB of quad flash: N8R8 and N16R8 modules. One image serves both; a 16 MB board uses the first 8 MB.

Buy the tested board

The gateway is developed and tested on the ESP32-S3-DevKitC-1 N16R8 (16 MB flash, 8 MB octal PSRAM). If you do not have a board yet, these are the ones used for development:

ESP32-S3-DevKitC-1 N16R8 on Amazon (1) ESP32-S3-DevKitC-1 N16R8 on Amazon (2)

For a wired connection: an ESP32-S3 board with built-in Ethernet and a PoE module. ESP32-S3 with Ethernet and PoE on Amazon

Ethernet support (W5500) is experimental and not yet validated on real hardware; check that the board has 8 MB octal PSRAM (R8) and at least 8 MB of flash, and set its W5500 pins under Network → Ethernet.

Affiliate links: buying through them supports the project at no extra cost to you. As an Amazon Associate I earn from qualifying purchases. Any supported board below works.

Supported ESP32-S3 boards

BoardFlash · PSRAMStatus
ESP32-S3-DevKitC-1 N16R8, ESP32-S3-WROOM-1/1U-N16R816 MB quad · 8 MB octalTested (reference board)
ESP32-S3-DevKitC-1 N8R8, ESP32-S3-WROOM-1/1U-N8R88 MB quad · 8 MB octalSame flash layout; hardware validation pending
Freenove ESP32-S3-WROOM N8R8 / N16R88–16 MB · 8 MB octalSupported; community-confirmed on earlier firmware
Seeed XIAO ESP32S3 (8 MB flash, 8 MB PSRAM)8 MB · 8 MB octalSupported; community-confirmed on earlier firmware

The module marking tells you the variant: N is the flash and R the PSRAM in MB. You need N8 or more and R8.

Not supported

Requirements

SoCESP32-S3 (dual core, 2.4 GHz WiFi)
MemoryAt least 8 MB quad flash, 8 MB octal PSRAM (N8R8 or N16R8)
PowerReliable USB supply, separate from the machines it should wake
OptionalmicroSD card for the log flight recorder

Community reports for other ESP32-S3 boards are collected in docs/HARDWARE.md; please add yours with the Hardware report issue form.

W5500 Ethernet and cellular (experimental)

From 3.0.25 a USB LTE modem, a 4G stick, a USB Ethernet adapter or phone tethering can also use the board's USB port. The board does not power that port: read USB modems, sticks and Ethernet adapters before plugging anything in.

The standard firmware image includes a driver for an explicitly wired W5500 SPI module: off until configured, explicit pins, DHCP or static IPv4, WiFi-first or Ethernet-first. It is host-tested only and not validated on real hardware; wire it as documented in docs/ETHERNET.md, or use an ESP32-S3 board with built-in Ethernet and PoE (see above). A UART cellular modem with a SIM can be used as a primary or failover uplink, also off until configured and not yet tested with a real modem (docs/CELLULAR.md).

Single radio

The uplink and the access point share one 2.4 GHz radio and channel. After a roam to a different channel the device realigns the AP, which briefly interrupts AP clients.

Support Mattboxx Edition

Enjoying the gateway? Choose where to leave a tip or support its development.

GitHub SponsorsSupport via GitHub Ko-fiLeave a tip on Ko-fi

Entirely optional. The firmware and all features stay free. Payments are handled on your chosen provider's website.