我相信大多數(shù)學習嵌入式的朋友學習單片機的第一個程序都是點燈，畢竟點燈簡單嘛，操作下GPIO即可。當然，本教程的第一個應用也從GPIO的使用開始。

1 RT-Thread PIN設備驅動簡介

RT-Thread 提供了一套簡單的 I/O 設備模型框架，如下圖所示。

它位于硬件和應用程序之間，共分成三層，從上到下分別是 I/O 設備管理層、設備驅動框架層、設備驅動層。

應用程序通過 I/O 設備管理接口獲得正確的設備驅動，然后通過這個設備驅動與底層 I/O 硬件設備進行數(shù)據(jù)（或控制）交互。關于I/O模型的詳細描述請參看RT-Thread官方手冊。

I/O設備模型：

https://www.rt-thread.org/document/site/#/rt-thread-version/rt-thread-standard/programming-manual/device/device

PIN設備屬于Miscellaneous類型，在驅動文件pin.c中的rt_device_pin_register()函數(shù)可以看到其注冊的設備類型，PIN設備是很多驅動的基礎，其他驅動的開發(fā)還會依賴PIN設備，比如軟件I2C的驅動就是在PIN設備的基礎上開發(fā)的。

應用程序通過 RT-Thread 提供的 PIN 設備管理接口來訪問 GPIO，相關接口如下所示：

關于PIN驅動API的詳細描述請參看以下內容：

https://www.rt-thread.org/document/site/#/rt-thread-version/rt-thread-standard/programming-manual/device/pin/pin

2 PIN設備使用實例之按鍵

筆者這里使用的是EK-RA6E2開發(fā)板，MCU資源很豐富，但是板載資源較少。EK-RA6E2開發(fā)板的用戶LED已經在主線程中使用了，因此這里就用戶按鍵來舉例說明如何使用PIN設備。

2.1 硬件電路

首先看下電路圖：

[]()Figure ? 按鍵電路

當然不同開發(fā)板，其引腳可能不同，請根據(jù)具體情況使用。由以上電路圖可以看到，當P304輸入低電平，表示按鍵按下，反之亦然。

2.2 按鍵實現(xiàn)

核心代碼如下：

#define KEY_PIN    BSP_IO_PORT_03_PIN_04 /* Onboard LED3 pins */

/* 按鍵檢測線程入口函數(shù)*/
static void key_thread_entry(void *parameter)
{
    static rt_uint8_t key_up = 1;   /* 按鍵松開標志 */

    /* 初始化按鍵 */
    rt_pin_mode(KEY_PIN, PIN_MODE_INPUT);

    while (1)
    {
        /* 檢測按鍵是否按下 */
        if (key_up && (rt_pin_read(KEY_PIN) == PIN_LOW) )
        {
            rt_thread_mdelay(50);   /* 延時消抖*/
            key_up = 0;

            if (rt_pin_read(KEY_PIN) == PIN_LOW)
            {
                /* 按鍵KEY按下，按鍵按下處理*/
                rt_kprintf("KEY pressed!n");
            }
        }
        else if((rt_pin_read(KEY_PIN) == PIN_HIGH) )
        {
            key_up = 1;     /* 按鍵已松開 */
        }
        rt_thread_mdelay(100);
    }
}

/* 線程初始化*/
int key_init(void)
{
    /* 創(chuàng)建線程，名稱是 key_thread，入口是 key_thread*/
    rt_thread_t key_tid= RT_NULL;
    key_tid = rt_thread_create( "gpio",
                             key_thread_entry,
                             RT_NULL,
                             1024,
                             3,
                             10);
    /* 如果獲得線程控制塊，啟動這個線程 */
    if(key_tid == RT_NULL)
    {
        rt_kprintf("Thread_gpio ERROR");
        return RT_ERROR;
    }
    else
    {
        rt_thread_startup(key_tid);
        return RT_EOK;
    }
}

/* 導出到 msh 命令列表中 */
MSH_CMD_EXPORT(key_init, key init);

構建并下載程序，并使用msh 命令初始化KEY線程，按下按鍵，則可以看到串口終端輸出以下信息：

當然啦，在finsh輸入list device可以查到注冊到RT-Thread的PIN設備：