ESP32 Setup

This guide will show you how to get started with the ESP32 module on the MATRIX Voice ESP32 version.

Step 1: Raspberry Pi Setup

Run the following commands inside your Raspberry Pi terminal to install the MATRIX Voice Software. This will keep the FPGA firmware updated and install few tools to flash the ESP-WROOM-32.

Add the MATRIX repository and key.

curl | sudo apt-key add -
echo "deb $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/matrixlabs.list

Update your repository and packages.

sudo apt-get update
sudo apt-get upgrade

Install the MATRIX init package.

sudo apt install matrixio-creator-init

Reboot your Raspberry Pi.

sudo reboot

Step 2: Personal Computer Setup

Here we're installing the requirements needed to allow your pc to develop and compile ESP32 projects.

Install Git:

Install ESP32 toolchain:

Setup ESP-IDF development framework:

Clone MATRIX Voice ESP32 repository

This repository contains the necessary libraries to control the MATRIX Voice's components.

# windows must be using MINGw32 terminal from toolchain step
git clone

Step 3: Build and Deploy

Here we will be deploying and running one of the example apps in the Repository we just downloaded.

Configuring IDF (one time setup):

cd matrixio_hal_esp32/examples/mic_energy/
make menuconfig

You will now be taken to the IDF Configuration screen, as shown above. Once there, select the option to save default configuration.

Running example project:

To finish running the example, all that's left is to make and deploy the code to the Raspberry Pi. This requires the Pi's IP address and you will be prompted to insert the Pi's password as well.

make deploy

Step 4: Finishing Up

Your MATRIX Voice ESP32 should now be running the deployed example. With the program properly flashed in the ESP32, the Voice can now run without the Pi if you choose to do so. Ensure the MATRIX Voice and Pi are not powered before connecting or disconnecting.