@@ -607,6 +607,18 @@ Buffer Flags
the format. Any subsequent call to the
:ref:`VIDIOC_DQBUF <VIDIOC_QBUF>` ioctl will not block anymore,
but return an ``EPIPE`` error code.
+ * .. _`V4L2-BUF-FLAG-HEADERS-ONLY`:
+
+ - ``V4L2_BUF_FLAG_HEADERS_ONLY``
+ - 0x00200000
+ - This flag may be set by user for decoder and by driver for encoder
+ when the buffer only contains the codec header,
+ but does not contain any frame data. Usually the codec
+ header is merged with the next IDR frame, with the flag
+ ``V4L2_BUF_FLAG_KEYFRAME``, but there are still some scenarios that will
+ queue the header in a separate buffer. This flag can be set only when
+ the codec supports V4L2_MPEG_VIDEO_HEADER_MODE_SEPARATE,
+ and the header mode is set to V4L2_MPEG_VIDEO_HEADER_MODE_SEPARATE
* .. _`V4L2-BUF-FLAG-REQUEST-FD`:
- ``V4L2_BUF_FLAG_REQUEST_FD``
@@ -1386,8 +1386,12 @@ enum v4l2_mpeg_video_intra_refresh_period_type -
(enum)
enum v4l2_mpeg_video_header_mode -
- Determines whether the header is returned as the first buffer or is
- it returned together with the first frame. Applicable to encoders.
+ Determines whether the header is returned as the first buffer
+ with flag V4L2_BUF_FLAG_HEADERS_ONLY or if
+ it is returned together with the first frame.
+ Applicable to encoders and decoders.
+ If it's not implemented in a driver,
+ V4L2_MPEG_VIDEO_HEADER_MODE_JOINED_WITH_1ST_FRAME is to be assumed,
Possible values are:
.. raw:: latex
@@ -1401,7 +1405,7 @@ enum v4l2_mpeg_video_header_mode -
:stub-columns: 0
* - ``V4L2_MPEG_VIDEO_HEADER_MODE_SEPARATE``
- - The stream header is returned separately in the first buffer.
+ - The stream header is returned separately in the first buffer with the flag V4L2_BUF_FLAG_HEADERS_ONLY.
* - ``V4L2_MPEG_VIDEO_HEADER_MODE_JOINED_WITH_1ST_FRAME``
- The stream header is returned together with the first encoded
frame.
@@ -1156,6 +1156,8 @@ static inline __u64 v4l2_timeval_to_ns(const struct timeval *tv)
#define V4L2_BUF_FLAG_TSTAMP_SRC_SOE 0x00010000
/* mem2mem encoder/decoder */
#define V4L2_BUF_FLAG_LAST 0x00100000
+/* Buffer only contains the codec header */
+#define V4L2_BUF_FLAG_HEADERS_ONLY 0x00200000
/* request_fd is valid */
#define V4L2_BUF_FLAG_REQUEST_FD 0x00800000
By setting the V4L2_BUF_FLAG_HEADERS_ONLY flag, hint the vb2 only contains stream header, but does not contain any frame data. This flag needs to be used when header mode is set to V4L2_MPEG_VIDEO_HEADER_MODE_SEPARATE. For decoder, there are some scenarios user only queue the header in a separate buffer, especially in android case, but some vpu requires one buffer contains one frame, for example, the amphion vpu, if the buffer only contains header, the driver will merge the header to the next IDR frame. So driver need this flag to tell this case. For encoder, it's an enhancement. when V4L2_MPEG_VIDEO_HEADER_MODE_SEPARATE is set, encoder can return vps, sps, pps separately. Signed-off-by: Ming Qian <ming.qian@nxp.com> --- Documentation/userspace-api/media/v4l/buffer.rst | 12 ++++++++++++ .../userspace-api/media/v4l/ext-ctrls-codec.rst | 10 +++++++--- include/uapi/linux/videodev2.h | 2 ++ 3 files changed, 21 insertions(+), 3 deletions(-)