MATRIX Voice and MATRIX Creator Running Google Assistant

Required Hardware

Before get started, let's review what you'll need.

• Raspberry Pi 3 (Recommended) or Pi 2 Model B (Supported).

• MATRIX Voice OR MATRIX Creator - Raspberry Pi does not have a built-in microphone, the MATRIX Voice & MATRIX Creator each have an 8 mic array - Buy MATRIX Voice or Buy MATRIX Creator.

• Micro-USB power adapter for Raspberry Pi.

• Micro SD Card (Minimum 8 GB) - An operating system is required to get started. You can download Raspbian Stretch and use the guides for Mac OS, Linux and Windows in the Raspberry Pi website.

• External Speaker with 3.5 mm audio cable.

• A USB Keyboard & Mouse, and an external HDMI Monitor - we also recommend having a USB keyboard and mouse as well as an HDMI monitor handy. You can also use the Raspberry Pi remotely, see this guide from Google.

• Internet connection (Ethernet or WiFi)

• (Optional) WiFi Wireless Adapter for Pi 2. Note: Pi 3 has built-in WiFi.

Let's Get Started

Once you have the Raspberry Pi with the SD Card inserted, the MATRIX Voice connected to it, power up the Raspberry Pi and open a terminal either in the Raspbian Desktop or just by ssh into it ( if you are you are using the Raspbian Lite version, in this case see guide on how to ssh here).

1. Installing MATRIX software

In order to allow the Google Assistant software to have access to MATRIX Voice microphones, run the following in your Raspberry Pi's terminal:

Add the MATRIX repository and key.

curl https://apt.matrix.one/doc/apt-key.gpg | sudo apt-key add -
echo "deb https://apt.matrix.one/raspbian $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/matrixlabs.list

Update your packages.

sudo apt-get update
sudo apt-get upgrade

Install the MATRIX packages.

sudo apt install matrixio-creator-init

Reboot your device.

sudo reboot

After rebooting, install the kernel modules.

sudo apt install matrixio-kernel-modules

Reboot your device for a second time.

sudo reboot

2. Set up Google Assistant

In this step you will setup all the required software to finally run the Assistant. Make sure you are in the /home/pi directory before starting.

Follow the guides in the links below :

• Configure Google Developer Project

• Register the Device Model

• Install the Google Assistant SDK and Sample Code

3. Get code to use the Everloop

Install git on your Raspberry Pi if you don't already have it.

sudo apt-get install git

Download our MATRIX Google Assistant repository.

git clone https://github.com/matrix-io/google-assistant-matrixio.git
cd google-assistant-matrixio/

4. Run the Google Assistant!

Now you are ready. Just run the following line making sure you put your project id and device model id from previous steps:

~/google-assistant-matrixio/google-matrixio-assistant-hotword --project_id your-dev-project-id --device_model_id your-model-id

The output should be like this:

(Ignore the "Cloud discovery ..." errors, this is an open issue of the google assistant sdk that will be removed in next releases):

(env) pi@raspberrypi:~ $ ~/google-assistant-matrixio/google-matrixio-assistant-hotword --project_id your-dev-project-id --device_model_id your-model-id
device_model_id: your-model-id
device_id: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
https://embeddedassistant.googleapis.com/v1alpha2/projects/your-dev-project-id/devices/XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 403
[3140:3159:ERROR:assistant_nupnp_client.cc(103)] Cloud discovery nupnp request failed: [60] Peer certificate cannot be authenticated with given CA certificates
[3140:3159:ERROR:assistant_nupnp_client.cc(103)] Cloud discovery nupnp request failed: [60] Peer certificate cannot be authenticated with given CA certificates
EventType.ON_MUTED_CHANGED
EventType.ON_START_FINISHED
[3140:3159:ERROR:assistant_nupnp_client.cc(103)] Cloud discovery nupnp request failed: [60] Peer certificate cannot be authenticated with given CA certificates 

Now you can talk to the Assistant starting with "OK Google" or just "Hey Google!"