Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
4e71d2d6
D
Docs
项目概览
OpenHarmony
/
Docs
1 年多 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
未验证
提交
4e71d2d6
编写于
3月 25, 2022
作者:
L
liyan
提交者:
Gitee
3月 25, 2022
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
update zh-cn/device-dev/driver/driver-platform-regulator-develop.md.
Signed-off-by:
N
li-yan339
<
liyan339@h-partners.com
>
上级
589cf078
变更
1
显示空白变更内容
内联
并排
Showing
1 changed file
with
125 addition
and
136 deletion
+125
-136
zh-cn/device-dev/driver/driver-platform-regulator-develop.md
zh-cn/device-dev/driver/driver-platform-regulator-develop.md
+125
-136
未找到文件。
zh-cn/device-dev/driver/driver-platform-regulator-develop.md
浏览文件 @
4e71d2d6
# R
EGULATOR
# R
egulator
-
[
概述
](
#1
)
-
[
功能简介
](
#2
)
-
[
基本概念
](
#3
)
-
[
运作机制
](
#4
)
-
[
约束与限制
](
#5
)
-
[
开发指导
](
#6
)
-
[
场景介绍
](
#7
)
-
[
接口说明
](
#8
)
-
[
开发步骤
](
#9
)
## 概述
<a name="1"></a>
## 概述
### 功能简介
<a name="2"></a>
### 功能简介
R
EGULATOR
模块用于控制系统中某些设备的电压/电流供应。
R
egulator
模块用于控制系统中某些设备的电压/电流供应。
### 基本概念
<a name="3"></a>
### 基本概念
R
EGULATOR模块用于控制系统中某些设备的电压/电流供应。在嵌入式系统(尤其是手机)中,控制耗电量很重要,直接影响到电池的续航时间。所以,如果系统中某一个模块暂时不需要使用,就可以通过REGULATOR
关闭其电源供应;或者降低提供给该模块的电压、电流大小。
R
egulator模块用于控制系统中某些设备的电压/电流供应。在嵌入式系统(尤其是手机)中,控制耗电量很重要,直接影响到电池的续航时间。所以,如果系统中某一个模块暂时不需要使用,就可以通过Regulator
关闭其电源供应;或者降低提供给该模块的电压、电流大小。
### 运作机制
<a name="4"></a>
### 运作机制
在HDF框架中,R
EGULATOR模块接口适配模式采用统一服务模式,这需要一个设备服务来作为REGULATOR模块的管理器,统一处理外部访问,这会在配置文件中有所体现。统一服务模式适合于同类型设备对象较多的情况,如REGULATOR
可能同时具备十几个控制器,采用独立服务模式需要配置更多的设备节点,且服务会占据内存资源。
在HDF框架中,R
egulator模块接口适配模式采用统一服务模式,这需要一个设备服务来作为Regulator模块的管理器,统一处理外部访问,这会在配置文件中有所体现。统一服务模式适合于同类型设备对象较多的情况,如Regulator
可能同时具备十几个控制器,采用独立服务模式需要配置更多的设备节点,且服务会占据内存资源。
R
EGULATOR
模块各分层的作用为:接口层提供打开设备,写入数据,关闭设备接口的能力。核心层主要提供绑定设备、初始化设备以及释放设备的能力。适配层实现其他具体的功能。
R
egulator
模块各分层的作用为:接口层提供打开设备,写入数据,关闭设备接口的能力。核心层主要提供绑定设备、初始化设备以及释放设备的能力。适配层实现其他具体的功能。
![](
../public_sys-resources/icon-note.gif
)
说明:核心层可以调用接口层的函数,也可以通过钩子函数调用适配层函数,从而使得适配层间接的可以调用接口层函数,但是不可逆转接口层调用适配层函数。
图 1
统一服务模式结构图
**图 1**
统一服务模式结构图
![
image1
](
figures/统一服务模式结构图.png
)
### 约束与限制
Regulator模块当前仅支持轻量和小型系统内核(LiteOS)。
##
# 约束与限制<a name="5"></a>
##
开发指导
REGULATOR模块当前仅支持轻量和小型系统内核(LiteOS) 。
### 场景介绍
## 开发指导<a name="6"></a>
Regulator模块用于控制系统中某些设备的电压/电流供应。
###
场景介绍<a name="7"></a>
###
接口说明
REGULATOR模块用于控制系统中某些设备的电压/电流供应。
### 接口说明<a name="8"></a>
通过以下RegulatorMethod中的函数调用REGULATOR驱动对应的函数。
通过以下RegulatorMethod中的函数调用Regulator驱动对应的函数。
RegulatorMethod定义:
...
...
@@ -70,25 +59,24 @@ struct RegulatorMethod {
**表 1**
RegulatorMethod 结构体成员的回调函数功能说明
<a
name=
"table27410339187"
></a>
| 成员函数 | 入参 | 返回值 | 功能 |
| ------------ | ------------------------------------------------------------ | ------------------ | ---------------- |
| open |
**node**
:结构体指针,核心层
r
egulator节点; | HDF_STATUS相关状态 | 打开设备 |
| close |
**node**
:结构体指针,核心层
r
egulator节点; | HDF_STATUS相关状态 | 关闭设备 |
| release |
**node**
:结构体指针,核心层
r
egulator节点; | HDF_STATUS相关状态 | 释放设备句柄 |
| enable |
**node**
:结构体指针,核心层
r
egulator节点; | HDF_STATUS相关状态 | 使能 |
| disable |
**node**
:结构体指针,核心层
r
egulator节点; | HDF_STATUS相关状态 | 禁用 |
| forceDisable |
**node**
:结构体指针,核心层
r
egulator节点; | HDF_STATUS相关状态 | 强制禁用 |
| setVoltage |
**node**
:结构体指针,核心层
regulator节点;
**minUv**
:uint32_t变量,最小电压;
**maxUv**
:uint32_t变量,最大电压; | HDF_STATUS相关状态 | 设置输出电压范围 |
| getVoltage |
**node**
:结构体指针,核心层
regulator节点;
**voltage**
:uint32_t指针,传出电压值; | HDF_STATUS相关状态 | 获取电压 |
| setCurrent |
**node**
:结构体指针,核心层
regulator节点;
**minUa**
:uint32_t变量,最小电流;
**maxUa**
:uint32_t变量,最大电流; | HDF_STATUS相关状态 | 设置输出电流范围 |
| getCurrent |
**node**
:结构体指针,核心层
regulator节点;
**regCurrent**
:uint32_t指针,传出电流值; | HDF_STATUS相关状态 | 获取电流 |
| getStatus |
**node**
:结构体指针,核心层
regulator节点;
**status**
:uint32_t指针,传出状态值; | HDF_STATUS相关状态 | 获取设备状态 |
### 开发步骤
<a name="9"></a>
R
EGULATOR
模块适配包含以下四个步骤:
| open |
**node**
:结构体指针,核心层
R
egulator节点; | HDF_STATUS相关状态 | 打开设备 |
| close |
**node**
:结构体指针,核心层
R
egulator节点; | HDF_STATUS相关状态 | 关闭设备 |
| release |
**node**
:结构体指针,核心层
R
egulator节点; | HDF_STATUS相关状态 | 释放设备句柄 |
| enable |
**node**
:结构体指针,核心层
R
egulator节点; | HDF_STATUS相关状态 | 使能 |
| disable |
**node**
:结构体指针,核心层
R
egulator节点; | HDF_STATUS相关状态 | 禁用 |
| forceDisable |
**node**
:结构体指针,核心层
R
egulator节点; | 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相关状态 | 获取设备状态 |
### 开发步骤
R
egulator
模块适配包含以下四个步骤:
-
实例化驱动入口。
-
配置属性文件。
...
...
@@ -118,18 +106,18 @@ REGULATOR模块适配包含以下四个步骤:
deviceNode信息与驱动入口注册相关,器件属性值与核心层RegulatorNode成员的默认值或限制范围有密切关系。
由于采用了统一服务模式,device_info.hcs文件中第一个设备节点必须为R
EGULATOR
管理器,其各项参数必须如下设置:
由于采用了统一服务模式,device_info.hcs文件中第一个设备节点必须为R
egulator
管理器,其各项参数必须如下设置:
| 成员名 | 值 |
| --------------- | ------------------------------------------------------------ |
| policy | 具体配置为0,不发布服务 |
| priority | 驱动启动优先级(0-200),值越大优先级越低,,优先级相同则不保证device的加载顺序。 |
| permission | 驱动权限 |
| moduleName | 固定为
HDF_PLATFORM_REGULATOR_MANAGER |
| moduleName | 固定为HDF_PLATFORM_REGULATOR_MANAGER |
| serviceName | 固定为HDF_PLATFORM_REGULATOR_MANAGER |
| deviceMatchAttr | 没有使用,可忽略 |
从第二个节点开始配置具体R
EGULATOR控制器信息,此节点并不表示某一路REGULATOR控制器,而是代表一个资源性质设备,用于描述一类REGULATOR控制器的信息。本例只有一个REGULATOR
设备,如有多个设备,则需要在device_info文件增加deviceNode信息,以及在regulator
\_
config文件中增加对应的器件属性。
从第二个节点开始配置具体R
egulator控制器信息,此节点并不表示某一路Regulator控制器,而是代表一个资源性质设备,用于描述一类Regulator控制器的信息。本例只有一个Regulator
设备,如有多个设备,则需要在device_info文件增加deviceNode信息,以及在regulator
\_
config文件中增加对应的器件属性。
-
device_info.hcs 配置参考。
...
...
@@ -140,7 +128,7 @@ REGULATOR模块适配包含以下四个步骤:
hostName = "platform_host";
priority = 50;
device_regulator :: device {
device0 :: deviceNode { //为每一个R
EGULATOR
控制器配置一个HDF设备节点,存在多个时添加,否则不用
device0 :: deviceNode { //为每一个R
egulator
控制器配置一个HDF设备节点,存在多个时添加,否则不用
policy = 1; // 2:用户态可见,1:内核态可见,0:不需要发布服务
priority = 50; // 驱动启动优先级
permission = 0644; // 驱动创建设备节点权限
...
...
@@ -278,7 +266,7 @@ REGULATOR模块适配包含以下四个步骤:
返回值:
HDF
\_
STATUS相关状态
(下表为部分展示,如需使用其他状态,可见//drivers/framework/include/utils/hdf
\_
base.h中HDF
\_
STATUS 定义)。
HDF
\_
STATUS相关状态
(下表为部分展示,如需使用其他状态,可见//drivers/framework/include/utils/hdf
\_
base.h中HDF
\_
STATUS 定义)。
**表 2**
HDF
\_
STATUS相关状态
...
...
@@ -295,6 +283,7 @@ REGULATOR模块适配包含以下四个步骤:
初始化自定义结构体和RegulatorNode成员,并通过调用核心层RegulatorNodeAdd函数挂载Regulator控制器。
```
c
static
int32_t
VirtualRegulatorInit
(
struct
HdfDeviceObject
*
device
)
{
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录