OpenHarmony(鸿蒙南向)——平台驱动开发【Regulator】

往期知识点记录:

  • 鸿蒙(HarmonyOS)应用层开发(北向)知识点汇总
  • 鸿蒙(OpenHarmony)南向开发保姆级知识点汇总~
  • 持续更新中……

概述

功能简介

Regulator模块用于控制系统中各类设备的电压/电流供应。在嵌入式系统(尤其是手机)中,控制耗电量很重要,直接影响到电池的续航时间。所以,如果系统中某一个模块暂时不需要使用,就可以通过Regulator关闭其电源供应;或者降低提供给该模块的电压、电流大小。

运作机制

在HDF框架中,Regulator模块接口适配模式采用统一服务模式(如图1所示),这需要一个设备服务来作为Regulator模块的管理器,统一处理外部访问,这会在配置文件中有所体现。统一服务模式适合于同类型设备对象较多的情况,如Regulator可能同时具备十几个控制器,采用独立服务模式需要配置更多的设备节点,且服务会占据内存资源。

Regulator模块各分层的作用为:

  • 接口层:提供打开设备,操作Regulator,关闭设备的能力。

  • 核心层:主要负责服务绑定、初始化以及释放管理器,并提供添加、删除以及获取Regulator设备的能力。

  • 适配层:由驱动适配者实现与硬件相关的具体功能,如设备的初始化等。

在统一模式下,所有的控制器都被核心层统一管理,并由核心层统一发布一个服务供接口层,因此这种模式下驱动无需再为每个控制器发布服务。

图 1 Regulator统一服务模式结构图

约束与限制

Regulator模块当前仅支持小型系统。

开发指导

场景介绍

Regulator模块用于控制系统中某些设备的电压/电流供应。当驱动开发者需要将Regulator设备适配到OpenHarmony时,需要进行Regulator驱动适配,下文将介绍如何进行Regulator驱动适配。

接口说明

为了保证上层在调用Regulator接口时能够正确的操作硬件,核心层在//drivers/hdf_core/framework/support/platform/include/regulator/regulator_core.h中定义了以下钩子函数。驱动适配者需要在适配层实现这些函数的具体功能,并与这些钩子函数挂接,从而完成接口层与核心层的交互。

RegulatorMethod定义:

struct RegulatorMethod {int32_t (*open)(struct RegulatorNode *node);int32_t (*close)(struct RegulatorNode *node);int32_t (*release)(struct RegulatorNode *node);int32_t (*enable)(struct RegulatorNode *node);int32_t (*disable)(struct RegulatorNode *node);int32_t (*forceDisable)(struct RegulatorNode *node);int32_t (*setVoltage)(struct RegulatorNode *node, uint32_t minUv, uint32_t maxUv);int32_t (*getVoltage)(struct RegulatorNode *node, uint32_t *voltage);int32_t (*setCurrent)(struct RegulatorNode *node, uint32_t minUa, uint32_t maxUa);int32_t (*getCurrent)(struct RegulatorNode *node, uint32_t *regCurrent);int32_t (*getStatus)(struct RegulatorNode *node, uint32_t *status);
};
c

表 1 RegulatorMethod 结构体成员的钩子函数功能说明

成员函数入参返回值功能
opennode:结构体指针,核心层Regulator节点HDF_STATUS相关状态打开设备
closenode:结构体指针,核心层Regulator节点HDF_STATUS相关状态关闭设备
releasenode:结构体指针,核心层Regulator节点HDF_STATUS相关状态释放设备句柄
enablenode:结构体指针,核心层Regulator节点HDF_STATUS相关状态使能
disablenode:结构体指针,核心层Regulator节点HDF_STATUS相关状态禁用
forceDisablenode:结构体指针,核心层Regulator节点HDF_STATUS相关状态强制禁用
setVoltagenode:结构体指针,核心层Regulator节点
minUv:uint32_t类型,最小电压
maxUv:uint32_t类型,最大电压
HDF_STATUS相关状态设置输出电压范围
getVoltagenode:结构体指针,核心层Regulator节点
voltage:uint32_t类型指针,传出电压值
HDF_STATUS相关状态获取电压
setCurrentnode:结构体指针,核心层Regulator节点
minUa:uint32_t类型,最小电流
maxUa:uint32_t类型,最大电流
HDF_STATUS相关状态设置输出电流范围
getCurrentnode:结构体指针,核心层Regulator节点
regCurrent:uint32_t类型指针,传出电流值
HDF_STATUS相关状态获取电流
getStatusnode:结构体指针,核心层Regulator节点
status:uint32_t类型指针,传出状态值
HDF_STATUS相关状态获取设备状态

