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

代码与思维2024-04-13 19:25

功能简介

PWM即脉冲宽度调制（Pulse Width Modulation）的缩写，是一种对模拟信号电平进行数字编码并将其转换为脉冲的技术。

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

  • PWM设备句柄获取和释放

  • PWM周期、占空比、极性的设置

  • PWM使能和关闭

  • PWM配置信息的获取和设置

基本概念

脉冲是"电脉冲"的简称，指电路中电流或电压短暂起伏的现象，其特点是突变和不连续性。脉冲的种类很多，常见的脉冲波形有：三角脉冲、尖脉冲、矩形脉冲、方形脉冲、梯形脉冲及阶梯脉冲等。脉冲的主要参数包括重复周期T（T=1/F，F为重复频率）、脉冲幅度U、脉冲前沿上升时间ts、后沿下降时间t、脉冲宽度tk等。

运作机制

在HDF框架中，PWM接口适配模式采用独立服务模式（如图1所示）。在这种模式下，每一个设备对象会独立发布一个设备服务来处理外部访问，设备管理器收到API的访问请求之后，通过提取该请求的参数，达到调用实际设备对象的相应内部方法的目的。独立服务模式可以直接借助HDF设备管理器的服务管理能力，但需要为每个设备单独配置设备节点，增加内存占用。

独立服务模式下，核心层不会统一发布一个服务供上层使用，因此这种模式下驱动要为每个控制器发布一个服务，具体表现为：

  • 驱动适配者需要实现HdfDriverEntry的Bind钩子函数以绑定服务。

  • device_info.hcs文件中deviceNode的policy字段为1或2，不能为0。

PWM模块各分层作用：

  • 接口层提供打开PWM设备、设置PWM设备周期、设置PWM设备占空时间、设置PWM设备极性、设置PWM设备参数、获取PWM设备参数、使能PWM设备、禁止PWM设备、关闭PWM设备的接口。

  • 核心层主要提供PWM控制器的添加、移除以及管理的能力，通过钩子函数与适配层交互。

  • 适配层主要是将钩子函数的功能实例化，实现具体的功能。

图 1 PWM独立服务模式结构图

使用指导

场景介绍

通常情况下，在使用马达控制、背光亮度调节时会用到PWM模块。

接口说明

PWM模块设备属性如表1所示，PWM模块提供的主要接口如表2所示，具体API详见//drivers/hdf_core/framework/include/platform/pwm_if.h。

表 1 PwmConfig结构体介绍

名称 描述
duty uint32_t类型，占空时间，以纳秒为单位。
period uint32_t类型，PWM周期，以纳秒为单位。
number uint32_t类型，要生成的方波数： - 正值：表示将生成指定数量的方波 - 0：表示方波将不断产生
polarity uint8_t类型，极性：正极性/反极性。
status uint8_t类型，状态：启用状态/禁用状态。

表 2 PWM驱动API接口功能介绍

接口名 接口描述
DevHandle PwmOpen(uint32_t num) 打开PWM设备
void PwmClose(DevHandle handle) 关闭PWM设备
int32_t PwmSetPeriod(DevHandle handle, uint32_t period) 设置PWM设备周期
int32_t PwmSetDuty(DevHandle handle, uint32_t duty) 设置PWM设备占空时间
int32_t PwmSetPolarity(DevHandle handle, uint8_t polarity) 设置PWM设备极性
int32_t PwmEnable(DevHandle handle) 使能PWM设备
int32_t PwmDisable(DevHandle handle) 禁用PWM设备
int32_t PwmSetConfig(DevHandle handle, struct PwmConfig *config) 设置PWM设备参数
int32_t PwmGetConfig(DevHandle handle, struct PwmConfig *config) 获取PWM设备参数

说明：

本文涉及PWM的所有接口，支持内核态及用户态使用。

开发步骤

使用PWM的一般流程如下图所示。

图 2 PWM使用流程图

获取PWM设备句柄

