From:   Ming Qian <ming.qian@nxp.com>
To:     mchehab@kernel.org, mirela.rabulea@oss.nxp.com,
        hverkuil-cisco@xs4all.nl
Cc:     shawnguo@kernel.org, s.hauer@pengutronix.de, kernel@pengutronix.de,
        festevam@gmail.com, xiahong.bao@nxp.com, linux-imx@nxp.com,
        linux-media@vger.kernel.org, linux-kernel@vger.kernel.org,
        devicetree@vger.kernel.org, linux-arm-kernel@lists.infradead.org
Subject: [PATCH v2 02/10] media: Add Y012 video format
Date:   Wed,  1 Feb 2023 14:02:24 +0800
Message-Id: <93889cdefacaad260d978a8353066dd384a64609.1675230665.git.ming.qian@nxp.com>
In-Reply-To: <cover.1675230665.git.ming.qian@nxp.com>
References: <cover.1675230665.git.ming.qian@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?YP9mH6UdS3ni0hrQJnsG+HQnrcPQFPsgAskJN+oLxw1OFMZL5rFnKK/olQ/I?=
 =?us-ascii?Q?DHqjaJqfP9EXSPik3Y8gQlJkkRoVLhcW90B/UI4N81KH5/wOzb4GFUtGsgik?=
 =?us-ascii?Q?F0xuTtp2QepCw+wEV3egRutY+xeimDBtPZ44cOFdmK6HY9RSTD6O+grYcwp7?=
 =?us-ascii?Q?ESvvjD1trfBkZy/8H+brV8Y1bwoYE52EUgw9xRF/fS9yJoaKTpvRhTqSNDdZ?=
 =?us-ascii?Q?aps8QwRUBNk0zKzXcX4C8DmdyeHBUvyCPkOzT0znTyJrt39zPBnCPi/50Kbq?=
 =?us-ascii?Q?7JrsbBTZEUOvIvIvFTzBIRgTep2IjpfzMB9fC03paYoLBZPF0HHpXZhANPVV?=
 =?us-ascii?Q?i9/fWI/fSNERz9BFhwGYHU457n4MhYqguNn7dTx9vNG0rEdV4zejwgrP1S0Z?=
 =?us-ascii?Q?PVOuWArbgBsznUUXLIuUWlO6IPq1AKbbgS44umckRFlTnAYENYVQJC8+1wru?=
 =?us-ascii?Q?2gSQ+STdMX1L6ZxkSxtPxZw8WTFZZGJ4W4Bqcyba0aG+8nXIgy8v3p4qzttS?=
 =?us-ascii?Q?tBvzQTbUSc8oamzc8G/IzMCLcYYokXzlfXrLKsolojAZeTqp1M61qpntsjRB?=
 =?us-ascii?Q?fJDkPxWw7Vn07zQuTdPr8i+6wF+hA+fNI6LdGg1xmxhcx2aeWyo0D0ewSEK9?=
 =?us-ascii?Q?/6MKvmu5951hQf7Te/vPKsD9p9mYUbgigRbJgXl9yqImNudQN98ZrTzIPo5m?=
 =?us-ascii?Q?TqUarLYGw0DOnfAnEwRkOAHNBSB3vxkbjdXTBOuuUdYDLNfg5C+PY5Shq1Pe?=
 =?us-ascii?Q?asfjlq3bmzBrRX4iM/QkrxavII9M/jQDU9FVbkg84rBoCQLMKW5ocHLc9b9d?=
 =?us-ascii?Q?j7PBAX6gnGurMtA7OSFXnGo+VV/PS4NouAzlJAdQ9F4UadOIpO2cSzUJZQLh?=
 =?us-ascii?Q?A5gKmdJDC2o0peUZRewRWcxRNeqLFDkBECyakaTJVwmhn9snDShQGpR2c/iI?=
 =?us-ascii?Q?eoCf7TYn8va5WTsn3FvVWLm6bk1yl64YOqraHqOBFp5OE7iBKDYX0cE8AfUa?=
 =?us-ascii?Q?CTpdF+zMZfB5fmL8INelKa0rkjUPzKG8y3sYQQVocJFS2vg+efTca+xsgYzn?=
 =?us-ascii?Q?ucPvNPYpLKn6yZDGnL5cxVpxakoeErXXAZRe3kSTAXxsYyjvKMWp4ILq0Fw1?=
 =?us-ascii?Q?cACmu9GCio28DopGXBbY3milrcFttwSM93WzDZ4sPAkEVaxLdJzaFZ/TiAfw?=
 =?us-ascii?Q?SapuNTAsMMkWBrgN9SLVMxZCcuzovR8i0Kn/B2bawgU0u2YWUz8ilsWXzkF+?=
 =?us-ascii?Q?DgXFd4Br+lwMvKvK8MZabC/UoJmi1hCuWtAAOWKEhOq69ByxDoL612EF6cLR?=
 =?us-ascii?Q?+55assk1uDBQlOKI0VDs94DyydP0NO+pKTyoS94NafP0tUiVoBt6gXZzVTLx?=
 =?us-ascii?Q?6pk4lSyaH9DQ+9D1E6DTiXHwYo+MPjfzcZmczzeqBUdUlkzhMmg8qyiaDyKh?=
 =?us-ascii?Q?N+tUlDmG5j0OZSh6bT0/oavBJNDCihoWIku2TnBkBocBnOkuvzoubxJf7p6g?=
 =?us-ascii?Q?GnYl6yQlM7d3U69LzDRWXyChE8UQ/jtG/7ySHrNr4uLPROSTifPaws8a9Kt/?=
 =?us-ascii?Q?f1xZwvebjnxLZKU+jRTP6T1iFkkMLFPq+3VDI9Dw?=
