Voice Assistant Guide
This page is for UltimateSensor Mini v1, which includes a microphone, speaker, media player and voice-assistant support.
Have Mini v2? Mini v2 has no microphone, speaker, media player or local wake word support. Use UltimateSensor Mini v2 for that hardware.
Standard Voice Pipeline
UltimateSensor Mini v1 uses the standard Home Assistant voice pipeline. The device captures the voice command, sends it to the selected Home Assistant assistant pipeline, and plays the response back through its media player.
- Follow the Home Assistant voice control documentation.
- Create or select your Home Assistant voice assistant pipeline.
- Open the UltimateSensor Mini v1 device in Settings -> Devices & services -> ESPHome.
- Select the Home Assistant assistant pipeline you want to use.
Local Wake Word
Local wake word support for UltimateSensor Mini v1 is included in production firmware 3.0 and newer. The firmware includes the wake words Okay Nabu and Hey Jarvis.
- Open the firmware page: smarthomeshop.io/en/firmware?product=ultimatesensor-mini.
- Install the matching Mini v1 Basic or Complete firmware. Devices on version 2.42 or older first need the one-time Version 3.0 USB-C upgrade.
- Add the device back to Home Assistant if needed.
- Keep the
Enable Voice Assistantswitch on. It is on by default.
If the Enable Voice Assistant switch is not visible, update the device to Mini v1 production firmware 3.0 or newer.
Troubleshooting
- Confirm that the Mini v1 hardware has microphone and speaker.
- Check that the media player entity exists.
- Confirm Mini v1 production firmware 3.0 or newer is installed if you want local wake word.
- Check the
Enable Voice Assistantswitch. - Verify that Home Assistant voice services are running.
- Check ESPHome logs for audio or voice assistant errors.
Front Light During Voice Use
| Front light | Meaning |
|---|---|
| Yellow animation | Waiting for Home Assistant |
| Blue, pulsing | Listening |
| Purple, fast pulsing | Thinking |
| Green | Speaking the response |
| Orange, with a spoken message | The voice pipeline is not available |
| Red | Error |
Current Voice Product
For new purchases, use the regular UltimateSensor v2 if you need voice assistant hardware.