上面讲解 PIN 设备驱动层的时候说到过，所有的 GPIO 对应的索引号都会在驱动文件中定义，直接查看文件使用索引号就可以：

对于STM32而言，使用示例如下：

//对应驱动文件，下面的代码含义就是 设置 PA0 的模式为 PIN_MODE_INPUT_PULLUP
rt_pin_mode(0, PIN_MODE_INPUT_PULLUP);

说明，查看驱动文件的方式并不直观。

2.2 操作函数

操作函数说明老样子

2.2.1 设置 GPIO 模式

/*
参数 	描述
pin 	引脚编号:索引号
mode 	引脚工作模式

工作模式可选：
#define PIN_MODE_OUTPUT 0x00            	输出 
#define PIN_MODE_INPUT 0x01              	输入 
#define PIN_MODE_INPUT_PULLUP 0x02      	上拉输入 
#define PIN_MODE_INPUT_PULLDOWN 0x03    	下拉输入 
#define PIN_MODE_OUTPUT_OD 0x04         	 开漏输出
*/
void rt_pin_mode(rt_base_t pin, rt_base_t mode);

2.2.2 设置/ 读取 GPIO 电平

设置引脚电平：

/*
参数 	描述
pin 	引脚编号
value 	电平逻辑值，

value 	取值：
PIN_LOW 低电平，
PIN_HIGH 高电平
*/
void rt_pin_write(rt_base_t pin, rt_base_t value);

读取引脚电平：

/*
参数 	描述
pin 	引脚编号
返回 	
PIN_LOW 	低电平
PIN_HIGH 	高电平
*/
int  rt_pin_read(rt_base_t pin);

2.2.3 绑定/脱离中断回调函数

绑定中断回调函数：

/*
参数 	描述
pin 	引脚编号
mode 	中断触发模式
hdr 	中断回调函数，用户需要自行定义这个函数
args 	中断回调函数的参数，不需要时设置为 RT_NULL
返回 	——
RT_EOK 	绑定成功
错误码 	绑定失败

其中 mode 可选参数：
#define PIN_IRQ_MODE_RISING 		0x00    上升沿触发 
#define PIN_IRQ_MODE_FALLING 		0x01    下降沿触发 
#define PIN_IRQ_MODE_RISING_FALLING 0x02 	边沿触发（上升沿和下降沿都触发）
#define PIN_IRQ_MODE_HIGH_LEVEL 	0x03    	高电平触发 
#define PIN_IRQ_MODE_LOW_LEVEL 		0x04      	低电平触发 
*/
rt_err_t rt_pin_attach_irq(rt_int32_t pin, rt_uint32_t mode,
                             void (*hdr)(void *args), void  *args);

脱离中断回调函数：

/*
参数 	描述
pin 	引脚编号
返回 	——
RT_EOK 	脱离成功
错误码 	脱离失败
*/
rt_err_t rt_pin_detach_irq(rt_int32_t pin);

说明：引脚脱离了中断回调函数以后，中断并没有关闭，还可以调用绑定中断回调函数再次绑定其他回调函数。

2.2.4 使能中断

绑定好引脚中断回调函数后需要使用下面的函数使能引脚中断：

/*
参数 	描述
pin 		引脚编号
enabled 	状态
返回 	——
RT_EOK 	使能成功
错误码 	使能失败

enabled 	可取 2 种值之一：
PIN_IRQ_ENABLE	（开启）
PIN_IRQ_DISABLE	（关闭）
*/
rt_err_t rt_pin_irq_enable(rt_base_t pin, rt_uint32_t enabled);

三、PIN 设备示例

只要明白了PIN 设备模型原理，使用起来还是很简单的，我们先看一下原理图：

程序如下，测试OK，太简单所以没有什么好说的：

...
//添加这两个头文件
#include <rtdevice.h>
#include "board.h"
...

static struct rt_thread led1_thread;    //led1线程
static char led1_thread_stack[256];

static rt_thread_t key1_thread = RT_NULL; //

#define LED1_PIN        GET_PIN(D,  9)
#define LED2_PIN        GET_PIN(D,  8)
#define KEY1_PIN        GET_PIN(D,  11)
#define KEY2_PIN        GET_PIN(D,  10)

#define key1_read   rt_pin_read(KEY1_PIN)
#define LED1_ON     rt_pin_write(LED1_PIN, PIN_LOW);
#define LED1_OFF    rt_pin_write(LED1_PIN, PIN_HIGH);
#define LED2_ON     rt_pin_write(LED2_PIN, PIN_LOW);
#define LED2_OFF    rt_pin_write(LED2_PIN, PIN_HIGH);
//#define LED0(n) (n ? rt_pin_write(LED0_PIN, PIN_HIGH) : rt_pin_write(LED0_PIN, PIN_LOW))

static void led1_thread_entry(void *par){
    while(1){
        LED1_ON;
        rt_thread_mdelay(1000);
        LED1_OFF;
        rt_thread_mdelay(1000);
    }
}

static void key1_thread_entry(void *par){
    while(1){
        if(key1_read == 0){
            rt_thread_mdelay(10); //去抖动
            if(key1_read == 0){
                rt_kprintf("key1 kicked..\r\n");
             }
             while(key1_read == 0){rt_thread_mdelay(10);//去抖动
            }
        }
        rt_thread_mdelay(1);
   }
}

int main(void)
{

    MX_USART1_UART_Init();
    //    MX_GPIO_Init();  //使用设备模型不需要初始化这个
    /*配置LED管脚为输出*/
    rt_pin_mode(LED1_PIN, PIN_MODE_OUTPUT);
    rt_pin_mode(LED2_PIN, PIN_MODE_OUTPUT);
    /*配置按键为输入*/
    rt_pin_mode(KEY1_PIN, PIN_MODE_INPUT);
    rt_pin_mode(KEY2_PIN, PIN_MODE_INPUT);
    /*LED默认状态*/
    rt_pin_write(LED1_PIN, 1);
    rt_pin_write(LED2_PIN, 0);
    
	rt_err_t rst2;
    rst2 = rt_thread_init(&led1_thread,
                        "led1_blink ",
                        led1_thread_entry,
                        RT_NULL,
                        &led1_thread_stack[0],
                        sizeof(led1_thread_stack),
                        RT_THREAD_PRIORITY_MAX -1,
                        50);

    if(rst2 == RT_EOK){
        rt_thread_startup(&led1_thread);
    }
    
    key1_thread = rt_thread_create("key1_control",
                                key1_thread_entry,
                                RT_NULL,
                                512,
                                RT_THREAD_PRIORITY_MAX -2,
                                50);

        /* 如果获得线程控制块，启动这个线程 */
        if (key1_thread != RT_NULL)
            rt_thread_startup(key1_thread);
  
  ...//后面省略

结语

本文我们详细的分析了 RT-Thread I/O 设备模型之PIN设备，最终看来，使用 PIN 设备模型操作还是特别的简单的。

其实关键的部分还是在于理解 PIN 设备模型的原理，理解了以后使用起来也更加的得心应手。