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

功能简介

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µVint32_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.mzph.cn/news/811967.shtml

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

相关文章

Excel/WPS超级处理器,提取汉字/字母/数字

在职场工作中,经常会遇到单元格中有汉字,数字,字母三者的自由组合,但往往只需要其中的一者,如何快速提取呢,超级处理器,提供了4个功能可选。 超级处理器下载与安装 1)分离字符 将…

平板设备IP地址设置指南

在数字化时代,平板电脑作为便携且功能强大的设备,广泛应用于日常生活和工作中。为了确保平板能够正常接入网络并与其他设备进行通信,正确设置IP地址是至关重要的。虎观小二将为您介绍如何设置平板的IP地址,帮助您轻松完成网络配置…

unity在linux环境下videoplayer 无法播放问题解决路径

1、问题 一个项目需要在linux下播放视频,并且视频在机器上,也就是要使用应用外的视频文件进行播放。 视频的格式当前提供的事avi格式,并且使用videoplayer 在windows下播放正常。 但是发出包之后再Ubuntu环境怎么都无法播放。 2、测试环境…

LDF、DBC、BIN、HEX、S19、BLF、ARXML、slx等

文章目录 如题 如题 LDF是LIN报文格式文件,把这个直接拖到软件里面,可以发报文和接收报文 DBC是CAN报文格式文件,把这个直接拖到软件里面,可以发报文和接收报文 BIN文件烧录在BOOT里面(stm32)&#xff0c…

开源无需授权2024最新同城上门预约家政按摩小程序+公众号H5+APP源码系统下载

2024最新同城上门预约家政按摩源码简介: 开源无需授权2024最新同城上门预约家政按摩小程序+公众号H5+APP源码系统下载,前端采用uni-app开发, 后端thinkphp框架开发。适配多端(小程序+公众号H5&…

php反序列化(2)

一.pop链 在反序列化中,我们能控制的数据就是对象中的属性值(成员变量),所以在php反序列化中有一种漏洞利用方法叫“面向属性编程”,即pop(property oriented programming)。 pop链就是利用魔…

不借助第三方工具打包QT程序

准备工作: 项目/可执行文件名:QTAppName 打包项目存放的文件名:pack(这个文件名无所谓) 脚本名: copylib.sh(类似ldd命令):用于将.so库文件的依赖项复制并放入自动生…

vscode远程免密登录ssh

vscode远程免密登录ssh 1. 安装vscode2. 安装ssh3. 本地vscode配置免密登录远端开发机1. 本地配置秘钥2. 远程开发机配置秘钥 4. vscode常用小工具1. vscode怎么设置ctrl加滚轮放大字体 1. 安装vscode 2. 安装ssh 设置符号打开config配置文件,点击符号ssh连接新的远…

4. Django 探究FBV视图

4. 探究FBV视图 视图(Views)是Django的MTV架构模式的V部分, 主要负责处理用户请求和生成相应的响应内容, 然后在页面或其他类型文档中显示. 也可以理解为视图是MVC架构里面的C部分(控制器), 主要处理功能和业务上的逻辑. 我们习惯使用视图函数处理HTTP请求, 即在视图里定义def…

A complete evaluation of the Chinese IP geolocation databases(2015年)

下载地址:A Complete Evaluation of the Chinese IP Geolocation Databases | IEEE Conference Publication | IEEE Xplore 被引用次数:12 Li H, He Y, ** R, et al. A complete evaluation of the Chinese IP geolocation databases[C]//2015 8th International Conference…

2024年MathorCup数学应用挑战赛A题思路分析

文章目录 题目简介题目背景和重要性题目要求和目标 题目分析和解题思路理解PCI规划的基本原则PCI参考算法 建立数学模型定义决策变量建立目标函数确定约束条件唯一性约束:确保每个小区的PCI在整个网络中是唯一的。 设计优化算法目标函数分析约束条件分析问题规模分析…

客户端传日期格式字段(String),服务端接口使用java.util.Date类型接收报错问题

客户端传日期格式字段(string),服务端接口使用java.util.Date类型接收报错问题 问题演示第1种:客户端以URL拼接的方式传值第2种:客户端以body中的form-data方式提交第3种 客户端以Body中的json方式提交 问题解决(全局解…

softmax回归:多分类问题的解码器

随着人工智能技术的不断发展,分类问题在机器学习领域中的地位日益凸显。在众多分类算法中,softmax回归以其独特的优势和广泛的应用场景,成为了处理多分类问题的有力工具。本文将深入探讨softmax回归的原理、应用及其优缺点,以期为…

pytorch-多分类实战之手写数字识别

目录 1. 网络设计2. 代码实现2.1 网络代码2.2 train 3. 完整代码 1. 网络设计 输入是手写数字图片28x28,输出是10个分类0~9,有两个隐藏层,如下图所示: 2. 代码实现 2.1 网络代码 第一层将784降维到200,第二次使用…

ChatGPT基础(二) ChatGPT的使用和调优

文章目录 ChatGPT的特性采用关键词进行提问给ChatGPT指定身份提升问答质量的策略1.表述方式上的优化2.用"继续"输出长内容3.营造场景4.由浅入深,提升问题质量5.预设回答框架和风格 ChatGPT的特性 1.能够联系上下文进行回答 ChatGPT回答问题是有上下文的&…

uni-app web端使用getUserMedia,摄像头拍照

<template><view><video id"video"></video></view> </template> 摄像头显示在video标签上 var opts {audio: false,video: true }navigator.mediaDevices.getUserMedia(opts).then((stream)> {video document.querySelec…

【python】在pycharm创建一个新的项目

双击打开pycharm,选择create new project 选择create,后进入项目 右键项目根目录,选择new一个新的python file 随意命名一下 输入p 然后后面就会出现智能补全提示,此时轻敲一下tab,代码就写好了,非常的方便 右键执行一下代码,下面两个直接运行和debug运行都是可以的 小结 …

CentOS 8服务器搭建L2TP服务器(over IPsec)操作指南

正文共&#xff1a;1234 字 14 图&#xff0c;预估阅读时间&#xff1a;2 分钟 之前发过把我自己的服务器搬上公网的文章&#xff08;我用100块钱把物理服务器放到了公网&#xff0c;省了几万块&#xff01;&#xff09;&#xff0c;当时L2TP拨号用的是网络上的解决方案&#x…

微服务整合Spring Cloud Gateway动态路由

前置 创建 Spring Cloud项目 参考&#xff1a;创建Spring Cloud Maven工程-CSDN博客 1. 创建一个maven jar类型项目 在idea中右键父工程-》New-》Module 创建一个maven工程 2. 引入相关依赖 在POM文件中引入下面的依赖 <project xmlns"http://maven.apache.org/P…

C++设计模式|创建型 1.单例模式

1.什么是单例模式&#xff1f; 单例模式的的核⼼思想在创建类对象的时候保证⼀个类只有⼀个实例&#xff0c;并提供⼀个全局访问点来访问这个实例。 只有⼀个实例的意思是&#xff0c;在整个应⽤程序中&#xff0c;只存在该类的⼀个实例对象&#xff0c;⽽不是创建多个相同类…