README.md

MIPI IMX415 Setup Guide

This is setup guide for enabling MIPI IMX415 for Intel® Alder-Lake N processor.

Requirements

Ensure that your system is set up properly.

1. ADLN Setup: Refer to ADLN Setup tutorial
2. ADLN BIOS Setup: Refer to BIOS Setup for MIPI IMX415
3. Obtain IMX415 drivers, kernels and packages zip file from Leopard team by dropping an email here: Leopard Support [email protected]

Validated Hardware

• AAEON UP Squared Pro 7000 (UPN-ADLNI3-A10-1664)
• LEOPARD IMX415 MIPI

Go to specific setup directory

This step will redirect user to the current platform setup directory

cd edge-developer-kit-reference-scripts/platforms/atom/adln/mipi/imx415

System Kernel Change

1. Run below command to install pre-built kernel v5.15.137.

   cd <zip_package_from_leopard>/imx415
   sudo dpkg -i linux-*.deb
   sudo update-grub
   sudo reboot
   

2. Once the system reboots, choose and select Kernel 5.15.137 under ‘Advanced Options for Ubuntu’.

Install IPU libraries

1. Run below script to install userspace IPU libraries.

   cd edge-developer-kit-reference-scripts/platforms/atom/adln/mipi/imx415/scripts
   ./install_ipu.sh
   

2. After installing userspace IPU libraries, run below script to setup userspace IPU libraries. The system reboots after this command.

   ./setup_ipu.sh
   

3. Run below to copy necessary drivers and packages from Section: Requirements , Step 3 onto ADL-N board.

   cd <zip_package_from_leopard>/ISP/
   cp camera/IMX415_TGL_10bits.aiqb /usr/share/defaults/etc/camera/ipu_adl/
   cp camera/libcamhal_profile.xml /usr/share/defaults/etc/camera/ipu_adl/ 
   cp camera/sensors/imx415.xml /usr/share/defaults/etc/camera/ipu_adl/sensors/
   cp camera/gcss/graph_settings_imx415.xml /usr/share/defaults/etc/camera/ipu_adl/gcss/
   

Validate IMX415 driver

1. To ensure IPU FW is probed and loaded properly, run this command.

   sudo dmesg | grep ipu
   

   

2. Lastly check if IMX415 sensor(s) are detected.

   sudo dmesg | grep imx415
   

   

   media-ctl -p
   

   

Streaming the camera

1. Set environment variables with following commands.

   cd edge-developer-kit-reference-scripts/platforms/atom/adln/mipi/imx415/scripts
   source setup_camera_env.sh
   

2. Launch the following command to see

   Single camera stream

   sudo -E gst-launch-1.0 icamerasrc device-name=imx415 printfps=true ! video/x-raw,format=NV12,width=3840,height=2160 ! videoconvert ! xvimagesink
   

   Dual camera stream

   sudo -E gst-launch-1.0 icamerasrc device-name=imx415 printfps=true ! video/x-raw,format=NV12,width=3840,height=2160 ! videoconvert ! xvimagesink icamerasrc device-name=imx415-2 printfps=true ! video/x-raw,format=NV12,width=3840,height=2160  ! videoconvert ! xvimagesink
   

Stream output

The images below shows the output for 2 IMX415 camera streams.

Next Steps

Refer to the available use cases and examples below

1. Intel® Distribution of OpenVINO™ Toolkit
2. Intel® Edge Software Hub