Start by making sure you've installed I2C support, see the previous page (Blinka Setup) on how to do it!

Install Voicecard software

Make sure you've got the BrainCraft HAT or Voice Bonnet installed, and I2C support installed as well!

When you run sudo i2cdetect -y 1

you should see an entry under 1A, indicating the hardware sees the audio card. The number may also appear as UU if you already installed software

At the command line run:

Depending on your kernel version, you may need to change your branch. You can check your kernel version by typing uname -r.

If your kernel version is around 5.4, use the following:

  • git checkout v5.5
  • sudo ./

If your kernel version is 5.10 or higher, use the following:

  • git checkout v5.9
  • sudo ./

At the end you should see something like this:

Reboot with

sudo reboot

and on reboot run

sudo aplay -l

To list all sound cards, you should see it at the bottom

On a Raspberry Pi 4, your card number may be Card 2 instead of 1 because of the second HDMI port. You'll need to make some changes to some of the commands to reflect this further down.

If your card number differs from the above image, take note of your number.

You can use alsamixer to adjust the volume, dont forget to select the card with F6

A gain of about 60% is plenty loud!

Headphone/Speaker Test

Make sure the Audio On/Off switch is set to ON!

With either headphones plugged into the headphone jack or a speaker attached to the speaker port, run

speaker-test -c2

you will hear white noise coming out of the speakers/headphones!

If you don't hear anything, make sure you have the audio on/off switch set!

Microphone Test

There are two microphones, and now we can test that they work. This test is best done with headphones, not using the speaker port, because it can cause a painful feedback effect if the speakers are next to the mics!


sudo arecord -f cd -Dhw:1 | aplay -Dhw:1

If your sound card ID is not #1, then replace the number in both of the -Dhw: parameters with your actual number.

Then either gently rub each microphone, or speak to hear yourself echoed!

Control-C to quit when done

Your audio subsystem is now completely tested!

This guide was first published on Oct 28, 2020. It was last updated on Oct 28, 2020.

This page (Audio Setup) was last updated on Oct 15, 2021.

Text editor powered by tinymce.