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:   Ming Qian <ming.qian@nxp.com>
To:     mchehab@kernel.org, hverkuil-cisco@xs4all.nl
Cc:     shawnguo@kernel.org, robh+dt@kernel.org, s.hauer@pengutronix.de,
        kernel@pengutronix.de, festevam@gmail.com, linux-imx@nxp.com,
        xiahong.bao@nxp.com, eagle.zhou@nxp.com, tao.jiang_2@nxp.com,
        linux-media@vger.kernel.org, linux-kernel@vger.kernel.org,
        linux-arm-kernel@lists.infradead.org
Subject: [PATCH v4 1/2] media: add RealVideo format RV30 and RV40
Date:   Tue, 17 Jan 2023 10:31:54 +0800
Message-Id: <daff0c9a4040d77f142f055d2113100251354d63.1673922423.git.ming.qian@nxp.com>
In-Reply-To: <cover.1673922423.git.ming.qian@nxp.com>
References: <cover.1673922423.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?kuXZXSYcn3CjrCkUfQltUf7eFan4nW/1Ly3AEtwlx3vvcdxEg8zsNAmyQm0B?=
 =?us-ascii?Q?J0Kq8betnYYpIkGeuT7mmoV8NEPhB2hhP5cvEO5Y5sPzMAudxjJ7Fl1u5ggN?=
 =?us-ascii?Q?rdgmGOZqjdkpBktM6urkStJH9az2WfB59yOd8z8yzNf6s5vG8OoCWvuCI20+?=
 =?us-ascii?Q?yZZmJV8j4vkvLK5di0lmCZ2dOCrfPfG8mjIFlXtyMyTPg+k2N9g+iXZT0bq9?=
 =?us-ascii?Q?5Jl+QU0BRlDuwM1oHUpAe56f0kBLoS7B3o+34G7lIRFgLRr9MBiD/cGZM7j6?=
 =?us-ascii?Q?bCynGfSDWuGy4OMlP2T+RKXLlGNaUPetAAGpgaMnB0ielkYvrfGI1f3wrVve?=
 =?us-ascii?Q?uUKEsWITYaZGmQ4dtY6phuMqZraageX5DU/EqvNMxMTHGQS02D3/Hdz0GWFb?=
 =?us-ascii?Q?BzMnSH9WHFU2xlISQOBvMSfVyzAEC+q99LsYcAjA4LSoLvfqoYQ0ZfbfHE0r?=
 =?us-ascii?Q?GsOteTSThAq5KJzjK+wZbnq5W+ZErBYAs/Im9MHXkplsQLCPO/xfDPKx6/2H?=
 =?us-ascii?Q?60DeIa4256uoBuV440ze26Cw18j9a9BrlYQTc2oexx1vR4BylyABMgLQDtgr?=
 =?us-ascii?Q?84YHUXmU2jJYx7EXJf2q00ykM6qaynZ7EForHJ9Np8jbUnBD5TMTI2+CGSDO?=
 =?us-ascii?Q?Cf+7gjwjdAnB37zQ9txkfoVwQSrAD5muNIlKRbszODxN4uQxp/Te6b0lKhTp?=
 =?us-ascii?Q?tSbT4rJ6jW0F0xlAZnS3lZfo3QmHt+De3TRLcdixKOsrY5O9AGX1kil4lRFp?=
 =?us-ascii?Q?0qiSluHsYPIS9JEjs/tdtvJMJ3Zo1Fcm+8rM6xuT/6/9U92PjujFEntxX/y4?=
 =?us-ascii?Q?Daj86I4IT5r7Hx1dhn39KstzCZBFry7vyYQL5ObP27jtFQwxs0Lw5yVdKH8F?=
 =?us-ascii?Q?mbN2KDHgEFx9VJG+RWYuktLB3OgNiwEp18nAjOIZmHbzIV8zP2rfkk0eNrmP?=
 =?us-ascii?Q?24lvQo1+idy92o/6utE+K5LcuwIppcebv3ZP+yLsteo7mMOfyvI2zAH0Lehe?=
 =?us-ascii?Q?1uThcY5jj1qNOlxC3Sm6gG71/BSNVBADRi5kC6QqUoqkgvCwAIDZulmkyjUx?=
 =?us-ascii?Q?a3CbWOxcjE+Bzbe9D+ARvrIxUJkJRzA1u8VVMCM+Gg755bUnvWvJdqdoeiqo?=
 =?us-ascii?Q?KFTzIGB5uXO2W9ZkGd9x1OwWX2uOT211kVhD2Z1/YHlnpJR9qgnVvhd2YeCu?=
 =?us-ascii?Q?qPpk+5QoGUFVj67+fFw1oUK7fBxW5BR+yatCfnZNXZGnmsSLYr2qByLa+nbR?=
 =?us-ascii?Q?O4A44tasWIWvXTdFr1aY2ZUjE474BnyE0MLNaLs5gluhkFst+vZ01ClU+1XF?=
 =?us-ascii?Q?IPU9La3B8afNo2NdpDyWCdn6Y6J4rP+jQkHAU1XgA62zv6t8zUi4euKlx8im?=
 =?us-ascii?Q?dmtFb0MJNziIpndLipOpXGxiVsfUNNJswvL5aJOoNEWVTvcbC9lvn5GQ2Hmx?=
 =?us-ascii?Q?af2xRWRNJPVATYsB+sFpEHpTAtsXWkyY0kUFUuzCj0OAPTr4gtya/dahaNzJ?=
 =?us-ascii?Q?rtxuEKUqNWWTB8lKVcvFwFKSdg5GPU0YIfOQdaDTtWVstMDPUoXpfzyo5GYc?=
 =?us-ascii?Q?+nIhagj3IJUh2Kvre45dbGfR+1EYCf4/09QDdkNm?=