开发步骤

Regulator模块适配包含以下四个步骤:

  • 实例化驱动入口
  • 配置属性文件
  • 实例化核心层接口函数
  • 驱动调试
  1. 实例化驱动入口

驱动开发首先需要实例化驱动入口,驱动入口必须为HdfDriverEntry(在hdf_device_desc.h中定义)类型的全局变量,且moduleName要和device_info.hcs中保持一致。

HDF框架会汇总所有加载的驱动的HdfDriverEntry对象入口,形成一个类似数组的段地址空间,方便上层调用。

一般在加载驱动时HDF会先调用Init函数加载该驱动。当Init调用异常时,HDF框架会调用Release释放驱动资源并退出。

    struct HdfDriverEntry g_regulatorDriverEntry = {.moduleVersion = 1,.moduleName = "virtual_regulator_driver",       // 【必要且与HCS文件中里面的moduleName匹配】.Init = VirtualRegulatorInit,                   // 见Init参考.Release = VirtualRegulatorRelease,             // 见Release参考};HDF_INIT(g_regulatorDriverEntry);                   // 调用HDF_INIT将驱动入口注册到HDF框架中c
  1. 配置属性文件

以Hi3516DV300开发板为例,在//vendor/hisilicon/hispark_taurus/hdf_config/device_info/device_info.hcs文件中添加deviceNode描述。

deviceNode信息与驱动入口注册相关,器件属性值与核心层RegulatorNode成员的默认值或限制范围有密切关系。

由于采用了统一服务模式,device_info.hcs文件中第一个设备节点必须为Regulator管理器,其各项参数必须如如表2所示:

表 2 device_info.hcs节点参数说明

成员名
policy驱动服务发布的策略,Regulator管理器具体配置为1,表示驱动对内核态发布服务
priority驱动启动优先级(0-200)。值越大优先级越低,优先级相同则不保证device的加载顺序,regulator管理器具体配置为50
permission驱动创建设备节点权限,Regulator管理器具体配置为0664
moduleName驱动名称,Regulator管理器固定为HDF_PLATFORM_REGULATOR_MANAGER
serviceName驱动对外发布服务的名称,Regulator管理器固定为HDF_PLATFORM_REGULATOR_MANAGER
deviceMatchAttr驱动私有数据匹配的关键字,Regulator管理器设置为hdf_platform_regulator_manager

从第二个节点开始配置具体Regulator控制器信息,此节点并不表示某一路Regulator控制器,而是代表一个资源性质设备,用于描述一类Regulator控制器的信息。本例只有一个Regulator设备,如有多个设备,则需要在device_info.hcs文件增加deviceNode信息,以及在regulator_config_linux.hcs文件中增加对应的器件属性。

  • device_info.hcs 配置参考
        root {device_info {platform :: host {hostName = "platform_host";priority = 50;device_regulator :: device {device0 :: deviceNode {	                                 // 为每一个Regulator控制器配置一个HDF设备节点,存在多个时添加,否则不用。policy = 1;	                                         // 2:用户态、内核态均可见;1:内核态可见;0:不需要发布服务。priority = 50;	                                     // 驱动启动优先级permission = 0644;	                                 // 驱动创建设备节点权限moduleName = "HDF_PLATFORM_REGULATOR_MANAGER";                                                //【必要】用于指定驱动名称,需要与期望的驱动Entry中的moduleName一致。serviceName = "HDF_PLATFORM_REGULATOR_MANAGER";		 // 【必要且唯一】驱动对外发布服务的名称deviceMatchAttr = "hdf_platform_regulator_manager";  // 【必要】用于配置控制器私有数据,要与regulator_config.hcs中对应控制器保持一致,具体的控制器信息在regulator_config.hcs中。}device1 :: deviceNode {policy = 0;priority = 55;permission = 0644;moduleName = "linux_regulator_adapter";deviceMatchAttr = "linux_regulator_adapter";}}}}}c
  • regulator_config_linux.hcs配置参考
        root {platform {regulator_config {match_attr = "linux_regulator_adapter";template regulator_controller {   // 【必要】模板配置,继承该模板的节点如果使用模板中的默认值,则节点字段可以缺省。device_num = 1;name = "";devName = "regulator_adapter_consumer01";supplyName = "";mode = 1;minUv = 0;                    // 最小电压maxUv = 20000;                // 最大电压minUa = 0;                    // 最小电流maxUa = 0;                    // 最大电流}controller_0x130d0000 :: regulator_controller {device_num = 1;name = "regulator_adapter_1";devName = "regulator_adapter_consumer01";supplyName = "virtual-regulator-hdf-adapter";mode = 1;minUv = 1000;maxUv = 50000;minUa = 0;maxUa = 0;}// 每个Regulator控制器对应一个controller节点,如存在多个Regulator控制器,请依次添加对应的controller节点。controller_0x130d0001 :: regulator_controller {device_num = 1;name = "regulator_adapter_2";devName = "regulator_adapter_consumer01";supplyName = "virtual2-regulator-hdf-adapter";mode = 2;minUv = 0;maxUv = 0;minUa = 1000;maxUa = 50000;}}}}c

需要注意的是,新增regulator_config.hcs配置文件后,必须在hdf.hcs文件中将其包含,否则配置文件无法生效。

例如:本例中regulator_config.hcs所在路径为//vendor/hisilicon/hispark_taurus_linux/hdf_config/device/regulator/regulator_config_linux.hcs,则必须在产品对应的hdf.hcs中添加如下语句:

        #include "device/regulator/regulator_config_linux.hcs"c
  1. 实例化核心层接口函数

完成驱动入口注册之后,下一步就是对核心层RegulatorNode对象的初始化,包括驱动适配者自定义结构体(传递参数和数据),实例化RegulatorNode成员RegulatorMethod(让用户可以通过接口来调用驱动底层函数),实现HdfDriverEntry成员函数(Bind、Init、Release)。

  • 自定义结构体参考。

从驱动的角度看,RegulatorNode结构体是参数和数据的载体,HDF框架通过DeviceResourceIface将regulator_config.hcs文件中的数值读入其中。

        // RegulatorNode是核心层控制器结构体,其中的成员在Init函数中会被赋值。struct RegulatorNode {struct RegulatorDesc regulatorInfo;struct DListHead node;struct RegulatorMethod *ops;void *priv;struct OsalMutex lock;};struct RegulatorDesc {const char *name;                           // regulator名称const char *parentName;                     // regulator父节点名称struct RegulatorConstraints constraints;    // regulator约束信息uint32_t minUv;                             // 最小输出电压值uint32_t maxUv;                             // 最大输出电压值uint32_t minUa;                             // 最小输出电流值uint32_t maxUa;                             // 最大输出电流值uint32_t status;                            // regulator的状态,开或关。int useCount;int consumerRegNums;                        // regulator用户数量RegulatorStatusChangecb cb;                 // 当regulator状态改变时,可通过此变量通知。};struct RegulatorConstraints {uint8_t alwaysOn;     // regulator是否常开uint8_t mode;         // 模式:电压或者电流uint32_t minUv;       // 最小可设置输出电压uint32_t maxUv;       // 最大可设置输出电压uint32_t minUa;       // 最小可设置输出电流uint32_t maxUa;       // 最大可设置输出电流};c
  • 实例化RegulatorNode成员RegulatorMethod。
        // regulator_virtual.c中的示例:钩子函数的填充static struct RegulatorMethod g_method = {.enable = VirtualRegulatorEnable,.disable = VirtualRegulatorDisable,.setVoltage = VirtualRegulatorSetVoltage,.getVoltage = VirtualRegulatorGetVoltage,.setCurrent = VirtualRegulatorSetCurrent,.getCurrent = VirtualRegulatorGetCurrent,.getStatus = VirtualRegulatorGetStatus,};c
  • Init函数开发参考

入参:

HdfDeviceObject是整个驱动对外提供的接口参数,具备HCS配置文件的信息。

返回值:

HDF_STATUS相关状态(表4为部分展示,如需使用其他状态,可参考//drivers/hdf_core/interfaces/inner_api/utils/hdf_base.h中HDF_STATUS定义)。

表 3 HDF_STATUS相关状态说明

状态(值)描述
HDF_ERR_INVALID_OBJECT控制器对象非法
HDF_ERR_MALLOC_FAIL内存分配失败
HDF_ERR_INVALID_PARAM参数非法
HDF_ERR_IOI/O 错误
HDF_SUCCESS初始化成功
HDF_FAILURE初始化失败

函数说明:

初始化自定义结构体和RegulatorNode成员,并通过调用核心层RegulatorNodeAdd函数挂载Regulator控制器。

        static int32_t VirtualRegulatorInit(struct HdfDeviceObject *device){int32_t ret;const struct DeviceResourceNode *childNode = NULL;...DEV_RES_NODE_FOR_EACH_CHILD_NODE(device->property, childNode) {ret = VirtualRegulatorParseAndInit(device, childNode);         // 【必要】实现见下......}......}static int32_t VirtualRegulatorParseAndInit(struct HdfDeviceObject *device, const struct DeviceResourceNode *node){int32_t ret;struct RegulatorNode *regNode = NULL;(void)device;regNode = (struct RegulatorNode *)OsalMemCalloc(sizeof(*regNode)); //加载HCS文件......ret = VirtualRegulatorReadHcs(regNode, node);                      // 读取HCS文件信息......regNode->priv = (void *)node;                                      // 实例化节点regNode->ops = &g_method;                                          // 实例化opsret = RegulatorNodeAdd(regNode);                                   // 挂载节点......}c
  • Release函数开发参考

入参:

HdfDeviceObject是整个驱动对外提供的接口参数,其包含了HCS配置文件中的相关配置信息。

返回值:

无。

函数说明:

释放内存和删除控制器,该函数需要在驱动入口结构体中赋值给Release接口,当HDF框架调用Init函数初始化驱动失败时,可以调用Release释放驱动资源。

        static void VirtualRegulatorRelease(struct HdfDeviceObject *device){......RegulatorNodeRemoveAll(); // 【必要】调用核心层函数,释放RegulatorNode的设备和服务}c
  1. 驱动调试

【可选】针对新增驱动程序,建议验证驱动基本功能,例如挂载后的测试用例是否成功等。

最后

经常有很多小伙伴抱怨说:不知道学习鸿蒙开发哪些技术?不知道需要重点掌握哪些鸿蒙应用开发知识点?

为了能够帮助到大家能够有规划的学习,这里特别整理了一套纯血版鸿蒙(HarmonyOS Next)全栈开发技术的学习路线,包含了鸿蒙开发必掌握的核心知识要点,内容有(ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、WebGL、元服务、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、OpenHarmony驱动开发、系统定制移植等等)鸿蒙(HarmonyOS NEXT)技术知识点。

在这里插入图片描述

《鸿蒙 (Harmony OS)开发学习手册》(共计892页):https://gitcode.com/HarmonyOS_MN/733GH/overview

如何快速入门?

1.基本概念
2.构建第一个ArkTS应用
3.……

鸿蒙开发面试真题(含参考答案):

在这里插入图片描述

《OpenHarmony源码解析》:

  • 搭建开发环境
  • Windows 开发环境的搭建
  • Ubuntu 开发环境搭建
  • Linux 与 Windows 之间的文件共享
  • ……
  • 系统架构分析
  • 构建子系统
  • 启动流程
  • 子系统
  • 分布式任务调度子系统
  • 分布式通信子系统
  • 驱动子系统
  • ……

图片

OpenHarmony 设备开发学习手册:https://gitcode.com/HarmonyOS_MN/733GH/overview

图片
在这里插入图片描述

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.rhkb.cn/news/432086.html

如若内容造成侵权/违法违规/事实不符,请联系长河编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

有关shell指令练习2

写一个shell脚本,将以下内容放到脚本中 在家目录下创建目录文件,dir dir下创建dir1和dir2 把当前目录下的所有文件拷贝到dir1中, 把当前目录下的所有脚本文件拷贝到dir2中 把dir2打包并压缩为dir2.tar.xz 再把dir2.tar.xz移动到dir1中 …

excel快速入门(二)

Excel的概念说明 文章目录 Excel的概念说明常见术语说明单元格/单元格区域活动单元格/单元格区域行或列单元格引用相对引用绝对引用混合引用 Excel的常见格式说明单元格格式数字格式 Excel 工作表编辑鼠标指针介绍1.白色十字状2.单向黑色箭头状3.双向单竖线箭头状4.双向双竖线箭…

Linux下的git开篇第一文:git的意义

1.git版本控制器 git其实就是一个版本控制器,程序员在写代码的时候,利用git工具保存每一个版本,在程序员需要任何一个版本的时候,都可提供。 2.git gitee&&github github其实上就是国外的gitee,网址在国外&am…

C++——关联式容器(5):哈希表

7.哈希表 7.1 哈希表引入 哈希表的出现依旧是为了查找方便而设计的。在顺序结构中,查询一个值需要一一比较,复杂度为O(N);在平衡树中,查询变为了二分查找,复杂度为O(logN);而对于哈希表,我们可…

JavaWeb - 7 - SpringBootWeb入门

Spring 官网:Spring | Home Spring发展到今天已经形成了一种开发生态圈,Spring提供了若干个子项目,每个项目用于完成特定的功能 SpringBoot SpringBoot可以帮助我们非常快速的构建应用程序、简化开发、提高效率 一.SpringBootWeb入门 需求…

【React】样式控制

1.react组件样式控制方式 行内样式&#xff08;通过style属性&#xff09;&#xff1a;不推荐class类名控制 function App() {const style {color: skyblue,fontSize: 20px}return (<div className"App"><span style{{ color: "pink", fontSiz…

N诺计算机考研-错题

B A.LLC&#xff0c;逻辑链路控制子层。一个主机中可能有多个进程在运行&#xff0c;它们可能同时与其他的一些进程&#xff08;在同一主机或多个主机中&#xff09;进行通信。因此在一个主机的 LLC子层的一个服务访问点&#xff0c;以便向多个进程提供服务。B.MAC地址&#xf…

VSCode#include头文件时找不到头文件:我的解决方法

0.前言 1.在学习了Linux之后&#xff0c;我平常大部分都使用本地的XShell或者VSCode连接远程云服务器写代码&#xff0c;CentOS的包管理器为我省去了不少繁琐的事情&#xff0c;今天使用vscode打开本地目录想写点代码发现#include头文件后&#xff0c;下方出现了波浪线&#…

手机解压软件加密指南:让文件更安全

在数字化时代&#xff0c;文件加密对于保护个人隐私和敏感信息的重要性不言而喻。随着互联网的飞速发展&#xff0c;我们的生活和工作越来越依赖于数字设备和网络。 然而&#xff0c;这也带来了一系列的安全风险&#xff0c;如黑客攻击、数据泄露等。文件加密技术成为了保护我…

keil软件开发流程

1.先建一个文件 2.然后打开keil&#xff0c;打开keil软件新建keil工程 3.确定保存的位置以及工程的名字 4.确定开发工程所用的单片机芯片 5.复制启动文件到工程中选择否 6.创建新的C文件 7.保存C文件 8.写一个代码 9.编译代码 10.勾选设置&#xff0c;生成可执行文件 10.构建代…

无人机之可承受风速的影响因素

无人机可承受风速的影响因素是多方面的&#xff0c;这些因素共同决定了无人机在特定风速条件下的飞行稳定性和安全性。以下是一些主要的影响因素&#xff1a; 一、无人机设计与结构 无人机的大小、形状和重量都会直接影响其抗风能力。大型无人机由于具有更大的表面积和质量&am…

HAproxy-7层负载均衡集群根据不同服务请求分配服务器

搭建HAproxy----7层负载均衡集群的补充 https://blog.csdn.net/qq_73990369/article/details/142500451?spm1001.2014.3001.5501 一、再准备两台虚拟机进行测试 192.168.229.15/24 ----php1 192.168.229.16/24 ----php2 1、PHP1 & php2(192.168.229.15/24 ,192…

SVG之path详解,全面解析椭圆弧命令A

前言&#xff1a; 转载于b站深坑妙脆角&#xff0c;讲解清晰明了&#xff0c;对初使用path圆弧命令非常友好 作者&#xff1a;深坑妙脆角 https://www.bilibili.com/read/cv35872299/?jump_opus1 出处&#xff1a;bilibili 简述&#xff1a; SVG 中的 <path> 元素用于创…

大数据Flink(一百二十三):五分钟上手Flink MySQL连接器

文章目录 五分钟上手Flink MySQL连接器 一、创建数据库表 二、​​​​​​创建session集群 三、源表查询 四、​​​​​窗口计算 五、​​​​​​结果数据写回数据库 五分钟上手Flink MySQL连接器 MySQL Connector可以将本地或远程的MySQL数据库连接到Flink中&#x…

16【Protues51单片机仿真】智能洗衣机倒计时系统

目录 一、主要功能 二、硬件资源 三、程序编程 四、实现现象 一、主要功能 用直流电机转动模拟洗衣机。要求 有弱洗、普通洗、强洗三种模式&#xff0c;可通过按键选择。可以设置洗衣时长&#xff0c;通关按键选择15、30、45、60、90分钟。时间到蜂鸣器报警提示。LCD 显示…

Koa (下一代web框架) 【Node.js进阶】

koa (中文网) 是基于 Node.js 平台的下一代 web 开发框架&#xff0c;致力于成为应用和 API 开发领域中的一个更小、更富有表现力、更健壮的基石&#xff1b; 利用 async 函数 丢弃回调函数&#xff0c;并增强错误处理&#xff0c;koa 没有任何预置的中间件&#xff0c;可快速…

大数据Hive组件安装

组件版本 组件版本Hadoop3.3.0JDK1.8.0_241Mysql5.7.25Hive3.1.2 Hadoop集群服务分布 Node1Node2Node3NameNode DataNode DataNodeDataNode NodeManager NodeManagerResourceManagerSecondaryNameNode 安装前请确定Hadoop集群服务全部启动&#xff0c;不然后续测试时会报…

Python面向对象编程:类和对象①

文章目录 一、什么是面向对象编程1.1 面向对象编程的基本概念1.2 Python中的类和对象 二、定义类和创建对象2.1 定义类2.2 创建对象2.3 __init__方法2.4 self参数 三、类的属性和方法3.1 类的属性3.1.1 实例属性3.1.2 类属性 3.2 类的方法3.2.1 实例方法3.2.2 类方法3.2.3 静态…

解锁HTML的力量:从基础标签到完整网页构建

在整个学习编程技能的过程中&#xff0c;我们会始终基于编程的本质&#xff1a;输入-》函数处理-》输出 和编程语言的本质&#xff1a;语法糖、变量、基础函数&#xff0c;去理解各种编程技术和学习相关的技能。 今天开始学习编程的第一个技能点&#xff1a;HTML。正如编程的本…

2024 Snap 新款ar眼镜介绍

2024 snap 新款ar眼镜介绍 2024 Snap 新款ar眼镜介绍 助力快速掌握数据集的信息和使用方式。