1.. SPDX-License-Identifier: GPL-2.0 2 3.. include:: <isonum.txt> 4 5==================================== 6AMD Image Signal Processor (amdisp4) 7==================================== 8 9Introduction 10============ 11 12This file documents the driver for the AMD ISP4 that is part of 13AMD Ryzen AI Max 300 Series. 14 15The driver is located under drivers/media/platform/amd/isp4 and uses 16the Media-Controller API. 17 18The driver exposes one video capture device to userspace and provide 19web camera like interface. Internally the video device is connected 20to the isp4 sub-device responsible for communication with the CCPU FW. 21 22Topology 23======== 24 25.. _amdisp4_topology_graph: 26 27.. kernel-figure:: amdisp4.dot 28 :alt: Diagram of the media pipeline topology 29 :align: center 30 31 32 33The driver has 1 sub-device: Representing isp4 image signal processor. 34The driver has 1 video device: Capture device for retrieving images. 35 36- ISP4 Image Signal Processing Subdevice Node 37 38--------------------------------------------- 39 40The isp4 is represented as a single V4L2 subdev, the sub-device does not 41provide interface to the user space. The sub-device is connected to one video node 42(isp4_capture) with immutable active link. The sub-device represents ISP with 43connected sensor similar to smart cameras (sensors with integrated ISP). 44sub-device has only one link to the video device for capturing the frames. 45The sub-device communicates with CCPU FW for streaming configuration and 46buffer management. 47 48 49- isp4_capture - Frames Capture Video Node 50 51------------------------------------------ 52 53Isp4_capture is a capture device to capture frames to memory. 54The entity is connected to isp4 sub-device. The video device 55provides web camera like interface to userspace. It supports 56mmap and dma buf types of memory. 57 58Capturing Video Frames Example 59============================== 60 61.. code-block:: bash 62 63 v4l2-ctl "-d" "/dev/video0" "--set-fmt-video=width=1920,height=1080,pixelformat=NV12" "--stream-mmap" "--stream-count=10" 64