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

功能简介

PIN即管脚控制器,用于统一管理各SoC的管脚资源,对外提供管脚复用功能:包括管脚推拉方式、管脚推拉强度以及管脚功能。

PIN接口定义了操作PIN管脚的通用方法集合,包括:

  • 获取/释放管脚描述句柄:传入管脚名与链表中每个控制器下管脚名进行匹配,匹配则会获取一个管脚描述句柄,操作完PIN管脚后释放该管脚描述句柄。

  • 设置/获取管脚推拉方式:推拉方式可以是上拉、下拉以及悬空。

  • 设置/获取管脚推拉强度:用户可根据实际设置管脚推拉强度大小。

  • 设置/获取管脚功能:通过管脚功能名设置/获取管脚功能,实现管脚复用。

基本概念

PIN是一个软件层面的概念,目的是为了统一各SoC的PIN管脚管理,对外提供管脚复用功能,配置PIN管脚的电气特性。

  • SoC(System on Chip)

    系统级芯片,也有称作片上系统,通常是面向特定用途将微处理器、模拟IP核、数字IP核和存储器集成在单一芯片的标准产品。

  • 管脚复用

    由于芯片自身的引脚数量有限,无法满足日益增多的外接需求。此时可以通过软件层面的寄存器设置,让引脚工作在不同的状态,从而实现相同引脚完成不同功能的目的。

运作机制

在HDF框架中,同类型设备对象较多时(可能同时存在十几个同类型配置器),若采用独立服务模式,则需要配置更多的设备节点,且相关服务会占据更多的内存资源。相反,采用统一服务模式可以使用一个设备服务作为管理器,统一处理所有同类型对象的外部访问(这会在配置文件中有所体现),实现便捷管理和节约资源的目的。PIN模块接口适配模式采用统一服务模式。

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

PIN模块各分层作用:

  • 接口层提供获取PIN管脚、设置PIN管脚推拉方式、获取PIN管脚推拉方式、设置PIN管脚推拉强度、获取PIN管脚推拉强度、设置PIN管脚功能、获取PIN管脚功能、释放PIN管脚的接口。

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

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

图 1 PIN统一服务模式 

PIN统一服务模式

约束与限制

PIN模块目前只支持小型系统LiteOS-A内核。

使用指导

场景介绍

PIN模块仅是一个软件层面的概念,主要工作是管脚资源管理。使用复用管脚时,通过设置管脚功能、设置管脚推拉方式、设置管脚推拉强度来适配指定场景的需求。

接口说明

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

表 1 PIN驱动API接口功能介绍

接口名描述
DevHandle PinGet(const char *pinName)获取管脚描述句柄
void PinPut(DevHandle handle)释放管脚描述句柄
int32_t PinSetPull(DevHandle handle, enum PinPullType pullType)设置管脚推拉方式
int32_t PinGetPull(DevHandle handle, enum PinPullType *pullType)获取管脚推拉方式
int32_t PinSetStrength(DevHandle handle, uint32_t strength)设置管脚推拉强度
int32_t PinGetStrength(DevHandle handle, uint32_t *strength)获取管脚推拉强度
int32_t PinSetFunc(DevHandle handle, const char *funcName)设置管脚功能
int32_t PinGetFunc(DevHandle handle, const char **funcName)获取管脚功能

说明:
本文涉及PIN的所有接口,支持内核态及用户态使用。

开发步骤

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

图 2 PIN使用流程图

PIN使用流程图

获取PIN管脚描述句柄

在使用PIN进行管脚操作时,首先要调用PinGet获取管脚描述句柄,该函数会返回匹配传入管脚名的管脚描述句柄。

DevHandle PinGet(const char *pinName);

表 2 PinGet参数和描述

参数描述
pinName字符指针类型,管脚名
返回值描述
NULL获取PIN管脚描述句柄失败
handlePIN管脚描述句柄

假设PIN需要操作的管脚名为P18,获取其管脚描述句柄的示例如下:

DevHandle handle = NULL;    // PIN管脚描述句柄char pinName = "P18";       // PIN管脚名
handle = PinGet(pinName);
if (handle == NULL) {HDF_LOGE("PinGet: get handle failed!\n");return HDF_FAILURE;
}
PIN设置管脚推拉方式

