qnlbnsl / esphome_matrixio

ESPHome Component for MatrixIO Devices

ESPHome MatrixIO

This custom component gives access to the LED-Strip (everloop), microphones and speakers of the Matrixio-Voice within ESPHome.

It allows to use a Matrixio-Voice as a satellite for Home Assistant voice control.

In this first version, only one microphone of the array is used. I might add a beamforming in the near future.

The implementation is based on the example code which MATRIX Labs provides on their project page: https://github.com/matrix-io.

Installation

Prepare Rasperberry PI

Follow "Step 1: Raspberry Pi Setup" of https://matrix-io.github.io/matrix-documentation/matrix-voice/esp32/

Unfortunately, the packages of MATRIX Lab are now longer maintained. Checkout the repository of Kunal Bansal https://github.com/qnlbnsl/Matrix-IO if you run into installation issues, especially with the new Rapsberry PI OS Bookworm.

Build firmware

git clone https://github.com/gnumpi/esphome_matrixio.git
cd esphome_matrixio
source scripts/setup_esphome.sh
esphome compile matrix_voice.yaml

copy .esphome/build/matrixio-voice/.pioenvs/matrixio-voice/firmware-factory.bin to raspberry pi.

Flash ESP32

On raspberry pi:

sudo voice_esp32_enable

voice_esptool --chip esp32 --port /dev/ttyS0 --baud 1500000 --before default_reset --after hard_reset write_flash -u --flash_mode dio --flash_freq 40m --flash_size detect 0x000 firmware-factory.bin