如何在RT-Thread中使用通用GPIO设备驱动从而操作GPIO呢

摘要

本应用笔记描述了如何使用 RT-Thread 的通用 GPIO 设备驱动，包括驱动的配置、相关 API 的应用。并给出了在正点原子 STM32F4 探索者开发板上验证的代码示例。

本文的目的和结构

本文的目的和背景

为了给用户提供操作 GPIO 的通用 API，方便应用程序开发，RT-Thread 中引入了通用 GPIO 设备驱动。并提供类似 Arduino 风格的 API 用于操作 GPIO，如设置 GPIO 模式和输出电平、读取 GPIO 输入电平、配置 GPIO 外部中断。本文说明了如何使用 RT-Thread 的通用 GPIO 设备驱动。

本文的结构

本文首先描述了 RT-Thread 通用 GPIO 设备驱动的基本情况，接下来给出了在正点原子 STM32F4 探索者开发板上验证的代码示例，最后详细描述了通用 GPIO 设备驱动 API 的参数取值和注意事项。

问题阐述

RT-Thread 提供了一套简单的 I/O 设备管理框架，它把 I/O 设备分成了三层进行处理：应用层、I/O 设备管理层、硬件驱动层。应用程序通过 RT-Thread 的设备操作接口获得正确的设备驱动，然后通过这个设备驱动与底层 I/O 硬件设备进行数据（或控制）交互。RT-Thread 提供给上层应用的是一个抽象的设备操作接口，给下层设备提供的是底层驱动框架。对于通用 GPIO 设备，应用程序既可以通过设备操作接口访问，又可以直接通过通用 GPIO 设备驱动来访问。一般来说，我们都是使用第二种方式，那么如何在 RT-Thread 中使用通用 GPIO 设备驱动从而操作 GPIO 呢？

问题的解决

本文基于正点原子 STM32F4 探索者开发板，给出了通用 GPIO 设备的具体应用示例代码，包含管脚输入、输出和外部中断的使用方法。由于 RT-Thread 上层应用 API 的通用性，因此这些代码不局限于具体的硬件平台，用户可以轻松将它移植到其它平台上。正点原子 STM32F4 探索者开发板使用的 MCU 是 STM32F407ZGT6，板载 2 颗 LED 和 4 个独立按键。LED 分别连接到 MCU 的 GPIOF9、GPIOF10，KEY0 按键连接到 GPIOE4，KEY1 按键连接到 GPIOE3，KEY2 按键连接到 GPIOE2，WK_UP 按键连接到 GPIOA0，2 颗 LED 均为低电平点亮，独立按键 KEY0、KEY1、KEY2 按下为低电平；WK_UP 按下为高电平。

准备和配置工程

• 下载 RT-Thread 源码
• 下载 GPIO 设备驱动示例代码
• 进入 rt-thread\bsp\stm32f4xx-HAL 目录，在 env 命令行中输入 menuconfig，进入配置界面，使用 menuconfig 工具（学习如何使用）配置工程。

(1) 在 menuconfig 配置界面依次选择 RT-Thread Components —-> Device Drivers —-> Using generic GPIO device drivers，如图所示：

(2) 输入命令scons —target=mdk5 -s生成 mdk5 工程。将示例代码附带的 main.c 替换掉 bsp 中的 main.c，如图所示：

(3) 编译，下载程序，在终端输入 list_device 命令可以看到 device 是 pin、类型是 Miscellaneous Device 就说明通用 GPIO 设备驱动添加成功了。

下面是 3 个通用 GPIO 设备驱动 API 应用示例，分别是：GPIO 输出、GPIO 输入、GPIO 外部中断，这些代码在正点原子 STM32F4 探索者开发板上验证通过。

GPIO 输出配置

示例 1：配置 GPIO 为输出，点亮 LED。根据原理图，GPIOF9 连接到了板载红色 LED，丝印为 DS0；GPIOF10 连接到了板载绿色 LED，丝印为 DS1。GPIOF9 输出低电平则点亮 DS0，GPIOF9 输出高电平则 DS0 不亮；GPIOF10 输出低电平则点亮 DS1，GPIOF10 输出高电平则 DS1 不亮。

在线程入口函数 led_thread_entry 里首先调用 rt_pin_mode 设置管脚模式为输出模式，然后就进入 while(1) 循环，间隔 500ms 调用 rt_pin_write 来改变 GPIO 输出电平。下面是创建线程的代码：

编译、下载程序，我们将看到 LED 间隔 500ms 闪烁的现象。

GPIO 输入配置

示例 2：配置 GPIOE3、GPIOE2 为上拉输入，GPIOA0 为下拉输入，检测按键信号。根据原理图，GPIOE3 连接到按键 KEY1，按键被按下时 GPIOE3 应读取到低电平，按键没有被按下时 GPIOE3 应读取到高电平；GPIOE2 连接到按键 KEY2，按键被按下时 GPIOE2 应读取到低电平，按键没有被按下时 GPIOE2 应读取到高电平；GPIOA0 连接到按键 WK_UP，按键被按下时 GPIOA0 应读取到高电平，按键没有被按下时 GPIOA0 应读取到低电平。

在线程入口函数 key_thread_entry 里首先调用 rt_pin_mode 设置管脚 GPIOE3 为上拉输入模式。这样当用户按下按键 KEY1 时，GPIOE3 读取到的电平是低电平；按键未被按下时，GPIOE3 读取到的电平是高电平。然后进入 while(1) 循环，调用 rt_pin_read 读取管脚 GPIOE3 电平，如果读取到低电平则表示按键 KEY1 被按下，就在终端打印字符串 "key1 pressed!"。每隔 10ms 检测一次按键输入情况。下面是创建线程的代码：

编译、下载程序，我们按下开发板上的用户按键，终端将打印提示字符。

GPIO 中断配置

示例 3：配置 GPIO 为外部中断模式、下降沿触发，检测按键信号。根据原理图，GPIOE4 连接到按键 KEY0，按键被按下时 MCU 应探测到电平下降沿。

在线程入口函数 irq_thread_entry 里首先调用 rt_pin_attach_irq 设置管脚 GPIOE4 为下降沿中断模式，并绑定了中断回调函数，还传入了字符串 "callback args"。然后调用 rt_pin_irq_enable 使能中断，这样按键 KEY0 被按下时 MCU 会检测到电平下降沿，触发外部中断，在中断服务程序中会调用回调函数 hdr_callback，在回调函数中打印传入的参数和提示信息。下面是创建线程的代码：

编译、下载程序，我们按下按键 KEY0，终端将打印提示字符。

I/O 设备管理框架和通用 GPIO 设备的联系

RT-Thread 自动初始化功能依次调用 rt_hw_pin_init ===> rt_device_pin_register ===> rt_device_register 完成了 GPIO 硬件初始化。rt_device_register 注册设备类型为 RT_Device_Class_Miscellaneous，即杂类设备，从而我们就可以使用统一的 API 操作 GPIO。

原作者：RT-Thread应用笔记