PIN设置管脚推拉方式的函数如下所示:

int32_t PinSetPull(DevHandle handle, enum PinPullType pullType);

表 3 参数和描述

参数描述
handleDevHandle类型,PIN管脚描述句柄
pullType枚举类型,PIN管脚推拉方式
返回值描述
HDF_SUCCESSPIN设置管脚推拉方式成功
负数PIN设置管脚推拉方式失败

假设PIN要设置的管脚推拉方式为上拉,其实例如下:

int32_t ret;
enum PinPullType pullTypeNum;// PIN设置管脚推拉方式
pullTypeNum = 1;
ret = PinSetPull(handle, pullTypeNum);
if (ret != HDF_SUCCESS) {HDF_LOGE("PinSetPull: failed, ret %d\n", ret);return ret;
}
PIN获取管脚推拉方式

PIN获取管脚推拉方式的函数如下所示:

int32_t PinGetPull(DevHandle handle, enum PinPullType *pullType);

表 4 PinGetPull参数和描述

参数描述
handleDevHandle类型,PIN管脚描述句柄
pullType枚举类型指针,接收PIN管脚推拉方式
返回值描述
HDF_SUCCESSPIN获取管脚推拉方式成功
负数PIN获取管脚推拉方式失败

PIN获取管脚推拉方式的实例如下:

int32_t ret;
enum PinPullType pullTypeNum;// PIN获取管脚推拉方式
ret = PinGetPull(handle, &pullTypeNum);
if (ret != HDF_SUCCESS) {HDF_LOGE("PinGetPull: failed, ret %d\n", ret);return ret;
}
PIN设置管脚推拉强度

PIN设置管脚推拉强度函数如下所示:

int32_t PinSetStrength(DevHandle handle, uint32_t strength);

表 5 PinSetStrength参数和描述

参数描述
handleDevHandle类型,管脚描述句柄
strengthuint32_t类型,PIN管脚推拉强度
返回值描述
HDF_SUCCESSPIN设置管脚推拉强度成功
负数PIN设置管脚推拉强度失败

假设PIN要设置的管脚推拉强度为2,其实例如下:

int32_t ret;
uint32_t strengthNum;
// PIN设置管脚推拉强度
strengthNum = 2;
ret = PinSetStrength(handle, strengthNum);
if (ret != HDF_SUCCESS) {HDF_LOGE("PinSetStrength: failed, ret %d\n", ret);return ret;
}
PIN获取管脚推拉强度

PIN设置管脚推拉强度后,可以通过PIN获取管脚推拉强度接口来查看PIN管脚推拉强度,PIN获取管脚推拉强度的函数如下所示:

int32_t PinGetStrength(DevHandle handle, uint32_t *strength);

表 6 PinGetStrength参数和描述

参数描述
handleDevHandle类型,管脚描述句柄
strengthuint32_t类型指针,接收PIN管脚推拉强度
返回值描述
HDF_SUCCESSPIN获取管脚推拉强度成功
负数PIN获取管脚推拉强度失败

PIN获取管脚推拉强度的实例如下:

int32_t ret;
uint32_t strengthNum;// PIN获取管脚推拉强度
ret = PinGetStrength(handle, &strengthNum);
if (ret != HDF_SUCCESS) {HDF_LOGE("PinGetStrength: failed, ret %d\n", ret);return ret;
}
PIN设置管脚功能

管脚功能特指的是管脚复用的功能,每个管脚功能都不相同,管脚功能名详细可以参考//device/soc/hisilicon/hi3516dv300/sdk_liteos/hdf_config/pin/pin_config.hcs。

PIN设置管脚功能函数如下所示:

int32_t PinSetFunc(DevHandle handle, const char *funcName);

表 7 PinSetFunc参数和描述

参数描述
handleDevHandle类型,管脚描述句柄
funcName字符指针类型,PIN管脚功能名
返回值描述
HDF_SUCCESSPIN设置管脚功能成功
负数PIN设置管脚功能失败

假设PIN需要设置的管脚功能为LSADC_CH1(ADC通道1),其实例如下:

int32_t ret;
char funcName = "LSADC_CH1";// PIN设置管脚功能
ret = PinSetFunc(handle, funcName);
if (ret != HDF_SUCCESS) {HDF_LOGE("PinSetFunc: failed, ret %d\n", ret);return ret;
}
PIN获取管脚功能

PIN设置管脚功能后,可以通过PIN获取管脚功能接口来查看PIN管脚功能,PIN获取管脚功能的函数如下所示:

int32_t PinGetFunc(DevHandle handle, const char **funcName);

表 8 PinGetFunc参数和描述

参数描述
handleDevHandle类型,管脚描述句柄
funcName字符类型双指针,接收PIN管脚功能
返回值描述
HDF_SUCCESSPIN获取管脚功能成功
负数PIN获取管脚功能失败

PIN获取管脚功能的实例如下:

int32_t ret;
char *funcName = NULL;// PIN获取管脚功能
ret = PinGetFunc(handle, &funcName);
if (ret != HDF_SUCCESS) {HDF_LOGE("PinGetFunc: failed, ret %d\n", ret);return ret;
}
释放PIN管脚描述句柄

PIN不再进行任何操作后,需要释放PIN管脚描述管脚句柄,函数如下所示:

void PinPut(DevHandle handle);

表 9 PinPut参数和描述

参数描述
handleDevHandle类型,管脚描述句柄
返回值描述
NA无返回值

PIN销毁管脚描述句柄实例如下:

PinPut(handle);

使用实例

下面将基于Hi3516DV300开发板展示使用PIN设置管脚相关属性完整操作,步骤主要如下:

  1. 传入要设置的管脚名,获取PIN管脚描述句柄。

  2. 通过PIN管脚描述句柄以及推拉方式pullTypeNum设置管脚推拉方式,如果操作失败则释放PIN管脚描述句柄。

  3. 通过PIN管脚描述句柄,并用pullTypeNum承接获取的管脚推拉方式,如果操作失败则释放PIN管脚描述句柄。

  4. 通过PIN管脚描述句柄以及推拉强度strengthNum设置管脚推拉强度,如果操作失败则释放PIN管脚描述句柄。

  5. 通过PIN管脚描述句柄,并用strengthNum承接获取的管脚推拉强度,如果操作失败则释放PIN管脚描述句柄。

  6. 通过PIN管脚描述句柄以及管脚功能名funName设置管脚功能,如果操作失败则释放PIN管脚描述句柄。

  7. 通过PIN管脚描述句柄,并用funName承接获取的管脚功能名,如果操作失败则释放PIN管脚描述句柄。

  8. 使用完PIN后,不再对管脚进行操作,释放PIN管脚描述句柄。

