Harmony鸿蒙南向驱动开发-Regulator接口使用

news2025/11/1 3:29:10

功能简介

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

Regulator接口定义了操作Regulator设备的通用方法集合，包括：

  • Regulator设备句柄获取和销毁。

  • Regulator设备电压、电流的设置。

  • Regulator设备使能和关闭。

  • Regulator设备电压、电流和状态的获取。

基本概念

  • 校准器

    当输入电压和输出负载发生变化时可以通过软件调整，使其能够提供稳定的输出电压。

  • Consumer

    由Regulator供电的设备统称为Consumer， 其可分为静态和动态两类：

    • 静态：不需要改变电压电流，只需要开关电源，通常在bootloader、firmware、kernel board阶段被设置。

    • 动态：根据操作需求改变电压电流。

  • PMIC（Power Management IC）

    电源管理芯片，内含多个电源甚至其他子系统。

运作机制

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

Regulator模块各分层的作用为：

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

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

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

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

Regulator统一服务模式结构图

约束与限制

Regulator模块API当前仅支持内核态调用。

使用指导

场景介绍

Regulator主要用于：

  1. 用于控制系统中某些设备的电压/电流供应。

  2. 用于稳压电源的管理。

接口说明

Regulator模块提供的主要接口如表1所示，具体API详见//drivers/hdf_core/framework/include/platform/regulator_if.h。

表 1 Regulator设备API接口说明

接口名接口描述
DevHandle RegulatorOpen(const char *name)获取Regulator设备驱动句柄
void RegulatorClose(DevHandle handle)销毁Regulator设备驱动句柄
int32_t RegulatorEnable(DevHandle handle)使能Regulator
int32_t RegulatorDisable(DevHandle handle)禁用Regulator
int32_t RegulatorForceDisable(DevHandle handle)强制禁用Regulator
int32_t RegulatorSetVoltage(DevHandle handle, uint32_t minUv, uint32_t maxUv)设置Regulator输出电压
int32_t RegulatorGetVoltage(DevHandle handle, uint32_t *voltage)获取Regulator输出电压
int32_t RegulatorSetCurrent(DevHandle handle, uint32_t minUa, uint32_t maxUa)设置Regulator输出电流
int32_t RegulatorGetCurrent(DevHandle handle, uint32_t *regCurrent)获取Regulator输出电流
int32_t RegulatorGetStatus(DevHandle handle, uint32_t *status)获取Regulator状态

开发步骤

使用Regulator设备的一般流程如图2所示。

图 2 Regulator设备使用流程图

Regulator设备使用流程图

获取Regulator设备句柄

在操作Regulator设备时，首先要调用RegulatorOpen获取Regulator设备句柄，该函数会返回指定设备名称的Regulator设备句柄。

DevHandle RegulatorOpen(const char *name);

表 2 RegulatorOpen参数和返回值描述

参数参数描述
name字符指针，Regulator设备名称
返回值返回值描述
handle获取成功返回Regulator设备句柄
NULL获取失败
// Regulator设备名称
const char *name = "regulator_virtual_1";
DevHandle handle = NULL;

// 获取Regulator设备句柄
handle = RegulatorOpen(name);
if (handle == NULL) {
    // 错误处理
    HDF_LOGE("RegulatorOpen: open regulator fail.\n");
    return HDF_FAILURE;
}
销毁Regulator设备句柄

关闭Regulator设备，系统释放对应的资源。

void RegulatorClose(DevHandle handle);

表 3 RegulatorClose参数描述

参数参数描述
handleDevHandle类型，Regulator设备句柄
// 销毁Regulator设备句柄
RegulatorClose(handle);
使能

启用Regulator设备。

int32_t RegulatorEnable(DevHandle handle);

表 4 RegulatorEnable参数描述

参数参数描述
handleDevHandle类型，Regulator设备句柄
返回值返回值描述
HDF_SUCCESS使能Regulator设备成功
负数使能Regulator设备失败
int32_t ret;

