atom-voices3r-ha-guide/docs/build-plan.md
2026-09-13 23:35:28 +02:00

56 lines
2.2 KiB
Markdown

# Bouwplan: ATOM VoiceS3R als HA-voice-satelliet
## Waarom dit board
ESP32-S3-PICO-1-N8R8 met 8 MB PSRAM: genoeg voor on-device wake word
(microWakeWord, "Okay Nabu"). ES8311-codec, MEMS-mic, NS4150B + 1 W
speaker, plus IR-zender als bonus.
## Stap 1 — Voice-pipeline in Home Assistant (eenmalig)
STT + TTS achter Assist. Twee routes:
- **HA OS / Supervised:** add-ons *Whisper* + *Piper* (Instellingen →
Add-ons). Whisper-model **small** of **medium** voor Nederlands
(tiny/base is te zwak). Bij Piper een `nl_*`-stem downloaden.
openWakeWord-add-on is **niet** nodig (wake word draait on-device).
- **HA Container:** `rhasspy/wyoming-whisper` en `rhassmy/wyoming-piper`
als Docker-containers, daarna als Wyoming-integraties toevoegen.
Daarna: Instellingen → Spraakassistenten → Assist-pipeline met NL als
taal, Whisper als STT, Piper als TTS.
## Stap 2 — ESPHome-firmware
ESPHome Builder-add-on installeren + in zijbalk. Nieuw device, naam
`atom-echos3r-voice-assistant`, ESP32-S3, board `esp32s3box`.
Gegenereerde API-key kopieren en de YAML uit
`../esphome/atom-echos3r-voice-assistant.yaml` gebruiken (drie
placeholders invullen: API-key, OTA-wachtwoord, wifi via secrets).
## Stap 3 — Flashen
USB-C **datakabel**. Reset ingedrukt houden tot groene LED brandt, dan
loslaten (= download mode). In ESPHome op Install → bij voorkeur
*manual download* (factory-format) → flashen via https://web.esphome.io
→ resetten. Eerste compilatie duurt lang; normaal.
## Stap 4 — Koppelen en testen
Na reboot: discovery onder Instellingen → Apparaten → ESPHome →
toevoegen → NL-pipeline selecteren. Test: "Okay Nabu, doe het licht in
de woonkamer aan". Geen wake word: eerst pipeline/add-ons checken, pas
daarna aan YAML komen. Ziet de browser het board niet: kabel (data!),
download mode, serial-permissies.
## Stap 5 — Eerste automatisering
Zie `../automations/s3r-rooktest.yaml`: gesproken melding bij
zonsondergang als rooktest. Daarna uitbreiden: deurbel, wasmachine-klaar
via stekker-vermogen, WAN-IP-wissel, etc.
## Volgorde-advies
Pipeline (stap 1) eerst testen met de browser-mic in HA, dan pas
flashen. Zo weet je bij problemen zeker dat het aan het board ligt en
niet aan Whisper/Piper.