#include "hdf_log.h"                              // 标准日志打印头文件
#include "pin_if.h"                               // PIN标准接口头文件int32_t PinTestSample(void)
{int32_t ret;uint32_t strengthNum;enum PinPullType pullTypeNum;char *pinName = NULL;const char *funcName = NULL;DevHandle handle = NULL;// PIN管脚名,要填写实际要设置的管脚名pinName = "P18"; // PIN获取管脚描述句柄handle = PinGet(pinName);if (handle == NULL) {HDF_LOGE("PinTestSample: pin get fail!\n");return -1;}// PIN设置管脚推拉方式为上拉 pullTypeNum = 1;ret = PinSetPull(handle, pullTypeNum);if (ret != HDF_SUCCESS) {HDF_LOGE("PinTestSample: pin set pull fail, ret:%d\n", ret);goto ERR;}// PIN获取管脚推拉方式 ret = PinGetPull(handle, &pullTypeNum);if (ret != HDF_SUCCESS) {HDF_LOGE("PinTestSample: pin get pull fail, ret:%d\n", ret);goto ERR;}// PIN设置管脚推拉强度为2 strengthNum = 2;ret = PinSetStrength(handle, strengthNum);if (ret != HDF_SUCCESS) {HDF_LOGE("PinTestSample: pin set strength fail, ret:%d\n", ret);goto ERR;}// PIN获取管脚推拉强度 ret = PinGetStrength(handle, &strengthNum);if (ret != HDF_SUCCESS) {HDF_LOGE("PinTestSample: pin get strength fail, ret:%d\n", ret);goto ERR;}// PIN设置管脚功能为LSADC_CH1 funcName = "LSADC_CH1";ret = PinSetFunc(handle, funcName);if (ret != HDF_SUCCESS) {HDF_LOGE("PinTestSample: pin set func fail, ret:%d\n", ret);goto ERR;}// PIN获取管脚功能 ret = PinGetFunc(handle, &funcName);if (ret != HDF_SUCCESS) {HDF_LOGE("PinTestSample: pin get func fail, ret:%d\n", ret);goto ERR;}HDF_LOGD("PinTestSample: function tests end.", __func__);
ERR:// 释放PIN管脚描述句柄 PinPut(handle); 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学习资料

总结

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

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

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

相关文章

代码随想录算法训练营第三十七天|● 738.单调递增的数字 ● 968.监控二叉树

738.单调递增的数字 class Solution { public:int monotoneIncreasingDigits(int n) {string a to_string(n);int k 0;for (int i a.size() - 1; i > 0; i--) {if (a[i] < a[i - 1]) {k i;a[i-1]--;}}cout << k << endl;if (k ! 0){for (int i a.size…

c# Xml 和 Json 转换方法记录

c# xml 转 json 在C#中&#xff0c;可以使用下面几种方法将XML转换为JSON&#xff1a; 使用Newtonsoft.Json库&#xff1a; using Newtonsoft.Json; using Newtonsoft.Json.Converters; using Newtonsoft.Json.Linq; using System.Xml;// 从XML字符串转换为JSON字符串 string …

安卓手机APP开发的媒体相关内容播放列表

安卓手机APP开发的媒体相关内容播放列表 目录 概述 修改播放列表 查询播放列表 重复模式 随机模式 设置一个定制的随机顺序 标识播放列表中的媒体项 把APP数据和播放列表媒体项关联起来

好玩的Unicode表情

Unicode表情符号是Unicode标准的一部分&#xff0c;适用于任何支持Unicode编码的语言和平台。Unicode是一种国际通用的字符编码标准&#xff0c;它涵盖了世界上几乎所有的文字、符号和表情符号&#xff0c;确保不同系统间的信息交换能够准确无误。 分类方式 表情符号&#xf…

如何保证数据库、缓存的双写一致?

文章目录 前言常见方案更新缓存的方案1. 先写缓存&#xff0c;再写数据库2. 先写数据库&#xff0c;再写缓存2.1. 写缓存失败2.2. 高并发问题2.3. 性能浪费 3. 先删缓存&#xff0c;再写数据库3.1. 高并发问题3.2. 缓存双删 4. 先写数据库&#xff0c;再删缓存5. 删除缓存失败怎…

单例模式a

为什么需要单例模式&#xff1f; 保证类的实例在全局只有一个&#xff0c;避免无效对象创建和销毁时的资源消耗。 在Java中一切都是对象&#xff0c;实例方法的调用需要通过对象&#xff0c;为了调用类中的方法而创建对象&#xff0c;方法调用完成之后对象也需要被GC回收&…

Stable Diffusion之Ubuntu下部署

1、安装conda环境 conda create -n webui python3.10.6 2、激活环境 每次使用都要激活 conda activate webui 注意开始位置的变换 关闭环境 conda deactivate webui 3、离线下载SD 代码 https://github.com/AUTOMATIC1111/stable-diffusion-webui https://github.com/Stabilit…

CentOS7.9.2009安装Kibana7.11.1

本文章使用CentOS7.9.2009服务器安装kibana7.11.1软件 1.服务器信息 [root@elasticsearch ~]# cat /etc/redhat-release CentOS Linux release 7.9.2009 (Core) [root@elasticsearch ~]# 2.kibana安装 2.1.创建kibana用户 创建kibana用户和组 命令: useradd kibana [r…

10个大型语言模型(LLM)常见面试问题和答案解析

今天我们来总结以下大型语言模型面试中常问的问题 1、哪种技术有助于减轻基于提示的学习中的偏见? A.微调 Fine-tuning B.数据增强 Data augmentation C.提示校准 Prompt calibration D.梯度裁剪 Gradient clipping 答案:C 提示校准包括调整提示&#xff0c;尽量减少产生…

SQL注入sqli_labs靶场第九、十题

第九题 ?id1 and 11 页面正常 ?id1 and 12 页面正常 ?id1 and 11 页面正常 ?id1 and 12 页面正常 输入任何信息&#xff0c;均显示相同页面&#xff0c;尝试延时注入判断 ?id1 and if(11,sleep(5),1)-- 页面迅速显示 ?id1 and if(11,sleep(5),1)-- 页面过了5秒显示 判断为…

http请求头导致了dial tcp:lookup xxxx on 10.43.0.10:53 no sunch host

事实证明人有的时候也不能太偷懒&#xff0c;太偷懒容易给自己埋坑。 问题的背景&#xff1a; web端调用服务A&#xff0c;服务A异步调用服务B。服务A有四个场景需要调用服务B&#xff0c;所以&#xff0c;服务A中封装了一个公用的方法&#xff0c;唯一的区别是&#xff0c;场…

IDEA 控制台中文乱码 4 种解决方案

前言 IntelliJ IDEA 如果不进行相关设置&#xff0c;可能会导致控制台中文乱码、配置文件中文乱码等问题&#xff0c;非常影响编码过程中进行问题追踪。本文总结了 IDEA 中常见的中文乱码解决方法&#xff0c;希望能够帮助到大家。 IDEA 中文乱码 解决方案 一、设置字体为支…

手机银行客户端框架之mPaaS介绍

移动开发平台&#xff08;Mobile PaaS&#xff0c;简称 mPaaS&#xff09;是源于支付宝 App 的移动开发平台&#xff0c;为移动开发、测试、运营及运维提供云到端的一站式解决方案&#xff0c;能有效降低技术门槛、减少研发成本、提升开发效率&#xff0c;协助企业快速搭建稳定…

H. GCD is Greater

H. GCD is Greater 题意 给定一个长度为 n n n的数组 a a a&#xff0c;先手选择 [ 2 , n − 2 ] [2,n-2] [2,n−2]个数并计算所选择数的gcd&#xff0c;后手选择剩下的数&#xff0c;并计算剩下所有的数按位与的结果&#xff0c;再加上给定的 x x x&#xff0c;如果先手的结果…

Docker Redis Debian服务器版

1.使用官方安装脚本自动安装docker 安装命令如下&#xff1a; curl -fsSL https://get.docker.com -o get-docker.shsudo sh get-docker.sh 如果安装提示 -bash sudo command not found 则需要 #update sudo apt-get update sudo apt-get install sudo再执行安装脚本1 安装…

c++中常用库函数

大小写转换 islower/isupper函数 char ch1 A; char ch2 b;//使用islower函数判断字符是否为小写字母 if(islower(ch1)){cout << ch1 << "is a lowercase letter." << end1; } else{cout << ch1 << "is not a lowercase lette…

上采样-Lanczos插值

Lanczos插值是一种高级的上采样方法&#xff0c;它在计算目标图像中每个像素的值时&#xff0c;利用了周围像素的信息&#xff0c;并通过Lanczos滤波器进行插值计算&#xff0c;以产生较为清晰的结果。下面通过图文并茂的方式详细描述Lanczos插值方法的实现过程。 现在我们想将…

IntelliJ IDEA(WebStorm、PyCharm、DataGrip等)设置中英文等宽字体,英文为中文的一半(包括标点符号)

1.设置前&#xff08;idea默认字体为 JetBrains Mono&#xff09; 2.设置后&#xff08;楷体&#xff09;

计算机网络常见面试总结

文章目录 1. 计算机网络基础1.1 网络分层模型1. OSI 七层模型是什么&#xff1f;每一层的作用是什么&#xff1f;2.TCP/IP 四层模型是什么&#xff1f;每一层的作用是什么&#xff1f;3. 为什么网络要分层&#xff1f; 1.2 常见网络协议1. 应用层有哪些常见的协议&#xff1f;2…

三种语言实现spark createDataFrame

前言 我们经常需要在本地用数组写一些测试数据,进行spark逻辑测试,需要借助StructType和StructField以及数组生成DataFrame,最终进行测试,这里就简单的用Java、Scala、Python三种语言实现用数组的数据创建DataFrame。 了解StructType和StructField StructType spark stru…