Community
Please visit our community support forums at community.matrix.one
Reinstall MATRIX Init Package and Reflash FPGA
If you experience strange behavior, reinstall the MATRIX init package and reflash FPGA.
Uninstall the matrixio-creator-init package.
sudo apt-get --purge remove matrixio-creator-init
Reboot your device.
sudo reboot
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 repository and packages.
sudo apt-get update sudo apt-get upgrade
Install the matrixio-creator-init package.
sudo apt-get install matrixio-creator-init
Reboot your device.
sudo reboot
FPGA will be reflashed with stock firmware.
Now you can flash the FPGA.
Reset the FPGA.
echo 26 > /sys/class/gpio/export 2>/dev/null echo out > /sys/class/gpio/gpio26/direction echo 1 > /sys/class/gpio/gpio26/value echo 0 > /sys/class/gpio/gpio26/value echo 1 > /sys/class/gpio/gpio26/value
Flash the SPI Flash bootloader onto FPGA.
xc3sprog -c matrix_voice blob/bscan_spi_s6lx9_ftg256.bit
You should receive the following.
XC3SPROG (c) 2004-2011 xc3sprog project $Rev: 774 $ OS: Linux Free software: If you contribute nothing, expect nothing! Feedback on success/failure/enhancement requests: http://sourceforge.net/mail/?group_id=170565 Check Sourceforge for updates: http://sourceforge.net/projects/xc3sprog/develop DNA is 0xf9d61a1ecbb64401
Flash the SPI Flash.
xc3sprog -c matrix_voice -I blob/system_voice.bit
You should receive the following.
XC3SPROG (c) 2004-2011 xc3sprog project $Rev: 774 $ OS: Linux Free software: If you contribute nothing, expect nothing! Feedback on success/failure/enhancement requests: http://sourceforge.net/mail/?group_id=170565 Check Sourceforge for updates: http://sourceforge.net/projects/xc3sprog/develop JEDEC: c2 20 0x17 0xc2 Found Macronix MX25L Device, Device ID 0x2017 256 bytes/page, 262144 pages = 67108864 bytes total Verify: Success!
Reset the FPGA.
echo 26 > /sys/class/gpio/export 2>/dev/null echo out > /sys/class/gpio/gpio26/direction echo 1 > /sys/class/gpio/gpio26/value echo 0 > /sys/class/gpio/gpio26/value echo 1 > /sys/class/gpio/gpio26/value
Power off your device.
sudo poweroff
Wait until the green led on your Raspberry Pi blinks 10 times, then unplug the power cable from your Raspberry Pi.
Plug the power cable back into your Raspberry Pi.
Reinstall MATRIX Kernel Modules
If you experience strange behavior, reinstall the MATRIX kernel modules.
Uninstall the matrixio-kernel-modules package.
sudo apt-get --purge remove matrixio-kernel-modules
Reboot your device.
sudo reboot
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 repository and packages.
sudo apt-get update sudo apt-get upgrade
Install the matrixio-kernel-modules package.
sudo apt-get install matrixio-kernel-modules
Reboot your device.
sudo reboot
Check Raspberry Pi GPIO
If you experience strange behavior, check the Raspberry Pi GPIO.
sudo cat /sys/kernel/debug/gpio
You should receive the following.
gpiochip0: GPIOs 0-53, parent: platform/3f200000.gpio, pinctrl-bcm2835: gpio-18 ( |sysfs ) out hi gpio-24 ( |sysfs ) out hi gpio-25 ( |sysfs ) out hi gpio-26 ( |sysfs ) out hi
If sysfs above is replaced with w1, use raspi-config to disable the 1-Wire interface.
sudo raspi-config
Inside raspi-config, navigate to Interfacing Options >> 1-Wire >> NO.
Hardware Tests
These tests will check if your MATRIX Voice is functioning properly.
We first need to install matrixio-creator-init, which handles the flashing of FPGA.
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 repository and packages.
sudo apt-get update sudo apt-get upgrade
Install the MATRIX init package.
sudo apt-get install matrixio-creator-init
Reboot your device.
sudo reboot
Matrix Init Script
After the reboot, run the matrix init script manually.
sudo /usr/share/matrixlabs/matrixio-devices/matrix-init.bash
You should receive the following.
*** MATRIX Voice has a updated firmware *** MATRIX Voice initial process has been launched
FPGA Info
This program checks the fpga info.
sudo /usr/share/matrixlabs/matrixio-devices/fpga_info
You should receive the following.
INFO: [/dev/spidev0.0] was opened FPGA IDENTIFY = 6032bad2 FPGA VERSION = 1000a
If you have the matrixio-kernel-modules installed, you should receive this instead.
INFO: [/dev/matrixio_regmap] was opened FPGA IDENTIFY = 6032bad2 FPGA VERSION = 1000a
FPGA Flash
If you don’t get the proper FPGA info you will need to run the FPGA flashing process.
cd /usr/share/matrixlabs/matrixio-devices/
sudo ./fpga-program.bash
You should receive the following.
*** MATRIX Voice has a updated firmware
If you get **** Could not program FPGA, please contact us.
Test Other Components
Install MATRIX HAL and test other components such as the microphone array using the MATRIX HAL examples.