ESP8266 GPIO中断学习

前言

GPIO中断在进行脉宽测量、脉冲计数时能起到极为重要的作用，本文主要介绍GPIO中断的用法，使用一个开关打开或关闭一个LED灯。

GPIO寄存器介绍

一、GPIO输入寄存器

寄存器名称	功能说明	寄存器大小	寄存器属性	参数说明
GPIO_IN	输入状态寄存器	16Bit	读写	对应GPIO0-GPIO15
GPIO_PIN12	中断类型寄存器	16Bit	读写	0：禁用该GPIO的中断 1：上升沿触发中断 2：下降沿触发中断 3：双边沿触发中断 4：低电平触发中断 5：高电平触发中断
GPIO_STATUS	中断状态寄存器	16Bit	读写	对应GPIO0-GPIO15
GPIO_STATUS_W1TC	复位中断标志寄存器	16Bit	读写	对应GPIO0-GPIO15

二、GPIO输出寄存器

寄存器名称	功能说明	寄存器大小	寄存器属性	参数说明
GPIO_ENABLE_W1TS	使能输出寄存器	16Bit	读写	对应GPIO0-GPIO15
GPIO_ENABLE_W1TC	禁用输出寄存器	16Bit	读写	对应GPIO0-GPIO15
GPIO_ENABLE	输出使能状态寄存器	16Bit	读写	对应GPIO0-GPIO15
GPIO_OUT_W1TC	输出低电平寄存器	16Bit	只读	对应GPIO0-GPIO15
GPIO_OUT_W1TS	输出高电平寄存器	16Bit	读写	对应GPIO0-GPIO15
GPIO_OUT	输出状态寄存器	16Bit	读写	对应GPIO0-GPIO15

注：GPIO16不支持触发IO中断。

相关API介绍

一、引脚复用功能切换函数

功能介绍	配置某引脚的其他功能	-
函数原型	PIN_FUNC_SELECT(PIN_NAME, FUNC)	宏函数
参数介绍	PIN_NAME	该引脚的MUX寄存器
-	FUNC	引脚需要配置的功能
参数枚举	关于PIN_NAME的参数详见eagle_soc.h,关于FUNC的参数详见ESP8266 管脚清单.xlsx（在官网上可以找到当然页可以参考eagle_soc.h）。	-
示例	PIN_FUNC_SELECT(PERIPHS_IO_MUX_GPIO4_U,FUNC_GPIO4);	配置MTDI引脚作为GPIO使用

二、输入模式配置

功能介绍	配置某引脚为输入模式	-
函数原型	GPIO_DIS_OUTPUT(gpio_no)	宏函数
参数介绍	gpio_no	GPIO的引脚号（0-15）
示例	GPIO_DIS_OUTPUT(0);	配置GPIO0为输入模式

三、上拉模式配置

功能介绍	开启某引脚上拉模式	-
函数原型	PIN_PULLUP_EN(PIN_NAME)	宏函数
参数介绍	PIN_NAME	该引脚的MUX寄存器的名称
示例	PIN_PULLUP_EN(PERIPHS_IO_MUX_GPIO4_U);	开启GPIO4的上拉输入功能
-	-	-
功能介绍	关闭某引脚上拉模式	-
函数原型	PIN_PULLUP_DIS(PIN_NAME)	宏函数
参数介绍	PIN_NAME	该引脚的MUX寄存器的名称
示例	PIN_PULLUP_DIS(PERIPHS_IO_MUX_GPIO4_U);	关闭GPIO4的上拉输入功能

四、获取输入引脚状态

功能介绍	读取某引脚的高低电平状态	-
函数原型	GPIO_INPUT_GET(gpio_no)	宏函数
参数介绍	gpio_no	GPIO的引脚号（0-15）
示例	GPIO_INPUT_GET(0);	读取GPIO0的输入引脚状态

五、GPIO中断状态配置

功能介绍	开启GPIO中断	-
函数原型	ETS_GPIO_INTR_ENABLE()	宏函数
-	-	-
功能介绍	关闭GPIO中断	-
函数原型	ETS_GPIO_INTR_DISABLE()	宏函数

六、配置中断处理函数

功能介绍	配置中断处理函数	-
函数原型	ETS_GPIO_INTR_ATTACH(GPIO_INTERRUPT,NULL)	宏函数
参数介绍	GPIO_INTERRUPT	GPIO的中断处理函数
参数介绍	NULL	GPIO的中断服务函数的参数

示例

void GPIO_ISR_Handler( void )
{
    /** GPIO中断处理函数 */
}

void GPIO_ISR_Handler_Config( void )
{
    ETS_GPIO_INTR_ATTACH(&GPIO_ISR_Handler,NULL);
}

