ESP32 学习日志（7）——GPIO应用

---

一、应用简介

用户可以通过ESP32提供的API来使用GPIO。本文介绍ESP32中的GPIO输出以及中断。

二、GPIO输出

/*******************************************
 * INCLUDES
 */
#include "driver/gpio.h"
#include "esp_log.h"

/*******************************************
 * LOCAL VARIABLES
 */
static const char *s_relayTag = "root_relay_service";										// 打印标识
/*******************************************
 * DEFINITIONS
 */
// 一个设备由2个继电器控制,这里将继电器分组,每组2个继电器
#define GROUP0_RELAY1_IO    	18
#define GROUP0_RELAY1_PIN_SEL  	(1<<GROUP0_RELAY1_IO)//配置gpioout位寄存器

#define GROUP0_RELAY2_IO    	19
#define GROUP0_RELAY2_PIN_SEL  	(1<<GROUP0_RELAY2_IO)//配置gpioout位寄存器

#define GROUP1_RELAY1_IO    	4
#define GROUP1_RELAY1_PIN_SEL  	(1<<GROUP1_RELAY1_IO)//配置gpioout位寄存器

#define GROUP1_RELAY2_IO    	27
#define GROUP1_RELAY2_PIN_SEL  	(1<<GROUP1_RELAY2_IO)//配置gpioout位寄存器

/*******************************************
 * PUBLIC FUNCTIONS
 */
/**
 @brief 继电器初始化
 @param 无
 @return 无
*/
void RelayGpioInit(void)
{
	gpio_config_t io_conf;
	// 定义一个gpio_config类型的结构体，下面的都算对其进行的配置
	// disable interrupt
	io_conf.intr_type = GPIO_PIN_INTR_DISABLE;
	// set as output mode
	io_conf.mode = GPIO_MODE_OUTPUT;
	//bit mask of the pins that you want to set,e.g.GPIO18/19
	io_conf.pin_bit_mask = GROUP0_RELAY1_PIN_SEL;
	// disable pull-down mode
	io_conf.pull_down_en = 0;
	// disable pull-up mode
	io_conf.pull_up_en = 0;
	// configure GPIO with the given settings
	gpio_config(&io_conf);
	// 默认输出高，继电器关
	gpio_set_level(GROUP0_RELAY1_IO, 0);


	gpio_config_t io_conf1;
	// 定义一个gpio_config类型的结构体，下面的都算对其进行的配置
	// disable interrupt
	io_conf1.intr_type = GPIO_PIN_INTR_DISABLE;
	// set as output mode
	io_conf1.mode = GPIO_MODE_OUTPUT;
	//bit mask of the pins that you want to set,e.g.GPIO18/19
	io_conf1.pin_bit_mask = GROUP0_RELAY2_PIN_SEL;
	// disable pull-down mode
	io_conf1.pull_down_en = 0;
	// disable pull-up mode
	io_conf1.pull_up_en = 0;
	// configure GPIO with the given settings
	gpio_config(&io_conf1);
	// 默认输出高，继电器关
	gpio_set_level(GROUP0_RELAY2_IO, 0);

	gpio_config_t io_conf2;
	// 定义一个gpio_config类型的结构体，下面的都算对其进行的配置
	// disable interrupt
	io_conf2.intr_type = GPIO_PIN_INTR_DISABLE;
	// set as output mode
	io_conf2.mode = GPIO_MODE_OUTPUT;
	//bit mask of the pins that you want to set,e.g.GPIO4/27
	io_conf2.pin_bit_mask = GROUP1_RELAY1_PIN_SEL;
	// disable pull-down mode
	io_conf2.pull_down_en = 0;
	// disable pull-up mode
	io_conf2.pull_up_en = 0;
	// configure GPIO with the given settings
	gpio_config(&io_conf2);
	// 默认输出高，继电器关
	gpio_set_level(GROUP1_RELAY1_IO, 0);

	gpio_config_t io_conf3;
	// 定义一个gpio_config类型的结构体，下面的都算对其进行的配置
	// disable interrupt
	io_conf3.intr_type = GPIO_PIN_INTR_DISABLE;
	// set as output mode
	io_conf3.mode = GPIO_MODE_OUTPUT;
	//bit mask of the pins that you want to set,e.g.GPIO4/27
	io_conf3.pin_bit_mask = GROUP1_RELAY2_PIN_SEL;
	// disable pull-down mode
	io_conf3.pull_down_en = 0;
	// disable pull-up mode
	io_conf3.pull_up_en = 0;
	// configure GPIO with the given settings
	gpio_config(&io_conf3);
	// 默认输出高，继电器关
	gpio_set_level(GROUP1_RELAY2_IO, 0);
}

