View source for Raspberry Pi Jack

* This is a 5/2/2013 copy of the original page available at: http://apps.linuxaudio.org/wiki/raspberrypi
* See also: [[Jack]]
===== Raspberry Pi and real-time, low-latency audio =====

The Raspberry Pi can be set up to handle real-time, low-latency audio but it requires quite some tweaking. Hence this Wiki article in which some common bottlenecks as well as some possible optimizations will be described. Last but not least this article will explain how to get JACK aka jackd running on your RPi.

===== Powering the RPi =====

If you use the micro-USB power input to power the RPi you might encounter sudden reboots when plugging in or unplugging USB devices. If you want to be sure your RPi doesn't reboot in such cases you can try backfeed powering your RPi by connecting the power supply to one of the USB ports or use a powered USB hub that backfeeds. Also make sure your power supply can provide at least 700mA at 5V. If you plan on using an USB interface you might need more power so try to find a power supply that provides 2A or even more.

===== Overclocking =====

With the ''raspi-config'' tool or by editing ''/boot/config.txt'' directly it is possible to overclock various parts of the RPi (CPU, GPU, SDRAM). A common issue with overclocking is SD card corruption. You can prevent this from happening by never using a ''core_freq'' (GPU frequency) value higher than 250. If you really want to use a higher ''core_freq'' value you could either use a SD card that doesn't show this behavior or put your root filesystem on an USB drive. Overclocking provides more processing power and since it doesn't void your warranty and you don't need to add fans or a heatsink you could consider it a must for doing audio related things on your RPi.

More info on overclocking: http://elinux.org/RPiconfig#Overclocking

==== CPU frequency scaling ====

From the aforementioned link:
>//"The latest kernel has a cpufreq kernel driver with the "ondemand" governor enabled by default. It has no effect if you have no overclock settings. But when you do, the arm frequency will vary with processor load."//((http://elinux.org/RPiconfig#Overclocking))

So when overclocking your RPi for audio usage you should set the governor to ''performance'' as a scaling CPU can cause audible glitches. This can be done with the following command:
  echo -n performance \
  | sudo tee /sys/devices/system/cpu/cpu0/cpufreq/scaling_governor

===== Disabling unneeded services =====

By default the RPi runs quite some services that are not really needed or even get in the way when setting up a real-time, low-latency environment. One way to disable such services from running and chewing up precious CPU cycles is to write a little script, an example can be found here: https://github.com/AutoStatic/scripts/raw/rpi/rpi/jackstart

Breaking down the script:

''#!/bin/bash

## Stop the ntp service\\
sudo service ntp stop\\
\\
## Stop the triggerhappy service\\
sudo service triggerhappy stop\\
\\
## Stop the dbus service. Warning: this can cause unpredictable behaviour when running a desktop environment on the RPi\\
sudo service dbus stop\\
\\
## Stop the console-kit-daemon service. Warning: this can cause unpredictable behaviour when running a desktop environment on the RPi\\
sudo killall console-kit-daemon\\
\\
## Stop the polkitd service. Warning: this can cause unpredictable behaviour when running a desktop environment on the RPi\\
sudo killall polkitd\\
\\
## Only needed when Jack2 is compiled with D-Bus support (Jack2 in the AutoStatic RPi audio repo is compiled without D-Bus support)\\
#export DBUS_SESSION_BUS_ADDRESS=unix:path=/run/dbus/system_bus_socket\\
\\
## Remount /dev/shm to prevent memory allocation errors\\
sudo mount -o remount,size=128M /dev/shm\\
\\
## Kill the usespace gnome virtual filesystem daemon.  Warning: this can cause unpredictable behaviour when running a desktop environment on the RPi\\
killall gvfsd\\
\\
## Kill the userspace D-Bus daemon.  Warning: this can cause unpredictable behaviour when running a desktop environment on the RPi\\
killall dbus-daemon\\
\\
## Kill the userspace dbus-launch daemon.  Warning: this can cause unpredictable behaviour when running a desktop environment on the RPi\\
killall dbus-launch\\
\\
## Uncomment if you'd like to disable the network adapter completely\\
#echo -n "1-1.1:1.0" | sudo tee /sys/bus/usb/drivers/smsc95xx/unbind\\
\\
## Set the CPU scaling governor to performance\\
echo -n performance | sudo tee /sys/devices/system/cpu/cpu0/cpufreq/scaling_governor\\
\\
## And finally start JACK\\
jackd -P70 -p16 -t2000 -d alsa -dhw:UA25 -p 128 -n 3 -r 44100 -s &\\
\\
exit
''

===== Running a headless RPi =====

