FR800X系列按键检测模块
读者对象：
本文档主要适用以下工程师：
嵌入式系统工程师
单片机软件工程师
IOT固件工程师
BLE固件工程师
文章目录
- 1.概要
- 2.用户如何设计按键检测模块
- 2.1 GPIO初始化
- 2.2按键模块初始化
- 2.3设计中断函数：
- 2.4循环检测按键和输出事件
- 2.5按键任务处理
- 2.6 事件处理函数
- 3.按键模块调试细节
- 4.小结
1.概要
FR800X系列软件开发中基于官方SDK中如何设计按键检测模块。按键检测需满足两个要求分别为消除抖动干扰和快速响应。要想消除抖动干扰，就需要做滤波处理，比如间隔10ms持续检测3(2-5)次为低电平为按键按下有效。快速响应就需要中断触发，中断触发后开启定时器循环检测按键。那用户怎样设计按键检测模块呢？
设计按键模块化好处：
灵活性：模块化的按键设计能够提供更多的选择和灵活性。不同的按键模块可以根据需求进行组合和更换，从而满足不同的功能需求。
易于维护：按键模块化可以使维护更加简单。当一个按键出现故障时，只需替换该模块，而无需更换整个设备。这节省了时间和资源，并减少了停机时间。
可扩展性：按键模块化允许在需要时添加更多的按键。这种扩展性使得设备能够适应不断变化的需求和功能。
互换性：按键模块化使不同厂商的按键能够互相兼容。这意味着用户可以更容易地找到合适的按键模块，并使用它们来替换原始设备中的按键。
降低成本：按键模块化可以降低成本，因为只需购买需要的按键模块，而无需购买整个设备。此外，模块化还可以减少对专门技术的需求，从而降低维修和维护的成本。
按键模块框图
本文主要讲述：①用户如何设置GOIO中断唤醒、IO中断怎样处理；②如何设计软件检测多个独立按键的；③用户发送按键事件，短按、长按、超长按；④然后统一处理按键事件，在按键事件中定义业务功能。
2.用户如何设计按键检测模块
首先建立键模块化文件app_buttons.c和app_buttons.h。app_buttons.c存放程序内容，app_buttons.h存放相关接口。实现了正常模式和低功耗模式下的按键检测，代码如下：
2.1 GPIO初始化
// 按键 PD7 PC2 PC3 exti_enable
system_set_port_mux(GPIO_PORT_D, GPIO_BIT_7, PORTD7_FUNC_D7);
system_set_port_mux(GPIO_PORT_D, GPIO_BIT_6, PORTD6_FUNC_D6);
system_set_port_mux(GPIO_PORT_C, GPIO_BIT_2, PORTC2_FUNC_C2);
system_set_port_mux(GPIO_PORT_C, GPIO_BIT_3, PORTC3_FUNC_C3);
system_set_port_pull(GPIO_PD7, GPIO_PULL_UP, true);
system_set_port_pull(GPIO_PD6, GPIO_PULL_UP, true);
system_set_port_pull(GPIO_PA4, GPIO_PULL_UP, true);
system_set_port_pull(GPIO_PA5, GPIO_PULL_UP, true);
exti_enable(GPIO_PD7|GPIO_PD6|GPIO_PC3|GPIO_PC2);
NVIC_EnableIRQ(GPIO_IRQn);
// 按键PD7 PC2 PC3 wakeup
pmu_set_pin_pull(GPIO_PORT_D, GPIO_PIN_7, GPIO_PULL_UP);
pmu_set_pin_pull(GPIO_PORT_D, GPIO_PIN_6, GPIO_PULL_UP);
pmu_set_pin_pull(GPIO_PORT_C, GPIO_PIN_2, GPIO_PULL_UP);
pmu_set_pin_pull(GPIO_PORT_C, GPIO_PIN_3, GPIO_PULL_UP);
pmu_port_wakeup_func_set(GPIO_PORT_D, GPIO_PIN_7);
pmu_port_wakeup_func_set(GPIO_PORT_D, GPIO_PIN_6);
pmu_port_wakeup_func_set(GPIO_PORT_C, GPIO_PIN_2);
pmu_port_wakeup_func_set(GPIO_PORT_C, GPIO_PIN_3);
button_init(GPIO_PD7|GPIO_PD6|GPIO_PC3|GPIO_PC2);
NVIC_EnableIRQ(PMU_IRQn);
2.2按键模块初始化
uart_printf("buttons_init,%x\r\n",enable_io);
/* 清除RAM */
memset(&button_curr_list,0,sizeof(button_curr_list));
memset(&button_last_list,0,sizeof(button_last_list));
/* 检测的IO mask */
button_io_mask = enable_io;
/* 检测变量初始化 */
for(uint8_t i=0; i<GPIO_DIO_MAX; i++)
{
if(enable_io & (0x01 <<i))
{
DEBUG_PRINTF("DIO num : %d\r\n",i);
button_curr_list[i].io_enable = 1;
button_curr_list[i].count = 0;
button_curr_list[i].flag = 1;
button_curr_list[i].io_mask = (0x01 << i);
button_last_list[i].io_enable = 1;
button_last_list[i].count = 0;
button_last_list[i].flag = 1;
button_last_list[i].io_mask = (0x01 << i);
}
}
// 按键检测定时器初始化
os_timer_init(&button_check_timer, button_timeout_handler, NULL);
2.3设计中断函数：
/*
* @fn pmu_gpio_isr_ram
*
* @brief pmu_gpio_isr
*
* @param None.
*
* @return None.
*/
__attribute__((section("ram_code"))) void pmu_gpio_isr_ram(void)
{
uint32_t gpio_value = ool_read32(PMU_REG_PORTA_LAST_STATUS);
button_toggle_detected(gpio_value);
ool_write32(PMU_REG_PORTA_LAST_STATUS, gpio_value);
}
2.4循环检测按键和输出事件
/* 中断检查IO状态 */
void BUTTON_CheckHandler(void)
{
static uint8_t released_type=0;
static uint32_t curr_button=0;
static uint32_t button_check_sleep=0;
//DEBUG_PRINTF("but: %04X \r\n",ool_read32(PMU_REG_PORTA_LAST_STATUS));
curr_button = ool_read32(PMU_REG_PORTA_LAST_STATUS);
for(uint8_t index=0; index<GPIO_DIO_MAX; index++)
{
if(button_curr_list[index].io_enable == 0) continue;
//DEBUG_PRINTF("[%d]\r\n",index);
button_curr_list[index].flag = (curr_button & (0x01<<index)) ? 1 : 0;
//DEBUG_PRINTF("%d[%d][%d]\r\n",index,button_curr_list[index].flag,button_last_list[index].flag);
if(button_curr_list[index].flag == button_last_list[index].flag)
{
//button_check_timer_begin |= button_curr_list[index].io_mask;
//DEBUG_PRINTF("Count[%d]\r\n",button_curr_list[index].count);
button_curr_list[index].count ++;
if(button_curr_list[index].count > BUTTON_LONG_LONG_TIME) // 超长按 5s
{
button_curr_list[index].count = BUTTON_LONG_LONG_TIME;
button_check_sleep &= ~button_curr_list[index].io_mask; // 清除进入 循环检查
}
else if(button_curr_list[index].count >= BUTTON_LONG_LONG_TIME) // 超长按 5s
{
if(button_curr_list[index].flag == 0)
{
button_send_event(BUTTON_LONG_LONG_PRESSED,index);
button_curr_list[index].out_type = BUTTON_LONG_LONG_PRESSED;
}
}else if(button_curr_list[index].count == BUTTON_LONG_TIME) // 长按 1s
{
//DEBUG_PRINTF("BUTTON_LONG_TIME\r\n");
if(button_curr_list[index].flag == 0)
{
button_send_event(BUTTON_LONG_PRESSED,index);
button_curr_list[index].out_type = BUTTON_LONG_PRESSED;
}else
{
if(released_type == BUTTON_NOP)
{
// 无按下按键或者按下时间不够
button_send_event(BUTTON_NOP,index);
}
}
}else if(button_curr_list[index].count == BUTTON_SHORT_TIME) // 短按 50ms
{
if(button_curr_list[index].flag == 0)
{
button_send_event(BUTTON_PRESSED,index);
button_curr_list[index].out_type = BUTTON_PRESSED;
released_type = BUTTON_PRESSED;
}else
{
if(button_curr_list[index].out_type == BUTTON_PRESSED)
{
button_send_event(BUTTON_RELEASED,index);
}else if(button_curr_list[index].out_type == BUTTON_LONG_PRESSED)
{
button_send_event(BUTTON_LONG_RELEASED,index);
}else if(button_curr_list[index].out_type == BUTTON_LONG_LONG_PRESSED)
{
button_send_event(BUTTON_LONG_LONG_RELEASED,index);
}
button_check_sleep &= ~button_curr_list[index].io_mask; // 清除进入 循环检查
//DEBUG_PRINTF("button_check %x %x\r\n",button_check_sleep,~button_curr_list[index].io_mask);
}
}
}else
{
button_curr_list[index].count = 0;
released_type = BUTTON_NOP;
button_check_sleep |= button_curr_list[index].io_mask;
button_last_list[index].flag = button_curr_list[index].flag;
}
}
//DEBUG_PRINTF("button_check %x %x\r\n",button_check_sleep,button_io_mask);
if((button_check_sleep & button_io_mask ) == 0)
{
DEBUG_PRINTF("button os_timer_stop\r\n");
os_timer_stop(&button_check_timer);
}
}
2.5按键任务处理
如何处理按键事件?
这里需要用到消息任务，如下：发送一个按键事件
void button_send_event(button_type_t type, uint8_t but_code)
{
os_event_t button_event;
struct button_msg_t msg;
msg.button_index = (0x01<<but_code);
msg.button_type = type;
msg.button_cnt = 0;
button_event.event_id = USER_EVT_BUTTON;
button_event.src_task_id = user_task_id;
button_event.param = (void *)&msg;
button_event.param_len = sizeof(msg);
DEBUG_PRINTF("button_send_event %d\r\n",type);
os_msg_post(user_task_id, &button_event);
}
2.6 事件处理函数
最后在用户任务中，处理相关按键事件任务
static int user_task_func(os_event_t *param)
{
switch(param->event_id)
{
case USER_EVT_AT_COMMAND:
//app_at_cmd_recv_handler(param->param, param->param_len);
break;
case USER_EVT_BUTTON:
{
struct button_msg_t *button_msg;
const char *button_type_str[] = {
"BUTTON_PRESSED",
"BUTTON_RELEASED",
"BUTTON_SHORT_RELEASED",
"BUTTON_MULTI_PRESSED",
"BUTTON_LONG_PRESSED",
"BUTTON_LONG_PRESSING",
"BUTTON_LONG_RELEASED",
"BUTTON_LONG_LONG_PRESSED",
"BUTTON_LONG_LONG_RELEASED",
"BUTTON_COMB_PRESSED",
"BUTTON_COMB_RELEASED",
"BUTTON_COMB_SHORT_PRESSED",
"BUTTON_COMB_LONG_PRESSED",
"BUTTON_COMB_LONG_PRESSING",
"BUTTON_COMB_LONG_RELEASED",
"BUTTON_COMB_LONG_LONG_PRESSED",
"BUTTON_COMB_LONG_LONG_RELEASED",
};
button_msg = (struct button_msg_t *)param->param;
co_printf("%x TYPE:%s.\r\n", button_msg->button_index,button_type_str[button_msg->button_type]);
switch( button_msg->button_type )
{
case BUTTON_PRESSED:
ProcessPress(button_msg->button_index);
break;
case BUTTON_LONG_PRESSED:
ProcessLongPress(button_msg->button_index);
break;
case BUTTON_LONG_LONG_PRESSED:
ProcessLongLongPress(button_msg->button_index);
break;
case BUTTON_SHORT_RELEASED:
ProcessRelease(button_msg->button_index);
break;
case BUTTON_LONG_RELEASED:
ProcessLongRelease(button_msg->button_index);
break;
case BUTTON_LONG_LONG_RELEASED:
ProcessLongLongRelease(button_msg->button_index);
break;
default:
break;
}
}
break;
case DSP_EVT_COMMAND:
break;
default:
break;
}
return EVT_CONSUMED;
}
3.按键模块调试细节
1)BLE工作在低功耗模式和正常工作模式下，按键皆可以正常使用
2)GPIO中断函数回调函数要处理好，放入相关的中断回调的接口
3)启动定时器轮询检测按键，检测超时关闭定时器，减少功耗
4.小结
按键检测处理方法有很多，这里采用中断+定时器检测并发送事件+事件处理的方法，好处有①可以实现按键的模块化；②中断按键响应速度快；③按键触发稳定，定时间隔滤波防止误处理。④支持32个独立按键检测。按键检测是软件开发必备知识，相信还有很多中方法；作者常用这种方法来开发按键检测，不知您还有哪种更好按键检测的方法，欢迎评论，谢谢！。
![[Mysql-DDL数据操作语句]](https://i-blog.csdnimg.cn/direct/8490a6034b294cd492726d39fb18f937.png)
