Skip to main content
The Raspberry Pi 5 with 2–3× the speed of the previous generation, and featuring silicon designed in‑house for the best possible performance, we’ve redefined the Raspberry Pi experience. The Pi5 is a versatile Linux development board with a quad-core processor running at 2.4GHz a GPIO header to connect sensors, and the ability to easily add an external microphone or camera - and it’s fully supported by Edge Impulse. You’ll be able to sample raw data, build models, and deploy trained machine learning models directly from the Studio. In addition to the Raspberry Pi 5 we recommend that you also add a camera and / or a microphone. Most popular USB webcams and the Camera Module work fine on the development board out of the box.

Raspberry Pi 5

Prerequisites

In this documentation, we will detail the steps to set up your Raspberry Pi 5 with the new Bookworm release OS for Edge Impulse. This guide includes headless setup instructions and how to connect to Edge Impulse, along with troubleshooting tips. For more detailed Raspberry Pi setup instructions please see their official documentation: Getting started with Raspberry Pi.

Headless Setup

You can set up your Raspberry Pi without a screen. To do so:
  1. Flash the Raspberry Pi OS image to an SD card using the Raspberry Pi Imager.
You must use 64-bit OS as 32-bit OS is no longer supported Raspberry Pi 5 uses aarch64, which is a 64-bit CPU. If you are installing Raspberry Pi OS for the RPi 5, make sure you use the 64-bit version. Raspberry Pi 5 cannot run armv7 images
  1. During the flashing process, access the advanced options menu in the Raspberry Pi Imager to preconfigure your WiFi and enable SSH.
    • You can also create an empty file called ssh in the boot drive to enable SSH if you have not set up SSH through the Raspberry Pi Imager options.
  • wpa_supplicant.conf cannot be used from Bookworm onward to set up WiFi and networking. You must use the Pi Imager or the advanced menuraspi-config tool to set up WiFi.
  1. Insert the SD card into your Raspberry Pi 5, and let the device boot up.
  2. Find the IP address of your Raspberry Pi. You can either do this through the DHCP logs in your router or by scanning your network. E.g., on macOS and Linux via:
arp -na | grep -i dc:a6:32
which should return something like:
? (192.168.1.19) at dc:a6:32:f5:b6:7e on en0 ifscope [ethernet]
Here 192.168.1.19 is your IP address. You can also try using raspberrypi.local instead of the IP address if your system supports mDNS.
  1. Connect to the Raspberry Pi over SSH. Open a terminal window and run:
ssh <username>@192.168.1.19
  1. Log in with the default username pi and password raspberry.

Setup with a Screen

If you have a screen and a keyboard/mouse attached to your Raspberry Pi:
  1. Flash the Raspberry Pi OS image to an SD card.
  2. Insert the SD card into your Raspberry Pi 5, and let the device boot up.
  3. Connect to your WiFi network.
  4. Click the ‘Terminal’ icon in the top bar of the Raspberry Pi.

Installing dependencies

Note: When using RPi OS Bookworm and RPi camera module you need to install gstreamer1.0-libcamera package first. However once gstreamer1.0-libcamera is installed it hides v4l2deviceproviders, as a result it hides webcam.To resolve this issue, you need to install the gstreamer1.0-libcamera package and use the latest edge-impulse-linux >=v1.9.2 to fix this issue.
To set this device up in Edge Impulse, run the following commands:
sudo apt update
curl -sL https://deb.nodesource.com/setup_20.x | sudo bash -
sudo apt install -y gcc g++ make build-essential nodejs sox gstreamer1.0-tools gstreamer1.0-plugins-good gstreamer1.0-plugins-base gstreamer1.0-plugins-base-apps
sudo npm install edge-impulse-linux -g --unsafe-perm
Then to update npm packages:
sudo npm install -g npm@10.8.1
If you have a Raspberry Pi Camera Module, you also need to activate it first. Run the following command:
sudo raspi-config
Use the cursor keys to select and open Interfacing Options, then select Camera, and follow the prompt to enable the camera. Reboot the Raspberry Pi.

Install with Docker

If you want to install Edge Impulse on your Raspberry Pi using Docker, run the following commands:
sudo apt update
sudo apt install -y docker.io
sudo systemctl enable docker
sudo systemctl start docker
sudo docker run -it --rm --privileged --network=host -v /dev/:/dev/ --env UDEV=1 --device /dev:/dev --entrypoint /bin/bash ubuntu:20.04
Once in the Docker container, run:
apt-get update

apt-get install wget -y
wget https://deb.nodesource.com/setup_20.x
bash setup_20.x
apt install -y gcc g++ make build-essential nodejs sox gstreamer1.0-tools gstreamer1.0-plugins-good gstreamer1.0-plugins-base gstreamer1.0-plugins-base-apps vim v4l-utils usbutils udev
apt-get install npm -y

Connecting to Edge Impulse

With all software set up, connect your camera or microphone to your Raspberry Pi (see ‘Next steps’ further on this page if you want to connect a different sensor). To connect your Raspberry Pi 5 to Edge Impulse, run the following command:
edge-impulse-linux
This command connects your Raspberry Pi 5 to Edge Impulse Studio. It will prompt you to log in and select a project. Once authenticated, your Raspberry Pi 5 will appear in the Edge Impulse Studio under Devices. To verify this, go to your Edge Impulse project, and click Devices. The device will be listed here.

Device connected to Edge Impulse.

You can now sample raw data, build models, and deploy trained machine learning models directly from the Studio. Please let us know if you have any questions or need further assistance: forum.edgeimpulse.com. If you want to switch projects run the command with --clean.

Troubleshooting

Wrong OS bits

If you see the following error when trying to deploy a .eim model to your Raspberry Pi:
Failed to run impulse Error: Unsupported architecture “aarch64”
It likely means you are attempting to deploy a .eim Edge Impulse model file to a 32-bit operating system running on a 64-bit CPU. To check your hardware architecture and OS in Linux, please run the following commands:
uname -m
uname -a
getconf LONG_BIT