WARNING! In my opinion the hardware drivers of the Cirrus Logic Audio Card never left an experimental state and the card is not usable in production. It's an odyssey to put it into operation on a Raspberry Pi 2. Here's a summary about the current state, pointing to useful resources and providing a tutorial to get the card up and running with Debian Jessie.
[UPDATE 2015/09/01] Updated installation instructions for the devicetree drivers. Thanks to HiassofT.
- The audio card does not work out of the box on a Raspberry Pi 2 (at least until 2015/08/31).
- Official documentation is served as a PDF file but PDF is not the web.
- No social media channel from Cirrus Logic found which provides frequent update for users.
- Useful information can be found in the Element14 community forum, but IMO it is hidden through bad UX.
- Build instructions from the official Cirrus repository are outdated in a few places.
- A lot of frustration in the web.
- A summary would save other peoples time and work.
Credits go the the brave authors and contributors who shared their knowledge and code.
The Cirrus Logic Audio
The Cirrus Logic Audio Card is a high quality sound card (24-bit, 192kHz) and comes with analogue line-in/-out, SPDIF in/out and an onboard stereo microphone. It connects to the 40-pin GPIO of the Raspberry Pi 2.
But it doesn’t fit into my case…
Craig Berscheidt from Built-to-Spec has designed a custom case. He fortunately provides the design files at thingiverse and the corresponding assembly instructions at the Built-to-Spec blog. If you don’t have a laser cutter, just buy your case at the Built-to-Spec store.
Since RPi 2 has the same form factor as RPi B+, the case from Built-to-Spec fits. The PCB clips are a bit brittle, be careful when snapping them onto the Raspberry Pi.
And then it says: no soundcards found…
You plugged everything in and together, installed a raspbian image to your sd card, but…
~ $ aplay -l aplay: device_list:268: no soundcards found...
or anything but the cirrus soundcard:
~ $ aplay -l **** List of PLAYBACK Hardware Devices **** card 0: ALSA [bcm2835 ALSA], device 0: bcm2835 ALSA [bcm2835 ALSA] ... card 0: ALSA [bcm2835 ALSA], device 1: bcm2835 ALSA [bcm2835 IEC958/HDMI]
Installing Debian Jessie
One of the benefits of Raspberry Pi 2 is, that it comes with an ARMv7 processor architecture. ARMv7 is widely supported by linux distributions and it doesn’t require prebuilt Raspbian packages. For Debian, the port of your choice is called armhf (arm hardfloat port) often refered to as “EABI hard-float ABI”.
Sjoerd Simons from Collabora provides prebuild Debian Jessie images for Raspberry Pi 2. The documentation can be found in a blog post.
However, I did not manage to boot a custom kernel with Cirrus support on that image. Therefore I suggest to install the official Raspbian image first and then upgrade to Jessie by following the upgrade instruction in the Jessie release notes.
If you feel unfamiliar with the following steps, please follow the upgrade instructions mentioned above. This section comes with no warranty:
- Go to
/etc/apt/and replace any occurences of
- Remove the configuration file
/etc/apt/sources.list.d/collabora.list. It’s a repo for a lightweight browser which was optimized for the limited resources of the Raspberry Pi 1. Collabora does not provide builds for Jessie and I guess you don’t need this browser on Raspbery Pi 2.
Execute the following commands as root or using
apt-get update apt-get upgrade apt-get dist-upgrade
This will probably take some time. For some packages you will be ask to choose a particular configuration file. If you just started with a fresh installation, you can safely answer “Yes” to any of these questions and install the configuration from the maintainers package.
- Now reboot your machine.
Building and installing the drivers for the Cirrus Logic Audio Card
Now to the nasty part. The kernel module from Cirrus has not made it into the official kernel repository. You have to build it by yourself. The fork from HiassofT is currently the most active and recent one. The following instructions are based on a forum post on element14 by HiassofT:
apt-get install screen bc screen git clone -b cirrus-4.1.y --single-branch --depth 1 https://github.com/HiassofT/rpi-linux.git cd rpi-linux/ make bcm2709_defconfig && make -j4 && make -j4 modules
[CTRL a] + d to quit your console session and let your Raspberry work hard in the background.
After half a day, get back to your session and install the build:
screen -r sudo make modules_install sudo cp /boot/kernel7.img /boot/kernel7.img.orig-bak sudo ./scripts/mkknlimg arch/arm/boot/zImage /boot/kernel7.img sudo cp -f arch/arm/boot/dts/*.dtb /boot/ sudo cp -f arch/arm/boot/dts/overlays/*.dtb arch/arm/boot/dts/overlays/README /boot/overlays/
Add the following lines to
And add the following lines to
softdep arizona-spi pre: arizona-ldo1 softdep spi-bcm2708 pre: fixed softdep spi-bcm2835 pre: fixed softdep snd-soc-wm8804-i2c pre: snd-soc-rpi-wsp-preinit softdep snd-soc-rpi-wsp pre: snd-soc-wm8804-i2c # To disable the buildin soundcard, also blacklist the `snd_bcm2835` module blacklist snd_bcm2835
Protect your kernel from being overridden by upgrades of the the bootloader packages when running
sudo apt-mark hold raspberrypi-bootloader
Reboot your Raspberry Pi.
Testing the audio card
Login, open a terminal and execute the following command:
~ $ aplay -l card 1: sndrpiwsp [snd_rpi_wsp], device 0: WM5102 AiFi wm5102-aif1-0  Subdevices: 1/1 Subdevice #0: subdevice #0
Then create a mixer setup. Cirrus provides some convenience scripts to preconfigure mixer settings. You can download the scripts from the CirrusLogic repository.
After unpacking, activate the line-out channel by executing:
Connect your stereo to the green audio jack and start your favorite music player.
Way too complicated. Anything more easy?
Go and kick Cirrus to provide bug free drivers for their audio card through the official raspberry kernel. It’s a shame they announce compatibility with Raspberry Pi 2 but don’t provide drivers for anyone except experienced kernel hackers. Their prebuild system image is not an option, because it probably breaks on upgrades.
There are some Debian packages to install a pre-build kernel + modules by autostatic. However there’s neither a build provided for Debian Jessie nor some source packages available. Not sure if you receive kernel updates through this repo at all… (I found that in the middle of an element14 forum post)
If you sell hardware for Raspberry Pi, …
- provide stable drivers through the offical raspberrypi linux kernel repository,
- provide a case if it does not fit into the usual cases,
- support your community with official updates, documentation and discussions,
- add an issue tracker to your source code repository,
- and don’t fool your customers with bad promises about compatibility.