cms网站下载,阿里云 wordpress 建站 教程,怎么访问域名网站,电商运营培训课程功能简介
PIN即管脚控制器#xff0c;用于统一管理各SoC的管脚资源#xff0c;对外提供管脚复用功能#xff1a;包括管脚推拉方式、管脚推拉强度以及管脚功能。
PIN接口定义了操作PIN管脚的通用方法集合#xff0c;包括#xff1a; 获取/释放管脚描述句柄#xff1a;传…功能简介
PIN即管脚控制器用于统一管理各SoC的管脚资源对外提供管脚复用功能包括管脚推拉方式、管脚推拉强度以及管脚功能。
PIN接口定义了操作PIN管脚的通用方法集合包括 获取/释放管脚描述句柄传入管脚名与链表中每个控制器下管脚名进行匹配匹配则会获取一个管脚描述句柄操作完PIN管脚后释放该管脚描述句柄。 设置/获取管脚推拉方式推拉方式可以是上拉、下拉以及悬空。 设置/获取管脚推拉强度用户可根据实际设置管脚推拉强度大小。 设置/获取管脚功能通过管脚功能名设置/获取管脚功能实现管脚复用。
基本概念
PIN是一个软件层面的概念目的是为了统一各SoC的PIN管脚管理对外提供管脚复用功能配置PIN管脚的电气特性。 SoCSystem on Chip 系统级芯片也有称作片上系统通常是面向特定用途将微处理器、模拟IP核、数字IP核和存储器集成在单一芯片的标准产品。 管脚复用 由于芯片自身的引脚数量有限无法满足日益增多的外接需求。此时可以通过软件层面的寄存器设置让引脚工作在不同的状态从而实现相同引脚完成不同功能的目的。
运作机制
在HDF框架中同类型设备对象较多时可能同时存在十几个同类型配置器若采用独立服务模式则需要配置更多的设备节点且相关服务会占据更多的内存资源。相反采用统一服务模式可以使用一个设备服务作为管理器统一处理所有同类型对象的外部访问这会在配置文件中有所体现实现便捷管理和节约资源的目的。PIN模块接口适配模式采用统一服务模式。
在统一模式下所有的控制器都被核心层统一管理并由核心层统一发布一个服务供接口层因此这种模式下驱动无需再为每个控制器发布服务。
PIN模块各分层作用 接口层提供获取PIN管脚、设置PIN管脚推拉方式、获取PIN管脚推拉方式、设置PIN管脚推拉强度、获取PIN管脚推拉强度、设置PIN管脚功能、获取PIN管脚功能、释放PIN管脚的接口。 核心层主要提供PIN管脚资源匹配PIN管脚控制器的添加、移除以及管理的能力通过钩子函数与适配层交互。 适配层主要是将钩子函数的功能实例化实现具体的功能。
图 1 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进行管脚操作时首先要调用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_CH1ADC通道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设置管脚相关属性完整操作步骤主要如下 传入要设置的管脚名获取PIN管脚描述句柄。 通过PIN管脚描述句柄以及推拉方式pullTypeNum设置管脚推拉方式如果操作失败则释放PIN管脚描述句柄。 通过PIN管脚描述句柄并用pullTypeNum承接获取的管脚推拉方式如果操作失败则释放PIN管脚描述句柄。 通过PIN管脚描述句柄以及推拉强度strengthNum设置管脚推拉强度如果操作失败则释放PIN管脚描述句柄。 通过PIN管脚描述句柄并用strengthNum承接获取的管脚推拉强度如果操作失败则释放PIN管脚描述句柄。 通过PIN管脚描述句柄以及管脚功能名funName设置管脚功能如果操作失败则释放PIN管脚描述句柄。 通过PIN管脚描述句柄并用funName承接获取的管脚功能名如果操作失败则释放PIN管脚描述句柄。 使用完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学习资料
总结
总的来说华为鸿蒙不再兼容安卓对中年程序员来说是一个挑战也是一个机会。只有积极应对变化不断学习和提升自己他们才能在这个变革的时代中立于不败之地。