在操作PWM设备时，首先要调用PwmOpen获取PWM设备句柄，该函数会返回指定设备号的PWM设备句柄。

DevHandle PwmOpen(uint32_t num);

表 3 PwmOpen参数和返回值描述

参数 参数描述
num uint32_t类型，PWM设备号
返回值 返回值描述
handle 打开PWM设备成功，返回PWM设备句柄
NULL 打开PWM设备失败

假设系统中的PWM设备号为0，获取该PWM设备句柄的示例如下：

uint32_t num = 0;         // PWM设备号
DevHandle handle = NULL;

handle = PwmOpen(num);    // 打开PWM 0设备并获取PWM设备句柄
if (handle == NULL) {
    HDF_LOGE("PwmOpen: open pwm_%u failed.\n", num);
    return HDF_FAILURE;
}
销毁PWM设备句柄

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

void PwmClose(DevHandle handle);

表 4 PwmClose参数描述

参数 参数描述
handle DevHandle类型，PWM设备句柄 
PwmClose(handle);    // 关闭PWM设备销毁PWM设备句柄
使能PWM设备
int32_t PwmEnable(DevHandle handle);

表 5 PwmEnable参数和返回值描述

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

ret = PwmEnable(handle);    // 启用PWM设备
if (ret != HDF_SUCCESS) {
    HDF_LOGE("PwmEnable: enable pwm failed, ret:%d\n", ret);
    return ret;
}
禁用PWM设备
int32_t PwmDisable(DevHandle handle);

表 6 PwmDisable参数和返回值描述

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

ret = PwmDisable(handle);    // 禁用PWM设备
if (ret != HDF_SUCCESS) {
    HDF_LOGE("PwmDisable: disable pwm failed, ret:%d\n", ret);
    return ret;
}
设置PWM设备周期
int32_t PwmSetPeriod(DevHandle handle, uint32_t period);

表 7 PwmSetPeriod参数和返回值描述

参数 参数描述
handle DevHandle类型，PWM设备句柄
period uint32_t类型，要设置的周期，单位为纳秒
返回值 返回值描述
HDF_SUCCESS 设置PWM设备周期成功
负数 设置PWM设备周期失败 
int32_t ret;

ret = PwmSetPeriod(handle, 50000000);    // 设置周期为50000000纳秒
if (ret != HDF_SUCCESS) {
    HDF_LOGE("PwmSetPeriod: pwm set period failed, ret:%d\n", ret);
    return ret;
}
设置PWM设备占空时间
int32_t PwmSetDuty(DevHandle handle, uint32_t duty);

表 8 PwmSetDuty参数和返回值描述

参数 参数描述
handle DevHandle类型，PWM设备句柄
duty uint32_t类型，要设置的占空时间，单位为纳秒
返回值 返回值描述
HDF_SUCCESS 设置PWM设备占空时间成功
负数 设置PWM设备占空时间失败 
int32_t ret;

ret = PwmSetDuty(handle, 25000000);    // 设置占空时间为25000000纳秒
if (ret != HDF_SUCCESS) {
    HDF_LOGE("PwmSetDuty: pwm set duty failed, ret:%d\n", ret);
    return ret;
}
设置PWM设备极性
int32_t PwmSetPolarity(DevHandle handle, uint8_t polarity);

表 9 PwmSetPolarity参数和返回值描述

参数 参数描述
handle DevHandle类型，PWM设备句柄
polarity uint8_t类型，要设置的极性，正/反
返回值 返回值描述
HDF_SUCCESS 设置PWM设备极性成功
负数 设置PWM设备极性失败 
int32_t ret;

ret = PwmSetPolarity(handle, PWM_INVERTED_POLARITY);    // 设置极性为反
if (ret != HDF_SUCCESS) {
    HDF_LOGE("PwmSetPolarity: pwm set polarity failed, ret:%d\n", ret);
    return ret;
}
设置PWM设备参数
int32_t PwmSetConfig(DevHandle handle, struct PwmConfig *config);

