OpenHarmony:全流程讲解如何编写GPIO平台驱动以及应用程序 原创 精华
1、案例简介
该程序是基于OpenHarmony标准系统编写的基础外设类:GPIO驱动。
目前已在凌蒙派-RK3568开发板跑通。详细资料请参考官网:https://gitee.com/Lockzhiner-Electronics/lockzhiner-rk3568-openharmony/tree/master/samples/b03_platform_device_gpio
详细资料请参考OpenHarmony官网:
2、基础知识
2.1、GPIO简介
GPIO(General-purpose input/output)即通用型输入输出。通常,GPIO控制器通过分组的方式管理所有GPIO管脚,每组GPIO有一个或多个寄存器与之关联,通过读写寄存器完成对GPIO管脚的操作。
2.2、GPIO平台驱动
GPIO(General-purpose input/output)即通用型输入输出。通常,GPIO控制器通过分组的方式管理所有GPIO管脚,每组GPIO有一个或多个寄存器与之关联,通过读写寄存器完成对GPIO管脚的操作。
GPIO模块各分层作用:
- 接口层提供操作GPIO管脚的标准方法。
- 核心层主要提供GPIO管脚资源匹配,GPIO管脚控制器的添加、移除以及管理的能力,通过钩子函数与适配层交互,供芯片厂家快速接入HDF框架。
- 适配层主要是将钩子函数的功能实例化,实现具体的功能。
GPIO统一服务模式结构图:
为了保证上层在调用GPIO接口时能够正确的操作GPIO管脚,核心层在//drivers/hdf_core/framework/support/platform/include/gpio/gpio_core.h中定义了以下钩子函数,驱动适配者需要在适配层实现这些函数的具体功能,并与钩子函数挂接,从而完成适配层与核心层的交互。
GpioMethod定义:
GpioMethod结构体成员的钩子函数功能说明:
函数成员 | 入参 | 出参 | 返回值 | 功能 |
---|---|---|---|---|
write | cntlr:结构体指针,核心层GPIO控制器 local:uint16_t类型,GPIO端口标识号 val:uint16_t类型,电平传入值 | 无 | HDF_STATUS相关状态 | GPIO引脚写入电平值 |
read | cntlr:结构体指针,核心层GPIO控制器 local:uint16_t类型,GPIO端口标识 | val:uint16_t类型指针,用于传出电平值。 | HDF_STATUS相关状态 | GPIO引脚读取电平值 |
setDir | cntlr:结构体指针,核心层GPIO控制器 local:uint16_t类型,GPIO端口标识号 dir:uint16_t类型,管脚方向传入值 | 无 | HDF_STATUS相关状态 | 设置GPIO引脚输入/输出方向 |
getDir | cntlr:结构体指针,核心层GPIO控制器 local:uint16_t类型,GPIO端口标识号 | dir:uint16_t类型指针,用于传出管脚方向值 | HDF_STATUS相关状态 | 读GPIO引脚输入/输出方向 |
setIrq | cntlr:结构体指针,核心层GPIO控制器 local:uint16_t类型,GPIO端口标识号 mode:uint16_t类型,表示触发模式(边沿或电平) func:函数指针,中断服务程序; arg:void指针,中断服务程序入参 | 无 | HDF_STATUS相关状态 | 将GPIO引脚设置为中断模式 |
unsetIrq | cntlr:结构体指针,核心层GPIO控制器 local:uint16_t类型,GPIO端口标识号 | 无 | HDF_STATUS相关状态 | 取消GPIO中断设置 |
enableIrq | cntlr:结构体指针,核心层GPIO控制器 local:uint16_t类型,GPIO端口标识号 | 无 | HDF_STATUS相关状态 | 使能GPIO管脚中断 |
disableIrq | cntlr:结构体指针,核心层GPIO控制器 local:uint16_t类型,GPIO端口标识号 | 无 | HDF_STATUS相关状态 | 禁止GPIO管脚中断 |
2.3、GPIO应用程序
GPIO驱动API接口功能:
接口名 | 描述 |
---|---|
GpioGetByName(const char *gpioName) | 获取GPIO管脚ID |
int32_t GpioRead(uint16_t gpio, uint16_t *val) | 读GPIO管脚电平值 |
int32_t GpioWrite(uint16_t gpio, uint16_t val) | 写GPIO管脚电平值 |
int32_t GpioGetDir(uint16_t gpio, uint16_t *dir) | 获取GPIO管脚方向 |
int32_t GpioSetDir(uint16_t gpio, uint16_t dir) | 设置GPIO管脚方向 |
int32_t GpioUnsetIrq(uint16_t gpio, void *arg); | 取消GPIO管脚对应的中断服务函数 |
int32_t GpioSetIrq(uint16_t gpio, uint16_t mode, GpioIrqFunc func, void *arg) | 设置GPIO管脚对应的中断服务函数 |
int32_t GpioEnableIrq(uint16_t gpio) | 使能GPIO管脚中断 |
int32_t GpioDisableIrq(uint16_t gpio) | 禁止GPIO管脚中断 |
GPIO标准API通过GPIO管脚号来操作指定管脚,使用GPIO的一般流程如下图所示:
3、代码解析
3.1、准备工作
查看《凌蒙派-RK3568开发板_排针说明表_》(即Git仓库的//docs/board/凌蒙派-RK3568开发板_排针说明表_v1.0.xlsx),选中0_B5(即GPIO0_B5)。
3.2、配置文件
3.2.1、device_info.hcs
创建config/device_info.hcs,用于GPIO驱动设备描述,具体内容如下:
注意:
device_gpio:为配置树对gpio的设备类结点。
device0:是用于启用HDF_PLATFORM_GPIO_MANAGER驱动的,它负责对GPIO进行对外接口管理。
device1:是用于启用linux_gpio_adapter驱动的,它负责对Linux GPIO的读写(即对Linux Gpio子系统进行操作)。
3.2.3、参与配置树编译
编辑//vendor/lockzhiner/rk3568/hdf_config/khdf/hdf.hcs,将device_info.hcs添加配置树中。具体内容如下所示:
3.3、HDF驱动
//drivers/hdf_core/adapter/khdf/linux/platform/gpio/gpio_adapter.c已对Linux Gpio子系统进行规范化操作。因此,我们不需要额外的GPIO寄存器操作。
3.4、应用程序
3.4.1、gpio_test.c
gpio_test.c主要分为两个部分:
- 对gpio引脚进行读操作。
- 对gpio引脚进行写操作。
(1)对gpio引脚进行读操作
(2)对gpio引脚进行写操作
3.4.2、BUILD.gn
3.4.3、参与应用程序编译
编辑//vendor/lockzhiner/rk3568/samples/BUILD.gn,开启sample编译。具体如下:
4、编译说明
建议使用docker编译方法,运行如下:
5、运行结果
该程序运行结果如下所示:
可将GPIO引脚接入排针中的GND或3V3引脚,查看GPIO输出结果。
《凌蒙派-RK3568开发板_排针说明表_》这个有链接吗
考虑入手块板子学习下
表图挺清晰的
先看下如何使用
实用的教程
麻烦问下,能在北向图形界面APP内进行GPIO的操作吗 ?
写得挺详细,排版好,容易看得懂。
请问能在北向图形界面APP内进行GPIO的操作吗
在shell输入rk3568_gpio_test -g 13 -i时显示GpioCntlrGetByGpio:gpio 13 is not in any controllers!
main函数打印error:GPioSetDir failed and ret = -4
GpioServiceIoSetDir : failed to set gpio dir: -4!
这个该怎么解决呢?
我也是,我是ret=-107,你找到原因了吗