X-OriginatorOrg: nxp.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 1de0bcc9-b257-4596-1dcb-08db041a082c
X-MS-Exchange-CrossTenant-AuthSource: AM6PR04MB6341.eurprd04.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 01 Feb 2023 06:03:25.8170
 (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: E1M0eYWqIi9a6WPt45Fou1s5W3XB15az4asrZ6frCI2fCV0e2kl+ph5GkrKvS6hBaT2frjSlTbWq7P5qIme9/A==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: DB9PR04MB8429
Precedence: bulk
List-ID: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org

Y012 is a luma-only formats with 12-bits per pixel,
expanded to 16bits.
Data in the 12 high bits, zeros in the 4 low bits,
arranged in little endian order.

Signed-off-by: Ming Qian <ming.qian@nxp.com>
---
 .../userspace-api/media/v4l/pixfmt-yuv-luma.rst       | 11 +++++++++++
 drivers/media/v4l2-core/v4l2-ioctl.c                  |  1 +
 include/uapi/linux/videodev2.h                        |  1 +
 3 files changed, 13 insertions(+)

diff --git a/Documentation/userspace-api/media/v4l/pixfmt-yuv-luma.rst b/Documentation/userspace-api/media/v4l/pixfmt-yuv-luma.rst
index 6a387f9df3ba..3ffa29000238 100644
--- a/Documentation/userspace-api/media/v4l/pixfmt-yuv-luma.rst
+++ b/Documentation/userspace-api/media/v4l/pixfmt-yuv-luma.rst
@@ -103,6 +103,17 @@ are often referred to as greyscale formats.
       - ...
       - ...
 
+    * .. _V4L2-PIX-FMT-Y012:
+
+      - ``V4L2_PIX_FMT_Y012``
+      - 'Y012'
+
+      - Y'\ :sub:`0`\ [3:0] `0000`
+      - Y'\ :sub:`0`\ [11:4]
+      - ...
+      - ...
+      - ...
+
     * .. _V4L2-PIX-FMT-Y14:
 
       - ``V4L2_PIX_FMT_Y14``
diff --git a/drivers/media/v4l2-core/v4l2-ioctl.c b/drivers/media/v4l2-core/v4l2-ioctl.c
index 067dbdd0a9ef..0ee730aa6cc7 100644
--- a/drivers/media/v4l2-core/v4l2-ioctl.c
+++ b/drivers/media/v4l2-core/v4l2-ioctl.c
@@ -1303,6 +1303,7 @@ static void v4l_fill_fmtdesc(struct v4l2_fmtdesc *fmt)
 	case V4L2_PIX_FMT_Y6:		descr = "6-bit Greyscale"; break;
 	case V4L2_PIX_FMT_Y10:		descr = "10-bit Greyscale"; break;
 	case V4L2_PIX_FMT_Y12:		descr = "12-bit Greyscale"; break;
+	case V4L2_PIX_FMT_Y012:		descr = "12-bit Greyscale"; break;
 	case V4L2_PIX_FMT_Y14:		descr = "14-bit Greyscale"; break;
 	case V4L2_PIX_FMT_Y16:		descr = "16-bit Greyscale"; break;
 	case V4L2_PIX_FMT_Y16_BE:	descr = "16-bit Greyscale BE"; break;
diff --git a/include/uapi/linux/videodev2.h b/include/uapi/linux/videodev2.h
index 5448aa3b7858..3d8f89bff33c 100644
--- a/include/uapi/linux/videodev2.h
+++ b/include/uapi/linux/videodev2.h
@@ -583,6 +583,7 @@ struct v4l2_pix_format {
 #define V4L2_PIX_FMT_Y6      v4l2_fourcc('Y', '0', '6', ' ') /*  6  Greyscale     */
 #define V4L2_PIX_FMT_Y10     v4l2_fourcc('Y', '1', '0', ' ') /* 10  Greyscale     */
 #define V4L2_PIX_FMT_Y12     v4l2_fourcc('Y', '1', '2', ' ') /* 12  Greyscale     */
+#define V4L2_PIX_FMT_Y012    v4l2_fourcc('Y', '0', '1', '2') /* 12  Greyscale     */
 #define V4L2_PIX_FMT_Y14     v4l2_fourcc('Y', '1', '4', ' ') /* 14  Greyscale     */
 #define V4L2_PIX_FMT_Y16     v4l2_fourcc('Y', '1', '6', ' ') /* 16  Greyscale     */
 #define V4L2_PIX_FMT_Y16_BE  v4l2_fourcc_be('Y', '1', '6', ' ') /* 16  Greyscale BE  */
-- 
2.38.1