README.md
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
