Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20;
From:   Liu Ying <victor.liu@nxp.com>
To:     dri-devel@lists.freedesktop.org, devicetree@vger.kernel.org,
        linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org,
        linux-media@vger.kernel.org
Cc:     andrzej.hajda@intel.com, narmstrong@baylibre.com,
        robert.foss@linaro.org, Laurent.pinchart@ideasonboard.com,
        jonas@kwiboo.se, jernej.skrabec@gmail.com, airlied@linux.ie,
        daniel@ffwll.ch, robh+dt@kernel.org,
        krzysztof.kozlowski+dt@linaro.org, shawnguo@kernel.org,
        s.hauer@pengutronix.de, kernel@pengutronix.de, festevam@gmail.com,
        linux-imx@nxp.com, lee.jones@linaro.org, mchehab@kernel.org,
        marcel.ziswiler@toradex.com,
        Laurent Pinchart <laurent.pinchart@ideasonboard.com>
Subject: [PATCH v8 02/14] media: docs: Add some RGB bus formats for i.MX8qm/qxp pixel combiner
Date:   Thu,  9 Jun 2022 14:49:19 +0800
Message-Id: <20220609064931.3068601-3-victor.liu@nxp.com>
In-Reply-To: <20220609064931.3068601-1-victor.liu@nxp.com>
References: <20220609064931.3068601-1-victor.liu@nxp.com>
Content-Transfer-Encoding: 8bit
Content-Type: text/plain
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?x2yE4gm9O7Q2V7MWd8vIVSXAXP/JKDIZW1w1IVAm3DqTKKx029978FxLT84B?=
 =?us-ascii?Q?CdxlbCK0l2Xeufyh5pOGNIyG7DK9a3NNPENyZhKBfxYQua0/g6y+YV+/CNmO?=
 =?us-ascii?Q?s0Y7HCDSg89kH0Z0Az3MCO5OEU8QRLCHnhAnfj2YihpIqDnvhZFZQkvfFTd+?=
 =?us-ascii?Q?hYmsntsmBZgAIwaRkzRlsjREEPPcBCQLVYaA9GMzeY55rlVUHSGmeIwygYeL?=
 =?us-ascii?Q?6Iojkk0SLApLYkkFrVmDiL5yzzYYvm4vona1LjjFHcE73FD5pSQhjbsIZu8o?=
 =?us-ascii?Q?3nUwl2p/29+ojjoHPS76u5Xe+fArln0CKZVeuElLL+9bJcf2IbHU4J1/+nEw?=
 =?us-ascii?Q?iLfr69ArR00R9QLy72KVAlXnkn0sxeNm3kvQXIcU2440nsfFa0NqwexSXqyJ?=
 =?us-ascii?Q?G5nGltZLfRe+7i3lo/loNuMhYXfV3h9jBz5BJVqbLD3prPYT/5qSvAYC7Jk0?=
 =?us-ascii?Q?fKA+qWBZPk9+CI52jhDOZmtlejbRa4fPXDjYRw48qNoB8/8TwkIZlXPpoDuQ?=
 =?us-ascii?Q?X2jy/0HmO9LXa2ViJF+zCRfvKKlPAFlTG1CbVEGjoD9katMJoh2nHLdSsurX?=
 =?us-ascii?Q?pK/PiKqDsyouhEee26FcHRPKBl+wJOey5jT4zTCeitMdkqGqtn8YYOF7IGm5?=
 =?us-ascii?Q?iX8kzY3tuI3vWxLipEb2ufhzJxt6/fq7Tdg0Op9D1ZSGVISFYN+2ElMKHlXJ?=
 =?us-ascii?Q?+QjYNLtjsBR1doJd7Twpnk9f4JsmwsjDIM4Kkrv9TUYUZzTIvFVZUG0Hk93D?=
 =?us-ascii?Q?NPSlWnX4X7a7ssLMK9UzFKWiM3XktzNbnxQuwkfyTtKmzXDVnZ0VJhAUKUNp?=
 =?us-ascii?Q?keZi+sfeb0Kk0SkmPC3/LRM/FppiszAifK4OhsRpzYK/j0O2W7tYiH/At9+t?=
 =?us-ascii?Q?Bbzcm+yiRVAsCZv2D9+i4Fe3ThLbbgtTzpT2D7FgKGnzBGn99v75iCZ8N2fa?=
 =?us-ascii?Q?Fl5wPW0OGm0xrqOaUZgIRdC63TS4hiVHvXRhJM2XbWtSbA6CWjcXlnyNRCm7?=
 =?us-ascii?Q?MwnVme05wN6zduegjY9w4CBGHb/TJYLXqfrLtxSvnFt3WDfY8UTqQvIusWOs?=
 =?us-ascii?Q?oHFuBxBku1+koJwBq8qj73R0WQIbaq5/EjOSpldWWkJekpeHBvzsCidHbKCh?=
 =?us-ascii?Q?cHeMDhNq2ZT824JmGiU2OyTmaGpcZJTBVzUVgBqOOoTkX6QIuY3HOLPtH9EF?=
 =?us-ascii?Q?rJGFSfiotSLNKfUfdwB67BNz5DSwONc6lOQDJHIzUDZZP7N4QMtlJUcXYIh+?=
 =?us-ascii?Q?x3puiUvaBawhwcl5b50VY8uyiAfhjt0UbEL1G68T0xa+gZEpK+cNnNjiWhwq?=
 =?us-ascii?Q?l4V+g7Fkp4q1niOAO6MqGiKb19f4BSPGUdvhmepBKbkr8IYYgOUA7qbKfVEQ?=
 =?us-ascii?Q?PlpK2cCU1+7yd8IGjQgYTHLR9IsX8XeDRWcpiR3ywY69fz852Hk0wxA8Cn6r?=
 =?us-ascii?Q?RDVufUxNm+6W+UqIlsxWt5c3Orc5V00tDbCRPse42bcV+ir3IgEvVp6YET5m?=
 =?us-ascii?Q?yRoyHAIQPmSdZnTFXB48FcgZyKy8ezrlhrNxvTMdsL6N81ZLl/0SA4ARR1Ha?=
 =?us-ascii?Q?PZSZU//m8n2DS4qTIDR31IDMc6rgAyt/PqS+nQ0xr3UhJXrglWCFcTALl5ky?=
 =?us-ascii?Q?AD8ZonNorEhTwP01EWW/Jv+zDjRHsYapQ9nl4AjsKZIIng3E/gCbVVRN4UcR?=
 =?us-ascii?Q?tcaur5tlfFPVHbdrNFu6NbXSGTZV0dQ+r/HyAaaGeveQPr9zNlBdN+yd1vnq?=
 =?us-ascii?Q?hK0wXdKW1Q=3D=3D?=
