Home

esp32_balboa_spa Wiki

ESP32 firmware that talks to a Balboa spa controller over RS485: read status, control equipment from the web portal, and publish state over MQTT / Home Assistant.

Full overview (value, parts, setup, features): README · Overview in the main repo.

Last reviewed for firmware: 2.10.0 (see VERSION in the main repo).

---

Canonical docs (versioned with releases)

These live in the main repository and should be treated as the source of truth for build flags, APIs, and release behavior. File links below use the ESP32 branch (GitHub default for this fork); main may lag and return 404 for some paths.

• README — overview, build, M5 wiring, MQTT/HA topics, OTA, compiler flags
• CHANGELOG — release history
• GitHub Releases — tagged snapshots
• OTA + live logging workflow
• FORK.md — fork maintenance and tags

---

Wiki guides

Page	Purpose
Getting started	First-time clone, config.h, flash, verify /status
Hardware targets	Supported vs planned boards, bring-up checklist (e.g. AtomS3)
Troubleshooting FAQ	Symptom → checks → deeper repo links
Home Assistant setup	Broker, discovery, temp units, example automation
Hardware field notes	Community-tested tubs and boards

---

External references (protocol & wiring)

• ccutrer/balboa_worldwide_app wiki — especially physical layer / finding wires
• protocol.md — frame formats and command semantics

---

Contributing to this wiki

• Field reports: Add a row on Hardware field notes (tub model, board, PlatformIO env, outcome).
• Corrections: Edit the wiki page directly, or open an Issue with tub model + board + what you tried.
• Behavior that depends on a firmware release (new MQTT topics, flags, APIs): update the main repo README/CHANGELOG in a PR; link from the wiki, do not duplicate long tables here.