Hello everyone,
This patch series adds a driver for Intel IPU6 input system.
IPU6 is the sixth generation of Imaging Processing Unit, it is a PCI
device which can be found in some Intel Client Platforms. User can use
IPU6 to capture images from MIPI camera sensors.
IPU6 has its own firmware which exposes ABIs to driver, and communicates
with CSE to do firmware authentication. IPU6 has its MMU hardware, so
the driver sets up a page table to allow IPU6 DMA to access the system
memory.
IPU6 input system driver uses MC and V4L2 sub-device APIs besides V4L2.
I can now capture images from ov01a10 and ov2740 sensors (including
metadata from the latter).
v4l2-compliance passes now:
v4l2-compliance 1.27.0-5198, 64 bits, 64-bit time_t
v4l2-compliance SHA: 8eaf0a14db34 2024-04-25 08:41:42
Compliance test for isys device /dev/video0:
Driver Info:
Driver name : isys
Card type : ipu6
Bus info : PCI:0000:00:05.0
Driver version : 6.9.0
Capabilities : 0xa4a00001
Video Capture
Metadata Capture
I/O MC
Streaming
Extended Pix Format
Device Capabilities
Device Caps : 0x24a00001
Video Capture
Metadata Capture
I/O MC
Streaming
Extended Pix Format
Media Driver Info:
Driver name : intel-ipu6
Model : ipu6
Serial :
Bus info : PCI:0000:00:05.0
Media version : 6.9.0
Hardware revision: 0x17aa22e7 (397026023)
Driver version : 6.9.0
Interface Info:
ID : 0x03000003
Type : V4L Video
Entity Info:
ID : 0x00000001 (1)
Name : Intel IPU6 ISYS Capture 0
Function : V4L2 I/O
Pad 0x01000002 : 0: Sink, Must Connect
Link 0x020000a9: from remote pad 0x1000083 of entity 'Intel IPU6 CSI2 0' (Video Interface Bridge): Data
Required ioctls:
test MC information (see 'Media Driver Info' above): OK
test VIDIOC_QUERYCAP: OK
test invalid ioctls: OK
Allow for multiple opens:
test second /dev/video0 open: OK
test VIDIOC_QUERYCAP: OK
test VIDIOC_G/S_PRIORITY: OK
test for unlimited opens: OK
Debug ioctls:
test VIDIOC_DBG_G/S_REGISTER: OK (Not Supported)
test VIDIOC_LOG_STATUS: OK (Not Supported)
Input ioctls:
test VIDIOC_G/S_TUNER/ENUM_FREQ_BANDS: OK (Not Supported)
test VIDIOC_G/S_FREQUENCY: OK (Not Supported)
test VIDIOC_S_HW_FREQ_SEEK: OK (Not Supported)
test VIDIOC_ENUMAUDIO: OK (Not Supported)
test VIDIOC_G/S/ENUMINPUT: OK
test VIDIOC_G/S_AUDIO: OK (Not Supported)
Inputs: 1 Audio Inputs: 0 Tuners: 0
Output ioctls:
test VIDIOC_G/S_MODULATOR: OK (Not Supported)
test VIDIOC_G/S_FREQUENCY: OK (Not Supported)
test VIDIOC_ENUMAUDOUT: OK (Not Supported)
test VIDIOC_G/S/ENUMOUTPUT: OK (Not Supported)
test VIDIOC_G/S_AUDOUT: OK (Not Supported)
Outputs: 0 Audio Outputs: 0 Modulators: 0
Input/Output configuration ioctls:
test VIDIOC_ENUM/G/S/QUERY_STD: OK (Not Supported)
test VIDIOC_ENUM/G/S/QUERY_DV_TIMINGS: OK (Not Supported)
test VIDIOC_DV_TIMINGS_CAP: OK (Not Supported)
test VIDIOC_G/S_EDID: OK (Not Supported)
Control ioctls (Input 0):
test VIDIOC_QUERY_EXT_CTRL/QUERYMENU: OK (Not Supported)
test VIDIOC_QUERYCTRL: OK (Not Supported)
test VIDIOC_G/S_CTRL: OK (Not Supported)
test VIDIOC_G/S/TRY_EXT_CTRLS: OK (Not Supported)
test VIDIOC_(UN)SUBSCRIBE_EVENT/DQEVENT: OK (Not Supported)
test VIDIOC_G/S_JPEGCOMP: OK (Not Supported)
Standard Controls: 0 Private Controls: 0
Format ioctls (Input 0):
test VIDIOC_ENUM_FMT/FRAMESIZES/FRAMEINTERVALS: OK
test VIDIOC_G/S_PARM: OK (Not Supported)
test VIDIOC_G_FBUF: OK (Not Supported)
test VIDIOC_G_FMT: OK
test VIDIOC_TRY_FMT: OK
test VIDIOC_S_FMT: OK
test VIDIOC_G_SLICED_VBI_CAP: OK (Not Supported)
test Cropping: OK (Not Supported)
test Composing: OK (Not Supported)
test Scaling: OK (Not Supported)
Codec ioctls (Input 0):
test VIDIOC_(TRY_)ENCODER_CMD: OK (Not Supported)
test VIDIOC_G_ENC_INDEX: OK (Not Supported)
test VIDIOC_(TRY_)DECODER_CMD: OK (Not Supported)
Buffer ioctls (Input 0):
test VIDIOC_REQBUFS/CREATE_BUFS/QUERYBUF: OK
test CREATE_BUFS maximum buffers: OK
test VIDIOC_REMOVE_BUFS: OK
test VIDIOC_EXPBUF: OK
test Requests: OK (Not Supported)
Total for isys device /dev/video0: 48, Succeeded: 48, Failed: 0, Warnings: 0
---
since v6:
- Fix firmware ABI kernel-doc.
- Make CSI-2 port / PHY ids int for negative error codes.
- Don't set alloc_devs[] in query_setup.
- Fix default format configuration and format enumeration
- Set minimum number of VB2 buffers to 1, keep the sanity check
- Return EBUSY from VIDIOC_S_FMT if the VB2 queue is streaming.
since v5:
- Address a compilation issue in an intermediate patch. No diff on top of
the set compared to v5.
since v4:
- Move to single-planar buffers. The reason for using multi-planar buffers
no longer exists.
- Clean up buffer setup and format access code.
- Align isys function naming (ipu6 prefix to ipu6_isys prefix).
- Separate formats for pixel and meta buffer types. This seems to be
assumed by the V4L2 spec and v4l2-compliance.
- Disable user-settable bytesperline for now. This may be allowed later
on. (For v4l2-compliance.)
- Enumerate formats valid for a given buffer type only. (For
v4l2-compliance.)
- The minimum image size earlier did not satisfy alignment requirements.
It's now 2x2 (was 1x1).
- Fix frame size enumeration type (CONTINUOUS -> STEPWISE).
- Use the PCI device as the device for V4L2 device.
- Obtain IPU6 ISYS format information dynamically instead of storing it in
the device context struct.
- Drop the patch selecting MEDIA_CONTROLLER when VIDEO_V4L2_SUBDEV_API is
selected. It doesn't belong to this set (although is nice otherwise).
Select MEDIA_CONTROLLER separately for IPU6.
- Align subject line prefixes to "media: ".
since v3:
- Prepend the series with IPU bridge changes for more reliable
IPU bridge initialisation.
- Split off the IPU6 PCI device ID table (due to the former change).
- Documentation improvements (mostly non-technical).
- Update copyright year.
- Remove unused struct ipu6_buttress_constraint and a few other unused
definitions.
- Miscellaneous cleanups.
- Make functions static if they can be so.
- Merge watermark setup error handling bugfix from Hongju.
- Use media_pad_remote_pad_unique() instead of
media_pad_remote_pad_first() in figuring out the remote sub-device.
- Determine the number of queues by counting the video nodes in the graph.
- Make the links from the external sub-devices to CSI-2 receivers enabled
and immutable.
- Simplify determining CSI-2 port control base port offset.
- Create only as many links as needed between CSI-2 receivers and video
nodes (one per video node).
v2 -> v3:
- Add line-based metadata capture support
- Fix header files inclusion issues
- Fix the CSI2 timing calculation
- Fix crash when remove module during streaming
- Remove some unused code
- Use cross-referencing links in documentation
- Update Makefile to use ":=" for objects
- Fix several bugs and coding style issues
v1 -> v2:
- Add multiplexed streams support
- Use auxiliary bus to register IPU6 devices
- Add IPU6 hardware and driver overview documentation
- Updata IPU6 admin-guide documentation
- Update number of source pads and video nodes to support
multiplexed streams
TODOs:
- Add firmware CSI2 lanes configuration verification
Bingbu Cao (16):
media: intel/ipu6: add Intel IPU6 PCI device driver
media: intel/ipu6: add IPU auxiliary devices
media: intel/ipu6: add IPU6 buttress interface driver
media: intel/ipu6: CPD parsing for get firmware components
media: intel/ipu6: add IPU6 DMA mapping API and MMU table
media: intel/ipu6: add syscom interfaces between firmware and driver
media: intel/ipu6: input system ABI between firmware and driver
media: intel/ipu6: add IPU6 CSI2 receiver v4l2 sub-device
media: intel/ipu6: add the CSI2 DPHY implementation
media: intel/ipu6: input system video nodes and buffer queues
media: intel/ipu6: add the main input system driver
media: intel/ipu6: add Kconfig and Makefile
media: MAINTAINERS: add maintainers for Intel IPU6 input system driver
media: intel/ipu6: support line-based metadata capture support
media: Documentation: add Intel IPU6 ISYS driver admin-guide doc
media: Documentation: add documentation of Intel IPU6 driver and
hardware overview
Sakari Ailus (2):
media: ipu6: Add PCI device table header
media: ivsc: csi: Use IPU bridge
Documentation/admin-guide/media/ipu6-isys.rst | 161 ++
.../admin-guide/media/ipu6_isys_graph.svg | 548 +++++++
.../admin-guide/media/v4l-drivers.rst | 1 +
.../driver-api/media/drivers/index.rst | 1 +
.../driver-api/media/drivers/ipu6.rst | 205 +++
MAINTAINERS | 10 +
drivers/media/pci/intel/Kconfig | 1 +
drivers/media/pci/intel/Makefile | 1 +
drivers/media/pci/intel/ipu6/Kconfig | 18 +
drivers/media/pci/intel/ipu6/Makefile | 23 +
drivers/media/pci/intel/ipu6/ipu6-bus.c | 165 ++
drivers/media/pci/intel/ipu6/ipu6-bus.h | 58 +
drivers/media/pci/intel/ipu6/ipu6-buttress.c | 912 +++++++++++
drivers/media/pci/intel/ipu6/ipu6-buttress.h | 92 ++
drivers/media/pci/intel/ipu6/ipu6-cpd.c | 362 +++++
drivers/media/pci/intel/ipu6/ipu6-cpd.h | 105 ++
drivers/media/pci/intel/ipu6/ipu6-dma.c | 502 ++++++
drivers/media/pci/intel/ipu6/ipu6-dma.h | 19 +
drivers/media/pci/intel/ipu6/ipu6-fw-com.c | 413 +++++
drivers/media/pci/intel/ipu6/ipu6-fw-com.h | 47 +
drivers/media/pci/intel/ipu6/ipu6-fw-isys.c | 487 ++++++
drivers/media/pci/intel/ipu6/ipu6-fw-isys.h | 596 +++++++
drivers/media/pci/intel/ipu6/ipu6-isys-csi2.c | 663 ++++++++
drivers/media/pci/intel/ipu6/ipu6-isys-csi2.h | 82 +
.../media/pci/intel/ipu6/ipu6-isys-dwc-phy.c | 536 +++++++
.../media/pci/intel/ipu6/ipu6-isys-jsl-phy.c | 242 +++
.../media/pci/intel/ipu6/ipu6-isys-mcd-phy.c | 720 +++++++++
.../media/pci/intel/ipu6/ipu6-isys-queue.c | 810 ++++++++++
.../media/pci/intel/ipu6/ipu6-isys-queue.h | 78 +
.../media/pci/intel/ipu6/ipu6-isys-subdev.c | 403 +++++
.../media/pci/intel/ipu6/ipu6-isys-subdev.h | 59 +
.../media/pci/intel/ipu6/ipu6-isys-video.c | 1420 +++++++++++++++++
.../media/pci/intel/ipu6/ipu6-isys-video.h | 141 ++
drivers/media/pci/intel/ipu6/ipu6-isys.c | 1367 ++++++++++++++++
drivers/media/pci/intel/ipu6/ipu6-isys.h | 206 +++
drivers/media/pci/intel/ipu6/ipu6-mmu.c | 845 ++++++++++
drivers/media/pci/intel/ipu6/ipu6-mmu.h | 73 +
.../intel/ipu6/ipu6-platform-buttress-regs.h | 226 +++
.../intel/ipu6/ipu6-platform-isys-csi2-reg.h | 172 ++
.../media/pci/intel/ipu6/ipu6-platform-regs.h | 179 +++
drivers/media/pci/intel/ipu6/ipu6.c | 895 +++++++++++
drivers/media/pci/intel/ipu6/ipu6.h | 342 ++++
drivers/media/pci/intel/ivsc/mei_csi.c | 20 +-
include/media/ipu6-pci-table.h | 28 +
44 files changed, 14232 insertions(+), 2 deletions(-)
create mode 100644 Documentation/admin-guide/media/ipu6-isys.rst
create mode 100644 Documentation/admin-guide/media/ipu6_isys_graph.svg
create mode 100644 Documentation/driver-api/media/drivers/ipu6.rst
create mode 100644 drivers/media/pci/intel/ipu6/Kconfig
create mode 100644 drivers/media/pci/intel/ipu6/Makefile
create mode 100644 drivers/media/pci/intel/ipu6/ipu6-bus.c
create mode 100644 drivers/media/pci/intel/ipu6/ipu6-bus.h
create mode 100644 drivers/media/pci/intel/ipu6/ipu6-buttress.c
create mode 100644 drivers/media/pci/intel/ipu6/ipu6-buttress.h
create mode 100644 drivers/media/pci/intel/ipu6/ipu6-cpd.c
create mode 100644 drivers/media/pci/intel/ipu6/ipu6-cpd.h
create mode 100644 drivers/media/pci/intel/ipu6/ipu6-dma.c
create mode 100644 drivers/media/pci/intel/ipu6/ipu6-dma.h
create mode 100644 drivers/media/pci/intel/ipu6/ipu6-fw-com.c
create mode 100644 drivers/media/pci/intel/ipu6/ipu6-fw-com.h
create mode 100644 drivers/media/pci/intel/ipu6/ipu6-fw-isys.c
create mode 100644 drivers/media/pci/intel/ipu6/ipu6-fw-isys.h
create mode 100644 drivers/media/pci/intel/ipu6/ipu6-isys-csi2.c
create mode 100644 drivers/media/pci/intel/ipu6/ipu6-isys-csi2.h
create mode 100644 drivers/media/pci/intel/ipu6/ipu6-isys-dwc-phy.c
create mode 100644 drivers/media/pci/intel/ipu6/ipu6-isys-jsl-phy.c
create mode 100644 drivers/media/pci/intel/ipu6/ipu6-isys-mcd-phy.c
create mode 100644 drivers/media/pci/intel/ipu6/ipu6-isys-queue.c
create mode 100644 drivers/media/pci/intel/ipu6/ipu6-isys-queue.h
create mode 100644 drivers/media/pci/intel/ipu6/ipu6-isys-subdev.c
create mode 100644 drivers/media/pci/intel/ipu6/ipu6-isys-subdev.h
create mode 100644 drivers/media/pci/intel/ipu6/ipu6-isys-video.c
create mode 100644 drivers/media/pci/intel/ipu6/ipu6-isys-video.h
create mode 100644 drivers/media/pci/intel/ipu6/ipu6-isys.c
create mode 100644 drivers/media/pci/intel/ipu6/ipu6-isys.h
create mode 100644 drivers/media/pci/intel/ipu6/ipu6-mmu.c
create mode 100644 drivers/media/pci/intel/ipu6/ipu6-mmu.h
create mode 100644 drivers/media/pci/intel/ipu6/ipu6-platform-buttress-regs.h
create mode 100644 drivers/media/pci/intel/ipu6/ipu6-platform-isys-csi2-reg.h
create mode 100644 drivers/media/pci/intel/ipu6/ipu6-platform-regs.h
create mode 100644 drivers/media/pci/intel/ipu6/ipu6.c
create mode 100644 drivers/media/pci/intel/ipu6/ipu6.h
create mode 100644 include/media/ipu6-pci-table.h
base-commit: 93fbe33941841718af85a33adcdcf27387d51b67
--
2.39.2
