An enhanced firmware for the ATS-Mini SI4732 / ESP32-S3 handheld radio receiver, with a modern LVGL interface, a spectrum + waterfall bandscope, a full HTTP control API, a rich web UI served straight from the device, and an MCP server so an AI agent (Claude Code, OpenAI Codex, …) can drive the radio.
Forked from esp32-si4732/ats-mini (MIT). The entire
radio core (SI4735/SSB/RDS/EIBI/scan/memory/network) is kept — only the TFT_eSPI draw layer was
replaced by a native esp_lcd + LVGL 9 UI, and the new features below were added.
Hardware: ESP32-S3 (WROOM-1-N16R8, 16 MB flash / 8 MB PSRAM) + SI4732, ST7789 320×170 display (8-bit 8080 parallel).
- LVGL UI — anti-aliased typography, a custom Orbitron frequency font, 9 live color themes, an S-unit S-meter, and a left sidebar menu that keeps the frequency visible (great for Seek).
- Bandscope — full-screen spectrum + waterfall (green→amber→red), a tuning cursor, and automatic re-scan as you pan across the band.
- Boot splash and an idle clock screensaver.
- HTTP control API —
tune,mode,band,volume,bandwidth,seek,memory(list/recall/save/clear), a genericsetfor every device setting, andautoscan(sweep the band → store every station to memory). See API. - Web UI in the firmware — the device serves a full control interface from LittleFS; no
external server needed. Themed
/config(WiFi/login/timezone) and a/mcphelper page. - Serial / BLE control (single-char protocol, incl. absolute
F<freq>tune). - Agent control via MCP — the
mcp/server +SKILL.mdlet an agent operate the radio through the HTTP API.
firmware/ ESP-IDF project (Arduino-as-component). main/, components/, data/ (web UI), tools/
mcp/ MCP server (server.py) + SKILL.md + README — agent control over the HTTP API
Just want to flash it? Prebuilt binaries + a flash.sh are in
firmware/prebuilt/ — no build needed.
The firmware is built with ESP-IDF v5.3 (not 5.5+ — arduino-esp32's legacy I2C HAL for IDF < 5.4 is what tolerates the SI4735's clock stretching). Arduino core, LVGL and the async web server come in as managed components.
cd firmware
idf.py set-target esp32s3 # first time only
idf.py buildThe web UI (firmware/data/: index.html, style.css, app.js, mcp.html, SKILL.md) is served from
the littlefs partition. Build the image with littlefs-python:
pip install littlefs-python
python tools/pack_lfs.py data littlefs.bin 0x1d0000 # 0x1d0000 = littlefs partition size# app + bootloader + partition table
esptool --chip esp32s3 -p /dev/ttyACM0 -b 460800 write_flash "@build/flash_args"
# web UI image at the littlefs partition offset (see partitions.csv → 0x610000)
esptool --chip esp32s3 -p /dev/ttyACM0 -b 460800 write_flash 0x610000 littlefs.bin(idf.py flash also works for the app; the LittleFS image must be flashed separately.)
Enable WiFi on the device (Menu → Settings → WiFi); its IP shows in Menu → Settings → About.
All endpoints return the status JSON (or {"error": …}).
| Endpoint | Params |
|---|---|
GET /api/status |
— |
GET/POST /api/tune |
freq=N (band units: FM 10 kHz, AM/SSB kHz) |
GET/POST /api/mode |
dir=up|down |
GET/POST /api/band |
dir=up|down or index=N |
GET/POST /api/volume |
dir=up|down or level=0..63 |
GET/POST /api/bandwidth |
dir=up|down |
GET/POST /api/seek |
dir=next|prev |
GET/POST /api/set |
name=<setting>&dir=up|down (step, squelch, agc, avc, softmute, brightness, calibration, rds, utc, fmregion, theme, ui, sleep, zoom, scroll, …) |
GET /api/memory · POST |
list, or slot=N&action=recall|save|clear&name=… |
GET/POST /api/autoscan |
clear=0|1 — sweep band → memory |
See mcp/README.md. In short: run the ats-mini MCP server (a thin wrapper
over the API), point it at the radio (ATS_MINI_HOST), and register it with your agent. The
device also serves a ready-to-paste prompt at http://<radio-ip>/mcp.
- Forked from esp32-si4732/ats-mini — MIT.
- Bundled Arduino libraries (SI4735, TFT_eSPI, NTPClient) keep their own licenses.
- This project: MIT (see LICENSE).