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 v2 1/2] media: add RealVideo format
Date:   Thu, 12 Jan 2023 17:18:17 +0800
Message-Id: <ef8212602467151a6e20ccce3e7ef7adcd7a7c91.1673514352.git.ming.qian@nxp.com>
In-Reply-To: <cover.1673514352.git.ming.qian@nxp.com>
References: <cover.1673514352.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?q3iETQ+JgwGAxKSom8sU1umbb2zKzelGrHtaOgsKcJCUKZhnrXjB//Sq1Mto?=
 =?us-ascii?Q?VrQqQmhFPYWHioh+gsKZgxf7z5urTWPgXQfbrGrQa+DEaXB02nXe8rCUk/Mr?=
 =?us-ascii?Q?82s0Iw7ONOxKTqhSj9rjLh5GLJ37gy8lNKMJu5tJJAbyB+XF69+WAo7sHzB2?=
 =?us-ascii?Q?Z+lp8ZbW3ELvvfvzgEEptboVX52CKGkARJVhbpRKTon7XQBaKEDsjGPd6MIe?=
 =?us-ascii?Q?9/zDwSheeiVkp6qe+H78M7/MsQ5F1HPU6gWWwlqaKoFaIZQY+fI4qVS8I396?=
 =?us-ascii?Q?0vRWmd/a3UFm0Tn6yiGoLwUMzSj4D2AmLM4dZiQJzY8BD/oJhxwJKVsu4puJ?=
 =?us-ascii?Q?vhNF7n7aN+tNxNk8TeZszTz2byjGB1NagKYI5MoxyPQ3bSBtDyJUx49X+umD?=
 =?us-ascii?Q?DMfRiRCBswe0v7KIoudmWswdmUC7p2fRWOB4lRJlL8I4OLUsBJReMMAQSdKT?=
 =?us-ascii?Q?UqTNsAL2sESHe2rgDeIcHyUfeAjvadm1UoNzWLJbUakO7VC8p5qpN1mkKbd9?=
 =?us-ascii?Q?qEiINF7KDl9jZL6O+MHMPkcJwyNXWv7/M6cLviocjeqwZ1tjX/pFMi3g1mp8?=
 =?us-ascii?Q?+wf2W+zYckyvrAYVrVhNK28NGN+hNGv04f1/v6AwYi23GYvdoZBAbHDXvBE0?=
 =?us-ascii?Q?6fX3uS9pjLAJ3cm0MrsDH29ct2k1Dd/2AdvWxEmG4GvQYFVaBKUtfwSD6fYE?=
 =?us-ascii?Q?omJVidvtZXnhLpRYUiGqbdixU3q+CVtDA5Kt58kISmemJlqK64/kP/KvuX3A?=
 =?us-ascii?Q?qyMJmt/iD43NaeyQZEJTVwm5w2eC15yaV5X+KMA4Sct1YbNdhf+zS8rhCMHs?=
 =?us-ascii?Q?AqLS/LJgdN79ozprQJKzY7zlCGUd9mufmBrmup40F4YSdm8CpHbT4ZWdIMPB?=
 =?us-ascii?Q?Sef+hy1BrdgPjxkwolT+y7hdTobWYkkMUuhLw0Fg4tFFwlrE67yc4MiJUgzR?=
 =?us-ascii?Q?R5pvdhhf7daOFsr9jglllXXDE8ERfyV+W+OGSjqyEF688y6gP8Et8bpkdkL7?=
 =?us-ascii?Q?CIbY/0lDqpdVcomOTpq/hwFgcgqBkFb0pHP6gkdbTElzslqUDEkJdxEpXtxR?=
 =?us-ascii?Q?WOE8w0VVMDhIzm2iXcR0cYgsSTGsbZ3POpH23J7l9rAdnMix2KDI8jERiCeo?=
 =?us-ascii?Q?SaC3nLjcAUgLrYui28r0CXxd8x8ACb1iW0lwWTOouuubOBUZ5/TuffmeRhPt?=
 =?us-ascii?Q?bHhwkVZiSNQeuIO2GRMHa3tDk2wcxbp0hbLWlpR4Ne/fS011pR5TUPChBlAg?=
 =?us-ascii?Q?G5r83sTbDjdz6dURaltz4iWmpCOUtB94/KY0pOhjFRg0e5smZKyaut2FzpRX?=
 =?us-ascii?Q?4xKZKEA5yE1p7aOPzaH+qG/OXnI0QiReUiDQEzy2m8a2xgfbCoh/Ildwi+LA?=
 =?us-ascii?Q?W5wTAX3Zl+3FsElAXb2qnJy6lYTOWaXEdCs0vtm6uDhU86XFoFMM2aZ+HGGj?=
 =?us-ascii?Q?v0nxVXNlXG5Sb65LlhL0jZbvWGArgHMuw6Dv1s8bdu6X2H7B5FFxt2f978ps?=
 =?us-ascii?Q?Z6F7VOm91lAqWkg+IHMJPdkxxyKzIuwVAXdl2V6GDnsMA9HDxSfu4HjVZAIa?=
 =?us-ascii?Q?nj6Q7nxVEv5+h38F4kZtj5cNk1cXW6UOuKT3slVZ?=