You can get a significant performance gain by not using a desktop environment on the RPi. That's nice and all but how do I control the RPi then and what if the software I'd like to use has a GUI? Enter X-forwarding over SSH. X-forwarding over SSH allows you to run software from the RPi within the desktop environment of the machine you're SSH'ing from. That machine does need to have Xorg installed so using Linux is your best option. Open a terminal on the machine you want to connect to the RPi over SSH and simply type:
  ssh -X pi@ip.address.of.rpi
  
This will give you shell access to the RPi. Now you can start GUI software by invoking them from the command line, like ''guitarix'' which will open the guitarix GUI on your connected Linux machine while the software itself runs on the RPi.

Using this method also works around the issue of non-working mice and keyboards when using the ''dwc_otg.speed=1'' option in your ''/boot/cmdline.txt'' file because now you can control the software with the mouse and keyboard of the connected Linux machine.
===== On-board audio =====

The on-board chipset of the RPi has quite some limitations unfortunately. It only does playback and the ALSA driver for this chipset lacks MMAP support so it's unusable with JACK directly. You can use JACK with the on-board chipset but only with the ALSA loopback device or the JACK dummy driver together with the ''alsa_out'' utility. This does introduce additional latency.

Other drawbacks of the analog audio output:
  * it can produce clicks and pops due to the design of the RPi 
  * apparently the on-board audio is 11 bits only

More info:\\
http://www.raspberrypi.org/phpBB3/viewtopic.php?f=38&t=30669\\
http://www.raspberrypi.org/phpBB3/viewtopic.php?p=297563
===== USB audio =====

To work around having only audio out an external USB audio interface can be an option as a lot of USB audio interfaces have both audio inputs and outputs that can be used simultaneously. You can also use JACK directly with an USB audio interface. To get a working set-up you will first need to work around some of the limitations of the USB implementation of the RPi.

==== Supported USB devices ====

=== USB1.1 ===

Any class compliant USB1.1 audio interface will work with the RPi. You can determine if a device is class compliant if the specifications of the interface state that no drivers are needed when using Mac or Windows. If unsure several listings of supported interfaces are available:
  * http://wiki.linuxaudio.org/wiki/current_audio_gear
  * http://wiki.linuxmusicians.com/doku.php?id=hardware_matrix
  * http://elinux.org/RPi_VerifiedPeripherals#USB_Sound_Cards (RPi specific)

=== USB2 ===

There are USB2.0 interfaces that are supported by the Linux audio driver stack (ALSA). Those interfaces should also work with the RPi. An example is the M-Audio Fast Track Ultra 8R, it has been reported that this interface works with the RPi.

==== Force USB1.1 mode ====

The RPi has a USB2.0 controller that apparently can cause issues with USB1.1 audio interfaces. The solution is to force the controller to use USB1.1 mode. You can do this by adding the following kernel parameter to your ''/boot/cmdline.txt'' file on your RPi:
  dwc_otg.speed=1

==== Ethernet controller ====

While you're at it you might also want to disable the turbo mode for the ethernet controller of the RPi by adding:
  smsc95xx.turbo_mode=N

>//"This feature enables the USB device to send multiple received ethernet packets in one USB transaction. This enables more efficient usage of the USB bus, and therefore higher throughput, but it causes multiple RAM allocation requests to happen at once as multiple incoming packets are processed. Turning it off means memory allocations happen in a less bursty fashion, so are less likely to fail when RAM is scarce."//((https://github.com/raspberrypi/linux/issues/153#issuecomment-10188636))

You could also disable the ethernet connection altogether to make sure you can use the full bandwidth of the USB controller:
  echo -n "1-1.1:1.0" | sudo tee /sys/bus/usb/drivers/smsc95xx/unbind

==== USB1.1 and more than two inputs ====

If your USB1.1 interface has more than two inputs and fails to work properly with JACK try forcing using only two inputs with the ''-i 2'' option of the ALSA backend driver.

===== Setting the default soundcard =====

The order in which soundcards are indexed is determinded by the content of ''/etc/modprobe.d/alsa-base.conf''. By default USB soundcards (or actually the snd-usb-audio kernel module) gets index -2 so it will never end up as the default soundcard. If you want your USB audio interface to be the default soundcard look up the following line in ''/etc/modprobe.d/alsa-base.conf'':
  options snd-usb-audio index=-2

And either comment it:
  #options snd-usb-audio index=-2

Or assign an index of 0:
  options snd-usb-audio index=0

Another option is to comment or remove the kernel module for the onboard soundcard (snd-bcm2835) from ''/etc/modules''. Keep in mind this will disable the onboard sound altogether. This might save you some precious CPU cycles too but don't expect too much of it.

===== Audio software repository =====

There's a [[http://rpi.autostatic.com/|repository]] available with packages of Jack1, Jack2 (both patched for use on ARM) and a small collection of software that is either not available or not up to date in the standard Raspbian repositories.

