Harmony鸿蒙南向驱动开发-Regulator

2024-04-11 02:28
文章标签 开发 驱动 鸿蒙 harmony 南向 regulator

本文主要是介绍Harmony鸿蒙南向驱动开发-Regulator，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

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

运作机制

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

Regulator模块各分层的作用为：

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

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

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

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

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

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);
};

表 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框架中

  2. 配置属性文件

    以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";}}}}
}

    • 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;}}}
}

      需要注意的是，新增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"

  3. 实例化核心层接口函数

    完成驱动入口注册之后，下一步就是对核心层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;       // 最大可设置输出电流
};

    • 实例化RegulatorNode成员RegulatorMethod。

      // regulator_virtual.c中的示例：钩子函数的填充
static struct RegulatorMethod g_method = {.enable = VirtualRegulatorEnable,.disable = VirtualRegulatorDisable,.setVoltage = VirtualRegulatorSetVoltage,.getVoltage = VirtualRegulatorGetVoltage,.setCurrent = VirtualRegulatorSetCurrent,.getCurrent = VirtualRegulatorGetCurrent,.getStatus = VirtualRegulatorGetStatus,
};

    • 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);                                   // 挂载节点......
}

    • Release函数开发参考

      入参：

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

      返回值：

      无。

      函数说明:

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

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

  4. 驱动调试

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

最后

有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）资料用来跟着学习是非常有必要的。 

这份鸿蒙（HarmonyOS NEXT）资料包含了鸿蒙开发必掌握的核心知识要点，内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）技术知识点。

希望这一份鸿蒙学习资料能够给大家带来帮助，有需要的小伙伴自行领取，限时开源，先到先得~无套路领取！！

获取这份完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

鸿蒙（HarmonyOS NEXT）最新学习路线

  •  HarmonOS基础技能

  • HarmonOS就业必备技能 
  •  HarmonOS多媒体技术

  • 鸿蒙NaPi组件进阶

  • HarmonOS高级技能

  • 初识HarmonOS内核 
  • 实战就业级设备开发

有了路线图，怎么能没有学习资料呢，小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门教学视频，内容包含：ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。

获取以上完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

《鸿蒙 (OpenHarmony)开发入门教学视频》

《鸿蒙生态应用开发V2.0白皮书》

图片

《鸿蒙 (OpenHarmony)开发基础到实战手册》

OpenHarmony北向、南向开发环境搭建

图片

 《鸿蒙开发基础》

  • ArkTS语言
  • 安装DevEco Studio
  • 运用你的第一个ArkTS应用
  • ArkUI声明式UI开发
  • .……

图片

 《鸿蒙开发进阶》

  • Stage模型入门
  • 网络管理
  • 数据管理
  • 电话服务
  • 分布式应用开发
  • 通知与窗口管理
  • 多媒体技术
  • 安全技能
  • 任务管理
  • WebGL
  • 国际化开发
  • 应用测试
  • DFX面向未来设计
  • 鸿蒙系统移植和裁剪定制
  • ……

图片

《鸿蒙进阶实战》

  • ArkTS实践
  • UIAbility应用
  • 网络案例
  • ……

图片

 获取以上完整鸿蒙HarmonyOS学习资料，请点击→纯血版全套鸿蒙HarmonyOS学习资料

总结

总的来说，华为鸿蒙不再兼容安卓，对中年程序员来说是一个挑战，也是一个机会。只有积极应对变化，不断学习和提升自己，他们才能在这个变革的时代中立于不败之地。 

这篇关于Harmony鸿蒙南向驱动开发-Regulator的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/892835。

相关文章

这15个Vue指令，让你的项目开发爽到爆

这15个Vue指令，让你的项目开发爽到爆

1. V-Hotkey 仓库地址: github.com/Dafrok/v-ho… Demo: 戳这里 https://dafrok.github.io/v-hotkey 安装: npm install --save v-hotkey 这个指令可以给组件绑定一个或多个快捷键。你想要通过按下 Escape 键后隐藏某个组件，按住 Control 和回车键再显示它吗？小菜一碟： <template
阅读更多...
Hadoop企业开发案例调优场景

Hadoop企业开发案例调优场景

需求 （1）需求：从1G数据中，统计每个单词出现次数。服务器3台，每台配置4G内存，4核CPU，4线程。 （2）需求分析： 1G / 128m = 8个MapTask；1个ReduceTask；1个mrAppMaster 平均每个节点运行10个 / 3台 ≈ 3个任务（4    3    3） HDFS参数调优 （1）修改：hadoop-env.sh export HDFS_NAMENOD
阅读更多...
嵌入式QT开发：构建高效智能的嵌入式系统

