ipu6-drivers

This repository supports MIPI cameras through the IPU6 on Intel Tiger Lake and Alder Lake platforms. There are 4 repositories that provide the complete setup:

• https://github.com/intel/ipu6-drivers - kernel drivers for the IPU and sensors
• https://github.com/intel/ipu6-camera-hal - HAL for processing of images in userspace
• https://github.com/intel/ipu6-camera-bins - IPU firmware and proprietary image processing libraries
• https://github.com/intel/icamerasrc (branch:icamerasrc_slim_api) - Gstreamer src plugin

Content of this repository:

• IPU6 kernel driver
• Drivers for HM11B1, OV01A1S, OV01A10 and OV02C10 sensors

Build instructions:

Three ways are available:

1. build with kernel source tree
2. build out of kernel source tree
3. and build with dkms

1. Build with kernel source tree

• Tested with kernel 5.15

• Check out kernel

• Patch the diff files in patch folder

• Copy repo content to kernel source

• Modify related Kconfig and Makefile

• Add config in LinuxRoot/drivers/media/i2c/Kconfig (for kernel 5.18+, use VIDEO_DEV instead of VIDEO_V4L2 in depends on section)

   config POWER_CTRL_LOGIC
   	tristate "power control logic driver"
   	depends on GPIO_ACPI
   	help
   	  This is a power control logic driver for sensor, the design
   	  depends on camera sensor connections.
   	  This driver controls power by getting and using managed GPIO
   	  pins from ACPI config for sensors, such as HM11B1, OV01A1S.
  
   	  To compile this driver as a module, choose M here: the
   	  module will be called power_ctrl_logic.
  
   config VIDEO_OV01A1S
   	tristate "OmniVision OV01A1S sensor support"
   	depends on POWER_CTRL_LOGIC
   	depends on VIDEO_V4L2 && I2C
   	depends on ACPI || COMPILE_TEST
   	select MEDIA_CONTROLLER
   	select VIDEO_V4L2_SUBDEV_API
   	select V4L2_FWNODE
   	help
   	  This is a Video4Linux2 sensor driver for the OmniVision
   	  OV01A1S camera.
  
   	  To compile this driver as a module, choose M here: the
   	  module will be called ov01a1s.
  
   config VIDEO_HM11B1
   	tristate "Himax HM11B1 sensor support"
   	depends on POWER_CTRL_LOGIC
   	depends on VIDEO_V4L2 && I2C
   	select MEDIA_CONTROLLER
   	select VIDEO_V4L2_SUBDEV_API
   	select V4L2_FWNODE
   	help
   	  This is a Video4Linux2 sensor driver for the Himax
   	  HM11B1 camera.
  
   	  To compile this driver as a module, choose M here: the
   	  module will be called hm11b1.
  
   config VIDEO_OV01A10
   	tristate "OmniVision OV01A10 sensor support"
   	depends on VIDEO_V4L2 && I2C
   	depends on ACPI || COMPILE_TEST
   	select MEDIA_CONTROLLER
   	select VIDEO_V4L2_SUBDEV_API
   	select V4L2_FWNODE
   	help
   	  This is a Video4Linux2 sensor driver for the OmniVision
   	  OV01A10 camera.
  
   	  To compile this driver as a module, choose M here: the
   	  module will be called ov01a10.
  
   config VIDEO_OV02C10
   	tristate "OmniVision OV02C10 sensor support"
   	depends on VIDEO_V4L2 && I2C
   	depends on ACPI || COMPILE_TEST
   	select MEDIA_CONTROLLER
   	select VIDEO_V4L2_SUBDEV_API
   	select V4L2_FWNODE
   	help
   	  This is a Video4Linux2 sensor driver for the OmniVision
   	  OV02C10 camera.
  
   	  To compile this driver as a module, choose M here: the
   	  module will be called ov02c10.
  
  

• Add to drivers/media/i2c/Makefile

   obj-$(CONFIG_POWER_CTRL_LOGIC) += power_ctrl_logic.o
   obj-$(CONFIG_VIDEO_OV01A1S) += ov01a1s.o
   obj-$(CONFIG_VIDEO_HM11B1)  += hm11b1.o
   obj-$(CONFIG_VIDEO_OV01A10) += ov01a10.o
   obj-$(CONFIG_VIDEO_OV02C10) += ov02c10.o

• Modify drivers/media/pci/Kconfig

   # replace line:
   # source "drivers/media/pci/intel/ipu3/Kconfig"
   # with line:
   source "drivers/media/pci/intel/Kconfig"
  

• Enable the following settings in .config

   CONFIG_VIDEO_INTEL_IPU6=m
   CONFIG_POWER_CTRL_LOGIC=m
   CONFIG_VIDEO_OV01A1S=m
   CONFIG_VIDEO_OV01A10=m
   CONFIG_VIDEO_HM11B1=m
   CONFIG_VIDEO_OV02C10=m
  

• LJCA and CVF part as below, refer to https://github.com/intel/ivsc-driver/blob/main/README.md

   CONFIG_MFD_LJCA=m
   CONFIG_I2C_LJCA=m
   CONFIG_SPI_LJCA=m
   CONFIG_GPIO_LJCA=m
   CONFIG_INTEL_MEI_VSC=m
   CONFIG_INTEL_VSC=m
   CONFIG_INTEL_VSC_CSI=m
   CONFIG_INTEL_VSC_ACE=m
   CONFIG_INTEL_VSC_PSE=m
   CONFIG_INTEL_VSC_ACE_DEBUG=m
  

2. Build outside kernel source tree

• Requires 5.15 kernel header installed on compiling machine

• To compile:

   $cd ipu6-drivers
   $make -j`nproc`

• To install and use modules

   $sudo make modules_install
   $sudo depmod -a

3. Build with dkms

a dkms.conf file is also provided as an example for building with dkms which can be used by dkms add, build and install.