X-OriginatorOrg: nxp.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 63bb2775-e7e9-4312-8fd3-08da49e408dc
X-MS-Exchange-CrossTenant-AuthSource: AM7PR04MB7046.eurprd04.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 09 Jun 2022 06:48:17.9826
 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: 686ea1d3-bc2b-4c6f-a92c-d99c5c301635
X-MS-Exchange-CrossTenant-MailboxType: HOSTED
X-MS-Exchange-CrossTenant-UserPrincipalName: +xCVYknOQaDl2sAn4JJ28nIw5kUjkfTWjOGopy2cb1CW/EmC/xqcp8qEy1E0hBCEU9TfUPTo7xjO3crThp6H/A==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: VI1PR0402MB3518
X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED,
        DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_NONE,
        RCVD_IN_MSPIKE_H2,SPF_HELO_NONE,SPF_PASS,T_SCC_BODY_TEXT_LINE,
        URIBL_BLOCKED autolearn=ham autolearn_force=no version=3.4.6
X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on
        lindbergh.monkeyblade.net
Precedence: bulk
List-ID: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org

This patch adds documentations for RGB666_1X30_CPADLO, RGB888_1X30_CPADLO,
RGB666_1X36_CPADLO and RGB888_1X36_CPADLO bus formats used by i.MX8qm/qxp
pixel combiner.  The RGB pixels with padding low per component are
transmitted on a 30-bit input bus(10-bit per component) from a display
controller or a 36-bit output bus(12-bit per component) to a pixel link.

Reviewed-by: Robert Foss <robert.foss@linaro.org>
Reviewed-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
Signed-off-by: Liu Ying <victor.liu@nxp.com>
---
Robert, I keep your R-b tag from v5. Let me know if you want me to drop it, as
v6 contains a fix.

v7->v8:
* No change.

v6->v7:
* No change.

v5->v6:
* Fix data organizations of MEDIA_BUS_FMT_RGB{666,888}_1X30-CPADLO. (Laurent)
* Add Laurent's R-b tag.

v4->v5:
* Add Robert's R-b tag.

v3->v4:
* No change.

v2->v3:
* No change.

v1->v2:
* No change.

 .../media/v4l/subdev-formats.rst              | 156 ++++++++++++++++++
 1 file changed, 156 insertions(+)

diff --git a/Documentation/userspace-api/media/v4l/subdev-formats.rst b/Documentation/userspace-api/media/v4l/subdev-formats.rst
index 0cbc045d5df6..d21d532eee15 100644
--- a/Documentation/userspace-api/media/v4l/subdev-formats.rst
+++ b/Documentation/userspace-api/media/v4l/subdev-formats.rst
@@ -1492,6 +1492,80 @@ The following tables list existing packed RGB formats.
       - b\ :sub:`2`
       - b\ :sub:`1`
       - b\ :sub:`0`
