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

最新推荐文章于 2024-05-22 22:49:30 发布
最新推荐文章于 2024-05-22 22:49:30 发布
阅读量834 收藏 25
点赞数 13
分类专栏： 鸿蒙南向开发 鸿蒙 文章标签： harmonyos 华为 OpenHarmony 嵌入式硬件 鸿蒙 驱动开发 android
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/m0_64420071/article/details/137652356
版权

功能简介

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学习资料

总结

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

代码与思维
关注
  • 13
    点赞
  • 踩
  • 25
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
鸿蒙HarmonyOS开发实战—流转
shudaoshanQAQ的博客
01-18 1096
随着全场景多设备生活方式的不断深入，用户拥有的设备越来越多，每个设备都能在适合的场景下提供良好的体验，例如：手表可以提供及时的信息查看能力，电视可以带来沉浸的观影体验。
Harmony鸿蒙南向驱动开发-PIN
m0_64420071的博客
04-10 720
PIN即管脚控制器，用于统一管理各SoC的管脚资源，对外提供管脚复用功能。
Harmony鸿蒙南向外设驱动开发-Pin_auth
m0_64420071的博客
04-13 727
口令认证是端侧设备不可或缺的一部分，为设备提供一种用户认证能力，可应用于设备解锁、支付、应用登录等身份认证场景。
Harmony鸿蒙南向外设驱动开发-Audio
m0_64420071的博客
04-12 921
本文主要介绍基于HDF（Hardware Driver Foundation）驱动框架开发的Audio驱动，包括Audio驱动的架构组成和功能部件
Harmony鸿蒙南向外设驱动开发-Touchscreen
m0_64420071的博客
04-13 780
Touchscreen驱动用于驱动触摸屏使其正常工作
Harmony鸿蒙南向外设驱动开发-LCD
m0_64420071的博客
04-13 804
LCD（Liquid Crystal Display）驱动编程，通过对显示器上电、初始化显示器驱动IC（Integrated Circuit）内部寄存器等操作，使其可以正常工作。
Harmony鸿蒙南向外设驱动开发-Face_auth
m0_64420071的博客
04-13 835
人脸识别功能是端侧设备不可或缺的一部分，为设备提供一种用户认证能力，可应用于设备解锁、支付、应用登录等身份认证场景
Harmony鸿蒙南向外设驱动开发-User_auth
m0_64420071的博客
04-13 895
用户认证功能是端侧设备不可或缺的一部分，可应用于设备解锁、支付、应用登录等身份认证场景。
Harmony鸿蒙南向外设驱动开发-Fingerprint_auth
m0_64420071的博客
04-13 815
指纹认证是端侧设备不可或缺的功能，为设备提供用户认证能力，可应用于设备解锁、支付、应用登录等身份认证场景
HarmonyOS 鸿蒙应用开发 例1-任务进度管理程序
01-27
任务进度轻松掌控：ArkUI框架实战详解任务管理应用开发 内容简介：想要高效管理任务，追踪进度？不妨借助ArkUI框架打造一个任务管理应用！本文将深入解析如何使用ArkUI的声明式UI设计，在应用中新增任务、完成任务，...
HarmonyOS（commandline-tools-linux-2.0.0.2.zip）
11-08
Command Line Tools for HarmonyOS（commandline-tools-linux-2.0.0.2.zip）
harmonyOS-鸿蒙壁纸App，使用ArkTs开发.zip
01-20
鸿蒙系统 harmonyOS-鸿蒙壁纸App，使用ArkTs开发.zip
华为鸿蒙HarmonyOS开发整理资料汇总.zip
11-25
华为鸿蒙HarmonyOS开发整理资料汇总，共38份。 1学前必读：HarmonyOS学习资源主题分享 2学前必读：OpenHarmony-联盟生态资料合集 3-1.HarmonyOS概述：技术特性 3-2.HarmonyOS概述：开发工具与平台 3-3.HarmonyOS...
HarmonyOS鸿蒙快速入门应用开发基础+进阶视频.zip
05-24
02.3 HarmonyOS设备开发平台介绍 02.4 分布式应用开发实例演示 02.5 第2期答疑环节 03.1 致软件工程师的灵魂拷问 03.2 重新定位_人_设备_场景的关系 03.3 应用开发者面临的挑战 03.4 DevEco_Studio提供分布式多设备...
纯血鸿蒙APP实战开发——多文件下载监听案例
m0_71524094的博客
05-16 361
多文件下载监听在应用开发中是一个非常常见的需求。本示例将介绍如何使用request上传下载模块实现多文件下载监听，如监听每个文件下载任务的进度，任务暂停，下载完成等下载情况。每个应用最多支持创建10个未完成的任务。如果你觉得这篇内容对你还蛮有帮助，我想邀请你帮我三个小忙：关注小编，同时可以期待后续文章ing🚀，不定期分享原创知识。
鸿蒙 DevEco Studio 3.1 Release 下载sdk报错的解决办法
最新发布
smileKH的博客
05-22 247
最近在学习鸿蒙开发，以后也会记录一些关于鸿蒙相关的问题和解决方法，希望能帮助到大家。
harmonyos鸿蒙快速入门应用开发基础视频.rar 下载
12-10
HarmonyOS鸿蒙快速入门应用开发基础视频.rar 是一个用于学习鸿蒙操作系统应用开发基础的视频资源。可以通过下载和观看这个视频来快速入门鸿蒙操作系统的应用开发。这个视频资源包含了丰富的内容，涵盖了鸿蒙操作系统...

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值