七、配置GPIO中断触发方式

功能介绍	配置GPIO中断触发方式	-
函数原型	void gpio_pin_intr_state_set(uint32 i, GPIO_INT_TYPE intr_state);	-
参数介绍	i（GPIO_ID_PIN(n)）	GPIO的引脚ID(n为GPIO引脚号，范围为0-15)
-	intr_state	GPIO中断触发方式
参数枚举	GPIO_PIN_INTR_DISABLE（0）	禁用该引脚的中断
-	GPIO_PIN_INTR_POSEDGE（1）	使能该引脚的上升沿中断
-	GPIO_PIN_INTR_NEGEDGE（2）	使能该引脚的下降沿中断
-	GPIO_PIN_INTR_ANYEDGE（3）	使能该引脚的双边沿中断
-	GPIO_PIN_INTR_LOLEVEL（4）	使能该引脚的低电平中断
-	GPIO_PIN_INTR_HILEVEL（5）	使能该引脚的高电平中断
示例	gpio_pin_intr_state_set(GPIO_ID_PIN(0),GPIO_PIN_INTR_ANYEDGE);	配置GPIO0的中断触发方式为双边沿触发方式

示例

#include "ets_sys.h"
#include "osapi.h"
#include "user_interface.h"
#include "eagle_soc.h"
#include "gpio.h"
#include "gpio16.h"

/** 开关输入相关 宏定义 */
#define SWITCH_Pin_NUM         5
#define SWITCH_Pin_FUNC        FUNC_GPIO5
#define SWITCH_Pin_MUX         PERIPHS_IO_MUX_GPIO5_U

#define SWITCH_Pin_Rd_Init()   GPIO_DIS_OUTPUT(SWITCH_Pin_NUM)
#define SWITCH_Pin_Wr_Init()   GPIO_OUTPUT_SET(SWITCH_Pin_NUM,0)
#define SWITCH_Pin_Set_High()  GPIO_OUTPUT_SET(SWITCH_Pin_NUM,1)
#define SWITCH_Pin_Set_Low()   GPIO_OUTPUT_SET(SWITCH_Pin_NUM,0)
#define SWITCH_Pin_State       ( GPIO_INPUT_GET(SWITCH_Pin_NUM) != 0 )

/**
*******************************************************************************
 * @brief       GPIO中断处理函数
 * @param       [in/out]  void
 * @return      void
 * @note        None
*******************************************************************************
*/
static void GPIO_ISR_Handler( void )
{
    /** 读取GPIO中断状态 */
    u32 pin_status = GPIO_REG_READ( GPIO_STATUS_ADDRESS );

    /** 关闭GPIO中断 */
    ETS_GPIO_INTR_DISABLE();

    /** 清除GPIO中断标志 */
    GPIO_REG_WRITE( GPIO_STATUS_W1TC_ADDRESS, pin_status );

    /** 检测是否已开关输入引脚中断 */
    if ( pin_status & BIT( SWITCH_Pin_NUM ) )
    {
        if( SWITCH_Pin_State )
        {
            gpio16_output_set(0);
        }
        else
        {
            gpio16_output_set(1);
        }
    }

    /** 开启GPIO中断 */
    ETS_GPIO_INTR_ENABLE();
}

/**
*******************************************************************************
 * @brief       输入初始化函数
 * @param       [in/out]  void
 * @return      void
 * @note        None
 *******************************************************************************
 */
static void drv_Input_Init( void )
{
    PIN_FUNC_SELECT( SWITCH_Pin_MUX, SWITCH_Pin_FUNC );

    SWITCH_Pin_Rd_Init();

    ETS_GPIO_INTR_DISABLE();

    ETS_GPIO_INTR_ATTACH( &GPIO_ISR_Handler, NULL );

    gpio_pin_intr_state_set( GPIO_ID_PIN( SWITCH_Pin_NUM ),
                             GPIO_PIN_INTR_ANYEDGE );

    /** 清除该引脚的GPIO中断标志 */
    GPIO_REG_WRITE( GPIO_STATUS_W1TC_ADDRESS, BIT(SWITCH_Pin_NUM) );

    ETS_GPIO_INTR_ENABLE();
}

/**
*******************************************************************************
 * @brief       用户初始化程序
 * @param       [in/out]  void
 * @return      void
 * @note        None
*******************************************************************************
*/
void user_init( void )
{
    drv_Input_Init();
    gpio16_output_conf();
}

参考资料

[1]. ESP8266技术参考
[2]. ESP8266Non-OS SDK API参考
[3]. ESP8266 管脚清单