// 启用Regulator设备
ret = RegulatorEnable(handle);
if (ret != HDF_SUCCESS) {
	// 错误处理
    HDF_LOGE("RegulatorEnable: enable regulator fail, ret:%d\n", ret);
    return ret;
}
禁用

禁用Regulator设备。如果Regulator设备状态为常开，或存在Regulator设备子节点未禁用，则禁用失败。

int32_t RegulatorDisable(DevHandle handle);

表 5 RegulatorDisable参数描述

参数参数描述
handleDevHandle类型，Regulator设备句柄
返回值返回值描述
HDF_SUCCESS禁用Regulator设备成功
负数禁用Regulator设备失败
int32_t ret;

// 禁用Regulator设备
ret = RegulatorDisable(handle);
if (ret != HDF_SUCCESS) {
	// 错误处理
    HDF_LOGE("RegulatorDisable: disable regulator fail, ret:%d\n", ret);
    return ret;
}
强制禁用

强制禁用Regulator设备。无论Regulator设备的状态是常开还是子节点已使能，Regulator设备都会被禁用。

int32_t RegulatorForceDisable(DevHandle handle);

表 6 RegulatorForceDisable参数描述

参数参数描述
handleDevHandle类型，Regulator设备句柄
返回值返回值描述
HDF_SUCCESS强制禁用Regulator设备成功
负数强制禁用Regulator设备失败
int32_t ret;

// 强制禁用Regulator设备
ret = RegulatorForceDisable(handle);
if (ret != HDF_SUCCESS) {
	// 错误处理
    HDF_LOGE("RegulatorForceDisable: force disable regulator fail, ret:%d\n", ret);
    return ret;
}
设置Regulator输出电压范围
int32_t RegulatorSetVoltage(DevHandle handle, uint32_t minUv, uint32_t maxUv);

表 7 RegulatorSetVoltage参数描述

参数参数描述
handleDevHandle类型，Regulator设备句柄
minUvuint32_t类型，最小电压
maxUvuint32_t类型，最大电压
返回值返回值描述
HDF_SUCCESS设置Regulator输出电压范围成功
负数设置Regulator输出电压范围失败
int32_t ret;
int32_t minUv = 0;        // 最小电压为0µV
int32_t maxUv = 20000;    // 最大电压为20000µV

// 设置Regulator电压输出电压范围
ret = RegulatorSetVoltage(handle, minUv, maxUv);
if (ret != HDF_SUCCESS) {
	// 错误处理
    HDF_LOGE("RegulatorSetVoltage: regulator set Voltage fail, ret:%d\n", ret);
    return ret;
}
获取Regulator电压
int32_t RegulatorGetVoltage(DevHandle handle, uint32_t *voltage);

表 8 RegulatorGetVoltage参数描述

参数参数描述
handleDevHandle类型，Regulator设备句柄
voltageuint32_t类型指针，待获取的Regulator电压
返回值返回值描述
HDF_SUCCESS获取Regulator电压成功
负数获取Regulator电压失败
int32_t ret;
uint32_t voltage;

// 获取Regulator电压
ret = RegulatorGetVoltage(handle, &voltage);
if (ret != HDF_SUCCESS) {
	// 错误处理
    HDF_LOGE("RegulatorGetVoltage: regulator get Voltage fail, ret:%d\n", ret);
    return ret;
}
设置Regulator输出电流范围
int32_t RegulatorSetCurrent(DevHandle handle, uint32_t minUa, uint32_t maxUa);

表 9 RegulatorSetCurrent参数描述

参数参数描述
handleDevHandle类型，Regulator设备句柄
minUauint32_t类型，最小电流
maxUauint32_t类型，最大电流
返回值返回值描述
HDF_SUCCESS设置Regulator输出电流范围成功
负数设置Regulator输出电流范围失败
int32_t ret;
int32_t minUa = 0;	    // 最小电流为0μA
int32_t maxUa = 200;    // 最大电流为200μA

