1# BearPi-HM_Nano开发板基础外设开发——GPIO输入 2本示例将演示如何在BearPi-HM_Nano开发板上使用GPIO输入功能去读取按键状态。 3 4## GPIO API分析 5本案例主要使用了以下几个API完成GPIO输入功能。 6### IoTGpioInit() 7```c 8unsigned int IoTGpioInit(unsigned int id); 9``` 10 **描述：** 11 12初始化GPIO外设。 13 14**参数：** 15 16|参数名|描述| 17|:--|:------| 18| id | 表示GPIO引脚号。 | 19 20### IoTGpioSetFunc() 21```c 22unsigned int IoTGpioSetFunc(unsigned int id, unsigned char val); 23``` 24**描述：** 25 26设置GPIO引脚复用功能。 27 28**参数：** 29 30|参数名|描述| 31|:--|:------| 32| id | 表示GPIO引脚号。 | 33| val | 表示GPIO复用的功能。 | 34 35### IoTGpioSetDir() 36```c 37unsigned int IoTGpioSetDir(unsigned int id, IotGpioDir dir); 38``` 39**描述：** 40 41设置GPIO输出方向。 42 43**参数：** 44 45|参数名|描述| 46|:--|:------| 47| id | 表示GPIO引脚号。 | 48| dir | 表示该GPIO用作输入还是输出。 | 49 50 51### IoTGpioSetPull() 52```c 53unsigned int IoTGpioSetPull(unsigned int id, IotGpioPull val); 54``` 55**描述：** 56 57设置GPIO的上下拉方式。 58 59**参数：** 60 61|参数名|描述| 62|:--|:------| 63| id | 表示GPIO引脚号。 | 64| val | 表示设置该GPIO为上拉或下拉。 | 65 66 67### IoTGpioRegisterIsrFunc() 68```c 69unsigned int IoTGpioRegisterIsrFunc(unsigned int id, IotGpioIntType intType, IotGpioIntPolarity intPolarity, GpioIsrCallbackFunc func, char *arg); 70``` 71**描述：** 72 73启用GPIO引脚的中断功能。这个函数可以用来为GPIO pin设置中断类型、中断极性和中断回调。 74 75**参数：** 76 77|参数名|描述| 78|:--|:------| 79| id | 表示GPIO引脚号。 | 80| intType| 表示中断类型。 | 81| intPolarity| 表示中断极性。 | 82| func| 表示中断回调函数。 | 83| arg| 表示中断回调函数中使用的参数的指针。 | 84 85 86## 硬件设计 87本案例将使用板载的两个用户按键来验证GPIO的输入功能，在BearPi-HM_Nano开发板上用户按键的连接电路图如下图所示，按键F1的检测引脚与主控芯片的GPIO_11连接，按键F2的检测引脚与主控芯片的GPIO_12连接，所以需要编写软件去读取GPIO_11和GPIO_12的电平值，判断按键是否被按下。 88 89 90 91## 软件设计 92 93**主要代码分析** 94 95这部分代码主要分析按键触发中断的功能代码，这里以按键F1为例，按键F1的检测引脚与主控芯片的GPIO_11连接，首先通过调用IoTGpioSetFunc()和IoTGpioSetDir()将GPIO_11设置为普通GPIO的输入模式。从前面原理图可知，当按键按下时，GPIO_11会被下拉到地，所以这里要使用IoTGpioSetPull()将GPIO_11引脚设置为上拉，这样才能产生电平的跳变。最后通过IoTGpioRegisterIsrFunc()将中断类型设置为边沿触发，且为下降沿触发，当按键被按下时，GPIO_11会从高电平转为低电平，产生一个下降，这个时候就会触发中断并回调F1_Pressed函数。在F1_Pressed函数中实现点亮LED灯操作。 96```c 97/** 98* @brief Callback for F1 key 99* 100*/ 101static void F1Pressed(char *arg) 102{ 103 (void)arg; 104 IoTGpioSetOutputVal(LED_GPIO, 1); 105} 106 107/** 108* @brief Callback for F2 key 109* 110*/ 111static void F2Pressed(char *arg) 112{ 113 (void)arg; 114 IoTGpioSetOutputVal(LED_GPIO, 0); 115} 116 117/** 118 * @brief Main Entry of the Button Example 119 * 120 */ 121static void ButtonExampleEntry(void) 122{ 123 //init gpio of LED 124 IoTGpioInit(LED_GPIO); 125 IoTGpioSetDir(LED_GPIO, IOT_GPIO_DIR_OUT); 126 127 //init gpio of F1 key and set it as the falling edge to trigger interrupt 128 IoTGpioInit(BUTTON_F1_GPIO); 129 IoTGpioSetDir(BUTTON_F1_GPIO, IOT_GPIO_DIR_IN); 130 IoTGpioSetPull(BUTTON_F1_GPIO, IOT_GPIO_PULL_UP); 131 IoTGpioRegisterIsrFunc(BUTTON_F1_GPIO, IOT_INT_TYPE_EDGE, IOT_GPIO_EDGE_FALL_LEVEL_LOW, F1Pressed, NULL); 132 133 //init gpio of F2 key and set it as the falling edge to trigger interrupt 134 IoTGpioInit(BUTTON_F2_GPIO); 135 IoTGpioSetDir(BUTTON_F2_GPIO, IOT_GPIO_DIR_IN); 136 IoTGpioSetPull(BUTTON_F2_GPIO, IOT_GPIO_PULL_UP); 137 IoTGpioRegisterIsrFunc(BUTTON_F2_GPIO, IOT_INT_TYPE_EDGE, IOT_GPIO_EDGE_FALL_LEVEL_LOW, F2Pressed, NULL); 138} 139``` 140 141## 编译调试 142 143### 修改 BUILD.gn 文件 144 145 146修改`device\board\bearpi\bearpi_hm_nano\app` 路径下 BUILD.gn 文件，指定 `button_example` 参与编译。 147 148```r 149#"B1_basic_led_blink:led_example", 150"B2_basic_button:button_example", 151#"B3_basic_pwm_led:pwm_example", 152#"B4_basic_adc:adc_example", 153#"B5_basic_i2c_nfc:i2c_example", 154#"B6_basic_uart:uart_example", 155``` 156 157 158### 运行结果 159 160示例代码编译烧录后，按下开发板的RESET按键，开发板开始正常工作，按下F1按键LED会点亮，按下F2按键LED会熄灭。 161 162 163
