About This Project

This repository contains reference drivers and configurations for Intel MIPI CSI cameras, supporting various sensor modules and Image Processing Units (IPUs).

Table of Contents

1. Supported Sensors
2. Supported Ubuntu and Kernel Version
3. Directory Structure
4. Getting Started Guide
5. Software Dependencies
6. Setup Procedure
   • Kernel Driver DKMS Build
   • BIOS Configuration
   • Sensor XML Configuration File Setup
   • Setup Verification
7. Contributing
8. Security
9. Code of Conduct

Supported Sensors

Sensor	Sensor Type	Vendor	IPU Version
AR0233+GW5300	GMSL	Sensing	IPU6EPMTL, IPU75XA
AR0234	GMSL	D3 Embedded	IPU6EPMTL
AR0234	MIPI CSI-2	D3 Embedded	IPU6EPMTL
AR0820+GW5300	GMSL	Sensing	IPU6EPMTL, IPU75XA
AR0830+AP1302	MIPI CSI-2	Leopard Imaging	IPU6EPMTL, IPU75XA
ISX031	GMSL	D3 Embedded	IPU6EP, IPU6EPMTL, IPU75XA, IPU8
ISX031	GMSL	Leopard Imaging	IPU6EP, IPU6EPMTL, IPU75XA, IPU8
ISX031	GMSL	Sensing	IPU6EP, IPU6EPMTL, IPU75XA
ISX031	MIPI CSI-2	D3 Embedded	IPU6EP, IPU6EPMTL, IPU75XA, IPU8
ISX031	MIPI CSI-2	Sensing	IPU6EP, IPU6EPMTL, IPU75XA
IMX415	MIPI CSI-2	Leopard Imaging	IPU6EPMTL
IMX586	MIPI CSI-2	Leopard Imaging	IPU6EPMTL
OV13B10	MIPI CSI-2	Leopard Imaging	IPU8

Note:
IPU6EP represents ADL, TWL, ASL and RPL platforms;
IPU6EPMTL represents MTL and ARL platforms;
IPU75XA represents PTL platforms;
IPU8 represents NVL platforms.

Supported Ubuntu and Kernel Version

IPU Version	Ubuntu Version	Kernel Version
IPU6EP / IPU6EPMTL	24.04.4	6.12 Intel BKC
	24.04.4	6.17 Canonical
	26.04	7.0 Canonical
IPU75XA	24.04.4	6.17 Intel BKC
	24.04.4	6.17 Canonical
	26.04	7.0 Canonical
IPU8	24.04.4	6.18 Intel BKC
	24.04.4	7.0 IOT Next

Directory Structure

Directory	Description
drivers/	Host Linux kernel drivers for supported sensors
config/	Host middleware configuration files
doc/	Documentation guide for kernelspace and userspace configuration
include/	Header files for driver compilation
acpi/	Host ASL source files for different configurations

Getting Started Guide

1. Download Getting Started Guide (table below), and setup according to your target Platform.
2. Inside the guide, follow all instructions under section Getting Started with Ubuntu with Kernel Overlay.
3. Under section Auto Script Installation, download and use Ubuntu Kernel Overlay Auto Installar Script from platform-respective Software Packages.

Note: All collaterals belows can be downloaded in rdc.intel.com with proper granted access.

Platform	Getting Started Guide	Software Package
ARL	828853	831484
MTL	779460	790840
TWL	793827	803960
PTL	858119	871556

Reference: Intel® IPU6 Enabling Partners Technical Collaterals Advisory

Software Dependencies

Install these software dependencies in your target system:

• ipu-camera-bins (E.g. ipu6-camera-bins / ipu7-camera-bins)
• ipu-camera-hal (E.g. ipu6-camera-hal / ipu7-camera-hal)
• icamerasrc

IPU Version	ipu-camera-bins	ipu-camera-hal	icamerasrc
IPU6	d9421fef539f24fc80c27002d5da753e193b0670	f93eec544a5234bf0b610b3f76d64c8fa711c364	867c5b6ab7925c9b69b8374873a832266d97d7e5
IPU7	d235697c3bb41d56402d4805a7b82fdc938c077a	ea085c325e7a67a811a0baa5ce2d1b8f5641ea02	867c5b6ab7925c9b69b8374873a832266d97d7e5

Setup Procedure

Kernel Driver DKMS Build

Initialize and update current repository recursively to ensure all dependencies are correctly fetched.

git checkout main
git submodule update --init --recursive

Build and install modules using DKMS

sudo dkms remove ipu-camera-sensor/0.1
sudo rm -rf /usr/src/ipu-camera-sensor-0.1/

sudo dkms add .
sudo dkms build -m ipu-camera-sensor -v 0.1
sudo dkms install -m ipu-camera-sensor -v 0.1 --force

BIOS Configuration

1. Power cycle target system with sensors connected.
2. Import sensor profile into BIOS, under section BIOS Configuration Table in recommended userspace.md.
   • E.g. ISX031 GMSL using userspace-gmsl.md
   • E.g. AR0234 MIPI using userspace-mipi.md

Camera Configuration File Setup

Setup camera configuration file under section Camera Configuration File Setup in recommended userspace.md.

Setup Verification

Verify sensor setup using media-ctl.

Note: Minimum version required = (1.30)

Contributing

Please read CONTRIBUTING.md for guidelines on contributing to this project.

Security

For security concerns, please see SECURITY.md.

Code of Conduct

This project follows our Code of Conduct.

(back to top)