// 设置Regulator输出电流范围
ret = RegulatorSetCurrent(handle, minUa, maxUa);
if (ret != HDF_SUCCESS) {
	// 错误处理
    HDF_LOGE("RegulatorSetCurrent: regulator set current fail, ret:%d\n", ret);
    return ret;
}
获取Regulator电流
int32_t RegulatorGetCurrent(DevHandle handle, uint32_t *regCurrent);

表 10 RegulatorGetCurrent参数描述

参数参数描述
handleDevHandle类型，Regulator设备句柄
regCurrentuint32_t类型指针，待获取的Regulator电流
返回值返回值描述
HDF_SUCCESS获取成功
负数获取失败
int32_t ret;
uint32_t regCurrent;

// 获取Regulator电流
ret = RegulatorGetCurrent(handle, &regCurrent);
if (ret != HDF_SUCCESS) {
	// 错误处理
    HDF_LOGE("RegulatorGetCurrent: regulator get current fail, ret:%d\n", ret);
    return ret;
}
获取Regulator状态
int32_t RegulatorGetStatus(DevHandle handle, uint32_t *status);

表 11 RegulatorGetStatus参数描述

参数参数描述
handleDevHandle类型，Regulator设备句柄
statusuint32_t类型指针，待获取Regulator状态
返回值返回值描述
HDF_SUCCESS获取成功
负数获取失败
int32_t ret;
uint32_t status;

// 获取Regulator状态
ret = RegulatorGetStatus(handle, &status);
if (ret != HDF_SUCCESS) {
	// 错误处理
    HDF_LOGE("RegulatorGetStatus: regulator get status fail, ret:%d\n", ret);
    return ret;
}

使用实例

本例拟对Hi3516DV300开发板上Regulator设备进行简单的读取操作。

Regulator设备完整的使用示例如下所示，首先获取Regulator设备句柄，然后使能，设置电压，获取电压、状态，禁用，最后销毁Regulator设备句柄。

void RegulatorTestSample(void)
{
    int32_t ret;
     
    /* Regulator设备名称 */
	const char *name = "regulator_virtual_1";
	DevHandle handle = NULL;

	/* 获取Regulator设备句柄 */
	handle = RegulatorOpen(name);
	if (handle  == NULL) {
    	HDF_LOGE("RegulatorOpen: failed!\n");
        return;
	}

	/* 启用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

	/* 设置Regulator输出电压范围 */
	ret = RegulatorSetVoltage(handle, minUv, maxUv);
	if (ret != 0) {
		HDF_LOGE("RegulatorSetVoltage: failed, ret %d\n", ret);
        goto _ERR;
	}
    
    uint32_t voltage;

    /* 获取Regulator电压 */
    ret = RegulatorGetVoltage(handle, &voltage);
    if (ret != 0) {
        HDF_LOGE("RegulatorGetVoltage: failed, ret %d\n", ret);
        goto _ERR;
    }
    
    uint32_t status;

    /* 获取Regulator状态 */
    ret = RegulatorGetStatus(handle, &status);
    if (ret != 0) {
        HDF_LOGE("RegulatorGetStatus: failed, ret %d\n", ret);
        goto _ERR;
    }

   /* 禁用Regulator设备 */
    ret = RegulatorDisable(handle);
    if (ret != 0) {
        HDF_LOGE("RegulatorDisable: failed, ret %d\n", ret);
        goto _ERR;
    }
    
_ERR:
    /* 销毁Regulator设备句柄 */
    RegulatorClose(handle); 
}

最后

有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（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学习资料

总结

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

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

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈，一经查实，立即删除！

相关文章

LC 515.在每个树行中找最大值

LC 515.在每个树行中找最大值

515. 在每个树行中找最大值 给定一棵二叉树的根节点 root ，请找出该二叉树中每一层的最大值。 示例1： 输入: root [1,3,2,5,3,null,9] 输出: [1,3,9] 示例2： 输入: root [1,2,3] 输出: [1,3] 提示： 二叉树的节点个数的范围是…
阅读更多...
ubuntu下NTFS分区无法访问挂载-解决办法！

