Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18;
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:     airlied@linux.ie, daniel@ffwll.ch, robh+dt@kernel.org,
        shawnguo@kernel.org, s.hauer@pengutronix.de, kernel@pengutronix.de,
        festevam@gmail.com, linux-imx@nxp.com, mchehab@kernel.org,
        a.hajda@samsung.com, narmstrong@baylibre.com,
        Laurent.pinchart@ideasonboard.com, jonas@kwiboo.se,
        jernej.skrabec@siol.net, kishon@ti.com, vkoul@kernel.org,
        robert.foss@linaro.org, lee.jones@linaro.org
Subject: [PATCH v5 02/14] media: docs: Add some RGB bus formats for i.MX8qm/qxp pixel combiner
Date:   Wed, 10 Mar 2021 17:55:26 +0800
Message-Id: <1615370138-5673-3-git-send-email-victor.liu@nxp.com>
In-Reply-To: <1615370138-5673-1-git-send-email-victor.liu@nxp.com>
References: <1615370138-5673-1-git-send-email-victor.liu@nxp.com>
Content-Type: text/plain
MIME-Version: 1.0
X-MS-Exchange-MessageSentRepresentingType: 1
Received: from localhost.localdomain (119.31.174.66) by HK2PR06CA0010.apcprd06.prod.outlook.com (2603:1096:202:2e::22) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256) id 15.20.3912.17 via Frontend Transport; Wed, 10 Mar 2021 10:09:04 +0000
X-MS-PublicTrafficType: Email
X-MS-Office365-Filtering-HT: Tenant
X-MS-Office365-Filtering-Correlation-Id: c63e1a8c-267a-4514-6a31-08d8e3ac8c49
X-MS-TrafficTypeDiagnostic: VI1PR0401MB2318:
X-MS-Exchange-Transport-Forked: True
X-Microsoft-Antispam-PRVS: <VI1PR0401MB2318788922D1DCE49340AF5998919@VI1PR0401MB2318.eurprd04.prod.outlook.com>
X-MS-Oob-TLC-OOBClassifiers: OLM:1201;
X-MS-Exchange-SenderADCheck: 1
X-Microsoft-Antispam: BCL:0;
X-Microsoft-Antispam-Message-Info: +phHwmGOeSYtlBInHvvM3OW3eu0pfQltIMkeg2PPCzbFUIyu4F94RFTKZfCIpr0yz6HEtv6JFMzyS9Vtuuu4NDJcCZXvb8ICheQYohvgeMUqPfNHUTi6p3HtrUmvTPvWuLCcISjlH3uM8RIzUFqoBrVX9Q0ExbcyONwjDD9FCbUHZ/k+B5Nj6f24CPYDWumJkptq6wfo+sPP7P3TlfSK+0S+0POCF1TN6kZbLGMUWAHNRJ0E0xoKhkrYZI+pXFr4VP5Q/2Yhf1SApHzlklfgOxNZIF44tww84Nf+hpgHpxc/s39TQgFTk1BmXNQcYnehWuAc8UDFakPFjj9z/Gzw3YHHbWDxU7xfp3xWpp63EqkPcRyujQVsxSP+TNyOXT5voSS+X8OuKBmJzF5dsahYNsj52kHrzmu6m2AMhQUcj/9jrNFRpiV5mIsLh80iJLRoTq8TIepuSE+dO8jUc6/VRF/ONjrQHnA8wVWMmGuFCE/vb66SjKGcNF0u1aYSiPz1+vaQTx0trWH/j8ruoNLQkVv0zaRLdYGdEqT0ObobwTtupUaE6QdaFQkiIsPVfZcFZRTHDTafdTy7GJ4XJ3iHqw==
X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:VI1PR04MB3983.eurprd04.prod.outlook.com;PTR:;CAT:NONE;SFS:(4636009)(39860400002)(136003)(396003)(366004)(376002)(346002)(6666004)(66476007)(66556008)(8936002)(6512007)(2616005)(36756003)(6506007)(316002)(66946007)(69590400012)(956004)(4326008)(86362001)(16526019)(5660300002)(478600001)(8676002)(2906002)(52116002)(6486002)(186003)(7416002)(26005);DIR:OUT;SFP:1101;
X-MS-Exchange-AntiSpam-MessageData: =?us-ascii?Q?pp5y/8YiVz2AXQg4xtTx3jzFb/fJa316LsYBibQ5Z/Ot9iF89LSh0QnQMWhy?=
 =?us-ascii?Q?UxP5nibLOPcXusT5EaZES+VsFvkpX1LGV6WESFrN8+GtaA1wzYA8ueIsmrip?=
 =?us-ascii?Q?RxHlOWK/yvC4e/7yz0VSjGTmJQGsBwIHPtGooeTdEAT7kJx+L5GHyQXNFOJB?=
 =?us-ascii?Q?I5gJyKgzmLGONyqsXBfgkfL22Knc3Q6Fa9lNTjRez0qUSgIEXHVmFDMuiRUh?=
 =?us-ascii?Q?qdBTnGr3D49spkx5uXYp3LozgI6rrQWUPQviKkqOphtbpn/C9lWkiTZ4p8Ch?=
 =?us-ascii?Q?IA0qzv+ohpzLNehVQSLi6B9TM9a+ZDe4PRcqLJ//CVauWEYv0M50YUy0CvTc?=
 =?us-ascii?Q?EjSUlPKFBy9vgEqYRFYOfTT8bVQfEucJvbEEac8ORAEhmKqBxikL97ay5eax?=
 =?us-ascii?Q?uBZTDNzVaK92WxsLFdUCV+r0TLKJ9doylv+Cib7cVcX+LB9PohwHjAtA639w?=
 =?us-ascii?Q?Dno8j7dThFHxO1g+g675deViI0aj86SgQG8mZI2E3+cY7KrnmFMHFOJmCQLU?=
 =?us-ascii?Q?f/gCdQJVdVCf8B1ekS7jvld2Bbc8NeOte40kSywYFcHGDIkkId4r92CanlW6?=
 =?us-ascii?Q?xDf/6I5BnfYcfMySAzuh9CJrSTWkVcnsClDMzlCogWRS6/ze6tY4nouNXZ0P?=
 =?us-ascii?Q?Meb1qj4VAbS+qD0xloC2pzOi4AwialCHvP0HDgbMgoaEZsD8owBzXSthK6HW?=
 =?us-ascii?Q?dZ9LsldW0yD6jOX5J0G0KzHylWEO25ZN7Zi9yqbmUfvMERhHsBu9wjszpXGK?=
 =?us-ascii?Q?lZaFujr7Ckrt0PfpW89SeFyIzifn4C1BAlSOzXkZVy1x0WFTJz6bX/szNjJt?=
 =?us-ascii?Q?NiNWYYcJMWkvb+v37RM5KODthgYQqTR3eakRMKZeZ5LDvpp+2MG+LUekOxpk?=
 =?us-ascii?Q?A6sqnp27kny1wQdhlE+i7+jfUL5cGzlycNpKCn+Mi8QXUn0JMJ4Hxt2hZzXZ?=
 =?us-ascii?Q?jxmrB0eAVOjXhYhAY8V6KSggEbBUbWE9GSjMWvyQHeA4uDRMNs77fneuepeB?=
 =?us-ascii?Q?x/CZaYgXBKNpJUBNekNtNRn2tnTq/y1QbeE7UUmSSFopaZ8AwHejcyKFZj4e?=
 =?us-ascii?Q?W5fceysTwMutik8TgdRsriOo2bNMWx40IipegWND4igUU/0B1Lo3XMz7TrxO?=
 =?us-ascii?Q?7F2ME1QVcqcvMSRCFLwfNlTIfCplHTf3p/grgYUEi2huj5OVvwHZXA5Tm8H9?=
 =?us-ascii?Q?Oq7rU+BlOzf48SsNFLGK/KgDL+FeL2YGVRR3aQILPdNwKBp+SD2Q32gqr2EC?=
 =?us-ascii?Q?kvMCMa52YCJDYVhaEXiZtWEMztVkkvg8pIthpJjyViCpI1ZWtyou8ShyDsjv?=
 =?us-ascii?Q?otrR9LFLJ45z0D3tSZNBXheE?=
X-OriginatorOrg: nxp.com
X-MS-Exchange-CrossTenant-Network-Message-Id: c63e1a8c-267a-4514-6a31-08d8e3ac8c49
X-MS-Exchange-CrossTenant-AuthSource: VI1PR04MB3983.eurprd04.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 10 Mar 2021 10:09:10.4364
 (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: HBwrz3UHjSoRLoIfof3Z+onW/9E9OFz1NXJ20/6uW0kKqdObJ/wciIjheuKkziL5whK5iQ2sYHJ2mN2sZRinZg==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: VI1PR0401MB2318
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>
Signed-off-by: Liu Ying <victor.liu@nxp.com>
---
v4->v5:
* Add Robert's R-b tag.

v3->v4:
* No change.

v2->v3:
* No change.

v1->v2:
* No change.

 .../userspace-api/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 7f16cbe..201c16d 100644
--- a/Documentation/userspace-api/media/v4l/subdev-formats.rst
+++ b/Documentation/userspace-api/media/v4l/subdev-formats.rst
@@ -1488,6 +1488,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
+      -
+      - 0
+      - 0
+      - 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
+      -
+      - 0
+      - 0
+      - 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
@@ -1665,6 +1739,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.7.4