X-OriginatorOrg: nxp.com
X-MS-Exchange-CrossTenant-Network-Message-Id: a8ce6366-015d-4e77-2e28-08daf8330cff
X-MS-Exchange-CrossTenant-AuthSource: AM6PR04MB6341.eurprd04.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 17 Jan 2023 02:32:17.3604
 (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: Ua2wmvzHWuVHMoFzQI3DXWXEMVqf2hhZbJcLjIveIt+XLjKSwQtUZ/1npOlcY5JneMYLkHsJQIRKh8xhcJmaIQ==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: DBBPR04MB7786
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_PASS,SPF_PASS 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

RealVideo, or also spelled as Real Video, is a suite of proprietary
video compression formats developed by RealNetworks -
the specific format changes with the version.
RealVideo codecs are identified by four-character codes.
RV30 and RV40 are RealNetworks' proprietary H.264-based codecs.

Reviewed-by: Nicolas Dufresne <nicolas.dufresne@collabora.com>
Signed-off-by: Ming Qian <ming.qian@nxp.com>
---
 .../media/v4l/pixfmt-compressed.rst           | 20 +++++++++++++++++++
 drivers/media/v4l2-core/v4l2-ioctl.c          |  2 ++
 include/uapi/linux/videodev2.h                |  2 ++
 3 files changed, 24 insertions(+)

diff --git a/Documentation/userspace-api/media/v4l/pixfmt-compressed.rst b/Documentation/userspace-api/media/v4l/pixfmt-compressed.rst
index a0230f357680..06b78e5589d2 100644
--- a/Documentation/userspace-api/media/v4l/pixfmt-compressed.rst
+++ b/Documentation/userspace-api/media/v4l/pixfmt-compressed.rst
@@ -237,6 +237,26 @@ Compressed Formats
         Metadata associated with the frame to decode is required to be passed
         through the ``V4L2_CID_STATELESS_FWHT_PARAMS`` control.
 	See the :ref:`associated Codec Control ID <codec-stateless-fwht>`.
+    * .. _V4L2-PIX-FMT-RV30:
+
+      - ``V4L2_PIX_FMT_RV30``
+      - 'RV30'
+      - RealVideo, or also spelled as Real Video, is a suite of
+        proprietary video compression formats developed by
+        RealNetworks - the specific format changes with the version.
+        RealVideo codecs are identified by four-character codes.
+        RV30 corresponds to RealVideo 8, suspected to be based
+        largely on an early draft of H.264
+    * .. _V4L2-PIX-FMT-RV40:
+
+      - ``V4L2_PIX_FMT_RV40``
+      - 'RV40'
+      - RV40 represents RealVideo 9 and RealVideo 10.
+        RealVideo 9, suspected to be based on H.264.
+        RealVideo 10, aka RV9 EHQ, This refers to an improved encoder
+        for the RV9 format that is fully backwards compatible with
+        RV9 players - the format and decoder did not change, only
+        the encoder did. As a result, it uses the same FourCC.
 
 .. raw:: latex
 
diff --git a/drivers/media/v4l2-core/v4l2-ioctl.c b/drivers/media/v4l2-core/v4l2-ioctl.c
index 9b5b04b8aa69..0546b00d3fc9 100644
--- a/drivers/media/v4l2-core/v4l2-ioctl.c
+++ b/drivers/media/v4l2-core/v4l2-ioctl.c
@@ -1473,6 +1473,8 @@ static void v4l_fill_fmtdesc(struct v4l2_fmtdesc *fmt)
 		case V4L2_PIX_FMT_FWHT:		descr = "FWHT"; break; /* used in vicodec */
 		case V4L2_PIX_FMT_FWHT_STATELESS:	descr = "FWHT Stateless"; break; /* used in vicodec */
 		case V4L2_PIX_FMT_SPK:		descr = "Sorenson Spark"; break;
+		case V4L2_PIX_FMT_RV30:		descr = "RealVideo 8"; break;
+		case V4L2_PIX_FMT_RV40:		descr = "RealVideo 9 & 10"; break;
 		case V4L2_PIX_FMT_CPIA1:	descr = "GSPCA CPiA YUV"; break;
 		case V4L2_PIX_FMT_WNVA:		descr = "WNVA"; break;
 		case V4L2_PIX_FMT_SN9C10X:	descr = "GSPCA SN9C10X"; break;
diff --git a/include/uapi/linux/videodev2.h b/include/uapi/linux/videodev2.h
index 262ef10cfa02..b121154a6e24 100644
--- a/include/uapi/linux/videodev2.h
+++ b/include/uapi/linux/videodev2.h
@@ -740,6 +740,8 @@ struct v4l2_pix_format {
 #define V4L2_PIX_FMT_H264_SLICE v4l2_fourcc('S', '2', '6', '4') /* H264 parsed slices */
 #define V4L2_PIX_FMT_HEVC_SLICE v4l2_fourcc('S', '2', '6', '5') /* HEVC parsed slices */
 #define V4L2_PIX_FMT_SPK      v4l2_fourcc('S', 'P', 'K', '0') /* Sorenson Spark */
+#define V4L2_PIX_FMT_RV30     v4l2_fourcc('R', 'V', '3', '0') /* RealVideo 8 */
+#define V4L2_PIX_FMT_RV40     v4l2_fourcc('R', 'V', '4', '0') /* RealVideo 9 & 10 */
 
 /*  Vendor-specific formats   */
 #define V4L2_PIX_FMT_CPIA1    v4l2_fourcc('C', 'P', 'I', 'A') /* cpia1 YUV */
-- 
2.38.1