pisound is compatible with virtually all Linux distributions and software as it comes with an ALSA audio and MIDI driver integrated in mainline Raspbian Linux kernel (ver. 4.4.27+). The support driver for pisound consists of two pieces - the Linux kernel module and user-space pisound-btn daemon.
The pisound button daemon is a user space program which implements monitoring of The Button on the board by registering a GPIO interrupt handler. Therefore it takes minimal CPU resources, but is still able to react to button pushes just at the moment it was interacted with. Read more on The Button functionality below.
Installing The Driver
To install the user-space button daemon and enable pisound, run the below commands in a terminal.
wget http://blokas.io/pisound/install-pisound.sh -O install-pisound.sh chmod +x install-pisound.sh ./install-pisound.sh
The above installs a button daemon named 'pisound-btn' and its scripts for button actions. If there were existing scripts, they are first backed up to
/usr/local/etc/pisound/backups/<current date>, so if you had overridden the default functions, you will have to restore your scripts manually.
Verifying It Works
Once the system boots up, run a terminal and run:
amidi -l arecord -l aplay -l
pi@raspberrypi:~ $ amidi -l Dir Device Name IO hw:1,0 pisound MIDI PS-10JAD4Q pi@raspberrypi:~ $ arecord -l **** List of CAPTURE Hardware Devices **** card 1: pisound [pisound], device 0: PS-10JAD4Q snd-soc-dummy-dai-0  Subdevices: 1/1 Subdevice #0: subdevice #0 pi@raspberrypi:~ $ aplay -l **** List of PLAYBACK Hardware Devices **** card 0: ALSA [bcm2835 ALSA], device 0: bcm2835 ALSA [bcm2835 ALSA] Subdevices: 8/8 Subdevice #0: subdevice #0 Subdevice #1: subdevice #1 Subdevice #2: subdevice #2 Subdevice #3: subdevice #3 Subdevice #4: subdevice #4 Subdevice #5: subdevice #5 Subdevice #6: subdevice #6 Subdevice #7: subdevice #7 card 0: ALSA [bcm2835 ALSA], device 1: bcm2835 ALSA [bcm2835 IEC958/HDMI] Subdevices: 1/1 Subdevice #0: subdevice #0 card 1: pisound [pisound], device 0: PS-10JAD4Q snd-soc-dummy-dai-0  Subdevices: 1/1 Subdevice #0: subdevice #0
In case you're having difficulties with getting pisound's driver to run, contact us and the community here: http://community.blokas.io/, provide the exact error and the last command you've executed.
Please add or let us know if you have pisound working on a distribution that is not in the list yet!
Software we tested which required no special changes, in alphabetic order:
- Carla / LV2
- darkice and icecast
- Pure Data
Software which required tweaks or workarounds, in alphabetic order:
- Sonic Pi