二、ESP-IDF库函数之RTC GPIO

1. 函数rtc_gpio_is_valid_gpio

函数原型：static bool rtc_gpio_is_valid_gpio (gpio_num_t gpio_num)
功能描述：判断指定的GPIO是否为有效的RTC GPIO。
返回参数：如果该GPIO为RTC GPIO，则返回true；反之，返回false。
输入参数：gpio_num，GPIO引脚编号（例如可取GPIO_NUM_12）。

2. 函数rtc_gpio_init

函数原型：esp_err_t rtc_gpio_init (gpio_num_t gpio_num)
功能描述：将GPIO初始化为RTC GPIO。初始化模拟功能的引脚时必须调用此函数。
返回参数：ESP_OK 成功；ESP_ERR_INVALID_ARG 该GPIO不是RTC IO。
输入参数：gpio_num，GPIO引脚编号（例如可取GPIO_NUM_12）。

3. 函数rtc_gpio_deinit

函数原型：esp_err_t rtc_gpio_deinit (gpio_num_t gpio_num)
功能描述：将GPIO初始化为数字GPIO。
返回参数：ESP_OK 成功；ESP_ERR_INVALID_ARG 该GPIO不是RTC IO。
输入参数：gpio_num，GPIO引脚编号（例如可取GPIO_NUM_12）。

4. 函数rtc_gpio_get_level

函数原型：uint32_t rtc_gpio_get_level (gpio_num_t gpio_num)
功能描述：获取RTC IO输入电平。
返回参数：可能的返回参数如下表所示。

函数返回值	描述
1	高电平
0	低电平
ESP_ERR_INVALID_ARG	该GPIO不是RTC IO

输入参数：gpio_num，GPIO引脚编号（例如可取GPIO_NUM_12）。

5. 函数rtc_gpio_set_level

函数原型：esp_err_t rtc_gpio_set_level (gpio_num_t gpio_num, uint32_t level)
功能描述：设置RTC IO输出电平。
返回参数：ESP_OK 成功；ESP_ERR_INVALID_ARG 该GPIO不是RTC IO。
输入参数1：gpio_num，GPIO引脚编号（例如可取GPIO_NUM_12）。
输入参数2：level，输出电平高低。

6. 函数rtc_gpio_set_direction

函数原型：esp_err_t rtc_gpio_set_direction (gpio_num_t gpio_num, rtc_gpio_mode_t mode)
功能描述：配置RTC GPIO方向，例如仅输出、仅输入、输出和输入。
返回参数：ESP_OK 成功；ESP_ERR_INVALID_ARG 该GPIO不是RTC IO。
输入参数1：gpio_num，GPIO引脚编号（例如可取GPIO_NUM_12）。
输入参数2：mode，引脚模式，其可选值如下图所示。

mode可取的值	描述
RTC_GPIO_MODE_INPUT_ONLY	仅输入
RTC_GPIO_MODE_OUTPUT_ONLY	仅输出
RTC_GPIO_MODE_INPUT_OUTUT	输入+输出
RTC_GPIO_MODE_DISABLED	禁用输入输出

7. 函数rtc_gpio_pullup_en

函数原型：esp_err_t rtc_gpio_pullup_en (gpio_num_t gpio_num)
功能描述：RTC GPIO启用上拉。此功能仅适用于RTC IO。通常更多调用gpio_pullup_en，其对普通GPIO和RTC IO均适用。
返回参数：ESP_OK 成功；ESP_ERR_INVALID_ARG 该GPIO不是RTC IO。
输入参数：gpio_num，GPIO引脚编号（例如可取GPIO_NUM_12）。

8. 函数rtc_gpio_pulldown_en

函数原型：esp_err_t rtc_gpio_pulldown_en (gpio_num_t gpio_num)
功能描述：RTC GPIO启用下拉。此功能仅适用于RTC IO。通常更多调用gpio_pulldown_en，其对普通GPIO和RTC IO均适用。
返回参数：ESP_OK 成功；ESP_ERR_INVALID_ARG 该GPIO不是RTC IO。
输入参数：gpio_num，GPIO引脚编号（例如可取GPIO_NUM_12）。

9. 函数rtc_gpio_pullup_dis

函数原型：esp_err_t rtc_gpio_pullup_dis (gpio_num_t gpio_num)
功能描述：RTC GPIO关闭上拉。此功能仅适用于RTC IO。通常更多调用gpio_pullup_dis，其对普通GPIO和RTC IO均适用。
返回参数：ESP_OK 成功；ESP_ERR_INVALID_ARG 该GPIO不是RTC IO。
输入参数：gpio_num，GPIO引脚编号（例如可取GPIO_NUM_12）。

10. 函数rtc_gpio_pulldown_dis

函数原型：esp_err_t rtc_gpio_pulldown_dis (gpio_num_t gpio_num)
功能描述：RTC GPIO关闭下拉。此功能仅适用于RTC IO。通常更多调用gpio_pulldown_dis，其对普通GPIO和RTC IO均适用。
返回参数：ESP_OK 成功；ESP_ERR_INVALID_ARG 该GPIO不是RTC IO。
输入参数：gpio_num，GPIO引脚编号（例如可取GPIO_NUM_12）。

参考链接: ESP-IDF 编程指南API»参考 » 外设 API » GPIO & RTC GPIO.