1# HDMI
2
3## 概述
4
5### 功能简介
6
7HDMI（High Definition Multimedia Interface），即高清多媒体接口，是Hitachi、Panasonic、Philips、Silicon Image、Sony、Thomson、Toshiba共同发布的一款音视频传输协议，主要用于DVD、机顶盒等音视频Source设备到TV、显示器等Sink设备的传输。HDMI传输过程遵循TMDS（Transition Minimized Differential Signaling）协议。
8
9### 基本概念
10
11- TMDS（Transition Minimized Differential signal）：过渡调制差分信号，也被称为最小化传输差分信号，用于发送音频、视频及各种辅助数据。
12
13- DDC（Display Data Channel）：显示数据通道，发送端与接收端可利用DDC通道得知彼此的发送与接收能力，但HDMI仅需单向获知接收端（显示器）的能力。
14
15- CEC（Consumer Electronics Control）：消费电子控制，该功能应该能够在连接HDMI的发送设备与接收设备之间实现交互操作。
16
17- FRL（Fixed Rate Link）：TMDS的架构进行讯号传输时，最高带宽可达18Gbps，而FRL模式的带宽则提升到48Gbps。
18
19- HDCP（High-bandwidth Digital Content Protection）：即高带宽数字内容保护技术，当用户对高清晰信号进行非法复制时，该技术会进行干扰，降低复制出来的影像的质量，从而对内容进行保护。
20
21### 运作机制
22
23在HDF框架中，HDMI的接口适配模式拟采用独立服务模式（如图1）。在这种模式下，每一个设备对象会独立发布一个设备服务来处理外部访问，设备管理器收到API的访问请求之后，通过提取该请求的参数，达到调用实际设备对象的相应内部方法的目的。独立服务模式可以直接借助HDFDeviceManager的服务管理能力，但需要为每个设备单独配置设备节点，增加内存占用率。
24
25HDMI模块各分层作用：
26
27- 接口层提供打开HDMI设备、启动HDMI传输、停止HDMI传输、声音图像消隐设置、设置色彩深度、获取色彩深度、设置视频属性、获取视频属性、设置HDR属性、读取Sink端原始EDID数据、注册HDMI热插拔检测回调函数、注销HDMI热插拔检测回调函数、关闭HDMI设备的接口。
28
29- 核心层主要提供HDMI控制器的打开、关闭及管理的能力，通过钩子函数与适配层交互。
30
31- 适配层主要是将钩子函数的功能实例化，实现具体的功能。
32
33**图 1** HDMI独立服务模式
34
35![HDMI独立服务模式](figures/独立服务模式结构图.png)
36
37### 约束与限制
38
39HDMI模块当前仅支持轻量和小型系统内核（LiteOS），暂无实际适配驱动。
40
41## 开发指导
42
43### 场景介绍
44
45HDMI具有体积小、传输速率高、传输带宽宽、兼容性好、能同时传输无压缩音视频信号等优点。与传统的全模拟接口相比，HDMI不但增加了设备间接线的便捷性，还提供了一些HDMI特有的智能化功能，可用于小体积设备进行高质量音视频传输的场景。
46
47### 接口说明
48
49HdmiCntlrOps定义：
50
51```c
52struct HdmiCntlrOps {
53    void (*hardWareInit)(struct HdmiCntlr *cntlr);
54    void (*hardWareStatusGet)(struct HdmiCntlr *cntlr, struct HdmiHardwareStatus *status);
55    void (*controllerReset)(struct HdmiCntlr *cntlr);
56    bool (*hotPlugStateGet)(struct HdmiCntlr *cntlr);
57    bool (*hotPlugInterruptStateGet)(struct HdmiCntlr *cntlr);
58    void (*lowPowerSet)(struct HdmiCntlr *cntlr, bool enable);
59    void (*tmdsModeSet)(struct HdmiCntlr *cntlr, enum HdmiTmdsModeType mode);
60    int32_t (*tmdsConfigSet)(struct HdmiCntlr *cntlr, struct HdmiTmdsConfig mode);
61    void (*infoFrameEnable)(struct HdmiCntlr *cntlr, enum HdmiPacketType infoFrameType, bool enable);
62    int32_t (*infoFrameSend)(struct HdmiCntlr *cntlr, enum HdmiPacketType infoFrameType, uint8_t *data, uint32_t len);
63    int32_t (*infoFrameDataSet)(struct HdmiCntlr *cntlr, uint32_t type, uint8_t *data, uint32_t len);
64    int32_t (*cecMsgSend)(struct HdmiCntlr *cntlr, struct HdmiCecMsg *msg);
65    void (*audioPathEnable)(struct HdmiCntlr *cntlr, bool enable);
66    void (*audioPathSet)(struct HdmiCntlr *cntlr, struct HdmiAudioConfigInfo *config);
67    void (*phyOutputEnable)(struct HdmiCntlr *cntlr, bool enable);
68    void (*phyOutputSet)(struct HdmiCntlr *cntlr, struct HdmiPhyCfg *cfg);
69    void (*blackDataSet)(struct HdmiCntlr *cntlr, bool enable);
70    void (*videoMuteEnable)(struct HdmiCntlr *cntlr, bool enable);
71    void (*videoPathSet)(struct HdmiCntlr *cntlr, struct HdmiVideoAttr *attr);
72    void (*audioMuteEnable)(struct HdmiCntlr *cntlr, bool enable);
73    void (*avmuteSet)(struct HdmiCntlr *cntlr, bool enable);
74    int32_t (*ddcTransfer)(struct HdmiCntlr *cntlr, struct HdmiDdcCfg *ddcCfg);
75    bool (*scdcSourceScrambleGet)(struct HdmiCntlr *cntlr);
76    int32_t (*scdcSourceScrambleSet)(struct HdmiCntlr *cntlr, bool enable);
77    void (*frlSet)(struct HdmiCntlr *cntlr);
78    int32_t (*frlEnable)(struct HdmiCntlr *cntlr, bool enable);
79    int32_t (*audioNctsSet)(struct HdmiCntlr *cntlr, struct HdmiFrlAudioNctsConfig *cfg);
80    void (*frlTrainingConfigSet)(struct HdmiCntlr *cntlr, struct HdmiFrlTrainConfig *cfg);
81    void (*frlTrainingStart)(struct HdmiCntlr *cntlr);
82    void (*frlGetTriningRslt)(struct HdmiCntlr *cntlr, struct HdmiFrlTrainRslt *rslt);
83    void (*hdcpRegInit)(struct HdmiCntlr *cntlr);
84    int32_t (*hdcpGenerateAksvAndAn)(struct HdmiCntlr *cntlr);
85    int32_t (*hdcpOptReg)(struct HdmiCntlr *cntlr, enum HdmiHdcpRegOptType type, uint8_t *data, uint32_t len);
86    void (*hdrTimerSet)(struct HdmiCntlr *cntlr, struct HdmiHdrTimerConfig *config);
87};
88```
89
90**表 1** HdmiCntlrOps结构体成员的回调函数功能说明
91
92| 函数成员 | 入参 | 出参 | 返回值 | 功能 |
93| ------------------------ | ------------------------------------------------------------ | -------------------------------------- | ------------------ | -------------------------------------------------- |
94| hardWareInit | **cntlr**：结构体指针，核心层HDMI控制器 | 无 | 无 | 初始化HDMI硬件 |
95| hardWareStatusGet | **cntlr**：结构体指针，核心层HDMI控制器<br /> | **status**：HDMI硬件状态 ; | 无 | 获取HDMI当前硬件状态 |
96| controllerReset | **cntlr**：结构体指针，核心层HDMI控制器 | 无 | 无 | 复位HDMI控制器 |
97| hotPlugStateGet | **cntlr**：结构体指针，核心层HDMI控制器 | 无 | bool：HDMI热插拔状态 | 获取HDMI热插拔状态 |
98| hotPlugInterruptStateGet | **cntlr**：结构体指针，核心层HDMI控制器 | 无 | bool：HDMI热插拔中断状态 | 获取HDMI热插拔中断状态 |
99| lowPowerSet | **cntlr**：结构体指针，核心层HDMI控制器<br />**enable**：bool，使能/去使能 | 无 | 无 | 使能/去使能低功耗 |
100| tmdsModeSet | **cntlr**：结构体指针，核心层HDMI控制器<br />**mode**：TMDS模式 | 无 | 无 | 设置TMDS模式 |
101| tmdsConfigSet | **cntlr**：结构体指针，核心层HDMI控制器<br />**mode**：TMDS参数 | 无 | HDF_STATUS相关状态 | 配置TMDS参数 |
102| infoFrameEnable | **cntlr**：结构体指针，核心层HDMI控制器<br />**infoFrameType**：packet类型<br />**enable**：bool，使能/去使能 | 无 | 无 | 使能/去使能infoFrame |
103| infoFrameSend | **cntlr**：结构体指针，核心层HDMI控制器<br />**infoFrameType**：packet类型<br />**data**：infoFrame数据<br />**len**：数据长度 | 无 | HDF_STATUS相关状态 | 发送infoFrame |
104| cecMsgSend | **cntlr**：结构体指针，核心层HDMI控制器<br />**msg**：CEC消息 | 无 | HDF_STATUS相关状态 | 发送CEC消息 |
105| audioPathEnable | **cntlr**：结构体指针，核心层HDMI控制器<br />**enable**：bool，使能/去使能| 无 | 无 | 使能/去使能audio通路 |
106| audioPathSet | **cntlr**：结构体指针，核心层HDMI控制器<br />**config**：配置信息 | 无 | 无 | 设置audio通路配置信息 |
107| phyOutputEnable | **cntlr**：结构体指针，核心层HDMI控制器<br />**enable**：bool，使能/去使能 | 无 | 无 | 使能/去使能物理层输出状态 |
108| phyOutputSet | **cntlr**：结构体指针，核心层HDMI控制器<br />**cfg**：配置信息 | 无 | 无 | 设置物理层配置信息 |
109| blackDataSet | **cntlr**：结构体指针，核心层HDMI控制器<br />**enable**：bool，使能/去使能 | 无 | 无 | 设置黑屏 |
110| videoMuteEnable | **cntlr**：结构体指针，核心层HDMI控制器<br />**enable**：bool，使能/去使能 | 无 | 无 | 使能/去使能video静音 |
111| videoPathSet | **cntlr**：结构体指针，核心层HDMI控制器<br />**attr**：配置信息| 无 | 无 | 设置video通路配置信息 |
112|audioMuteEnable | **cntlr**：结构体指针，核心层HDMI控制器<br />**enable**：bool，使能/去使能 | 无 | 无 | 使能/去使能audio静音 |
113| avmuteSet | **cntlr**：结构体指针，核心层HDMI控制器<br />**enable**：bool，使能/去使能| 无 | 无 | 使能/去使能声音图像消隐 |
114| ddcTransfer | **cntlr**：结构体指针，核心层HDMI控制器<br />**ddcCfg**：DDC配置参数 |**ddcCfg**：DDC配置参数 |HDF_STATUS相关状态 | 读写DDC数据 |
115| scdcSourceScrambleGet | **cntlr**：结构体指针，核心层HDMI控制器 | 无 | bool，加扰状态 | 获取source端的加扰状态 |
116| scdcSourceScrambleSet | **cntlr**：结构体指针，核心层HDMI控制器<br />**enable**：bool，使能/去使能 | 无 | HDF_STATUS相关状态 | 使能/去使能source端的加扰 |
117| frlEnable | **cntlr**：结构体指针，核心层HDMI控制器<br />**enable**：bool，使能/去使能 | 无 | HDF_STATUS相关状态 | 使能/去使能FRL |
118| audioNctsSet | **cntlr**：结构体指针，核心层HDMI控制器<br />**cfg**：N/CTS配置参数 | 无 | HDF_STATUS相关状态 | 设置audio的N/CTS信息 |
119| frlTrainingConfigSet | **cntlr**：结构体指针，核心层HDMI控制器<br />**cfg**：FRL Training配置参数 | 无 | 无| 设置FRL Training配置信息 |
120| frlTrainingStart | **cntlr**：结构体指针，核心层HDMI控制器 | 无 | 无 | 开始FRL Training流程 |
121| frlGetTriningRslt | **cntlr**：结构体指针，核心层HDMI控制器 | **rslt**：FRL Training结果 | 无 | 获取FRL Training结果 |
122| hdcpRegInit | **cntlr**：结构体指针，核心层HDMI控制器 | 无 | 无 | 初始化HDCP流程相关的寄存器 |
123|hdcpGenerateAksvAndAn |**cntlr**：结构体指针，核心层HDMI控制器 | 无 | HDF_STATUS相关状态 | HDCP流程中生成aksv和an |
124| hdcpOptReg | **cntlr**：结构体指针，核心层HDMI控制器<br />**type**：操作类型<br />**data**：寄存器数据<br />**len**：数据长度 | **data**：寄存器数据 | HDF_STATUS相关状态 | HDCP流程中读写相关寄存器 |
125| hdrTimerSet | **cntlr**：结构体指针，核心层HDMI控制器<br />**config**：timer配置信息 | 无 | 无 | 设置HDR相关的timer配置信息 |
126
127
128### 开发步骤
129
130HDMI模块适配包含以下四个步骤：
131
132- 实例化驱动入口
133
134    - 实例化HdfDriverEntry结构体成员。
135
136    - 调用HDF_INIT将HdfDriverEntry实例化对象注册到HDF框架中。
137
138- 配置属性文件
139
140    - 在device_info.hcs文件中添加deviceNode描述。
141
142    - 【可选】添加hdmi_config.hcs器件属性文件。
143
144- 实例化HDMI控制器对象
145
146    - 初始化HdmiCntlr成员。
147
148    - 实例化HdmiCntlr成员HdmiCntlrOps方法集合。
149
150- 驱动调试
151
152    【可选】针对新增驱动程序，建议验证驱动基本功能，例如挂载后的信息反馈，HDMI传输等。
153
1541. 实例化驱动入口
155
156    驱动入口必须为HdfDriverEntry（在hdf_device_desc.h中定义）类型的全局变量，且moduleName要和device_info.hcs中保持一致。HDF框架会将所有加载的驱动的HdfDriverEntry对象首地址汇总，形成一个类似数组的段地址空间，方便上层调用。
157
158    一般在加载驱动时HDF会先调用Bind函数，再调用Init函数加载该驱动。当Init调用异常时，HDF框架会调用Release释放驱动资源并退出。
159
160    HDMI驱动入口参考：
161
162    ```c
163    struct HdfDriverEntry g_hdmiDriverEntry = {
164        .moduleVersion = 1,
165        .Bind = HdmiAdapterBind,
166        .Init = HdmiAdapterInit,
167        .Release = HdmiAdapterRelease,
168        .moduleName = "adapter_hdmi_driver", // 【必要且与HCS文件中里面的moduleName匹配】
169    };
170    HDF_INIT(g_hdmiDriverEntry);             // 调用HDF_INIT将驱动入口注册到HDF框架中
171    ```
172
1732. 配置属性文件
174
175    完成驱动入口注册之后，下一步请在device_info.hcs文件中添加deviceNode信息，并在hdmi_config.hcs中配置器件属性。deviceNode信息与驱动入口注册相关，器件属性值对于厂商驱动的实现以及核心层HdmiCntlr相关成员的默认值或限制范围有密切关系。从第一个节点开始配置具体HDMI控制器信息，此节点并不表示某一路HDMI控制器，而是代表一个资源性质设备，用于描述一类HDMI控制器的信息。本例只有一个HDMI控制器，如有多个控制器，则需要在device_info文件增加deviceNode信息，以及在hdmi_config文件中增加对应的器件属性。
176
177    - device_info.hcs配置参考
178
179        ```c
180        root {
181            platform :: host {
182                 device_hdmi :: device {
183                    device0 :: deviceNode {
184                        policy = 2;                                // 等于2，需要发布服务。
185                        priority = 20;                             // 驱动启动优先级。
186                        permission = 0644;                         // 驱动创建设备节点权限。
187                        serviceName = "HDF_PLATFORM_HDMI_0";       //【必要】驱动对外发布服务的名称，必须唯一。
188                        moduleName = "hdmi_driver";                //【必要】用于指定驱动名称，需要与期望的驱动Entry中的moduleName一致。
189                        deviceMatchAttr = "adapter_hdmi_driver";   //【必要】用于配置控制器私有数据，要与hdmi_config.hcs中对应控制器保持一致。
190                    }                                              // 具体的控制器信息在hdmi_config.hcs中。
191                 }
192            }
193        }
194        ```
195
196    - hdmi_config.hcs 配置参考
197
198        ```c
199        root {
200            platform {
201                hdmi_config {
202                    template hdmi_controller {     // 模板公共参数，继承该模板的节点如果使用模板中的默认值，则节点字段可以缺省。
203                        match_attr = "";           //【必要】需要和device_info.hcs中的deviceMatchAttr值一致。
204                        index = 0;                 //【必要】hdmi控制器编号
205                        regBasePhy = 0x10100000;   //【必要】寄存器物理基地址
206                        regSize = 0xd1;            //【必要】寄存器位宽
207                        irqNum = 100;              //【必要】中断号
208                        maxTmdsClock = 300;
209                        videoTiming = 10;
210                        quantization = 1;
211                        colorSpace = 0;
212                        colorimetry = 0;
213                        audioIfType = 0;
214                        audioBitDepth = 1;
215                        audioSampleRate = 2;
216                        audioChannels = 1;
217                        hdrColorimetry = 4;
218                        hdrUserMode = 1;
219                        cap = 0xd001e045;
220                    }
221                    controller_0x10100000 :: hdmi_controller {
222                        match_attr = "adapter_hdmi_driver";
223                        index = 0;
224                        regBasePhy = 0x10100000;
225                        irqNum = 100;
226                        maxTmdsClock = 400;
227                        defTmdsClock = 300;
228                        maxFrlRate = 600;
229                        videoTiming = 10;
230                        quantization = 1;
231                        colorSpace = 0;
232                        colorimetry = 0;
233                        audioIfType = 0;
234                        audioSampleRate = 2;
235                        audioChannels = 1;
236                        hdrColorimetry = 4;
237                        hdrUserMode = 1;
238                        cap = 0xd001e045;
239                    }
240                }
241            }
242        }
243        ```
244
245        需要注意的是，新增hdmi_config.hcs配置文件后，必须在对应的hdf.hcs文件中包含hdmi_config.hcs所在路径信息，否则配置文件无法生效。
246
2473. 实例化HDMI控制器对象
248
249    最后一步，完成驱动入口注册之后，要以核心层HdmiCntlr对象的初始化为核心，包括厂商自定义结构体（传递参数和数据），实例化HdmiCntlr成员HdmiCntlrOps（让用户可以通过接口来调用驱动底层函数），实现HdfDriverEntry成员函数（Bind，Init，Release）。
250
251    - 自定义结构体参考
252
253        > ![](../public_sys-resources/icon-note.gif) **说明：**<br>
254        > 从驱动角度看，自定义结构体是参数和数据的载体。HDF会读取hdmi_config.hcs文件中的数值并通过DeviceResourceIface来初始化结构体成员，且其中一些重要数值（例如设备号、总线号等）也会被传递给核心层HdmiCntlr对象。
255
256        ```c
257        struct HdmiAdapterHost {
258            struct HdmiCntlr *cntlr;        //【必要】是核心层控制对象，具体描述如下。
259            volatile unsigned char *regBase;//【必要】寄存器基地址
260            uint32_t regBasePhy;            //【必要】寄存器物理基地址
261            uint32_t regSize;               //【必要】寄存器位宽
262            uint32_t irqNum;                //【必要】中断号
263        };
264
265        struct HdmiCntlr {
266            struct IDeviceIoService service;
267            struct HdfDeviceObject *hdfDevObj;
268            struct PlatformDevice device;
269            struct OsalMutex mutex;
270            struct PlatformQueue *msgQueue;
271            struct HdmiCntlrCap cap;
272            struct HdmiAttr attr;
273            struct HdmiCntlrOps *ops;
274            uint32_t deviceIndex;
275            uint32_t state;                 // 控制器状态
276            enum HdmiTmdsModeType tmdsMode;
277            struct HdmiDevice *hdmi;
278            struct HdmiInfoframe infoframe;
279            struct HdmiScdc *scdc;
280            struct HdmiDdc ddc;
281            struct HdmiFrl *frl;
282            struct HdmiHdcp *hdcp;
283            struct HdmiCec *cec;
284            struct HdmiEvent event;
285            struct HdmiHdr *hdr;
286            void *priv;
287        };
288        ```
289
290    -  HdmiCntlr成员回调函数结构体HdmiCntlrOps的实例化
291
292        ```c
293        static struct HdmiCntlrOps g_hdmiAdapterHostOps = {
294            .hardWareInit = HdmiAdapterHardWareInit,
295            .hardWareStatusGet = HdmiAdapterHardWareStatusGet,
296            .controllerReset = HdmiAdapterControllerReset,
297            .hotPlugStateGet = HdmiAdapterHotPlugStateGet,
298            .hotPlugInterruptStateGet = HdmiAdapterHotPlugInterruptStateGet,
299            .lowPowerSet = HdmiAdapterLowPowerSet,
300            .tmdsModeSet = HdmiAdapterTmdsModeSet,
301            .tmdsConfigSet = HdmiAdapterTmdsConfigSet,
302            .infoframeEnable = HdmiAdapterInfoframeEnable,
303            .infoframeSend = HdmiAdapterInfoframeSend,
304            .infoframeDataSet = HdmiAdapterInfoframeDataSet,
305            .cecMsgSend = HdmiAdapterCecMsgSend,
306            .audioPathEnable = HdmiAdapterAudioPathEnable,
307            .audioPathSet = HdmiAdapterAudioPathSet,
308            .phyOutputEnable = HdmiAdapterPhyOutputEnable,
309            .phyOutputSet = HdmiAdapterPhyOutputSet,
310            .blackDataSet = HdmiAdapterBlackDataSet,
311            .videoMuteEnable = HdmiAdapterVideoMuteEnable,
312            .videoPathSet = HdmiAdapterVideoPathSet,
313            .audioMuteEnable = HdmiAdapterAudioMuteEnable,
314            .avmuteSet = HdmiAdapterAvmuteSet,
315            .ddcTransfer = HdmiAdapterDdcTransfer,
316            .scdcSourceScrambleGet = HdmiAdapterScdcSourceScrambleGet,
317            .scdcSourceScrambleSet = HdmiAdapterScdcSourceScrambleSet,
318            .frlSet = HdmiAdapterFrlSet,
319            .frlEnable = HdmiAdapterFrlEnable,
320            .audioNctsSet = HdmiAdapterAudioNctsSet,
321            .frlTrainingConfigSet = HdmiAdapterFrlTrainingConfigSet,
322            .frlTrainingStart = HdmiAdapterFrlTrainingStart,
323            .frlGetTriningRslt = HdmiAdapterFrlGetTriningRslt,
324            .hdcpRegInit = HdmiAdapterHdcpRegInit,
325            .hdcpGenerateAksvAndAn = HdmiAdapterHdcpGenerateAksvAndAn,
326            .hdcpOptReg = HdmiAdapterHdcpOptReg,
327            .hdrTimerSet = HdmiAdapterHdrTimerSet,
328        };
329        ```
330
331    - Bind函数参考
332
333        **入参：**
334
335        HdfDeviceObject是整个驱动对外呈现的接口参数，具备HCS配置文件的信息。
336
337        **返回值：**
338
339        HDF_STATUS相关状态 （表2为部分展示，如需使用其他状态，可参考//drivers/hdf_core/interfaces/inner_api/utils/hdf_base.h中HDF_STATUS的定义）。
340
341        **表 2** HDF_STATUS相关状态说明
342
343        | 状态(值) | 问题描述 |
344        | -------- | -------- |
345        | HDF_ERR_INVALID_OBJECT | 控制器对象非法 |
346        | HDF_ERR_MALLOC_FAIL | 内存分配失败 |
347        | HDF_ERR_IO | I/O&nbsp;错误 |
348        | HDF_SUCCESS | 初始化成功 |
349        | HDF_FAILURE | 初始化失败 |
350
351        **函数说明：**
352
353        初始化自定义结构体对象HdmiAdapterHost，初始化HdmiCntlr成员，调用核心层HdmiCntlrAdd函数。
354
355        HdmiCntlr，HdmiAdapterHost，HdfDeviceObject之间互相赋值，方便其他函数可以相互转化。
356
357        ```c
358        static int32_t HdmiAdapterBind(struct HdfDeviceObject *obj)
359        {
360            struct HdmiCntlr *cntlr = NULL;
361            struct HimciAdapterHost *host = NULL;
362            int32_t ret;
363            cntlr = (struct HdmiCntlr *)OsalMemCalloc(sizeof(struct HdmiCntlr));
364            if (cntlr == NULL) {
365                HDF_LOGE("%s: malloc cntlr failed!", __func__);
366                return HDF_ERR_MALLOC_FAIL;
367            }
368            host = (struct HimciAdapterHost *)OsalMemCalloc(sizeof(struct HimciAdapterHost));
369            if (host == NULL) {
370                HDF_LOGE("%s: malloc host failed!", __func__);
371                return HDF_ERR_MALLOC_FAIL;
372            }
373            cntlr->priv = (void *)host;              //【必要】将host存放至cntlr的私有数据
374            cntlr->ops = &g_hdmiHostOps;             //【必要】HdmiCntlrOps的实例化对象的挂载
375            cntlr->hdfDevObj = obj;                  //【必要】使HdfDeviceObject与HdmiCntlr可以相互转化的前提
376            obj->service = &cntlr->service;          //【必要】使HdfDeviceObject与HdmiCntlr可以相互转化的前提
377            ret = HdmiAdapterCntlrParse(cntlr, obj); //【必要】初始化cntlr，失败则goto __ERR。
378            ......
379            ret = HdmiAdapterHostParse(host, obj);   //【必要】初始化host对象的相关属性，失败则goto __ERR。
380            ......
381            ret = HdmiAdapterHostInit(host, cntlr);  // 厂商自定义的初始化，失败则goto __ERR。
382            ......
383            ret = HdmiCntlrAdd(cntlr);               // 调用核心层函数，失败则goto __ERR。
384            ......
385            HDF_LOGD("HdmiAdapterBind: success.");
386            return HDF_SUCCESS;
387        __ERR:
388            HdmiAdapterDeleteHost(host);
389            HDF_LOGD("HdmiAdapterBind: fail, err = %d.", ret);
390            return ret;
391        }
392        ```
393
394    - Init函数参考
395
396        **入参：**
397
398        HdfDeviceObject是整个驱动对外暴露的接口参数，具备HCS配置文件的信息。
399
400        **返回值：**
401
402        HDF_STATUS相关状态。
403
404        **函数说明**：
405
406        实现HdmiAdapterInit函数。
407
408        ```c
409        static int32_t HdmiAdapterInit(struct HdfDeviceObject *obj)
410        {
411            return HDF_SUCCESS;
412        }
413        ```
414
415    - Release函数参考
416
417        **入参：**
418
419        HdfDeviceObject是整个驱动对外暴露的接口参数，具备HCS配置文件的信息。
420
421        **返回值：**
422
423        无
424
425        **函数说明：**
426
427        释放内存和删除控制器，该函数需要在驱动入口结构体中赋值给Release接口，当HDF框架调用Init函数初始化驱动失败时，可以调用Release释放驱动资源。
428
429        > ![](../public_sys-resources/icon-note.gif) **说明：**<br>
430        > 所有强制转换获取相应对象的操作前提是在Init函数中具备对应赋值的操作。
431
432        ```c
433        static void HdmiAdapterRelease(struct HdfDeviceObject *obj)
434        {
435            struct HdmiCntlr *cntlr = NULL;
436            ......
437            cntlr = (struct HdmiCntlr *)obj->service;               // 这里有HdfDeviceObject到HdmiCntlr的强制转化，通过service成员，赋值见Bind函数。
438            ......
439            HimciDeleteHost((struct HimciAdapterHost *)cntlr->priv);// 厂商自定义的内存释放函数，这里有HdmiCntlr到HimciAdapterHost的强制转化。
440        }
441        ```
442
4434. 驱动调试
444
445    【可选】针对新增驱动程序，建议验证驱动基本功能，例如挂载后的信息反馈，HDMI传输等。
446