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.rhkb.cn/news/306815.html

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

相关文章

OpenAI现已普遍提供带有视觉应用程序接口的GPT-4 Turbo

OpenAI宣布,其功能强大的GPT-4 Turbo with Vision模型现已通过公司的API全面推出,为企业和开发人员将高级语言和视觉功能集成到其应用程序中开辟了新的机会。 PS:使用Wildcard享受不受网络限制的API调用,详情查看教程 继去年 9 月…

java Web 中小企业门户网站用eclipse定制开发mysql数据库BS模式java编程jdbc

一、源码特点 JSP 中小企业门户网站是一套完善的web设计系统,对理解JSP java 编程开发语言有帮助,系统具有完整的源代码和数据库,系统主要采用B/S模式开发。开发环境为TOMCAT7.0,eclipse开发,数据库为Mysql5.0,使…

jenkins+sonar配置

安装插件 Sonar Scanner 用于扫描项目 配置sonar scanner jenkins集成sonar 1、sonar生成token 生成完保存好,刷新后无法查看 2、jenkins配置全局凭据 3、jenkins配置系统设置

Spring Boot集成Graphql快速入门Demo

1.Graphql介绍 GraphQL 是一个用于 API 的查询语言,是一个使用基于类型系统来执行查询的服务端运行时(类型系统由你的数据定义)。GraphQL 并没有和任何特定数据库或者存储引擎绑定,而是依靠你现有的代码和数据支撑。 优势 GraphQL…

蓝桥杯嵌入式(G431)备赛笔记——RTC

// RTC time// 声明一个变量 rtc_tick 用于记录上次 RTC 处理的时间 u32 rtc_tick 0;// 声明结构体变量 D 用于存储 RTC 的日期信息 RTC_DateTypeDef D;// 声明结构体变量 T 用于存储 RTC 的时间信息 RTC_TimeTypeDef T;// RTC_proc 函数,用于处理 RTC 时间 void R…

uniapp 开发小程序如何检测到更新点击重启小程序完成更新?

官方文档:uni.getUpdateManager() | uni-app官网 示例代码: const updateManager uni.getUpdateManager();updateManager.onCheckForUpdate(function (res) {// 请求完新版本信息的回调console.log(res.hasUpdate); });updateManager.onUpdateReady(fu…

一、flask入门和视图

run启动参数 模板渲染 后端给前端页面传参 前端页面设置css from flask import Flask, render_template,jsonify# 创建flask对象 app Flask(__name__)# 视图函数 路由route app.route("/") def hello_world():# 响应,返回给前端的数据return "h…

MariaDB介绍和安装

MariaDB介绍和安装 文章目录 MariaDB介绍和安装1.MariaDB介绍2.MariaDB安装2.1 主机初始化2.1.1 设置网卡名和ip地址2.1.2 配置镜像源2.1.3 关闭防火墙2.1.4 禁用SELinux2.1.5 设置时区 2.2 包安装2.2.1 Rocky和CentOS 安装 MariaDB2.2.2 Ubuntu 安装 MariaDB 2.3 源码安装2.3.…

数据结构:线性表————单链表专题

🌈个人主页:小新_- 🎈个人座右铭:“成功者不是从不失败的人,而是从不放弃的人!”🎈 🎁欢迎各位→点赞👍 收藏⭐️ 留言📝 🏆所属专栏&#xff1…

类和对象二

一、运算符重载 为了使自定义类型可以使用加减等运算符,CPP提供了一个功能叫运算符重载。 关键字:operator操作符 运算符重载最好定义在类对象里,这也可以避免访问不到私有成员的问题。 代码演示: 在类里定义之后,…

java包目录命名

包目录命名 config controller exception model common entity enums reponse request repository security service util

大数据之ClickHouse

大数据之ClickHouse 简介 ClickHouse是一种列式数据库管理系统,专门用于高性能数据分析和数据仓库应用。它是一个开源的数据库系统,最初由俄罗斯搜索引擎公司Yandex开发,用于满足大规模数据分析和报告的需求。 特点 开源的列式存储数据库…

2024年mathorcup(妈妈杯)数学建模C题思路-物流网络分拣中心货量预测及人员排班

# 1 赛题 C 题 物流网络分拣中心货量预测及人员排班 电商物流网络在订单履约中由多个环节组成,图 ’ 是一个简化的物流 网络示意图。其中,分拣中心作为网络的中间环节,需要将包裹按照不同 流向进行分拣并发往下一个场地,最终使包裹…

外观模式:简化复杂系统的统一接口

在面向对象的软件开发中,外观模式是一种常用的结构型设计模式,旨在为复杂的系统提供一个简化的接口。通过创建一个统一的高级接口,这个模式帮助客户端通过一个简单的方式与复杂的子系统交互。本文将详细介绍外观模式的定义、实现、应用场景以…

云原生(八)、Kubernetes基础(一)

K8S 基础 # 获取登录令牌 kubectl create token admin --namespace kubernetes-dashboard1、 NameSpace Kubernetes 启动时会创建四个初始名字空间 default:Kubernetes 包含这个名字空间,以便于你无需创建新的名字空间即可开始使用新集群。 kube-node-lease: 该…

PostgreSQL15 + PostGis + QGIS安装教程

目录 下载1、PostgreSQL安装1.1、环境变量配置 2、PostGIS安装2.1、安装插件 3、QGIS下载3.1、安装3.2、测试 下载 PostgreSQL15安装:下载地址 PostGIS安装:下载地址(倒数第二个) 1、PostgreSQL安装 下载安装包之后一直点下一步…

Python 全栈系列239 使用消息队列完成分布式任务

说明 在Python - 深度学习系列32 - glm2接口部署实践提到,通过部署本地化大模型来完成特定的任务。 由于大模型的部署依赖显卡,且常规量级的任务需要大量的worker支持,从成本考虑,租用算力机是比较经济的。由于任务是属于超高计…

AR地图导览小程序是怎么开发出来的?

在移动互联网时代,AR技术的发展为地图导览提供了全新的可能性。AR地图导览小程序结合了虚拟现实技术和地图导航功能,为用户提供了更加沉浸式、直观的导览体验。本文将从专业性和思考深度两个方面,探讨AR地图导览小程序的开发方案。 编辑搜图 …

【大语言模型】基础:如何处理文章,向量化与BoW

词袋模型(BoW)是自然语言处理(NLP)和机器学习中一种简单而广泛使用的文本表示方法。它将文本文档转换为数值特征向量,使得可以对文本数据执行数学和统计操作。词袋模型将文本视为无序的单词集合(或“袋”&a…

给现有rabbitmq集群添加rabbitmq节点

现有的:10.2.59.216 rabbit-node1 10.2.59.217 rabbit-node2 新增 10.2.59.199 rabbit-node3 1、分别到官网下载erlang、rabbitmq安装包,我得版本跟现有集群保持一致。 erlang安装包:otp_src_22.0.tar.gz rabbitmq安装包&#xff1…