ubuntu下NTFS分区无法访问挂载-解决办法！

Ubuntu系统下，有的时候发现，挂载的NTFS文件系统硬盘无法访问。点击弹出类似问题： Error mounting /dev/sda1 at /media/root/新加卷: Command-line mount -t "ntfs" -o "uhelperudisks2,nodev,nosuid,uid0,gid0" "/…
阅读更多...
LeetCode-416. 分割等和子集【数组 动态规划】

LeetCode-416. 分割等和子集【数组 动态规划】

LeetCode-416. 分割等和子集【数组 动态规划】 题目描述：解题思路一：01背包问题，动规五部曲解题思路二：0解题思路三：0 题目描述： 给你一个 只包含正整数 的 非空 数组 nums 。请你判断是否可以将这个数组分…
阅读更多...
云计算：OVS 集群 使用 Geneve 流表

云计算：OVS 集群 使用 Geneve 流表

目录 一、实验 1.环境 2.OVS 集群 使用 Geneve 流表 二、问题 1.VXLAN与Geneve区别 一、实验 1.环境 (1) 主机 表1 宿主机 主机架构软件IP网卡备注ovs_controller控制端 karaf 0.7.3 192.168.204.63 1个NAT网卡 （204网段） 已部署ovs_server01服务…
阅读更多...
【无标题】nodejs+mogoodb数据库写注册接口

【无标题】nodejs+mogoodb数据库写注册接口

描述 本篇文章主要记录使用nodejs express搭建服务器，并链接mogoodb数据来书写简单的后台接口；前端项目使用的vue2的一个酒店管理项目。阅读本文章，可以了解如何连接mogoodb数据库，和一些对数据库进行操作的命令。前端如何进行跨…
阅读更多...
2024年Mathorcup数学建模竞赛A题思路

2024年Mathorcup数学建模竞赛A题思路

可以关注下，代码已出 【金山文档 | WPS云文档】 2024年Mathorcup思路代码在线文档https://link.zhihu.com/?targethttps%3A//kdocs.cn/l/cdlol5FlRAdE 整体来说这个题就两个步骤，第一是训练一个响应面模型，输入是附表1邻区的PCI值&#xff0…
阅读更多...
裸机开发之汇编、寄存器

裸机开发之汇编、寄存器

一、什么是汇编？为什么学汇编？ 在之前写控制代码的时候就在想：底层是怎么控制的？后来经过学习知道之前所编写的代码都是应用层代码，顾名思义就是在系统写好的底层之上调用系统函数。原以为底层是指写系统写好的底层函数…
阅读更多...
gitlab使用

gitlab使用

个人笔记（整理不易，有帮助，收藏点赞评论，爱你们！！！你的支持是我写作的动力） 笔记目录：学习笔记目录_pytest和unittest、airtest_weixin_42717928的博客-CSDN博客 个人随笔…
阅读更多...
在线客服业务架构：构建智能互动与个性化服务

在线客服业务架构：构建智能互动与个性化服务

随着数字化时代的到来，在线客服业务正成为企业与客户沟通互动的重要渠道。在这个快节奏的时代，如何构建一个高效、智能的在线客服业务架构成为了企业关注的焦点。本文将探讨在线客服业务架构的重要性，并介绍如何构建智能互动与个性化服务的在…
阅读更多...
自建远程桌面服务器，控制免root安卓手机和pc

自建远程桌面服务器，控制免root安卓手机和pc

RustDesk是一个开源的远程桌面软件，它允许用户通过互联网在不同设备之间共享桌面和控制权限。这款软件以最少的配置提供了自托管和安全保障，是一个类似于TeamViewer的开源替代品​ (RustDesk)​。RustDesk支持在Windows、macOS、Linux、iOS、Android以及…
阅读更多...
图片合成二维码怎么实现？图片二维码的生成技巧

图片合成二维码怎么实现？图片二维码的生成技巧

