Skip to content

About

Enhanced ATS-Mini (SI4732 / ESP32-S3) radio firmware — LVGL UI, spectrum + waterfall bandscope, HTTP/BLE control API, on-device web UI, and an MCP server for AI-agent control.

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ATS-Mini Pro

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).

Features

  • 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 generic set for every device setting, and autoscan (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 /mcp helper page.
  • Serial / BLE control (single-char protocol, incl. absolute F<freq> tune).
  • Agent control via MCP — the mcp/ server + SKILL.md let an agent operate the radio through the HTTP API.

Repository layout

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

Build & flash

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 build

LittleFS web-UI image

The 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

Flash (ESP32-S3 on /dev/ttyACM0)

# 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.)

HTTP control API

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

Agent control (MCP)

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.

Credits & license

  • Forked from esp32-si4732/ats-mini — MIT.
  • Bundled Arduino libraries (SI4735, TFT_eSPI, NTPClient) keep their own licenses.
  • This project: MIT (see LICENSE).

About

Enhanced ATS-Mini (SI4732 / ESP32-S3) radio firmware — LVGL UI, spectrum + waterfall bandscope, HTTP/BLE control API, on-device web UI, and an MCP server for AI-agent control.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages