目標

測試 ARTPI 上和 pin 有關的這些接口：

rt_pin_get() 獲取引腳編號
rt_pin_mode() 設置引腳模式
rt_pin_write() 設置引腳電平
rt_pin_read() 讀取引腳電平
rt_pin_attach_irq() 綁定引腳中斷回調函數
rt_pin_irq_enable() 使能引腳中斷
rt_pin_detach_irq() 脫離引腳中斷回調函數

接線

根據 ARTPI 引腳圖：

我們選擇 PC6、PC7 兩個引腳，PC7 輸出，PC6 輸入下拉。用一根杜邦線將兩個引腳連接起來。

PC7 每隔半秒鐘切換一次高低電平，PC6 設置成上升沿中斷。同時每隔一秒切換一次中斷使能狀況。這樣每過2秒鐘就會觸發執行中斷回調函數。

代碼

// main.c
#include
#include
#include "drv_common.h"
//#define PC7_PIN GET_PIN(C, 7)
//#define PC6_PIN GET_PIN(C, 6)
// 中斷回調函數
void pin_isr(void *args)
{
rt_uint32_t pin = (rt_uint32_t)args; // 獲取引腳編號
rt_kprintf("pin %d level is highn", pin); // 打印引腳電平狀態
}
int main(void)
{
rt_uint32_t count = 1;
int pc6 = rt_pin_get("PC.6");
int pc7 = rt_pin_get("PC.7");
rt_kprintf("pc6 is %dn", pc6);
rt_kprintf("pc7 is %dn", pc7);
rt_pin_mode(pc7, PIN_MODE_OUTPUT);
rt_pin_mode(pc6, PIN_MODE_INPUT_PULLDOWN);
rt_pin_attach_irq(pc6, PIN_IRQ_MODE_RISING, pin_isr, (void )pc6);
rt_pin_irq_enable(pc6, PIN_IRQ_ENABLE);
while (count ++) {
if (count % 2) rt_pin_irq_enable(pc6, PIN_IRQ_DISABLE);
else rt_pin_irq_enable(pc6, PIN_IRQ_ENABLE);
rt_thread_mdelay(500);
rt_pin_write(pc7, PIN_HIGH);
rt_thread_mdelay(500);
rt_pin_write(pc7, PIN_LOW);
}
return RT_EOK;
}
#include "stm32h7xx.h"
static int vtor_config(void)
{
/ Vector Table Relocation in Internal QSPI_FLASH */
SCB->VTOR = QSPI_BASE;
return 0;
}
INIT_BOARD_EXPORT(vtor_config);

運行結果

| /

RT - Thread Operating System
/ | 4.1.0 build Jun 9 2023 14:46:16
2006 - 2022 Copyright by RT-Thread team
pc6 is 38
pc7 is 39
msh />pin 38 level is high
pin 38 level is high
pin 38 level is high
pin 38 level is high
pin 38 level is high
pin 38 level is high
pin 38 level is high
(每隔2秒輸出一次 pin 38 level is high)
至此，RT-Thread 中 PIN 的所有接口都已經測試完畢。

utest 自動測試

在 application 目錄下新建一個 pin_tc.c 文件，內容如下：

/*

Copyright (c) 2006-2023, RT-Thread Development Team

SPDX-License-Identifier: Apache-2.0

Change Logs:
Date Author Notes
2023-06-09 IcyFeather the first version
*/
#include
#include
#include "drv_common.h"
#include "utest.h"
// 中斷回調函數
void pin_isr(void *args)
{
rt_uint32_t pin = (rt_uint32_t)args; // 獲取引腳編號
uassert_int_equal(pin, 38);
uassert_int_equal(rt_pin_read(38), PIN_HIGH);
}
static void test_rt_pin(void)
{
int pc6 = rt_pin_get("PC.6");
int pc7 = rt_pin_get("PC.7");
uassert_int_equal(pc6, 38);
uassert_int_equal(pc7, 39);
rt_pin_mode(pc7, PIN_MODE_OUTPUT);
rt_pin_mode(pc6, PIN_MODE_INPUT_PULLDOWN);
rt_pin_attach_irq(pc6, PIN_IRQ_MODE_RISING, pin_isr, (void *)pc6);
rt_pin_irq_enable(pc6, PIN_IRQ_ENABLE);
rt_pin_write(pc7, PIN_HIGH);
uassert_int_equal(rt_pin_read(pc6), PIN_HIGH);
rt_pin_write(pc7, PIN_LOW);
uassert_int_equal(rt_pin_read(pc6), PIN_LOW);
}
static rt_err_t utest_tc_init(void)
{
return RT_EOK;
}
static rt_err_t utest_tc_cleanup(void)
{
return RT_EOK;
}
static void testcase(void)
{
UTEST_UNIT_RUN(test_rt_pin);
}
UTEST_TC_EXPORT(testcase, "pin_tc", utest_tc_init, utest_tc_cleanup, 10);

編譯下載，在 finsh 中運行 utest_run：

最后顯示 PASSED 即為測試通過。