/**
 @brief 继电器状态设置
 @param relayStatus -[in] 状态值(每一位代表一个继电器,低四位有效)
 @return 无
*/
void SetRelayStatus(uint8_t relayStatus)
{
	if((relayStatus & 0x01) == 0)
	{
		gpio_set_level(GROUP0_RELAY1_IO, 0);
	}
	else
	{
		gpio_set_level(GROUP0_RELAY1_IO, 1);
	}
	ESP_LOGI(s_relayTag, "GROUP0_RELAY1_IO:%x", (relayStatus & 0x01));
	
	if((relayStatus & 0x02) == 0)
	{
		gpio_set_level(GROUP0_RELAY2_IO, 0);
	}
	else
	{
		gpio_set_level(GROUP0_RELAY2_IO, 1);
	}
	ESP_LOGI(s_relayTag, "GROUP0_RELAY2_IO:%x", (relayStatus & 0x02));

	if((relayStatus & 0x04) == 0)
	{
		gpio_set_level(GROUP1_RELAY1_IO, 0);
	}
	else
	{
		gpio_set_level(GROUP1_RELAY1_IO, 1);
	}
	ESP_LOGI(s_relayTag, "GROUP1_RELAY1_IO:%x", (relayStatus & 0x04));

	if((relayStatus & 0x08) == 0)
	{
		gpio_set_level(GROUP1_RELAY2_IO, 0);
	}
	else
	{
		gpio_set_level(GROUP1_RELAY2_IO, 1);
	}
	ESP_LOGI(s_relayTag, "GROUP1_RELAY2_IO:%x", (relayStatus & 0x08));
}

三、GPIO输入

/*********************************************************************
 * INCLUDES
 */
#include <stdio.h>
#include <string.h>
#include <stdlib.h>
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "freertos/queue.h"
#include "driver/gpio.h"
#include "esp_log.h"

/*********************************************************************
 * DEFINITIONS
 */
#define ESP_INTR_FLAG_DEFAULT 0
#define ROOT_KEY1_IO    	34
#define ROOT_KEY2_IO    	35
#define ROOT_KEY3_IO    	5
#define ROOT_KEY4_IO    	21
#define ROOT_KEY5_IO    	25
#define ROOT_KEY6_IO    	26

static void IRAM_ATTR keyIsrHandler(void* arg);
static void eliminateDitheringTimerCB(void *arg);
static void queueTask(void* arg);
/*********************************************************************
 * LOCAL VARIABLES
 */
static const char *s_keyTag = "key_service";
// 定义一个队列返回变量 
static xQueueHandle s_gpioEvtQueue = NULL;
static uint32_t s_gpioNum = 0;

// 消抖定时器配置
static esp_timer_handle_t s_eliminateDitheringHandle = 0;
static esp_timer_create_args_t s_eliminateDitheringArg = 
{ 
	.callback = &eliminateDitheringTimerCB, 								// 设置回调函数
	.arg = NULL, 															// 不携带参数
	.name = "EliminateDitheringTimer" 										// 定时器名字
};

/*********************************************************************
 * PUBLIC FUNCTIONS
 */
