Alvium CSI driver for Toradex systems

Overview

This repository contains the manifest files for building the Allied Vision Alvium reference image for various Toradex systems.

Compatibiliy

This release is tested with:

• Toradex Verdin iMX8M Plus SoM + Mallow carrier
• Toradex Verdin iMX8M Mini SoM + Mallow carrier
• Alvium C series cameras with Firmware 14

The release is based on the Toradex BSP 7.3.0 and contains Vimba X 2025-1 and the V4L2Viewer 2.4.0.

This release supports V4L2 and GenICam for CSI2 access. Vimba X 2025-1 is preinstalled in the Allied Vision camera reference image.

Quick Start

Prerequisites

• One of the supported board combinations: e.g Verdin iMX8M Plus + Mallow or Verdin iMX8M Mini + Mallow
• Host PC: Install the requirements as defined in the Yocto Project Reference Manual
• Alvium C series camera with Firmware 14

Building the reference image

Tip: For the prebake image, skip steps 1-3 and start with step 4.

To install the driver and layer:

1. Install kas

   python3 -m venv .venv
   source .venv/bin/activate
   python3 -m pip install kas

2. Accept Vimba X License and NXP EULA Vimba X uses a commercial license, which can be found here Vimba X License. To accept the license please uncomment the following line in the board configuration yaml file:

   #    LICENSE_FLAGS_ACCEPTED:append = " commercial_vimbax "

   Some packages for the NXP SoCs require the NXP/Freescale EULA available in "toradex-bsp/layers/meta-freescale/EULA" to be read and accepted. To accept the license uncomment the following line in the board configuration yaml file:

   #    ACCEPT_FSL_EULA = "1"

3. Select kas build configuration The following build configuration are avaiable

   Board combination	Configration file
   Verdin iMX8M Mini + Mallow	alvium-verdin-imx8mm-7.x.y-avt1.0.0.yml
   Verdin iMX8M Plus + Mallow	alvium-verdin-imx8mp-7.x.y-avt1.0.0.yml

4. Build the AVT Image with the command:

   kas build <configuration .yml>

5. Flash the image using the Toradex Easy Installer Please follow the instructions from Toradex how to use the Toradex Easy Installer: Flash a New Image Using Toradex Easy Installer

6. Boot the board.

7. Check if the camera firmware version is 14 or higher. If the camera has an earlier firmware, perform an update with Vimba X Firmware Updater.

Beta Disclaimer

Please be aware that all code revisions not explicitly listed in the Github Release section are considered a Beta Version.

For Beta Versions, the following applies in addition to the BSD 3-Clause License:

THE SOFTWARE IS PRELIMINARY AND STILL IN TESTING AND VERIFICATION PHASE AND IS PROVIDED ON AN “AS IS” AND “AS AVAILABLE” BASIS AND IS BELIEVED TO CONTAIN DEFECTS. THE PRIMARY PURPOSE OF THIS EARLY ACCESS IS TO OBTAIN FEEDBACK ON PERFORMANCE AND THE IDENTIFICATION OF DEFECTS IN THE SOFTWARE, HARDWARE AND DOCUMENTATION.