|
|
/*
|
|
|
* Copyright (c) Hisilicon Technologies Co., Ltd. 2009-2020. All rights reserved.
|
|
|
* Description: Define the infomation about hdmi module.
|
|
|
* Author: Hisilicon
|
|
|
* Create: 2009-08-28
|
|
|
*/
|
|
|
|
|
|
#ifndef UAPI_HDMITX_H
|
|
|
#define UAPI_HDMITX_H
|
|
|
|
|
|
#include "uapi_cec.h"
|
|
|
#include "uapi_video.h"
|
|
|
|
|
|
#ifdef __cplusplus
|
|
|
#if __cplusplus
|
|
|
extern "C" {
|
|
|
#endif
|
|
|
#endif
|
|
|
|
|
|
#define UAPI_HDMITX_VENDOR_NAME_LEN 4
|
|
|
|
|
|
/*
|
|
|
* 3D video capibility bit definations
|
|
|
* CNcomment: 3D 能力位定义
|
|
|
*/
|
|
|
#define UAPI_HDMITX_3D_BZ_NONE 0
|
|
|
#define UAPI_HDMITX_3D_BZ_FRAME_PACKING (1 << 1)
|
|
|
#define UAPI_HDMITX_3D_BZ_FIELD_ALTERNATIVE (1 << 2)
|
|
|
#define UAPI_HDMITX_3D_BZ_LINE_ALTERNATIVE (1 << 3)
|
|
|
#define UAPI_HDMITX_3D_BZ_SIDE_BY_SIDE_FULL (1 << 4)
|
|
|
#define UAPI_HDMITX_3D_BZ_L_DEPTH (1 << 5)
|
|
|
#define UAPI_HDMITX_3D_BZ_L_DEPTH_GFX_GFX_DEPTH (1 << 6)
|
|
|
#define UAPI_HDMITX_3D_BZ_TOP_AND_BOTTOM (1 << 7)
|
|
|
#define UAPI_HDMITX_3D_BZ_SIDE_BY_SIDE_HALF (1 << 8)
|
|
|
|
|
|
/*
|
|
|
* UAPI_HDMITX_TIMING_FLAG flag definations
|
|
|
* CNcomment: 详细时序的标志位定义
|
|
|
*/
|
|
|
#define UAPI_HDMITX_TIMING_FLAG_NATIVE (1 << 0)
|
|
|
/*
|
|
|
* if bit is 1, the timing's vertical frequency is adjusted by a factor of 1000/1001
|
|
|
* CNcomment: 当bit为1时，则时序的垂直频率调整因子为1000/1001。
|
|
|
*/
|
|
|
#define UAPI_HDMITX_TIMING_FLAG_ALTERNATE_RATE (1 << 1)
|
|
|
|
|
|
/*
|
|
|
* Short Audio Descriptors max count, see CTA-861-G 7.5.2 Audio Data Block
|
|
|
* CNcomment: 简式音频描述符最大个数.见 CTA-861-G 7.5.2 Audio Data Block
|
|
|
*/
|
|
|
#define UAPI_HDMITX_MAX_AUDIO_CNT (0xe + 0x9)
|
|
|
|
|
|
/*
|
|
|
* Color format/depth(@u32ColorCap) flag definations
|
|
|
* CNcomment: 颜色格式/位宽能力标志位定义
|
|
|
*/
|
|
|
#define UAPI_HDMITX_COLOR_RGB_24 (1 << 0)
|
|
|
#define UAPI_HDMITX_COLOR_RGB_30 (1 << 1)
|
|
|
#define UAPI_HDMITX_COLOR_RGB_36 (1 << 2)
|
|
|
#define UAPI_HDMITX_COLOR_RGB_48 (1 << 3)
|
|
|
#define UAPI_HDMITX_COLOR_Y444_24 (1 << 4)
|
|
|
#define UAPI_HDMITX_COLOR_Y444_30 (1 << 5)
|
|
|
#define UAPI_HDMITX_COLOR_Y444_36 (1 << 6)
|
|
|
#define UAPI_HDMITX_COLOR_Y444_48 (1 << 7)
|
|
|
#define UAPI_HDMITX_COLOR_Y420_24 (1 << 8)
|
|
|
#define UAPI_HDMITX_COLOR_Y420_30 (1 << 9)
|
|
|
#define UAPI_HDMITX_COLOR_Y420_36 (1 << 10)
|
|
|
#define UAPI_HDMITX_COLOR_Y420_48 (1 << 11)
|
|
|
#define UAPI_HDMITX_COLOR_Y422 (1 << 12)
|
|
|
#define UAPI_HDMITX_COLOR_RGB_MASK (0xf << 0)
|
|
|
#define UAPI_HDMITX_COLOR_Y444_MASK (0xf << 4)
|
|
|
#define UAPI_HDMITX_COLOR_Y420_MASK (0xf << 8)
|
|
|
#define UAPI_HDMITX_COLOR_Y422_MASK (1 << 12)
|
|
|
|
|
|
/*
|
|
|
* HDCP re-authen defalut time, see uapi_hdmitx_hdcp_set_auth_times
|
|
|
* CNcomment: HDCP重认证默认时间
|
|
|
*/
|
|
|
#define UAPI_HDMITX_HDCP_REAUTH_DEFAULT 0xffffffff
|
|
|
|
|
|
/*
|
|
|
* Defines HDMITX interface ID
|
|
|
* CNcomment: 定义HDMITX 接口ID
|
|
|
*/
|
|
|
typedef enum {
|
|
|
UAPI_HDMITX_ID_0 = 0, /* HDMITX interface 0 */ /* CNcomment: HDMITX接口0 */
|
|
|
UAPI_HDMITX_ID_1 = 1, /* HDMITX interface 1 */ /* CNcomment: HDMITX接口1 */
|
|
|
UAPI_HDMITX_ID_MAX
|
|
|
} uapi_hdmitx_id;
|
|
|
|
|
|
/*
|
|
|
* Defines HDMITX event type
|
|
|
* CNcomment: 定义HDMITX事件类型
|
|
|
*/
|
|
|
typedef enum {
|
|
|
UAPI_HDMITX_EVENT_HOTPLUG_IN, /* HDMITX cable plug in */ /* CNcomment: HDMITX线缆插入 */
|
|
|
UAPI_HDMITX_EVENT_HOTPLUG_OUT, /* HDMITX cable plug out */ /* CNcomment: HDMITX线缆拔出 */
|
|
|
UAPI_HDMITX_EVENT_HDCP_CAP_CHANGE, /* HDCP capability change */ /* CNcomment: HDCP能力改变 */
|
|
|
UAPI_HDMITX_EVENT_HDCP_FAIL, /* HDCP authentication fail */ /* CNcomment: HDCP认证失败 */
|
|
|
UAPI_HDMITX_EVENT_HDCP_SUCCESS, /* HDCP authentication success */ /* CNcomment: HDCP认证成功 */
|
|
|
UAPI_HDMITX_EVENT_RSEN_CONNECT, /* HDMITX TMDS link connect */ /* CNcomment: TMDS链接成功 */
|
|
|
UAPI_HDMITX_EVENT_RSEN_DISCONNECT, /* HDMITX TMDS link is disconnect */ /* CNcomment: TMDS断开链接 */
|
|
|
UAPI_HDMITX_EVENT_LINK_TRAIN_FAIL, /* HDMITX FRL link training fail */ /* CNcomment: HDMITX固定码率链路训练失败 */
|
|
|
UAPI_HDMITX_EVENT_HDCP_KEY_LOST, /* HDMITX HDCP AUTH LOST HDCP1.4 KEY */ /* CNcomment: HDCP1.4 key 丢失 */
|
|
|
UAPI_HDMITX_EVENT_MAX
|
|
|
} uapi_hdmitx_event_type;
|
|
|
|
|
|
/*
|
|
|
* Defines event callback function interface
|
|
|
* CNcomment: 定义事件回调函数
|
|
|
*/
|
|
|
typedef td_void (*uapi_hdmitx_callback_ptr)(uapi_hdmitx_id id, uapi_hdmitx_event_type event,
|
|
|
td_void *private_data);
|
|
|
|
|
|
/*
|
|
|
* Defines HDMITX Callback Struct
|
|
|
* CNcomment: 定义HDMITX回调结构体类型
|
|
|
*/
|
|
|
typedef struct {
|
|
|
uapi_hdmitx_callback_ptr event_callback_func; /* callback function pointer */ /* CNcomment: 回调函数指针 */
|
|
|
td_void *private_data; /* callback funtion param */ /* CNcomment: 回调函数参数 */
|
|
|
} uapi_hdmitx_callback;
|
|
|
|
|
|
/*
|
|
|
* HDMITX hot plug status
|
|
|
* CNcomment: HDMITX 线缆拔插状态
|
|
|
*/
|
|
|
typedef enum {
|
|
|
UAPI_HDMITX_HOTPLUG_DETECTING, /* Hotplug is detecting */ /* CNcomment: 拔插状态检测中 */
|
|
|
UAPI_HDMITX_HOTPLUG_IN, /* Plug in */ /* CNcomment: 插入 */
|
|
|
UAPI_HDMITX_HOTPLUG_OUT, /* Plug out */ /* CNcomment: 拔出 */
|
|
|
UAPI_HDMITX_HOTPLUG_DET_FAIL, /* Hot plug detection failure */ /* CNcomment: 线缆拔插检测失效 */
|
|
|
} uapi_hdmitx_hotplug_status;
|
|
|
|
|
|
/*
|
|
|
* HDMITX TMDS link rsen status
|
|
|
* CNcomment: HDMITX TMDS链路的rsen状态
|
|
|
*/
|
|
|
typedef enum {
|
|
|
UAPI_HDMITX_RSEN_DISCONNECT, /* Rsen disconnect */ /* CNcomment: TMDS RSEN断开连接 */
|
|
|
UAPI_HDMITX_RSEN_CONNECT, /* Rsen connect */ /* CNcomment: TMDS RSEN链接成功 */
|
|
|
UAPI_HDMITX_RSEN_DET_FAIL, /* Rsen detection failure */ /* CNcomment: TMDS RSEN检测失效 */
|
|
|
} uapi_hdmitx_rsen_status;
|
|
|
|
|
|
/*
|
|
|
* HDMITX status
|
|
|
* CNcomment: HDMITX 状态
|
|
|
*/
|
|
|
typedef struct {
|
|
|
uapi_hdmitx_hotplug_status hotplug; /* HDMITX hot plug status */ /* CNcomment: hot plug状态 */
|
|
|
uapi_hdmitx_rsen_status rsen; /* HDMITX TMDS link rsen status */ /* CNcomment: TMDS链路的rsen状态 */
|
|
|
td_bool output_enable; /* HDMITX signal output enable status */ /* CNcomment: 信号输出使能状态 */
|
|
|
} uapi_hdmitx_status;
|
|
|
|
|
|
/*
|
|
|
* Sink colorimety capability infomation struct. see CTA-861-G
|
|
|
* CNcomment: Sink色域能力信息结构体, 请参考CTA-861-G
|
|
|
*/
|
|
|
typedef struct {
|
|
|
td_bool xvycc601; /* support xvYCC601, Standard Definition Colorimetry based on IEC 61966-2-4 [5 ]
|
|
|
* CNcomment: 支持xvYCC601，基于IEC 61966-2-4 [5]的标准定义色域 */
|
|
|
td_bool xvycc709; /* support xvYCC709, High Definition Colorimetry based on IEC 61966-2-4 [5 ]
|
|
|
* CNcomment: 支持xvYCC709，基于IEC 61966-2-4 [5]的高清色域 */
|
|
|
td_bool sycc601; /* Colorimetry based on IEC 61966-2-1/Amendment 1 [34]
|
|
|
* CNcomment: 色域设置基于 IEC 61966-2-1/Amendment 1 [34] */
|
|
|
td_bool adobe_ycc601; /* Colorimetry based on IEC 61966-2-5 [32], Annex A
|
|
|
* CNcomment: 色域设置基于 IEC 61966-2-5 [32], Annex A */
|
|
|
td_bool adobe_rgb; /* Colorimetry based on IEC 61966-2-5 [32]
|
|
|
* CNcomment: 色域设置基于 IEC 61966-2-5 [32] */
|
|
|
td_bool bt2020_c_ycc; /* Colorimetry based on ITU-R BT.2020 [39] Y'cC'bcC'rc
|
|
|
* CNcomment: 色域设置基于 ITU-R BT.2020 [39] Y'cC'bcC'rc */
|
|
|
td_bool bt2020_ycc; /* Colorimetry based on ITU-R BT.2020 [39] Y'C'BC'R
|
|
|
* CNcomment: 色域设置基于 ITU-R BT.2020 [39] Y'C'BC'R */
|
|
|
td_bool bt2020_rgb; /* Colorimetry based on ITU-R BT.2020 [39] R'G'B'
|
|
|
* CNcomment: 色域设置基于 ITU-R BT.2020 [39] R'G'B' */
|
|
|
td_bool dci_p3; /* Colorimetry based on DCI-P3 [51][52] */ /* CNcomment: 色域设置基于 DCI-P3 [51][52] */
|
|
|
} uapi_hdmitx_colorimetry;
|
|
|
|
|
|
/*
|
|
|
* Sink manufacture infomation struct
|
|
|
* CNcomment: Sink 制造信息结构体
|
|
|
*/
|
|
|
typedef struct {
|
|
|
td_u8 mfrs_name[UAPI_HDMITX_VENDOR_NAME_LEN]; /* manufacture name */ /* CNcomment: 制造名字 */
|
|
|
td_u32 product_code; /* product code */ /* CNcomment: 产品代码 */
|
|
|
td_u32 serial_number; /* serial numeber of manufacture */ /* CNcomment: 制造的序列号 */
|
|
|
td_u32 week; /* the week of manufacture */ /* CNcomment: 生产周 */
|
|
|
td_u32 year; /* the year of manufacture */ /* CNcomment: 制造的年限 */
|
|
|
} uapi_hdmitx_manufacture_info;
|
|
|
|
|
|
/*
|
|
|
* Define sdetail timing information
|
|
|
* CNcomment: 详细时序信息定义
|
|
|
*/
|
|
|
typedef struct {
|
|
|
td_u32 pixel_clock; /* pixel clock */ /* CNcomment: 像素时钟 */
|
|
|
td_bool progressive; /* if ture, the timing is a progressive format; or it is a interlaced format */
|
|
|
/* CNcomment: 如果true，则时序为逐行输出格式；或者为隔行输出格式 */
|
|
|
td_u32 field_rate; /* field rate */ /* CNcomment: 场速率 */
|
|
|
td_u32 h_active; /* horizontal active */ /* CNcomment: 水平活动区域 */
|
|
|
td_u32 h_total; /* horizontal total */ /* CNcomment: 水平计数 */
|
|
|
td_u32 h_blank; /* horizontal blank */ /* CNcomment: 水平空白区域 */
|
|
|
td_u32 h_front; /* horizontal front */ /* CNcomment: 水平前消隐 */
|
|
|
td_u32 h_sync; /* horizontal sync pulse */ /* CNcomment: 水平同步脉冲 */
|
|
|
td_u32 h_back; /* horizontal back */ /* CNcomment: 水平后消隐 */
|
|
|
td_bool h_pol; /* horizontal polarity, true for positive, false for negative */
|
|
|
/* CNcomment: 水平极性，正为真，负为假 */
|
|
|
td_u32 v_active; /* vertical active */ /* CNcomment: 垂直活动区域 */
|
|
|
td_u32 v_total; /* vertical total */ /* CNcomment: 垂直计数 */
|
|
|
td_u32 v_blank; /* vertical blank */ /* CNcomment: 垂直空白区域 */
|
|
|
td_u32 v_front; /* vertical front */ /* CNcomment: 垂直前消隐 */
|
|
|
td_u32 v_sync; /* vertical sync pulse */ /* CNcomment: 垂直同步脉冲 */
|
|
|
td_u32 v_back; /* vertical back */ /* CNcomment: 垂直后消隐 */
|
|
|
td_bool v_pol; /* vertical polarity, true for positive, false for negative */
|
|
|
/* CNcomment: 垂直极性，正为真，负为假 */
|
|
|
uapi_video_aspect_ratio pic_asp_ratio; /* see picture aspect ratio definations */
|
|
|
/* CNcomment: 见画面纵横比定义 */
|
|
|
td_u32 flag; /* see UAPI_HDMITX_TIMING_FLAG_XXX definations */
|
|
|
/* CNcomment: 见相关UAPI_HDMITX_TIMING_FLAG_XXX 宏定义 */
|
|
|
td_u32 mode_3d; /* see 3D video capibility bit definations, UAPI_HDMITX_3D_BZ_XXX */
|
|
|
/* CNcomment: 见3D视频能力位定义，UAPI_HDMITX_3D_BZ_XXX */
|
|
|
} uapi_hdmitx_detail_timing;
|
|
|
|
|
|
/*
|
|
|
* available mode information
|
|
|
* CNcomment: 有效制式模式信息
|
|
|
*/
|
|
|
typedef struct {
|
|
|
td_u32 vic; /* Video ID Code */ /* CNcomment: 视频ID编码 */
|
|
|
uapi_hdmitx_detail_timing detail_timing; /* see detail timing information */ /* CNcomment: 详细时序信息定义 */
|
|
|
td_u32 color_cap; /* see Color format/depth(@u32ColorCap) flag definations */
|
|
|
/* CNcomment: 见颜色格式/深度（@u32ColorCap）标志定义 */
|
|
|
} uapi_hdmitx_avail_mode;
|
|
|
|
|
|
/*
|
|
|
* available capability information
|
|
|
* CNcomment: 有效能力信息
|
|
|
*/
|
|
|
typedef struct {
|
|
|
uapi_hdmitx_avail_mode native_mode; /* the native mode */ /* CNcomment: 最佳模式 */
|
|
|
uapi_hdmitx_avail_mode max_mode; /* the max resolution & field rate mode */
|
|
|
/* CNcomment: 最大分辨率&场速率模式 */
|
|
|
td_u32 mode_cnt; /* avail modes count */ /* CNcomment: 有效模式计数 */
|
|
|
td_u32 max_tmds_clock; /* max tmds clock */ /* CNcomment: 最大的TMDS时钟 */
|
|
|
td_bool dvi_only; /* If true, this sink only supports DVI mode else support HDMITX mode and DVI mode */
|
|
|
/* CNcomment: 如果为真，则对端只支持DVI模式，否则支持HDMITX模式和DVI模式 */
|
|
|
} uapi_hdmitx_avail_cap;
|
|
|
|
|
|
/*
|
|
|
* EDID latency capability, see <hdmi1.4b> page154
|
|
|
* CNcomment: Sink 音视频延时能力结构体, 请参考hdmi1.4b 的154页
|
|
|
*/
|
|
|
typedef struct {
|
|
|
td_bool present; /* latency info is valid. */ /* CNcomment: 时延信息有效. */
|
|
|
td_u32 p_video; /* video latency for progressive video formats.in milliseconds */
|
|
|
/* CNcomment: 逐行视频格式的视频延迟，以毫秒为单位 */
|
|
|
td_u32 p_audio; /* audio latency for progressive video formats.in milliseconds */
|
|
|
/* CNcomment: 逐行视频格式的音频延迟，以毫秒为单位 */
|
|
|
td_u32 i_video; /* video latency for interlaced video formats.in milliseconds */
|
|
|
/* CNcomment: 隔行扫描视频格式的视频延迟。以毫秒为单位 */
|
|
|
td_u32 i_audio; /* audio latency for interlaced video formats.in milliseconds */
|
|
|
/* CNcomment: 隔行扫描视频格式的音频延迟。以毫秒为单位 */
|
|
|
} uapi_hdmitx_latency;
|
|
|
|
|
|
/*
|
|
|
* EDID max display parameters struct
|
|
|
* CNcomment: Sink 最大显示尺寸结构体
|
|
|
*/
|
|
|
typedef struct {
|
|
|
td_u8 max_image_width; /* the disp image max width (0~255)cm */ /* CNcomment: 色散图像最大宽度(0~255)cm */
|
|
|
td_u8 max_image_height; /* the disp image max height (0~255)cm */ /* CNcomment: 色散图像最大高度(0~255)cm */
|
|
|
} uapi_hdmitx_disp_para;
|
|
|
|
|
|
/*
|
|
|
* Defines eotf capability struct
|
|
|
* CNcomment: 定义eotf能力结构体
|
|
|
*/
|
|
|
typedef struct {
|
|
|
td_bool traditional_sdr; /* Traditional gamma - SDR Luminance Range */ /* CNcomment: 传统伽玛-SDR亮度范围 */
|
|
|
td_bool traditional_hdr; /* Traditional gamma - HDR Luminance Range */ /* CNcomment: 传统伽玛-HDR亮度范围 */
|
|
|
td_bool hdr10; /* HDR10(SMPTE ST 2084) */ /* CNcomment:HDMT HDR的HDR10模式 */
|
|
|
td_bool hlg; /* Hybrid Log-Gamma */ /* CNcomment: HDMT HDR的HLG模式(混合对数伽玛) */
|
|
|
} uapi_hdmitx_eotf;
|
|
|
|
|
|
/*
|
|
|
* Sink HDR dynamic metadata type
|
|
|
* CNcomment: Sink 动态元数据能力结构体
|
|
|
*/
|
|
|
typedef struct {
|
|
|
td_bool d_type1_support; /* type1 dynamic metadata support */ /* CNcomment: type1动态元数据支持 */
|
|
|
td_u32 d_type1_version; /* type1 dynamic metadata version */ /* CNcomment: type1动态元数据版本 */
|
|
|
td_bool d_type2_support; /* type2 dynamic metadata support */ /* CNcomment: type2动态元数据支持 */
|
|
|
td_u32 d_type2_version; /* type2 dynamic metadata version */ /* CNcomment: type2动态元数据版本 */
|
|
|
td_bool d_type3_support; /* type3 dynamic metadata support */ /* CNcomment: type3动态元数据支持 */
|
|
|
td_bool d_type4_support; /* type4 dynamic metadata support */ /* CNcomment: type4动态元数据支持 */
|
|
|
td_u32 d_type4_version; /* type_4_hdr_metadata_version */ /* CNcomment: type4动态元数据版本 */
|
|
|
} uapi_hdmitx_dynamic_metadata;
|
|
|
|
|
|
/*
|
|
|
* Sink HDR static metadata type
|
|
|
* CNcomment: Sink 静态元数据能力结构体
|
|
|
*/
|
|
|
typedef struct {
|
|
|
td_bool stype1; /* Static Metadata Type 1 support */ /* CNcomment: 静态元数据Type1支持 */
|
|
|
td_u8 max_lum_cv; /* Desired Content Max Luminance Data. Real value(in 1cd/m^2) = 50.2^(CV/32) */
|
|
|
/* CNcomment: 期望的内容最大亮度数据 */
|
|
|
td_u8 aver_lum_cv; /* Desired Content Max Frame-average Luminance. Real value(in 1cd/m^2) = 50.2^(CV/32) */
|
|
|
/* CNcomment: 所需内容最大帧平均亮度 */
|
|
|
td_u8 min_lum_cv; /* Desired Content Min Luminance Data.
|
|
|
* Real value(in 1cd/m^2) = MaxLuminance_CV * (MinLuminance_CV/255)^2 / 100 */
|
|
|
/* CNcomment: 所需内容最小亮度数据。 */
|
|
|
} uapi_hdmitx_static_metadata;
|
|
|
|
|
|
/*
|
|
|
* Sink HDR capability struct
|
|
|
* CNcomment: Sink HDR能力结构体
|
|
|
*/
|
|
|
typedef struct {
|
|
|
uapi_hdmitx_eotf eotf;
|
|
|
uapi_hdmitx_static_metadata static_metadata; /* HDR Static Metadata Type */ /* CNcomment: HDR静态元数据类型 */
|
|
|
uapi_hdmitx_dynamic_metadata dynamic_metadata; /* HDR Dynamic Metadata Type */ /* CNcomment: HDR动态元数据类型 */
|
|
|
} uapi_hdmitx_hdr_info;
|
|
|
|
|
|
/*
|
|
|
* EDID dolby vision capability ,for version 0
|
|
|
* CNcomment: Sink dolby vision能力结构体(版本0)
|
|
|
*/
|
|
|
typedef struct {
|
|
|
td_bool ycbcr422_12bit; /* support(true) or not support(false) a YCbCr422-12Bit dolby singal */
|
|
|
/* CNcomment: 支持(true)或不支持(false)YCbCr422-12bit杜比信号 */
|
|
|
td_bool cap_2160p60; /* capable of processing a max timming 3840X2160p60(true)/3840X2160p30(false) */
|
|
|
/* CNcomment: 能够处理最大时序3840X2160p60（真）/3840X2160p30（假） */
|
|
|
td_bool global_dimming; /* support(true) or not support(false) global dimming. */
|
|
|
/* CNcomment: 支持(true)或不支持(false)全局调光功能 */
|
|
|
td_u16 white_x; /* white point chromaticity coordinate x, bit[11:0] valid. bit[11:0] valid.
|
|
|
* Real value = SUM OF bit[N]*2^-(12-N) */
|
|
|
/* CNcomment: 白点色度坐标x，bit[11:0]有效。bit[11:0]有效。 */
|
|
|
td_u16 white_y; /* white point chromaticity coordinate y, bit[11:0] valid. bit[11:0] valid.
|
|
|
* Real value = SUM OF bit[N]*2^-(12-N) */
|
|
|
/* CNcomment: 白点色度坐标y，bit[11:0]有效。bit[11:0]有效。 */
|
|
|
td_u8 dm_major_ver; /* the major version of display management implemented. */
|
|
|
/* CNcomment: 显示器管理实施的主要版本 */
|
|
|
td_u8 dm_minor_ver; /* the minor version of display management implemented. */
|
|
|
/* CNcomment: 显示器管理实施的次要版本 */
|
|
|
td_u16 target_min_pq; /* Perceptual quantization(PQ)-encoded value of minimum display luminance */
|
|
|
/* CNcomment: PQ（感知量化）编码的最小显示亮度值 */
|
|
|
td_u16 target_max_pq; /* PQ-encoded value of maximum display luminance */
|
|
|
/* CNcomment: PQ编码的最大显示亮度值 */
|
|
|
td_u16 red_x; /* red primary chromaticity coordinate x, bit[11:0] valid. Real value =SUM OF bit[N]*2^-(12-N) */
|
|
|
/* CNcomment: 红色主色坐标x，bit[11:0]有效. 实际值=SUM of bit[N]*2^-(12-N) */
|
|
|
td_u16 red_y; /* red primary chromaticity coordinate y, bit[11:0] valid. Real value =SUM OF bit[N]*2^-(12-N) */
|
|
|
/* CNcomment: 红色主色坐标y，bit[11:0]有效. 实际值=SUM of bit[N]*2^-(12-N) */
|
|
|
td_u16 green_x; /* green primary chromaticity coordinate x, bit[11:0] valid. Real value =SUM OF bit[N]*2^-(12-N) */
|
|
|
/* CNcomment: 绿色主色坐标x，bit[11:0]有效. 实际值=SUM of bit[N]*2^-(12-N) */
|
|
|
td_u16 green_y; /* green primary chromaticity coordinate y, bit[11:0] valid. Real value =SUM OF bit[N]*2^-(12-N) */
|
|
|
/* CNcomment: 绿色主色坐标y，bit[11:0]有效. 实际值=SUM of bit[N]*2^-(12-N) */
|
|
|
td_u16 blue_x; /* blue primary chromaticity coordinate x, bit[11:0] valid. Real value =SUM OF bit[N]*2^-(12-N) */
|
|
|
/* CNcomment: 蓝色主色坐标x，bit[11:0]有效. 实际值=SUM of bit[N]*2^-(12-N) */
|
|
|
td_u16 blue_y; /* blue primary chromaticity coordinate y, bit[11:0] valid. Real value =SUM OF bit[N]*2^-(12-N) */
|
|
|
/* CNcomment: 蓝色主色坐标y，bit[11:0]有效. 实际值=SUM of bit[N]*2^-(12-N) */
|
|
|
} uapi_hdmitx_dolby_v0;
|
|
|
|
|
|
/*
|
|
|
* EDID dolby vision capability ,for version 1
|
|
|
* CNcomment: Sink dolby vision能力结构体(版本1)
|
|
|
*/
|
|
|
typedef struct {
|
|
|
td_bool ycbcr422_12bit; /* support or not YCbCr422-12Bit dolby singal; For low-latency this flag is ingnored */
|
|
|
/* CNcomment: 是否支持YCbCr422-12bit杜比信号；低延时时, 该标志被忽略 */
|
|
|
td_bool cap_2160p60; /* capable of processing a max timming 3840X2160p60/3840X2160p30 */
|
|
|
/* CNcomment: 能够处理的最大时序3840X2160p60/3840X2160p30 */
|
|
|
td_bool global_dimming; /* support(true) or not support(false) global dimming. */
|
|
|
/* CNcomment: 支持(true)或不支持(false)全局调光功能 */
|
|
|
td_bool colorimetry; /* 0: Dolby Vision HDMI sink's colorimetry is close to Rec.709,
|
|
|
* 1: EDR HDMI sink's colorimetry is close to P3,if Byte[9] to Byte[14] are present,
|
|
|
* ignores this bit. */
|
|
|
/* CNcomment: 0: 杜比Vision HDMI Sink的色域接近Rec.709
|
|
|
* 1: EDR HDMI sink端色域接近P3，如果Byte[9]到Byte[14]存在，忽略此位. */
|
|
|
td_u8 dm_version; /* 0: based on display management v2.x;
|
|
|
* 1: based on the video and blending pipeline v3.x;
|
|
|
* 2-7: reserved. */
|
|
|
/* CNcomment: 0：基于显示管理v2.x；
|
|
|
* 1：基于视频和混合管道 v3.x；
|
|
|
* 2-7：保留. */
|
|
|
td_u8 low_latency; /* 0: Supports only standard Dolby Vison;
|
|
|
* 1: Supports low latency with 12-bit YCbCr 4:2:2 interface;
|
|
|
* 2-3: reserved */
|
|
|
/* CNcomment: 0：只支持标准的杜比版本；
|
|
|
* 1：支持12bit YCbCr 4:2:2接口的低时延；
|
|
|
* 2-3：保留 */
|
|
|
td_u16 target_min_lum; /* minimum display luminance = (100+50*CV)cd/m2, where CV is the value */
|
|
|
/* CNcomment: 显示最小亮度=(100+50*CV)cd/m2，其中CV为数值 */
|
|
|
td_u16 target_max_lum; /* maximum display luminance = (CV/127)^2cd/m2, where CV is the value */
|
|
|
/* CNcomment: 显示最大亮度=(CV/127)^2cd/m2，其中CV为数值 */
|
|
|
td_u16 red_x; /* red primary chromaticity coordinate x, bit[11:0] valid. Real value = SUM OF bit[N]*2^-(12-N) */
|
|
|
/* CNcomment: 红色主色坐标x，bit[11:0]有效. 实际值=SUM of bit[N]*2^-(12-N) */
|
|
|
td_u16 red_y; /* red primary chromaticity coordinate y, bit[11:0] valid. Real value = SUM OF bit[N]*2^-(12-N) */
|
|
|
/* CNcomment: 红色主色坐标y，bit[11:0]有效. 实际值=SUM of bit[N]*2^-(12-N) */
|
|
|
td_u16 green_x; /* green primary chromaticity coordinate x, bit[11:0] valid. Real value = SUM OF bit[N]*2^-(12-N) */
|
|
|
/* CNcomment: 绿色主色坐标x，bit[11:0]有效. 实际值=SUM of bit[N]*2^-(12-N) */
|
|
|
td_u16 green_y; /* green primary chromaticity coordinate y, bit[11:0] valid. Real value = SUM OF bit[N]*2^-(12-N) */
|
|
|
/* CNcomment: 绿色主色坐标y，bit[11:0]有效. 实际值=SUM of bit[N]*2^-(12-N) */
|
|
|
td_u16 blue_x; /* blue primary chromaticity coordinate x, bit[11:0] valid. Real value = SUM OF bit[N]*2^-(12-N) */
|
|
|
/* CNcomment: 蓝色主色坐标x，bit[11:0]有效. 实际值=SUM of bit[N]*2^-(12-N) */
|
|
|
td_u16 blue_y; /* blue primary chromaticity coordinate y, bit[11:0] valid. Real value = SUM OF bit[N]*2^-(12-N) */
|
|
|
/* CNcomment: 蓝色主色坐标y，bit[11:0]有效. 实际值=SUM of bit[N]*2^-(12-N) */
|
|
|
} uapi_hdmitx_dolby_v1;
|
|
|
|
|
|
/*
|
|
|
* EDID dolby vision capability ,for version 2
|
|
|
* CNcomment: Sink dolby vision能力结构体(版本2)
|
|
|
*/
|
|
|
typedef struct {
|
|
|
td_bool ycbcr422_12bit; /* support(true) or not support(false) a YCbCr422-12Bit dolby singal */
|
|
|
/* CNcomment: 支持(true)或不支持(false) YCbCr422-12bit杜比信号 */
|
|
|
td_bool back_light_ctrl; /* supports Backlight Control */
|
|
|
/* CNcomment: 支持背光控制 */
|
|
|
td_bool global_dimming; /* support(true) or not support(false) global dimming. */
|
|
|
/* CNcomment: 支持(true)或不支持(false)全局调光功能 */
|
|
|
td_u8 dm_version; /* 0:based on display management v2.x;
|
|
|
* 1:based on the video and blending pipeline v3.x;
|
|
|
* 2-7: reserved. only support when u8VSVDBVersion = 1. */
|
|
|
/* CNcomment: 0：基于显示管理v2.x；
|
|
|
* 1：基于视频，混合管道 v3.x；
|
|
|
* 2-7：保留。仅当u8VSVDBVersion=1时支持。 */
|
|
|
td_u8 back_lt_min_lum; /* minimum luminance level 0:25cd/m2 1:50cd/m2 2:75cd/m2 3:100cd/m2 */
|
|
|
/* CNcomment: 最小亮度等级0:25cd/m2 1:50cd/m2 2:75cd/m2 3:100cd/m2 */
|
|
|
td_u8 interface; /* 0:support only "low latency with YCbCr422"
|
|
|
* 1:support both "low latency with YCbCr422" and YCbCr444/RGB_10/12bit*
|
|
|
* 2:support both "standard DolbyVision" and "low latency with YCbCr422"
|
|
|
* 3:support "standard DolbyVision" "low latency YCbCr422 YCbCr444/RGB_10/12bit" */
|
|
|
/* CNcomment: 0：只支持“低延时YCbCr422”
|
|
|
* 1：同时支持YCbCr422的低时延和YCbCr444/RGB_10/12bit*
|
|
|
* 2：同时支持“标准DolbyVision”和“YCbCr422低延时”
|
|
|
* 3：支持“标准杜比视觉”“低延时YCbCr422 YCbCr444/RGB_10/12bit” */
|
|
|
td_u8 y444_rgb_10b12b; /* 0:not support 1:Support YCbCr444/RGB444_10bit 2:YCbCr444/RGB444_12bit 3:reserved */
|
|
|
/* CNcomment: 0：不支持; 1：支持YCbCr444/RGB444_10bit; 2：支持YCbCr444/RGB444_12bit;
|
|
|
* 3：保留 */
|
|
|
td_u16 target_min_pq_v2; /* maximum display luminance, in the PQ-encoded value= 2055+target_max_pq_v2*65. */
|
|
|
/* CNcomment: 最大显示亮度，PQ编码值=2055+target_max_pq_v2*65. */
|
|
|
td_u16 target_max_pq_v2; /* minimum display luminance, in the PQ-encoded value= 2055+target_max_pq_v2*65. */
|
|
|
/* CNcomment: 最小显示亮度，PQ编码值=2055+target_max_pq_v2*65. */
|
|
|
td_u16 red_x; /* red primary chromaticity coordinate x, bit[11:0] valid. Real value =SUM OF bit[N]*2^-(12-N) */
|
|
|
/* CNcomment: 红色主色坐标x，bit[11:0]有效. 实际值=SUM of bit[N]*2^-(12-N) */
|
|
|
td_u16 red_y; /* red primary chromaticity coordinate y, bit[11:0] valid. Real value =SUM OF bit[N]*2^-(12-N) */
|
|
|
/* CNcomment: 红色主色坐标y，bit[11:0]有效. 实际值=SUM of bit[N]*2^-(12-N) */
|
|
|
td_u16 green_x; /* green primary chromaticity coordinate x, bit[11:0] valid. Real value =SUM OF bit[N]*2^-(12-N) */
|
|
|
/* CNcomment: 绿色主色坐标x，bit[11:0]有效. 实际值=SUM of bit[N]*2^-(12-N) */
|
|
|
td_u16 green_y; /* green primary chromaticity coordinate y, bit[11:0] valid. Real value =SUM OF bit[N]*2^-(12-N) */
|
|
|
/* CNcomment: 绿色主色坐标y，bit[11:0]有效. 实际值=SUM of bit[N]*2^-(12-N) */
|
|
|
td_u16 blue_x; /* blue primary chromaticity coordinate x, bit[11:0] valid. Real value =SUM OF bit[N]*2^-(12-N) */
|
|
|
/* CNcomment: 蓝色主色坐标x，bit[11:0]有效. 实际值=SUM of bit[N]*2^-(12-N) */
|
|
|
td_u16 blue_y; /* blue primary chromaticity coordinate y, bit[11:0] valid. Real value =SUM OF bit[N]*2^-(12-N) */
|
|
|
/* CNcomment: 蓝色主色坐标y，bit[11:0]有效 */
|
|
|
} uapi_hdmitx_dolby_v2;
|
|
|
|
|
|
/*
|
|
|
* EDID dolby vision capability
|
|
|
* CNcomment: Sink dolby vision能力结构体
|
|
|
*/
|
|
|
typedef struct {
|
|
|
td_bool support_v0; /* V0 support */ /* CNcomment: V0支持 */
|
|
|
td_bool support_v1; /* V1 support */ /* CNcomment: V1支持 */
|
|
|
td_bool support_v2; /* V2 support */ /* CNcomment: V2支持 */
|
|
|
uapi_hdmitx_dolby_v0 v0; /* V0 detail */ /* CNcomment: V0详细能力 */
|
|
|
uapi_hdmitx_dolby_v1 v1; /* V1 detail */ /* CNcomment: V1详细能力 */
|
|
|
uapi_hdmitx_dolby_v2 v2; /* V2 detail */ /* CNcomment: V2详细能力 */
|
|
|
} uapi_hdmitx_dolby_info;
|
|
|
|
|
|
/*
|
|
|
* Sink VRR capability, see Spec HDMITX2.1 Table 10-6
|
|
|
* CNcomment: Sink VRR能力结构体,见协议HDMITX2.1 Table 10-6
|
|
|
*/
|
|
|
typedef struct {
|
|
|
td_bool fva;
|
|
|
td_bool cnm_vrr;
|
|
|
td_bool cinema_vrr;
|
|
|
td_bool m_delta;
|
|
|
td_bool fapa_start_locat;
|
|
|
td_bool allm;
|
|
|
td_u16 vrr_min;
|
|
|
td_u16 vrr_max;
|
|
|
} uapi_hdmitx_vrr_info;
|
|
|
|
|
|
/*
|
|
|
* Sink cuva capability.
|
|
|
* CNcomment: Sink CUVA能力结构体
|
|
|
*/
|
|
|
typedef struct {
|
|
|
td_u8 system_start_code; /* support version code. */ /* CNcomment: 支持的CUVA版本号 */
|
|
|
td_u8 version_code; /* support HDMI version code. */ /* CNcomment: 支持HDMI系统版本号 */
|
|
|
td_u32 display_max_lum; /* display maximum luminance. max display is display_max_lum/10000. */
|
|
|
/* CNcomment: 支持的最大显示亮度. max display最终值是display_max_lum/10000. */
|
|
|
td_u32 display_min_lum; /* display minimum luminance. min display is display_min_lum/10000. */
|
|
|
/* CNcomment: 支持的最小显示亮度. min display最终值是display_min_lum/10000. */
|
|
|
td_bool monitor_mode_support; /* monitor mode support. */ /* CNcomment: 显示终端对监视器适配模式的支持能力 */
|
|
|
td_bool rx_mode_support; /* rx mode support. */ /* CNcomment: 显示终端对接收端适配模式的支持能力 */
|
|
|
} uapi_hdmitx_cuva_info;
|
|
|
|
|
|
/*
|
|
|
* Sink speaker capability,see CTA-861-G Page 104
|
|
|
* CNcomment: Sink 扬声器能力结构体,参考CTA-861-G 104页
|
|
|
*/
|
|
|
typedef struct {
|
|
|
td_bool fl_fr; /* Front Left and Front Right(FL/FR) */ /* CNcomment: 左前、右前(FL/FR) */
|
|
|
td_bool lfe; /* Low Frequency Effect(LFE) */ /* CNcomment: 低频效应(LFE) */
|
|
|
td_bool fc; /* Front Center(FC) */ /* CNcomment: 前部中心(FC) */
|
|
|
td_bool rl_rr; /* Rear Left and Rear Right(RL/RR) */ /* CNcomment: 左后右后(RL/RR) */
|
|
|
td_bool rc; /* Rear Center(RC) */ /* CNcomment: 后部中心(FC) */
|
|
|
td_bool flc_frc; /* Front Left Center and Front Right Center(FLC/FRC) */ /* CNcomment: 前左中和前右中(FLC/FRC) */
|
|
|
td_bool rlc_rrc; /* Front Left Center and Rear Right Center(FLC/RRC) */ /* CNcomment: 前左中 后右中(FLC/RRC) */
|
|
|
td_bool flw_frw; /* Front Left Wide and Front Right Wide(FLW/FRW) */ /* CNcomment: 左前宽右前宽(FLW/FRW) */
|
|
|
td_bool flh_frh; /* Front Left High and Front Right High(FLH/FRH) */ /* CNcomment: 左前高右前高(FLH/FRH) */
|
|
|
td_bool tc; /* Top Center(TC) */ /* CNcomment: 顶部中心(TC) */
|
|
|
td_bool fch; /* Front Center High(FCH) */ /* CNcomment: 前部中心高配(FCH) */
|
|
|
} uapi_hdmitx_audio_speaker;
|
|
|
|
|
|
/*
|
|
|
* Short Audio Descriptors. see CTA-861-G 7.5.2 Audio Data Block
|
|
|
* CNcomment: 简式音频描述符.见 CTA-861-G 7.5.2 Audio Data Block
|
|
|
*/
|
|
|
typedef struct {
|
|
|
td_u32 fmt_code; /* Audio Format Code */ /* CNcomment: 音频格式编码 */
|
|
|
td_u32 ext_code; /* Audio Coding Extension Type Code */ /* CNcomment: 音频编码扩展类型编码 */
|
|
|
td_u32 max_channel; /* Max Number of channels. Audio Format Code 1 to 14; Audio Coding Extension Type Codes 4 to 6,
|
|
|
* 8 to 10; Audio Coding Extension Type 0x0D (L-PCM 3D Audio), bits MC4:MC0 */
|
|
|
/* CNcomment: 最大通道数。音频格式编码1~14；音频编码扩展类型编码4~6，8~10；
|
|
|
* 音频编码扩展类型0x0D（L-PCM 3D音频），bits MC4:MC0 */
|
|
|
td_bool samp_32k;
|
|
|
td_bool samp_44p1k;
|
|
|
td_bool samp_48k;
|
|
|
td_bool samp_88p2k;
|
|
|
td_bool samp_96k;
|
|
|
td_bool samp_176p4k;
|
|
|
td_bool samp_192k;
|
|
|
td_bool width_16; /* 16bit.Only to Audio Format Code = 1 (L-PCM) & Audio Extension Type Code 13 (L-PCM 3D Audio) */
|
|
|
/* CNcomment: 16bit. 仅音频格式编码=1 (L-PCM) &音频扩展类型编码13 （L-PCM 3D音频） */
|
|
|
td_bool width_20; /* 20bit.Only to Audio Format Code = 1 (L-PCM) & Audio Extension Type Code 13 (L-PCM 3D Audio) */
|
|
|
/* CNcomment: 20bit. 仅音频格式编码=1 (L-PCM) &音频扩展类型编码13 （L-PCM 3D音频） */
|
|
|
td_bool width_24; /* 24bit.Only to Audio Format Code = 1 (L-PCM) & Audio Extension Type Code 13 (L-PCM 3D Audio) */
|
|
|
/* CNcomment: 24bit. 仅音频格式编码=1 (L-PCM) &音频扩展类型编码13 （L-PCM 3D音频） */
|
|
|
td_u32 max_bit_rate; /* Maximum bit rate in Hz.Only to Audio Format Codes 2 to 8 */
|
|
|
/* CNcomment: 最大比特率(hz). 仅限音频格式代码2到8 */
|
|
|
td_u32 dependent; /* Audio Format Code dependent value.Only to Audio Format Codes 9 to 13 */
|
|
|
/* CNcomment: 音频格式代码依赖值. 仅针对音频格式代码9到13 */
|
|
|
td_u32 profile; /* Profile. Only to Audio Format Codes 14 (WMA pro) */
|
|
|
/* CNcomment: 配置文件. 只对音频格式编码14(WMA pro) */
|
|
|
td_bool len_1024tl; /* 1024_TL. AAC audio frame lengths 1024_TL. Only to extension Type Codes 4 to 6 */
|
|
|
/* CNcomment: 1024_TL. AAC音频帧长1024_TL。只对扩展类型代码4-6 */
|
|
|
td_bool len_960tl; /* 960_TL. AAC audio frame lengths 960_TL. Only to extension Type Codes 4 to 6 */
|
|
|
/* CNcomment: 960_TL. AAC音频帧长为960_TL。仅适用于扩展类型代码4至6 */
|
|
|
td_bool mps_l; /* MPS_L. Only to Extension Type Codes 8 to 10 */
|
|
|
/* CNcomment: MPS_L. 只对扩展类型代码8~10 */
|
|
|
} uapi_hdmitx_audio_fmt_info;
|
|
|
|
|
|
/*
|
|
|
* Defines Audio capability information
|
|
|
* CNcomment: 音频能力信息定义
|
|
|
*/
|
|
|
typedef struct {
|
|
|
td_bool basic_support; /* basic audio support. Basic Audio-Uncompressed, two channel, digital audio. */
|
|
|
/* CNcomment: 基本音频支持。基本音频-非压缩，双通道，数字音频. */
|
|
|
td_u32 audio_fmt_cnt; /* Short Audio Descriptors audio format support total number.
|
|
|
* It must less than UAPI_HDMITX_MAX_AUDIO_CNT */
|
|
|
/* CNcomment: ShortAudioDescriptors音频格式支持总数。必须小于UAPI_HDMITX_MAX_AUDIO_CNT */
|
|
|
uapi_hdmitx_audio_fmt_info sad[UAPI_HDMITX_MAX_AUDIO_CNT]; /* Short Audio Descriptors audio format.
|
|
|
* see CTA-861-G 7.5.2 */
|
|
|
/* CNcomment: 短音频描述符音频格式。
|
|
|
* 见 CTA-861-G 7.5.2 */
|
|
|
} uapi_hdmitx_audio_info;
|
|
|
|
|
|
/*
|
|
|
* Defines EDID version
|
|
|
* CNcomment:定义EDID 版本参数
|
|
|
*/
|
|
|
typedef struct {
|
|
|
td_u8 version;
|
|
|
td_u8 revision;
|
|
|
} uapi_hdmitx_edid_version;
|
|
|
|
|
|
/*
|
|
|
* Sink capability information
|
|
|
* CNcomment: 对端能力信息
|
|
|
*/
|
|
|
typedef struct {
|
|
|
uapi_hdmitx_manufacture_info manufacture; /* Sink manufacture infomation struct */
|
|
|
/* CNcomment: sink端制造厂商信息结构 */
|
|
|
uapi_hdmitx_edid_version edid_version; /* EDID version */ /* CNcomment: EDID版本 */
|
|
|
uapi_hdmitx_colorimetry colorimetry; /* Sink colorimety capability infomation struct */
|
|
|
/* CNcomment: Sink色域能力信息结构体 */
|
|
|
uapi_hdmitx_latency latency; /* EDID latency capability */ /* CNcomment: EDID延时能力 */
|
|
|
uapi_hdmitx_disp_para disp_para; /* EDID max display parameters struct */
|
|
|
/* CNcomment: EDID最大显示参数结构体 */
|
|
|
uapi_hdmitx_audio_speaker speaker; /* Sink speaker capability */ /* CNcomment: sink端的扬声器能力 */
|
|
|
uapi_hdmitx_audio_info audio; /* Audio capability */ /* CNcomment: 音频能力 */
|
|
|
uapi_hdmitx_dolby_info dolby; /* EDID dolby vision capability */ /* CNcomment: EDID杜比版本能力 */
|
|
|
uapi_hdmitx_hdr_info hdr; /* Sink HDR capability struct */ /* CNcomment: sink端HDR能力结构体 */
|
|
|
uapi_hdmitx_vrr_info vrr; /* Sink VRR capability */ /* CNcomment: sink端VRR能力 */
|
|
|
uapi_hdmitx_cuva_info cuva; /* Sink CUVA capability */ /* CNcomment: sink端CUVA能力 */
|
|
|
td_u8 reserved;
|
|
|
} uapi_hdmitx_sink_info;
|
|
|
|
|
|
/*
|
|
|
* Defines HDCP KEY version enum
|
|
|
* CNcomment: 定义HDCP KEY版本枚举
|
|
|
*/
|
|
|
typedef enum {
|
|
|
UAPI_HDMITX_HDCP_KEY_VER_1X, /* HDCP1X KEY version */ /* CNcomment: HDCP1X版本KEY */
|
|
|
UAPI_HDMITX_HDCP_KEY_VER_MAX
|
|
|
} uapi_hdmitx_hdcp_key_ver;
|
|
|
|
|
|
/*
|
|
|
* Defines HDCP KEY struct
|
|
|
* CNcomment: 定义HDCP KEY结构体
|
|
|
*/
|
|
|
typedef struct {
|
|
|
uapi_hdmitx_hdcp_key_ver key_ver; /* KEY version */ /* CNcomment: KEY版本 */
|
|
|
td_u8 *data; /* Pointer of key data */ /* CNcomment: key数据指针 */
|
|
|
td_s32 length; /* Length of key data, in bytes */ /* CNcomment: key数据长度，单位为字节 */
|
|
|
} uapi_hdmitx_hdcp_key;
|
|
|
|
|
|
/*
|
|
|
* HDCP SRM struct
|
|
|
* CNcomment: HDCP SRM(失效列表)结构体
|
|
|
*/
|
|
|
typedef struct {
|
|
|
td_u8 *data; /* Pointer of SRM data */ /* CNcomment: SRM数据指针 */
|
|
|
td_s32 length; /* Length of SRM data, in bytes */ /* CNcomment: SRM数据长度，单位为字节 */
|
|
|
} uapi_hdmitx_hdcp_srm;
|
|
|
|
|
|
/*
|
|
|
* HDCP capability struct
|
|
|
* CNcomment: HDCP 能力结构体
|
|
|
*/
|
|
|
typedef struct {
|
|
|
td_bool support14; /* sink support HDCP1.4 version */ /* CNcomment: sink支持HDCP1.4版本 */
|
|
|
td_bool support2x; /* sink support HDCP2.X(2.2/2.3) version */ /* CNcomment: sink支持HDCP2.X(2.2/2.3)版本 */
|
|
|
} uapi_hdmitx_hdcp_cap;
|
|
|
|
|
|
/*
|
|
|
* Defines HDMITX HDCP mode enum
|
|
|
* CNcomment: 定义HDCP 模式枚举
|
|
|
*/
|
|
|
typedef enum {
|
|
|
UAPI_HDMITX_HDCP_MODE_AUTO, /* AUTO mode,preferred higher capable protocol version */
|
|
|
/* CNcomment: 自动模式，优选具备能力的高版本 */
|
|
|
UAPI_HDMITX_HDCP_MODE_14, /* HDCP1.4 mode */ /* CNcomment: HDCP1.4 认证模式 */
|
|
|
UAPI_HDMITX_HDCP_MODE_2X, /* HDCP2.X(2.2/2.3) mode */ /* CNcomment: HDCP2.X(2.2/2.3) 认证模式 */
|
|
|
UAPI_HDMITX_HDCP_MODE_MAX
|
|
|
} uapi_hdmitx_hdcp_mode;
|
|
|
|
|
|
/*
|
|
|
* Defines HDCP version enum
|
|
|
* CNcomment: 定义HDCP 版本枚举
|
|
|
*/
|
|
|
typedef enum {
|
|
|
UAPI_HDMITX_HDCP_VER_NONE, /* no authentication */ /* CNcomment: 未启动HDCP认证 */
|
|
|
UAPI_HDMITX_HDCP_VER_14, /* HDCP1.4 version */ /* CNcomment: HDCP1.4版本 */
|
|
|
UAPI_HDMITX_HDCP_VER_2X, /* HDCP2.X(2.2/2.3) version */ /* CNcomment: HDCP2.X(2.2/2.3)版本 */
|
|
|
UAPI_HDMITX_HDCP_VER_MAX
|
|
|
} uapi_hdmitx_hdcp_ver;
|
|
|
|
|
|
/*
|
|
|
* HDCP error code
|
|
|
* CNcomment: HDMITX HDCP错误码
|
|
|
*/
|
|
|
typedef enum {
|
|
|
UAPI_HDMITX_HDCP_ERR_UNDO = 0x00, /* do not start hdcp. */ /* CNcomment: 未启动HDCP认证 */
|
|
|
UAPI_HDMITX_HDCP_ERR_NONE, /* no authentication error. */ /* CNcomment: 无认证错误 */
|
|
|
UAPI_HDMITX_HDCP_ERR_PLUG_OUT, /* cable plug out. */ /* CNcomment: 线缆拔出 */
|
|
|
UAPI_HDMITX_HDCP_ERR_NO_SIGNAL, /* signal output disable. */ /* CNcomment: 未输出信号 */
|
|
|
UAPI_HDMITX_HDCP_ERR_NO_KEY, /* do not load key. */ /* CNcomment: 未加载key */
|
|
|
UAPI_HDMITX_HDCP_ERR_INVALID_KEY, /* key is invalid. */ /* CNcomment: 加载了无效key */
|
|
|
UAPI_HDMITX_HDCP_ERR_DDC, /* DDC link error. */ /* CNcomment: DDC通道错误 */
|
|
|
UAPI_HDMITX_HDCP_ERR_ON_SRM, /* on revocation list. */ /* CNcomment: 在失效列表中 */
|
|
|
UAPI_HDMITX_HDCP_ERR_NO_CAP, /* no hdcp capability. */ /* CNcomment: 设备不支持hdcp */
|
|
|
UAPI_HDMITX_HDCP_ERR_TYPE1_NO_2X_CAP, /* no hdcp2x capability on stream type 1. */
|
|
|
/* CNcomment: 流类型1上没有hdcp2x功能 */
|
|
|
UAPI_HDMITX_HDCP_ERR_TYPE1_ON_1X_MODE, /* set only hdcp1x mode on stream type 1. */
|
|
|
/* CNcomment: 在流类型1上仅支持hdcp1x模式 */
|
|
|
UAPI_HDMITX_HDCP_1X_NO_CAP = 0x10, /* no hdcp1.4 capability. */ /* CNcomment: 当前制式或设备不支持hdcp1.x */
|
|
|
UAPI_HDMITX_HDCP_1X_BCAP_FAIL, /* read BCAP failed. */ /* CNcomment: 读取BCAP失败 */
|
|
|
UAPI_HDMITX_HDCP_1X_BSKV_FAIL, /* read BKSV failed. */ /* CNcomment: 读取BKSV失败 */
|
|
|
UAPI_HDMITX_HDCP_1X_INTEGRITY_FAIL_R0, /* R0(R0') integrety failure. */ /* CNcomment: R0(R0')校验失败 */
|
|
|
UAPI_HDMITX_HDCP_1X_WATCHDOG_TIMEOUT, /* Repeater watch dog timeout. */ /* CNcomment: 看门狗超时 */
|
|
|
UAPI_HDMITX_HDCP_1X_VI_CHCECK_FAIL, /* Vi(Vi') check failed. */ /* CNcomment: Vi(Vi')校验失败 */
|
|
|
UAPI_HDMITX_HDCP_1X_EXCEEDED_TOPOLOGY, /* Exceeded toplogy. */ /* CNcomment: 超出设备个数或topology层限制 */
|
|
|
UAPI_HDMITX_HDCP_1X_INTEGRITY_FAIL_RI, /* Ri(Ri') integrety failure. */ /* CNcomment: Ri(Ri')校验失败 */
|
|
|
UAPI_HDMITX_HDCP_2X_NO_CAP = 0x20, /* no hdcp2x capability. */ /* CNcomment: 设备不支持hdcp2x */
|
|
|
UAPI_HDMITX_HDCP_2X_SIGNATURE_FAIL, /* signature error. */ /* CNcomment: 签名错误 */
|
|
|
UAPI_HDMITX_HDCP_2X_MISMATCH_H, /* mismatch H(H'). */ /* CNcomment: H(H')不匹配 */
|
|
|
UAPI_HDMITX_HDCP_2X_AKE_TIMEOUT, /* AKE timeout. */ /* CNcomment: AKE超时 */
|
|
|
UAPI_HDMITX_HDCP_2X_LOCALITY_FAIL, /* locality check failed. */ /* CNcomment: 本地校验失败 */
|
|
|
UAPI_HDMITX_HDCP_2X_REAUTH_REQ, /* REAUTH_REQ request. */ /* CNcomment: 重认证请求 */
|
|
|
UAPI_HDMITX_HDCP_2X_WATCHDOG_TIMEOUT, /* watchdog timeout. */ /* CNcomment: 看门狗超时 */
|
|
|
UAPI_HDMITX_HDCP_2X_V_MISMATCH, /* mismatch V(V'). */ /* CNcomment: V(V')不匹配 */
|
|
|
UAPI_HDMITX_HDCP_2X_ROLL_OVER, /* no roll-over of seq_num_V. */ /* CNcomment: 未检测到seq_num_V */
|
|
|
UAPI_HDMITX_HDCP_2X_EXCEEDED_TOPOLOGY /* Exceeded toplogy. */ /* CNcomment: 超出设备个数或topology层限制 */
|
|
|
} uapi_hdmitx_hdcp_err;
|
|
|
|
|
|
/*
|
|
|
* Defines HDCP status struct
|
|
|
* CNcomment: 定义HDCP 状态结构体
|
|
|
*/
|
|
|
typedef struct {
|
|
|
td_bool auth_start; /* HDCP authentication start. */ /* CNcomment: HDCP认证启动 */
|
|
|
td_bool auth_success; /* HDCP authentication success. */ /* CNcomment: HDCP认证成功 */
|
|
|
td_u32 cur_reauth_times; /* HDCP current re-authen times. */ /* CNcomment: HDCP当前重认证次数 */
|
|
|
uapi_hdmitx_hdcp_ver version; /* HDCP authentication version. */ /* CNcomment: HDCP认证版本 */
|
|
|
uapi_hdmitx_hdcp_err err_code; /* HDCP authentication error code. */ /* CNcomment: HDCP认证错误码 */
|
|
|
} uapi_hdmitx_hdcp_status;
|
|
|
|
|
|
/*
|
|
|
* Defines the status of logical address enum
|
|
|
* CNcomment: 定义CEC 逻辑地址状态枚举
|
|
|
*/
|
|
|
typedef enum {
|
|
|
UAPI_HDMITX_CEC_ADDR_STATUS_VALID, /* The logical address is valid */ /* CNcomment: 当前逻辑地址有效 */
|
|
|
UAPI_HDMITX_CEC_ADDR_STATUS_INVALID, /* The logical address is invalid */ /* CNcomment: 当前逻辑地址无效 */
|
|
|
UAPI_HDMITX_CEC_ADDR_STATUS_NOT_CONFIG, /* The logical address is not set */ /* CNcomment: 未设置过逻辑地址 */
|
|
|
UAPI_HDMITX_CEC_ADDR_STATUS_CONFIGURING, /* The driver is querying the available logical address now */
|
|
|
/* CNcomment: 驱动正在查询可用的逻辑地址 */
|
|
|
} uapi_hdmitx_cec_logic_addr_status;
|
|
|
|
|
|
/*
|
|
|
* The event type of CEC
|
|
|
* CNcomment: CEC事件类型
|
|
|
*/
|
|
|
typedef enum {
|
|
|
UAPI_HDMITX_CEC_EVENT_STATUS_CHANGE, /* CEC status was changed, e.g the logical or physical address was changed */
|
|
|
/* CNcomment: 表示CEC状态发生了变化，比如逻辑地址或者物理地址发生了变化 */
|
|
|
UAPI_HDMITX_CEC_EVENT_RECEIVED, /* Receive a CEC message */ /* CNcomment: 接收到CEC消息 */
|
|
|
} uapi_hdmitx_cec_event_type;
|
|
|
|
|
|
/*
|
|
|
* The status of CEC
|
|
|
* CNcomment: CEC的状态
|
|
|
*/
|
|
|
typedef struct {
|
|
|
td_u16 logic_addr; /* Current logical address */ /* CNcomment: 当前的逻辑地址 */
|
|
|
td_u16 physic_addr; /* Current physical address */ /* CNcomment: 当前物理地址 */
|
|
|
uapi_hdmitx_cec_logic_addr_status addr_status; /* the status of logical address */
|
|
|
/* CNcomment: 逻辑地址配置状态 */
|
|
|
} uapi_hdmitx_cec_status;
|
|
|
|
|
|
/*
|
|
|
* The data of CEC event
|
|
|
* CNcomment: CEC事件数据
|
|
|
*/
|
|
|
typedef union {
|
|
|
uapi_hdmitx_cec_status cec_status; /* The current status of CEC */ /* CNcomment: 当前CEC的状态 */
|
|
|
uapi_cec_msg rx_msg; /* The message that received */ /* CNcomment: 接收到的CEC消息 */
|
|
|
} uapi_hdmitx_cec_event_data;
|
|
|
|
|
|
/*
|
|
|
* The callback function type of CEC
|
|
|
* CNcomment: CEC回调函数类型定义
|
|
|
*/
|
|
|
typedef td_void (*uapi_hdmitx_callback_pfn)(uapi_hdmitx_id id, uapi_hdmitx_cec_event_type type,
|
|
|
const uapi_hdmitx_cec_event_data *data, td_void *private_data);
|
|
|
|
|
|
/*
|
|
|
* The callback struct of CEC
|
|
|
* CNcomment: CEC回调结构体定义
|
|
|
*/
|
|
|
typedef struct {
|
|
|
uapi_hdmitx_callback_pfn func; /* The callback function type of CEC */ /* CNcomment: CEC回调函数类型定义 */
|
|
|
td_void *private_data; /* Private callback paramters */ /* CNcomment: 用户私有回调参数 */
|
|
|
} uapi_hdmitx_cec_callback;
|
|
|
|
|
|
|
|
|
/*
|
|
|
* brief init function. CNcomment: 初始化 CNend
|
|
|
* attention User needs to call this function before call other hdmitx function
|
|
|
* CNcomment: 用户需在调用其他HDMI TX接口前调用这个接口 CNend
|
|
|
* param CNcomment: 无 CNend
|
|
|
* retval ::TD_SUCCESS Success. CNcomment: 成功 CNend
|
|
|
* retval ::please refer to the err code definition of mpi. CNcomment: 请参考MPI错误码 CNend
|
|
|
* see \n
|
|
|
* N/A CNcomment: 无 CNend
|
|
|
*/
|
|
|
td_s32 uapi_hdmitx_init(td_void);
|
|
|
|
|
|
/*
|
|
|
* brief deinit function. CNcomment: 去初始化 CNend
|
|
|
* attention User needs to call this function before the application exits.
|
|
|
* CNcomment: 用户需在应用对退出前调用这个接口 CNend
|
|
|
* param CNcomment:无 CNend
|
|
|
* retval ::TD_SUCCESS Success. CNcomment: 成功 CNend
|
|
|
* retval ::please refer to the err code definition of mpi. CNcomment: 请参考MPI错误码 CNend
|
|
|
* see \n
|
|
|
* N/A CNcomment: 无 CNend
|
|
|
*/
|
|
|
td_s32 uapi_hdmitx_deinit(td_void);
|
|
|
|
|
|
/*
|
|
|
* brief register callback function. CNcomment: 注册回调函数 CNend
|
|
|
* attention User needs to register a callback function to handle events defined in uapi_hdmitx_event_type.
|
|
|
* CNcomment: 用户需注册一个回调函数，用于处理uapi_hdmitx_event_type定义的事件. CNend
|
|
|
* param[in] hdmitx_id hdmi device id. CNcomment: HDMITX设备ID CNend
|
|
|
* param[in] callback_func callback function CNcomment: 回调函数 CNend
|
|
|
* retval ::TD_SUCCESS Success. CNcomment: 成功 CNend
|
|
|
* retval ::please refer to the err code definition of mpi. CNcomment: 请参考MPI错误码 CNend
|
|
|
* see uapi_hdmitx_callback and uapi_hdmitx_event_type
|
|
|
*/
|
|
|
td_s32 uapi_hdmitx_register_callback(uapi_hdmitx_id hdmitx_id, const uapi_hdmitx_callback *callback_func);
|
|
|
|
|
|
|
|
|
/*
|
|
|
* brief unregister callback function. CNcomment: 注销回调函数 CNend
|
|
|
* attention This function must be called when exiting the callback service registered by
|
|
|
* uapi_hdmitx_register_callback.
|
|
|
* CNcomment: 退出由uapi_hdmitx_register_callback注册的回调服务时，该函数必须调用. CNend
|
|
|
* param[in] hdmitx_id hdmi device id.CNcomment: HDMITX设备ID CNend
|
|
|
* param[in] callback_func callback function CNcomment: 回调函数 CNend
|
|
|
* retval ::TD_SUCCESS Success. CNcomment: 成功 CNend
|
|
|
* retval ::please refer to the err code definition of mpi. CNcomment: 请参考MPI错误码 CNend
|
|
|
* see uapi_hdmitx_callback
|
|
|
*/
|
|
|
td_s32 uapi_hdmitx_unregister_callback(uapi_hdmitx_id hdmitx_id, const uapi_hdmitx_callback *callback_func);
|
|
|
|
|
|
/*
|
|
|
* brief get current hdmi status. CNcomment: 获取hdmi当前的状态 CNend
|
|
|
* attention \n
|
|
|
* N/A CNcomment: 无 CNend
|
|
|
* param[in] hdmitx_id hdmi device id. CNcomment: HDMITX设备ID CNend
|
|
|
* param[out] hdmi_status hdmi cuttent status. CNcomment: HDMITX当前状态 CNend
|
|
|
* retval ::TD_SUCCESS Success. CNcomment: 成功 CNend
|
|
|
* retval ::please refer to the err code definition of mpi. CNcomment: 请参考MPI错误码 CNend
|
|
|
* see uapi_hdmitx_status
|
|
|
*/
|
|
|
td_s32 uapi_hdmitx_get_status(uapi_hdmitx_id hdmitx_id, uapi_hdmitx_status *hdmi_status);
|
|
|
|
|
|
|
|
|
/*
|
|
|
* brief read sink's edid raw data. CNcomment: 读取EDID裸数据 CNend
|
|
|
* attention \n
|
|
|
* N/A CNcomment: 无 CNend
|
|
|
* param[in] hdmitx_id hdmi device id. CNcomment: HDMITX设备ID CNend
|
|
|
* param[in/out] edid_buf pointer to the buffer allocated externally.
|
|
|
* CNcomment: 获取EDID裸数据的buffer指针，用户需自己分配好buffer。 CNend
|
|
|
* param[in] buf_size size of the edid raw data buffer，the recommended buffer size is 512.
|
|
|
* CNcomment: EDID裸数据buffer大小，建议定义为512。不排除将来有设备的EDID裸数据长度超过512。 CNend
|
|
|
* param[out] edid_len the real lenth of edid raw data. CNcomment: 获取EDID裸数据实际长度 CNend
|
|
|
* param[in] force when true, force to re-read EDID from sink, or read EDID from current copy.
|
|
|
* CNcomment: 当设置为true,强制从sink重新读取EDID；否则，从当前内存备份中获取。 CNend
|
|
|
* retval ::TD_SUCCESS Success. CNcomment: 成功 CNend
|
|
|
* retval ::please refer to the err code definition of mpi. CNcomment: 请参考MPI错误码 CNend
|
|
|
* see \n
|
|
|
* N/A CNcomment: 无 CNend
|
|
|
*/
|
|
|
td_s32 uapi_hdmitx_read_edid(uapi_hdmitx_id hdmitx_id, td_u8 *edid_buf,
|
|
|
td_u32 buf_size, td_u32 *edid_len, td_bool force);
|
|
|
|
|
|
/*
|
|
|
* brief get sink's capability information. CNcomment: 获取对端能力信息。 CNend
|
|
|
* attention \n
|
|
|
* N/A CNcomment: 无 CNend
|
|
|
* param[in] hdmitx_id hdmi device id. CNcomment: HDMITX设备ID CNend
|
|
|
* param[in] sink_info pointer to the memory of the sink's capability information structure.
|
|
|
* CNcomment: 对端能力信息指针 CNend
|
|
|
* retval ::TD_SUCCESS Success. CNcomment: 成功 CNend
|
|
|
* retval ::please refer to the err code definition of mpi. CNcomment: 请参考MPI错误码 CNend
|
|
|
* see uapi_hdmitx_sink_info
|
|
|
*/
|
|
|
td_s32 uapi_hdmitx_get_sink_info(uapi_hdmitx_id hdmitx_id, uapi_hdmitx_sink_info *sink_info);
|
|
|
|
|
|
/*
|
|
|
* brief get available capability. CNcomment: 获取有效能力信息。 CNend
|
|
|
* attention \n
|
|
|
* N/A CNcomment: 无 CNend
|
|
|
* param[in] hdmitx_id hdmi device id. CNcomment: HDMITX设备ID CNend
|
|
|
* param[in] avail_cap pointer to the memory of the available capability structure. CNcomment: 有效能力信息指针 CNend
|
|
|
* retval ::TD_SUCCESS Success. CNcomment: 成功 CNend
|
|
|
* retval ::please refer to the err code definition of mpi. CNcomment: 请参考MPI错误码 CNend
|
|
|
* see uapi_hdmitx_avail_cap
|
|
|
*/
|
|
|
td_s32 uapi_hdmitx_get_avail_capability(uapi_hdmitx_id hdmitx_id, uapi_hdmitx_avail_cap *avail_cap);
|
|
|
|
|
|
/*
|
|
|
* brief get available modes. CNcomment: 获取有效制式集。 CNend
|
|
|
* attention The user needs to allocate a memory buffer. The recommended number is set to @mode_cnt
|
|
|
* in uapi_hdmitx_avail_cap. CNcomment: 用户需分配存储缓冲区，建议个数设置为uapi_hdmitx_avail_cap中的@mode_cnt CNend
|
|
|
* param[in] hdmitx_id hdmi device id. CNcomment: HDMITX设备ID CNend
|
|
|
* param[in] avail_modes pointer to the memory buffer of the available modes.
|
|
|
* CNcomment: 有效制式集存储缓冲区指针。 CNend
|
|
|
* param[in] mode_cnt available modes count assigned by user. CNcomment: 用户分配的有效制式单元个数 CNend
|
|
|
* param[out] avail_mode_cnt pointer to the memory of the real available modes count.
|
|
|
* CNcomment: 真实返回的有效制式个数 CNend
|
|
|
* retval ::TD_SUCCESS Success. CNcomment: 成功 CNend
|
|
|
* retval ::please refer to the err code definition of mpi. CNcomment: 请参考MPI错误码 CNend
|
|
|
* see uapi_hdmitx_avail_mode
|
|
|
*/
|
|
|
td_s32 uapi_hdmitx_get_avail_modes(uapi_hdmitx_id hdmitx_id,
|
|
|
uapi_hdmitx_avail_mode *avail_modes, td_u32 mode_cnt, td_u32 *avail_mode_cnt);
|
|
|
|
|
|
/*
|
|
|
* brief load HDCP KEY. CNcomment: 加载HDCP KEY CNend
|
|
|
* attention The HDCP1X version KEY is purchased and loaded by the user from the HDCP organization.
|
|
|
* CNcomment: HDCP1X版本KEY由用户从HDCP组织购买并加载。 CNend
|
|
|
* param[in] hdmitx_id hdmi device id. CNcomment: HDMITX设备ID CNend
|
|
|
* param[in] key key struct pointer CNcomment: key结构指针 CNend
|
|
|
* retval ::TD_SUCCESS Success. CNcomment: 成功 CNend
|
|
|
* retval ::please refer to the err code definition of mpi. CNcomment: 请参考MPI错误码 CNend
|
|
|
* see uapi_hdmitx_hdcp_key
|
|
|
*/
|
|
|
td_s32 uapi_hdmitx_hdcp_load_key(uapi_hdmitx_id hdmitx_id, const uapi_hdmitx_hdcp_key *key);
|
|
|
|
|
|
/*
|
|
|
* brief set SRM. CNcomment: 设置SRM数据 CNend
|
|
|
* attention
|
|
|
* 1.Setting SRM multiple times is subject to the last succesful one.
|
|
|
* 2.The SRM will be updated from time to time and will be obtained from the official HDCP website by users.
|
|
|
* 3.The kernel does not set SRM by default.
|
|
|
* CNcomment:
|
|
|
* 1.多次设置SRM则以最后一次成功的为准
|
|
|
* 2.失效名单会不定期更新，由用户从HDCP官方网站获取
|
|
|
* 3.内核默认不设置失效名单
|
|
|
* CNend
|
|
|
* param[in] hdmitx_id hdmi channel id. CNcomment: HDMITX设备ID CNend
|
|
|
* param[in] srm pointer to SRM raw data CNcomment: SRM结构指针 CNend
|
|
|
* retval ::TD_SUCCESS Success. CNcomment: 成功 CNend
|
|
|
* retval ::please refer to the err code definition of mpi. CNcomment: 请参考MPI错误码 CNend
|
|
|
* see uapi_hdmitx_hdcp_srm
|
|
|
*/
|
|
|
td_s32 uapi_hdmitx_hdcp_set_srm(uapi_hdmitx_id hdmitx_id, const uapi_hdmitx_hdcp_srm *srm);
|
|
|
|
|
|
/*
|
|
|
* brief get sink's HDCP capability. CNcomment: 获取Sink设备的HDCP能力 CNend
|
|
|
* attention It is suggested that user gets more times until retval is TD_SUCCESS.
|
|
|
* CNcomment: 建议用户调用多次获取HDCP能力直到返回值为TD_SUCCESS。 CNend
|
|
|
* param[in] hdmitx_id hdmi device id. CNcomment: HDMITX设备ID CNend
|
|
|
* param[out] hdcp_cap the HDCP capability of the sink. CNcomment: SINK的HDCP能力 CNend
|
|
|
* retval ::TD_SUCCESS Success. CNcomment: 成功 CNend
|
|
|
* retval ::please refer to the err code definition of mpi. CNcomment: 请参考MPI错误码 CNend
|
|
|
* see uapi_hdmitx_hdcp_cap
|
|
|
*/
|
|
|
td_s32 uapi_hdmitx_hdcp_get_cap(uapi_hdmitx_id hdmitx_id, uapi_hdmitx_hdcp_cap *hdcp_cap);
|
|
|
|
|
|
/*
|
|
|
* brief set HDCP re-authen times. CNcomment: 设置HDCP失败重认证次数 CNend
|
|
|
* attention
|
|
|
* 1. It can be set in the HDCP start or stop status.
|
|
|
* 2. Kernel will re-authen until fail-times reached the setting times.
|
|
|
* 3. The default setting times is UAPI_HDMITX_HDCP_REAUTH_DEFAULT,kernel will re-authentication every fail-time.
|
|
|
* 4. The re-authen times do not work if it is not ready to authentication.Such as cable plug out,
|
|
|
* no signal,invalid key,id is on SRM,HDMI connector physical damage，etc.
|
|
|
* CNcomment:
|
|
|
* 1.HDCP启动/停止状态下均可设置重认证次数
|
|
|
* 2.设置成功后，从下一次与sink进行HDCP认证起，连续重认证失败达到设置的次数后，上报HDCP握手失败事件并停止认证
|
|
|
* 3.设置为UAPI_HDMITX_HDCP_REAUTH_DEFAULT(默认值)，表示内核在每次认证失败时都在协议规定时间内重认证
|
|
|
* 4.因未达到准备状态导致的失败不进行重认证，设定次数无效。如:线缆拔出、未输出信号、KEY无效、ID失效、HDMI端口物理损坏等
|
|
|
* CNend
|
|
|
* param[in] hdmitx_id hdmi device id. CNcomment: HDMITX设备ID CNend
|
|
|
* param[in] reauth_times re-authen times CNcomment: 重认证次数 CNend
|
|
|
* retval ::TD_SUCCESS Success. CNcomment: 成功 CNend
|
|
|
* retval ::please refer to the err code definition of mpi. CNcomment: 请参考MPI错误码 CNend
|
|
|
* see \n
|
|
|
* N/A CNcomment: 无 CNend
|
|
|
*/
|
|
|
td_s32 uapi_hdmitx_hdcp_set_auth_times(uapi_hdmitx_id hdmitx_id, td_u32 reauth_times);
|
|
|
|
|
|
/*
|
|
|
* brief start HDCP authentication. CNcomment: 启动HDCP认证 CNend
|
|
|
* attention Users should not choose HDCP mode that is not supported by sink capability.
|
|
|
* CNcomment: 用户不应选择sink能力不支持的HDCP模式。 CNend
|
|
|
* param[in] hdmitx_id hdmi device id. CNcomment: HDMITX设备ID CNend
|
|
|
* param[in] hdcp_mode hdcp mode. CNcomment: HDCP认证模式 CNend
|
|
|
* retval ::TD_SUCCESS Success. CNcomment: 成功 CNend
|
|
|
* retval ::please refer to the err code definition of mpi. CNcomment: 请参考MPI错误码 CNend
|
|
|
* see uapi_hdmitx_hdcp_mode
|
|
|
*/
|
|
|
td_s32 uapi_hdmitx_hdcp_start_auth(uapi_hdmitx_id hdmitx_id, uapi_hdmitx_hdcp_mode hdcp_mode);
|
|
|
|
|
|
/*
|
|
|
* brief stop HDCP authentication. CNcomment: 停止HDCP认证 CNend
|
|
|
* param[in] hdmitx_id hdmi device id. CNcomment: HDMITX设备ID CNend
|
|
|
* retval ::TD_SUCCESS Success. CNcomment: 成功 CNend
|
|
|
* retval ::please refer to the err code definition of mpi. CNcomment: 请参考MPI错误码 CNend
|
|
|
* see \n
|
|
|
* N/A CNcomment: 无 CNend
|
|
|
*/
|
|
|
td_s32 uapi_hdmitx_hdcp_stop_auth(uapi_hdmitx_id hdmitx_id);
|
|
|
|
|
|
/*
|
|
|
* brief get HDCP status. CNcomment: 获取HDCP状态 CNend
|
|
|
* attention It is recommended that the user call the interface after capturing the HDCP event,
|
|
|
* and handle it according to different status.
|
|
|
* CNcomment: 建议用户在获取HDCP事件后调用该接口，并根据不同的状态做相应处理 CNend
|
|
|
* param[in] hdmitx_id hdmi device id. CNcomment: HDMITX设备ID CNend
|
|
|
* param[in] hdcp_status hdcp status. CNcomment: HDCP认证状态 CNend
|
|
|
* retval ::TD_SUCCESS Success. CNcomment: 成功 CNend
|
|
|
* retval ::please refer to the err code definition of mpi. CNcomment: 请参考MPI错误码 CNend
|
|
|
* see uapi_hdmitx_hdcp_status
|
|
|
*/
|
|
|
td_s32 uapi_hdmitx_hdcp_get_status(uapi_hdmitx_id hdmitx_id, uapi_hdmitx_hdcp_status *hdcp_status);
|
|
|
|
|
|
/*
|
|
|
* brief Enable or disable the CEC interface. CNcomment: 打开/关闭CEC接口 CNend
|
|
|
* attention Multiple processes are not supported. CNcomment: 不支持多进程 CNend
|
|
|
* param[in] id The HDMI interface. CNcomment: HDMI端口 CNend
|
|
|
* param[in] enable True-enbale CEC, false-disable CEC. CNcomment: true-打开CEC，false-关闭CEC CNend
|
|
|
* retval ::TD_SUCCESS Success. CNcomment: 成功 CNend
|
|
|
* retval ::SOC_ERR_HDMITX_BUS_BUSY CEC already open by other process. CNcomment: CEC已经被其他进程占用 CNend
|
|
|
* retval ::SOC_ERR_HDMITX_INVALID_PARA The input parameter was invalid. CNcomment: 非法输入参数 CNend
|
|
|
* retval ::TD_FAILURE Others error. CNcomment: 其他错误 CNend
|
|
|
* see \n
|
|
|
* N/A CNcomment: 无 CNend
|
|
|
*/
|
|
|
td_s32 uapi_hdmitx_cec_enable(uapi_hdmitx_id id, td_bool enable);
|
|
|
|
|
|
/*
|
|
|
* brief Register the Callback function of CEC. CNcomment: 注册CEC回调函数 CNend
|
|
|
* attention Can only register one callback function by a process. You shall call this function
|
|
|
* before uapi_hdmitx_cec_set_device_type and after uapi_hdmitx_cec_enable.
|
|
|
* CNcomment: 一个进程仅能注册一个回调函数. 必须在uapi_hdmitx_cec_enable之后和uapi_hdmitx_cec_set_device_type之前调
|
|
|
* 用此接口. CNend
|
|
|
* param[in] id The HDMI interface. CNcomment: HDMI端口 CNend
|
|
|
* param[in] callback The pointer of the callback funtion that you want to register.
|
|
|
* CNcomment: 需要注册的回调函数指针 CNend
|
|
|
* retval ::TD_SUCCESS Success. CNcomment: 成功 CNend
|
|
|
* retval ::SOC_ERR_HDMITX_DEV_NOT_OPEN CEC not open. CNcomment:CEC没有打开 CNend
|
|
|
* retval ::SOC_ERR_HDMITX_CALLBACK_ALREADY Callback function already register. CNcomment: 已经注册了CEC回调函数 CNend
|
|
|
* retval ::SOC_ERR_HDMITX_INVALID_PARA The input parameter was invalid. CNcomment: 非法输入参数 CNend
|
|
|
* retval ::TD_FAILURE Others error. CNcomment: 其他错误 CNend
|
|
|
* see uapi_hdmitx_cec_callback \n
|
|
|
*/
|
|
|
td_s32 uapi_hdmitx_cec_register_callback(uapi_hdmitx_id id, const uapi_hdmitx_cec_callback *callback);
|
|
|
|
|
|
/*
|
|
|
* brief Unregister the Callback function of CEC. CNcomment: 注销CEC回调函数 CNend
|
|
|
* attention You shall call this function before disable CEC. CNcomment: 必须在关闭CEC之前调用此接口. CNend
|
|
|
* param[in] id The HDMI interface CNcomment: HDMI端口 CNend
|
|
|
* retval ::TD_SUCCESS Success. CNcomment: 成功 CNend
|
|
|
* retval ::SOC_ERR_HDMITX_DEV_NOT_OPEN CEC not open. CNcomment: CEC没有打开 CNend
|
|
|
* retval ::SOC_ERR_HDMITX_INVALID_PARA The input parameter was invalid. CNcomment: 非法输入参数 CNend
|
|
|
* retval ::TD_FAILURE Others error. CNcomment: 其他错误 CNend
|
|
|
* see \n
|
|
|
* N/A CNcomment: 无 CNend
|
|
|
*/
|
|
|
td_s32 uapi_hdmitx_cec_unregister_callback(uapi_hdmitx_id id);
|
|
|
|
|
|
/*
|
|
|
* brief Get the current status of CEC. CNcomment: 获取当前CEC的状态 CNend
|
|
|
* attention
|
|
|
* param[in] id The HDMI interface. CNcomment: HDMI端口 CNend
|
|
|
* param[in] status A return value of the current status of CEC. CNcomment: 返回当前CEC状态 CNend
|
|
|
* retval ::TD_SUCCESS Success. CNcomment: 成功 CNend
|
|
|
* retval ::SOC_ERR_HDMITX_DEV_NOT_OPEN CEC not open. CNcomment: CEC没有打开 CNend
|
|
|
* retval ::SOC_ERR_HDMITX_INVALID_PARA The input parameter was invalid. CNcomment: 非法输入参数 CNend
|
|
|
* retval ::TD_FAILURE Others error. CNcomment: 其他错误 CNend
|
|
|
* see uapi_hdmitx_cec_status \n
|
|
|
*/
|
|
|
td_s32 uapi_hdmitx_cec_get_status(uapi_hdmitx_id id, uapi_hdmitx_cec_status *status);
|
|
|
|
|
|
/*
|
|
|
* brief Config the device type of CEC. CNcomment: 设置CEC设备类型 CNend
|
|
|
* attention The device type must be set before send or receive any messages. Be carefull, all messages in
|
|
|
* transmit queue as well as in receive queue will lost when change the device type.
|
|
|
* CNcomment: 必须在发送或者接收CEC消息之前设置设备类型。注意，中途改变设备，发送队列和接收队列中所有的消息都会丢失。
|
|
|
* CNend
|
|
|
* param[in] id The HDMI interface. CNcomment: HDMI端口 CNend
|
|
|
* param[in] device_type The device type want to set. CNcomment: 希望设置的设备类型 CNend
|
|
|
* retval ::TD_SUCCESS Success. CNcomment: 成功 CNend
|
|
|
* retval ::SOC_ERR_HDMITX_DEV_NOT_OPEN CEC not open. CNcomment: CEC没有打开 CNend
|
|
|
* retval ::SOC_ERR_HDMITX_FEATURE_NO_SUPPORT An unsupported logical address is set.
|
|
|
* CNcomment: 设置了一个不支持设备类型 CNend
|
|
|
* retval ::SOC_ERR_HDMITX_INVALID_PARA The input parameter was invalid. CNcomment: 非法输入参数 CNend
|
|
|
* retval ::SOC_ERR_HDMITX_NO_CALLBACK Callback funtion was not registered, you must register the callback funtion
|
|
|
* before set logical address. CNcomment: 回调函数没有注册，请先注册回调函数 CNend
|
|
|
* retval ::TD_FAILURE Others error. CNcomment: 其他错误 CNend
|
|
|
* see uapi_cec_device_type \n
|
|
|
*/
|
|
|
td_s32 uapi_hdmitx_cec_set_device_type(uapi_hdmitx_id id, td_u8 device_type);
|
|
|
|
|
|
/*
|
|
|
* brief Transmit a CEC message. CNcomment: 发送一个CEC消息 CNend
|
|
|
* attention This call will block utill the transmit was completed, and the transmit status was returned.
|
|
|
* CNcomment: 调用会阻塞直到发送完成，并返回发送状态 CNend
|
|
|
* param[in] id The HDMI interface CNcomment: HDMI端口 CNend
|
|
|
* param msg The message need to transmit. CNcomment: 待发送的消息 CNend
|
|
|
* retval ::TD_SUCCESS Indicate that the message is successfully sent and acknowledged.
|
|
|
* CNcomment: 表示消息发送成功，并且收到应答 CNend
|
|
|
* retval ::SOC_ERR_HDMITX_DEV_NOT_OPEN CEC not open. CNcomment: CEC没有打开 CNend
|
|
|
* retval ::SOC_ERR_HDMITX_NO_LOGIC_ADDR The logical address is not set, or the logical address is querying now.
|
|
|
* CNcomment: 未设置逻辑地址，或者驱动正在查询可用的逻辑地址 CNend
|
|
|
* retval ::SOC_ERR_HDMITX_MSG_NACK Indicate that the message is successfully sent and is not acknowledged.
|
|
|
* CNcomment: 表示发送的CEC消息没有应答 CNend
|
|
|
* retval ::SOC_ERR_HDMITX_MSG_FAILED Indicate that the message sent is failed.
|
|
|
* CNcomment: 表示CEC消息发送成功，但没有收到应答 CNend
|
|
|
* retval ::SOC_ERR_HDMITX_INVALID_PARA The input parameter was invalid. CNcomment: 非法输入参数 CNend
|
|
|
* retval ::TD_FAILURE Others error. CNcomment: 其他错误 CNend
|
|
|
* see uapi_cec_msg \n
|
|
|
*/
|
|
|
td_s32 uapi_hdmitx_cec_send_msg(uapi_hdmitx_id id, const uapi_cec_msg *msg);
|
|
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
|
#if __cplusplus
|
|
|
}
|
|
|
#endif
|
|
|
#endif
|
|
|
|
|
|
#endif /* UAPI_HDMITX_H */
|
