Skip to content

D
Docs

OpenHarmony / Docs
大约 2 年 前同步成功

通知 161
Star 293
Fork 28
D
Docs
未验证 提交 2fbe7df9 编写于 作者: O openharmony_ci 提交者： Gitee
浏览文件
操作

!3966 【OpenHarmony开源贡献者计划2022】GPIO&HDMI相关格式及表达问题 

Merge pull request !3966 from king_he/hdmi-1
上级 4d00c4c1 e0d86218
显示空白变更内容
内联 并排
Showing with 119 addition and 124 deletion
zh-cn/device-dev/driver/driver-platform-gpio-des.md
浏览文件 @ 2fbe7df9
...@@ -26,7 +26,7 @@ GPIO接口定义了操作GPIO管脚的标准方法集合，包括： ...@@ -26,7 +26,7 @@ GPIO接口定义了操作GPIO管脚的标准方法集合，包括：
| GPIO配置 | -&nbsp;GpioSetDir：设置管脚方向<br/>-&nbsp;GpioGetDir：获取管脚方向 | | GPIO配置 | -&nbsp;GpioSetDir：设置管脚方向<br/>-&nbsp;GpioGetDir：获取管脚方向 |
| GPIO中断设置 | -&nbsp;GpioSetIrq：设置管脚对应的中断服务函数<br/>-&nbsp;GpioUnSetIrq：取消管脚对应的中断服务函数<br/>-&nbsp;GpioEnableIrq：使能管脚中断<br/>-&nbsp;GpioDisableIrq：禁止管脚中断 | | GPIO中断设置 | -&nbsp;GpioSetIrq：设置管脚对应的中断服务函数<br/>-&nbsp;GpioUnSetIrq：取消管脚对应的中断服务函数<br/>-&nbsp;GpioEnableIrq：使能管脚中断<br/>-&nbsp;GpioDisableIrq：禁止管脚中断 |
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**<br>
> 本文涉及的所有接口，仅限内核态使用，不支持在用户态使用。 > 本文涉及的所有接口，仅限内核态使用，不支持在用户态使用。
...@@ -154,7 +154,7 @@ GPIO标准API通过GPIO管脚号来操作指定管脚，使用GPIO的一般流 ...@@ -154,7 +154,7 @@ GPIO标准API通过GPIO管脚号来操作指定管脚，使用GPIO的一般流
| 0 | 设置成功 | | 0 | 设置成功 |
| 负数 | 设置失败 | | 负数 | 设置失败 |
> ![icon-caution.gif](public_sys-resources/icon-caution.gif) **注意：** > ![icon-caution.gif](public_sys-resources/icon-caution.gif) **注意：**<br>
> 同一时间，只能为某个GPIO管脚设置一个中断服务函数，如果重复调用GpioSetIrq函数，则之前设置的中断服务函数会被取代。 > 同一时间，只能为某个GPIO管脚设置一个中断服务函数，如果重复调用GpioSetIrq函数，则之前设置的中断服务函数会被取代。
当不再需要响应中断服务函数时，使用如下函数取消中断设置： 当不再需要响应中断服务函数时，使用如下函数取消中断设置：
...@@ -183,7 +183,7 @@ GPIO标准API通过GPIO管脚号来操作指定管脚，使用GPIO的一般流 ...@@ -183,7 +183,7 @@ GPIO标准API通过GPIO管脚号来操作指定管脚，使用GPIO的一般流
| 0 | 使能成功 | | 0 | 使能成功 |
| 负数 | 使能失败 | | 负数 | 使能失败 |
> ![icon-caution.gif](public_sys-resources/icon-caution.gif) **注意：** > ![icon-caution.gif](public_sys-resources/icon-caution.gif) **注意：**<br>
> 必须通过此函数使能管脚中断，之前设置的中断服务函数才能被正确响应。 > 必须通过此函数使能管脚中断，之前设置的中断服务函数才能被正确响应。
如果要临时屏蔽此中断，可以通过如下函数禁止GPIO管脚中断： 如果要临时屏蔽此中断，可以通过如下函数禁止GPIO管脚中断：
......
zh-cn/device-dev/driver/driver-platform-gpio-develop.md
浏览文件 @ 2fbe7df9
...@@ -3,9 +3,7 @@ ...@@ -3,9 +3,7 @@
## 概述 ## 概述
GPIO（General-purpose input/output）即通用型输入输出，在HDF框架中， GPIO（General-purpose input/output）即通用型输入输出，在HDF框架中，GPIO的接口适配模式采用无服务模式，用于不需要在用户态提供API的设备类型，或者没有用户态和内核区分的OS系统，其关联方式是DevHandle直接指向设备对象内核态地址（DevHandle是一个void类型指针）。
GPIO的接口适配模式采用无服务模式，用于不需要在用户态提供API的设备类型，或者没有用户态和内核区分的OS系统，其关联方式是DevHandle直接指向设备对象内核态地址（DevHandle是一个void类型指针）。
**图1** GPIO无服务模式结构图 **图1** GPIO无服务模式结构图
...@@ -37,35 +35,35 @@ struct GpioMethod { ...@@ -37,35 +35,35 @@ struct GpioMethod {
| 函数成员 | 入参 | 出参 | 返回值 | 功能 | | 函数成员 | 入参 | 出参 | 返回值 | 功能 |
| -------- | -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- | -------- |
| write | cntlr：结构体指针，核心层GPIO控制器；<br/>local：uint16_t，GPIO端口标识号&nbsp;；<br/>val：uint16_t，电平传入值； | 无 | HDF_STATUS相关状态 | GPIO引脚写入电平值 | | write | cntlr：结构体指针，核心层GPIO控制器<br/>local：uint16_t，GPIO端口标识号<br/>val：uint16_t，电平传入值 | 无 | HDF_STATUS相关状态 | GPIO引脚写入电平值 |
| read | cntlr：结构体指针，核心层GPIO控制器；<br/>local：uint16_t，GPIO端口标识； | val：uint16_t&nbsp;指针，用于传出电平值。 | HDF_STATUS相关状态 | GPIO引脚读取电平值 | | read | cntlr：结构体指针，核心层GPIO控制器<br/>local：uint16_t，GPIO端口标识 | val：uint16_t指针，用于传出电平值。 | HDF_STATUS相关状态 | GPIO引脚读取电平值 |
| setDir | cntlr：结构体指针，核心层GPIO控制器；<br/>local：uint16_t，GPIO端口标识号&nbsp;；<br/>dir：uint16_t，管脚方向传入值； | 无 | HDF_STATUS相关状态 | 设置GPIO引脚输入/输出方向 | | setDir | cntlr：结构体指针，核心层GPIO控制器<br/>local：uint16_t，GPIO端口标识号<br/>dir：uint16_t，管脚方向传入值 | 无 | HDF_STATUS相关状态 | 设置GPIO引脚输入/输出方向 |
| getDir | cntlr：结构体指针，核心层GPIO控制器；<br/>local：uint16_t，GPIO端口标识号； | dir：uint16_t&nbsp;指针，用于传出管脚方向值。 | HDF_STATUS相关状态 | 读GPIO引脚输入/输出方向 | | getDir | cntlr：结构体指针，核心层GPIO控制器<br/>local：uint16_t，GPIO端口标识号 | dir：uint16_t指针，用于传出管脚方向值 | HDF_STATUS相关状态 | 读GPIO引脚输入/输出方向 |
| setIrq | cntlr：结构体指针，核心层GPIO控制器；<br/>local：uint16_t，GPIO端口标识号；<br/>mode：uint16_t，表示触发模式（边沿或电平）；<br/>func：函数指针，中断服务程序；<br/>arg：void指针，中断服务程序入参； | 无 | HDF_STATUS相关状态 | 将GPIO引脚设置为中断模式 | | setIrq | cntlr：结构体指针，核心层GPIO控制器<br/>local：uint16_t，GPIO端口标识号<br/>mode：uint16_t，表示触发模式（边沿或电平）<br/>func：函数指针，中断服务程序；<br/>arg：void指针，中断服务程序入参 | 无 | HDF_STATUS相关状态 | 将GPIO引脚设置为中断模式 |
| unsetIrq | cntlr：结构体指针，核心层GPIO控制器；<br/>local：uint16_t，GPIO端口标识号； | 无 | HDF_STATUS相关状态 | 取消GPIO中断设置 | | unsetIrq | cntlr：结构体指针，核心层GPIO控制器<br/>local：uint16_t，GPIO端口标识号 | 无 | HDF_STATUS相关状态 | 取消GPIO中断设置 |
| enableIrq | cntlr：结构体指针，核心层GPIO控制器；<br/>local：uint16_t，GPIO端口标识号； | 无 | HDF_STATUS相关状态 | 使能GPIO管脚中断 | | enableIrq | cntlr：结构体指针，核心层GPIO控制器<br/>local：uint16_t，GPIO端口标识号 | 无 | HDF_STATUS相关状态 | 使能GPIO管脚中断 |
| disableIrq | cntlr：结构体指针，核心层GPIO控制器；<br/>local：uint16_t，GPIO端口标识号； | 无 | HDF_STATUS相关状态 | 禁止GPIO管脚中断 | | disableIrq | cntlr：结构体指针，核心层GPIO控制器<br/>local：uint16_t，GPIO端口标识号 | 无 | HDF_STATUS相关状态 | 禁止GPIO管脚中断 |
## 开发步骤 ## 开发步骤
GPIO模块适配的三个环节是配置属性文件，实例化驱动入口，以及实例化核心层接口函数。GPIO控制器分组管理所有管脚，相关参数会在属性文件中有所体现；驱动入口和接口函数的实例化环节是厂商驱动接入HDF的核心环节。 GPIO模块适配的三个环节是配置属性文件，实例化驱动入口，以及实例化核心层接口函数。GPIO控制器分组管理所有管脚，相关参数会在属性文件中有所体现；驱动入口和接口函数的实例化环节是厂商驱动接入HDF的核心环节。
1. **实例化驱动入口：** 1. 实例化驱动入口：
- 实例化HdfDriverEntry结构体成员。 - 实例化HdfDriverEntry结构体成员。
- 调用HDF_INIT将HdfDriverEntry实例化对象注册到HDF框架中。 - 调用HDF_INIT将HdfDriverEntry实例化对象注册到HDF框架中。
2. **配置属性文件：** 2. 配置属性文件：
- 在device_info.hcs文件中添加deviceNode描述。 - 在device_info.hcs文件中添加deviceNode描述。
- 【可选】添加gpio_config.hcs器件属性文件。 - 【可选】添加gpio_config.hcs器件属性文件。
3. **实例化GPIO控制器对象：** 3. 实例化GPIO控制器对象：
- 初始化GpioCntlr成员。 - 初始化GpioCntlr成员。
- 实例化GpioCntlr成员GpioMethod。 - 实例化GpioCntlr成员GpioMethod。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**<br>
> 实例化GpioCntlr成员GpioMethod，详见[接口说明](#接口说明)。 > 实例化GpioCntlr成员GpioMethod，详见[接口说明](#接口说明)。
4. **驱动调试：** 4. 驱动调试：
【可选】针对新增驱动程序，建议验证驱动基本功能，例如GPIO控制状态，中断响应情况等。 【可选】针对新增驱动程序，建议验证驱动基本功能，例如GPIO控制状态，中断响应情况等。
...@@ -81,19 +79,19 @@ GPIO模块适配的三个环节是配置属性文件，实例化驱动入口， ...@@ -81,19 +79,19 @@ GPIO模块适配的三个环节是配置属性文件，实例化驱动入口，
``` ```
struct HdfDriverEntry g_gpioDriverEntry = { struct HdfDriverEntry g_gpioDriverEntry = {
.moduleVersion = 1, .moduleVersion = 1,
.Bind = Pl061GpioBind, //GPIO不需要实现Bind,本例是一个空实现，厂商可根据自身需要添加相关操作 .Bind = Pl061GpioBind, // GPIO不需要实现Bind,本例是一个空实现，厂商可根据自身需要添加相关操作
.Init = Pl061GpioInit, //见Init参考 .Init = Pl061GpioInit, // 见Init参考
.Release = Pl061GpioRelease, //见Release参考 .Release = Pl061GpioRelease, // 见Release参考
.moduleName = "hisi_pl061_driver",//【必要且需要与HCS文件中里面的moduleName匹配】 .moduleName = "hisi_pl061_driver",//【必要且需要与HCS文件中里面的moduleName匹配】
}; };
//调用HDF_INIT将驱动入口注册到HDF框架中 // 调用HDF_INIT将驱动入口注册到HDF框架中
HDF_INIT(g_gpioDriverEntry); HDF_INIT(g_gpioDriverEntry);
``` ```
2. 完成驱动入口注册之后，下一步请在device_info.hcs文件中添加deviceNode信息，并在 gpio_config.hcs 中配置器件属性。deviceNode信息与驱动入口注册相关，器件属性值与核心层GpioCntlr 成员的默认值或限制范围有密切关系。 2. 完成驱动入口注册之后，下一步请在device_info.hcs文件中添加deviceNode信息，并在 gpio_config.hcs 中配置器件属性。deviceNode信息与驱动入口注册相关，器件属性值与核心层GpioCntlr 成员的默认值或限制范围有密切关系。
本例只有一个GPIO控制器，如有多个器件信息，则需要在device_info文件增加deviceNode信息，以及在gpio_config文件中增加对应的器件属性。 本例只有一个GPIO控制器，如有多个器件信息，则需要在device_info文件增加deviceNode信息，以及在gpio_config文件中增加对应的器件属性。
- device_info.hcs 配置参考。 - device_info.hcs配置参考
``` ```
root { root {
...@@ -108,14 +106,14 @@ GPIO模块适配的三个环节是配置属性文件，实例化驱动入口， ...@@ -108,14 +106,14 @@ GPIO模块适配的三个环节是配置属性文件，实例化驱动入口，
permission = 0644; // 驱动创建设备节点权限 permission = 0644; // 驱动创建设备节点权限
moduleName = "hisi_pl061_driver"; //【必要】用于指定驱动名称，需要与期望的驱动Entry中的moduleName一致； moduleName = "hisi_pl061_driver"; //【必要】用于指定驱动名称，需要与期望的驱动Entry中的moduleName一致；
deviceMatchAttr = "hisilicon_hi35xx_pl061";//【必要】用于配置控制器私有数据，要与 gpio_config.hcs 中 deviceMatchAttr = "hisilicon_hi35xx_pl061";//【必要】用于配置控制器私有数据，要与 gpio_config.hcs 中
//对应控制器保持一致，其他控制器信息也在文件中 // 对应控制器保持一致，其他控制器信息也在文件中
} }
} }
} }
} }
} }
``` ```
- gpio_config.hcs 配置参考。 - gpio_config.hcs配置参考
``` ```
root { root {
...@@ -123,7 +121,7 @@ GPIO模块适配的三个环节是配置属性文件，实例化驱动入口， ...@@ -123,7 +121,7 @@ GPIO模块适配的三个环节是配置属性文件，实例化驱动入口，
gpio_config { gpio_config {
controller_0x120d0000 { controller_0x120d0000 {
match_attr = "hisilicon_hi35xx_pl061"; //【必要】必须和device_info.hcs中的deviceMatchAttr值一致 match_attr = "hisilicon_hi35xx_pl061"; //【必要】必须和device_info.hcs中的deviceMatchAttr值一致
groupNum = 12; //【必要】GPIO组索引 需要根据设备情况填写 groupNum = 12; //【必要】GPIO组索引，需要根据设备情况填写
bitNum = 8; //【必要】每组GPIO管脚数 bitNum = 8; //【必要】每组GPIO管脚数
regBase = 0x120d0000;//【必要】物理基地址 regBase = 0x120d0000;//【必要】物理基地址
regStep = 0x1000; //【必要】寄存器偏移步进 regStep = 0x1000; //【必要】寄存器偏移步进
...@@ -143,17 +141,17 @@ GPIO模块适配的三个环节是配置属性文件，实例化驱动入口， ...@@ -143,17 +141,17 @@ GPIO模块适配的三个环节是配置属性文件，实例化驱动入口，
``` ```
struct Pl061GpioCntlr { struct Pl061GpioCntlr {
struct GpioCntlr cntlr;//【必要】 是核心层控制对象，其成员定义见下面 struct GpioCntlr cntlr;//【必要】是核心层控制对象，其成员定义见下面
volatile unsigned char *regBase; //【必要】寄存器基地址 volatile unsigned char *regBase; //【必要】寄存器基地址
uint32_t phyBase; //【必要】 物理基址 uint32_t phyBase; //【必要】物理基址
uint32_t regStep; //【必要】 寄存器偏移步进 uint32_t regStep; //【必要】寄存器偏移步进
uint32_t irqStart; //【必要】 中断开启 uint32_t irqStart; //【必要】中断开启
uint16_t groupNum; //【必要】 用于描述厂商的GPIO端口号的参数 uint16_t groupNum; //【必要】用于描述厂商的GPIO端口号的参数
uint16_t bitNum; //【必要】 用于描述厂商的GPIO端口号的参数 uint16_t bitNum; //【必要】用于描述厂商的GPIO端口号的参数
uint8_t irqShare; //【必要】 共享中断 uint8_t irqShare; //【必要】共享中断
struct Pl061GpioGroup *groups; //【可选】 根据厂商需要设置 struct Pl061GpioGroup *groups; //【可选】根据厂商需要设置
}; };
struct Pl061GpioGroup { //包括寄存器地址，中断号，中断函数和和锁 struct Pl061GpioGroup { // 包括寄存器地址，中断号，中断函数和和锁
volatile unsigned char *regBase; volatile unsigned char *regBase;
unsigned int index; unsigned int index;
unsigned int irq; unsigned int irq;
...@@ -182,15 +180,15 @@ GPIO模块适配的三个环节是配置属性文件，实例化驱动入口， ...@@ -182,15 +180,15 @@ GPIO模块适配的三个环节是配置属性文件，实例化驱动入口，
static struct GpioMethod g_method = { static struct GpioMethod g_method = {
.request = NULL, .request = NULL,
.release = NULL, .release = NULL,
.write = Pl061GpioWrite, //写管脚 .write = Pl061GpioWrite, // 写管脚
.read = Pl061GpioRead, //读管脚 .read = Pl061GpioRead, // 读管脚
.setDir = Pl061GpioSetDir, //设置管脚方向 .setDir = Pl061GpioSetDir, // 设置管脚方向
.getDir = Pl061GpioGetDir, //获取管脚方向 .getDir = Pl061GpioGetDir, // 获取管脚方向
.toIrq = NULL, .toIrq = NULL,
.setIrq = Pl061GpioSetIrq, //设置管脚中断，如不具备此能力可忽略 .setIrq = Pl061GpioSetIrq, // 设置管脚中断，如不具备此能力可忽略
.unsetIrq = Pl061GpioUnsetIrq, //取消管脚中断设置，如不具备此能力可忽略 .unsetIrq = Pl061GpioUnsetIrq, // 取消管脚中断设置，如不具备此能力可忽略
.enableIrq = Pl061GpioEnableIrq, //使能管脚中断，如不具备此能力可忽略 .enableIrq = Pl061GpioEnableIrq, // 使能管脚中断，如不具备此能力可忽略
.disableIrq = Pl061GpioDisableIrq,//禁止管脚中断，如不具备此能力可忽略 .disableIrq = Pl061GpioDisableIrq,// 禁止管脚中断，如不具备此能力可忽略
}; };
``` ```
...@@ -224,13 +222,13 @@ GPIO模块适配的三个环节是配置属性文件，实例化驱动入口， ...@@ -224,13 +222,13 @@ GPIO模块适配的三个环节是配置属性文件，实例化驱动入口，
static int32_t Pl061GpioInit(struct HdfDeviceObject *device) static int32_t Pl061GpioInit(struct HdfDeviceObject *device)
{ {
... ...
struct Pl061GpioCntlr *pl061 = &g_pl061;//利用静态全局变量完成初始化 struct Pl061GpioCntlr *pl061 = &g_pl061;// 利用静态全局变量完成初始化
//static struct Pl061GpioCntlr g_pl061 = { // static struct Pl061GpioCntlr g_pl061 = {
// .groups = NULL, // .groups = NULL,
// .groupNum = PL061_GROUP_MAX, // .groupNum = PL061_GROUP_MAX,
// .bitNum = PL061_BIT_MAX, // .bitNum = PL061_BIT_MAX,
//}; //};
ret = Pl061GpioReadDrs(pl061, device->property);//利用从gpio_config.HCS文件读取的属性值来初始化自定义结构体对象成员 ret = Pl061GpioReadDrs(pl061, device->property);// 利用从gpio_config.HCS文件读取的属性值来初始化自定义结构体对象成员
... ...
pl061->regBase = OsalIoRemap(pl061->phyBase, pl061->groupNum * pl061->regStep);//地址映射 pl061->regBase = OsalIoRemap(pl061->phyBase, pl061->groupNum * pl061->regStep);//地址映射
... ...
...@@ -251,11 +249,11 @@ GPIO模块适配的三个环节是配置属性文件，实例化驱动入口， ...@@ -251,11 +249,11 @@ GPIO模块适配的三个环节是配置属性文件，实例化驱动入口，
... ...
} }
``` ```
- Release 函数参考 - Release函数参考
入参： 入参：
HdfDeviceObject 是整个驱动对外暴露的接口参数，具备 HCS 配置文件的信息。 HdfDeviceObject是整个驱动对外暴露的接口参数，具备hcs配置文件的信息。
返回值： 返回值：
...@@ -263,7 +261,7 @@ GPIO模块适配的三个环节是配置属性文件，实例化驱动入口， ...@@ -263,7 +261,7 @@ GPIO模块适配的三个环节是配置属性文件，实例化驱动入口，
函数说明： 函数说明：
释放内存和删除控制器，该函数需要在驱动入口结构体中赋值给 Release 接口， 当HDF框架调用Init函数初始化驱动失败时，可以调用 Release 释放驱动资源。所有强制转换获取相应对象的操作**前提**是在Init函数中具备对应赋值的操作。 释放内存和删除控制器，该函数需要在驱动入口结构体中赋值给Release 接口，当HDF框架调用Init函数初始化驱动失败时，可以调用Release释放驱动资源。所有强制转换获取相应对象的操作**前提**是在Init函数中具备对应赋值的操作。
``` ```
...@@ -273,13 +271,13 @@ GPIO模块适配的三个环节是配置属性文件，实例化驱动入口， ...@@ -273,13 +271,13 @@ GPIO模块适配的三个环节是配置属性文件，实例化驱动入口，
struct Pl061GpioCntlr *pl061 = NULL; struct Pl061GpioCntlr *pl061 = NULL;
... ...
cntlr = GpioCntlrFromDevice(device);//【必要】通过强制转换获取核心层控制对象 cntlr = GpioCntlrFromDevice(device);//【必要】通过强制转换获取核心层控制对象
//return (device == NULL) ? NULL : (struct GpioCntlr *)device->service; // return (device == NULL) ? NULL : (struct GpioCntlr *)device->service;
... ...
#ifdef PL061_GPIO_USER_SUPPORT #ifdef PL061_GPIO_USER_SUPPORT
GpioRemoveVfs();//与Init中GpioAddVfs相反 GpioRemoveVfs();//与Init中GpioAddVfs相反
#endif #endif
GpioCntlrRemove(cntlr); //【必要】取消设备信息、服务等内容在核心层上的挂载 GpioCntlrRemove(cntlr); //【必要】取消设备信息、服务等内容在核心层上的挂载
pl061 = ToPl061GpioCntlr(cntlr); //return (struct Pl061GpioCntlr *)cntlr; pl061 = ToPl061GpioCntlr(cntlr); // return (struct Pl061GpioCntlr *)cntlr;
Pl061GpioRleaseCntlrMem(pl061); //【必要】锁和内存的释放 Pl061GpioRleaseCntlrMem(pl061); //【必要】锁和内存的释放
OsalIoUnmap((void *)pl061->regBase);//【必要】解除地址映射 OsalIoUnmap((void *)pl061->regBase);//【必要】解除地址映射
pl061->regBase = NULL; pl061->regBase = NULL;
......
zh-cn/device-dev/driver/driver-platform-hdmi-des.md
浏览文件 @ 2fbe7df9
...@@ -5,15 +5,15 @@ ...@@ -5,15 +5,15 @@
### 功能简介 ### 功能简介
- HDMI（High Definition Multimedia Interface），即高清多媒体接口，主要用于DVD、机顶盒等音视频Source到TV、显示器等Sink设备的传输。 HDMI（High Definition Multimedia Interface），即高清多媒体接口，主要用于DVD、机顶盒等音视频Source到TV、显示器等Sink设备的传输。
- HDMI以主从方式工作，通常有一个Source端和一个Sink端。 HDMI以主从方式工作，通常有一个Source端和一个Sink端。
- HDMI接口定义了完成HDMI传输的通用方法集合，包括： HDMI接口定义了完成HDMI传输的通用方法集合，包括：
- HDMI控制器管理：打开或关闭HDMI控制器 - HDMI控制器管理：打开或关闭HDMI控制器
- HDMI启动/停止传输：启动或停止HDMI传输 - HDMI启动/停止传输：启动或停止HDMI传输
- HDMI控制器设置：设置音频、视频及HDR属性，设置色彩深度、声音图像消隐等 - HDMI控制器设置：设置音频、视频及HDR属性，设置色彩深度、声音图像消隐等
- HDMI读取EDID：读取Sink端原始的EDID数据 - HDMI读取EDID：读取Sink端原始的EDID数据
- HDMI热插拔：注册/注销热插拔回调函数 - HDMI热插拔：注册/注销热插拔回调函数
### 基本概念 ### 基本概念
...@@ -22,9 +22,9 @@ HDMI是Hitachi、Panasonic、Philips、Silicon Image、Sony、Thomson、Toshiba ...@@ -22,9 +22,9 @@ HDMI是Hitachi、Panasonic、Philips、Silicon Image、Sony、Thomson、Toshiba
- TMDS（Transition Minimized Differential signal）：过渡调制差分信号，也被称为最小化传输差分信号，用于发送音频、视频及各种辅助数据。 - TMDS（Transition Minimized Differential signal）：过渡调制差分信号，也被称为最小化传输差分信号，用于发送音频、视频及各种辅助数据。
- DDC（Display Data Channel）：显示数据通道，发送端与接收端可利用DDC通道得知彼此的发送与接收能力，但HDMI仅需单向获知接收端（显示器）的能力。 - DDC（Display Data Channel）：显示数据通道，发送端与接收端可利用DDC通道得知彼此的发送与接收能力，但HDMI仅需单向获知接收端（显示器）的能力。
- CEC（Consumer Electronics Control）：消费电子控制，该功能应该能够在连接HDMI的发送设备与接收设备之间实现交互操作。 - CEC（Consumer Electronics Control）：消费电子控制，该功能应该能够在连接HDMI的发送设备与接收设备之间实现交互操作。
- FRL（Fixed Rate Link）：TMDS 的架构进行讯号传输时，最高带宽可达 18Gbps，而 FRL 模式的带宽则提升到 48 Gbps。 - FRL（Fixed Rate Link）：TMDS 的架构进行讯号传输时，最高带宽可达 18Gbps，而FRL模式的带宽则提升到48 Gbps。
- HDCP（High-bandwidth Digital Content Protection）：即高带宽数字内容保护技术，当用户对高清晰信号进行非法复制时，该技术会进行干扰，降低复制出来的影像的质量，从而对内容进行保护。 - HDCP（High-bandwidth Digital Content Protection）：即高带宽数字内容保护技术，当用户对高清晰信号进行非法复制时，该技术会进行干扰，降低复制出来的影像的质量，从而对内容进行保护。
- EDID（Extended Display Identification Data）：扩展显示标识数据， 通常存储在显示器的固件中，标识供应商信息、EDID版本信息、最大图像大小、颜色设置、厂商预设置、频率范围的限制以及显示器名和序列号的字符串。 - EDID（Extended Display Identification Data）：扩展显示标识数据，通常存储在显示器的固件中，标识供应商信息、EDID版本信息、最大图像大小、颜色设置、厂商预设置、频率范围的限制以及显示器名和序列号的字符串。
### 运作机制 ### 运作机制
...@@ -38,7 +38,7 @@ HDMI物理连接如图1所示： ...@@ -38,7 +38,7 @@ HDMI物理连接如图1所示：
### 约束与限制 ### 约束与限制
HDMI模块当前仅支持轻量和小型系统内核（LiteOS） 。 HDMI模块当前仅支持轻量和小型系统内核（LiteOS）。
## 使用指导 ## 使用指导
...@@ -92,7 +92,7 @@ DevHandle HdmiOpen(int16_t number); ...@@ -92,7 +92,7 @@ DevHandle HdmiOpen(int16_t number);
| NULL | 打开HDMI控制器失败 | | NULL | 打开HDMI控制器失败 |
| 控制器句柄 | 打开的HDMI控制器句柄 | | 控制器句柄 | 打开的HDMI控制器句柄 |
假设系统中存在2个HDMI控制器，编号从0到1，那么我们现在获取0号控制器： 假设系统中存在2个HDMI控制器，编号从0到1，以下代码示例为获取0号控制器：
```c ```c
DevHandle hdmiHandle = NULL; /* HDMI控制器句柄 / DevHandle hdmiHandle = NULL; /* HDMI控制器句柄 /
......
zh-cn/device-dev/driver/driver-platform-hdmi-develop.md
浏览文件 @ 2fbe7df9
...@@ -5,19 +5,17 @@ ...@@ -5,19 +5,17 @@
### 功能简介 ### 功能简介
HDMI（High Definition Multimedia Interface），即高清多媒体接口，主要用于DVD、机顶盒等音视频source到TV、显示器等Sink设备的传输。 HDMI（High Definition Multimedia Interface），即高清多媒体接口，是Hitachi、Panasonic、Philips、Silicon Image、Sony、Thomson、Toshiba共同发布的一款音视频传输协议，主要用于DVD、机顶盒等音视频source到TV、显示器等Sink设备的传输。HDMI传输过程遵循TMDS（Transition Minimized Differential Signaling）协议。
### 基本概念 ### 基本概念
HDMI是Hitachi、Panasonic、Philips、Silicon Image、Sony、Thomson、Toshiba共同发布的一款音视频传输协议。传输过程遵循TMDS（Transition Minimized Differential Signaling）协议。
- TMDS（Transition Minimized Differential signal）：过渡调制差分信号，也被称为最小化传输差分信号，用于发送音频、视频及各种辅助数据。 - TMDS（Transition Minimized Differential signal）：过渡调制差分信号，也被称为最小化传输差分信号，用于发送音频、视频及各种辅助数据。
- DDC（Display Data Channel）：显示数据通道，发送端与接收端可利用DDC通道得知彼此的发送与接收能力，但HDMI仅需单向获知接收端（显示器）的能力。 - DDC（Display Data Channel）：显示数据通道，发送端与接收端可利用DDC通道得知彼此的发送与接收能力，但HDMI仅需单向获知接收端（显示器）的能力。
- CEC（Consumer Electronics Control）：消费电子控制，该功能应该能够在连接HDMI的发送设备与接收设备之间实现交互操作。 - CEC（Consumer Electronics Control）：消费电子控制，该功能应该能够在连接HDMI的发送设备与接收设备之间实现交互操作。
- FRL（Fixed Rate Link）：TMDS 的架构进行讯号传输时，最高带宽可达 18Gbps，而 FRL 模式的带宽则提升到 48 Gbps。 - FRL（Fixed Rate Link）：TMDS 的架构进行讯号传输时，最高带宽可达18Gbps，而 FRL 模式的带宽则提升到48Gbps。
- HDCP（High-bandwidth Digital Content Protection）：即高带宽数字内容保护技术，当用户对高清晰信号进行非法复制时，该技术会进行干扰，降低复制出来的影像的质量，从而对内容进行保护。 - HDCP（High-bandwidth Digital Content Protection）：即高带宽数字内容保护技术，当用户对高清晰信号进行非法复制时，该技术会进行干扰，降低复制出来的影像的质量，从而对内容进行保护。
...@@ -85,57 +83,57 @@ struct HdmiCntlrOps { ...@@ -85,57 +83,57 @@ struct HdmiCntlrOps {
| 函数成员 | 入参 | 出参 | 返回值 | 功能 | | 函数成员 | 入参 | 出参 | 返回值 | 功能 |
| ------------------------ | ------------------------------------------------------------ | -------------------------------------- | ------------------ | -------------------------------------------------- | | ------------------------ | ------------------------------------------------------------ | -------------------------------------- | ------------------ | -------------------------------------------------- |
| hardWareInit | **cntlr**: 结构体指针，核心层HDMI控制器; | 无 | 无 | 初始化HDMI硬件 | | hardWareInit | **cntlr**：结构体指针，核心层HDMI控制器 | 无 | 无 | 初始化HDMI硬件 |
| hardWareStatusGet | **cntlr**: 结构体指针，核心层HDMI控制器;<br /> | **status**：HDMI硬件状态 ; | 无 | 获取HDMI当前硬件状态 | | hardWareStatusGet | **cntlr**：结构体指针，核心层HDMI控制器<br /> | **status**：HDMI硬件状态 ; | 无 | 获取HDMI当前硬件状态 |
| controllerReset | **cntlr**: 结构体指针，核心层HDMI控制器; | 无 | 无 | 复位HDMI控制器 | | controllerReset | **cntlr**：结构体指针，核心层HDMI控制器 | 无 | 无 | 复位HDMI控制器 |
| hotPlugStateGet | **cntlr**: 结构体指针，核心层HDMI控制器; | 无 | bool: HDMI热插拔状态 | 获取HDMI热插拔状态 | | hotPlugStateGet | **cntlr**：结构体指针，核心层HDMI控制器 | 无 | bool: HDMI热插拔状态 | 获取HDMI热插拔状态 |
| hotPlugInterruptStateGet | **cntlr**: 结构体指针，核心层HDMI控制器; | 无 | bool: HDMI热插拔中断状态 | 获取HDMI热插拔中断状态 | | hotPlugInterruptStateGet | **cntlr**：结构体指针，核心层HDMI控制器 | 无 | bool: HDMI热插拔中断状态 | 获取HDMI热插拔中断状态 |
| lowPowerSet | **cntlr**: 结构体指针，核心层HDMI控制器;<br />**enable**: bool，使能/去使能 | 无 | 无 | 使能/去使能低功耗 | | lowPowerSet | **cntlr**：结构体指针，核心层HDMI控制器<br />**enable**: bool，使能/去使能 | 无 | 无 | 使能/去使能低功耗 |
| tmdsModeSet | **cntlr**: 结构体指针，核心层HDMI控制器;<br />**mode**:TMDS模式 | 无 | 无 | 设置TMDS模式 | | tmdsModeSet | **cntlr**：结构体指针，核心层HDMI控制器<br />**mode**：TMDS模式 | 无 | 无 | 设置TMDS模式 |
|tmdsConfigSet|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**mode**: TMDS参数|无|HDF_STATUS相关状态|配置TMDS参数| | tmdsConfigSet | **cntlr**：结构体指针，核心层HDMI控制器<br />**mode**: TMDS参数 | 无 | HDF_STATUS相关状态 | 配置TMDS参数 |
|infoFrameEnable|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**infoFrameType**: packet类型<br />**enable**: bool，使能/去使能|无|无|使能/去使能infoFrame| | infoFrameEnable | **cntlr**：结构体指针，核心层HDMI控制器<br />**infoFrameType**: packet类型<br />**enable**: bool，使能/去使能 | 无 | 无 | 使能/去使能infoFrame |
|infoFrameSend|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**infoFrameType**: packet类型<br />**data**: infoFrame数据<br />**len**:数据长度|无|HDF_STATUS相关状态|发送infoFrame| | infoFrameSend | **cntlr**：结构体指针，核心层HDMI控制器<br />**infoFrameType**: packet类型<br />**data**: infoFrame数据<br />**len**：数据长度 | 无 | HDF_STATUS相关状态 | 发送infoFrame |
|cecMsgSend|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**msg**: CEC消息|无|HDF_STATUS相关状态|发送CEC消息| | cecMsgSend | **cntlr**：结构体指针，核心层HDMI控制器<br />**msg**: CEC消息 | 无 | HDF_STATUS相关状态 | 发送CEC消息 |
|audioPathEnable|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**enable**: bool，使能/去使能|无|无|使能/去使能audio通路| | audioPathEnable | **cntlr**：结构体指针，核心层HDMI控制器<br />**enable**: bool，使能/去使能| 无 | 无 | 使能/去使能audio通路 |
|audioPathSet|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**config**: 配置信息|无|无|设置audio通路配置信息| | audioPathSet | **cntlr**：结构体指针，核心层HDMI控制器<br />**config**: 配置信息 | 无 | 无 | 设置audio通路配置信息 |
|phyOutputEnable|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**enable**: bool，使能/去使能|无|无|使能/去使能物理层输出状态| | phyOutputEnable | **cntlr**：结构体指针，核心层HDMI控制器<br />**enable**: bool，使能/去使能 | 无 | 无 | 使能/去使能物理层输出状态 |
|phyOutputSet|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**cfg**: 配置信息|无|无|设置物理层配置信息| | phyOutputSet | **cntlr**：结构体指针，核心层HDMI控制器<br />**cfg**: 配置信息 | 无 | 无 | 设置物理层配置信息 |
|blackDataSet|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**enable**: bool，使能/去使能|无|无|设置黑屏| | blackDataSet | **cntlr**：结构体指针，核心层HDMI控制器<br />**enable**: bool，使能/去使能 | 无 | 无 | 设置黑屏 |
|videoMuteEnable|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**enable**: bool，使能/去使能|无|无|使能/去使能video静音| | videoMuteEnable | **cntlr**：结构体指针，核心层HDMI控制器<br />**enable**: bool，使能/去使能 | 无 | 无 | 使能/去使能video静音 |
|videoPathSet|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**attr**： 配置信息|无|无|设置viedo通路配置信息| | videoPathSet | **cntlr**：结构体指针，核心层HDMI控制器<br />**attr**：配置信息| 无 | 无 | 设置viedo通路配置信息 |
|audioMuteEnable|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**enable**: bool，使能/去使能|无|无|使能/去使能audio静音| |audioMuteEnable | **cntlr**：结构体指针，核心层HDMI控制器<br />**enable**: bool，使能/去使能 | 无 | 无 | 使能/去使能audio静音 |
|avmuteSet|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**enable**: bool，使能/去使能|无|无|使能/去使能声音图像消隐| | avmuteSet | **cntlr**：结构体指针，核心层HDMI控制器<br />**enable**: bool，使能/去使能| 无 | 无 | 使能/去使能声音图像消隐 |
|ddcTransfer|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**ddcCfg**：DDC配置参数|**ddcCfg**：DDC配置参数|HDF_STATUS相关状态|读写DDC数据| | ddcTransfer | **cntlr**：结构体指针，核心层HDMI控制器<br />**ddcCfg**：DDC配置参数 |**ddcCfg**：DDC配置参数 |HDF_STATUS相关状态 | 读写DDC数据 |
|scdcSourceScrambleGet|**cntlr**: 结构体指针，核心层HDMI控制器;|无|bool，加扰状态|获取source端的加扰状态| | scdcSourceScrambleGet | **cntlr**：结构体指针，核心层HDMI控制器 | 无 | bool，加扰状态 | 获取source端的加扰状态 |
|scdcSourceScrambleSet|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**enable**: bool，使能/去使能|无|HDF_STATUS相关状态|使能/去使能source端的加扰| | scdcSourceScrambleSet | **cntlr**：结构体指针，核心层HDMI控制器<br />**enable**: bool，使能/去使能 | 无 | HDF_STATUS相关状态 | 使能/去使能source端的加扰 |
|frlEnable|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**enable**: bool，使能/去使能|无|HDF_STATUS相关状态|使能/去使能FRL| | frlEnable | **cntlr**：结构体指针，核心层HDMI控制器<br />**enable**: bool，使能/去使能 | 无 | HDF_STATUS相关状态 | 使能/去使能FRL |
|audioNctsSet|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**cfg**：N/CTS配 置参数|无|HDF_STATUS相关状态|设置audio的N/CTS信息| | audioNctsSet | **cntlr**：结构体指针，核心层HDMI控制器<br />**cfg**：N/CTS配置参数 | 无 | HDF_STATUS相关状态 | 设置audio的N/CTS信息 |
|frlTrainingConfigSet|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**cfg**：FRL Traning配置参数|无|无|设置FRL Traning配置信息| | frlTrainingConfigSet | **cntlr**：结构体指针，核心层HDMI控制器<br />**cfg**：FRL Traning配置参数 | 无 | 无| 设置FRL Traning配置信息 |
|frlTrainingStart|**cntlr**: 结构体指针，核心层HDMI控制器;|无|无|开始FRL Traning流程| | frlTrainingStart | **cntlr**：结构体指针，核心层HDMI控制器 | 无 | 无 | 开始FRL Traning流程 |
|frlGetTriningRslt|**cntlr**: 结构体指针，核心层HDMI控制器;|**rslt**：FRL Traning结果|无|获取FRL Traning结果| | frlGetTriningRslt | **cntlr**：结构体指针，核心层HDMI控制器 | **rslt**：FRL Traning结果 | 无 | 获取FRL Traning结果 |
|hdcpRegInit|**cntlr**: 结构体指针，核心层HDMI控制器;|无|无|初始化HDCP流程相关的寄存器| | hdcpRegInit | **cntlr**：结构体指针，核心层HDMI控制器 | 无 | 无 | 初始化HDCP流程相关的寄存器 |
|hdcpGenerateAksvAndAn|**cntlr**: 结构体指针，核心层HDMI控制器;|无|HDF_STATUS相关状态|HDCP流程中生成aksv和an| |hdcpGenerateAksvAndAn |**cntlr**：结构体指针，核心层HDMI控制器 | 无 | HDF_STATUS相关状态 | HDCP流程中生成aksv和an |
|hdcpOptReg|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**type**: 操作类型<br />**data**: 寄存器数据<br />**len**: 数据长度|**data**: 寄存器数据|HDF_STATUS相关状态|HDCP流程中读写相关寄存器| | hdcpOptReg | **cntlr**：结构体指针，核心层HDMI控制器<br />**type**: 操作类型<br />**data**: 寄存器数据<br />**len**: 数据长度 | **data**: 寄存器数据 | HDF_STATUS相关状态 | HDCP流程中读写相关寄存器 |
|hdrTimerSet|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**config**: timer配置信息|无|无|设置HDR相关的timer配置信息| | hdrTimerSet | **cntlr**：结构体指针，核心层HDMI控制器<br />**config**: timer配置信息 | 无 | 无 | 设置HDR相关的timer配置信息 |
### 开发步骤 ### 开发步骤
HDMI模块适配的三个环节是配置属性文件，实例化驱动入口以及实例化HDMI控制器对象。 HDMI模块适配的三个环节是配置属性文件，实例化驱动入口以及实例化HDMI控制器对象。
- **实例化驱动入口：** - 实例化驱动入口：
- 实例化HdfDriverEntry结构体成员。 - 实例化HdfDriverEntry结构体成员。
- 调用HDF_INIT将HdfDriverEntry实例化对象注册到HDF框架中。 - 调用HDF_INIT将HdfDriverEntry实例化对象注册到HDF框架中。
- **配置属性文件：** - 配置属性文件：
- 在device_info.hcs文件中添加deviceNode描述。 - 在device_info.hcs文件中添加deviceNode描述。
- 【可选】添加hdmi_config.hcs器件属性文件。 - 【可选】添加hdmi_config.hcs器件属性文件。
- **实例化HDMI控制器对象：** - 实例化HDMI控制器对象：
- 初始化HdmiCntlr成员。 - 初始化HdmiCntlr成员。
- 实例化HdmiCntlr成员HdmiCntlrOps方法集合。 - 实例化HdmiCntlr成员HdmiCntlrOps方法集合。
1. **实例化驱动入口** 1. 实例化驱动入口
驱动入口必须为HdfDriverEntry（在 hdf_device_desc.h 中定义）类型的全局变量，且moduleName要和device_info.hcs中保持一致。HDF框架会将所有加载的驱动的HdfDriverEntry对象首地址汇总，形成一个类似数组的段地址空间，方便上层调用。 驱动入口必须为HdfDriverEntry（在 hdf_device_desc.h 中定义）类型的全局变量，且moduleName要和device_info.hcs中保持一致。HDF框架会将所有加载的驱动的HdfDriverEntry对象首地址汇总，形成一个类似数组的段地址空间，方便上层调用。
...@@ -151,16 +149,16 @@ HDMI模块适配的三个环节是配置属性文件，实例化驱动入口以 ...@@ -151,16 +149,16 @@ HDMI模块适配的三个环节是配置属性文件，实例化驱动入口以
.Release = HdmiAdapterRelease, .Release = HdmiAdapterRelease,
.moduleName = "adapter_hdmi_driver",//【必要】与HCS里面的名字匹配 .moduleName = "adapter_hdmi_driver",//【必要】与HCS里面的名字匹配
}; };
HDF_INIT(g_hdmiDriverEntry); //调用HDF_INIT将驱动入口注册到HDF框架中 HDF_INIT(g_hdmiDriverEntry); // 调用HDF_INIT将驱动入口注册到HDF框架中
``` ```
2. **配置属性文件** 2. 配置属性文件
完成驱动入口注册之后，下一步请在device_info.hcs文件中添加deviceNode信息，并在hdmi_config.hcs中配置器件属性。deviceNode信息与驱动入口注册相关，器件属性值对于厂商驱动的实现以及核心层HdmiCntlr相关成员的默认值或限制范围有密切关系。 完成驱动入口注册之后，下一步请在device_info.hcs文件中添加deviceNode信息，并在hdmi_config.hcs中配置器件属性。deviceNode信息与驱动入口注册相关，器件属性值对于厂商驱动的实现以及核心层HdmiCntlr相关成员的默认值或限制范围有密切关系。
从第一个节点开始配置具体HDMI控制器信息，此节点并不表示某一路HDMI控制器，而是代表一个资源性质设备，用于描述一类HDMI控制器的信息。本例只有一个HDMI控制器，如有多个控制器，则需要在device_info文件增加deviceNode信息，以及在hdmi_config文件中增加对应的器件属性。 从第一个节点开始配置具体HDMI控制器信息，此节点并不表示某一路HDMI控制器，而是代表一个资源性质设备，用于描述一类HDMI控制器的信息。本例只有一个HDMI控制器，如有多个控制器，则需要在device_info文件增加deviceNode信息，以及在hdmi_config文件中增加对应的器件属性。
- device_info.hcs 配置参考 - device_info.hcs配置参考
```c ```c
root { root {
...@@ -228,13 +226,13 @@ HDMI模块适配的三个环节是配置属性文件，实例化驱动入口以 ...@@ -228,13 +226,13 @@ HDMI模块适配的三个环节是配置属性文件，实例化驱动入口以
} }
``` ```
3. **实例化控制器对象** 3. 实例化控制器对象
最后一步，完成驱动入口注册之后，要以核心层HdmiCntlr对象的初始化为核心，包括厂商自定义结构体（传递参数和数据），实例化HdmiCntlr成员HdmiCntlrOps（让用户可以通过接口来调用驱动底层函数），实现HdfDriverEntry成员函数（Bind，Init，Release）。 最后一步，完成驱动入口注册之后，要以核心层HdmiCntlr对象的初始化为核心，包括厂商自定义结构体（传递参数和数据），实例化HdmiCntlr成员HdmiCntlrOps（让用户可以通过接口来调用驱动底层函数），实现HdfDriverEntry成员函数（Bind，Init，Release）。
- 自定义结构体参考 - 自定义结构体参考
> ![](../public_sys-resources/icon-note.gif) **说明：** > ![](../public_sys-resources/icon-note.gif) **说明：**<br>
> 从驱动角度看，自定义结构体是参数和数据的载体。HDF会读取hdmi_config.hcs文件中的数值并通过DeviceResourceIface来初始化结构体成员，且其中一些重要数值（例如设备号、总线号等）也会被传递给核心层HdmiCntlr对象。 > 从驱动角度看，自定义结构体是参数和数据的载体。HDF会读取hdmi_config.hcs文件中的数值并通过DeviceResourceIface来初始化结构体成员，且其中一些重要数值（例如设备号、总线号等）也会被传递给核心层HdmiCntlr对象。
```c ```c
...@@ -316,17 +314,17 @@ HDMI模块适配的三个环节是配置属性文件，实例化驱动入口以 ...@@ -316,17 +314,17 @@ HDMI模块适配的三个环节是配置属性文件，实例化驱动入口以
- Bind函数参考 - Bind函数参考
**入参：** **入参：**
HdfDeviceObject 是整个驱动对外呈现的接口参数，具备 HCS 配置文件的信息 HdfDeviceObject是整个驱动对外呈现的接口参数，具备hcs配置文件的信息
**返回值：** **返回值：**
HDF_STATUS相关状态 （下表为部分展示，如需使用其他状态，可见//drivers/framework/include/utils/hdf_base.h中HDF_STATUS 定义） HDF_STATUS相关状态（下表为部分展示，如需使用其他状态，可见//drivers/framework/include/utils/hdf_base.h中HDF_STATUS 定义）
|状态(值)|状态描述| |状态(值)|状态描述|
|:-|:-| |:-|:-|
|HDF_ERR_INVALID_OBJECT|控制器对象非法| |HDF_ERR_INVALID_OBJECT|控制器对象非法|
|HDF_ERR_INVALID_PARAM |参数非法| |HDF_ERR_INVALID_PARAM |参数非法|
|HDF_ERR_MALLOC_FAIL |内存分配失败| |HDF_ERR_MALLOC_FAIL |内存分配失败|
|HDF_ERR_IO |I/O 错误| |HDF_ERR_IO |I/O错误|
|HDF_SUCCESS |传输成功| |HDF_SUCCESS |传输成功|
|HDF_FAILURE |传输失败| |HDF_FAILURE |传输失败|
...@@ -355,13 +353,13 @@ HDMI模块适配的三个环节是配置属性文件，实例化驱动入口以 ...@@ -355,13 +353,13 @@ HDMI模块适配的三个环节是配置属性文件，实例化驱动入口以
cntlr->ops = &g_hdmiHostOps; //【必要】HdmiCntlrOps的实例化对象的挂载 cntlr->ops = &g_hdmiHostOps; //【必要】HdmiCntlrOps的实例化对象的挂载
cntlr->hdfDevObj = obj; //【必要】使HdfDeviceObject与HdmiCntlr可以相互转化的前提 cntlr->hdfDevObj = obj; //【必要】使HdfDeviceObject与HdmiCntlr可以相互转化的前提
obj->service = &cntlr->service; //【必要】使HdfDeviceObject与HdmiCntlr可以相互转化的前提 obj->service = &cntlr->service; //【必要】使HdfDeviceObject与HdmiCntlr可以相互转化的前提
ret = HdmiAdapterCntlrParse(cntlr, obj); //【必要】 初始化 cntlr. 失败则 goto __ERR; ret = HdmiAdapterCntlrParse(cntlr, obj); //【必要】初始化cntlr，失败则 goto __ERR;
... ...
ret = HdmiAdapterHostParse(host, obj); //【必要】 初始化 host对象的相关属性，失败则 goto __ERR; ret = HdmiAdapterHostParse(host, obj); //【必要】初始化host对象的相关属性，失败则 goto __ERR;
... ...
ret = HdmiAdapterHostInit(host, cntlr); //厂商自定义的初始化，失败则 goto __ERR; ret = HdmiAdapterHostInit(host, cntlr); // 厂商自定义的初始化，失败则 goto __ERR;
... ...
ret = HdmiCntlrAdd(cntlr); //调用核心层函数 失败则 goto __ERR; ret = HdmiCntlrAdd(cntlr); // 调用核心层函数 失败则 goto __ERR;
... ...
HDF_LOGD("HdmiAdapterBind: success."); HDF_LOGD("HdmiAdapterBind: success.");
return HDF_SUCCESS; return HDF_SUCCESS;
...@@ -375,7 +373,7 @@ HDMI模块适配的三个环节是配置属性文件，实例化驱动入口以 ...@@ -375,7 +373,7 @@ HDMI模块适配的三个环节是配置属性文件，实例化驱动入口以
- Init函数参考 - Init函数参考
**入参：** **入参：**
HdfDeviceObject 是整个驱动对外暴露的接口参数，具备 HCS 配置文件的信息 HdfDeviceObject是整个驱动对外暴露的接口参数，具备hcs配置文件的信息
**返回值：** **返回值：**
HDF_STATUS相关状态 HDF_STATUS相关状态
...@@ -394,25 +392,24 @@ HDMI模块适配的三个环节是配置属性文件，实例化驱动入口以 ...@@ -394,25 +392,24 @@ HDMI模块适配的三个环节是配置属性文件，实例化驱动入口以
- Release 函数参考 - Release 函数参考
**入参：** **入参：**
HdfDeviceObject 是整个驱动对外暴露的接口参数，具备 HCS 配置文件的信息 HdfDeviceObject是整个驱动对外暴露的接口参数，具备hcs配置文件的信息
**返回值：** **返回值：**
无 无
**函数说明：** **函数说明：**
释放内存和删除控制器，该函数需要在驱动入口结构体中赋值给 Release 接口， 当HDF框架调用Init函数初始化驱动失败时，可以调用 Release 释放驱动资源。 释放内存和删除控制器，该函数需要在驱动入口结构体中赋值给Release接口，当HDF框架调用Init函数初始化驱动失败时，可以调用Release释放驱动资源。
```c ```c
static void HdmiAdapterRelease(struct HdfDeviceObject *obj) static void HdmiAdapterRelease(struct HdfDeviceObject *obj)
{ {
struct HdmiCntlr *cntlr = NULL; struct HdmiCntlr *cntlr = NULL;
... ...
cntlr = (struct HdmiCntlr *)obj->service;//这里有HdfDeviceObject到HdmiCntlr的强制转化，通过service成员，赋值见Bind函数 cntlr = (struct HdmiCntlr *)obj->service;// 这里有HdfDeviceObject到HdmiCntlr的强制转化，通过service成员，赋值见Bind函数
... ...
HimciDeleteHost((struct HimciAdapterHost *)cntlr->priv);//厂商自定义的内存释放函数,这里有HdmiCntlr到HimciAdapterHost的强制转化 HimciDeleteHost((struct HimciAdapterHost *)cntlr->priv);// 厂商自定义的内存释放函数,这里有HdmiCntlr到HimciAdapterHost的强制转化
} }
``` ```
> ![](../public_sys-resources/icon-note.gif) **说明：** > ![](../public_sys-resources/icon-note.gif) **说明：**<br>
> 所有强制转换获取相应对象的操作前提是在Init函数中具备对应赋值的操作。 > 所有强制转换获取相应对象的操作前提是在Init函数中具备对应赋值的操作。
\ No newline at end of file
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或