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
   • Camera Configuration File Setup
   • Setup Verification
7. Contributing
8. Security
9. Code of Conduct
10. License

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, IPU75XA, IPU8
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
	24.04.4	6.18 Intel BKC
	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	cead7320d84ee9ade4f60d74e935b16b5a760945	ef30767553685b83034e42325992a2442c5fcb2c	867c5b6ab7925c9b69b8374873a832266d97d7e5
IPU8	adf55525ab9d370828723b1ff8bee76ed7a492e8	fd1efb6f2ef25fd24775a303cc71af6139d797eb	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

Note: Workaround required for IPU7/IPU8 RAW sensor due to tuning dependency.

By default, ipu7-drivers submodule tracks the tip of its main branch. For IPU75XA,

cd ipu7-drivers
git checkout 44bbc2de71fe5e7a5a7124d4c5e5900e70e13736
cd ..

For IPU8,

cd ipu7-drivers
git checkout bed9b71d5be56d0e24c771c7a6ec83fd0a9db433
cd ..

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.

License

Files in config/ and script/ are licensed under the Apache License 2.0. See LICENSE-APACHE for details.

Files in acpi/, drivers/ and include/ are licensed under the GPL-2.0 License. See LICENSE-GPL for details.

(back to top)