图片合成二维码如何制作呢？现在很多的二维码都会提供图片预览的功能，我们可以用手机扫描二维码来查看图片的信息，比如很多的产品信息、旅游攻略、产品海报等等类型经常会制作这种类型的二维码。 其实图片制作二维码的方法很简单，…
阅读更多...
MobX进阶:从基础到高级特性全面探索

MobX进阶:从基础到高级特性全面探索

MobX 提供了丰富的高级特性,包括计算属性、反应式视图、中间件、异步流程控制、依赖注入和动态 observable 、在服务端渲染和 TypeScript 支持方面提供了良好的集成。这些特性进一步增强了 MobX 在状态管理方面的灵活性和可扩展性,使其成为一个功能强大、易于使用的状态管理解决…
阅读更多...
用CRMEB多店版，看品牌连锁店如何做电商

用CRMEB多店版，看品牌连锁店如何做电商

2023年，被很多人认为是充满希望的一年，受社会环境影响消沉三年的实体商业仿佛看到了希望，都准备在今年大展身手。再看市场，经过3年的发展，很多线下实体店铺的线上商业布局已经小有成效，线下连锁品牌店线上化…
阅读更多...
服务器配置环境步骤

服务器配置环境步骤

1、创建虚拟环境 conda create --name 名字 pythonpython版本号2、进入虚拟环境 conda activate 名字3、确认自己要安装的torch版本和torchvision版本，进入https://pytorch.org/get-started/previous-versions/ 复制相应的命令，运行即可 注&#xff1a…
阅读更多...
MVCC（解决MySql中的并发事务的隔离性）

MVCC（解决MySql中的并发事务的隔离性）

MVCC 如何保证事务的隔离性？ 1.排他锁：如一个事务获取了一个数据行的排他锁，其他事务就不能再获取改行的其他锁。 2.MVCC：多版本并发控制。 MVCC： 1.隐藏字段 1.DB_TRX_ID：最近修改事务的id。默认值从0开…
阅读更多...
React添加到现有项目

React添加到现有项目

1.检查现有项目的根目录下是否有package.json文件 如果没有，则在项目的根目录下初始化一个package.json配置文件 2.在根目录下安装react和react-dom依赖 npm install --save react react-dom react-scripts安装成功后，react、react-dom以及react-scr…
阅读更多...
RPA实战演练UiBot6.0新食堂一楼问卷星（类似于之前的网页表单提交）

RPA实战演练UiBot6.0新食堂一楼问卷星（类似于之前的网页表单提交）

要使用RPA（Robotic Process Automation，机器人流程自动化）帮助新食堂进行调查问卷，我们可以结合UiBot 6.0来实施具体的计划。以下是一个大致的实战演练计划： 一、目标与需求分析 明确调查目标：了解新食堂…
阅读更多...
小间距LED显示屏拼接器的技术详解

小间距LED显示屏拼接器的技术详解

随着科技的不断进步，小间距LED显示屏因其无缝拼接、高清晰度和卓越的显示效果，在众多高端应用场合成为首选。然而，要充分发挥这些优势，不仅需要LED显示屏本身的高质量图像处理和精湛的组装工艺，还需要一个强大的图像拼…
阅读更多...
Java 语言程序设计（基础篇）原书第10版 梁勇著 PDF 文字版电子书

Java 语言程序设计（基础篇）原书第10版 梁勇著 PDF 文字版电子书

简介 Java 语言程序设计（基础篇）原书第 10 版 是 Java 语言的经典教材，中文版分为基础篇和进阶篇，主要介绍程序设计基础、面向对象程序设计、GUI 程序设计、数据结构和算法、高级 Java 程序设计等内容。本书通过示例讲解问题求解…
阅读更多...
【python】图像边缘提取效果增强方法-高斯模糊

【python】图像边缘提取效果增强方法-高斯模糊

一、介绍 高斯模糊是一种常用的图像处理技术，用于减少图像中的噪声和细节。它通过对图像中的每个像素点进行加权平均来实现模糊效果。具体而言，高斯模糊使用一个高斯核函数作为权重，对每个像素点周围的邻域进行加权平均。这样可以使得每个像…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023