ESP32 GPIO函数相关介绍

ESP32 GPIO函数库介绍

函数名称	参数类型	返回值	主要功能	注：
gpio_config	gpio_config_t*	返回ESP_OK或者ESP_ERR_INVALID_ARG参数错误	初始化GPIO
gpio_reset_pin	gpio_num_t	总是返回ESP_OK	将GPIO设置为默认状态，使能上拉同时关闭输入输出功能。常用于关闭ESP32与外设的连接
gpio_set_intr_type	gpio_num_t 和gpio_int_type_t	返回ESP_OK或者ESP_ERR_INVALID_ARG参数错误	设置GPIO中断触发类型，例如上升沿或下降沿等触发。
gpio_intr_enable	gpio_num_t	返回ESP_OK或者ESP_ERR_INVALID_ARG参数错误	使能GPIO中断功能
gpio_intr_disable	gpio_num_t	返回ESP_OK或者ESP_ERR_INVALID_ARG参数错误	关闭GPIO中断功能
gpio_set_level	gpio_num_t和uint32_t level。0为低电平，1为高电平。	返回ESP_OK或者ESP_ERR_INVALID_ARG参数错误	设置GPIO的输出电平的高低
gpio_get_level	gpio_num_t	int	获得GPIO当前电平高低状态，返回值为0或1.当引脚未被初始化为输入或输出状态时总是返回0.
gpio_set_direction	gpio_num_t和gpio_mode_t	返回ESP_OK或者ESP_ERR_INVALID_ARG参数错误	设置GPIO的数据流通方向，例如仅输入、仅输出、输入和输出。
gpio_set_pull_mode	gpio_num_t和gpio_pull_mode_t	返回ESP_OK或者ESP_ERR_INVALID_ARG参数错误	设置GPIO为上拉或下拉模式，仅适用于同时具有输入和输出功能的引脚，仅仅具有输入功能的引脚34-39不可以使用本函数进行配置。
gpio_wakeup_enable	gpio_num_t和gpio_int_type_t	返回ESP_OK或者ESP_ERR_INVALID_ARG参数错误	使能GPIO唤醒函数，仅支持高电平或低电平唤醒。
gpio_wakeup_disable	gpio_num_t和gpio_int_type_t	返回ESP_OK或者ESP_ERR_INVALID_ARG参数错误	关闭GPIO唤醒功能。
gpio_isr_register	fn函数指针，arg参数，intr_alloc_flags，gpio_isr_handle_t *handle中断函数执行后的返回地址。	返回ESP_OK，ESP_ERR_INVALID_ARG参数错误，ESP_ERR_NOT_FOUND没有中断发现错误	统一为所有GPIO注册一个中断服务函数，任何GPIO中断都会调用此函数。
gpio_pullup_en	gpio_num_t	返回ESP_OK或者ESP_ERR_INVALID_ARG参数错误	使能GPIO上拉功能
gpio_pullup_dis	gpio_num_t	返回ESP_OK或者ESP_ERR_INVALID_ARG参数错误	关闭GPIO上拉功能
gpio_pulldown_en	gpio_num_t	返回ESP_OK或者ESP_ERR_INVALID_ARG参数错误	开启GPIO下拉功能
gpio_pulldown_dis	gpio_num_t	返回ESP_OK或者ESP_ERR_INVALID_ARG参数错误	关闭GPIO下拉功能
gpio_install_isr_service	intr_alloc_flags用于给中断赋予权限	返回ESP_OK，ESP_ERR_INVALID_ARG参数错误等	开启中断服务程序，与gpio_isr_handler_add()配合使用，与gpio_isr_register()不兼容。
gpio_uninstall_isr_service	void	void	卸载ISR服务，释放相关资源。
gpio_isr_handler_add	gpio_num_t，gpio_isr_t isr_handler中断服务函数，void *args函数的参数	ESP_ERR_INVALID_STATE中断未被初始化，ESP_OK或者ESP_ERR_INVALID_ARG参数错误	给相应GPIO添加对应的中断服务程序，
gpio_isr_handler_remove	gpio_num_t	ESP_ERR_INVALID_STATE中断未被初始化，ESP_OK或者ESP_ERR_INVALID_ARG参数错误	为单个GPIO关闭中断服务程序
gpio_set_drive_capability	gpio_num_t和gpio_drive_cap_t	返回ESP_OK，ESP_ERR_INVALID_ARG参数错误	为GPIO配置驱动能力，仅支持配置为输出模式的引脚。
gpio_get_drive_capability	gpio_num_t，gpio_drive_cap_t *指针	返回ESP_OK，ESP_ERR_INVALID_ARG参数错误	获得单个引脚的驱动能力信息
gpio_hold_en	gpio_num_t	返回ESP_OK，ESP_ERR_INVALID_ARG参数错误	引脚状态保持使能，适用于输入和输出，使能后引脚状态强制锁定，高低电平状态不受外界影响。深度睡眠模式下无法使用此功能。
gpio_hold_dis	gpio_num_t	返回ESP_OK，ESP_ERR_INVALID_ARG参数错误	关闭引脚状态锁定功能，
gpio_deep_sleep_hold_en	void	void	使能深度睡眠状态下依然可以使用引脚状态锁定功能，gpio_hold_dis()函数可以关闭此功能。
gpio_deep_sleep_hold_dis	void	void	关闭深度睡眠状态下依然可以使用引脚状态锁定的功能
gpio_iomux_in	gpio_num和signal_idx信号ID，可在soc/gpio_sig_map.h中查询	void	通过IO交换矩阵使引脚与内部外设相连接，仅可将引脚设置为外设的输入接口
gpio_iomux_out	gpio_num，int func（外设功能号可在soc/io_mux_reg.h中查看）和bool oen_inv当需要反转输出是设置为True	void	通过交换矩阵将GPIO引脚设置为外设的输出接口
gpio_force_hold_all	void	esp_err_t	强制保持引脚数字状态
gpio_force_unhold_all	void	esp_err_t	解除引脚保持状态
gpio_sleep_sel_en	gpio_num_t	ESP_OK	启用SLP_SEL在lightsleep中自动更改GPIO状态。
gpio_sleep_sel_dis	gpio_num_t	ESP_OK	关闭SLP_SEL在lightsleep中自动更改GPIO状态。
gpio_sleep_set_direction	gpio_num_t和gpio_mode_t	返回ESP_OK，ESP_ERR_INVALID_ARG参数错误	在睡眠状态设置引脚的数据输送方向
gpio_sleep_set_pull_mode	gpio_num_t和gpio_pull_mode_t	返回ESP_OK，ESP_ERR_INVALID_ARG参数错误	在睡眠状态下设置引脚为上拉或下拉
gpio_deep_sleep_wakeup_enable	gpio_num_t和gpio_int_type_t中断类型	返回ESP_OK，ESP_ERR_INVALID_ARG参数错误	使能GPIO深度睡眠状态下唤醒函数，用户无法在APP中使用，由SDK调用。
gpio_deep_sleep_wakeup_disable	gpio_num_t	返回ESP_OK，ESP_ERR_INVALID_ARG参数错误	关闭深度睡眠状态下的唤醒函数