Learn Raspberry Pi FAQ and Troubleshooting

Getting Started

Welcome to RNBO


RNBO Basics

Key Differences

Why We Made RNBO

Coding Resources


Audio IO

Messages to rnbo~

Using Parameters


Messages and Ports

Polyphony and Voice Control

Audio Files in RNBO

Using Buffers

Using the FFT

Export Targets

Export Targets Overview

Max External Target
Raspberry Pi Target
The Web Export Target
The C++ Source Code Target

Code Export

Working with JavaScript
Working with C++

Special Topics

Sample Accurate Patching
Scala and Custom Tuning

RNBO and Max for Live

RNBO Raspberry Pi OSCQuery Runner


Export Description

Raspberry Pi GPIO

Updating the RNBO Package

Raspberry Pi Target FAQ Troubleshooting

Working with the Raspberry Pi can sometimes be challenging. Here are some steps to try when you are having trouble with the Pi.

Help! Max can't find my Pi on my local network.

RNBO will have no trouble finding your Pi when both your Pi and the computer running Max both have a good connection to the same local network. When RNBO can't find the Pi - this is often due to a poor or unstable connection. Here are some things to try.

The username for the pi must be pi for the runner to communicate. This is set to pi by default. If you've recently changed the username on the pi in settings - or when you used the Raspberry Pi imager - change the name back to pi. Support for custom usernames may be supported in the future.

Note: This is not the hostname, which you see in the export sidebar and are free to change from the default c74rpi.

Rebooting the pi can help - but do it safely by using the terminal command sudo reboot or the menu option in the desktop GUI, don't cut the power by un/replugging.

Ensure your power supply to the RPi is sufficient and connections are firm. Current draw from USB ports, hats, dongles etc can affect performance and stability if not supplied with the correct power. USB cables often have a high internal resistance, which can cause a slight voltage drop. For USB data, it's not a problem, but for USB Power, this is a factor. If you see hwmon hwmon1: Undervoltage detected! in the logs or on the command line in the raspberry pi terminal, this is a sign that the power supply or cable is insufficient, poor quality, or perhaps even damaged. If in doubt, use an official RPi PSU.

If you're connecting to the Pi via an ethernet cable to the router - ensure you're using a good-quality ethernet cable. CAT5/5e is common. Some RPi users solve their connection issues by switching to CAT6, especially over lengthy cables.

If you're using an ad-hoc machine-to-machine network connection - especially if this involves a dongle or adapter of some kind - you might want to ensure that the Ethernet cable is plugged in on both ends and then remove and re-insert the adapter to get the bytes flowing. Or plug the Pi into an open port on the router.

Connect a monitor and keyboard up to your pi and take a look in the terminal. Running the command hostname -I from the pi's terminal will show the IP address of the RPi on the network. If this address is in the range of to this means the Pi couldn't get the IP address from your router and used Automatic Private IP Addressing (APIPA) instead, meaning that the Pi assigned itself an IP because the router couldn't provide it like usual. In this case, power cycling your router can help. Be patient, and the DHCP server should issue a dynamic IP and allow the regular connection.

Try enabling Internet Sharing from the computer's active network interface to the Ethernet port. This will also help the rPi to pull a valid IP address.

Help! I cannot login to my Pi via ssh, and I am seeing a message : Could not resolve hostname ****.local: No such host is known.

ssh must be enabled in the configuration settings on the raspberry pi, if this is a new install of the RNBO RPi image - this won't be enabled by default.

If you cannot reach the pi via ssh and you normally can, you might want to take a peek at the network settings as the computer may not think the pi is attached. See the steps above for general networking troubleshooting.

Help! My USB audio interface isn't showing up/is crashing the runner

You might need to do some additional configuration. Using the device number awarded to your USB device and try creating/modifying ~/.asoundrc to read:

defaults.pcm.card 0
defaults.pcm.device 0
defaults.ctl.card 0

The Pi's default audio is disabled by default, but I really want to use the built-in audio. Can I do that?

Un-commenting out the line dtparam=audio=on in /boot/config.txt to re-enable the built-in audio.

The Pi's external soundcard/hat is not enabled, but I really want to use the built-in audio, can I do that?

In some cases, un-commenting out the line dtparam=audio=on in /boot/config.txt will enable the external soundcard/hat.

After exporting to my Pi I see message that there are outdated packages on my system.

This message indicates that there are new updates available for packages being used on your rPi OS. You can update these by making sure the rPi is internet connected, then ssh'ing into the machine (see Raspberry Pi Setup) and then running the following commands.

First enter

sudo apt-get update

Press return/enter to run the command, which downloads any available upgrades. This can take a few minutes. Once complete, type:

sudo apt-get upgrade

Press return/enter to install the updates. Again this can take some time. Once completed, you will need to restart your Pi using sudo reboot for the changes to take effect.

I want to do graphics, etc. with my Pi.

The boot image contains a complete Raspian system, including Desktop resources. You may still need to install stuff related to your application.

Can you recommend a USB interface?

Any ALSA class-compliant USB2 interface will work. The Behringer UCA-202 (or UCA-222) is an inexpensive option that works fine.

What about a hat for the Pi?

The hifiberry DAC+ is a nice option if you only need output ( RCA jacks only ). The Blokas PiSound has both audio ( 1/4" jacks ) and MIDI ( full-size DIN5 ports ), but see the note above about driver compatibility.

Can I load samples in my rPi to use with RNBO patchers?

Yes! In the export configuration for the Raspberry Pi Export target, you will find the option to Copy Sample Dependencies. See the Exporting to the Raspberry Pi Target guide.

How do I update my Raspberry Pi to run the latest RNBO source code?

You might notice that the Export Sidebar for the Raspberry Pi target shows not only the names of connected devices, but also the version of the runner code that is active on each rPi device. It will also remind you when a version update is needed to the Raspberry Pi to run the source code to match your current version of RNBO.

How do I control my patchers remotely?

The RNBOOSCQuery runner has built-in support for OSC control and auto-exposes all named parameters, inports and outports. That means that you can set parameter values, send MIDI messages, and address inports by sending OSC messages to your Pi. You can use this information to build your own OSC patch with the udpsend object, or connect with third-party platforms like TouchOSC. Max also provides the rnbo.remote object which makes remote control even simpler, as well as a Web Interface that you can access from the browser.

What happened to the Debug Interface and the Debug Interface Document?

The Debug Interface has been updated and replaced with the Web Interface with the introduction of RNBO 1.3.0.

When I open the Web Interface I can't see any patcher instances or nodes in the interface.

If you were previously working with the RNBO Debug interface, it may be that the cache needs to be cleared in order to reveal the Web Interface in the case that the Interface was opened previously. This can occur if your default browser is Mozilla Firefox.

Can I access the list of available OSC messages?

The JSON list of available messages, which also includes audio configuration options for your soundcard and messages to save and manage presets, can be accessed via any web browser if you know the IP of the rPi. The webpage url is in the format http://ip_address:port/rnbo/inst/0 . The ip_adress can be your actual IP or the rpi's hostname for local networks (default c74rpi.local) and the default port is 5678.

i.e., using the defaults from the RNBO pi image, http://c74rpi.local:5678/rnbo/inst/0 .

If you need to find the IP of the pi, simply connect a monitor and keyboard or login in over ssh and run hostname -I in the terminal.