MPEG-2 stateless API cleanup
v2 cover MPEG-2 stateless API cleanup
Hello everyone,
Following the H.264 API cleanup, and with all the lessons learned from it, here's a revisit on the MPEG-2 API.
The biggest changes are:
* Drop slice size and offset parameters, given the API doesn't seem to be designed to work per-slice.
* Convert all the 1-bit syntax elements from structure fields to bits in a bit field flags field, following the other codec APIs.
* Split the sequence, picture and slice headers to separate controls.
This is build tested only, I haven't yet modified the existing Ffmpeg-based implementation, as I'd like to have some consensus first.
Reviews and feedback are appreciated!
v2:
* Fixed bad use of boolean negation in a flag, which was fortunately reported by 0day bot.
Thanks,
Ezequiel
Ezequiel Garcia (3):
media: uapi: mpeg2: Cleanup flags
media: uapi: mpeg2: Remove unused slice size and offset
media: uapi: mpeg2: Split sequence and picture parameters
.../media/v4l/ext-ctrls-codec.rst | 159 +++++++++++------- .../media/v4l/pixfmt-compressed.rst | 5 +- drivers/media/v4l2-core/v4l2-ctrls.c | 59 ++++--- drivers/staging/media/hantro/hantro_drv.c | 10 ++ .../media/hantro/hantro_g1_mpeg2_dec.c | 82 +++++---- .../media/hantro/rk3399_vpu_hw_mpeg2_dec.c | 82 +++++---- drivers/staging/media/sunxi/cedrus/cedrus.c | 14 ++ drivers/staging/media/sunxi/cedrus/cedrus.h | 2 + .../staging/media/sunxi/cedrus/cedrus_mpeg2.c | 49 +++--- include/media/mpeg2-ctrls.h | 153 +++++++++++++---- include/media/v4l2-ctrls.h | 4 + 11 files changed, 395 insertions(+), 224 deletions(-)
Signature · 1 line
2.27.0
PATCH v2 1/3 media: uapi: mpeg2: Cleanup flags
Our current MPEG-2 uAPI uses 1-byte fields for MPEG-2 boolean syntax elements. Clean these by adding a 'flags' field and flag macro for each boolean syntax element.
Move quantization "load" flags to struct v4l2_mpeg2_picture, so the applications can skip passing the quantization matrices (by not setting the MPEG2_QUANTIZATION control in decode request).
A follow-up change will refactor this uAPI so we don't need to add padding fields just yet.
--- .../media/v4l/ext-ctrls-codec.rst | 108 +++++++++++------- drivers/media/v4l2-core/v4l2-ctrls.c | 14 +-- .../media/hantro/hantro_g1_mpeg2_dec.c | 76 ++++++------ .../media/hantro/rk3399_vpu_hw_mpeg2_dec.c | 76 ++++++------ .../staging/media/sunxi/cedrus/cedrus_mpeg2.c | 42 +++---- include/media/mpeg2-ctrls.h | 47 +++++--- 6 files changed, 196 insertions(+), 167 deletions(-)
Documentation/userspace-api/media/v4l/ext-ctrls-codec.rst +68 -40
@@ -2275,13 +2275,28 @@ enum v4l2_mpeg_video_h264_hierarchical_coding_type - - ``profile_and_level_indication`` - The current profile and level indication as extracted from the bitstream. - * - __u8 - - ``progressive_sequence`` - - Indication that all the frames for the sequence are progressive instead - of interlaced. * - __u8 - ``chroma_format`` - The chrominance sub-sampling format (1: 4:2:0, 2: 4:2:2, 3: 4:4:4). + * - __u32 + - ``flags`` + - See :ref:`MPEG-2 Sequence Flags <mpeg2_sequence_flags>`. + +.. _mpeg2_sequence_flags: + +``MPEG-2 Sequence Flags`` + +.. cssclass:: longtable + +.. flat-table:: + :header-rows: 0 + :stub-columns: 0 + :widths: 1 1 2 + + * - ``V4L2_MPEG2_SEQ_FLAG_PROGRESSIVE`` + - 0x00000001 + - Indication that all the frames for the sequence are progressive instead + of interlaced. .. c:type:: v4l2_mpeg2_picture
@@ -2310,30 +2325,60 @@ enum v4l2_mpeg_video_h264_hierarchical_coding_type - - ``picture_structure`` - Picture structure (1: interlaced top field, 2: interlaced bottom field, 3: progressive frame). - * - __u8 - - ``top_field_first`` - - If set to 1 and interlaced stream, top field is output first. - * - __u8 - - ``frame_pred_frame_dct`` - - If set to 1, only frame-DCT and frame prediction are used. - * - __u8 - - ``concealment_motion_vectors`` - - If set to 1, motion vectors are coded for intra macroblocks. - * - __u8 - - ``q_scale_type`` + * - __u32 + - ``flags`` + - See :ref:`MPEG-2 Picture Flags <mpeg2_picture_flags>`. + + +.. _mpeg2_picture_flags: + +``MPEG-2 Picture Flags`` + +.. cssclass:: longtable + +.. flat-table:: + :header-rows: 0 + :stub-columns: 0 + :widths: 1 1 2 + + * - ``V4L2_MPEG2_PIC_FLAG_TOP_FIELD_FIRST`` + - 0x00000001 + - If set and it's an interlaced stream, top field is output first. + * - ``V4L2_MPEG2_PIC_FLAG_FRAME_PRED_DCT`` + - 0x00000002 + - If set only frame-DCT and frame prediction are used. + * - ``V4L2_MPEG2_PIC_FLAG_CONCEALMENT_MV`` + - 0x00000004 + - If set motion vectors are coded for intra macroblocks. + * - ``V4L2_MPEG2_PIC_FLAG_Q_SCALE_TYPE`` + - 0x00000008 - This flag affects the inverse quantization process. - * - __u8 - - ``intra_vlc_format`` + * - ``V4L2_MPEG2_PIC_FLAG_INTRA_VLC`` + - 0x00000010 - This flag affects the decoding of transform coefficient data. - * - __u8 - - ``alternate_scan`` + * - ``V4L2_MPEG2_PIC_FLAG_ALT_SCAN`` + - 0x00000020 - This flag affects the decoding of transform coefficient data. - * - __u8 - - ``repeat_first_field`` + * - ``V4L2_MPEG2_PIC_FLAG_REPEAT_FIRST`` + - 0x00000040 - This flag affects the decoding process of progressive frames. - * - __u16 - - ``progressive_frame`` + * - ``V4L2_MPEG2_PIC_FLAG_PROGRESSIVE`` + - 0x00000080 - Indicates whether the current frame is progressive. + * - ``V4L2_MPEG2_PIC_FLAG_LOAD_INTRA`` + * - 0x00000100 + - Indicate whether to load the user-specified intra quantiser matrix. + * - ``V4L2_MPEG2_PIC_FLAG_LOAD_NON_INTRA`` + * - 0x00000200 + - Indicate whether to load the user-specified non-intra quantiser matrix. + * - ``V4L2_MPEG2_PIC_FLAG_LOAD_CHROMA_INTRA`` + * - 0x00000400 + - Indicate whether to load the user-specified chroma intra quantiser + matrix, only relevant for 4:2:2 and 4:4:4 YUV formats. + * - ``V4L2_MPEG2_PIC_FLAG_LOAD_CHROMA_NON_INTRA`` + * - 0x0000800 + - Indicate whether to load the user-specified chroma non-intra quantiser + matrix, only relevant for 4:2:2 and 4:4:4 YUV formats. ``V4L2_CID_MPEG_VIDEO_MPEG2_QUANTIZATION (struct)`` Specifies quantization matrices (as extracted from the bitstream) for the
@@ -2359,23 +2404,6 @@ enum v4l2_mpeg_video_h264_hierarchical_coding_type - :stub-columns: 0 :widths: 1 1 2 - * - __u8 - - ``load_intra_quantiser_matrix`` - - One bit to indicate whether to load the ``intra_quantiser_matrix`` data. - * - __u8 - - ``load_non_intra_quantiser_matrix`` - - One bit to indicate whether to load the ``non_intra_quantiser_matrix`` - data. - * - __u8 - - ``load_chroma_intra_quantiser_matrix`` - - One bit to indicate whether to load the - ``chroma_intra_quantiser_matrix`` data, only relevant for non-4:2:0 YUV - formats. - * - __u8 - - ``load_chroma_non_intra_quantiser_matrix`` - - One bit to indicate whether to load the - ``chroma_non_intra_quantiser_matrix`` data, only relevant for non-4:2:0 - YUV formats. * - __u8 - ``intra_quantiser_matrix[64]`` - The quantization matrix coefficients for intra-coded frames, in zigzag
drivers/media/v4l2-core/v4l2-ctrls.c +7 -7
@@ -1641,7 +1641,7 @@ static void std_init_compound(const struct v4l2_ctrl *ctrl, u32 idx,/* interlaced top field */ p_mpeg2_slice_params->picture.picture_structure =1 ; p_mpeg2_slice_params->picture.picture_coding_type = -V4L2_MPEG2_PICTURE_CODING_TYPE_I ; +V4L2_MPEG2_PIC_CODING_TYPE_I ;break ; } }
@@ -1803,18 +1803,18 @@ static int std_validate_compound(const struct v4l2_ctrl *ctrl, u32 idx, }switch (p_mpeg2_slice_params->picture.picture_structure) { -case 1 :/* interlaced top field */ -case 2 :/* interlaced bottom field */ -case 3 :/* progressive */ +case V4L2_MPEG2_PIC_TOP_FIELD : +case V4L2_MPEG2_PIC_BOTTOM_FIELD : +case V4L2_MPEG2_PIC_FRAME :break ;default :return -EINVAL ; }switch (p_mpeg2_slice_params->picture.picture_coding_type) { -case V4L2_MPEG2_PICTURE_CODING_TYPE_I : -case V4L2_MPEG2_PICTURE_CODING_TYPE_P : -case V4L2_MPEG2_PICTURE_CODING_TYPE_B : +case V4L2_MPEG2_PIC_CODING_TYPE_I : +case V4L2_MPEG2_PIC_CODING_TYPE_P : +case V4L2_MPEG2_PIC_CODING_TYPE_B :break ;default :return -EINVAL ;
drivers/staging/media/hantro/hantro_g1_mpeg2_dec.c +36 -40
151 lines not on this page · raw message
drivers/staging/media/hantro/rk3399_vpu_hw_mpeg2_dec.c +36 -40
147 lines not on this page · raw message
drivers/staging/media/sunxi/cedrus/cedrus_mpeg2.c +21 -21
78 lines not on this page · raw message
include/media/mpeg2-ctrls.h +28 -19
75 lines not on this page · raw message
Signature · 1 line
2.27.0
PATCH v2 2/3 media: uapi: mpeg2: Remove unused slice size and offset
In reply to Ezequiel GarciaThe MPEG2_SLICE_PARAMS control is designed to refer to a single slice. Conversely, in each request the OUTPUT buffer is expected to hold a single slice, so the offset and size fields are not needed.
The start of the slice is aligned to the start of the buffer, and the buffer's plane payload size is the slice size.
To reduce the API surface and avoid confusion drop these fields from control.
--- Documentation/userspace-api/media/v4l/ext-ctrls-codec.rst | 6 ------ drivers/staging/media/hantro/hantro_g1_mpeg2_dec.c | 4 ++-- drivers/staging/media/hantro/rk3399_vpu_hw_mpeg2_dec.c | 4 ++-- drivers/staging/media/sunxi/cedrus/cedrus_mpeg2.c | 7 +++---- include/media/mpeg2-ctrls.h | 2 -- 5 files changed, 7 insertions(+), 16 deletions(-)
Documentation/userspace-api/media/v4l/ext-ctrls-codec.rst +0 -6
@@ -2218,12 +2218,6 @@ enum v4l2_mpeg_video_h264_hierarchical_coding_type - :stub-columns: 0 :widths: 1 1 2 - * - __u32 - - ``bit_size`` - - Size (in bits) of the current slice data. - * - __u32 - - ``data_bit_offset`` - - Offset (in bits) to the video data in the current slice data. * - struct :c:type:`v4l2_mpeg2_sequence` - ``sequence`` - Structure with MPEG-2 sequence metadata, merging relevant fields from
drivers/staging/media/hantro/hantro_g1_mpeg2_dec.c +2 -2
@@ -206,7 +206,7 @@ void hantro_g1_mpeg2_dec_run(struct hantro_ctx *ctx)G1_REG_TOPFIELDFIRST_E (pic->flags &V4L2_MPEG2_PIC_FLAG_TOP_FIELD_FIRST );vdpu_write_relaxed (vpu, reg,G1_SWREG (4 )); - reg =G1_REG_STRM_START_BIT (slice_params->data_bit_offset) | + reg =G1_REG_STRM_START_BIT (0 ) |G1_REG_QSCALE_TYPE (pic->flags &V4L2_MPEG2_PIC_FLAG_Q_SCALE_TYPE ) |G1_REG_CON_MV_E (pic->flags &V4L2_MPEG2_PIC_FLAG_CONCEALMENT_MV ) | G1_REG_INTRA_DC_PREC(pic->intra_dc_precision) |
@@ -215,7 +215,7 @@ void hantro_g1_mpeg2_dec_run(struct hantro_ctx *ctx)vdpu_write_relaxed (vpu, reg,G1_SWREG (5 )); reg =G1_REG_INIT_QP (1 ) | -G1_REG_STREAM_LEN (slice_params->bit_size >>3 ); +G1_REG_STREAM_LEN (vb2_get_plane_payload (&src_buf->vb2_buf,0 ));vdpu_write_relaxed (vpu, reg,G1_SWREG (6 )); reg = G1_REG_ALT_SCAN_FLAG_E(pic->flags & V4L2_MPEG2_PIC_FLAG_ALT_SCAN) |
drivers/staging/media/hantro/rk3399_vpu_hw_mpeg2_dec.c +2 -2
@@ -179,7 +179,7 @@ void rk3399_vpu_mpeg2_dec_run(struct hantro_ctx *ctx)vdpu_write_relaxed (vpu, reg,VDPU_SWREG (50 )); reg =VDPU_REG_INIT_QP (1 ) | -VDPU_REG_STREAM_LEN (slice_params->bit_size >>3 ); +VDPU_REG_STREAM_LEN (vb2_get_plane_payload (&src_buf->vb2_buf,0 ));vdpu_write_relaxed (vpu, reg,VDPU_SWREG (51 )); reg = VDPU_REG_APF_THRESHOLD(8) |
@@ -222,7 +222,7 @@ void rk3399_vpu_mpeg2_dec_run(struct hantro_ctx *ctx)VDPU_REG_TOPFIELDFIRST_E (pic->flags &V4L2_MPEG2_PIC_FLAG_TOP_FIELD_FIRST );vdpu_write_relaxed (vpu, reg,VDPU_SWREG (120 )); - reg =VDPU_REG_STRM_START_BIT (slice_params->data_bit_offset) | + reg =VDPU_REG_STRM_START_BIT (0 ) |VDPU_REG_QSCALE_TYPE (pic->flags &V4L2_MPEG2_PIC_FLAG_Q_SCALE_TYPE ) |VDPU_REG_CON_MV_E (pic->flags &V4L2_MPEG2_PIC_FLAG_CONCEALMENT_MV ) | VDPU_REG_INTRA_DC_PREC(pic->intra_dc_precision) |
drivers/staging/media/sunxi/cedrus/cedrus_mpeg2.c +3 -4
@@ -186,10 +186,9 @@ static void cedrus_mpeg2_setup(struct cedrus_ctx *ctx, struct cedrus_run *run)/* Source offset and length in bits. */ -cedrus_write (dev,VE_DEC_MPEG_VLD_OFFSET , - slice_params->data_bit_offset); +cedrus_write (dev,VE_DEC_MPEG_VLD_OFFSET ,0 ); - reg = slice_params->bit_size - slice_params->data_bit_offset; + reg =vb2_get_plane_payload (&run->src->vb2_buf,0 ) *8 ;cedrus_write (dev,VE_DEC_MPEG_VLD_LEN , reg);/* Source beginning and end addresses. */
@@ -203,7 +202,7 @@ static void cedrus_mpeg2_setup(struct cedrus_ctx *ctx, struct cedrus_run *run)cedrus_write (dev,VE_DEC_MPEG_VLD_ADDR , reg); - reg = src_buf_addr +DIV_ROUND_UP (slice_params->bit_size,8 ); + reg = src_buf_addr +vb2_get_plane_payload (&run->src->vb2_buf,0 );cedrus_write (dev,VE_DEC_MPEG_VLD_END_ADDR , reg);/* Macroblock address: start at the beginning. */
include/media/mpeg2-ctrls.h +0 -2
@@ -68,8 +68,6 @@ struct v4l2_mpeg2_picture { };struct v4l2_ctrl_mpeg2_slice_params { -__u32 bit_size; -__u32 data_bit_offset;__u64 backward_ref_ts;__u64 forward_ref_ts;
Signature · 1 line
2.27.0
PATCH v2 3/3 media: uapi: mpeg2: Split sequence and picture parameters
In reply to Ezequiel GarciaTypically, bitstreams are composed of one sequence header NAL unit, followed by a number of picture header and picture coding extension NAL units. Each picture can be composed by a number of slices.
Let's split the MPEG-2 uAPI to follow these semantics more closely, allowing more usage flexibility. Having these controls splitted allows applications to set a sequence control at the beginning of a sequence, and then set a picture control for each frame.
While here add padding fields where needed, and document the uAPI header thoroughly.
--- .../media/v4l/ext-ctrls-codec.rst | 47 ++++++-- .../media/v4l/pixfmt-compressed.rst | 5 +- drivers/media/v4l2-core/v4l2-ctrls.c | 45 +++++-- drivers/staging/media/hantro/hantro_drv.c | 10 ++ .../media/hantro/hantro_g1_mpeg2_dec.c | 14 ++- .../media/hantro/rk3399_vpu_hw_mpeg2_dec.c | 14 ++- drivers/staging/media/sunxi/cedrus/cedrus.c | 14 +++ drivers/staging/media/sunxi/cedrus/cedrus.h | 2 + .../staging/media/sunxi/cedrus/cedrus_mpeg2.c | 8 +- include/media/mpeg2-ctrls.h | 110 +++++++++++++++--- include/media/v4l2-ctrls.h | 4 + 11 files changed, 212 insertions(+), 61 deletions(-)
Documentation/userspace-api/media/v4l/ext-ctrls-codec.rst +35 -12
@@ -2218,14 +2218,6 @@ enum v4l2_mpeg_video_h264_hierarchical_coding_type - :stub-columns: 0 :widths: 1 1 2 - * - struct :c:type:`v4l2_mpeg2_sequence` - - ``sequence`` - - Structure with MPEG-2 sequence metadata, merging relevant fields from - the sequence header and sequence extension parts of the bitstream. - * - struct :c:type:`v4l2_mpeg2_picture` - - ``picture`` - - Structure with MPEG-2 picture metadata, merging relevant fields from - the picture header and picture coding extension parts of the bitstream. * - __u64 - ``backward_ref_ts`` - Timestamp of the V4L2 capture buffer to use as backward reference, used
@@ -2243,14 +2235,28 @@ enum v4l2_mpeg_video_h264_hierarchical_coding_type - * - __u32 - ``quantiser_scale_code`` - Code used to determine the quantization scale to use for the IDCT. + * - __u8 + - ``reserved`` + - Applications and drivers must set this to zero. -.. c:type:: v4l2_mpeg2_sequence +``V4L2_CID_MPEG_VIDEO_MPEG2_SEQUENCE (struct)`` + Specifies the sequence parameters (as extracted from the bitstream) for the + associated MPEG-2 slice data. This includes fields matching the syntax + elements from the sequence header and sequence extension parts of the + bitstream as specified by :ref:`mpeg2part2`. + + .. note:: + + This compound control is not yet part of the public kernel API and + it is expected to change. + +.. c:type:: v4l2_ctrl_mpeg2_sequence .. cssclass:: longtable .. tabularcolumns:: |p{1.5cm}|p{6.3cm}|p{9.4cm}| -.. flat-table:: struct v4l2_mpeg2_sequence +.. flat-table:: struct v4l2_ctrl_mpeg2_sequence :header-rows: 0 :stub-columns: 0 :widths: 1 1 2
@@ -2272,6 +2278,9 @@ enum v4l2_mpeg_video_h264_hierarchical_coding_type - * - __u8 - ``chroma_format`` - The chrominance sub-sampling format (1: 4:2:0, 2: 4:2:2, 3: 4:4:4). + * - __u8 + - ``reserved`` + - Applications and drivers must set this to zero. * - __u32 - ``flags`` - See :ref:`MPEG-2 Sequence Flags <mpeg2_sequence_flags>`.
@@ -2292,13 +2301,24 @@ enum v4l2_mpeg_video_h264_hierarchical_coding_type - - Indication that all the frames for the sequence are progressive instead of interlaced. -.. c:type:: v4l2_mpeg2_picture +``V4L2_CID_MPEG_VIDEO_MPEG2_PICTURE (struct)`` + Specifies the picture parameters (as extracted from the bitstream) for the + associated MPEG-2 slice data. This includes fields matching the syntax + elements from the picture header and picture coding extension parts of the + bitstream as specified by :ref:`mpeg2part2`. + + .. note:: + + This compound control is not yet part of the public kernel API and + it is expected to change. + +.. c:type:: v4l2_ctrl_mpeg2_picture .. cssclass:: longtable .. tabularcolumns:: |p{1.5cm}|p{6.3cm}|p{9.4cm}| -.. flat-table:: struct v4l2_mpeg2_picture +.. flat-table:: struct v4l2_ctrl_mpeg2_picture :header-rows: 0 :stub-columns: 0 :widths: 1 1 2
@@ -2319,6 +2339,9 @@ enum v4l2_mpeg_video_h264_hierarchical_coding_type - - ``picture_structure`` - Picture structure (1: interlaced top field, 2: interlaced bottom field, 3: progressive frame). + * - __u8 + - ``reserved`` + - Applications and drivers must set this to zero. * - __u32 - ``flags`` - See :ref:`MPEG-2 Picture Flags <mpeg2_picture_flags>`.
Documentation/userspace-api/media/v4l/pixfmt-compressed.rst +3 -2
@@ -113,8 +113,9 @@ Compressed Formats This format is adapted for stateless video decoders that implement a MPEG-2 pipeline (using the :ref:`mem2mem` and :ref:`media-request-api`). Metadata associated with the frame to decode is required to be passed - through the ``V4L2_CID_MPEG_VIDEO_MPEG2_SLICE_PARAMS`` control and - quantization matrices can optionally be specified through the + through the ``V4L2_CID_MPEG_VIDEO_MPEG2_SEQUENCE``, + ``V4L2_CID_MPEG_VIDEO_MPEG2_PICTURE``, and ``V4L2_CID_MPEG_VIDEO_MPEG2_SLICE_PARAMS`` + controls. Quantization matrices can optionally be specified through the ``V4L2_CID_MPEG_VIDEO_MPEG2_QUANTIZATION`` control. See the :ref:`associated Codec Control IDs <v4l2-mpeg-mpeg2>`. Exactly one output and one capture buffer must be provided for use with
drivers/media/v4l2-core/v4l2-ctrls.c +33 -12
99 lines not on this page · raw message
drivers/staging/media/hantro/hantro_drv.c +10 -0
@@ -286,6 +286,16 @@ static const struct hantro_ctrl controls[] = { .def = 50, .ops = &hantro_jpeg_ctrl_ops, }, + }, { + .codec = HANTRO_MPEG2_DECODER, + .cfg = { + .id = V4L2_CID_MPEG_VIDEO_MPEG2_SEQUENCE, + }, + }, { + .codec = HANTRO_MPEG2_DECODER, + .cfg = { + .id = V4L2_CID_MPEG_VIDEO_MPEG2_PICTURE, + }, }, { .codec = HANTRO_MPEG2_DECODER, .cfg = {
drivers/staging/media/hantro/hantro_g1_mpeg2_dec.c +8 -6
@@ -95,8 +95,8 @@ static void hantro_g1_mpeg2_dec_set_buffers(struct hantro_dev *vpu, struct hantro_ctx *ctx, struct vb2_buffer *src_buf, struct vb2_buffer *dst_buf, - const struct v4l2_mpeg2_sequence *seq, - const struct v4l2_mpeg2_picture *pic, + const struct v4l2_ctrl_mpeg2_sequence *seq, + const struct v4l2_ctrl_mpeg2_picture *pic, const struct v4l2_ctrl_mpeg2_slice_params *slice_params) { dma_addr_t forward_addr = 0, backward_addr = 0;
@@ -156,8 +156,8 @@ void hantro_g1_mpeg2_dec_run(struct hantro_ctx *ctx)struct hantro_dev *vpu = ctx->dev;struct vb2_v4l2_buffer *src_buf, *dst_buf;const struct v4l2_ctrl_mpeg2_slice_params *slice_params; -const struct v4l2_mpeg2_sequence *seq; -const struct v4l2_mpeg2_picture *pic; +const struct v4l2_ctrl_mpeg2_sequence *seq; +const struct v4l2_ctrl_mpeg2_picture *pic;u32 reg; src_buf =hantro_get_src_buf (ctx);
@@ -168,8 +168,10 @@ void hantro_g1_mpeg2_dec_run(struct hantro_ctx *ctx) slice_params =hantro_get_ctrl (ctx,V4L2_CID_MPEG_VIDEO_MPEG2_SLICE_PARAMS ); - seq = &slice_params->sequence; - pic = &slice_params->picture; + seq =hantro_get_ctrl (ctx, +V4L2_CID_MPEG_VIDEO_MPEG2_SEQUENCE ); + pic =hantro_get_ctrl (ctx, +V4L2_CID_MPEG_VIDEO_MPEG2_PICTURE ); reg =G1_REG_DEC_AXI_RD_ID (0 ) | G1_REG_DEC_TIMEOUT_E(1) |
drivers/staging/media/hantro/rk3399_vpu_hw_mpeg2_dec.c +8 -6
@@ -97,8 +97,8 @@ rk3399_vpu_mpeg2_dec_set_buffers(struct hantro_dev *vpu,struct hantro_ctx *ctx, struct vb2_buffer *src_buf, struct vb2_buffer *dst_buf, - const struct v4l2_mpeg2_sequence *seq, - const struct v4l2_mpeg2_picture *pic, + const struct v4l2_ctrl_mpeg2_sequence *seq, + const struct v4l2_ctrl_mpeg2_picture *pic, const struct v4l2_ctrl_mpeg2_slice_params *slice_params) { dma_addr_t forward_addr = 0, backward_addr = 0;
@@ -158,8 +158,8 @@ void rk3399_vpu_mpeg2_dec_run(struct hantro_ctx *ctx)struct hantro_dev *vpu = ctx->dev;struct vb2_v4l2_buffer *src_buf, *dst_buf;const struct v4l2_ctrl_mpeg2_slice_params *slice_params; -const struct v4l2_mpeg2_sequence *seq; -const struct v4l2_mpeg2_picture *pic; +const struct v4l2_ctrl_mpeg2_sequence *seq; +const struct v4l2_ctrl_mpeg2_picture *pic;u32 reg; src_buf =hantro_get_src_buf (ctx);
@@ -169,8 +169,10 @@ void rk3399_vpu_mpeg2_dec_run(struct hantro_ctx *ctx) slice_params =hantro_get_ctrl (ctx,V4L2_CID_MPEG_VIDEO_MPEG2_SLICE_PARAMS ); - seq = &slice_params->sequence; - pic = &slice_params->picture; + seq =hantro_get_ctrl (ctx, +V4L2_CID_MPEG_VIDEO_MPEG2_SEQUENCE ); + pic =hantro_get_ctrl (ctx, +V4L2_CID_MPEG_VIDEO_MPEG2_PICTURE ); reg =VDPU_REG_DEC_ADV_PRE_DIS (0 ) | VDPU_REG_DEC_SCMD_DIS(0) |
drivers/staging/media/sunxi/cedrus/cedrus.c +14 -0
@@ -29,6 +29,20 @@#include "cedrus_hw.h" static const struct cedrus_control cedrus_controls[] = { + { + .cfg = { + .id =V4L2_CID_MPEG_VIDEO_MPEG2_SEQUENCE , + }, + .codec =CEDRUS_CODEC_MPEG2 , + .required = true, + }, + { + .cfg = { + .id =V4L2_CID_MPEG_VIDEO_MPEG2_PICTURE , + }, + .codec =CEDRUS_CODEC_MPEG2 , + .required = true, + }, { .cfg = { .id =V4L2_CID_MPEG_VIDEO_MPEG2_SLICE_PARAMS ,
drivers/staging/media/sunxi/cedrus/cedrus.h +2 -0
@@ -66,6 +66,8 @@ struct cedrus_h264_run { };struct cedrus_mpeg2_run { +const struct v4l2_ctrl_mpeg2_sequence *sequence; +const struct v4l2_ctrl_mpeg2_picture *picture;const struct v4l2_ctrl_mpeg2_slice_params *slice_params;const struct v4l2_ctrl_mpeg2_quantization *quantization; };
drivers/staging/media/sunxi/cedrus/cedrus_mpeg2.c +4 -4
@@ -75,8 +75,8 @@ static void cedrus_mpeg2_irq_disable(struct cedrus_ctx *ctx)static void cedrus_mpeg2_setup (struct cedrus_ctx *ctx,struct cedrus_run *run) {const struct v4l2_ctrl_mpeg2_slice_params *slice_params; -const struct v4l2_mpeg2_sequence *seq; -const struct v4l2_mpeg2_picture *pic; +const struct v4l2_ctrl_mpeg2_sequence *seq; +const struct v4l2_ctrl_mpeg2_picture *pic;const struct v4l2_ctrl_mpeg2_quantization *quantization;dma_addr_t src_buf_addr, dst_luma_addr, dst_chroma_addr;dma_addr_t fwd_luma_addr, fwd_chroma_addr;
@@ -90,8 +90,8 @@ static void cedrus_mpeg2_setup(struct cedrus_ctx *ctx, struct cedrus_run *run)u32 reg; slice_params = run->mpeg2.slice_params; - seq = &slice_params->sequence; - pic = &slice_params->picture; + seq = run->mpeg2.sequence; + pic = run->mpeg2.picture; quantization = run->mpeg2.quantization;
include/media/mpeg2-ctrls.h +91 -19
145 lines not on this page · raw message
include/media/v4l2-ctrls.h +4 -0
@@ -43,6 +43,8 @@ struct video_device;* @p_u16: Pointer to a 16-bit unsigned value. * @p_u32: Pointer to a 32-bit unsigned value. * @p_char: Pointer to a string. +* @p_mpeg2_sequence: Pointer to a MPEG2 sequence structure. +* @p_mpeg2_picture: Pointer to a MPEG2 picture structure. * @p_mpeg2_slice_params: Pointer to a MPEG2 slice parameters structure. * @p_mpeg2_quantization: Pointer to a MPEG2 quantization data structure. * @p_fwht_params: Pointer to a FWHT stateless parameters structure.
@@ -67,6 +69,8 @@ union v4l2_ctrl_ptr {u16 *p_u16;u32 *p_u32;char *p_char; +struct v4l2_ctrl_mpeg2_sequence *p_sequence; +struct v4l2_ctrl_mpeg2_picture *p_picture;struct v4l2_ctrl_mpeg2_slice_params *p_mpeg2_slice_params;struct v4l2_ctrl_mpeg2_quantization *p_mpeg2_quantization;struct v4l2_ctrl_fwht_params *p_fwht_params;
Signature · 1 line
2.27.0
Re: [PATCH v2 3/3] media: uapi: mpeg2: Split sequence and picture parameters
Hi Ezequiel,
url: https://github.com/0day-ci/linux/commits/Ezequiel-Garcia/MPEG-2-stateless-API-cleanup/20201106-045304 base: git://linuxtv.org/media_tree.git master config: i386-randconfig-m021-20201110 (attached as .config) compiler: gcc-9 (Debian 9.3.0-15) 9.3.0
If you fix the issue, kindly add following tag as appropriate
smatch warnings:drivers/media/v4l2-core/v4l2-ctrls.c:1809 std_validate_compound() warn: ignoring unreachable code.
vim +1809 drivers/media/v4l2-core/v4l2-ctrls.c
de8145452eebe55 Ezequiel Garcia 2019-07-11 1774 static int std_validate_compound(const struct v4l2_ctrl *ctrl, u32 idx,
0176077a813933a Hans Verkuil 2014-04-27 1775 union v4l2_ctrl_ptr ptr)
0176077a813933a Hans Verkuil 2014-04-27 1776 {
0e380411d9f043f Ezequiel Garcia 2020-11-05 1777 struct v4l2_ctrl_mpeg2_sequence *p_mpeg2_sequence;
0e380411d9f043f Ezequiel Garcia 2020-11-05 1778 struct v4l2_ctrl_mpeg2_picture *p_mpeg2_picture;
c27bb30e7b6d385 Paul Kocialkowski 2018-09-13 1779 struct v4l2_ctrl_mpeg2_slice_params *p_mpeg2_slice_params;
298c62d3856111e Ezequiel Garcia 2019-07-11 1780 struct v4l2_ctrl_vp8_frame_header *p_vp8_frame_header;
d9358563179a7f0 Ezequiel Garcia 2020-08-25 1781 struct v4l2_ctrl_h264_slice_params *p_h264_slice_params;
f9879eb378295e8 Ezequiel Garcia 2020-08-25 1782 struct v4l2_ctrl_h264_decode_params *p_h264_dec_params;
256fa3920874b0f Paul Kocialkowski 2019-10-22 1783 struct v4l2_ctrl_hevc_sps *p_hevc_sps;
256fa3920874b0f Paul Kocialkowski 2019-10-22 1784 struct v4l2_ctrl_hevc_pps *p_hevc_pps;
256fa3920874b0f Paul Kocialkowski 2019-10-22 1785 struct v4l2_ctrl_hevc_slice_params *p_hevc_slice_params;
d1dc49370f8371b Ricardo Ribalda 2019-10-07 1786 struct v4l2_area *area;
de8145452eebe55 Ezequiel Garcia 2019-07-11 1787 void *p = ptr.p + idx * ctrl->elem_size;
256fa3920874b0f Paul Kocialkowski 2019-10-22 1788 unsigned int i;
de8145452eebe55 Ezequiel Garcia 2019-07-11 1789
de8145452eebe55 Ezequiel Garcia 2019-07-11 1790 switch ((u32)ctrl->type) {
0e380411d9f043f Ezequiel Garcia 2020-11-05 1791 case V4L2_CTRL_TYPE_MPEG2_SEQUENCE:
0e380411d9f043f Ezequiel Garcia 2020-11-05 1792 p_mpeg2_sequence = p;
de8145452eebe55 Ezequiel Garcia 2019-07-11 1793
0e380411d9f043f Ezequiel Garcia 2020-11-05 1794 switch (p_mpeg2_sequence->chroma_format) {
de8145452eebe55 Ezequiel Garcia 2019-07-11 1795 case 1: /* 4:2:0 */
de8145452eebe55 Ezequiel Garcia 2019-07-11 1796 case 2: /* 4:2:2 */
de8145452eebe55 Ezequiel Garcia 2019-07-11 1797 case 3: /* 4:4:4 */
de8145452eebe55 Ezequiel Garcia 2019-07-11 1798 break;
de8145452eebe55 Ezequiel Garcia 2019-07-11 1799 default:
de8145452eebe55 Ezequiel Garcia 2019-07-11 1800 return -EINVAL;
de8145452eebe55 Ezequiel Garcia 2019-07-11 1801 }
0e380411d9f043f Ezequiel Garcia 2020-11-05 1802 zero_reserved(*p_mpeg2_sequence);
0e380411d9f043f Ezequiel Garcia 2020-11-05 1803 break;
0e380411d9f043f Ezequiel Garcia 2020-11-05 1804
0e380411d9f043f Ezequiel Garcia 2020-11-05 1805 case V4L2_CTRL_TYPE_MPEG2_PICTURE:
0e380411d9f043f Ezequiel Garcia 2020-11-05 1806 p_mpeg2_picture = p;
0e380411d9f043f Ezequiel Garcia 2020-11-05 1807 break;
^^^^^^de8145452eebe55 Ezequiel Garcia 2019-07-11 1808
0e380411d9f043f Ezequiel Garcia 2020-11-05 @1809 switch (p_mpeg2_picture->intra_dc_precision) {
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^Unreachable.
de8145452eebe55 Ezequiel Garcia 2019-07-11 1810 case 0: /* 8 bits */ de8145452eebe55 Ezequiel Garcia 2019-07-11 1811 case 1: /* 9 bits */ de8145452eebe55 Ezequiel Garcia 2019-07-11 1812 case 2: /* 10 bits */ de8145452eebe55 Ezequiel Garcia 2019-07-11 1813 case 3: /* 11 bits */ de8145452eebe55 Ezequiel Garcia 2019-07-11 1814 break; de8145452eebe55 Ezequiel Garcia 2019-07-11 1815 default: de8145452eebe55 Ezequiel Garcia 2019-07-11 1816 return -EINVAL; de8145452eebe55 Ezequiel Garcia 2019-07-11 1817 } 0e380411d9f043f Ezequiel Garcia 2020-11-05 1818 break; de8145452eebe55 Ezequiel Garcia 2019-07-11 1819
Re: [PATCH v2 3/3] media: uapi: mpeg2: Split sequence and picture parameters
In reply to Ezequiel GarciaHi Ezequiel,
Quoted 579 lines · Ezequiel Garcia
Typically, bitstreams are composed of one sequence header NAL unit, followed by a number of picture header and picture coding extension NAL units. Each picture can be composed by a number of slices.
Let's split the MPEG-2 uAPI to follow these semantics more closely, allowing more usage flexibility. Having these controls splitted allows applications to set a sequence control at the beginning of a sequence, and then set a picture control for each frame.
While here add padding fields where needed, and document the uAPI header thoroughly.
Signed-off-by Ezequiel Garcia <[email protected]>--- .../media/v4l/ext-ctrls-codec.rst | 47 ++++++-- .../media/v4l/pixfmt-compressed.rst | 5 +- drivers/media/v4l2-core/v4l2-ctrls.c | 45 +++++-- drivers/staging/media/hantro/hantro_drv.c | 10 ++ .../media/hantro/hantro_g1_mpeg2_dec.c | 14 ++- .../media/hantro/rk3399_vpu_hw_mpeg2_dec.c | 14 ++- drivers/staging/media/sunxi/cedrus/cedrus.c | 14 +++ drivers/staging/media/sunxi/cedrus/cedrus.h | 2 + .../staging/media/sunxi/cedrus/cedrus_mpeg2.c | 8 +- include/media/mpeg2-ctrls.h | 110 +++++++++++++++--- include/media/v4l2-ctrls.h | 4 + 11 files changed, 212 insertions(+), 61 deletions(-)Documentation/userspace-api/media/v4l/ext-ctrls-codec.rst +35
-12@@ -2218,14 +2218,6 @@ enum v4l2_mpeg_video_h264_hierarchical_coding_type - :stub-columns: 0 :widths: 1 1 2 - * - struct :c:type:`v4l2_mpeg2_sequence` - - ``sequence`` - - Structure with MPEG-2 sequence metadata, merging relevant fields from - the sequence header and sequence extension parts of the bitstream. - * - struct :c:type:`v4l2_mpeg2_picture` - - ``picture`` - - Structure with MPEG-2 picture metadata, merging relevant fields from - the picture header and picture coding extension parts of the bitstream. * - __u64 - ``backward_ref_ts`` - Timestamp of the V4L2 capture buffer to use as backward reference, used@@ -2243,14 +2235,28 @@ enum v4l2_mpeg_video_h264_hierarchical_coding_type - * - __u32 - ``quantiser_scale_code`` - Code used to determine the quantization scale to use for the IDCT. + * - __u8 + - ``reserved`` + - Applications and drivers must set this to zero. -.. c:type:: v4l2_mpeg2_sequence +``V4L2_CID_MPEG_VIDEO_MPEG2_SEQUENCE (struct)`` + Specifies the sequence parameters (as extracted from the bitstream) for the + associated MPEG-2 slice data. This includes fields matching the syntax + elements from the sequence header and sequence extension parts of the + bitstream as specified by :ref:`mpeg2part2`. + + .. note:: + + This compound control is not yet part of the public kernel API and + it is expected to change. + +.. c:type:: v4l2_ctrl_mpeg2_sequence .. cssclass:: longtable .. tabularcolumns:: |p{1.5cm}|p{6.3cm}|p{9.4cm}| -.. flat-table:: struct v4l2_mpeg2_sequence +.. flat-table:: struct v4l2_ctrl_mpeg2_sequence :header-rows: 0 :stub-columns: 0 :widths: 1 1 2@@ -2272,6 +2278,9 @@ enum v4l2_mpeg_video_h264_hierarchical_coding_type - * - __u8 - ``chroma_format`` - The chrominance sub-sampling format (1: 4:2:0, 2: 4:2:2, 3: 4:4:4). + * - __u8 + - ``reserved`` + - Applications and drivers must set this to zero. * - __u32 - ``flags`` - See :ref:`MPEG-2 Sequence Flags <mpeg2_sequence_flags>`.@@ -2292,13 +2301,24 @@ enum v4l2_mpeg_video_h264_hierarchical_coding_type - - Indication that all the frames for the sequence are progressive instead of interlaced. -.. c:type:: v4l2_mpeg2_picture +``V4L2_CID_MPEG_VIDEO_MPEG2_PICTURE (struct)`` + Specifies the picture parameters (as extracted from the bitstream) for the + associated MPEG-2 slice data. This includes fields matching the syntax + elements from the picture header and picture coding extension parts of the + bitstream as specified by :ref:`mpeg2part2`. + + .. note:: + + This compound control is not yet part of the public kernel API and + it is expected to change. + +.. c:type:: v4l2_ctrl_mpeg2_picture .. cssclass:: longtable .. tabularcolumns:: |p{1.5cm}|p{6.3cm}|p{9.4cm}| -.. flat-table:: struct v4l2_mpeg2_picture +.. flat-table:: struct v4l2_ctrl_mpeg2_picture :header-rows: 0 :stub-columns: 0 :widths: 1 1 2@@ -2319,6 +2339,9 @@ enum v4l2_mpeg_video_h264_hierarchical_coding_type - - ``picture_structure`` - Picture structure (1: interlaced top field, 2: interlaced bottom field, 3: progressive frame). + * - __u8 + - ``reserved`` + - Applications and drivers must set this to zero. * - __u32 - ``flags`` - See :ref:`MPEG-2 Picture Flags <mpeg2_picture_flags>`.Documentation/userspace-api/media/v4l/pixfmt-compressed.rst +3
-2@@ -113,8 +113,9 @@ Compressed Formats This format is adapted for stateless video decoders that implement a MPEG-2 pipeline (using the :ref:`mem2mem` and :ref:`media-request-api`). Metadata associated with the frame to decode is required to be passed - through the ``V4L2_CID_MPEG_VIDEO_MPEG2_SLICE_PARAMS`` control and - quantization matrices can optionally be specified through the + through the ``V4L2_CID_MPEG_VIDEO_MPEG2_SEQUENCE``, + ``V4L2_CID_MPEG_VIDEO_MPEG2_PICTURE``, and ``V4L2_CID_MPEG_VIDEO_MPEG2_SLICE_PARAMS`` + controls. Quantization matrices can optionally be specified through the ``V4L2_CID_MPEG_VIDEO_MPEG2_QUANTIZATION`` control. See the :ref:`associated Codec Control IDs <v4l2-mpeg-mpeg2>`. Exactly one output and one capture buffer must be provided for use withdrivers/media/v4l2-core/v4l2-ctrls.c +33
-12@@ -1620,7 +1620,8 @@ static bool std_equal(const struct v4l2_ctrl *ctrl, u32 idx,static void std_init_compound (const struct v4l2_ctrl *ctrl,u32 idx,union v4l2_ctrl_ptr ptr) { -struct v4l2_ctrl_mpeg2_slice_params *p_mpeg2_slice_params; +struct v4l2_ctrl_mpeg2_sequence *p_mpeg2_sequence; +struct v4l2_ctrl_mpeg2_picture *p_mpeg2_picture;void *p = ptr.p + idx * ctrl->elem_size;if (ctrl->p_def.p_const)@@ -1634,13 +1635,18 @@ static void std_init_compound(const struct v4l2_ctrl *ctrl, u32 idx,* v4l2_ctrl_type enum. */ switch ((u32 )ctrl->type) { -case V4L2_CTRL_TYPE_MPEG2_SLICE_PARAMS : - p_mpeg2_slice_params = p; +case V4L2_CTRL_TYPE_MPEG2_SEQUENCE : + p_mpeg2_sequence = p; +/* 4:2:0 */ - p_mpeg2_slice_params->sequence.chroma_format =1 ; + p_mpeg2_sequence->chroma_format =1 ; +break ; +case V4L2_CTRL_TYPE_MPEG2_PICTURE : + p_mpeg2_picture = p; +/* interlaced top field */ - p_mpeg2_slice_params->picture.picture_structure =1 ; - p_mpeg2_slice_params->picture.picture_coding_type = + p_mpeg2_picture->picture_structure =1 ; + p_mpeg2_picture->picture_coding_type =V4L2_MPEG2_PIC_CODING_TYPE_I ;break ; }@@ -1768,6 +1774,8 @@ static void std_log(const struct v4l2_ctrl *ctrl)static int std_validate_compound (const struct v4l2_ctrl *ctrl,u32 idx,union v4l2_ctrl_ptr ptr) { +struct v4l2_ctrl_mpeg2_sequence *p_mpeg2_sequence; +struct v4l2_ctrl_mpeg2_picture *p_mpeg2_picture;struct v4l2_ctrl_mpeg2_slice_params *p_mpeg2_slice_params;struct v4l2_ctrl_vp8_frame_header *p_vp8_frame_header;struct v4l2_ctrl_h264_slice_params *p_h264_slice_params;@@ -1780,10 +1788,10 @@ static int std_validate_compound(const struct v4l2_ctrl *ctrl, u32 idx,unsigned int i;switch ((u32 )ctrl->type) { -case V4L2_CTRL_TYPE_MPEG2_SLICE_PARAMS : - p_mpeg2_slice_params = p; +case V4L2_CTRL_TYPE_MPEG2_SEQUENCE : + p_mpeg2_sequence = p; -switch (p_mpeg2_slice_params->sequence.chroma_format) { +switch (p_mpeg2_sequence->chroma_format) {case 1 :/* 4:2:0 */ case 2 :/* 4:2:2 */ case 3 :/* 4:4:4 */ @@ -1791,8 +1799,14 @@ static int std_validate_compound(const struct v4l2_ctrl *ctrl, u32 idx,default :return -EINVAL ; } +zero_reserved (*p_mpeg2_sequence); +break ; + +case V4L2_CTRL_TYPE_MPEG2_PICTURE : + p_mpeg2_picture = p; +break ; -switch (p_mpeg2_slice_params->picture.intra_dc_precision) { +switch (p_mpeg2_picture->intra_dc_precision) {case 0 :/* 8 bits */ case 1 :/* 9 bits */ case 2 :/* 10 bits */ @@ -1801,8 +1815,9 @@ static int std_validate_compound(const struct v4l2_ctrl *ctrl, u32 idx,default :return -EINVAL ; } +break ; -switch (p_mpeg2_slice_params->picture.picture_structure) { +switch (p_mpeg2_picture->picture_structure) {case V4L2_MPEG2_PIC_TOP_FIELD :case V4L2_MPEG2_PIC_BOTTOM_FIELD :case V4L2_MPEG2_PIC_FRAME :@@ -1811,7 +1826,7 @@ static int std_validate_compound(const struct v4l2_ctrl *ctrl, u32 idx,return -EINVAL ; } -switch (p_mpeg2_slice_params->picture.picture_coding_type) { +switch (p_mpeg2_picture->picture_coding_type) {case V4L2_MPEG2_PIC_CODING_TYPE_I :case V4L2_MPEG2_PIC_CODING_TYPE_P :case V4L2_MPEG2_PIC_CODING_TYPE_B :@@ -1819,7 +1834,13 @@ static int std_validate_compound(const struct v4l2_ctrl *ctrl, u32 idx,default :return -EINVAL ; } +zero_reserved (*p_mpeg2_picture); +break ; + +case V4L2_CTRL_TYPE_MPEG2_SLICE_PARAMS : + p_mpeg2_slice_params = p; +zero_reserved (*p_mpeg2_slice_params);break ;case V4L2_CTRL_TYPE_MPEG2_QUANTIZATION :drivers/staging/media/hantro/hantro_drv.c +10
-0@@ -286,6 +286,16 @@ static const struct hantro_ctrl controls[] = { .def = 50, .ops = &hantro_jpeg_ctrl_ops, }, + }, { + .codec = HANTRO_MPEG2_DECODER, + .cfg = { + .id = V4L2_CID_MPEG_VIDEO_MPEG2_SEQUENCE, + }, + }, { + .codec = HANTRO_MPEG2_DECODER, + .cfg = { + .id = V4L2_CID_MPEG_VIDEO_MPEG2_PICTURE, + }, }, { .codec = HANTRO_MPEG2_DECODER, .cfg = {drivers/staging/media/hantro/hantro_g1_mpeg2_dec.c +8
-6@@ -95,8 +95,8 @@ static void hantro_g1_mpeg2_dec_set_buffers(struct hantro_dev *vpu, struct hantro_ctx *ctx, struct vb2_buffer *src_buf, struct vb2_buffer *dst_buf, - const struct v4l2_mpeg2_sequence *seq, - const struct v4l2_mpeg2_picture *pic, + const struct v4l2_ctrl_mpeg2_sequence *seq, + const struct v4l2_ctrl_mpeg2_picture *pic, const struct v4l2_ctrl_mpeg2_slice_params *slice_params) { dma_addr_t forward_addr = 0, backward_addr = 0;@@ -156,8 +156,8 @@ void hantro_g1_mpeg2_dec_run(struct hantro_ctx *ctx)struct hantro_dev *vpu = ctx->dev;struct vb2_v4l2_buffer *src_buf, *dst_buf;const struct v4l2_ctrl_mpeg2_slice_params *slice_params; -const struct v4l2_mpeg2_sequence *seq; -const struct v4l2_mpeg2_picture *pic; +const struct v4l2_ctrl_mpeg2_sequence *seq; +const struct v4l2_ctrl_mpeg2_picture *pic;u32 reg; src_buf =hantro_get_src_buf (ctx);@@ -168,8 +168,10 @@ void hantro_g1_mpeg2_dec_run(struct hantro_ctx *ctx) slice_params =hantro_get_ctrl (ctx,V4L2_CID_MPEG_VIDEO_MPEG2_SLICE_PARAMS ); - seq = &slice_params->sequence; - pic = &slice_params->picture; + seq =hantro_get_ctrl (ctx, +V4L2_CID_MPEG_VIDEO_MPEG2_SEQUENCE ); + pic =hantro_get_ctrl (ctx, +V4L2_CID_MPEG_VIDEO_MPEG2_PICTURE ); reg =G1_REG_DEC_AXI_RD_ID (0 ) | G1_REG_DEC_TIMEOUT_E(1) |drivers/staging/media/hantro/rk3399_vpu_hw_mpeg2_dec.c +8
-6@@ -97,8 +97,8 @@ rk3399_vpu_mpeg2_dec_set_buffers(struct hantro_dev *vpu,struct hantro_ctx *ctx, struct vb2_buffer *src_buf, struct vb2_buffer *dst_buf, - const struct v4l2_mpeg2_sequence *seq, - const struct v4l2_mpeg2_picture *pic, + const struct v4l2_ctrl_mpeg2_sequence *seq, + const struct v4l2_ctrl_mpeg2_picture *pic, const struct v4l2_ctrl_mpeg2_slice_params *slice_params) { dma_addr_t forward_addr = 0, backward_addr = 0;@@ -158,8 +158,8 @@ void rk3399_vpu_mpeg2_dec_run(struct hantro_ctx *ctx)struct hantro_dev *vpu = ctx->dev;struct vb2_v4l2_buffer *src_buf, *dst_buf;const struct v4l2_ctrl_mpeg2_slice_params *slice_params; -const struct v4l2_mpeg2_sequence *seq; -const struct v4l2_mpeg2_picture *pic; +const struct v4l2_ctrl_mpeg2_sequence *seq; +const struct v4l2_ctrl_mpeg2_picture *pic;u32 reg; src_buf =hantro_get_src_buf (ctx);@@ -169,8 +169,10 @@ void rk3399_vpu_mpeg2_dec_run(struct hantro_ctx *ctx) slice_params =hantro_get_ctrl (ctx,V4L2_CID_MPEG_VIDEO_MPEG2_SLICE_PARAMS ); - seq = &slice_params->sequence; - pic = &slice_params->picture; + seq =hantro_get_ctrl (ctx, +V4L2_CID_MPEG_VIDEO_MPEG2_SEQUENCE ); + pic =hantro_get_ctrl (ctx, +V4L2_CID_MPEG_VIDEO_MPEG2_PICTURE ); reg =VDPU_REG_DEC_ADV_PRE_DIS (0 ) | VDPU_REG_DEC_SCMD_DIS(0) |drivers/staging/media/sunxi/cedrus/cedrus.c +14
-0@@ -29,6 +29,20 @@#include "cedrus_hw.h" static const struct cedrus_control cedrus_controls[] = { + { + .cfg = { + .id =V4L2_CID_MPEG_VIDEO_MPEG2_SEQUENCE , + }, + .codec =CEDRUS_CODEC_MPEG2 , + .required = true, + }, + { + .cfg = { + .id =V4L2_CID_MPEG_VIDEO_MPEG2_PICTURE , + }, + .codec =CEDRUS_CODEC_MPEG2 , + .required = true, + }, { .cfg = { .id =V4L2_CID_MPEG_VIDEO_MPEG2_SLICE_PARAMS ,drivers/staging/media/sunxi/cedrus/cedrus.h +2
-0@@ -66,6 +66,8 @@ struct cedrus_h264_run { };struct cedrus_mpeg2_run { +const struct v4l2_ctrl_mpeg2_sequence *sequence; +const struct v4l2_ctrl_mpeg2_picture *picture;const struct v4l2_ctrl_mpeg2_slice_params *slice_params;const struct v4l2_ctrl_mpeg2_quantization *quantization; };drivers/staging/media/sunxi/cedrus/cedrus_mpeg2.c +4
-4@@ -75,8 +75,8 @@ static void cedrus_mpeg2_irq_disable(struct cedrus_ctx *ctx)static void cedrus_mpeg2_setup (struct cedrus_ctx *ctx,struct cedrus_run *run) {const struct v4l2_ctrl_mpeg2_slice_params *slice_params; -const struct v4l2_mpeg2_sequence *seq; -const struct v4l2_mpeg2_picture *pic; +const struct v4l2_ctrl_mpeg2_sequence *seq; +const struct v4l2_ctrl_mpeg2_picture *pic;const struct v4l2_ctrl_mpeg2_quantization *quantization;dma_addr_t src_buf_addr, dst_luma_addr, dst_chroma_addr;dma_addr_t fwd_luma_addr, fwd_chroma_addr;@@ -90,8 +90,8 @@ static void cedrus_mpeg2_setup(struct cedrus_ctx *ctx, struct cedrus_run *run)u32 reg; slice_params = run->mpeg2.slice_params; - seq = &slice_params->sequence; - pic = &slice_params->picture; + seq = run->mpeg2.sequence; + pic = run->mpeg2.picture; quantization = run->mpeg2.quantization;include/media/mpeg2-ctrls.h +91
-19@@ -12,24 +12,46 @@#define _MPEG2_CTRLS_H_#define V4L2_CID_MPEG_VIDEO_MPEG2_SLICE_PARAMS (V4L2_CID_MPEG_BASE+250) -#define V4L2_CID_MPEG_VIDEO_MPEG2_QUANTIZATION (V4L2_CID_MPEG_BASE+251) +#define V4L2_CID_MPEG_VIDEO_MPEG2_SEQUENCE (V4L2_CID_MPEG_BASE+251) +#define V4L2_CID_MPEG_VIDEO_MPEG2_PICTURE (V4L2_CID_MPEG_BASE+252) +#define V4L2_CID_MPEG_VIDEO_MPEG2_QUANTIZATION (V4L2_CID_MPEG_BASE+253)/* enum v4l2_ctrl_type type values */ -#define V4L2_CTRL_TYPE_MPEG2_SLICE_PARAMS 0x0103 -#define V4L2_CTRL_TYPE_MPEG2_QUANTIZATION 0x0104 +#define V4L2_CTRL_TYPE_MPEG2_SLICE_PARAMS 0x0130 +#define V4L2_CTRL_TYPE_MPEG2_SEQUENCE 0x0131 +#define V4L2_CTRL_TYPE_MPEG2_PICTURE 0x0132 +#define V4L2_CTRL_TYPE_MPEG2_QUANTIZATION 0x0133#define V4L2_MPEG2_SEQ_FLAG_PROGRESSIVE 0x0001 -struct v4l2_mpeg2_sequence { -/* ISO/IEC 13818-2, ITU-T Rec. H.262: Sequence header */ +/** +* struct v4l2_ctrl_mpeg2_sequence - MPEG-2 sequence header +* +* All the members on this structure match the sequence header and sequence +* extension syntaxes as specified by the MPEG-2 specification. +* +* Fields horizontal_size, vertical_size and vbv_buffer_size are a +* combination of respective _value and extension syntax elements, +* as described in section 6.3.3 "Sequence header". +* +* @horizontal_size: combination of elements horizontal_size_value and +* horizontal_size_extension. +* @vertical_size: combination of elements vertical_size_value and +* vertical_size_extension. +* @vbv_buffer_size: combination of elements vbv_buffer_size_value and +* vbv_buffer_size_extension. +* @profile_and_level_indication: see MPEG-2 specification. +* @chroma_format: see MPEG-2 specification. +* @reserved: padding field. Should be zeroed by applications. +* @flags: see V4L2_MPEG2_SEQ_FLAG_{}. +*/ +struct v4l2_ctrl_mpeg2_sequence {__u16 horizontal_size;__u16 vertical_size;__u32 vbv_buffer_size; - -/* ISO/IEC 13818-2, ITU-T Rec. H.262: Sequence extension */ __u16 profile_and_level_indication;__u8 chroma_format; - +__u8 reserved;__u32 flags; };@@ -55,30 +77,80 @@ struct v4l2_mpeg2_sequence {#define V4L2_MPEG2_PIC_FLAG_LOAD_CHROMA_INTRA 0x0400#define V4L2_MPEG2_PIC_FLAG_LOAD_CHROMA_NON_INTRA 0x0800 -struct v4l2_mpeg2_picture { -/* ISO/IEC 13818-2, ITU-T Rec. H.262: Picture header */ +/** +* struct v4l2_ctrl_mpeg2_picture - MPEG-2 picture header +* +* All the members on this structure match the picture header and picture +* coding extension syntaxes as specified by the MPEG-2 specification. +* +* In particular, the set of quantization load flags V4L2_MPEG2_PIC_FLAG_LOAD_{} +* are specified here in order to allow applications to pass non-default +* quantization matrices. In this case, applications are expected to use +* V4L2_CTRL_TYPE_MPEG2_QUANTIZATION to pass the values of non-default +* matrices. +* +* @picture_coding_type: see MPEG-2 specification. +* @f_code[2][2]: see MPEG-2 specification. +* @intra_dc_precision: see MPEG-2 specification. +* @picture_structure: see V4L2_MPEG2_PIC_{}_FIELD. +* @reserved: padding field. Should be zeroed by applications. +* @flags: see V4L2_MPEG2_PIC_FLAG_{}. +*/ +struct v4l2_ctrl_mpeg2_picture {__u8 picture_coding_type; - -/* ISO/IEC 13818-2, ITU-T Rec. H.262: Picture coding extension */ __u8 f_code[2 ][2 ];__u8 intra_dc_precision;__u8 picture_structure; - +__u8 reserved;__u32 flags; }; +/** +* struct v4l2_ctrl_mpeg2_slice_params - MPEG-2 slice header +* +* @backward_ref_ts: timestamp of the V4L2 capture buffer to use as +* reference for backward prediction. +* @forward_ref_ts: timestamp of the V4L2 capture buffer to use as +* reference for forward prediction. These timestamp refers to the +* timestamp field in struct v4l2_buffer. Use v4l2_timeval_to_ns() +* to convert the struct timeval to a __u64. +* @quantiser_scale_code: quantiser scale integer matching an +* homonymous syntax element. +* @reserved: padding field. Should be zeroed by applications. +*/ struct v4l2_ctrl_mpeg2_slice_params {__u64 backward_ref_ts;__u64 forward_ref_ts; - -struct v4l2_mpeg2_sequence sequence; -struct v4l2_mpeg2_picture picture; - -/* ISO/IEC 13818-2, ITU-T Rec. H.262: Slice */ __u32 quantiser_scale_code; +__u32 reserved; }; -/* ISO/IEC 13818-2, ITU-T Rec. H.262: Quant matrix extension */ +/** +* struct v4l2_ctrl_mpeg2_quantization - MPEG-2 quantization +* +* Quantization matrices as specified by section 6.3.7 +* "Quant matrix extension". +* +* Applications are expected to set the quantization matrices load +* flags V4L2_MPEG2_PIC_FLAG_LOAD_{} in struct v4l2_ctrl_mpeg2_picture +* to tell the kernel that a non-default matrix shall be used +* to decode the picture. +* +* @intra_quantiser_matrix: The quantization matrix coefficients +* for intra-coded frames, in zigzag scanning order. It is relevant +* for both luma and chroma components, although it can be superseded +* by the chroma-specific matrix for non-4:2:0 YUV formats. +* @non_intra_quantiser_matrix: The quantization matrix coefficients +* for non-intra-coded frames, in zigzag scanning order. It is relevant +* for both luma and chroma components, although it can be superseded +* by the chroma-specific matrix for non-4:2:0 YUV formats. +* @chroma_intra_quantiser_matrix: The quantization matrix coefficients +* for the chominance component of intra-coded frames, in zigzag scanning +* order. Only relevant for 4:2:2 and 4:4:4 YUV formats. +* @chroma_non_intra_quantiser_matrix: The quantization matrix coefficients +* for the chrominance component of non-intra-coded frames, in zigzag scanning +* order. Only relevant for 4:2:2 and 4:4:4 YUV formats. +*/ struct v4l2_ctrl_mpeg2_quantization {__u8 intra_quantiser_matrix[64 ];__u8 non_intra_quantiser_matrix[64 ];include/media/v4l2-ctrls.h +2
-0@@ -43,6 +43,8 @@ struct video_device;* @p_u16: Pointer to a 16-bit unsigned value. * @p_u32: Pointer to a 32-bit unsigned value. * @p_char: Pointer to a string. +* @p_mpeg2_sequence: Pointer to a MPEG2 sequence structure. +* @p_mpeg2_picture: Pointer to a MPEG2 picture structure. * @p_mpeg2_slice_params: Pointer to a MPEG2 slice parameters structure. * @p_mpeg2_quantization: Pointer to a MPEG2 quantization data structure. * @p_fwht_params: Pointer to a FWHT stateless parameters structure.
include/media/v4l2-ctrls.h union v4l2_ctrl_ptr { · line 73
Quoted 5 lines
include/media/v4l2-ctrls.h +2
-0@@ -67,6 +69,8 @@ union v4l2_ctrl_ptr {u16 *p_u16;u32 *p_u32;char *p_char; +struct v4l2_ctrl_mpeg2_sequence *p_sequence; +struct v4l2_ctrl_mpeg2_picture *p_picture;
These two should be named p_mpeg2_<name> to match the doc comment.
I think this series looks good and aligns MPEG-2 ctrls with other codecs. Together with some fixup at [1] this series is
on RK3288 (Hantro G1) with FFmpeg + Kodi.
[1] https://github.com/Kwiboo/linux-rockchip/commit/a6942e0a1e5f03078a37a1c575f76d02d7ba775f
Best regards,
Jonas
Quoted 4 lines
include/media/v4l2-ctrls.h +0
-0struct v4l2_ctrl_mpeg2_slice_params *p_mpeg2_slice_params;struct v4l2_ctrl_mpeg2_quantization *p_mpeg2_quantization;struct v4l2_ctrl_fwht_params *p_fwht_params;
Re: [PATCH v2 3/3] media: uapi: mpeg2: Split sequence and picture parameters
Quoted 590 lines · Jonas Karlman
Hi Ezequiel,
Quoted 579 lines · Ezequiel Garcia
Typically, bitstreams are composed of one sequence header NAL unit, followed by a number of picture header and picture coding extension NAL units. Each picture can be composed by a number of slices.
Let's split the MPEG-2 uAPI to follow these semantics more closely, allowing more usage flexibility. Having these controls splitted allows applications to set a sequence control at the beginning of a sequence, and then set a picture control for each frame.
While here add padding fields where needed, and document the uAPI header thoroughly.
Signed-off-by Ezequiel Garcia <[email protected]>--- .../media/v4l/ext-ctrls-codec.rst | 47 ++++++-- .../media/v4l/pixfmt-compressed.rst | 5 +- drivers/media/v4l2-core/v4l2-ctrls.c | 45 +++++-- drivers/staging/media/hantro/hantro_drv.c | 10 ++ .../media/hantro/hantro_g1_mpeg2_dec.c | 14 ++- .../media/hantro/rk3399_vpu_hw_mpeg2_dec.c | 14 ++- drivers/staging/media/sunxi/cedrus/cedrus.c | 14 +++ drivers/staging/media/sunxi/cedrus/cedrus.h | 2 + .../staging/media/sunxi/cedrus/cedrus_mpeg2.c | 8 +- include/media/mpeg2-ctrls.h | 110 +++++++++++++++--- include/media/v4l2-ctrls.h | 4 + 11 files changed, 212 insertions(+), 61 deletions(-)Documentation/userspace-api/media/v4l/ext-ctrls-codec.rst +35
-12@@ -2218,14 +2218,6 @@ enum v4l2_mpeg_video_h264_hierarchical_coding_type - :stub-columns: 0 :widths: 1 1 2 - * - struct :c:type:`v4l2_mpeg2_sequence` - - ``sequence`` - - Structure with MPEG-2 sequence metadata, merging relevant fields from - the sequence header and sequence extension parts of the bitstream. - * - struct :c:type:`v4l2_mpeg2_picture` - - ``picture`` - - Structure with MPEG-2 picture metadata, merging relevant fields from - the picture header and picture coding extension parts of the bitstream. * - __u64 - ``backward_ref_ts`` - Timestamp of the V4L2 capture buffer to use as backward reference, used@@ -2243,14 +2235,28 @@ enum v4l2_mpeg_video_h264_hierarchical_coding_type - * - __u32 - ``quantiser_scale_code`` - Code used to determine the quantization scale to use for the IDCT. + * - __u8 + - ``reserved`` + - Applications and drivers must set this to zero. -.. c:type:: v4l2_mpeg2_sequence +``V4L2_CID_MPEG_VIDEO_MPEG2_SEQUENCE (struct)`` + Specifies the sequence parameters (as extracted from the bitstream) for the + associated MPEG-2 slice data. This includes fields matching the syntax + elements from the sequence header and sequence extension parts of the + bitstream as specified by :ref:`mpeg2part2`. + + .. note:: + + This compound control is not yet part of the public kernel API and + it is expected to change. + +.. c:type:: v4l2_ctrl_mpeg2_sequence .. cssclass:: longtable .. tabularcolumns:: |p{1.5cm}|p{6.3cm}|p{9.4cm}| -.. flat-table:: struct v4l2_mpeg2_sequence +.. flat-table:: struct v4l2_ctrl_mpeg2_sequence :header-rows: 0 :stub-columns: 0 :widths: 1 1 2@@ -2272,6 +2278,9 @@ enum v4l2_mpeg_video_h264_hierarchical_coding_type - * - __u8 - ``chroma_format`` - The chrominance sub-sampling format (1: 4:2:0, 2: 4:2:2, 3: 4:4:4). + * - __u8 + - ``reserved`` + - Applications and drivers must set this to zero. * - __u32 - ``flags`` - See :ref:`MPEG-2 Sequence Flags <mpeg2_sequence_flags>`.@@ -2292,13 +2301,24 @@ enum v4l2_mpeg_video_h264_hierarchical_coding_type - - Indication that all the frames for the sequence are progressive instead of interlaced. -.. c:type:: v4l2_mpeg2_picture +``V4L2_CID_MPEG_VIDEO_MPEG2_PICTURE (struct)`` + Specifies the picture parameters (as extracted from the bitstream) for the + associated MPEG-2 slice data. This includes fields matching the syntax + elements from the picture header and picture coding extension parts of the + bitstream as specified by :ref:`mpeg2part2`. + + .. note:: + + This compound control is not yet part of the public kernel API and + it is expected to change. + +.. c:type:: v4l2_ctrl_mpeg2_picture .. cssclass:: longtable .. tabularcolumns:: |p{1.5cm}|p{6.3cm}|p{9.4cm}| -.. flat-table:: struct v4l2_mpeg2_picture +.. flat-table:: struct v4l2_ctrl_mpeg2_picture :header-rows: 0 :stub-columns: 0 :widths: 1 1 2@@ -2319,6 +2339,9 @@ enum v4l2_mpeg_video_h264_hierarchical_coding_type - - ``picture_structure`` - Picture structure (1: interlaced top field, 2: interlaced bottom field, 3: progressive frame). + * - __u8 + - ``reserved`` + - Applications and drivers must set this to zero. * - __u32 - ``flags`` - See :ref:`MPEG-2 Picture Flags <mpeg2_picture_flags>`.Documentation/userspace-api/media/v4l/pixfmt-compressed.rst +3
-2@@ -113,8 +113,9 @@ Compressed Formats This format is adapted for stateless video decoders that implement a MPEG-2 pipeline (using the :ref:`mem2mem` and :ref:`media-request-api`). Metadata associated with the frame to decode is required to be passed - through the ``V4L2_CID_MPEG_VIDEO_MPEG2_SLICE_PARAMS`` control and - quantization matrices can optionally be specified through the + through the ``V4L2_CID_MPEG_VIDEO_MPEG2_SEQUENCE``, + ``V4L2_CID_MPEG_VIDEO_MPEG2_PICTURE``, and ``V4L2_CID_MPEG_VIDEO_MPEG2_SLICE_PARAMS`` + controls. Quantization matrices can optionally be specified through the ``V4L2_CID_MPEG_VIDEO_MPEG2_QUANTIZATION`` control. See the :ref:`associated Codec Control IDs <v4l2-mpeg-mpeg2>`. Exactly one output and one capture buffer must be provided for use withdrivers/media/v4l2-core/v4l2-ctrls.c +33
-12@@ -1620,7 +1620,8 @@ static bool std_equal(const struct v4l2_ctrl *ctrl, u32 idx,static void std_init_compound (const struct v4l2_ctrl *ctrl,u32 idx,union v4l2_ctrl_ptr ptr) { -struct v4l2_ctrl_mpeg2_slice_params *p_mpeg2_slice_params; +struct v4l2_ctrl_mpeg2_sequence *p_mpeg2_sequence; +struct v4l2_ctrl_mpeg2_picture *p_mpeg2_picture;void *p = ptr.p + idx * ctrl->elem_size;if (ctrl->p_def.p_const)@@ -1634,13 +1635,18 @@ static void std_init_compound(const struct v4l2_ctrl *ctrl, u32 idx,* v4l2_ctrl_type enum. */ switch ((u32 )ctrl->type) { -case V4L2_CTRL_TYPE_MPEG2_SLICE_PARAMS : - p_mpeg2_slice_params = p; +case V4L2_CTRL_TYPE_MPEG2_SEQUENCE : + p_mpeg2_sequence = p; +/* 4:2:0 */ - p_mpeg2_slice_params->sequence.chroma_format =1 ; + p_mpeg2_sequence->chroma_format =1 ; +break ; +case V4L2_CTRL_TYPE_MPEG2_PICTURE : + p_mpeg2_picture = p; +/* interlaced top field */ - p_mpeg2_slice_params->picture.picture_structure =1 ; - p_mpeg2_slice_params->picture.picture_coding_type = + p_mpeg2_picture->picture_structure =1 ; + p_mpeg2_picture->picture_coding_type =V4L2_MPEG2_PIC_CODING_TYPE_I ;break ; }@@ -1768,6 +1774,8 @@ static void std_log(const struct v4l2_ctrl *ctrl)static int std_validate_compound (const struct v4l2_ctrl *ctrl,u32 idx,union v4l2_ctrl_ptr ptr) { +struct v4l2_ctrl_mpeg2_sequence *p_mpeg2_sequence; +struct v4l2_ctrl_mpeg2_picture *p_mpeg2_picture;struct v4l2_ctrl_mpeg2_slice_params *p_mpeg2_slice_params;struct v4l2_ctrl_vp8_frame_header *p_vp8_frame_header;struct v4l2_ctrl_h264_slice_params *p_h264_slice_params;@@ -1780,10 +1788,10 @@ static int std_validate_compound(const struct v4l2_ctrl *ctrl, u32 idx,unsigned int i;switch ((u32 )ctrl->type) { -case V4L2_CTRL_TYPE_MPEG2_SLICE_PARAMS : - p_mpeg2_slice_params = p; +case V4L2_CTRL_TYPE_MPEG2_SEQUENCE : + p_mpeg2_sequence = p; -switch (p_mpeg2_slice_params->sequence.chroma_format) { +switch (p_mpeg2_sequence->chroma_format) {case 1 :/* 4:2:0 */ case 2 :/* 4:2:2 */ case 3 :/* 4:4:4 */ @@ -1791,8 +1799,14 @@ static int std_validate_compound(const struct v4l2_ctrl *ctrl, u32 idx,default :return -EINVAL ; } +zero_reserved (*p_mpeg2_sequence); +break ; + +case V4L2_CTRL_TYPE_MPEG2_PICTURE : + p_mpeg2_picture = p; +break ; -switch (p_mpeg2_slice_params->picture.intra_dc_precision) { +switch (p_mpeg2_picture->intra_dc_precision) {case 0 :/* 8 bits */ case 1 :/* 9 bits */ case 2 :/* 10 bits */ @@ -1801,8 +1815,9 @@ static int std_validate_compound(const struct v4l2_ctrl *ctrl, u32 idx,default :return -EINVAL ; } +break ; -switch (p_mpeg2_slice_params->picture.picture_structure) { +switch (p_mpeg2_picture->picture_structure) {case V4L2_MPEG2_PIC_TOP_FIELD :case V4L2_MPEG2_PIC_BOTTOM_FIELD :case V4L2_MPEG2_PIC_FRAME :@@ -1811,7 +1826,7 @@ static int std_validate_compound(const struct v4l2_ctrl *ctrl, u32 idx,return -EINVAL ; } -switch (p_mpeg2_slice_params->picture.picture_coding_type) { +switch (p_mpeg2_picture->picture_coding_type) {case V4L2_MPEG2_PIC_CODING_TYPE_I :case V4L2_MPEG2_PIC_CODING_TYPE_P :case V4L2_MPEG2_PIC_CODING_TYPE_B :@@ -1819,7 +1834,13 @@ static int std_validate_compound(const struct v4l2_ctrl *ctrl, u32 idx,default :return -EINVAL ; } +zero_reserved (*p_mpeg2_picture); +break ; + +case V4L2_CTRL_TYPE_MPEG2_SLICE_PARAMS : + p_mpeg2_slice_params = p; +zero_reserved (*p_mpeg2_slice_params);break ;case V4L2_CTRL_TYPE_MPEG2_QUANTIZATION :drivers/staging/media/hantro/hantro_drv.c +10
-0@@ -286,6 +286,16 @@ static const struct hantro_ctrl controls[] = { .def = 50, .ops = &hantro_jpeg_ctrl_ops, }, + }, { + .codec = HANTRO_MPEG2_DECODER, + .cfg = { + .id = V4L2_CID_MPEG_VIDEO_MPEG2_SEQUENCE, + }, + }, { + .codec = HANTRO_MPEG2_DECODER, + .cfg = { + .id = V4L2_CID_MPEG_VIDEO_MPEG2_PICTURE, + }, }, { .codec = HANTRO_MPEG2_DECODER, .cfg = {drivers/staging/media/hantro/hantro_g1_mpeg2_dec.c +8
-6@@ -95,8 +95,8 @@ static void hantro_g1_mpeg2_dec_set_buffers(struct hantro_dev *vpu, struct hantro_ctx *ctx, struct vb2_buffer *src_buf, struct vb2_buffer *dst_buf, - const struct v4l2_mpeg2_sequence *seq, - const struct v4l2_mpeg2_picture *pic, + const struct v4l2_ctrl_mpeg2_sequence *seq, + const struct v4l2_ctrl_mpeg2_picture *pic, const struct v4l2_ctrl_mpeg2_slice_params *slice_params) { dma_addr_t forward_addr = 0, backward_addr = 0;@@ -156,8 +156,8 @@ void hantro_g1_mpeg2_dec_run(struct hantro_ctx *ctx)struct hantro_dev *vpu = ctx->dev;struct vb2_v4l2_buffer *src_buf, *dst_buf;const struct v4l2_ctrl_mpeg2_slice_params *slice_params; -const struct v4l2_mpeg2_sequence *seq; -const struct v4l2_mpeg2_picture *pic; +const struct v4l2_ctrl_mpeg2_sequence *seq; +const struct v4l2_ctrl_mpeg2_picture *pic;u32 reg; src_buf =hantro_get_src_buf (ctx);@@ -168,8 +168,10 @@ void hantro_g1_mpeg2_dec_run(struct hantro_ctx *ctx) slice_params =hantro_get_ctrl (ctx,V4L2_CID_MPEG_VIDEO_MPEG2_SLICE_PARAMS ); - seq = &slice_params->sequence; - pic = &slice_params->picture; + seq =hantro_get_ctrl (ctx, +V4L2_CID_MPEG_VIDEO_MPEG2_SEQUENCE ); + pic =hantro_get_ctrl (ctx, +V4L2_CID_MPEG_VIDEO_MPEG2_PICTURE ); reg =G1_REG_DEC_AXI_RD_ID (0 ) | G1_REG_DEC_TIMEOUT_E(1) |drivers/staging/media/hantro/rk3399_vpu_hw_mpeg2_dec.c +8
-6@@ -97,8 +97,8 @@ rk3399_vpu_mpeg2_dec_set_buffers(struct hantro_dev *vpu,struct hantro_ctx *ctx, struct vb2_buffer *src_buf, struct vb2_buffer *dst_buf, - const struct v4l2_mpeg2_sequence *seq, - const struct v4l2_mpeg2_picture *pic, + const struct v4l2_ctrl_mpeg2_sequence *seq, + const struct v4l2_ctrl_mpeg2_picture *pic, const struct v4l2_ctrl_mpeg2_slice_params *slice_params) { dma_addr_t forward_addr = 0, backward_addr = 0;@@ -158,8 +158,8 @@ void rk3399_vpu_mpeg2_dec_run(struct hantro_ctx *ctx)struct hantro_dev *vpu = ctx->dev;struct vb2_v4l2_buffer *src_buf, *dst_buf;const struct v4l2_ctrl_mpeg2_slice_params *slice_params; -const struct v4l2_mpeg2_sequence *seq; -const struct v4l2_mpeg2_picture *pic; +const struct v4l2_ctrl_mpeg2_sequence *seq; +const struct v4l2_ctrl_mpeg2_picture *pic;u32 reg; src_buf =hantro_get_src_buf (ctx);@@ -169,8 +169,10 @@ void rk3399_vpu_mpeg2_dec_run(struct hantro_ctx *ctx) slice_params =hantro_get_ctrl (ctx,V4L2_CID_MPEG_VIDEO_MPEG2_SLICE_PARAMS ); - seq = &slice_params->sequence; - pic = &slice_params->picture; + seq =hantro_get_ctrl (ctx, +V4L2_CID_MPEG_VIDEO_MPEG2_SEQUENCE ); + pic =hantro_get_ctrl (ctx, +V4L2_CID_MPEG_VIDEO_MPEG2_PICTURE ); reg =VDPU_REG_DEC_ADV_PRE_DIS (0 ) | VDPU_REG_DEC_SCMD_DIS(0) |drivers/staging/media/sunxi/cedrus/cedrus.c +14
-0@@ -29,6 +29,20 @@#include "cedrus_hw.h" static const struct cedrus_control cedrus_controls[] = { + { + .cfg = { + .id =V4L2_CID_MPEG_VIDEO_MPEG2_SEQUENCE , + }, + .codec =CEDRUS_CODEC_MPEG2 , + .required = true, + }, + { + .cfg = { + .id =V4L2_CID_MPEG_VIDEO_MPEG2_PICTURE , + }, + .codec =CEDRUS_CODEC_MPEG2 , + .required = true, + }, { .cfg = { .id =V4L2_CID_MPEG_VIDEO_MPEG2_SLICE_PARAMS ,drivers/staging/media/sunxi/cedrus/cedrus.h +2
-0@@ -66,6 +66,8 @@ struct cedrus_h264_run { };struct cedrus_mpeg2_run { +const struct v4l2_ctrl_mpeg2_sequence *sequence; +const struct v4l2_ctrl_mpeg2_picture *picture;const struct v4l2_ctrl_mpeg2_slice_params *slice_params;const struct v4l2_ctrl_mpeg2_quantization *quantization; };drivers/staging/media/sunxi/cedrus/cedrus_mpeg2.c +4
-4@@ -75,8 +75,8 @@ static void cedrus_mpeg2_irq_disable(struct cedrus_ctx *ctx)static void cedrus_mpeg2_setup (struct cedrus_ctx *ctx,struct cedrus_run *run) {const struct v4l2_ctrl_mpeg2_slice_params *slice_params; -const struct v4l2_mpeg2_sequence *seq; -const struct v4l2_mpeg2_picture *pic; +const struct v4l2_ctrl_mpeg2_sequence *seq; +const struct v4l2_ctrl_mpeg2_picture *pic;const struct v4l2_ctrl_mpeg2_quantization *quantization;dma_addr_t src_buf_addr, dst_luma_addr, dst_chroma_addr;dma_addr_t fwd_luma_addr, fwd_chroma_addr;@@ -90,8 +90,8 @@ static void cedrus_mpeg2_setup(struct cedrus_ctx *ctx, struct cedrus_run *run)u32 reg; slice_params = run->mpeg2.slice_params; - seq = &slice_params->sequence; - pic = &slice_params->picture; + seq = run->mpeg2.sequence; + pic = run->mpeg2.picture; quantization = run->mpeg2.quantization;include/media/mpeg2-ctrls.h +91
-19@@ -12,24 +12,46 @@#define _MPEG2_CTRLS_H_#define V4L2_CID_MPEG_VIDEO_MPEG2_SLICE_PARAMS (V4L2_CID_MPEG_BASE+250) -#define V4L2_CID_MPEG_VIDEO_MPEG2_QUANTIZATION (V4L2_CID_MPEG_BASE+251) +#define V4L2_CID_MPEG_VIDEO_MPEG2_SEQUENCE (V4L2_CID_MPEG_BASE+251) +#define V4L2_CID_MPEG_VIDEO_MPEG2_PICTURE (V4L2_CID_MPEG_BASE+252) +#define V4L2_CID_MPEG_VIDEO_MPEG2_QUANTIZATION (V4L2_CID_MPEG_BASE+253)/* enum v4l2_ctrl_type type values */ -#define V4L2_CTRL_TYPE_MPEG2_SLICE_PARAMS 0x0103 -#define V4L2_CTRL_TYPE_MPEG2_QUANTIZATION 0x0104 +#define V4L2_CTRL_TYPE_MPEG2_SLICE_PARAMS 0x0130 +#define V4L2_CTRL_TYPE_MPEG2_SEQUENCE 0x0131 +#define V4L2_CTRL_TYPE_MPEG2_PICTURE 0x0132 +#define V4L2_CTRL_TYPE_MPEG2_QUANTIZATION 0x0133#define V4L2_MPEG2_SEQ_FLAG_PROGRESSIVE 0x0001 -struct v4l2_mpeg2_sequence { -/* ISO/IEC 13818-2, ITU-T Rec. H.262: Sequence header */ +/** +* struct v4l2_ctrl_mpeg2_sequence - MPEG-2 sequence header +* +* All the members on this structure match the sequence header and sequence +* extension syntaxes as specified by the MPEG-2 specification. +* +* Fields horizontal_size, vertical_size and vbv_buffer_size are a +* combination of respective _value and extension syntax elements, +* as described in section 6.3.3 "Sequence header". +* +* @horizontal_size: combination of elements horizontal_size_value and +* horizontal_size_extension. +* @vertical_size: combination of elements vertical_size_value and +* vertical_size_extension. +* @vbv_buffer_size: combination of elements vbv_buffer_size_value and +* vbv_buffer_size_extension. +* @profile_and_level_indication: see MPEG-2 specification. +* @chroma_format: see MPEG-2 specification. +* @reserved: padding field. Should be zeroed by applications. +* @flags: see V4L2_MPEG2_SEQ_FLAG_{}. +*/ +struct v4l2_ctrl_mpeg2_sequence {__u16 horizontal_size;__u16 vertical_size;__u32 vbv_buffer_size; - -/* ISO/IEC 13818-2, ITU-T Rec. H.262: Sequence extension */ __u16 profile_and_level_indication;__u8 chroma_format; - +__u8 reserved;__u32 flags; };@@ -55,30 +77,80 @@ struct v4l2_mpeg2_sequence {#define V4L2_MPEG2_PIC_FLAG_LOAD_CHROMA_INTRA 0x0400#define V4L2_MPEG2_PIC_FLAG_LOAD_CHROMA_NON_INTRA 0x0800 -struct v4l2_mpeg2_picture { -/* ISO/IEC 13818-2, ITU-T Rec. H.262: Picture header */ +/** +* struct v4l2_ctrl_mpeg2_picture - MPEG-2 picture header +* +* All the members on this structure match the picture header and picture +* coding extension syntaxes as specified by the MPEG-2 specification. +* +* In particular, the set of quantization load flags V4L2_MPEG2_PIC_FLAG_LOAD_{} +* are specified here in order to allow applications to pass non-default +* quantization matrices. In this case, applications are expected to use +* V4L2_CTRL_TYPE_MPEG2_QUANTIZATION to pass the values of non-default +* matrices. +* +* @picture_coding_type: see MPEG-2 specification. +* @f_code[2][2]: see MPEG-2 specification. +* @intra_dc_precision: see MPEG-2 specification. +* @picture_structure: see V4L2_MPEG2_PIC_{}_FIELD. +* @reserved: padding field. Should be zeroed by applications. +* @flags: see V4L2_MPEG2_PIC_FLAG_{}. +*/ +struct v4l2_ctrl_mpeg2_picture {__u8 picture_coding_type; - -/* ISO/IEC 13818-2, ITU-T Rec. H.262: Picture coding extension */ __u8 f_code[2 ][2 ];__u8 intra_dc_precision;__u8 picture_structure; - +__u8 reserved;__u32 flags; }; +/** +* struct v4l2_ctrl_mpeg2_slice_params - MPEG-2 slice header +* +* @backward_ref_ts: timestamp of the V4L2 capture buffer to use as +* reference for backward prediction. +* @forward_ref_ts: timestamp of the V4L2 capture buffer to use as +* reference for forward prediction. These timestamp refers to the +* timestamp field in struct v4l2_buffer. Use v4l2_timeval_to_ns() +* to convert the struct timeval to a __u64. +* @quantiser_scale_code: quantiser scale integer matching an +* homonymous syntax element. +* @reserved: padding field. Should be zeroed by applications. +*/ struct v4l2_ctrl_mpeg2_slice_params {__u64 backward_ref_ts;__u64 forward_ref_ts; - -struct v4l2_mpeg2_sequence sequence; -struct v4l2_mpeg2_picture picture; - -/* ISO/IEC 13818-2, ITU-T Rec. H.262: Slice */ __u32 quantiser_scale_code; +__u32 reserved; }; -/* ISO/IEC 13818-2, ITU-T Rec. H.262: Quant matrix extension */ +/** +* struct v4l2_ctrl_mpeg2_quantization - MPEG-2 quantization +* +* Quantization matrices as specified by section 6.3.7 +* "Quant matrix extension". +* +* Applications are expected to set the quantization matrices load +* flags V4L2_MPEG2_PIC_FLAG_LOAD_{} in struct v4l2_ctrl_mpeg2_picture +* to tell the kernel that a non-default matrix shall be used +* to decode the picture. +* +* @intra_quantiser_matrix: The quantization matrix coefficients +* for intra-coded frames, in zigzag scanning order. It is relevant +* for both luma and chroma components, although it can be superseded +* by the chroma-specific matrix for non-4:2:0 YUV formats. +* @non_intra_quantiser_matrix: The quantization matrix coefficients +* for non-intra-coded frames, in zigzag scanning order. It is relevant +* for both luma and chroma components, although it can be superseded +* by the chroma-specific matrix for non-4:2:0 YUV formats. +* @chroma_intra_quantiser_matrix: The quantization matrix coefficients +* for the chominance component of intra-coded frames, in zigzag scanning +* order. Only relevant for 4:2:2 and 4:4:4 YUV formats. +* @chroma_non_intra_quantiser_matrix: The quantization matrix coefficients +* for the chrominance component of non-intra-coded frames, in zigzag scanning +* order. Only relevant for 4:2:2 and 4:4:4 YUV formats. +*/ struct v4l2_ctrl_mpeg2_quantization {__u8 intra_quantiser_matrix[64 ];__u8 non_intra_quantiser_matrix[64 ];include/media/v4l2-ctrls.h +2
-0@@ -43,6 +43,8 @@ struct video_device;* @p_u16: Pointer to a 16-bit unsigned value. * @p_u32: Pointer to a 32-bit unsigned value. * @p_char: Pointer to a string. +* @p_mpeg2_sequence: Pointer to a MPEG2 sequence structure. +* @p_mpeg2_picture: Pointer to a MPEG2 picture structure. * @p_mpeg2_slice_params: Pointer to a MPEG2 slice parameters structure. * @p_mpeg2_quantization: Pointer to a MPEG2 quantization data structure. * @p_fwht_params: Pointer to a FWHT stateless parameters structure. include/media/v4l2-ctrls.h union v4l2_ctrl_ptr { · line 73
Quoted 5 lines
include/media/v4l2-ctrls.h +2
-0@@ -67,6 +69,8 @@ union v4l2_ctrl_ptr {u16 *p_u16;u32 *p_u32;char *p_char; +struct v4l2_ctrl_mpeg2_sequence *p_sequence; +struct v4l2_ctrl_mpeg2_picture *p_picture;These two should be named p_mpeg2_<name> to match the doc comment.
Quoted 9 lines
I think this series looks good and aligns MPEG-2 ctrls with other codecs. Together with some fixup at [1] this series is
Tested-by Jonas Karlman <[email protected]>on RK3288 (Hantro G1) with FFmpeg + Kodi.
[1] https://github.com/Kwiboo/linux-rockchip/commit/a6942e0a1e5f03078a37a1c575f76d02d7ba775f
Thanks a lot!
Just submitted v3 with your tested-by
and the above fixes.
Ezequiel