Commit e65e4f13 authored by Kamil Debski's avatar Kamil Debski Committed by Mauro Carvalho Chehab
Browse files

[media] v4l: add control definitions for codec devices 



Add control definitions and documentation for controls
specific to codec devices.

Signed-off-by: default avatarKamil Debski <k.debski@samsung.com>
Signed-off-by: default avatarKyungmin Park <kyungmin.park@samsung.com>
Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@redhat.com>
parent 4fa64dae

Documentation/DocBook/media/v4l/controls.xml

+969 −0

File changed.

Preview size limit exceeded, changes collapsed.

include/linux/videodev2.h

+168 −1
Original line number Diff line number Diff line
@@ -1156,8 +1156,13 @@ enum v4l2_colorfx { 
#define V4L2_CID_ILLUMINATORS_1			(V4L2_CID_BASE+37)

#define V4L2_CID_ILLUMINATORS_2			(V4L2_CID_BASE+38)



#define V4L2_CID_MIN_BUFFERS_FOR_CAPTURE	(V4L2_CID_BASE+39)

#define V4L2_CID_MIN_BUFFERS_FOR_OUTPUT		(V4L2_CID_BASE+40)



/* last CID + 1 */

#define V4L2_CID_LASTP1                         (V4L2_CID_BASE+39)

#define V4L2_CID_LASTP1                         (V4L2_CID_BASE+41)



/* Minimum number of buffer neede by the device */



/*  MPEG-class control IDs defined by V4L2 */

#define V4L2_CID_MPEG_BASE 			(V4L2_CTRL_CLASS_MPEG | 0x900)
@@ -1329,6 +1334,141 @@ enum v4l2_mpeg_video_bitrate_mode { 
#define V4L2_CID_MPEG_VIDEO_TEMPORAL_DECIMATION (V4L2_CID_MPEG_BASE+209)

#define V4L2_CID_MPEG_VIDEO_MUTE 		(V4L2_CID_MPEG_BASE+210)

#define V4L2_CID_MPEG_VIDEO_MUTE_YUV 		(V4L2_CID_MPEG_BASE+211)

#define V4L2_CID_MPEG_VIDEO_DECODER_SLICE_INTERFACE		(V4L2_CID_MPEG_BASE+212)

#define V4L2_CID_MPEG_VIDEO_DECODER_MPEG4_DEBLOCK_FILTER	(V4L2_CID_MPEG_BASE+213)

#define V4L2_CID_MPEG_VIDEO_CYCLIC_INTRA_REFRESH_MB		(V4L2_CID_MPEG_BASE+214)

#define V4L2_CID_MPEG_VIDEO_FRAME_RC_ENABLE			(V4L2_CID_MPEG_BASE+215)

#define V4L2_CID_MPEG_VIDEO_HEADER_MODE				(V4L2_CID_MPEG_BASE+216)

enum v4l2_mpeg_video_header_mode {

	V4L2_MPEG_VIDEO_HEADER_MODE_SEPARATE			= 0,

	V4L2_MPEG_VIDEO_HEADER_MODE_JOINED_WITH_1ST_FRAME	= 1,



};

#define V4L2_CID_MPEG_VIDEO_MAX_REF_PIC			(V4L2_CID_MPEG_BASE+217)

#define V4L2_CID_MPEG_VIDEO_MB_RC_ENABLE		(V4L2_CID_MPEG_BASE+218)

#define V4L2_CID_MPEG_VIDEO_MULTI_SLICE_MAX_BYTES	(V4L2_CID_MPEG_BASE+219)

#define V4L2_CID_MPEG_VIDEO_MULTI_SLICE_MAX_MB		(V4L2_CID_MPEG_BASE+220)

#define V4L2_CID_MPEG_VIDEO_MULTI_SLICE_MODE		(V4L2_CID_MPEG_BASE+221)

enum v4l2_mpeg_video_multi_slice_mode {

	V4L2_MPEG_VIDEO_MULTI_SLICE_MODE_SINGLE		= 0,

	V4L2_MPEG_VIDEO_MULTI_SICE_MODE_MAX_MB		= 1,

	V4L2_MPEG_VIDEO_MULTI_SICE_MODE_MAX_BYTES	= 2,

};

#define V4L2_CID_MPEG_VIDEO_VBV_SIZE			(V4L2_CID_MPEG_BASE+222)

#define V4L2_CID_MPEG_VIDEO_H263_I_FRAME_QP		(V4L2_CID_MPEG_BASE+300)

#define V4L2_CID_MPEG_VIDEO_H263_P_FRAME_QP		(V4L2_CID_MPEG_BASE+301)

#define V4L2_CID_MPEG_VIDEO_H263_B_FRAME_QP		(V4L2_CID_MPEG_BASE+302)

#define V4L2_CID_MPEG_VIDEO_H263_MIN_QP			(V4L2_CID_MPEG_BASE+303)

#define V4L2_CID_MPEG_VIDEO_H263_MAX_QP			(V4L2_CID_MPEG_BASE+304)

#define V4L2_CID_MPEG_VIDEO_H264_I_FRAME_QP		(V4L2_CID_MPEG_BASE+350)

#define V4L2_CID_MPEG_VIDEO_H264_P_FRAME_QP		(V4L2_CID_MPEG_BASE+351)

#define V4L2_CID_MPEG_VIDEO_H264_B_FRAME_QP		(V4L2_CID_MPEG_BASE+352)

#define V4L2_CID_MPEG_VIDEO_H264_MIN_QP			(V4L2_CID_MPEG_BASE+353)

#define V4L2_CID_MPEG_VIDEO_H264_MAX_QP			(V4L2_CID_MPEG_BASE+354)

#define V4L2_CID_MPEG_VIDEO_H264_8X8_TRANSFORM		(V4L2_CID_MPEG_BASE+355)

#define V4L2_CID_MPEG_VIDEO_H264_CPB_SIZE		(V4L2_CID_MPEG_BASE+356)

#define V4L2_CID_MPEG_VIDEO_H264_ENTROPY_MODE		(V4L2_CID_MPEG_BASE+357)

enum v4l2_mpeg_video_h264_entropy_mode {

	V4L2_MPEG_VIDEO_H264_ENTROPY_MODE_CAVLC	= 0,

	V4L2_MPEG_VIDEO_H264_ENTROPY_MODE_CABAC	= 1,

};

#define V4L2_CID_MPEG_VIDEO_H264_I_PERIOD		(V4L2_CID_MPEG_BASE+358)

#define V4L2_CID_MPEG_VIDEO_H264_LEVEL			(V4L2_CID_MPEG_BASE+359)

enum v4l2_mpeg_video_h264_level {

	V4L2_MPEG_VIDEO_H264_LEVEL_1_0	= 0,

	V4L2_MPEG_VIDEO_H264_LEVEL_1B	= 1,

	V4L2_MPEG_VIDEO_H264_LEVEL_1_1	= 2,

	V4L2_MPEG_VIDEO_H264_LEVEL_1_2	= 3,

	V4L2_MPEG_VIDEO_H264_LEVEL_1_3	= 4,

	V4L2_MPEG_VIDEO_H264_LEVEL_2_0	= 5,

	V4L2_MPEG_VIDEO_H264_LEVEL_2_1	= 6,

	V4L2_MPEG_VIDEO_H264_LEVEL_2_2	= 7,

	V4L2_MPEG_VIDEO_H264_LEVEL_3_0	= 8,

	V4L2_MPEG_VIDEO_H264_LEVEL_3_1	= 9,

	V4L2_MPEG_VIDEO_H264_LEVEL_3_2	= 10,

	V4L2_MPEG_VIDEO_H264_LEVEL_4_0	= 11,

	V4L2_MPEG_VIDEO_H264_LEVEL_4_1	= 12,

	V4L2_MPEG_VIDEO_H264_LEVEL_4_2	= 13,

	V4L2_MPEG_VIDEO_H264_LEVEL_5_0	= 14,

	V4L2_MPEG_VIDEO_H264_LEVEL_5_1	= 15,

};

#define V4L2_CID_MPEG_VIDEO_H264_LOOP_FILTER_ALPHA	(V4L2_CID_MPEG_BASE+360)

#define V4L2_CID_MPEG_VIDEO_H264_LOOP_FILTER_BETA	(V4L2_CID_MPEG_BASE+361)

#define V4L2_CID_MPEG_VIDEO_H264_LOOP_FILTER_MODE	(V4L2_CID_MPEG_BASE+362)

enum v4l2_mpeg_video_h264_loop_filter_mode {

	V4L2_MPEG_VIDEO_H264_LOOP_FILTER_MODE_ENABLED				= 0,

	V4L2_MPEG_VIDEO_H264_LOOP_FILTER_MODE_DISABLED				= 1,

	V4L2_MPEG_VIDEO_H264_LOOP_FILTER_MODE_DISABLED_AT_SLICE_BOUNDARY	= 2,

};

#define V4L2_CID_MPEG_VIDEO_H264_PROFILE		(V4L2_CID_MPEG_BASE+363)

enum v4l2_mpeg_video_h264_profile {

	V4L2_MPEG_VIDEO_H264_PROFILE_BASELINE			= 0,

	V4L2_MPEG_VIDEO_H264_PROFILE_CONSTRAINED_BASELINE	= 1,

	V4L2_MPEG_VIDEO_H264_PROFILE_MAIN			= 2,

	V4L2_MPEG_VIDEO_H264_PROFILE_EXTENDED			= 3,

	V4L2_MPEG_VIDEO_H264_PROFILE_HIGH			= 4,

	V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_10			= 5,

	V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_422			= 6,

	V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_444_PREDICTIVE	= 7,

	V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_10_INTRA		= 8,

	V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_422_INTRA		= 9,

	V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_444_INTRA		= 10,

	V4L2_MPEG_VIDEO_H264_PROFILE_CAVLC_444_INTRA		= 11,

	V4L2_MPEG_VIDEO_H264_PROFILE_SCALABLE_BASELINE		= 12,

	V4L2_MPEG_VIDEO_H264_PROFILE_SCALABLE_HIGH		= 13,

	V4L2_MPEG_VIDEO_H264_PROFILE_SCALABLE_HIGH_INTRA	= 14,

	V4L2_MPEG_VIDEO_H264_PROFILE_STEREO_HIGH		= 15,

	V4L2_MPEG_VIDEO_H264_PROFILE_MULTIVIEW_HIGH		= 16,

};

#define V4L2_CID_MPEG_VIDEO_H264_VUI_EXT_SAR_HEIGHT	(V4L2_CID_MPEG_BASE+364)

#define V4L2_CID_MPEG_VIDEO_H264_VUI_EXT_SAR_WIDTH	(V4L2_CID_MPEG_BASE+365)

#define V4L2_CID_MPEG_VIDEO_H264_VUI_SAR_ENABLE		(V4L2_CID_MPEG_BASE+366)

#define V4L2_CID_MPEG_VIDEO_H264_VUI_SAR_IDC		(V4L2_CID_MPEG_BASE+367)

enum v4l2_mpeg_video_h264_vui_sar_idc {

	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_UNSPECIFIED	= 0,

	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_1x1		= 1,

	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_12x11		= 2,

	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_10x11		= 3,

	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_16x11		= 4,

	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_40x33		= 5,

	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_24x11		= 6,

	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_20x11		= 7,

	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_32x11		= 8,

	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_80x33		= 9,

	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_18x11		= 10,

	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_15x11		= 11,

	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_64x33		= 12,

	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_160x99		= 13,

	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_4x3		= 14,

	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_3x2		= 15,

	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_2x1		= 16,

	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_EXTENDED	= 17,

};

#define V4L2_CID_MPEG_VIDEO_MPEG4_I_FRAME_QP	(V4L2_CID_MPEG_BASE+400)

#define V4L2_CID_MPEG_VIDEO_MPEG4_P_FRAME_QP	(V4L2_CID_MPEG_BASE+401)

#define V4L2_CID_MPEG_VIDEO_MPEG4_B_FRAME_QP	(V4L2_CID_MPEG_BASE+402)

#define V4L2_CID_MPEG_VIDEO_MPEG4_MIN_QP	(V4L2_CID_MPEG_BASE+403)

#define V4L2_CID_MPEG_VIDEO_MPEG4_MAX_QP	(V4L2_CID_MPEG_BASE+404)

#define V4L2_CID_MPEG_VIDEO_MPEG4_LEVEL		(V4L2_CID_MPEG_BASE+405)

enum v4l2_mpeg_video_mpeg4_level {

	V4L2_MPEG_VIDEO_MPEG4_LEVEL_0	= 0,

	V4L2_MPEG_VIDEO_MPEG4_LEVEL_0B	= 1,

	V4L2_MPEG_VIDEO_MPEG4_LEVEL_1	= 2,

	V4L2_MPEG_VIDEO_MPEG4_LEVEL_2	= 3,

	V4L2_MPEG_VIDEO_MPEG4_LEVEL_3	= 4,

	V4L2_MPEG_VIDEO_MPEG4_LEVEL_3B	= 5,

	V4L2_MPEG_VIDEO_MPEG4_LEVEL_4	= 6,

	V4L2_MPEG_VIDEO_MPEG4_LEVEL_5	= 7,

};

#define V4L2_CID_MPEG_VIDEO_MPEG4_PROFILE	(V4L2_CID_MPEG_BASE+406)

enum v4l2_mpeg_video_mpeg4_profile {

	V4L2_MPEG_VIDEO_MPEG4_PROFILE_SIMPLE				= 0,

	V4L2_MPEG_VIDEO_MPEG4_PROFILE_ADVANCED_SIMPLE			= 1,

	V4L2_MPEG_VIDEO_MPEG4_PROFILE_CORE				= 2,

	V4L2_MPEG_VIDEO_MPEG4_PROFILE_SIMPLE_SCALABLE			= 3,

	V4L2_MPEG_VIDEO_MPEG4_PROFILE_ADVANCED_CODING_EFFICIENCY	= 4,

};

#define V4L2_CID_MPEG_VIDEO_MPEG4_QPEL		(V4L2_CID_MPEG_BASE+407)



/*  MPEG-class control IDs specific to the CX2341x driver as defined by V4L2 */

#define V4L2_CID_MPEG_CX2341X_BASE 				(V4L2_CTRL_CLASS_MPEG | 0x1000)
@@ -1371,6 +1511,33 @@ enum v4l2_mpeg_cx2341x_video_median_filter_type { 
#define V4L2_CID_MPEG_CX2341X_VIDEO_CHROMA_MEDIAN_FILTER_TOP 	(V4L2_CID_MPEG_CX2341X_BASE+10)

#define V4L2_CID_MPEG_CX2341X_STREAM_INSERT_NAV_PACKETS 	(V4L2_CID_MPEG_CX2341X_BASE+11)



/*  MPEG-class control IDs specific to the Samsung MFC 5.1 driver as defined by V4L2 */

#define V4L2_CID_MPEG_MFC51_BASE				(V4L2_CTRL_CLASS_MPEG | 0x1100)



#define V4L2_CID_MPEG_MFC51_VIDEO_DECODER_H264_DISPLAY_DELAY		(V4L2_CID_MPEG_MFC51_BASE+0)

#define V4L2_CID_MPEG_MFC51_VIDEO_DECODER_H264_DISPLAY_DELAY_ENABLE	(V4L2_CID_MPEG_MFC51_BASE+1)

#define V4L2_CID_MPEG_MFC51_VIDEO_FRAME_SKIP_MODE			(V4L2_CID_MPEG_MFC51_BASE+2)

enum v4l2_mpeg_mfc51_video_frame_skip_mode {

	V4L2_MPEG_MFC51_VIDEO_FRAME_SKIP_MODE_DISABLED		= 0,

	V4L2_MPEG_MFC51_VIDEO_FRAME_SKIP_MODE_LEVEL_LIMIT	= 1,

	V4L2_MPEG_MFC51_VIDEO_FRAME_SKIP_MODE_BUF_LIMIT		= 2,

};

#define V4L2_CID_MPEG_MFC51_VIDEO_FORCE_FRAME_TYPE			(V4L2_CID_MPEG_MFC51_BASE+3)

enum v4l2_mpeg_mfc51_video_force_frame_type {

	V4L2_MPEG_MFC51_VIDEO_FORCE_FRAME_TYPE_DISABLED		= 0,

	V4L2_MPEG_MFC51_VIDEO_FORCE_FRAME_TYPE_I_FRAME		= 1,

	V4L2_MPEG_MFC51_VIDEO_FORCE_FRAME_TYPE_NOT_CODED	= 2,

};

#define V4L2_CID_MPEG_MFC51_VIDEO_PADDING				(V4L2_CID_MPEG_MFC51_BASE+4)

#define V4L2_CID_MPEG_MFC51_VIDEO_PADDING_YUV				(V4L2_CID_MPEG_MFC51_BASE+5)

#define V4L2_CID_MPEG_MFC51_VIDEO_RC_FIXED_TARGET_BIT			(V4L2_CID_MPEG_MFC51_BASE+6)

#define V4L2_CID_MPEG_MFC51_VIDEO_RC_REACTION_COEFF			(V4L2_CID_MPEG_MFC51_BASE+7)

#define V4L2_CID_MPEG_MFC51_VIDEO_H264_ADAPTIVE_RC_ACTIVITY		(V4L2_CID_MPEG_MFC51_BASE+50)

#define V4L2_CID_MPEG_MFC51_VIDEO_H264_ADAPTIVE_RC_DARK			(V4L2_CID_MPEG_MFC51_BASE+51)

#define V4L2_CID_MPEG_MFC51_VIDEO_H264_ADAPTIVE_RC_SMOOTH		(V4L2_CID_MPEG_MFC51_BASE+52)

#define V4L2_CID_MPEG_MFC51_VIDEO_H264_ADAPTIVE_RC_STATIC		(V4L2_CID_MPEG_MFC51_BASE+53)

#define V4L2_CID_MPEG_MFC51_VIDEO_H264_NUM_REF_PIC_FOR_P		(V4L2_CID_MPEG_MFC51_BASE+54)



/*  Camera class control IDs */

#define V4L2_CID_CAMERA_CLASS_BASE 	(V4L2_CTRL_CLASS_CAMERA | 0x900)

#define V4L2_CID_CAMERA_CLASS 		(V4L2_CTRL_CLASS_CAMERA | 1)