Input Polling

该示例使用 GPIO 输入功能，轮询检测 GPIO 的输入信号。

需要将 GPIO 配置为输入模式，并在 while 循环中实时打印输入电平状态。

用户可以通过不同的宏配置来修改引脚信息。具体宏配置详见配置选项。

环境需求

该示例的环境需求，可参考环境需求。

硬件连线

连接 P1_0 和 VDDIO 检测输入高电平。连接 P1_0 和 GND 检测输入低电平。

备注

VDDIO 的连接可参考评估板指南中 IC供电电压选择的说明进行连接。

配置选项

可配置如下宏修改引脚定义。
```
#define INPUT_PIN           P1_0
```

编译和下载

该示例的编译和下载流程，可参考编译和下载。

测试验证

当 EVB 启动后，在 Debug Analyzer 工具内观察如下 log。
```
Start input polling test!
```
当检测 GPIO 输入高电平时，每隔大约 2s 在 Debug Analyzer 工具内打印如下信息。
```
gpio_input_data = 1
gpio_input_data = 1
gpio_input_data = 1
...
```
当检测 GPIO 输入低电平时，每隔大约 2s 在 Debug Analyzer 工具内打印如下信息。
```
gpio_input_data = 0
gpio_input_data = 0
gpio_input_data = 0
...
```

代码介绍

该章节主要介绍示例中的初始化和相应功能实现的代码和流程说明。

源码路径

工程文件和源码路径如下：

工程路径: sdk\samples\peripheral\gpio\input_polling\proj
源码路径: sdk\samples\peripheral\gpio\input_polling\src

初始化

外设的初始化流程可参考 General Introduction 中的初始化流程部分。

调用 Pad_Config() 与 Pinmux_Config()，配置对应引脚的 PAD 和 PINMUX 。

void board_gpio_init(void)
{
    Pad_Config(INPUT_PIN, PAD_PINMUX_MODE, PAD_IS_PWRON, PAD_PULL_NONE, PAD_OUT_ENABLE, PAD_OUT_HIGH);

    Pinmux_Config(INPUT_PIN, DWGPIO);
}

调用 RCC_PeriphClockCmd() ，开启 GPIO 时钟。
对 GPIO 外设进行初始化:
1. 定义 GPIO_InitTypeDef 类型 GPIO_InitStruct ，调用 GPIO_StructInit() 将 GPIO_InitStruct 预填默认值。
2. 根据需求修改 GPIO_InitStruct 参数，GPIO 的初始化参数配置如下表。调用 GPIO_Init()，初始化 GPIO 外设。

GPIO 初始化参数
GPIO Hardware Parameters	Setting in the `GPIO_InitStruct`	GPIO
GPIO pin	`GPIO_InitTypeDef::GPIO_Pin`	`GPIO_PIN`
GPIO direction	`GPIO_InitTypeDef::GPIO_Dir`	`GPIO_DIR_IN`
GPIO interrupt	`GPIO_InitTypeDef::GPIO_ITCmd`	`DISABLE`

功能实现

初始化后执行 while 循环，循环体内调用 GPIO_ReadInputDataBit() 函数，获取并打印读取到的输入电平信息。

while (1)
{
   uint8_t gpio_input_data = GPIO_ReadInputDataBit(GPIO_PORT, GPIO_PIN);
   DBG_DIRECT("gpio_input_data = %d", gpio_input_data);
   platform_delay_ms(2000);
}