Skip to content

Latest commit

 

History

History
24 lines (17 loc) · 2.7 KB

software.md

File metadata and controls

24 lines (17 loc) · 2.7 KB

Installing the Koala firmware

Flashing DFU software to Respeaker Lite

Your Respeaker Lite board comes pre-flashed with some software. However, most probably it's software, built to use the board as external microphone for computer over USB. There's also chance that the flashed firmware is intended for usage over I2S (which we need), but is using 16kHz sample rate (which we don't, as Koala is using 48kHz sample rate for better sound playback).

To flash Respeaker board with correct software, you can use included sowtware (or take same one from official repo) and instructions from Seeed site.

Please re-insert the board after flash and make sure that displayed version is correct one.

Flashing ESPHome configuration to ESP32-S3 board

There's two configurations available: dashboard and factory. Also you will need to copy base config YAML into common directory in your ESPHome root folder. Alternatively, you can copy everything from koala-base.yaml to the chosen config and merge everything inside.

  1. Pick your config:
    • Dashboard YAML will build regular ESPhome device, with your WiFi credentials and without BLE Improv functionality. It will connect to your WiFi automatically and will be available for adding in Home Assistant right away.
    • Factory YAML will build the firmware, similar to the one Voice PE has. It will be able to connect to any WiFi network via BLE Improv, and in case of reconnecting to other WiFi you will have to just reset the device to factory settings. Also this version will receive OTA from this repository. You will see Home Assistant system prompt to update your device once the update is available. Basically set-and-forget option, and the option to choose if you're making the device for a friend/family.
  2. Build the firmware with ESPHome and flash it with your method of choice.

Connecting to Home Assistant

  • I'm sure you already know how to connect ESPHome devices to Home Assistant. If it's your first time, please check the official documentation.
  • In case of Factory firmware you will need to connect the device to the WiFi first. Check Improv docs for details. (When asked to authorize by pressing button on device, use small round button!)
  • The voice satellite onboarding wizard will help you setup the pipeline and wake word.

Happy tinkering!