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