How axiomantic/esphome-satellite works
esphome-satellite is ESPHome firmware and a Home Assistant integration for voice satellites. The main device workflow captures microphone audio, coordinates voice-assistant state and audio feedback, and uses speaker hardware for playback; the README highlights protections against self-hearing and idle stop-word triggers, plus recovery on pipeline or connection errors. The Home Assistant integration adds conversation, STT, and configurable addressing gatekeepers. Sampled firmware excerpts show microphone buffering and audio output behavior, but not the full state machine or all firmware-to-server wiring; those links are omitted where evidence is unavailable.
Main entry points: client_factory.py Gatekeeper factory · i2s_audio_speaker.cpp I2S speaker · i2s_audio_microphone.cpp I2S microphone · pcm_sound_player.h PCM sound player
Components 22
Voice Supervision
- Voice assistant
components/voice_assistant/voice_assistant.cpp - PCM sound player
src/pcm_sound_player.h - Built-in sound themes
src/sound_data.h
Audio I/O
- Microphone source
components/microphone/microphone_source.cpp - Microphone interface
components/microphone/microphone.h - I2S microphone
components/i2s_audio/microphone/i2s_audio_microphone.cpp - I2S audio core
components/i2s_audio/i2s_audio.h - Speaker resampler
components/resampler/speaker/resampler_speaker.cpp - I2S speaker
components/i2s_audio/speaker/i2s_audio_speaker.cpp - Standard I2S output
components/i2s_audio/speaker/i2s_audio_speaker_standard.cpp - SPDIF output
components/i2s_audio/speaker/i2s_audio_spdif.cpp - SPDIF encoder
components/i2s_audio/speaker/spdif_encoder.cpp
Home Assistant
- Conversation handling
custom_components/esphome_satellite/conversation.py - Speech-to-text
custom_components/esphome_satellite/stt.py - Gatekeeper factory
custom_components/esphome_satellite/client_factory.py - LLM gatekeeper
custom_components/esphome_satellite/llm_client.py - System One client
custom_components/esphome_satellite/systemone_client.py
Board Hardware
- XVF3800 hardware
src/xvf3800_hardware.h - AIC3104 DAC
components/aic3104/aic3104.cpp
Other components
- Voice user
- Home Assistant user
- Inference endpoint
Connections 20
- Voice user → I2S microphone: speaks to
- I2S microphone → Microphone interface: implements
- Microphone source → Microphone interface: reads from
- Voice assistant → Microphone source: buffers audio from
components/voice_assistant/voice_assistant.cpp - I2S microphone → I2S audio core: uses
- Speaker resampler → I2S speaker: writes to
components/resampler/speaker/resampler_speaker.cpp - Standard I2S output → I2S speaker: implements output
- SPDIF output → I2S speaker: uses interface
- SPDIF output → SPDIF encoder: uses encoder
- I2S speaker → Speaker resampler: accepts resampled stream
- PCM sound player → Built-in sound themes: looks up sounds
src/pcm_sound_player.h - PCM sound player → XVF3800 hardware: uses board audio
src/pcm_sound_player.h - AIC3104 DAC → XVF3800 hardware: supports board audio
- Home Assistant user → Conversation handling: starts conversation
- Conversation handling → Gatekeeper factory: creates gatekeeper
custom_components/esphome_satellite/conversation.py - Speech-to-text → Gatekeeper factory: creates gatekeeper
custom_components/esphome_satellite/stt.py - Gatekeeper factory → LLM gatekeeper: selects client
custom_components/esphome_satellite/client_factory.py - Gatekeeper factory → System One client: selects client
custom_components/esphome_satellite/client_factory.py - LLM gatekeeper → Inference endpoint: posts classification
custom_components/esphome_satellite/llm_client.py - System One client → Inference endpoint: posts inference request
custom_components/esphome_satellite/systemone_client.py