rtt——PIN设备的使用

RT-thread通过PIN设备对芯片的GPIO引脚进行管理，我们可以通过rtt它提供的一系列PIN设备管理接口来操作GPIO

rt_pin_get

在rtt中的引脚编号和芯片上的引脚号并不是一个概念，所以在操作PIN设备前，我们需要使用引脚编号来指定对哪个引脚进行操作。通常有3种方式获得引脚编号：调用API、宏定义、查看PIN驱动文件。

调用API

使用rt_pin_get函数获取引脚编号

pin_num = rt_pin_get("PA.3");

宏定义

#define LED GET_PIN(A,3)

查看PIN驱动文件

pin的驱动文件在drivers/drv_gpio.c中

我们从PA0往后依次类推即可

rt_pin_mode

设置引脚输出/输出模式，共有五种模式：推挽输出、开漏输出、输入、上拉输入、下拉输入

引脚在使用前需要先设置好输入输出模式

rt_pin_mode(rt_base_t pin, rt_base_t mode);
// pin为引脚编号、mode为引脚模式

rt_pin_write

设置引脚输出的电平状态

void rtt_pin_write(rt_base_t pin, rt_base_t value);
// pin引脚编号，value输出的电平值:PIN_HIGH 高电平、PIN_LOW低电平

rt_pin_read

读取输入的引脚状态

int rt_pin_read(rt_base_t pin);
// 返回值：引脚状态PIN_HIGH 高电平、PIN_LOW低电平，pin引脚编号

rt_pin_attach_irq

绑定中断回调函数
引脚的中断触发方式一共5种：下降沿、上升沿、高电平、低电平、双边沿

rt_err_t rt_pin_attach_pin(rt_basr_t pin. rt_uint32_t mode, void (*hdr)(void *aegs), void *args);
// rt_err_t:返回结果，绑定成功：RT_EOK；绑定失败:返回错误码
// pin 引脚编号，mode 中断触发方式，void (*hdr)(void *aegs) 中断函数，void *args 函数参数，不设置为RT_NULL

rt_pin_detach_irq

脱离引脚中断回调函数，如果想要不在进入中断函数或更换中断回调方式可以使用这个函数操作

rt_err_t rt_pin_detach_irq(rt_base_t pin);

调用这个函数，虽然脱离了中断回调函数，但是中断还是使能的，可以更换其他的中断函数

rt_pin_enable_irq

使能中断，打开或关闭引脚的中断

rt_err_t rt_pin_enable_irq(rt_base_t pin, rt_uint32_t enabled);
// enabled:PIN_IRQ_ENABLE 开启中断，PIN_IRQ_DISABLE 关闭中断

练习

使用中断方式，实现按键按下时点亮LED

/*
 * Copyright (c) 2006-2025, RT-Thread Development Team
 *
 * SPDX-License-Identifier: Apache-2.0
 *
 * Change Logs:
 * Date           Author       Notes
 * 2025-03-10     RT-Thread    first version
 */

#include <rtthread.h>
#include "rtdevice.h"
#include "drv_common.h"
#include <rtdbg.h>

#define DBG_TAG "main"
#define DBG_LVL DBG_LOG
// 定义LED的引脚编号
#define LED_Y GET_PIN(H, 10)
// 定义按键K1的引脚编号
#define KEY1 GET_PIN(A, 0)

/* KEY1的中断回调函数 */
void Key1_irq(void *args)
{
    if(rt_pin_read(KEY1) == PIN_HIGH)
        rt_pin_write(LED_Y, PIN_LOW);
    else {
        rt_pin_write(LED_Y, PIN_HIGH);
    }
}

int main(void)
{
    int count = 1;

    /* 设置引脚的模式 */
    rt_pin_mode(LED_Y, PIN_MODE_OUTPUT);
    rt_pin_write(LED_Y, PIN_HIGH);

    /* 按键中断配置 */
    rt_pin_attach_irq(KEY1, PIN_IRQ_MODE_RISING_FALLING, Key1_irq, RT_NULL);
    /* 开启中断 */
    rt_pin_irq_enable(KEY1, PIN_IRQ_ENABLE);

    while (count++)
    {

    }

    return RT_EOK;
}