X-OriginatorOrg: nxp.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 97875b8a-4c09-4e93-c51a-08daf47dfdd6
X-MS-Exchange-CrossTenant-AuthSource: AM6PR04MB6341.eurprd04.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 12 Jan 2023 09:18:39.5802
 (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: lTGtIfxgET2TU94+gbEQW6qLKI7s7wBE7cKao6Y7hBGsunh5HE4qMcVHaNhbVDfbvTXEpHqPSN9YHnrTRY0Nzg==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM9PR04MB8923
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.
RV10 and RV20 are the H.263-based codecs.
RV30 and RV40 are RealNetworks' proprietary H.264-based codecs.
RV60 is RealNetworks' proprietary HEVC-based codecs.

Signed-off-by: Ming Qian <ming.qian@nxp.com>
---
 .../userspace-api/media/v4l/pixfmt-compressed.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-compressed.rst b/Documentation/userspace-api/media/v4l/pixfmt-compressed.rst
index a0230f357680..22035d92c788 100644
--- a/Documentation/userspace-api/media/v4l/pixfmt-compressed.rst
+++ b/Documentation/userspace-api/media/v4l/pixfmt-compressed.rst
@@ -237,6 +237,17 @@ 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-RV:
+
+      - ``V4L2_PIX_FMT_RV``
+      - 'RV00'
+      - 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.
+        RV10 and RV20 are the H.263-based codecs.
+        RV30 and RV40 are RealNetworks' proprietary H.264-based codecs.
+        RV60 is RealNetworks' proprietary HEVC-based codecs.
 
 .. raw:: latex
 
diff --git a/drivers/media/v4l2-core/v4l2-ioctl.c b/drivers/media/v4l2-core/v4l2-ioctl.c
index 9b5b04b8aa69..c375261d169f 100644
--- a/drivers/media/v4l2-core/v4l2-ioctl.c
+++ b/drivers/media/v4l2-core/v4l2-ioctl.c
@@ -1473,6 +1473,7 @@ 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_RV:		descr = "RealVideo"; 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..0a7ddb023d7c 100644
--- a/include/uapi/linux/videodev2.h
+++ b/include/uapi/linux/videodev2.h
@@ -740,6 +740,7 @@ 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_RV       v4l2_fourcc('R', 'V', '0', '0') /* RealVideo */
 
 /*  Vendor-specific formats   */
 #define V4L2_PIX_FMT_CPIA1    v4l2_fourcc('C', 'P', 'I', 'A') /* cpia1 YUV */
-- 
2.38.1