==== Adding the repository ====

  wget -O - http://rpi.autostatic.com/autostatic.gpg.key| sudo apt-key add -
  sudo wget -O /etc/apt/sources.list.d/autostatic-audio-raspbian.list http://rpi.autostatic.com/autostatic-audio-raspbian.list
  sudo apt-get update

===== Using JACK =====

JACK (JACK Audio Connection Kit), often referred to as jackd, is a
>//"system for handling real-time, low latency audio (and MIDI). It runs on GNU/Linux, Solaris, FreeBSD, OS X and Windows (and can be ported to other POSIX-conformant platforms). It can connect a number of different applications to an audio device, as well as allowing them to share audio between themselves. Its clients can run in their own processes (ie. as normal applications), or can they can run within the JACK server (ie. as a "plugin"). JACK also has support for distributing audio processing across a network, both fast & reliable LANs as well as slower, less reliable WANs.\\
\\
JACK was designed from the ground up for professional audio work, and its design focuses on two key areas: synchronous execution of all clients, and low latency operation."//((http://jackaudio.org/))

==== Patching JACK ====

You will need a patched JACK for the RPi otherwise you will encounter the infamous "Bus error" when starting JACK.  This is because JACK uses packed structs and the RPi doesn't like those: http://comments.gmane.org/gmane.comp.audio.jackit/26713.

Patches can be found here: https://github.com/AutoStatic/jack-armel
The patches apply cleanly to Jack1 0.121.3 git commit 75e3e20b and Jack2 1.9.8 git commit 007cdc37 but since the patches are relatively simple they can be easily adapted for other JACK versions.

When using Jack2 you might want to disable dbus dependent code in JACK components if you want to run Jack2 on a headless RPi (so without X). You can do this by building without the ''--dbus'' option.

==== Packages ====

There are also packages available that contain patched versions of Jack1 and Jack2. You can find them in the aforementioned [[wiki:raspberrypi#audio_software_repository|audio repository]].

After having added the repository you can install either Jack1 or Jack2 with ''apt-get''.

=== Jack1 ===

  sudo apt-get --no-install-recommends install jackd1

=== Jack2 ===

  sudo apt-get --no-install-recommends install jackd2

==== Running JACK ====

Before starting JACK you will want to increase the size of ''/dev/shm'' first:
  sudo mount -o remount,size=128M /dev/shm

So JACK will not complain that it cannot allocate memory. Also set the CPU governor to performance so the CPU frequency does not scale:
  echo -n performance \
  | sudo tee /sys/devices/system/cpu/cpu0/cpufreq/scaling_governor

=== Using an external USB audio interface ===

Now you should be able to fire up jackd, the actual daemon of the JACK package. Capture or playback only should be no problem but full-duplex can be troublesome, ALSA will report a lot of xruns and when using Jack1 the watchdog thread will kick in after a while killing JACK. In this case, try adding the ALSA ''-s'' option (softmode) and see if that improves stability. An example JACK command would look like this:
  jackd -P70 -p16 -t2000 -dalsa -dhw:UA25 -p128 -n3 -r44100 -s &

Which translates to: run JACK with a realtime priority of 70 (''-P70''), use a port maximum of 16 (''-p16''), use a client timeout of 2000s (''-t2000'', default is 500 and this can cause issues with some applications), use the ALSA driver stack (''-dalsa''), use the USB interface with cardname UA25 (''-dhw:UA25'', this is an Edirol UA-25 USB interface), use a frames/period setting of 128 (''-p128''), use a periods/buffer setting of 3 (''-n3'', this is the recommended setting for USB interfaces, the default is 2), use a sample rate of 44.1kHz (''-r44100'') and use the softmode setting of ALSA (''-s'') to ignore xruns reported by the ALSA driver. The ampersand (&) at the end puts the whole jackd process in the background.

=== Using the on-board audio ===

JACK can't be used directly with the on-board audio, JACK won't start because the driver for the on-board audio lacks mmap support. You can work around this limitation by using the JACK dummy driver and a utility called ''alsa_out''. An example of how to start the jackd JACK daemon could be:
  jackd -d dummy
  
This will start JACK using the dummy driver with the default sample rate and number of frames (resp. 48kHz and 1024). When JACK is running you can start ''alsa_out'' which will create two input ports in JACK to which you can connect JACK clients with ''jack_connect''. The ''alsa_out'' utility will then output the sound to the analog jack output or the HDMI output.

Using this method has its drawbacks though:
  * Additional latency is introduced to such extent that it is practically unusable for real-time, low-latency audio.
  * The higher the quality of the throughput (the ''-q'' option of ''alsa_out'') the bigger the chance of xruns.
  * The resulting set-up isn't the most stable solution.

{{tag>jack hardware_linux usb_audio_midi jackd raspberry_pi}}