From patchwork Tue Sep 10 08:07:06 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Tomi Valkeinen X-Patchwork-Id: 13798159 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 062DEECE58D for ; Tue, 10 Sep 2024 09:15:39 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender:List-Subscribe:List-Help :List-Post:List-Archive:List-Unsubscribe:List-Id:Cc:To:In-Reply-To:References :Message-Id:Content-Transfer-Encoding:Content-Type:MIME-Version:Subject:Date: From:Reply-To:Content-ID:Content-Description:Resent-Date:Resent-From: Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Owner; bh=Qrs2P5OJlmr0lgBiFqTQyhVZyN18HkIExX3lKJ6sUb0=; b=wB6zfhQvMsYJpnyu7rWzaQt7pk PZYnEoIjNKw1N7UHrcMqLzuB8S5fJNnhFB7pmy9/Y5OPhNxvFq71IuwItilX7t8HbOXzSx/C/RHic QTLkxl7KAjzFEsgRGL7WRVBIin9J9Ng1lnipI9OfKEr0y47OAa0FeZvAch3l6lHCOveTyXCeWHcb9 OyyEhxGHCTE2oulMbciZ0z5Fhl7FOPYYPT2eeqda+m2r2ZFGDInW+QCAk0rehHi+o8Gxq52iztS7t udL0bSQaWwvIGIUYrUdP1tcKrmEaADFC+jSH5X+x/F3hQULZD1T4XIluWxGH5M0rWTbl6z1d3u2Mt bVPRsLtA==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.97.1 #2 (Red Hat Linux)) id 1snwyA-00000004yD3-45r6; Tue, 10 Sep 2024 09:15:30 +0000 Received: from perceval.ideasonboard.com ([213.167.242.64]) by bombadil.infradead.org with esmtps (Exim 4.97.1 #2 (Red Hat Linux)) id 1snvuR-00000004jlU-1m4Y; Tue, 10 Sep 2024 08:08:14 +0000 Received: from [127.0.1.1] (91-156-87-48.elisa-laajakaista.fi [91.156.87.48]) by perceval.ideasonboard.com (Postfix) with ESMTPSA id 457AAC8A; Tue, 10 Sep 2024 10:06:14 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com; s=mail; t=1725955575; bh=bn7hb6abGotN+zJtZ8HsRWN0WBNQG9WEsGLPob3ZvdA=; h=From:Date:Subject:References:In-Reply-To:To:Cc:From; b=f2BduO9y5nb0yDaz2fX72wSqKmnWT17ZuA2XrzhbhIcuzqUdU8fN0f5jjfNnqEjp6 PSxbsQ8LEYtuVFEYZ7GYDkcrnsk4It5gRxlX56QIrGMhhhoXCx4sZhBMjqY06GQdHi z3xaNwgliPzeNzMMMO29IO2WaHUMH+N5EquEdBfI= From: Tomi Valkeinen Date: Tue, 10 Sep 2024 11:07:06 +0300 Subject: [PATCH v5 1/4] media: uapi: Add meta formats for PiSP FE config and stats MIME-Version: 1.0 Message-Id: <20240910-rp1-cfe-v5-1-9ab4c4c8eace@ideasonboard.com> References: <20240910-rp1-cfe-v5-0-9ab4c4c8eace@ideasonboard.com> In-Reply-To: <20240910-rp1-cfe-v5-0-9ab4c4c8eace@ideasonboard.com> To: Mauro Carvalho Chehab , Raspberry Pi Kernel Maintenance , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Florian Fainelli , Broadcom internal kernel review list , Rob Herring , Krzysztof Kozlowski Cc: linux-media@vger.kernel.org, linux-kernel@vger.kernel.org, devicetree@vger.kernel.org, linux-rpi-kernel@lists.infradead.org, linux-arm-kernel@lists.infradead.org, Naushir Patuck , Laurent Pinchart , Sakari Ailus , Jacopo Mondi , Kieran Bingham , Tomi Valkeinen X-Mailer: b4 0.13.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=4361; i=tomi.valkeinen@ideasonboard.com; h=from:subject:message-id; bh=bn7hb6abGotN+zJtZ8HsRWN0WBNQG9WEsGLPob3ZvdA=; b=owEBbQKS/ZANAwAIAfo9qoy8lh71AcsmYgBm3/4/pnygRauM2TiT+lFLJk8Mcdoc+dsdU/dRw LbKlsQ9xkGJAjMEAAEIAB0WIQTEOAw+ll79gQef86f6PaqMvJYe9QUCZt/+PwAKCRD6PaqMvJYe 9WA4EACYQFXgbrBc+JnlxDVviSdcTRJQ4yiV8BwAyeEdciKrBxPsP7P+kTes0hsBT+uBtRbxGHi GKn7nAwpPnxwxUxykHuboErjLMz1zDTLn0Ya17PZ6P0YYaFtddyrGMjEeIwWY19AR6cNi/ve6T3 T0VXSWvR13FKCzuyAyYHBQxRDiwHmebalizr7lSeKZ9FgKNdsbYcUhVbSAd/t9lUWIiY0QNTlsM D6uGOet9N6dOyW8gvZg9L6KtXQmcI0FU2OXHoVpozQEM2FcnaE5/7rQWnZxKA49ZSn1DqU5zXTl Skjg7m83syzalnsNxpG4rEUBZSfQJNN9MmVdNUT4S8UiSHfiPVGChRbgCbOhL6gmD2czAEGqJA1 l/Pq4v+smF+PY7GsEnx274OHwveAoNhslF5P5q8pfGUfE3ma/9jSdpwuihwJomuwHB9XDp33lIW qUV9uDOB0qSLjAw7+jC1hrA7xgzGg/a97a97zusFJwucgyO5RGYGJmUTkw7cIj/cxBrzrZE5Rh1 fmuYU3nE4iZEu/XtrABIbW02o+IC4P8ZoiK2/4nceUC00hey2UbG6Svv0KoJPwFC8VFZKI2cbq8 CrQN8LIG1v2GtOvTEk0cC8DmyyRaDWZXQOoIYWE4qipLi/1VA1uxzLPSKaNKiEUW+vb0ajNtrux NH2lm92LsSzCqiw== X-Developer-Key: i=tomi.valkeinen@ideasonboard.com; a=openpgp; fpr=C4380C3E965EFD81079FF3A7FA3DAA8CBC961EF5 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20240910_010735_657759_52DD1F39 X-CRM114-Status: GOOD ( 15.44 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org Add two meta formats for PiSP FE: V4L2_META_FMT_RPI_FE_CFG and V4L2_META_FMT_RPI_FE_STATS. The former is used to provide configuration for the FE and the latter is used to read the statistics from the FE. Signed-off-by: Tomi Valkeinen --- .../userspace-api/media/v4l/meta-formats.rst | 1 + .../userspace-api/media/v4l/metafmt-pisp-fe.rst | 39 ++++++++++++++++++++++ drivers/media/v4l2-core/v4l2-ioctl.c | 2 ++ include/uapi/linux/videodev2.h | 2 ++ 4 files changed, 44 insertions(+) diff --git a/Documentation/userspace-api/media/v4l/meta-formats.rst b/Documentation/userspace-api/media/v4l/meta-formats.rst index c6e56b5888bc..86ffb3bc8ade 100644 --- a/Documentation/userspace-api/media/v4l/meta-formats.rst +++ b/Documentation/userspace-api/media/v4l/meta-formats.rst @@ -16,6 +16,7 @@ These formats are used for the :ref:`metadata` interface only. metafmt-generic metafmt-intel-ipu3 metafmt-pisp-be + metafmt-pisp-fe metafmt-rkisp1 metafmt-uvc metafmt-vivid diff --git a/Documentation/userspace-api/media/v4l/metafmt-pisp-fe.rst b/Documentation/userspace-api/media/v4l/metafmt-pisp-fe.rst new file mode 100644 index 000000000000..fddeada83e4a --- /dev/null +++ b/Documentation/userspace-api/media/v4l/metafmt-pisp-fe.rst @@ -0,0 +1,39 @@ +.. SPDX-License-Identifier: GPL-2.0 + +.. _v4l2-meta-fmt-rpi-fe-cfg: + +************************ +V4L2_META_FMT_RPI_FE_CFG +************************ + +Raspberry Pi PiSP Front End configuration format +================================================ + +The Raspberry Pi PiSP Front End image signal processor is configured by +userspace by providing a buffer of configuration parameters to the +`rp1-cfe-fe-config` output video device node using the +:c:type:`v4l2_meta_format` interface. + +The `Raspberry Pi PiSP technical specification +`_ +provide detailed description of the Front End configuration and programming +model. + +.. _v4l2-meta-fmt-rpi-fe-stats: + +************************** +V4L2_META_FMT_RPI_FE_STATS +************************** + +Raspberry Pi PiSP Front End statistics format +============================================= + +The Raspberry Pi PiSP Front End image signal processor provides statistics data +by writing to a buffer provided via the `rp1-cfe-fe-stats` capture video device +node using the +:c:type:`v4l2_meta_format` interface. + +The `Raspberry Pi PiSP technical specification +`_ +provide detailed description of the Front End configuration and programming +model. diff --git a/drivers/media/v4l2-core/v4l2-ioctl.c b/drivers/media/v4l2-core/v4l2-ioctl.c index 5eb4d797d259..95c2c4a97966 100644 --- a/drivers/media/v4l2-core/v4l2-ioctl.c +++ b/drivers/media/v4l2-core/v4l2-ioctl.c @@ -1466,6 +1466,8 @@ static void v4l_fill_fmtdesc(struct v4l2_fmtdesc *fmt) case V4L2_PIX_FMT_Y212: descr = "12-bit YUYV Packed"; break; case V4L2_PIX_FMT_Y216: descr = "16-bit YUYV Packed"; break; case V4L2_META_FMT_RPI_BE_CFG: descr = "RPi PiSP BE Config format"; break; + case V4L2_META_FMT_RPI_FE_CFG: descr = "RPi PiSP FE Config format"; break; + case V4L2_META_FMT_RPI_FE_STATS: descr = "RPi PiSP FE Statistics format"; break; case V4L2_META_FMT_GENERIC_8: descr = "8-bit Generic Metadata"; break; case V4L2_META_FMT_GENERIC_CSI2_10: descr = "8-bit Generic Meta, 10b CSI-2"; break; case V4L2_META_FMT_GENERIC_CSI2_12: descr = "8-bit Generic Meta, 12b CSI-2"; break; diff --git a/include/uapi/linux/videodev2.h b/include/uapi/linux/videodev2.h index 4e91362da6da..9f68cd55248f 100644 --- a/include/uapi/linux/videodev2.h +++ b/include/uapi/linux/videodev2.h @@ -857,6 +857,8 @@ struct v4l2_pix_format { /* Vendor specific - used for RaspberryPi PiSP */ #define V4L2_META_FMT_RPI_BE_CFG v4l2_fourcc('R', 'P', 'B', 'C') /* PiSP BE configuration */ +#define V4L2_META_FMT_RPI_FE_CFG v4l2_fourcc('R', 'P', 'F', 'C') /* PiSP FE configuration */ +#define V4L2_META_FMT_RPI_FE_STATS v4l2_fourcc('R', 'P', 'F', 'S') /* PiSP FE stats */ #ifdef __KERNEL__ /* From patchwork Tue Sep 10 08:07:07 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Tomi Valkeinen X-Patchwork-Id: 13798111 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 4C674ECE582 for ; Tue, 10 Sep 2024 08:20:02 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender:List-Subscribe:List-Help :List-Post:List-Archive:List-Unsubscribe:List-Id:Cc:To:In-Reply-To:References :Message-Id:Content-Transfer-Encoding:Content-Type:MIME-Version:Subject:Date: From:Reply-To:Content-ID:Content-Description:Resent-Date:Resent-From: Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Owner; bh=NycLjYJiw1DPydmCpg5qE1iQoGeblIR8LiuJHKWYRYI=; b=z3skqfx6Z1mXBYGDe4Y6Zf6bmN 12I2Y/xnhndwiBlD97Vb9lDSHrW8rMARY+dsrPQOcgZP4YMCYUMA3qZOWCYNrol3IPZr7SMas/Hcn JW3QDh3KkE2xWR8lRfyejgbReA6C6je7lQ/7a7pUjhZwoBLDFmg9Mv1hJbQviAzJPLlb2b3XiA842 UZwZgtsFgegCbLWh1AE8eD2Hi8tnXv5hn8izp+kslpt2CfIHMkFoctr4qAAVePBj98ie/FYMMT1Qi kkbV6eUIl5e7IfdO4lKgBZ4106vbYrBsqPq1PcJKLDdAL0FjGJQPQu/0czydQBf6r2rUJosRtxIG9 CMlLxVTw==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.97.1 #2 (Red Hat Linux)) id 1snw6I-00000004nBu-1t9t; Tue, 10 Sep 2024 08:19:50 +0000 Received: from perceval.ideasonboard.com ([213.167.242.64]) by bombadil.infradead.org with esmtps (Exim 4.97.1 #2 (Red Hat Linux)) id 1snw2a-00000004mBi-17Yf; Tue, 10 Sep 2024 08:16:03 +0000 Received: from [127.0.1.1] (91-156-87-48.elisa-laajakaista.fi [91.156.87.48]) by perceval.ideasonboard.com (Postfix) with ESMTPSA id 51A141920; Tue, 10 Sep 2024 10:06:15 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com; s=mail; t=1725955576; bh=glmpFc00SsZ+PfwzIlsw73UpQTBgwInpTitkkKEeCPQ=; h=From:Date:Subject:References:In-Reply-To:To:Cc:From; b=kQIjsuUHseW/dvTWKGGKcGZW84VjlMlVVSaZo6cegeX5Png8LNRVVJvvGfy4Bjs9h i1bgUggQJl4CBXyb97cvrbKRvXVMb7GI4s9JQi4WBNKTGq/+5EEI8WpmRqe5DxvFRs 5WMkFpbqp3oV5K/fY0tJSgVsJgWctweAafZKztKk= From: Tomi Valkeinen Date: Tue, 10 Sep 2024 11:07:07 +0300 Subject: [PATCH v5 2/4] dt-bindings: media: Add bindings for raspberrypi,rp1-cfe MIME-Version: 1.0 Message-Id: <20240910-rp1-cfe-v5-2-9ab4c4c8eace@ideasonboard.com> References: <20240910-rp1-cfe-v5-0-9ab4c4c8eace@ideasonboard.com> In-Reply-To: <20240910-rp1-cfe-v5-0-9ab4c4c8eace@ideasonboard.com> To: Mauro Carvalho Chehab , Raspberry Pi Kernel Maintenance , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Florian Fainelli , Broadcom internal kernel review list , Rob Herring , Krzysztof Kozlowski Cc: linux-media@vger.kernel.org, linux-kernel@vger.kernel.org, devicetree@vger.kernel.org, linux-rpi-kernel@lists.infradead.org, linux-arm-kernel@lists.infradead.org, Naushir Patuck , Laurent Pinchart , Sakari Ailus , Jacopo Mondi , Kieran Bingham , Tomi Valkeinen , Krzysztof Kozlowski X-Mailer: b4 0.13.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=2916; i=tomi.valkeinen@ideasonboard.com; h=from:subject:message-id; bh=glmpFc00SsZ+PfwzIlsw73UpQTBgwInpTitkkKEeCPQ=; b=owEBbQKS/ZANAwAIAfo9qoy8lh71AcsmYgBm3/5AZD/bnvMVEiJo/Q2UhQHiY6Yhrh+NKwxoA 2CVJcTONKOJAjMEAAEIAB0WIQTEOAw+ll79gQef86f6PaqMvJYe9QUCZt/+QAAKCRD6PaqMvJYe 9Q08D/9jH2FsfDpjeJN53Woz6dLqaezLtRH8jSkYFb0JFaTcydhOLWSMMPm0K3cmNI30MVOIwzB tLwnsVmOs9cQYd3Si63JJhOPvzwZBS4x93UAZ5JfdNGtfBCyZGCkhEKHLC4ggRUGhDgnIrHMfdr 9IijXeKlzTgIAixn5dcPmRBBLxePuf40zlvWCPQUCPPBbR1W9WvlNZtan/ceKuBhdW3hgp2Ff2R nUl0C8VJm3L/O246l2JdqPG//NOU5pmQeMGD72DBTF9buRHnzBJ906OG0YM1bK2IhYrtYEGP8Xk lmb/wDlLGd+qz53AbsXGeldMm+oQluB0RsCuHXFT0F1x6uPCx+XgK/fLCIqbhis+jjc6cm852hs Lt+PPoNK9kXCH8zHwILP+LRfyArr/mlbaFYvqgVRuhLtdD0NeGd8KtxmB+HKzkotiwqmWRG7z2O CXdvwxfCATZd9YOHB0ysRAp1+swOCW2hiNouCtL82/9NWict5VfHxUhU9QxqSRQHvl01pkryQGq gSEakN0zpFPwzKtowOCUPP4vfQaI7w9T8ToL2ssOGA782aSVgclCcL8hxaNgna4y8MxagsO7PxO /0ugKOp8MZZ8lmgAQhjJeFh4A8EsIuT6r+bk2Latj0KPyzsJrQsQZjX3E+nJLZFxRU6321jcP7R ao/u2yavt0YsQAA== X-Developer-Key: i=tomi.valkeinen@ideasonboard.com; a=openpgp; fpr=C4380C3E965EFD81079FF3A7FA3DAA8CBC961EF5 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20240910_011600_461832_B7405F43 X-CRM114-Status: GOOD ( 10.69 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org Add DT bindings for raspberrypi,rp1-cfe. Reviewed-by: Krzysztof Kozlowski Signed-off-by: Tomi Valkeinen --- .../bindings/media/raspberrypi,rp1-cfe.yaml | 93 ++++++++++++++++++++++ 1 file changed, 93 insertions(+) diff --git a/Documentation/devicetree/bindings/media/raspberrypi,rp1-cfe.yaml b/Documentation/devicetree/bindings/media/raspberrypi,rp1-cfe.yaml new file mode 100644 index 000000000000..eba5394719b9 --- /dev/null +++ b/Documentation/devicetree/bindings/media/raspberrypi,rp1-cfe.yaml @@ -0,0 +1,93 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/media/raspberrypi,rp1-cfe.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Raspberry Pi PiSP Camera Front End + +maintainers: + - Tomi Valkeinen + - Raspberry Pi Kernel Maintenance + +description: | + The Raspberry Pi PiSP Camera Front End is a module in Raspberrypi 5's RP1 I/O + controller, that contains: + - MIPI D-PHY + - MIPI CSI-2 receiver + - Simple image processor (called PiSP Front End, or FE) + + The FE documentation is available at: + https://datasheets.raspberrypi.com/camera/raspberry-pi-image-signal-processor-specification.pdf + + The PHY and CSI-2 receiver part have no public documentation. + +properties: + compatible: + items: + - const: raspberrypi,rp1-cfe + + reg: + items: + - description: CSI-2 registers + - description: D-PHY registers + - description: MIPI CFG (a simple top-level mux) registers + - description: FE registers + + interrupts: + maxItems: 1 + + clocks: + maxItems: 1 + + port: + $ref: /schemas/graph.yaml#/$defs/port-base + additionalProperties: false + description: CSI-2 RX Port + + properties: + endpoint: + $ref: video-interfaces.yaml# + unevaluatedProperties: false + + properties: + data-lanes: + minItems: 1 + maxItems: 4 + + required: + - data-lanes + +required: + - compatible + - reg + - interrupts + - clocks + +additionalProperties: false + +examples: + - | + rp1 { + #address-cells = <2>; + #size-cells = <2>; + + csi@110000 { + compatible = "raspberrypi,rp1-cfe"; + reg = <0xc0 0x40110000 0x0 0x100>, + <0xc0 0x40114000 0x0 0x100>, + <0xc0 0x40120000 0x0 0x100>, + <0xc0 0x40124000 0x0 0x1000>; + + interrupts = <42>; + + clocks = <&rp1_clocks>; + + port { + csi_ep: endpoint { + remote-endpoint = <&cam_endpoint>; + data-lanes = <1 2>; + }; + }; + }; + }; From patchwork Tue Sep 10 08:07:09 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Tomi Valkeinen X-Patchwork-Id: 13798110 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 44EEAECE582 for ; Tue, 10 Sep 2024 08:18:56 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender:List-Subscribe:List-Help :List-Post:List-Archive:List-Unsubscribe:List-Id:Cc:To:In-Reply-To:References :Message-Id:Content-Transfer-Encoding:Content-Type:MIME-Version:Subject:Date: From:Reply-To:Content-ID:Content-Description:Resent-Date:Resent-From: Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Owner; bh=kncMR9E8VHOybEPf6D6AZqvUKUCYvL+7V7vYdCgIAQ0=; b=s5eGnvK0UkvO9dBZKpKvBRsTi+ o0WXovaVMH7HZ2KE4AEed/RpS/2JvYPeiw6gPfcIY80eca4NfOagVJLNfIOd4Pfp+sDntT6U6xw4X ATw2w7XgLQ9KL3xkz7eyPwZLOMph2DaYynd5RyVoaNmHEXlSxC9XI8RypLJEz8LJVfoGJZCSShdMa I7ghLue3DIiBdgd7dqjpedfW4Y2jvy0r6V8BZLWBFi5oJOYGXsaz2CF6v1UBlM6uIa1hPx+5JF3+N L/XKea2Rq18IoNdCTRyPIStN7dkcuzxexHsl8l0/Iveu1hokonEAMg0zuepOT8w4K4AMnbchyjH8Y bXpxYJKA==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.97.1 #2 (Red Hat Linux)) id 1snw5D-00000004mx5-0uW3; Tue, 10 Sep 2024 08:18:43 +0000 Received: from perceval.ideasonboard.com ([213.167.242.64]) by bombadil.infradead.org with esmtps (Exim 4.97.1 #2 (Red Hat Linux)) id 1snw2a-00000004mBj-17xH; Tue, 10 Sep 2024 08:16:03 +0000 Received: from [127.0.1.1] (91-156-87-48.elisa-laajakaista.fi [91.156.87.48]) by perceval.ideasonboard.com (Postfix) with ESMTPSA id A12301A60; Tue, 10 Sep 2024 10:06:17 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com; s=mail; t=1725955578; bh=ldQ0outL4QKLwryuC/LIt5eVxQJHAdWhRM3fm421H80=; h=From:Date:Subject:References:In-Reply-To:To:Cc:From; b=r/yveOD/QBWvCrKsa2ZyEMHRSdg105C+L4vqPB/LcEmNha7dOrOwls6/O98S5QEQ2 k73qCZx3DuNnTZUqK/2Ye+5iwAfebwz4ABJWoEg2g7p8y0gNbM5PazuFDDNNwjSU6u s4f4nVLzZae4wfGZhFRRfK+P3efXctmYBFwUgkzQ= From: Tomi Valkeinen Date: Tue, 10 Sep 2024 11:07:09 +0300 Subject: [PATCH v5 4/4] media: admin-guide: Document the Raspberry Pi CFE (rp1-cfe) MIME-Version: 1.0 Message-Id: <20240910-rp1-cfe-v5-4-9ab4c4c8eace@ideasonboard.com> References: <20240910-rp1-cfe-v5-0-9ab4c4c8eace@ideasonboard.com> In-Reply-To: <20240910-rp1-cfe-v5-0-9ab4c4c8eace@ideasonboard.com> To: Mauro Carvalho Chehab , Raspberry Pi Kernel Maintenance , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Florian Fainelli , Broadcom internal kernel review list , Rob Herring , Krzysztof Kozlowski Cc: linux-media@vger.kernel.org, linux-kernel@vger.kernel.org, devicetree@vger.kernel.org, linux-rpi-kernel@lists.infradead.org, linux-arm-kernel@lists.infradead.org, Naushir Patuck , Laurent Pinchart , Sakari Ailus , Jacopo Mondi , Kieran Bingham , Tomi Valkeinen X-Mailer: b4 0.13.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=6375; i=tomi.valkeinen@ideasonboard.com; h=from:subject:message-id; bh=ldQ0outL4QKLwryuC/LIt5eVxQJHAdWhRM3fm421H80=; b=owEBbQKS/ZANAwAIAfo9qoy8lh71AcsmYgBm3/5BqQ9yMYwo1Yar/vRA3IGB/2qZTLd5iW9CX 1aEDGSMJLGJAjMEAAEIAB0WIQTEOAw+ll79gQef86f6PaqMvJYe9QUCZt/+QQAKCRD6PaqMvJYe 9V1eD/9J5jhFiLHKyDfWf/5IC1O6eTUyCPP0UNHr2qh/Asjy2aLZSe4ToaZnolsKM44S+NXYXgd fzwm+XRzU1VbcMxHsll2BT7sEmYqkoU5STPHZ1El3Y3gQEE+UEwb7ciEMDscLg0f5k9cAm+xsAq 6gqltEvMUZjtqEcxjI1tR63GudWYVfqlMzHI/EYtHcVEFPyRvNBHgjXMTc9zTifWDhs7YN+HkNB 0t/18gdC4O/8F8oytoy6KUGIyfRO8bAbcK0VlAqqfPjys4kkuQMy0CXYkcVzVKlLjLbVrfvovzb 0IGdqq+w22tHC2TsDAAibc+OpPVQTrJQDfAyE9YDSzNvvEjA79ftqpLxwzaZTgnEavAoCeE6+cc lpfNUzZ6B5S6QOZU183H0np/y0nNJQe1fM61hOsr6STPKOfGPcXyspwLWAxC5dRwRBLImvQvjXH ICS/7a3WdRJFUAG5DJAEvMAIHpjN0H/K463xmxnE3voeyQB/UDPulRdLgRzST9Jyo+NctbcMEa0 sujX0yLU5QYr09H+XqRw/7luXjTESMjQbCIu2l0D/vgJqpXV5XDoyLWGBk91P+0qadXaEyvBLBT bPnb7YvmeRb0lyKH4MdQkm4ZXwkKYI4phcM8U1rz/mVLhDgXLIf7eepXOZCcouh+YXz+oCDsIXM Z+bm4XYrR86ZHDg== X-Developer-Key: i=tomi.valkeinen@ideasonboard.com; a=openpgp; fpr=C4380C3E965EFD81079FF3A7FA3DAA8CBC961EF5 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20240910_011600_468844_9A044734 X-CRM114-Status: GOOD ( 15.65 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org Add documentation for rp1-cfe driver. Signed-off-by: Tomi Valkeinen --- .../admin-guide/media/raspberrypi-rp1-cfe.dot | 27 ++++++++ .../admin-guide/media/raspberrypi-rp1-cfe.rst | 78 ++++++++++++++++++++++ Documentation/admin-guide/media/v4l-drivers.rst | 1 + 3 files changed, 106 insertions(+) diff --git a/Documentation/admin-guide/media/raspberrypi-rp1-cfe.dot b/Documentation/admin-guide/media/raspberrypi-rp1-cfe.dot new file mode 100644 index 000000000000..7717f2291049 --- /dev/null +++ b/Documentation/admin-guide/media/raspberrypi-rp1-cfe.dot @@ -0,0 +1,27 @@ +digraph board { + rankdir=TB + n00000001 [label="{{ 0} | csi2\n/dev/v4l-subdev0 | { 1 | 2 | 3 | 4}}", shape=Mrecord, style=filled, fillcolor=green] + n00000001:port1 -> n00000011 [style=dashed] + n00000001:port1 -> n00000007:port0 + n00000001:port2 -> n00000015 + n00000001:port2 -> n00000007:port0 [style=dashed] + n00000001:port3 -> n00000019 [style=dashed] + n00000001:port3 -> n00000007:port0 [style=dashed] + n00000001:port4 -> n0000001d [style=dashed] + n00000001:port4 -> n00000007:port0 [style=dashed] + n00000007 [label="{{ 0 | 1} | pisp-fe\n/dev/v4l-subdev1 | { 2 | 3 | 4}}", shape=Mrecord, style=filled, fillcolor=green] + n00000007:port2 -> n00000021 + n00000007:port3 -> n00000025 [style=dashed] + n00000007:port4 -> n00000029 + n0000000d [label="{imx219 6-0010\n/dev/v4l-subdev2 | { 0}}", shape=Mrecord, style=filled, fillcolor=green] + n0000000d:port0 -> n00000001:port0 [style=bold] + n00000011 [label="rp1-cfe-csi2-ch0\n/dev/video0", shape=box, style=filled, fillcolor=yellow] + n00000015 [label="rp1-cfe-csi2-ch1\n/dev/video1", shape=box, style=filled, fillcolor=yellow] + n00000019 [label="rp1-cfe-csi2-ch2\n/dev/video2", shape=box, style=filled, fillcolor=yellow] + n0000001d [label="rp1-cfe-csi2-ch3\n/dev/video3", shape=box, style=filled, fillcolor=yellow] + n00000021 [label="rp1-cfe-fe-image0\n/dev/video4", shape=box, style=filled, fillcolor=yellow] + n00000025 [label="rp1-cfe-fe-image1\n/dev/video5", shape=box, style=filled, fillcolor=yellow] + n00000029 [label="rp1-cfe-fe-stats\n/dev/video6", shape=box, style=filled, fillcolor=yellow] + n0000002d [label="rp1-cfe-fe-config\n/dev/video7", shape=box, style=filled, fillcolor=yellow] + n0000002d -> n00000007:port1 +} diff --git a/Documentation/admin-guide/media/raspberrypi-rp1-cfe.rst b/Documentation/admin-guide/media/raspberrypi-rp1-cfe.rst new file mode 100644 index 000000000000..668d978a9875 --- /dev/null +++ b/Documentation/admin-guide/media/raspberrypi-rp1-cfe.rst @@ -0,0 +1,78 @@ +.. SPDX-License-Identifier: GPL-2.0 + +============================================ +Raspberry Pi PiSP Camera Front End (rp1-cfe) +============================================ + +The PiSP Camera Front End +========================= + +The PiSP Camera Front End (CFE) is a module which combines a CSI-2 receiver with +a simple ISP, called the Front End (FE). + +The CFE has four DMA engines and can write frames from four separate streams +received from the CSI-2 to the memory. One of those streams can also be routed +directly to the FE, which can do minimal image processing, write two versions +(e.g. non-scaled and downscaled versions) of the received frames to memory and +provide statistics of the received frames. + +The FE registers are documented in the `Raspberry Pi Image Signal Processor +(ISP) Specification document +`_, +and example code for FE can be found in `libpisp +`_. + +The rp1-cfe driver +================== + +The Raspberry Pi PiSP Camera Front End (rp1-cfe) driver is located under +drivers/media/platform/raspberrypi/rp1-cfe. It uses the `V4L2 API` to register +a number of video capture and output devices, the `V4L2 subdev API` to register +subdevices for the CSI-2 received and the FE that connects the video devices in +a single media graph realized using the `Media Controller (MC) API`. + +The media topology registered by the `rp1-cfe` driver, in this particular +example connected to an imx219 sensor, is the following one: + +.. _rp1-cfe-topology: + +.. kernel-figure:: raspberrypi-rp1-cfe.dot + :alt: Diagram of an example media pipeline topology + :align: center + +The media graph contains the following video device nodes: + +- rp1-cfe-csi2-ch0: capture device for the first CSI-2 stream +- rp1-cfe-csi2-ch1: capture device for the second CSI-2 stream +- rp1-cfe-csi2-ch2: capture device for the third CSI-2 stream +- rp1-cfe-csi2-ch3: capture device for the fourth CSI-2 stream +- rp1-cfe-fe-image0: capture device for the first FE output +- rp1-cfe-fe-image1: capture device for the second FE output +- rp1-cfe-fe-stats: capture device for the FE statistics +- rp1-cfe-fe-config: output device for FE configuration + +rp1-cfe-csi2-chX +---------------- + +The rp1-cfe-csi2-chX capture devices are normal V4L2 capture devices which +can be used to capture video frames or metadata received from the CSI-2. + +rp1-cfe-fe-image0, rp1-cfe-fe-image1 +------------------------------------ + +The rp1-cfe-fe-image0 and rp1-cfe-fe-image1 capture devices are used to write +the processed frames to memory. + +rp1-cfe-fe-stats +---------------- + +The format of the FE statistics buffer is defined by +:c:type:`pisp_statistics` C structure and the meaning of each parameter is +described in the `PiSP specification` document. + +rp1-cfe-fe-config +----------------- + +The format of the FE configuration buffer is defined by +:c:type:`pisp_fe_config` C structure and the meaning of each parameter is +described in the `PiSP specification` document. diff --git a/Documentation/admin-guide/media/v4l-drivers.rst b/Documentation/admin-guide/media/v4l-drivers.rst index b6af448b9fe9..61da154e079a 100644 --- a/Documentation/admin-guide/media/v4l-drivers.rst +++ b/Documentation/admin-guide/media/v4l-drivers.rst @@ -26,6 +26,7 @@ Video4Linux (V4L) driver-specific documentation raspberrypi-pisp-be rcar-fdp1 rkisp1 + raspberrypi-rp1-cfe saa7134 si470x si4713