Skip to content

PhilDevProg/ipu6-drivers

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ipu6-drivers

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

Content of this repository:

  • IPU6 kernel driver
  • Kernel patches needed
  • Drivers for HM11B1, OV01A1S, OV01A10, OV02C10, OV02E10, OV2740, HM2170, HM2172 and HI556 sensors

Dependencies

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 v6.4

  • Check out kernel

  • Apply patches:

     # For Meteor Lake B stepping only
     patch/0002-iommu-Add-passthrough-for-MTL-IPU.patch
    
     # For v5.15 <= kernel version < v5.17 and using INT3472
     patch/int3472-v5.15/*.patch
    
     # For v5.17 <= kernel version < v6.1.7 and using INT3472
     patch/int3472-v5.17/*.patch
    
     # For kernel version >= 6.1.7 and using INT3472
     patch/int3472-v6.1.7/*.patch
    
     # For kernel version >= 6.3 and using ov13b10
     patch/ov13b10-v6.3/*.patch
  • Copy repo content to kernel source (except Makefile and drivers/media/i2c/{Kconfig,Makefile}, will change manually next)

  • Modify related Kconfig and Makefile

  • Add config in LinuxRoot/drivers/media/i2c/Kconfig (for kernel version < 5.18, use VIDEO_V4L2 instead of VIDEO_DEV 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 VIDEO_DEV && 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 VIDEO_DEV && 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_DEV && 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_DEV && 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.
    
     config VIDEO_OV02E10
     	tristate "OmniVision OV02E10 sensor support"
     	depends on VIDEO_DEV && 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
     	  OV02E10 camera.
    
     	  To compile this driver as a module, choose M here: the
     	  module will be called ov02e10.
    
     config VIDEO_OV13858_INTEL
     	tristate "OmniVision OV13858 sensor support"
     	depends on VIDEO_DEV && 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
     	  OV13858 camera.
    
     	  To compile this driver as a module, choose M here: the
     	  module will be called ov13858_intel.
    
     config VIDEO_HM2170
     	tristate "Himax HM2170 sensor support"
     	depends on VIDEO_DEV && I2C
     	select MEDIA_CONTROLLER
     	select VIDEO_V4L2_SUBDEV_API
     	select V4L2_FWNODE
     	help
     		This is a Video4Linux2 sensor driver for the Himax
     		HM2170 camera.
    
     		To compile this driver as a module, choose M here: the
     		module will be called hm2170.
    
     config VIDEO_HM2172
     	tristate "Himax HM2172 sensor support"
     	depends on VIDEO_DEV && I2C
     	select MEDIA_CONTROLLER
     	select VIDEO_V4L2_SUBDEV_API
     	select V4L2_FWNODE
     	help
     		This is a Video4Linux2 sensor driver for the Himax
     		HM2170 camera.
    
     		To compile this driver as a module, choose M here: the
     		module will be called hm2172.
    
    
  • 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
     obj-$(CONFIG_VIDEO_OV02E10) += ov02e10.o
     obj-$(CONFIG_VIDEO_OV13858_INTEL) += ov13858_intel.o
     obj-$(CONFIG_VIDEO_HM2170) += hm2170.o
     obj-$(CONFIG_VIDEO_HM2170) += hm2172.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_IPU_ISYS_BRIDGE=y
     CONFIG_VIDEO_OV01A1S=m
     CONFIG_VIDEO_OV01A10=m
     CONFIG_VIDEO_HM11B1=m
     CONFIG_VIDEO_OV02C10=m
     CONFIG_VIDEO_OV02E10=m
     CONFIG_VIDEO_OV13858_INTEL = m
     CONFIG_VIDEO_HM2170=m
     CONFIG_VIDEO_HM2172=m
     # Set this only if you use only 1 camera and don't want too many device nodes in media-ctl
     # CONFIG_IPU_SINGLE_BE_SOC_DEVICE=y
     # If your kernel < 5.15 or not set CONFIG_INTEL_SKL_INT3472, please set this
     # CONFIG_POWER_CTRL_LOGIC=m
    
  • LJCA and CVF part as below, please check details at 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 kernel header installed on build machine

  • Requires iVSC driver be built together

  • To prepare dependency:

     cd ipu6-drivers
     git clone https://github.com/intel/ivsc-driver.git
     cp -r ivsc-driver/backport-include ivsc-driver/drivers ivsc-driver/include .
     rm -rf ivsc-driver
  • To build and install:

     make -j`nproc` && sudo make modules_install && sudo depmod -a

3. Build with dkms

  • Prepare dependency:

     cd ipu6-drivers
     git clone https://github.com/intel/ivsc-driver.git
     cp -r ivsc-driver/backport-include ivsc-driver/drivers ivsc-driver/include .
     rm -rf ivsc-driver
  • Register, build and auto install:

     sudo dkms add .
     sudo dkms autoinstall ipu6-drivers/0.0.0

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C 99.6%
  • Makefile 0.4%