嵌入式QT开发：构建高效智能的嵌入式系统

摘要： 本文深入探讨了嵌入式 QT 相关的各个方面。从 QT 框架的基础架构和核心概念出发，详细阐述了其在嵌入式环境中的优势与特点。文中分析了嵌入式 QT 的开发环境搭建过程，包括交叉编译工具链的配置等关键步骤。进一步探讨了嵌入式 QT 的界面设计与开发，涵盖了从基本控件的使用到复杂界面布局的构建。同时也深入研究了信号与槽机制在嵌入式系统中的应用，以及嵌入式 QT 与硬件设备的交互，包括输入输出设
阅读更多...
OpenHarmony鸿蒙开发（ Beta5.0）无感配网详解

OpenHarmony鸿蒙开发（ Beta5.0）无感配网详解

1、简介 无感配网是指在设备联网过程中无需输入热点相关账号信息，即可快速实现设备配网，是一种兼顾高效性、可靠性和安全性的配网方式。 2、配网原理 2.1 通信原理 手机和智能设备之间的信息传递，利用特有的NAN协议实现。利用手机和智能设备之间的WiFi 感知订阅、发布能力，实现了数字管家应用和设备之间的发现。在完成设备间的认证和响应后，即可发送相关配网数据。同时还支持与常规Sof
阅读更多...
活用c4d官方开发文档查询代码

活用c4d官方开发文档查询代码

当你问AI助手比如豆包，如何用python禁止掉xpresso标签时候，它会提示到 这时候要用到两个东西。https://developers.maxon.net/论坛搜索和开发文档 比如这里我就在官方找到正确的id描述 然后我就把参数标签换过来
阅读更多...
Linux_kernel驱动开发11

Linux_kernel驱动开发11

一、改回nfs方式挂载根文件系统         在产品将要上线之前，需要制作不同类型格式的根文件系统         在产品研发阶段，我们还是需要使用nfs的方式挂载根文件系统         优点：可以直接在上位机中修改文件系统内容，延长EMMC的寿命         【1】重启上位机nfs服务         sudo service nfs-kernel-server resta
阅读更多...
【区块链 + 人才服务】区块链集成开发平台 | FISCO BCOS应用案例

【区块链 + 人才服务】区块链集成开发平台 | FISCO BCOS应用案例

随着区块链技术的快速发展，越来越多的企业开始将其应用于实际业务中。然而，区块链技术的专业性使得其集成开发成为一项挑战。针对此，广东中创智慧科技有限公司基于国产开源联盟链 FISCO BCOS 推出了区块链集成开发平台。该平台基于区块链技术，提供一套全面的区块链开发工具和开发环境，支持开发者快速开发和部署区块链应用。此外，该平台还可以提供一套全面的区块链开发教程和文档，帮助开发者快速上手区块链开发。
阅读更多...
Vue3项目开发——新闻发布管理系统（六）

Vue3项目开发——新闻发布管理系统（六）

文章目录 八、首页设计开发1、页面设计2、登录访问拦截实现3、用户基本信息显示①封装用户基本信息获取接口②用户基本信息存储③用户基本信息调用④用户基本信息动态渲染 4、退出功能实现①注册点击事件②添加退出功能③数据清理 5、代码下载 八、首页设计开发 登录成功后，系统就进入了首页。接下来，也就进行首页的开发了。 1、页面设计 系统页面主要分为三部分，左侧为系统的菜单栏，右侧
阅读更多...
v0.dev快速开发

v0.dev快速开发

探索v0.dev：次世代开发者之利器 今之技艺日新月异，开发者之工具亦随之进步不辍。v0.dev者，新兴之开发者利器也，迅速引起众多开发者之瞩目。本文将引汝探究v0.dev之基本功能与优势，助汝速速上手，提升开发之效率。 何谓v0.dev？ v0.dev者，现代化之开发者工具也，旨在简化并加速软件开发之过程。其集多种功能于一体，助开发者高效编写、测试及部署代码。无论汝为前端开发者、后端开发者
阅读更多...
pico2 开发环境搭建-基于ubuntu

pico2 开发环境搭建-基于ubuntu

pico2 开发环境搭建-基于ubuntu 安装编译工具链下载sdk 和example编译example 安装编译工具链 sudo apt install cmake gcc-arm-none-eabi libnewlib-arm-none-eabi libstdc++-arm-none-eabi-newlib 注意cmake的版本，需要在3.17 以上 下载sdk 和ex
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2