/**
 @brief 按键中断初始化
 @param 无
 @return 无
*/
void KeyInit(void)
{
    gpio_config_t io_conf;

    //interrupt of rising edge
    io_conf.intr_type = GPIO_INTR_NEGEDGE;
    //bit mask of the pins
    io_conf.pin_bit_mask = ( (1ULL<<ROOT_KEY1_IO) | (1ULL<<ROOT_KEY2_IO) | (1ULL<<ROOT_KEY3_IO) | (1ULL<<ROOT_KEY4_IO) | (1ULL<<ROOT_KEY5_IO) | (1ULL<<ROOT_KEY6_IO));
    //set as input mode    
    io_conf.mode = GPIO_MODE_INPUT;
    //enable pull-down mode
    io_conf.pull_down_en = 0;
    io_conf.pull_up_en = 1;
    gpio_config(&io_conf);

    //change gpio intrrupt type for one pin
    gpio_set_intr_type(ROOT_KEY1_IO, GPIO_INTR_NEGEDGE);
	gpio_set_intr_type(ROOT_KEY2_IO, GPIO_INTR_NEGEDGE);
	gpio_set_intr_type(ROOT_KEY3_IO, GPIO_INTR_NEGEDGE);
	gpio_set_intr_type(ROOT_KEY4_IO, GPIO_INTR_NEGEDGE);
    gpio_set_intr_type(ROOT_KEY5_IO, GPIO_INTR_NEGEDGE);
	gpio_set_intr_type(ROOT_KEY6_IO, GPIO_INTR_NEGEDGE);

    //create a queue to handle gpio event from isr
    s_gpioEvtQueue = xQueueCreate(20, sizeof(uint32_t));
    //start gpio task
    xTaskCreate(queueTask, "queueTask", 4096, NULL, 3, NULL);

    //install gpio isr service
    gpio_install_isr_service(ESP_INTR_FLAG_DEFAULT);
    //hook isr handler for specific gpio pin
    gpio_isr_handler_add(ROOT_KEY1_IO, keyIsrHandler, (void*) ROOT_KEY1_IO);
	gpio_isr_handler_add(ROOT_KEY2_IO, keyIsrHandler, (void*) ROOT_KEY2_IO);
	gpio_isr_handler_add(ROOT_KEY3_IO, keyIsrHandler, (void*) ROOT_KEY3_IO);
	gpio_isr_handler_add(ROOT_KEY4_IO, keyIsrHandler, (void*) ROOT_KEY4_IO);
    gpio_isr_handler_add(ROOT_KEY5_IO, keyIsrHandler, (void*) ROOT_KEY5_IO);
	gpio_isr_handler_add(ROOT_KEY6_IO, keyIsrHandler, (void*) ROOT_KEY6_IO);

	// 创建消抖定时器
	esp_timer_create(&s_eliminateDitheringArg, &s_eliminateDitheringHandle);

}

/*********************************************************************
 * LOCAL FUNCTIONS
 */
 /**
 @brief 按键中断服务
 @param arg -[in] 任意参数
 @return 无
*/
static void IRAM_ATTR keyIsrHandler(void* arg)
{

	s_gpioNum = (uint32_t) arg;
	// 开消抖,单位:us
	esp_timer_start_once(s_eliminateDitheringHandle, 40 * 1000);

}

/**
 @brief 消抖回调
 @param arg -[in] 任意参数
 @return 无
*/
static void eliminateDitheringTimerCB(void *arg) 
{
	if(gpio_get_level(s_gpioNum) == 0)
	{
		//把中断消息插入到队列的后面，将gpio的io参数传递到队列中	
		xQueueSendFromISR(s_gpioEvtQueue, &s_gpioNum, NULL);
	}
}

/**
 @brief 任务函数
 @param arg -[in] 任意参数
 @return 无
*/
static void queueTask(void* arg)
{
    uint32_t io_num;
    for(;;) 
	{
        if(xQueueReceive(s_gpioEvtQueue, &io_num, portMAX_DELAY))
		{
			// 一个设备占用2个继电器(例如:KEY1~KEY3对应第0组的那个设备,此设备由继电器1、2控制)
			if(io_num == ROOT_KEY1_IO)
			{
				ESP_LOGI(s_keyTag,"GPIO[%d] intr, key[%d], val: %d\n", io_num, 1, gpio_get_level(io_num));
			}
			if(io_num == ROOT_KEY2_IO)
			{
				ESP_LOGI(s_keyTag,"GPIO[%d] intr, key[%d], val: %d\n", io_num, 2, gpio_get_level(io_num));
			}
			if(io_num == ROOT_KEY3_IO)
			{
				ESP_LOGI(s_keyTag,"GPIO[%d] intr, key[%d], val: %d\n", io_num, 3, gpio_get_level(io_num));
			}
			if(io_num == ROOT_KEY4_IO)
			{
				ESP_LOGI(s_keyTag,"GPIO[%d] intr, key[%d], val: %d\n", io_num, 4, gpio_get_level(io_num));
			}
			if(io_num == ROOT_KEY5_IO)
			{
				ESP_LOGI(s_keyTag,"GPIO[%d] intr, key[%d], val: %d\n", io_num, 5, gpio_get_level(io_num));
			}
			if(io_num == ROOT_KEY6_IO)
			{
				ESP_LOGI(s_keyTag,"GPIO[%d] intr, key[%d], val: %d\n", io_num, 6, gpio_get_level(io_num));
			}
        }
    }
}

---

• 由 青梅煮久 写于 2021 年 01 月 08 日