Respeaker-Lite-ESPHome-integration

KO | EN

gitlite — search

#javascript #llm #go #golang #android #machine-learning #docker #java #cli #kubernetes #awesome-list #pytorch #mcp #open-source

Respeaker-Lite-ESPHome-integration

(★ 240)

No description available.

File Explorer

Download Latest Version (.zip)

- FUNDING.yml
- - Applicator.step
  - Board bracket.step
  - Button Action.step
  - Button Mute.step
  - Face plate.step
  - Grill.step
  - LED cover.step
  - Main casing.step
  - Power LED cover.step
- Casing.md
- step_10_insert_to_main_casing.png
- step_11_screw_main_casing.png
- step_1_face_plate.png
- step_2_face_plate_back.png
- step_3_face_plate_with_led_covers.png
- step_4_face_plate_with_respeaker.png
- step_5_add_respeaker_bracket.png
- step_6_add_speaker.png
- step_7_glue_grill.png
- step_8_glue_buttons.png
- step_9_main_casing.png
- - respeaker-satellite-base.yaml
- respeaker-satellite-dashboard-example.yaml
- alarms.md
- blueprints.md
- tts_uri.md
README.md
respeaker_lite_i2s_dfu_firmware_48k_v1.1.0.bin

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

### _Check out [Koala Satellite](https://github.com/formatBCE/Koala-Satellite), the next step of evolution for this project!_

[!["Buy Me A Coffee"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://www.buymeacoffee.com/formatbce)

## What is it
This repository contains example code to integrate Seeed Respeaker Lite Voice Kit (with XIAO ESP32-S3 on board) with ESPHome.
I'm thankful for continuous help of ESPHome team and Seeed developers, that let me put this thing together. 
It's using [official code for Voice Preview Edition by ESPHome team](https://github.com/esphome/home-assistant-voice-pe), as well as firmware and guides from [Seeed Wiki](https://wiki.seeedstudio.com/xiao_respeaker/) and [their repository for Respeaker](https://github.com/respeaker/ReSpeaker_Lite/tree/master).

## *Disclaimer
### Use this on your own risk. Expect breaking changes.
Although Voice PE is released, parts of its code are still under active development. I will try to update YAML and XMOS board firmware as soon as i can, but it can't be instantenuous...
If you encounter a problem, before creating ticket here you may go to PE and Seeed repos, linked above, and see if something changed there. I'll gladly accept pull-requests. :)

## Why?
I completely abandoned proprietary assistants in the Summer of 2024 and fully committed to Assist all-hands.
With this board i finally can build device, that will satisfy me and (more important) my family as their trusted voice assistant.

## What to do with it?
__* Thanks to Mike aka @mikey60 and his fork to nabu_microphone, this project is using 48kHz sample rate for better music playback quality.*__
1. Get Respeaker Lite with ESP32 soldered to it (you may solder it yourself, pins on the back can remain dry, they're not used).
2. [Solder USR to D2 and MUTE to D3 pins](https://wiki.seeedstudio.com/respeaker_button/). _**ATTENTION! This step is mandatory, as without it the buttons on satellite won't work as intended.**_
3. [Flash 48kHz I2S firmware of version **not lower than 1.1.0** to the XMOS board](https://wiki.seeedstudio.com/xiao_respeaker/#flash-the-i2s-firmware) (pay attention to USB port, you need the main board port, not ESP32 one). Make sure you're using 48kHz version, as 16kHz version won't work with this repo. You can use included [firmware file](/respeaker_lite_i2s_dfu_firmware_48k_v1.1.0.bin) to be sure.
5. Flash ESPHome firmware (YAML included, adjust `/config/respeaker-satellite-dashboard-example.yaml` to your needs) to ESP32 (use its port).
6. Add device to Home Assistant.

### Here are also some [useful blueprints to use with your satellite](readme/blueprints.md)

## Current abilities
The device has feature parity with Voice PE. Pretty much everything works same way, except volume control (solved in [Koala Satellite](https://github.com/formatBCE/Koala-Satellite)).
There are some additional things i've added for convenience:
- switches to turn off button sounds, mute/unmute sounds;
- sensors for next device timer properties (time is updated once per 5 sec, name is available if set);
- TTS URI event `esphome.tts_uri`, sent to Home Assistant every time there's voice response (check out example automation to redirect response to other media player [here](readme/tts_uri.md));
- STT text event `esphome.stt_text`, sent every time there's text of response available (you may use it to display readable response on your dashboard, for example);
- daily alarm functionality, read more on it [here](readme/alarms.md).

## DFU software auto-update
Since version 2025.2.2, the firmware includes corresponding DFU firmware for Respeaker Lite board. On first start after update, new firmware will be installed to Respeaker automatically. You will see Respeaker LED flashing yellow, while installing, and green on successful install. So now there's no need to update DFU firmware. Woohoo!

### Casing
I made some casing to improve family approval factor. [Check it out.](casing/Casing.md)

[!["Buy Me A Coffee"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://www.buymeacoffee.com/formatbce)

Respeaker-Lite-ESPHome-integration

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Respeaker-Lite-ESPHome-integration

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README