[PATCH v4 2/3] media: uapi: Add Qualcomm iris MBR rate control

From: Sachin Kumar Garg

Date: Mon Nov 16 2026 - 12:06:16 EST


Add include/uapi/linux/media/qcom/iris-config.h defining
V4L2_CID_QCOM_MBR_RATE_CONTROL, the first control in the
V4L2_CID_USER_QCOM_IRIS_BASE range, so that userspace can use it.

Document the control in
Documentation/userspace-api/media/drivers/qcom-iris.rst and add both
files to the Qualcomm iris MAINTAINERS entry.

Signed-off-by: Sachin Kumar Garg <sachin.garg@xxxxxxxxxxxxxxxx>
---
.../userspace-api/media/drivers/index.rst | 1 +
.../userspace-api/media/drivers/qcom-iris.rst | 28 ++++++++++++++++++++++
MAINTAINERS | 2 ++
include/uapi/linux/media/qcom/iris-config.h | 15 ++++++++++++
4 files changed, 46 insertions(+)

diff --git a/Documentation/userspace-api/media/drivers/index.rst b/Documentation/userspace-api/media/drivers/index.rst
index 8d2c489b8453..66cb9773bd4b 100644
--- a/Documentation/userspace-api/media/drivers/index.rst
+++ b/Documentation/userspace-api/media/drivers/index.rst
@@ -37,6 +37,7 @@ For more details see the file COPYING in the source distribution of Linux.
max2175
npcm-video
omap3isp-uapi
+ qcom-iris
thp7312
uvcvideo
vgxy61
diff --git a/Documentation/userspace-api/media/drivers/qcom-iris.rst b/Documentation/userspace-api/media/drivers/qcom-iris.rst
new file mode 100644
index 000000000000..49f70ef49d6c
--- /dev/null
+++ b/Documentation/userspace-api/media/drivers/qcom-iris.rst
@@ -0,0 +1,28 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+Qualcomm Iris video driver
+==========================
+
+The Qualcomm Iris video driver implements the following driver-specific
+control.
+
+Driver-specific Controls
+------------------------
+
+``V4L2_CID_QCOM_MBR_RATE_CONTROL (boolean)``
+ MBR Rate Control is a VBR Rate Control mode optimized for
+ surveillance video content, which has high temporal correlation
+ due to static camera positions. This Rate Control smartly identifies
+ key-frames in the scene, and allocates more bits to them to improve
+ the coding efficiency by taking advantage of high temporal
+ correlation in surveillance videos.
+
+ .. flat-table::
+ :header-rows: 0
+ :stub-columns: 0
+ :widths: 1 4
+
+ * - ``0``
+ - MBR Rate Control is disabled (default).
+ * - ``1``
+ - MBR Rate Control is enabled.
diff --git a/MAINTAINERS b/MAINTAINERS
index 760791e3635f..f28f235f5cb1 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -22599,7 +22599,9 @@ L: linux-media@xxxxxxxxxxxxxxx
L: linux-arm-msm@xxxxxxxxxxxxxxx
S: Maintained
F: Documentation/devicetree/bindings/media/qcom,*-iris.yaml
+F: Documentation/userspace-api/media/drivers/qcom-iris.rst
F: drivers/media/platform/qcom/iris/
+F: include/uapi/linux/media/qcom/iris-config.h

QUALCOMM MIPI CSI2 PHY DRIVER
M: Bryan O'Donoghue <bod@xxxxxxxxxx>
diff --git a/include/uapi/linux/media/qcom/iris-config.h b/include/uapi/linux/media/qcom/iris-config.h
new file mode 100644
index 000000000000..0551b61aa06c
--- /dev/null
+++ b/include/uapi/linux/media/qcom/iris-config.h
@@ -0,0 +1,15 @@
+/* SPDX-License-Identifier: GPL-2.0-only WITH Linux-syscall-note */
+/*
+ * Qualcomm Iris Video Driver - Userspace API
+ *
+ * Copyright (c) Qualcomm Technologies, Inc. and/or its subsidiaries.
+ */
+
+#ifndef __UAPI_QCOM_IRIS_CONFIG_H
+#define __UAPI_QCOM_IRIS_CONFIG_H
+
+#include <linux/v4l2-controls.h>
+
+#define V4L2_CID_QCOM_MBR_RATE_CONTROL (V4L2_CID_USER_QCOM_IRIS_BASE + 0x0)
+
+#endif /* __UAPI_QCOM_IRIS_CONFIG_H */

--
2.34.1