Outcome
Deploy and validate a Wyoming satellite endpoint from OS prep through service startup and voice verification.
Audience and Scope
Audience: Home automation builder with intermediate Home Assistant and Docker experience
Estimated Time: 1-4 hours
Difficulty: intermediate
Before You Start
- Target device provisioned and network reachable.
- Audio hardware connected and recognized.
- Home Assistant Wyoming integration enabled.
Hardware and Software
Hardware
- Satellite hardware (Pi-class host or equivalent).
- Wyoming satellite package/service.
- Configured STT/TTS pipeline in Home Assistant.
Software
- Satellite hardware (Pi-class host or equivalent).
- Wyoming satellite package/service.
- Configured STT/TTS pipeline in Home Assistant.
Step-by-Step
Step 1: Prepare OS and audio stack
Objective: Update OS, enable required interfaces, and verify microphone/speaker devices.
Actions:
- Implement prepare os and audio stack according to your environment.
Verification:
- Confirm expected state in Home Assistant and logs.
- Run a manual test to verify expected behavior.
Common failure and fix: If no audio input: verify capture device index and permissions.
Step 2: Install Wyoming satellite
Objective: Install runtime dependencies and satellite service package.
Actions:
- Implement install wyoming satellite according to your environment.
Verification:
- Confirm expected state in Home Assistant and logs.
- Run a manual test to verify expected behavior.
Common failure and fix: If no audio input: verify capture device index and permissions.
Step 3: Configure service
Objective: Set server endpoint, wake behavior, and audio device mappings.
Actions:
- Implement configure service according to your environment.
Verification:
- Confirm expected state in Home Assistant and logs.
- Run a manual test to verify expected behavior.
Common failure and fix: If no audio input: verify capture device index and permissions.
Step 4: Run local audio tests
Objective: Record and play back samples to confirm quality.
Actions:
- Implement run local audio tests according to your environment.
Verification:
- Confirm expected state in Home Assistant and logs.
- Run a manual test to verify expected behavior.
Common failure and fix: If no audio input: verify capture device index and permissions.
Step 5: Register in Home Assistant
Objective: Add endpoint and bind to the intended voice pipeline.
Actions:
- Implement register in home assistant according to your environment.
Verification:
- Confirm expected state in Home Assistant and logs.
- Run a manual test to verify expected behavior.
Common failure and fix: If no audio input: verify capture device index and permissions.
Step 6: Validate intents
Objective: Test lighting/media intents and confirm response latency.
Actions:
- Implement validate intents according to your environment.
Verification:
- Confirm expected state in Home Assistant and logs.
- Run a manual test to verify expected behavior.
Common failure and fix: If no audio input: verify capture device index and permissions.
Validation Checklist
- Device stays connected to Wyoming service.
- Audio capture/playback quality acceptable.
- Core intents execute reliably.
Operations and Maintenance
- Document update cadence for packages and containers.
- Schedule backup verification.
- Record service health baselines and alert thresholds.
Troubleshooting and Rollback
- If no audio input: verify capture device index and permissions.
- If no output: verify speaker device selection and ALSA/Pulse config.
- If frequent disconnects: pin service versions and set restart policy.