表 10 PwmSetConfig参数和返回值描述

参数 参数描述
handle DevHandle类型，PWM设备句柄
config 结构体指针类型，配置参数
返回值 返回值描述
HDF_SUCCESS 设置PWM设备参数成功
负数 设置PWM设备参数失败 
int32_t ret;
struct PwmConfig pcfg;

pcfg.duty = 25000000;                     // 占空时间为25000000纳秒
pcfg.period = 50000000;                   // 周期为50000000纳秒
pcfg.number = 0;                          // 不断产生方波
pcfg.polarity = PWM_INVERTED_POLARITY;    // 极性为反
pcfg.status = PWM_ENABLE_STATUS;          // 运行状态为启用

ret = PwmSetConfig(handle, &pcfg);        // 设置PWM设备参数
if (ret != HDF_SUCCESS) {
    HDF_LOGE("PwmSetConfig: pwm set config failed, ret:%d\n", ret);
    return ret;
}
获取PWM设备参数
int32_t PwmGetConfig(DevHandle handle, struct PwmConfig *config);

表 11 PwmGetConfig参数和返回值描述

参数 参数描述
handle DevHandle类型，PWM设备句柄
config 结构体指针类型，配置参数
返回值 返回值描述
HDF_SUCCESS 获取PWM设备参数成功
负数 获取PWM设备参数失败 
int32_t ret;
struct PwmConfig pcfg;

ret = PwmGetConfig(handle, &pcfg);    // 获取PWM设备参数
if (ret != HDF_SUCCESS) {
    HDF_LOGE("PwmGetConfig: pwm get config failed, ret:%d\n", ret);
    return ret;
}

使用实例

下面将基于Hi3516DV300开发板展示使用PWM完整操作，步骤主要如下：

  1. 传入PWM设备号，打开PWM设备并获得PWM设备句柄。

  2. 通过PWM设备句柄及待设置的周期，设置PWM设备周期。

  3. 通过PWM设备句柄及待设置的占空时间，设置PWM设备占空时间。

  4. 通过PWM设备句柄及待设置的极性，设置PWM设备极性。

  5. 通过PWM设备句柄及待获取的设备参数，获取PWM设备参数。

  6. 通过PWM设备句柄，使能PWM设备。

  7. 通过PWM设备句柄及待设置的设备参数，设置PWM设备参数。

  8. 通过PWM设备句柄，禁用PWM设备。

  9. 通过PWM设备句柄，关闭PWM设备。

    #include "pwm_if.h" // pwm标准接口头文件
    #include "hdf_log.h" // 标准日志打印头文件

    static int32_t PwmTestSample(void)
    {
    int32_t ret;
    uint32_t num;
    uint32_t period;
    uint32_t duty;
    DevHandle handle = NULL;

     struct PwmConfig pcfg;
 pcfg.duty = 20000000;                                         // 占空时间为20000000纳秒                 
 pcfg.period = 40000000;                                       // 周期为40000000纳秒
 pcfg.number = 100;                                            // 生成100个方波
 pcfg.polarity = PWM_NORMAL_POLARITY;                          // 极性为正
 pcfg.status = PWM_ENABLE_STATUS;                              // 运行状态为启用

 num = 1;                                                      // PWM设备编号，要填写实际平台上的编号

 handle = PwmOpen(num);                                        // 获取PWM设备句柄
 if (handle == NULL) {
     HDF_LOGE("PwmTestSample: open pwm_%u fail!\n", num);
     return HDF_FAILURE;
 }

 period = 50000000;                                            // 设置周期为50000000纳秒
 ret = PwmSetPeriod(handle, period);
 if (ret != HDF_SUCCESS) {
     HDF_LOGE("PwmTestSample: pwm set period fail, ret:%d\n", ret);
     goto ERR;
 }

 duty = 25000000;                                              // 设置占空时间为25000000纳秒
 ret = PwmSetDuty(handle, duty);
 if (ret != HDF_SUCCESS) {
     HDF_LOGE("PwmTestSample: pwm set duty fail, ret:%d\n", ret);
     goto ERR;
 }

 ret = PwmSetPolarity(handle, PWM_INVERTED_POLARITY);          // 设置极性为反
 if (ret != HDF_SUCCESS) {
     HDF_LOGE("PwmTestSample: pwm set polarity fail, ret:%d\n", ret);
     goto ERR;
 }

 ret = PwmGetConfig(handle, &pcfg);                            // 获取PWM设备参数
 if (ret != HDF_SUCCESS) {
     HDF_LOGE("PwmTestSample: get pwm config fail, ret:%d\n", ret);
     goto ERR;
 }

 ret = PwmEnable(handle);                                      // 启用PWM设备
 if (ret != HDF_SUCCESS) {
     HDF_LOGE("PwmEnable: enable pwm fail, ret:%d\n", ret);
     goto ERR;
 }

 ret = PwmSetConfig(handle, &pcfg);                            // 设置PWM设备参数
 if (ret != HDF_SUCCESS) {
     HDF_LOGE("PwmTestSample: set pwm config fail, ret:%d\n", ret);
     goto ERR;
 }

 ret = PwmDisable(handle);                                     // 禁用PWM设备
 if (ret != HDF_SUCCESS) {
     HDF_LOGE("PwmTestSample: disable pwm fail, ret:%d\n", ret);
     goto ERR;
 }

 HDF_LOGD("PwmTestSample: all tests end.");

    ERR:
    PwmClose(handle); // 销毁PWM设备句柄
    return ret;
    }

