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.
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
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
169.254.255.254 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.
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.
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.
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.
The boot image contains a complete Raspian system, including Desktop resources. You may still need to install stuff related to your application.
Any ALSA class-compliant USB2 interface will work. The Behringer UCA-202 (or UCA-222) is an inexpensive option that works fine.
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.
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.
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.
Yes! The RNBOOSCQuery runner has built-in support for OSC control and auto-exposes all named parameters, inports and outports. You can use this information to build your own OSC patch, connect to third-party platforms like TouchOSC, or to connect directly from the Max using the rnbo.remote object.
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,
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.