You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
476 lines
14 KiB
476 lines
14 KiB
#ifndef _H_MSM_VPU_H_
|
|
#define _H_MSM_VPU_H_
|
|
|
|
#include <linux/videodev2.h>
|
|
|
|
/*
|
|
* V 4 L 2 E X T E N S I O N S B Y V P U
|
|
*/
|
|
|
|
/*
|
|
* v4l2_buffer:
|
|
*
|
|
* VPU uses standard V4L2 buffer flags, and defines some custom
|
|
* flags (used in v4l2_buffer.flags field):
|
|
* V4L2_QCOM_BUF_FLAG_EOS: buffer flag indicating end of stream
|
|
* V4L2_BUF_FLAG_CDS_ENABLE: buffer flag to enable chroma down-sampling
|
|
*/
|
|
#define V4L2_BUF_FLAG_CDS_ENABLE 0x10000000
|
|
|
|
/*
|
|
* VPU uses multi-plane v4l2_buffer in the following manner:
|
|
* each plane can be a separate ION buffer, or all planes are from the
|
|
* same ION buffer (under this case all planes have the same fd, but different
|
|
* offset).
|
|
*
|
|
* For struct v4l2_plane
|
|
* fd: ION fd representing the ION buffer this plane is from
|
|
* reserved[0]: offset of this plane from the start of the ION buffer in
|
|
* bytes. Needed when all planes are from the same ION buffer.
|
|
*/
|
|
#define V4L2_PLANE_MEM_OFFSET 0
|
|
|
|
/*
|
|
* struct v4l2_format:
|
|
* always use v4l2_pix_format_mplane, even when there is only one plane
|
|
*
|
|
* v4l2_pix_format_mplane:
|
|
*
|
|
* VPU uses v4l2_pix_format_mplane for pixel format configuration
|
|
* The following members of this structure is either extended or changed:
|
|
* pixelformat: extended, a few more private formats added
|
|
* colorspace: possible values are enum vpu_colorspace
|
|
* field: when it is V4L2_FIELD_ALTERNATE, flags from vpu format extension
|
|
* specifies which field first.
|
|
* reserved[]: VPU format extension. struct v4l2_format_vpu_extension
|
|
*/
|
|
enum vpu_colorspace {
|
|
VPU_CS_MIN = 0,
|
|
/* RGB with full range*/
|
|
VPU_CS_RGB_FULL = 1,
|
|
/* RGB with limited range*/
|
|
VPU_CS_RGB_LIMITED = 2,
|
|
/* REC 601 with full range */
|
|
VPU_CS_REC601_FULL = 3,
|
|
/* REC 601 with limited range */
|
|
VPU_CS_REC601_LIMITED = 4,
|
|
/* REC 709 with full range */
|
|
VPU_CS_REC709_FULL = 5,
|
|
/* REC 709 with limited range */
|
|
VPU_CS_REC709_LIMITED = 6,
|
|
/* SMPTE 240 with full range */
|
|
VPU_CS_SMPTE240_FULL = 7,
|
|
/* SMPTE 240 with limited range */
|
|
VPU_CS_SMPTE240_LIMITED = 8,
|
|
VPU_CS_MAX = 9,
|
|
};
|
|
|
|
|
|
#define VPU_FMT_EXT_FLAG_BT 1 /* bottom field first */
|
|
#define VPU_FMT_EXT_FLAG_TB 2 /* top field first */
|
|
#define VPU_FMT_EXT_FLAG_3D 4 /* 3D format */
|
|
struct v4l2_format_vpu_extension {
|
|
__u8 flag;
|
|
__u8 gap_in_lines;
|
|
};
|
|
|
|
/*
|
|
* Supported pixel formats:
|
|
*
|
|
* VPU supported pixel format fourcc codes (use in s_fmt pixelformat field).
|
|
* Can be enumerated using VIDIOC_ENUM_FMT
|
|
*
|
|
* Standard V4L2 formats, defined in videodev2.h :
|
|
*
|
|
* V4L2_PIX_FMT_RGB24 24 bit RGB-8-8-8
|
|
* V4L2_PIX_FMT_RGB32 32 bit XRGB-8-8-8-8
|
|
* V4L2_PIX_FMT_BGR24 24 bit BGR-8-8-8
|
|
* V4L2_PIX_FMT_BGR32 32 bit BGRX-8-8-8-8
|
|
*
|
|
* V4L2_PIX_FMT_NV12 12 bit YUV 4:2:0 semi-planar NV12
|
|
* V4L2_PIX_FMT_NV21 12 bit YUV 4:2:0 semi-planar NV21
|
|
* V4L2_PIX_FMT_YUYV 16 bit YUYV 4:2:2 interleaved
|
|
* V4L2_PIX_FMT_YVYU 16 bit YVYU 4:2:2 interleaved
|
|
* V4L2_PIX_FMT_UYVY 16 bit UYVY 4:2:2 interleaved
|
|
* V4L2_PIX_FMT_VYUY 16 bit VYUY 4:2:2 interleaved
|
|
*
|
|
*
|
|
* Private VPU formats, defined here :
|
|
*
|
|
* V4L2_PIX_FMT_XRGB2 32 bit XRGB-2-10-10-10
|
|
* V4L2_PIX_FMT_XBGR2 32 bit XBGR-2-10-10-10
|
|
*
|
|
* V4L2_PIX_FMT_YUYV10 24 bit YUYV 4:2:2 10 bit per component loose
|
|
* V4L2_PIX_FMT_YUV8 24 bit YUV 4:4:4 8 bit per component
|
|
* V4L2_PIX_FMT_YUV10 32 bit YUV 4:4:4 10 bit per component loose
|
|
* V4L2_PIX_FMT_YUYV10BWC 10 bit YUYV 4:2:2 compressed, for output only
|
|
*/
|
|
#define V4L2_PIX_FMT_XRGB2 v4l2_fourcc('X', 'R', 'G', '2')
|
|
#define V4L2_PIX_FMT_XBGR2 v4l2_fourcc('X', 'B', 'G', '2')
|
|
#define V4L2_PIX_FMT_YUYV10 v4l2_fourcc('Y', 'U', 'Y', 'L')
|
|
#define V4L2_PIX_FMT_YUV8 v4l2_fourcc('Y', 'U', 'V', '8')
|
|
#define V4L2_PIX_FMT_YUV10 v4l2_fourcc('Y', 'U', 'V', 'L')
|
|
#define V4L2_PIX_FMT_YUYV10BWC v4l2_fourcc('Y', 'B', 'W', 'C')
|
|
|
|
/*
|
|
* VIDIOC_S_INPUT/VIDIOC_S_OUTPUT
|
|
*
|
|
* The single integer passed by these commands specifies port type in the
|
|
* lower 16 bits, and pipe bit mask in the higher 16 bits.
|
|
*/
|
|
/* input / output types */
|
|
#define VPU_INPUT_TYPE_HOST 0
|
|
#define VPU_INPUT_TYPE_VCAP 1
|
|
#define VPU_OUTPUT_TYPE_HOST 0
|
|
#define VPU_OUTPUT_TYPE_DISPLAY 1
|
|
|
|
/* input / output pipe bit fields */
|
|
#define VPU_PIPE_VCAP0 (1 << 16)
|
|
#define VPU_PIPE_VCAP1 (1 << 17)
|
|
#define VPU_PIPE_DISPLAY0 (1 << 18)
|
|
#define VPU_PIPE_DISPLAY1 (1 << 19)
|
|
#define VPU_PIPE_DISPLAY2 (1 << 20)
|
|
#define VPU_PIPE_DISPLAY3 (1 << 21)
|
|
|
|
/*
|
|
* V P U E V E N T S : I D s A N D D A T A P A Y L O A D S
|
|
*/
|
|
|
|
/*
|
|
* Event ID: set in type field of struct v4l2_event
|
|
* payload: returned in u.data array of struct v4l2_event
|
|
*
|
|
*
|
|
* VPU_EVENT_FLUSH_DONE: Done flushing buffers after VPU_FLUSH_BUFS ioctl
|
|
* payload data: enum v4l2_buf_type (buffer type of flushed port)
|
|
*
|
|
* VPU_EVENT_ACTIVE_REGION_CHANGED: New Active Region Detected
|
|
* payload data: struct v4l2_rect (new active region rectangle)
|
|
*
|
|
* VPU_EVENT_SESSION_TIMESTAMP: New Session timestamp
|
|
* payload data: vpu_frame_timestamp_info
|
|
*
|
|
* VPU_EVENT_SESSION_CREATED: New session has been created
|
|
* payload data: int (number of the attached session)
|
|
*
|
|
* VPU_EVENT_SESSION_FREED: Session is detached and free
|
|
* payload data: int (number of the detached session)
|
|
*
|
|
* VPU_EVENT_SESSION_CLIENT_EXITED: Indicates that clients of current
|
|
* session have exited.
|
|
* payload data: int (number of all remaining clients for this session)
|
|
*
|
|
* VPU_EVENT_HW_ERROR: a hardware error occurred in VPU
|
|
* payload data: NULL
|
|
*
|
|
* VPU_EVENT_INVALID_CONFIG: invalid VPU session configuration
|
|
* payload data: NULL
|
|
*
|
|
* VPU_EVENT_FAILED_SESSION_STREAMING: Failed to stream session
|
|
* payload data: NULL
|
|
*/
|
|
#define VPU_PRIVATE_EVENT_BASE (V4L2_EVENT_PRIVATE_START + 6 * 1000)
|
|
enum VPU_PRIVATE_EVENT {
|
|
VPU_EVENT_START = VPU_PRIVATE_EVENT_BASE,
|
|
|
|
VPU_EVENT_FLUSH_DONE = VPU_EVENT_START + 1,
|
|
VPU_EVENT_ACTIVE_REGION_CHANGED = VPU_EVENT_START + 2,
|
|
VPU_EVENT_SESSION_TIMESTAMP = VPU_EVENT_START + 3,
|
|
VPU_EVENT_SESSION_CREATED = VPU_EVENT_START + 4,
|
|
VPU_EVENT_SESSION_FREED = VPU_EVENT_START + 5,
|
|
VPU_EVENT_SESSION_CLIENT_EXITED = VPU_EVENT_START + 6,
|
|
|
|
VPU_EVENT_HW_ERROR = VPU_EVENT_START + 11,
|
|
VPU_EVENT_INVALID_CONFIG = VPU_EVENT_START + 12,
|
|
VPU_EVENT_FAILED_SESSION_STREAMING = VPU_EVENT_START + 13,
|
|
|
|
VPU_EVENT_END
|
|
};
|
|
|
|
|
|
/*
|
|
* V P U CO N T R O L S : S T R U C T S A N D I D s
|
|
*
|
|
* Controls are video processing parameters
|
|
*/
|
|
|
|
/*
|
|
* Standard VPU Controls
|
|
*/
|
|
struct vpu_ctrl_standard {
|
|
__u32 enable; /* boolean: 0=disable, else=enable */
|
|
__s32 value;
|
|
};
|
|
|
|
struct vpu_ctrl_auto_manual {
|
|
__u32 enable; /* boolean: 0=disable, else=enable */
|
|
__u32 auto_mode; /* boolean: 0=manual, else=automatic */
|
|
__s32 value;
|
|
};
|
|
|
|
struct vpu_ctrl_range_mapping {
|
|
__u32 enable; /* boolean: 0=disable, else=enable */
|
|
__u32 y_range; /* the range mapping set for Y [0, 7] */
|
|
__u32 uv_range; /* the range mapping set for UV [0, 7] */
|
|
};
|
|
|
|
#define VPU_ACTIVE_REGION_N_EXCLUSIONS 1
|
|
struct vpu_ctrl_active_region_param {
|
|
__u32 enable; /* boolean: 0=disable, else=enable */
|
|
/* number of exclusion regions */
|
|
__u32 num_exclusions;
|
|
/* roi where active region detection is applied */
|
|
struct v4l2_rect detection_region;
|
|
/* roi(s) excluded from active region detection*/
|
|
struct v4l2_rect excluded_regions[VPU_ACTIVE_REGION_N_EXCLUSIONS];
|
|
};
|
|
|
|
struct vpu_ctrl_deinterlacing_mode {
|
|
__u32 field_polarity;
|
|
__u32 mvp_mode;
|
|
};
|
|
|
|
struct vpu_ctrl_hqv {
|
|
__u32 enable;
|
|
/* strength control of all sharpening features [0, 100] */
|
|
__u32 sharpen_strength;
|
|
/* strength control of Auto NR feature [0, 100] */
|
|
__u32 auto_nr_strength;
|
|
};
|
|
|
|
struct vpu_info_frame_timestamp {
|
|
/* presentation timestamp of the frame */
|
|
__u32 pts_low;
|
|
__u32 pts_high;
|
|
/* qtimer snapshot */
|
|
__u32 qtime_low;
|
|
__u32 qtime_high;
|
|
};
|
|
|
|
struct vpu_control {
|
|
__u32 control_id;
|
|
union control_data {
|
|
__s32 value;
|
|
struct vpu_ctrl_standard standard;
|
|
struct vpu_ctrl_auto_manual auto_manual;
|
|
struct vpu_ctrl_range_mapping range_mapping;
|
|
struct vpu_ctrl_active_region_param active_region_param;
|
|
struct v4l2_rect active_region_result;
|
|
struct vpu_ctrl_deinterlacing_mode deinterlacing_mode;
|
|
struct vpu_ctrl_hqv hqv;
|
|
struct vpu_info_frame_timestamp timestamp;
|
|
__u8 reserved[124];
|
|
} data;
|
|
};
|
|
|
|
/*
|
|
* IDs for standard controls (use in control_id field of struct vpu_control)
|
|
*
|
|
* VPU_CTRL_NOISE_REDUCTION: noise reduction level, data: auto_manual,
|
|
* value: [0, 100] (step in increments of 25).
|
|
*
|
|
* VPU_CTRL_IMAGE_ENHANCEMENT: image enhancement level, data: auto_manual,
|
|
* value: [-100, 100] (step in increments of 1).
|
|
*
|
|
* VPU_CTRL_ANAMORPHIC_SCALING: anamorphic scaling config, data: standard,
|
|
* value: [0, 100] (step in increments of 1).
|
|
*
|
|
* VPU_CTRL_DIRECTIONAL_INTERPOLATION: directional interpolation config
|
|
* data: standard, value: [0, 100] (step in increments of 1).
|
|
*
|
|
* VPU_CTRL_BACKGROUND_COLOR: , data: value,
|
|
* value: red[0:7] green[8:15] blue[16:23] alpha[24:31]
|
|
*
|
|
* VPU_CTRL_RANGE_MAPPING: Y/UV range mapping, data: range_mapping,
|
|
* y_range: [0, 7], uv_range: [0, 7] (step in increments of 1).
|
|
*
|
|
* VPU_CTRL_DEINTERLACING_MODE: deinterlacing mode, data: deinterlacing_mode,
|
|
* field_polarity: [0, 2], mvp_mode: [0, 2] (step in increments of 1).
|
|
*
|
|
* VPU_CTRL_ACTIVE_REGION_PARAM: active region detection parameters (set only)
|
|
* data: active_region_param,
|
|
*
|
|
* VPU_CTRL_ACTIVE_REGION_RESULT: detected active region roi (get only)
|
|
* data: active_region_result
|
|
*
|
|
* VPU_CTRL_PRIORITY: Session priority, data: value,
|
|
* value: high 100, normal 50
|
|
*
|
|
* VPU_CTRL_CONTENT_PROTECTION: input content protection status, data: value,
|
|
* value: secure 1, non-secure 0
|
|
*
|
|
* VPU_CTRL_DISPLAY_REFRESH_RATE: display refresh rate (set only)
|
|
* data: value (set to __u32 16.16 format)
|
|
*
|
|
* VPU_CTRL_HQV: hqv block config, data: hqv,
|
|
* sharpen_strength: [0, 100] (step in increments of 25),
|
|
* auto_nr_strength: [0, 100] (step in increments of 1).
|
|
*
|
|
* VPU_CTRL_HQV_SHARPEN: , data: value,
|
|
* sharpen_strength: [0, 100] (step in increments of 1).
|
|
*
|
|
* VPU_CTRL_HQV_AUTONR: , data: value,
|
|
* auto_nr_strength: [0, 100] (step in increments of 1).
|
|
*
|
|
* VPU_CTRL_ACE: , data: value
|
|
*
|
|
* VPU_CTRL_ACE_BRIGHTNESS: , data: value,
|
|
* value: [-100, 100] (step in increments of 1).
|
|
*
|
|
* VPU_CTRL_ACE_CONTRAST: , data: value,
|
|
* value: [-100, 100] (step in increments of 1).
|
|
*
|
|
* VPU_CTRL_2D3D: , data: value,
|
|
* value: 1 enabled, 0 disabled
|
|
*
|
|
* VPU_CTRL_2D3D_DEPTH: , data: value,
|
|
* value: [0, 100] (step in increments of 1).
|
|
*
|
|
* VPU_CTRL_TIMESTAMP_INFO_MODE: timestamp reporting mode,
|
|
* data: value specifying how frequent a timestamp reporting info, value
|
|
* is in frames
|
|
*
|
|
* VPU_INFO_TIMESTAMP: timestamp information (get only)
|
|
* data: struct vpu_frame_timestamp_info
|
|
*
|
|
* VPU_CTRL_FRC: enable/disable FRC, data: value,
|
|
* value: 1 enable, 0 disable
|
|
*
|
|
* VPU_CTRL_FRC_MOTION_SMOOTHNESS: , data: value,
|
|
* value: [0, 100] (step in increments of 1).
|
|
*
|
|
* VPU_CTRL_FRC_MOTION_CLEAR: , data: value,
|
|
* value: [0, 100] (step in increments of 1).
|
|
*
|
|
* VPU_CTRL_LATENCY: session latency, data: value in us
|
|
*
|
|
* VPU_CTRL_LATENCY_MODE: data: value (ultra low, low, etc.)
|
|
*
|
|
* VPU_INFO_STATISTICS: frames dropped, etc (get only),
|
|
* data: reserved
|
|
*/
|
|
#define VPU_CTRL_ID_MIN 0
|
|
|
|
#define VPU_CTRL_NOISE_REDUCTION 1
|
|
#define VPU_CTRL_IMAGE_ENHANCEMENT 2
|
|
#define VPU_CTRL_ANAMORPHIC_SCALING 3
|
|
#define VPU_CTRL_DIRECTIONAL_INTERPOLATION 4
|
|
#define VPU_CTRL_BACKGROUND_COLOR 5
|
|
#define VPU_CTRL_RANGE_MAPPING 6
|
|
#define VPU_CTRL_DEINTERLACING_MODE 7
|
|
#define VPU_CTRL_ACTIVE_REGION_PARAM 8
|
|
#define VPU_CTRL_ACTIVE_REGION_RESULT 9
|
|
#define VPU_CTRL_PRIORITY 10
|
|
#define VPU_CTRL_CONTENT_PROTECTION 11
|
|
#define VPU_CTRL_DISPLAY_REFRESH_RATE 12
|
|
|
|
#define VPU_CTRL_HQV 20
|
|
#define VPU_CTRL_HQV_SHARPEN 21
|
|
#define VPU_CTRL_HQV_AUTONR 22
|
|
#define VPU_CTRL_ACE 23
|
|
#define VPU_CTRL_ACE_BRIGHTNESS 24
|
|
#define VPU_CTRL_ACE_CONTRAST 25
|
|
#define VPU_CTRL_2D3D 26
|
|
#define VPU_CTRL_2D3D_DEPTH 27
|
|
#define VPU_CTRL_FRC 28
|
|
#define VPU_CTRL_FRC_MOTION_SMOOTHNESS 29
|
|
#define VPU_CTRL_FRC_MOTION_CLEAR 30
|
|
|
|
#define VPU_INFO_TIMESTAMP 35
|
|
#define VPU_CTRL_TIMESTAMP_INFO_MODE 36
|
|
#define VPU_INFO_STATISTICS 37
|
|
#define VPU_CTRL_LATENCY 38
|
|
#define VPU_CTRL_LATENCY_MODE 39
|
|
|
|
#define VPU_CTRL_ID_MAX 40
|
|
|
|
|
|
/*
|
|
* Extended VPU Controls (large data payloads)
|
|
*/
|
|
#define VPU_MAX_EXT_DATA_SIZE 720
|
|
struct vpu_control_extended {
|
|
/*
|
|
* extended control type
|
|
* 0: system
|
|
* 1: session
|
|
*/
|
|
__u32 type;
|
|
|
|
/*
|
|
* size and ptr of the data to send
|
|
* maximum VPU_MAX_EXT_DATA_SIZE bytes
|
|
*/
|
|
__u32 data_len;
|
|
void __user *data_ptr;
|
|
|
|
/*
|
|
* size and ptr of the buffer to recv data
|
|
* maximum VPU_MAX_EXT_DATA_SIZE bytes
|
|
*/
|
|
__u32 buf_size;
|
|
void __user *buf_ptr;
|
|
};
|
|
|
|
/*
|
|
* Port specific controls
|
|
*/
|
|
struct vpu_control_port {
|
|
__u32 control_id;
|
|
__u32 port; /* 0: INPUT, 1: OUTPUT */
|
|
union control_port_data {
|
|
__u32 framerate;
|
|
} data;
|
|
};
|
|
|
|
/*
|
|
* IDs for port controls (use in control_id field of struct vpu_control_port)
|
|
*
|
|
* VPU_CTRL_FPS: set frame rate, data: __u32, 16.16 format
|
|
*/
|
|
#define VPU_CTRL_FPS 1000
|
|
|
|
|
|
/*
|
|
* V P U D E V I C E P R I V A T E I O C T L C O D E S
|
|
*/
|
|
|
|
/* VPU Session ioctls (deprecated) */
|
|
#define VPU_ATTACH_TO_SESSION _IOW('V', (BASE_VIDIOC_PRIVATE + 1), int)
|
|
|
|
/* VPU Session ioctls */
|
|
#define VPU_QUERY_SESSIONS _IOR('V', (BASE_VIDIOC_PRIVATE + 0), int)
|
|
#define VPU_CREATE_SESSION _IOR('V', (BASE_VIDIOC_PRIVATE + 2), int)
|
|
#define VPU_JOIN_SESSION _IOW('V', (BASE_VIDIOC_PRIVATE + 3), int)
|
|
|
|
/* Enable second VPU output port and use with current client */
|
|
#define VPU_CREATE_OUTPUT2 _IO('V', (BASE_VIDIOC_PRIVATE + 5))
|
|
|
|
/* Explicit commit of session configuration */
|
|
#define VPU_COMMIT_CONFIGURATION _IO('V', (BASE_VIDIOC_PRIVATE + 10))
|
|
|
|
/* Flush all buffers of given type (port) */
|
|
#define VPU_FLUSH_BUFS _IOW('V', (BASE_VIDIOC_PRIVATE + 15), \
|
|
enum v4l2_buf_type)
|
|
|
|
/* VPU controls get/set ioctls (for most controls with small data) */
|
|
#define VPU_G_CONTROL _IOWR('V', (BASE_VIDIOC_PRIVATE + 20), \
|
|
struct vpu_control)
|
|
#define VPU_S_CONTROL _IOW('V', (BASE_VIDIOC_PRIVATE + 21), \
|
|
struct vpu_control)
|
|
|
|
/* extended control set/get ioctls (large data payloads) */
|
|
#define VPU_G_CONTROL_EXTENDED _IOWR('V', (BASE_VIDIOC_PRIVATE + 22), \
|
|
struct vpu_control_extended)
|
|
#define VPU_S_CONTROL_EXTENDED _IOW('V', (BASE_VIDIOC_PRIVATE + 23), \
|
|
struct vpu_control_extended)
|
|
|
|
/* VPU port (input/output) specific controls get/set ioctls */
|
|
#define VPU_G_CONTROL_PORT _IOWR('V', (BASE_VIDIOC_PRIVATE + 24), \
|
|
struct vpu_control_port)
|
|
#define VPU_S_CONTROL_PORT _IOW('V', (BASE_VIDIOC_PRIVATE + 25), \
|
|
struct vpu_control_port)
|
|
|
|
#endif /* _H_MSM_VPU_H_ */
|
|
|