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
ISX031	GMSL	Leopard Imaging	IPU6EP, IPU6EPMTL, IPU75XA
ISX031	GMSL	Sensing	IPU6EP, IPU6EPMTL, IPU75XA
ISX031	MIPI CSI-2	D3 Embedded	IPU6EP, IPU6EPMTL, IPU75XA

Note:
IPU6EP represents ADL, TWL, ASL and RPL platforms;
IPU6EPMTL represents MTL and ARL platforms;
IPU75XA represents PTL 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
IPU75XA	24.04.4	6.17 Intel BKC
	24.04.4	6.17 Canonical

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

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	0b102acf2d95f86ec85f0299e0dc779af5fdfb81	a647a0a0c660c1e43b00ae9e06c0a74428120f3a	4fb31db76b618aae72184c59314b839dedb42689
IPU7	2ef0857570b2dde3c2072fdacf22fdfff1a89bf2	3b9388ecdb682b6e7e9f57a4192b4612bfb43410	4fb31db76b618aae72184c59314b839dedb42689

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)