ESPHome MatrixIO

Target: ESPHome-2023.12.9

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.

Now it is also possible to use the Matrixio-Voice as a media player for Home Assistant. Configuration files can be found in the 'examples' folder.

Right now, only one microphone of the array is used. I might add a beamforming in the future.

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

Installation

Prepare Raspberry 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

Configuration

esp32:
  board: esp32dev
  framework:
    type: esp-idf
    version: recommended

spi:
  clk_pin:  GPIO32
  mosi_pin: GPIO33
  miso_pin: GPIO21

matrixio:
  id: matrixio_dev
  cs_pin: GPIO23

light:
  - platform: matrixio
    name: everloop
    id: everloop

microphone:
  - platform: matrixio
    id: matrixio_mic

speaker:
  - platform: matrixio
    id: matrixio_speaker
    # [headphone,speakers], default: headphone
    audio_out: headphone
    # 0..100, in percent, default: 80
    volume: 90