Skip to content

D
Docs

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

通知 159
Star 292
Fork 28
D
Docs

体验新版 GitCode，发现更多精彩内容 >>

未验证 提交 b7f0757c 编写于 作者: O openharmony_ci 提交者： Gitee
浏览文件
操作

!3905 【OpenHarmony开源贡献者计划2022】Regulator相关格式及表达问题 

Merge pull request !3905 from king_he/regulator-1
上级 f5bf3588 ee41de7a
隐藏空白更改
内联 并排
Showing with 140 addition and 141 deletion
zh-cn/device-dev/driver/driver-platform-regulator-des.md
浏览文件 @ b7f0757c
......@@ -5,12 +5,12 @@
### 功能简介
- Regulator模块用于控制系统中某些设备的电压/电流供应。在嵌入式系统（尤其是手机）中，控制耗电量很重要，直接影响到电池的续航时间。所以，如果系统中某一个模块暂时不需要使用，就可以通过Regulator关闭其电源供应；或者降低提供给该模块的电压、电流大小。
- Regulator接口定义了操作Regulator设备的通用方法集合，包括：
- Regulator设备句柄获取和销毁。
- Regulator设备电压、电流的设置。
- Regulator设备使能和关闭。
- Regulator设备电压、电流和状态的获取。
Regulator模块用于控制系统中某些设备的电压/电流供应。在嵌入式系统（尤其是手机）中，控制耗电量很重要，直接影响到电池的续航时间。所以，如果系统中某一个模块暂时不需要使用，就可以通过Regulator关闭其电源供应；或者降低提供给该模块的电压、电流大小。
Regulator接口定义了操作Regulator设备的通用方法集合，包括：
- Regulator设备句柄获取和销毁。
- Regulator设备电压、电流的设置。
- Regulator设备使能和关闭。
- Regulator设备电压、电流和状态的获取。
### 基本概念
......@@ -37,7 +37,7 @@
Regulator模块各分层的作用为：接口层提供打开设备，写入数据，关闭设备接口的能力。核心层主要提供绑定设备、初始化设备以及释放设备的能力。适配层实现其他具体的功能。
![](../public_sys-resources/icon-note.gif) 说明：核心层可以调用接口层的函数，也可以通过钩子函数调用适配层函数，从而使得适配层间接的可以调用接口层函数，但是不可逆转接口层调用适配层函数。
![](../public_sys-resources/icon-note.gif) 说明：<br>核心层可以调用接口层的函数，也可以通过钩子函数调用适配层函数，从而使得适配层间接的可以调用接口层函数，但是不可逆转接口层调用适配层函数。
**图 1** 统一服务模式结构图
......@@ -45,7 +45,7 @@ Regulator模块各分层的作用为：接口层提供打开设备，写入数
### 约束与限制
Regulator模块当前仅支持轻量和小型系统内核（LiteOS） 。
Regulator模块当前仅支持轻量和小型系统内核（LiteOS）。
## 使用指导
......@@ -58,20 +58,20 @@ Regulator主要用于：
### 接口说明
**表1** Regulator设备API功能介绍
**表1** Regulator设备API接口说明
| 接口名 | 描述 |
| 接口名 | 描述 |
| --------------------- | ------------------------- |
| RegulatorOpen | 获取Regulator设备驱动句柄 |
| RegulatorClose | 销毁Regulator设备驱动句柄 |
| RegulatorEnable | 使能Regulator |
| RegulatorDisable | 禁用Regulator |
| RegulatorForceDisable | 强制禁用Regulator |
| RegulatorSetVoltage | 设置Regulator输出电压 |
| RegulatorGetVoltage | 获取Regulator输出电压 |
| RegulatorSetCurrent | 设置Regulator输出电流 |
| RegulatorGetCurrent | 获取Regulator输出电流 |
| RegulatorGetStatus | 获取Regulator状态 |
| RegulatorOpen | 获取Regulator设备驱动句柄 |
| RegulatorClose | 销毁Regulator设备驱动句柄 |
| RegulatorEnable | 使能Regulator |
| RegulatorDisable | 禁用Regulator |
| RegulatorForceDisable | 强制禁用Regulator |
| RegulatorSetVoltage | 设置Regulator输出电压 |
| RegulatorGetVoltage | 获取Regulator输出电压 |
| RegulatorSetCurrent | 设置Regulator输出电流 |
| RegulatorGetCurrent | 获取Regulator输出电流 |
| RegulatorGetStatus | 获取Regulator状态 |
......@@ -95,12 +95,12 @@ DevHandle RegulatorOpen(const char *name);
**表2** RegulatorOpen参数和返回值描述
| 参数 | 参数描述 |
| 参数 | 参数描述 |
| ---------- | ----------------------------- |
| name | Regulator设备名称 |
| **返回值** | **返回值描述** |
| handle | 获取成功返回Regulator设备句柄 |
| NULL | 获取失败 |
| name | Regulator设备名称 |
| **返回值** | **返回值描述** |
| handle | 获取成功返回Regulator设备句柄 |
| NULL | 获取失败 |
......@@ -126,7 +126,7 @@ void RegulatorClose(DevHandle handle);
**表3** RegulatorClose参数描述
| 参数 | 参数描述 |
| 参数 | 参数描述 |
| ------ | ----------------- |
| handle | Regulator设备句柄 |
......@@ -145,22 +145,22 @@ int32_t RegulatorEnable(DevHandle handle);
**表4** RegulatorEnable参数描述
| 参数 | 参数描述 |
| 参数 | 参数描述 |
| ---------- | ----------------- |
| handle | Regulator设备句柄 |
| **返回值** | **返回值描述** |
| 0 | 使能成功 |
| 负数 | 使能失败 |
| handle | Regulator设备句柄 |
| **返回值** | **返回值描述** |
| 0 | 使能成功 |
| 负数 | 使能失败 |
```
int32_t ret;
/*启用Regulator设备*/
/* 启用Regulator设备 */
ret = RegulatorEnable(handle);
if (ret != 0) {
/*错误处理*/
/* 错误处理 */
}
```
......@@ -174,20 +174,20 @@ int32_t RegulatorDisable(DevHandle handle);
**表5** RegulatorDisable参数描述
| 参数 | 参数描述 |
| 参数 | 参数描述 |
| ---------- | ----------------- |
| handle | Regulator设备句柄 |
| **返回值** | **返回值描述** |
| 0 | 禁用成功 |
| 负数 | 禁用失败 |
| handle | Regulator设备句柄 |
| **返回值** | **返回值描述** |
| 0 | 禁用成功 |
| 负数 | 禁用失败 |
```
int32_t ret;
/*禁用Regulator设备*/
/* 禁用Regulator设备 */
ret = RegulatorDisable(handle);
if (ret != 0) {
/*错误处理*/
/* 错误处理 */
}
```
......@@ -202,20 +202,20 @@ int32_t RegulatorForceDisable(DevHandle handle);
**表6** RegulatorForceDisable参数描述
| 参数 | 参数描述 |
| 参数 | 参数描述 |
| ---------- | ----------------- |
| handle | Regulator设备句柄 |
| **返回值** | **返回值描述** |
| 0 | 禁用成功 |
| 负数 | 禁用失败 |
| handle | Regulator设备句柄 |
| **返回值** | **返回值描述** |
| 0 | 禁用成功 |
| 负数 | 禁用失败 |
```
int32_t ret;
/*强制禁用Regulator设备*/
/* 强制禁用Regulator设备 */
ret = RegulatorForceDisable(handle);
if (ret != 0) {
/*错误处理*/
/* 错误处理 */
}
```
......@@ -229,24 +229,24 @@ int32_t RegulatorSetVoltage(DevHandle handle, uint32_t minUv, uint32_t maxUv);
**表7** RegulatorSetVoltage参数描述
| 参数 | 参数描述 |
| 参数 | 参数描述 |
| ---------- | ----------------- |
| handle | Regulator设备句柄 |
| minUv | 最小电压 |
| maxUv | 最大电压 |
| **返回值** | **返回值描述** |
| 0 | 设置成功 |
| 负数 | 设置失败 |
| handle | Regulator设备句柄 |
| minUv | 最小电压 |
| maxUv | 最大电压 |
| **返回值** | **返回值描述** |
| 0 | 设置成功 |
| 负数 | 设置失败 |
```
int32_t ret;
int32_t minUv = 0; //最小电压为0µV
int32_t maxUv = 20000; //最大电压为20000µV
int32_t minUv = 0; // 最小电压为0µV
int32_t maxUv = 20000; // 最大电压为20000µV
/*设置Regulator电压输出电压范围*/
/* 设置Regulator电压输出电压范围 */
ret = RegulatorSetVoltage(handle, minUv, maxUv);
if (ret != 0) {
/*错误处理*/
/* 错误处理 */
}
```
......@@ -261,13 +261,13 @@ int32_t RegulatorGetVoltage(DevHandle handle, uint32_t *voltage);
**表8** RegulatorGetVoltage参数描述
| 参数 | 参数描述 |
| 参数 | 参数描述 |
| ---------- | ----------------- |
| handle | Regulator设备句柄 |
| *voltage | 参数指针 |
| **返回值** | **返回值描述** |
| 0 | 获取成功 |
| 负数 | 获取失败 |
| handle | Regulator设备句柄 |
| *voltage | 参数指针 |
| **返回值** | **返回值描述** |
| 0 | 获取成功 |
| 负数 | 获取失败 |
```
int32_t ret;
......@@ -290,24 +290,24 @@ int32_t RegulatorSetCurrent(DevHandle handle, uint32_t minUa, uint32_t maxUa);
**表9** RegulatorSetCurrent参数描述
| 参数 | 参数描述 |
| 参数 | 参数描述 |
| ---------- | ----------------- |
| handle | Regulator设备句柄 |
| minUa | 最小电流 |
| maxUa | 最大电流 |
| **返回值** | **返回值描述** |
| 0 | 设置成功 |
| 负数 | 设置失败 |
| handle | Regulator设备句柄 |
| minUa | 最小电流 |
| maxUa | 最大电流 |
| **返回值** | **返回值描述** |
| 0<br>| 设置成功 |
| 负数 | 设置失败 |
```
int32_t ret;
int32_t minUa = 0; //最小电流为0μA
int32_t maxUa = 200; //最大电流为200μA
int32_t minUa = 0; // 最小电流为0μA
int32_t maxUa = 200; // 最大电流为200μA
/*设置Regulator输出电流范围*/
/* 设置Regulator输出电流范围 */
ret = RegulatorSetCurrent(handle, minUa, maxUa);
if (ret != 0) {
/*错误处理*/
/* 错误处理 */
}
```
......@@ -321,22 +321,22 @@ int32_t RegulatorGetCurrent(DevHandle handle, uint32_t *regCurrent);
**表10** RegulatorGetCurrent参数描述
| 参数 | 参数描述 |
| 参数 | 参数描述 |
| ----------- | ----------------- |
| handle | Regulator设备句柄 |
| *regCurrent | 参数指针 |
| **返回值** | **返回值描述** |
| 0 | 获取成功 |
| 负数 | 获取失败 |
| handle | Regulator设备句柄 |
| *regCurrent | 参数指针 |
| **返回值** | **返回值描述** |
| 0 | 获取成功 |
| 负数 | 获取失败 |
```
int32_t ret;
uint32_t regCurrent;
/*获取Regulator电流*/
/* 获取Regulator电流 */
ret = RegulatorGetCurrent(handle, &regCurrent);
if (ret != 0) {
/*错误处理*/
/* 错误处理 */
}
```
......@@ -350,22 +350,22 @@ int32_t RegulatorGetStatus(DevHandle handle, uint32_t *status);
**表11** RegulatorGetStatus参数描述
| 参数 | 参数描述 |
| 参数 | 参数描述 |
| ---------- | ----------------- |
| handle | Regulator设备句柄 |
| *status | 参数指针 |
| **返回值** | **返回值描述** |
| 0 | 获取成功 |
| 负数 | 获取失败 |
| handle | Regulator设备句柄 |
| *status | 参数指针 |
| **返回值** | **返回值描述** |
| 0 | 获取成功 |
| 负数 | 获取失败 |
```
int32_t ret;
uint32_t status;
/*获取Regulator状态*/
/* 获取Regulator状态 */
ret = RegulatorGetStatus(handle, &status);
if (ret != 0) {
/*错误处理*/
/* 错误处理 */
}
```
......@@ -391,17 +391,17 @@ void RegulatorTestSample(void)
return;
}
/*启用Regulator设备*/
/* 启用Regulator设备 */
ret = RegulatorEnable(handle);
if (ret != 0) {
HDF_LOGE("RegulatorEnable: failed, ret %d\n", ret);
goto _ERR;
}
int32_t minUv = 0; //最小电压为0µV
int32_t maxUv = 20000; //最大电压为20000µV
int32_t minUv = 0; // 最小电压为0µV
int32_t maxUv = 20000; // 最大电压为20000µV
/*设置Regulator输出电压范围*/
/* 设置Regulator输出电压范围 */
ret = RegulatorSetVoltage(handle, minUv, maxUv);
if (ret != 0) {
HDF_LOGE("RegulatorSetVoltage: failed, ret %d\n", ret);
......@@ -410,7 +410,7 @@ void RegulatorTestSample(void)
uint32_t voltage;
/*获取Regulator电压*/
/* 获取Regulator电压 */
ret = RegulatorGetVoltage(handle, &voltage);
if (ret != 0) {
HDF_LOGE("RegulatorGetVoltage: failed, ret %d\n", ret);
......@@ -419,14 +419,14 @@ void RegulatorTestSample(void)
uint32_t status;
/*获取Regulator状态*/
/* 获取Regulator状态 */
ret = RegulatorGetStatus(handle, &status);
if (ret != 0) {
HDF_LOGE("RegulatorGetStatus: failed, ret %d\n", ret);
goto _ERR;
}
/*禁用Regulator设备*/
/* 禁用Regulator设备 */
ret = RegulatorDisable(handle);
if (ret != 0) {
HDF_LOGE("RegulatorDisable: failed, ret %d\n", ret);
......
zh-cn/device-dev/driver/driver-platform-regulator-develop.md
浏览文件 @ b7f0757c
......@@ -5,19 +5,18 @@
### 功能简介
Regulator模块用于控制系统中某些设备的电压/电流供应。
### 基本概念
Regulator模块用于控制系统中某些设备的电压/电流供应。在嵌入式系统（尤其是手机）中，控制耗电量很重要，直接影响到电池的续航时间。所以，如果系统中某一个模块暂时不需要使用，就可以通过Regulator关闭其电源供应；或者降低提供给该模块的电压、电流大小。
### 运作机制
在HDF框架中，Regulator模块接口适配模式采用统一服务模式，这需要一个设备服务来作为Regulator模块的管理器，统一处理外部访问，这会在配置文件中有所体现。统一服务模式适合于同类型设备对象较多的情况，如Regulator可能同时具备十几个控制器，采用独立服务模式需要配置更多的设备节点，且服务会占据内存资源。
Regulator模块各分层的作用为：接口层提供打开设备，写入数据，关闭设备接口的能力。核心层主要提供绑定设备、初始化设备以及释放设备的能力。适配层实现其他具体的功能。
Regulator模块各分层的作用为：
- 接口层提供打开设备，写入数据，关闭设备接口的能力。
- 核心层主要提供绑定设备、初始化设备以及释放设备的能力。
- 适配层实现其他具体的功能。
![](../public_sys-resources/icon-note.gif) 说明：核心层可以调用接口层的函数，也可以通过钩子函数调用适配层函数，从而使得适配层间接的可以调用接口层函数，但是不可逆转接口层调用适配层函数。
![](../public_sys-resources/icon-note.gif) 说明：<br>核心层可以调用接口层的函数，也可以通过钩子函数调用适配层函数，从而使得适配层间接的可以调用接口层函数，但是不可逆转接口层调用适配层函数。
**图 1** 统一服务模式结构图
......@@ -61,18 +60,18 @@ struct RegulatorMethod {
| 成员函数 | 入参 | 返回值 | 功能 |
| ------------ | ------------------------------------------------------------ | ------------------ | ---------------- |
| open | **node**：结构体指针，核心层Regulator节点； | HDF_STATUS相关状态 | 打开设备 |
| close | **node**：结构体指针，核心层Regulator节点； | HDF_STATUS相关状态 | 关闭设备 |
| release | **node**：结构体指针，核心层Regulator节点； | HDF_STATUS相关状态 | 释放设备句柄 |
| enable | **node**：结构体指针，核心层Regulator节点； | HDF_STATUS相关状态 | 使能 |
| disable | **node**：结构体指针，核心层Regulator节点； | HDF_STATUS相关状态 | 禁用 |
| forceDisable | **node**：结构体指针，核心层Regulator节点； | HDF_STATUS相关状态 | 强制禁用 |
| setVoltage | **node**：结构体指针，核心层Regulator节点；<br>**minUv**：uint32_t变量，最小电压；<br>**maxUv**：uint32_t变量，最大电压； | HDF_STATUS相关状态 | 设置输出电压范围 |
| getVoltage | **node**：结构体指针，核心层Regulator节点；<br>**voltage**：uint32_t指针，传出电压值； | HDF_STATUS相关状态 | 获取电压 |
| setCurrent | **node**：结构体指针，核心层Regulator节点；<br>**minUa**：uint32_t变量，最小电流；<br>**maxUa**：uint32_t变量，最大电流； | HDF_STATUS相关状态 | 设置输出电流范围 |
| getCurrent | **node**：结构体指针，核心层Regulator节点；<br>**regCurrent**：uint32_t指针，传出电流值； | HDF_STATUS相关状态 | 获取电流 |
| getStatus | **node**：结构体指针，核心层Regulator节点；<br>**status**：uint32_t指针，传出状态值； | HDF_STATUS相关状态 | 获取设备状态 |
| ------------ | ----------------------------------------------------------- | ----------------- | ---------------- |
| open | **node**：结构体指针，核心层Regulator节点 | HDF_STATUS相关状态 | 打开设备 |
| close | **node**：结构体指针，核心层Regulator节点 | HDF_STATUS相关状态 | 关闭设备 |
| release | **node**：结构体指针，核心层Regulator节点 | HDF_STATUS相关状态 | 释放设备句柄 |
| enable | **node**：结构体指针，核心层Regulator节点 | HDF_STATUS相关状态 | 使能 |
| disable | **node**：结构体指针，核心层Regulator节点 | HDF_STATUS相关状态 | 禁用 |
| forceDisable | **node**：结构体指针，核心层Regulator节点 | HDF_STATUS相关状态 | 强制禁用 |
| setVoltage | **node**：结构体指针，核心层Regulator节点<br>**minUv**：uint32_t变量，最小电压<br>**maxUv**：uint32_t变量，最大电压 | HDF_STATUS相关状态 | 设置输出电压范围 |
| getVoltage | **node**：结构体指针，核心层Regulator节点<br>**voltage**：uint32_t指针，传出电压值 | HDF_STATUS相关状态 | 获取电压 |
| setCurrent | **node**：结构体指针，核心层Regulator节点<br>**minUa**：uint32_t变量，最小电流<br>**maxUa**：uint32_t变量，最大电流 | HDF_STATUS相关状态 | 设置输出电流范围 |
| getCurrent | **node**：结构体指针，核心层Regulator节点<br>**regCurrent**：uint32_t指针，传出电流值 | HDF_STATUS相关状态 | 获取电流 |
| getStatus | **node**：结构体指针，核心层Regulator节点<br>**status**：uint32_t指针，传出状态值 | HDF_STATUS相关状态 | 获取设备状态 |
### 开发步骤
......@@ -92,11 +91,11 @@ Regulator模块适配包含以下四个步骤：
```
struct HdfDriverEntry g_regulatorDriverEntry = {
.moduleVersion = 1,
.moduleName = "virtual_regulator_driver",//【必要且与HCS文件中里面的moduleName匹配】
.moduleName = "virtual_regulator_driver",// 【必要且与HCS文件中里面的moduleName匹配】
.Init = VirtualRegulatorInit,
.Release = VirtualRegulatorRelease,
};
//调用HDF_INIT将驱动入口注册到HDF框架中
// 调用HDF_INIT将驱动入口注册到HDF框架中
HDF_INIT(g_regulatorDriverEntry);
```
......@@ -111,7 +110,7 @@ Regulator模块适配包含以下四个步骤：
| 成员名 | 值 |
| --------------- | ------------------------------------------------------------ |
| policy | 具体配置为0，不发布服务 |
| priority | 驱动启动优先级（0-200），值越大优先级越低,，优先级相同则不保证device的加载顺序。 |
| priority | 驱动启动优先级（0-200）。值越大优先级越低，优先级相同则不保证device的加载顺序 |
| permission | 驱动权限 |
| moduleName | 固定为HDF_PLATFORM_REGULATOR_MANAGER |
| serviceName | 固定为HDF_PLATFORM_REGULATOR_MANAGER |
......@@ -119,7 +118,7 @@ Regulator模块适配包含以下四个步骤：
从第二个节点开始配置具体Regulator控制器信息，此节点并不表示某一路Regulator控制器，而是代表一个资源性质设备，用于描述一类Regulator控制器的信息。本例只有一个Regulator设备，如有多个设备，则需要在device_info文件增加deviceNode信息，以及在regulator\_config文件中增加对应的器件属性。
- device_info.hcs 配置参考。
- device_info.hcs 配置参考
```
root {
......@@ -128,14 +127,14 @@ Regulator模块适配包含以下四个步骤：
hostName = "platform_host";
priority = 50;
device_regulator :: device {
device0 :: deviceNode { //为每一个Regulator控制器配置一个HDF设备节点，存在多个时添加，否则不用
policy = 1; // 2:用户态可见,1:内核态可见,0:不需要发布服务
device0 :: deviceNode { // 为每一个Regulator控制器配置一个HDF设备节点，存在多个时添加，否则不用
policy = 1; // 2：用户态可见；1：内核态可见；0：不需要发布服务
priority = 50; // 驱动启动优先级
permission = 0644; // 驱动创建设备节点权限
/*【必要】用于指定驱动名称，需要与期望的驱动Entry中的moduleName一致；*/
/* 【必要】用于指定驱动名称，需要与期望的驱动Entry中的moduleName一致 */
moduleName = "HDF_PLATFORM_REGULATOR_MANAGER";
serviceName = "HDF_PLATFORM_REGULATOR_MANAGER"; //【必要且唯一】驱动对外发布服务的名称
/*【必要】用于配置控制器私有数据，要与regulator_config.hcs中对应控制器保持一致，具体的控制器信息在regulator_config.hcs 中*/
/* 【必要】用于配置控制器私有数据，要与regulator_config.hcs中对应控制器保持一致，具体的控制器信息在regulator_config.hcs中 */
deviceMatchAttr = "hdf_platform_regulator_manager";
}
device1 :: deviceNode {
......@@ -151,14 +150,14 @@ Regulator模块适配包含以下四个步骤：
}
```
- regulator\_config.hcs 配置参考。
- regulator\_config.hcs配置参考
```
root {
platform {
regulator_config {
match_attr = "linux_regulator_adapter";
template regulator_controller { //【必要】模板配置，继承该模板的节点如果使用模板中的默认值，则节点字段可以缺省
template regulator_controller { // 【必要】模板配置，继承该模板的节点如果使用模板中的默认值，则节点字段可以缺省
device_num = 1;
name = "";
devName = "regulator_adapter_consumer01";
......@@ -180,7 +179,7 @@ Regulator模块适配包含以下四个步骤：
minUa = 0;
maxUa = 0;
}
/*每个Regulator控制器对应一个controller节点，如存在多个Regulator控制器，请依次添加对应的controller节点。*/
/* 每个Regulator控制器对应一个controller节点，如存在多个Regulator控制器，请依次添加对应的controller节点 */
controller_0x130d0001 :: regulator_controller {
device_num = 1;
name = "regulator_adapter_2";
......@@ -216,9 +215,9 @@ Regulator模块适配包含以下四个步骤：
};
struct RegulatorDesc {
const char *name; /* regulator 名称 */
const char *parentName; /* regulator 父节点名称 */
struct RegulatorConstraints constraints; /* regulator 约束信息 */
const char *name; /* regulator名称 */
const char *parentName; /* regulator父节点名称 */
struct RegulatorConstraints constraints; /* regulator约束信息 */
uint32_t minUv; /* 最小输出电压值 */
uint32_t maxUv; /* 最大输出电压值 */
uint32_t minUa; /* 最小输出电流值 */
......@@ -244,7 +243,7 @@ Regulator模块适配包含以下四个步骤：
- 实例化RegulatorNode成员RegulatorMethod，其他成员在Init函数中初始化。
```c
// regulator_virtual.c 中的示例：钩子函数的填充
// regulator_virtual.c中的示例：钩子函数的填充
static struct RegulatorMethod g_method = {
.enable = VirtualRegulatorEnable,
.disable = VirtualRegulatorDisable,
......@@ -262,7 +261,7 @@ Regulator模块适配包含以下四个步骤：
入参：
HdfDeviceObject 是整个驱动对外暴露的接口参数，具备 HCS 配置文件的信息。
HdfDeviceObject 是整个驱动对外暴露的接口参数，具备hcs配置文件的信息。
返回值：
......@@ -270,7 +269,7 @@ Regulator模块适配包含以下四个步骤：
**表 2** HDF\_STATUS相关状态
| 状态(值) | 问题描述 |
| 状态(值) | 描述 |
| ---------------------- | -------------- |
| HDF_ERR_INVALID_OBJECT | 控制器对象非法 |
| HDF_ERR_MALLOC_FAIL | 内存分配失败 |
......@@ -291,7 +290,7 @@ Regulator模块适配包含以下四个步骤：
const struct DeviceResourceNode *childNode = NULL;
...
DEV_RES_NODE_FOR_EACH_CHILD_NODE(device->property, childNode) {
ret = VirtualRegulatorParseAndInit(device, childNode);//【必要】实现见下
ret = VirtualRegulatorParseAndInit(device, childNode);// 【必要】实现见下
...
}
...
......@@ -305,12 +304,12 @@ Regulator模块适配包含以下四个步骤：
regNode = (struct RegulatorNode *)OsalMemCalloc(sizeof(*regNode));//加载HCS文件
...
ret = VirtualRegulatorReadHcs(regNode, node);//读取HCS文件信息
ret = VirtualRegulatorReadHcs(regNode, node);// 读取HCS文件信息
...
regNode->priv = (void *)node; //实例化节点
regNode->ops = &g_method; //实例化ops
regNode->priv = (void *)node; // 实例化节点
regNode->ops = &g_method; // 实例化ops
ret = RegulatorNodeAdd(regNode); //挂载节点
ret = RegulatorNodeAdd(regNode); // 挂载节点
...
}
```
......@@ -319,7 +318,7 @@ Regulator模块适配包含以下四个步骤：
入参：
HdfDeviceObject是整个驱动对外暴露的接口参数，其包含了HCS配置文件中的相关配置信息。
HdfDeviceObject是整个驱动对外暴露的接口参数，其包含了hcs配置文件中的相关配置信息。
返回值：
......@@ -327,13 +326,13 @@ Regulator模块适配包含以下四个步骤：
函数说明:
释放内存和删除控制器，该函数需要在驱动入口结构体中赋值给Release接口，当HDF框架调用Init函数 初始化驱动失败时，可以调用Release释放驱动资源。
释放内存和删除控制器，该函数需要在驱动入口结构体中赋值给Release接口，当HDF框架调用Init函数初始化驱动失败时，可以调用Release释放驱动资源。
```c
static void VirtualRegulatorRelease(struct HdfDeviceObject *device)
{
...
RegulatorNodeRemoveAll();//【必要】调用核心层函数，释放RegulatorNode的设备和服务
RegulatorNodeRemoveAll();// 【必要】调用核心层函数，释放RegulatorNode的设备和服务
}
```
......
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或