Starter Kit – Raspberry Pi 5 (GenX320)

Starter Kit – Raspberry Pi 5 (GenX320)

The Starter Kit GenX320 for Raspberry Pi 5 allows you to evaluate and develop embedded event-based vision applications based on the Raspberry Pi 5 single board computer (available from Raspberry Pi) using Prophesee's GenX320 event sensor.

Info
Product briefs can be downloaded in the attachments at the bottom of this page.

Recommended Hardware 

Item
SKU
Link
Raspberry Pi 5
(8GB RAM or greater)
SC1432
Active Cooler
SC1148
Power Supply
SC1153 (US)
SC1408 (EU)
SSD Kit
(highly recommended)
SC1675
MicroSD Card
(16GB or more)


MicroSD Card Reader



Setup and Installation

At first, you will need to assemble the hardware accessories taking care of orientation of the camera flex cable. Then, install the software using one of the following methods. 
(Optional) If you have a Raspberry Pi SSD kit, then you need to setup it following the instructions for the Raspberry Pi M.2 HAT+ and using our custom Linux image or compiling our sensor driver from source code as described below.

Method 1 - Installation using the Custom Linux Image

  1. Download our custom linux image (which is based on BookWorm Raspberry Pi OS and includes precompiled RPi sensor driver and OpenEB) 
  2. Flash the downloaded image to a microSD card or SSD:
    1. Recommended: use RPi Imager software and set a new login/password
    2. Alternatively: flash the image by any other method and use the default login/password that are pi/pi 

Method 2 - Installation from Source Code

Warning
The current version of the sensor driver supports Linux kernel versions up to 6.12. It is not compatible with kernel 6.18, which is installed by default on Raspberry Pi OS Trixie). Before proceeding please ensure that your system is running a supported kernel version (for example by running uname -a command). 
  1. Start your Raspberry Pi and open a terminal windows
  2. Clone the RPi sensor driver repository and navigate to its directory:
    1. git clone https://github.com/prophesee-ai/rpi-sensor-drivers
    2. cd rpi-sensor-drivers
  3. Follow the installation instructions in the README (they include building a patched version of OpenEB)
    1. Note that the instructions were originally made for Raspberry Pi OS BookWorm.
    2. If you are using Raspberry Pi OS Trixie, install additional dependencies
    3. sudo apt update
    4. sudo apt -y install libcanberra-gtk3-module libgles-dev
  4. Reload the libraries after the installation:
    1. sudo ldconfig

Optionally, for using Python API and running Python code samples, you will need to install Python and some additional libraries.


Data Streaming

First, prepare your system for loading the sensor driver and formats :  
  1. Load the sensor driver by loading the device tree overlay for both slots (your may add it to your boot configuration):
    1. sudo dtoverlay genx320
    2. sudo dtoverlay genx320,cam0
  2. Setup additional parameters:
    1. In case of installing the software from our custom image:
      1. Setup formats/links/parameters for V4l:
        1. ./rp5_setup_v4l.sh
    2. In case of installing the software from the source code:
      1. Setup formats/links/parameters for V4l:
        1. ./rpi-sensor-drivers/rp5_setup_v4l.sh
      2. Configure the following environment variables (you may add them to your ~/.bashrc to make them permanent, otherwise they are applied only in the active window):
        1. export PSEE_VAR_V4L2_BSIZE=1
        2. export V4L2_HEAP=vidbuf_cached

Now, you are ready to run OpenEB applications and tools and compile samples.
We recommend you to start with Metavision Viewer allowing data visualization, recording and replay:
  1. metavision_viewer



OpenEB provides a variety of code samples helping to get started quickly. Most OpenEB samples are distributed as source code. While some samples are precompiled and ready to run, others require compilation.
The samples are installed in the following directories and can be compiled following the instructions in this tutorial:
  1. ls /usr/local/share/metavision/hal
  2. ls /usr/local/share/metavision/sdk

    As a Prophesee customer, get access to your personal ticketing tool, application notes, product manuals, SDK Download Center and more resources.