標(biāo)簽： esp8266 key
KEY 相關(guān)API
有關(guān)按鍵的程序在SDK根目錄下的driver_lib文件夾中的key.c和key.h燥筷。
相關(guān)結(jié)構(gòu)體
/** 按鍵處理函數(shù) 數(shù)據(jù)類型 */
typedef void (* key_function)(void);
struct single_key_param
{
/*按鍵處理流程標(biāo)號*/
uint8 key_level;
/*GPIO引腳號（0-15）*/
uint8 gpio_id;
/*GPIO 功能(詳見ESP8266 管腳清單.xlsx)*/
uint8 gpio_func;
/*GPIO MUX寄存器（參見gpio.h）*/
uint32 gpio_name;
/*定時器相關(guān)數(shù)據(jù)結(jié)構(gòu)(詳見SDK開發(fā)文檔)*/
os_timer_t key_5s;
/*定時器相關(guān)數(shù)據(jù)結(jié)構(gòu)(詳見SDK開發(fā)文檔)*/
os_timer_t key_50ms;
/*按鍵短按處理程序*/
key_function short_press;
/*按鍵長按處理程序*/
key_function long_press;
};
struct keys_param
{
/*按鍵的數(shù)量*/
uint8 key_num;
/*按鍵的相關(guān)信息*/
struct single_key_param **single_key;
};
API
struct single_key_param *key_init_single(uint8 gpio_id, uint32 gpio_name, uint8 gpio_func, key_function long_press, key_function short_press);
說明:返回一個由程序分配的存儲著按鍵數(shù)據(jù)的指針
按鍵檢查流程圖：
按鍵檢查流程圖
源碼剖析
- 按鍵初始化函數(shù)
void ICACHE_FLASH_ATTR key_init(struct keys_param *keys)
{
uint8 i;
/* 配置GPIO中斷的中斷服務(wù)函數(shù) */
ETS_GPIO_INTR_ATTACH(key_intr_handler, keys);
/* 關(guān)閉GPIO中斷 */
ETS_GPIO_INTR_DISABLE();
for (i = 0; i < keys->key_num; i++)
{
keys->single_key[i]->key_level = 1;
/* 配置引腳模式為GPIO模式 */
PIN_FUNC_SELECT(keys->single_key[i]->gpio_name, keys->single_key[i]->gpio_func);
/*配置GPIO模式為輸入模式 */
gpio_output_set(0, 0, 0, GPIO_ID_PIN(keys->single_key[i]->gpio_id));
/* 初始化GPIO中斷配置 */
gpio_register_set(GPIO_PIN_ADDR(keys->single_key[i]->gpio_id), GPIO_PIN_INT_TYPE_SET(GPIO_PIN_INTR_DISABLE)
| GPIO_PIN_PAD_DRIVER_SET(GPIO_PAD_DRIVER_DISABLE)
| GPIO_PIN_SOURCE_SET(GPIO_AS_PIN_SOURCE));
/* 清除GPIO中斷標(biāo)志 */
GPIO_REG_WRITE(GPIO_STATUS_W1TC_ADDRESS, BIT(keys->single_key[i]->gpio_id));
/* 配置GPIO中斷觸發(fā)類型為下降沿觸發(fā) */
gpio_pin_intr_state_set(GPIO_ID_PIN(keys->single_key[i]->gpio_id), GPIO_PIN_INTR_NEGEDGE);
}
/* 開啟GPIO中斷 */
ETS_GPIO_INTR_ENABLE();
}
- 按鍵長按檢測函數(shù)
static void ICACHE_FLASH_ATTR key_5s_cb(struct single_key_param *single_key)
{
/* 關(guān)閉按鍵長按檢測定時器 */
os_timer_disarm(&single_key->key_5s);
/* 按鍵處于按下狀態(tài) */
if (0 == GPIO_INPUT_GET(GPIO_ID_PIN(single_key->gpio_id)))
{
/* 執(zhí)行按鍵長按處理函數(shù) */
if (single_key->long_press)
{
single_key->long_press();
}
}
}
- 按鍵短按檢測函數(shù)
static void ICACHE_FLASH_ATTR key_50ms_cb(struct single_key_param *single_key)
{
/* 關(guān)閉按鍵短按檢測定時器 */
os_timer_disarm(&single_key->key_50ms);
/* 按鍵處于松開狀態(tài) */
if (1 == GPIO_INPUT_GET(GPIO_ID_PIN(single_key->gpio_id)))
{
/* 停止按鍵長按狀態(tài)檢測 */
os_timer_disarm(&single_key->key_5s);
single_key->key_level = 1;
/* 設(shè)置該按鍵中斷觸發(fā)方式為下降沿觸發(fā)(等待按鍵再次按下) */
gpio_pin_intr_state_set(GPIO_ID_PIN(single_key->gpio_id), GPIO_PIN_INTR_NEGEDGE);
/* 運行按鍵短按處理程序 */
if (single_key->short_press)
{
single_key->short_press();
}
}
else
{
/* 設(shè)置該按鍵中斷觸發(fā)方式為上升沿觸發(fā)(等待按鍵松開) */
gpio_pin_intr_state_set(GPIO_ID_PIN(single_key->gpio_id), GPIO_PIN_INTR_POSEDGE);
}
}
- GPIO中斷處理函數(shù)
static void key_intr_handler(struct keys_param *keys)
{
uint8 i;
//讀取GPIO狀態(tài)寄存器，獲取中斷信息
uint32 gpio_status = GPIO_REG_READ(GPIO_STATUS_ADDRESS);
for (i = 0; i < keys->key_num; i++)
{
if (gpio_status & BIT(keys->single_key[i]->gpio_id))
{
/** 關(guān)閉該按鍵的中斷 */
gpio_pin_intr_state_set(GPIO_ID_PIN(keys->single_key[i]->gpio_id), GPIO_PIN_INTR_DISABLE);
/** 清除該按鍵的中斷標(biāo)志 */
GPIO_REG_WRITE(GPIO_STATUS_W1TC_ADDRESS, gpio_status & BIT(keys->single_key[i]->gpio_id));
/** 按鍵處理流程一 */
if (keys->single_key[i]->key_level == 1)
{
/** 啟動按鍵長按檢測定時器 */
os_timer_disarm(&keys->single_key[i]->key_5s);
os_timer_setfn(&keys->single_key[i]->key_5s, (os_timer_func_t *)key_5s_cb, keys->single_key[i]);
os_timer_arm(&keys->single_key[i]->key_5s, 5000, 0);
keys->single_key[i]->key_level = 0;
/** 設(shè)置該按鍵中斷觸發(fā)方式為上升沿觸發(fā)(等待按鍵松開) */
gpio_pin_intr_state_set(GPIO_ID_PIN(keys->single_key[i]->gpio_id), GPIO_PIN_INTR_POSEDGE);
}
/** 按鍵處理流程二 */
else
{
/** 啟動按鍵短按檢測定時器 */
os_timer_disarm(&keys->single_key[i]->key_50ms);
os_timer_setfn(&keys->single_key[i]->key_50ms, (os_timer_func_t *)key_50ms_cb, keys->single_key[i]);
os_timer_arm(&keys->single_key[i]->key_50ms, 50, 0);
}
}
}
}
KEY Demo
#include "ets_sys.h"
#include "osapi.h"
#include "os_type.h"
#include "user_interface.h"
#include "eagle_soc.h"
#include "gpio.h"
#include "key.h"
/*********************************************************************************
* @brief 開關(guān)輸入引腳配置
********************************************************************************/
#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 按鍵相關(guān)變量
********************************************************************************/
static struct keys_param switch_param;
static struct single_key_param *switch_signle;
static bool status = true;
/*********************************************************************************
* @brief 開關(guān)短按狀態(tài)處理函數(shù)
* @param [in/out] void
* @return void
* @note None
********************************************************************************/
static void Switch_ShortPress_Handler( void )
{
if( status == true )
{
status = false;
}
else
{
status = true;
}
}
/********************************************************************************
* @brief 輸入初始化函數(shù)
* @param [in/out] void
* @return void
* @note None
********************************************************************************/
void drv_Switch_Init( void )
{
switch_signle = key_init_single( SWITCH_Pin_NUM, SWITCH_Pin_MUX,
SWITCH_Pin_FUNC,
NULL,
&Switch_ShortPress_Handler );
switch_param.key_num = 1;
switch_param.single_key = &switch_signle;
key_init( &switch_param );
}
http://blog.csdn.net/qq_15647227/article/details/52403998
http://www.cnblogs.com/mmmmar/p/6545202.html
http://blog.csdn.net/qq_15647227/article/details/52218376