最后

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

总结

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

相关推荐
一个处女座的程序猿O(∩_∩)O32 分钟前
开源鸿蒙 5.0 正式版发布
华为·harmonyos
程序猿会指北1 小时前
【鸿蒙（HarmonyOS）性能优化指南】内存分析器Allocation Profiler
性能优化·移动开发·harmonyos·openharmony·arkui·组件化·鸿蒙开发
丘狸尾1 小时前
[cisco 模拟器] ftp服务器配置
android·运维·服务器
van叶～3 小时前
探索未来编程：仓颉语言的优雅设计与无限可能
android·java·数据库·仓颉
程序猿会指北4 小时前
【鸿蒙（HarmonyOS）性能优化指南】启动分析工具Launch Profiler
c++·性能优化·harmonyos·openharmony·arkui·启动优化·鸿蒙开发
鸿蒙程序媛4 小时前
2024最新鸿蒙开发面试题合集-HarmonyOS NEXT Release（API 12 Release）
harmonyos·harmonyos面试题
轻口味5 小时前
【每日学点鸿蒙知识】DevEco、HDC报错、C调用数据库、测试工具、codegen
数据库·华为·harmonyos
Crossoads7 小时前
【汇编语言】端口 —— 「从端口到时间：一文了解CMOS RAM与汇编指令的交汇」
android·java·汇编·深度学习·网络协议·机器学习·汇编语言
li_liuliu8 小时前
Android4.4 在系统中添加自己的System Service
android
C4rpeDime10 小时前
自建MD5解密平台-续
android
热门推荐
01【一文读懂】NTN（非地面网络）技术介绍02优化手机性能，解决卡顿问题：关闭这3个微信开关，释放内存空间03玄机平台应急响应—webshell查杀04Cube-Studio：开源大模型全链路一站式中台05基于大语言模型（LLM）的合成数据生成、策展和评估的综述06(欧拉)openEuler系统添加网卡文件配置流程、(欧拉)openEuler系统手动配置ipv6地址流程、(欧拉)openEuler系统网络管理说明07组基轨迹建模 GBTM的介绍与实现（Stata 或 R）08HCIA-datacom数通题库和录播视频资料09Docker 夺命连环 15 问10RAG 实践- Ollama+RagFlow 部署本地知识库