+    * .. _MEDIA-BUS-FMT-RGB666-1X30-CPADLO:
+
+      - MEDIA_BUS_FMT_RGB666_1X30-CPADLO
+      - 0x101e
+      -
+      -
+      -
+      - r\ :sub:`5`
+      - r\ :sub:`4`
+      - r\ :sub:`3`
+      - r\ :sub:`2`
+      - r\ :sub:`1`
+      - r\ :sub:`0`
+      - 0
+      - 0
+      - 0
+      - 0
+      - g\ :sub:`5`
+      - g\ :sub:`4`
+      - g\ :sub:`3`
+      - g\ :sub:`2`
+      - g\ :sub:`1`
+      - g\ :sub:`0`
+      - 0
+      - 0
+      - 0
+      - 0
+      - b\ :sub:`5`
+      - b\ :sub:`4`
+      - b\ :sub:`3`
+      - b\ :sub:`2`
+      - b\ :sub:`1`
+      - b\ :sub:`0`
+      - 0
+      - 0
+      - 0
+      - 0
+    * .. _MEDIA-BUS-FMT-RGB888-1X30-CPADLO:
+
+      - MEDIA_BUS_FMT_RGB888_1X30-CPADLO
+      - 0x101f
+      -
+      -
+      -
+      - r\ :sub:`7`
+      - r\ :sub:`6`
+      - r\ :sub:`5`
+      - r\ :sub:`4`
+      - r\ :sub:`3`
+      - r\ :sub:`2`
+      - r\ :sub:`1`
+      - r\ :sub:`0`
+      - 0
+      - 0
+      - g\ :sub:`7`
+      - g\ :sub:`6`
+      - g\ :sub:`5`
+      - g\ :sub:`4`
+      - g\ :sub:`3`
+      - g\ :sub:`2`
+      - g\ :sub:`1`
+      - g\ :sub:`0`
+      - 0
+      - 0
+      - b\ :sub:`7`
+      - b\ :sub:`6`
+      - b\ :sub:`5`
+      - b\ :sub:`4`
+      - b\ :sub:`3`
+      - b\ :sub:`2`
+      - b\ :sub:`1`
+      - b\ :sub:`0`
+      - 0
+      - 0
     * .. _MEDIA-BUS-FMT-ARGB888-1X32:
 
       - MEDIA_BUS_FMT_ARGB888_1X32
@@ -1669,6 +1743,88 @@ The following table list existing packed 36bit wide RGB formats.
       - 2
       - 1
       - 0
+    * .. _MEDIA-BUS-FMT-RGB666-1X36-CPADLO:
+
+      - MEDIA_BUS_FMT_RGB666_1X36_CPADLO
+      - 0x1020
+      -
+      - r\ :sub:`5`
+      - r\ :sub:`4`
+      - r\ :sub:`3`
+      - r\ :sub:`2`
+      - r\ :sub:`1`
+      - r\ :sub:`0`
+      - 0
+      - 0
+      - 0
+      - 0
+      - 0
+      - 0
+      - g\ :sub:`5`
+      - g\ :sub:`4`
+      - g\ :sub:`3`
+      - g\ :sub:`2`
+      - g\ :sub:`1`
+      - g\ :sub:`0`
+      - 0
+      - 0
+      - 0
+      - 0
+      - 0
+      - 0
+      - b\ :sub:`5`
+      - b\ :sub:`4`
+      - b\ :sub:`3`
+      - b\ :sub:`2`
+      - b\ :sub:`1`
+      - b\ :sub:`0`
+      - 0
+      - 0
+      - 0
+      - 0
+      - 0
+      - 0
+    * .. _MEDIA-BUS-FMT-RGB888-1X36-CPADLO:
+
+      - MEDIA_BUS_FMT_RGB888_1X36_CPADLO
+      - 0x1021
+      -
+      - r\ :sub:`7`
+      - r\ :sub:`6`
+      - r\ :sub:`5`
+      - r\ :sub:`4`
+      - r\ :sub:`3`
+      - r\ :sub:`2`
+      - r\ :sub:`1`
+      - r\ :sub:`0`
+      - 0
+      - 0
+      - 0
+      - 0
+      - g\ :sub:`7`
+      - g\ :sub:`6`
+      - g\ :sub:`5`
+      - g\ :sub:`4`
+      - g\ :sub:`3`
+      - g\ :sub:`2`
+      - g\ :sub:`1`
+      - g\ :sub:`0`
+      - 0
+      - 0
+      - 0
+      - 0
+      - b\ :sub:`7`
+      - b\ :sub:`6`
+      - b\ :sub:`5`
+      - b\ :sub:`4`
+      - b\ :sub:`3`
+      - b\ :sub:`2`
+      - b\ :sub:`1`
+      - b\ :sub:`0`
+      - 0
+      - 0
+      - 0
+      - 0
     * .. _MEDIA-BUS-FMT-RGB121212-1X36:
 
       - MEDIA_BUS_FMT_RGB121212_1X36
-- 
2.25.1