AB8SS integreren met Home Assistant via ESPHome: een complete gids
Veel gebruikers van de AB8SS audio‑switch lopen vroeg of laat tegen hetzelfde probleem aan: het apparaat werkt betrouwbaar, maar de seriële aansturing is… eigenzinnig. Het protocol verwacht exacte byte‑reeksen, echo’s, en reageert alleen correct als je de juiste state‑machine gebruikt. Standaard integraties werken daarom vaak niet of slechts half.
In deze blog laat ik zien hoe je de AB8SS volledig en stabiel kunt integreren met Home Assistant via ESPHome, inclusief een robuuste YAML‑configuratie die alle protocol‑eigenaardigheden netjes afhandelt.
Deze oplossing is ontwikkeld, getest en verfijnd met echte hardware — en werkt 100% betrouwbaar.
Waarom de AB8SS lastig is om aan te sturen
De AB8SS gebruikt een seriële interface met een aantal bijzonderheden:
- Elke opdracht moet exact worden opgebouwd uit 4 bytes
- Het apparaat stuurt een echo terug dat byte‑voor‑byte moet worden gevalideerd
- Pas daarna volgt een status‑antwoord
- Het apparaat accepteert geen nieuwe opdrachten zolang de vorige niet volledig is afgerond
- Foutafhandeling is noodzakelijk om vastlopers te voorkomen
Veel implementaties falen omdat ze deze stappen niet strikt volgen.
Daarom hebben we een state‑machine gebouwd die:
- elke byte valideert
- timeouts afhandelt
- commando’s in een wachtrij zet
- de AB8SS nooit overspoelt
- altijd in sync blijft met het apparaat
De oplossing: een robuuste ESPHome‑configuratie
De YAML‑configuratie die we hebben ontwikkeld bevat:
- Een UART‑configuratie met correcte baudrate en framing
- Een state‑machine die echo’s en antwoorden valideert
- Een command‑queue zodat Home Assistant meerdere opdrachten kan sturen
- Sensors die de actuele status van alle zones en bronnen teruggeven
- Switches en selects om zones en inputs te bedienen
- Volledige foutafhandeling en automatische recovery
Deze configuratie maakt de AB8SS net zo betrouwbaar als een native Home Assistant‑integratie.
Hoe het werkt (conceptueel)
- Home Assistant stuurt een opdracht (bijv. “Zone 3 → Input 2”).
- ESPHome zet het commando in een wachtrij.
- De state‑machine stuurt de 4 bytes naar de AB8SS.
- De AB8SS stuurt een echo terug → ESPHome valideert elke byte.
- Daarna stuurt de AB8SS een statusbericht.
- De state‑machine verwerkt het antwoord en werkt de entiteiten bij.
- Pas daarna wordt het volgende commando verstuurd.
Dit voorkomt dat de AB8SS “out of sync” raakt — een veelvoorkomend probleem.
De YAML‑configuratie
Klik deze link om de yaml file te downloaden
Hoe de state‑machine werkt
De kern van de oplossing is een compacte maar krachtige state‑machine die:
1. Een commando uit de queue haalt
Bijvoorbeeld: 050001FA* → Zone 1 aan
2. Een ATTENTION‑byte (!) stuurt
De AB8SS antwoordt met ! als hij klaar is.
3. Elke byte van het commando stuurt
En wacht op de echo.
4. Echo valideert
Als de echo niet klopt → retry Na 5 mislukte pogingen → abort
5. Statusframe verwerkt
Bijvoorbeeld: 84xxxxxx* → bitmask van alle zones + input
6. Home Assistant‑entiteiten bijwerkt
Elke zone wordt direct geüpdatet.
7. Automatisch een statuspoll plant
Zodat Home Assistant altijd synchroon blijft.
Home Assistant entiteiten
De YAML maakt automatisch de volgende entiteiten aan:
Zones (switches)
- Zone 1 t/m Zone 8 → aan/uit
Inputselectie (switch)
- Input A/B
Debug‑modus
- Logt alle RX/TX bytes in realtime
Waarom deze implementatie uniek is
Deze oplossing:
- werkt met echte echo‑validatie
- heeft retry‑logica
- voorkomt dat de AB8SS “out of sync” raakt
- gebruikt een command‑queue zodat Home Assistant meerdere opdrachten tegelijk kan sturen
- verwerkt statusframes en houdt Home Assistant realtime up‑to‑date
- bevat timeouts en foutafhandeling
- is volledig ESPHome‑native (geen custom component nodig)
Dit is de meest complete en betrouwbare AB8SS‑integratie die momenteel beschikbaar is.
Installatie‑stappen
Flash een ESP32 met ESPHome
Sluit de AB8SS aan via UART op de ESP32
Ik gebruik hiervoor een RS232 naar TTL module, zoals bijvoorbeeld deze.
En een D1 Mini Live ESP32.
- TX → RX
- RX → TX
- GND → GND
Upload de YAML
Voeg het apparaat toe aan Home Assistant
Bedien zones en inputs direct vanuit HA
Gebruik debug‑modus om communicatie te monitoren
Conclusie
De AB8SS is een fantastisch apparaat, maar het protocol vraagt om een zorgvuldige implementatie. Met deze ESPHome‑configuratie kun je de AB8SS volledig integreren in Home Assistant, zonder instabiliteit of half werk.
Deze oplossing is:
- robuust
- getest
- onderhoudsvrij
- volledig lokaal
- makkelijk uit te breiden
State‑machine diagram voor de AB8SS‑implementatie
┌──────────────────────────┐
│ IDLE │
│ - Geen actief commando │
│ - Queue check │
│ - Poll timer check │
└───────────┬──────────────┘
│
▼
┌──────────────────────────┐
│ ATTENTION_SEND │
│ TX: "!" │
│ Deadline = now + 100ms │
└───────────┬──────────────┘
│
▼
┌──────────────────────────┐
│ ATTENTION_WAIT │
│ Wacht op RX: "!" │
│ Timeout → ABORT │
└───────────┬──────────────┘
│
▼
┌──────────────────────────┐
│ CMD_SEND │
│ TX: current_cmd[pos] │
│ Deadline = 5–10ms │
└───────────┬──────────────┘
│
▼
┌──────────────────────────┐
│ CMD_WAIT │
│ Wacht op echo │
│ Echo OK → pos++ │
│ Echo NOK → "-" + ABORT │
└───────────┬──────────────┘
│
▼
┌──────────────────────────┐
│ DONE │
│ - Command klaar │
│ - Poll in queue │
│ - next_allowed = +50ms │
└───────────┬──────────────┘
│
▼
┌──────────────────────────┐
│ ABORT │
│ - Retry tot 5x │
│ - Daarna drop │
│ - next_allowed = +300ms │
└──────────────────────────┘Behuizing
De ESP32 en uart zijn eventueel in een 3D geprinte behuizing te plaatsen
