BES按键模块

于 2024-03-06 11:50:10 发布
阅读量1.1k 收藏 26
点赞数 15
分类专栏： BES开发讲解 文章标签： 嵌入式硬件
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/pisces_3s/article/details/136410021
版权

一、前言

上一章简单介绍了一下BES代码框架的组成，本章主要讲解一下BES按键模块，包含驱动、按键响应以及对应的消息处理。

二、按键驱动

1、按键的GPIO配置：

const struct HAL_KEY_GPIOKEY_CFG_T cfg_hw_gpio_key_cfg[CFG_HW_GPIOKEY_NUM] = {
#if (CFG_HW_GPIOKEY_NUM > 0)
#ifdef BES_AUDIO_DEV_Main_Board_9v0
    {HAL_KEY_CODE_FN1,{HAL_IOMUX_PIN_P0_0, HAL_IOMUX_FUNC_AS_GPIO,HAL_IOMUX_PIN_VOLTAGE_VIO, HAL_IOMUX_PIN_PULLUP_ENABLE}},
    {HAL_KEY_CODE_FN2,{HAL_IOMUX_PIN_P0_1, HAL_IOMUX_FUNC_AS_GPIO,HAL_IOMUX_PIN_VOLTAGE_VIO, HAL_IOMUX_PIN_PULLUP_ENABLE}},
#else
    {HAL_KEY_CODE_FN1,{HAL_IOMUX_PIN_P1_3, HAL_IOMUX_FUNC_AS_GPIO,HAL_IOMUX_PIN_VOLTAGE_VIO, HAL_IOMUX_PIN_PULLUP_ENABLE}},
    //{HAL_KEY_CODE_FN2,{HAL_IOMUX_PIN_P0_5, HAL_IOMUX_FUNC_AS_GPIO,HAL_IOMUX_PIN_VOLTAGE_VIO, HAL_IOMUX_PIN_PULLUP_ENABLE}},
    {HAL_KEY_CODE_FN2,{HAL_IOMUX_PIN_P1_2, HAL_IOMUX_FUNC_AS_GPIO,HAL_IOMUX_PIN_VOLTAGE_VIO, HAL_IOMUX_PIN_PULLUP_ENABLE}},
#endif
#endif
};

2、按键驱动的相关函数

int app_key_open(int checkPwrKey)

开启按键功能，初始化按键线程、申请按键链表资源。

int hal_key_open(int checkPwrKey, int (* cb)(uint32_t, uint8_t))

按键驱动初始化，启动包含GPIO按键、ADC按键、拨码按键等。主要功能是初始化按键。

static void hal_key_boot_handler(void *param)

static void hal_key_debounce_handler(void *param)

上面两个函数均为键值生成函数，其中hal_key_boot_handler为启动过程中电源键的键值生成函数，仅仅在启动过程中使用，hal_key_debounce_handler为普通按键的键值生成函数，该函数功能包含了按键的防抖、键值的转化等，有兴趣可以深入研究下其中的流程，还是有点东西的。

static int send_key_event(enum HAL_KEY_CODE_T code, enum HAL_KEY_EVENT_T event)

按键事件上报。

3、按键参数的配置

下面的主要是按键长按、短按、抖动时间，以及多击的间隔时间等配置，可以根据实际的项目要求及形态进行配置。

#ifndef CFG_SW_KEY_LLPRESS_THRESH_MS
#define CFG_SW_KEY_LLPRESS_THRESH_MS        5000
#endif
#ifndef CFG_SW_KEY_LPRESS_THRESH_MS
#define CFG_SW_KEY_LPRESS_THRESH_MS         1500
#endif
#ifndef CFG_SW_KEY_REPEAT_THRESH_MS
#define CFG_SW_KEY_REPEAT_THRESH_MS         500
#endif
#ifndef CFG_SW_KEY_DBLCLICK_THRESH_MS
#define CFG_SW_KEY_DBLCLICK_THRESH_MS       400
#endif
#ifndef CFG_SW_KEY_INIT_DOWN_THRESH_MS
#define CFG_SW_KEY_INIT_DOWN_THRESH_MS      200
#endif
#ifndef CFG_SW_KEY_INIT_LPRESS_THRESH_MS
#define CFG_SW_KEY_INIT_LPRESS_THRESH_MS    3000
#endif
#ifndef CFG_SW_KEY_INIT_LLPRESS_THRESH_MS
#define CFG_SW_KEY_INIT_LLPRESS_THRESH_MS   10000
#endif
#ifndef CFG_SW_KEY_CHECK_INTERVAL_MS
#define CFG_SW_KEY_CHECK_INTERVAL_MS        40
#endif

三、按键响应和处理

第二节的内容有兴趣可以深入研究下，对于实际项目来说，还是需要多关注下按键的响应流程和处理。

1、按键响应流程

当按键初始化完成后，当硬件上按键按键后，驱动层会上报按键的键值和按键事件，具体函数见第二节。上报的按键信息通过消息队列传递至对应的按键执行函数，对应的函数及功能描述如下：

static int key_event_process(uint32_t key_code, uint8_t key_event)

按键消息传递函数，同时增加了按键消息过滤机制，当按键上报太多，就废弃掉最新的按键。

static int app_key_handle_process(APP_MESSAGE_BODY *msg_body)

按键消息接收函数，该函数会通过键值和事件找到对应的执行函数。

void app_key_init(void)

按键初始化，TWS模式和Stereo模式的处理不一致，需要特别注意。该函数非常重要，涉及到按键的执行函数设定，需要特别注意。

下面是按键键值、按键事件和按键执行函数的对应对应关系，用户可以按照需求定义。此处展示的TWS模式的按键配置。

const APP_KEY_HANDLE  app_ibrt_ui_test_key_cfg[] =
{
    {{APP_KEY_CODE_GOOGLE, APP_KEY_EVENT_FIRST_DOWN}, "google assistant key",app_ibrt_ui_test_voice_assistant_key, NULL},
    {{APP_KEY_CODE_GOOGLE, APP_KEY_EVENT_UP}, "google assistant key",app_ibrt_ui_test_voice_assistant_key, NULL},
    {{APP_KEY_CODE_GOOGLE, APP_KEY_EVENT_LONGPRESS}, "google assistant key",app_ibrt_ui_test_voice_assistant_key, NULL},
    {{APP_KEY_CODE_GOOGLE, APP_KEY_EVENT_CLICK}, "google assistant key",app_ibrt_ui_test_voice_assistant_key, NULL},
    {{APP_KEY_CODE_GOOGLE, APP_KEY_EVENT_DOUBLECLICK}, "google assistant key",app_ibrt_ui_test_voice_assistant_key, NULL},                   
    {{APP_KEY_CODE_PWR,APP_KEY_EVENT_DOWN},"app_ibrt_ui_test_key_local",app_ibrt_ui_test_key_local, NULL},
    {{APP_KEY_CODE_PWR,APP_KEY_EVENT_CLICK},"bt anc key",app_anc_key, NULL}
    {{APP_KEY_CODE_PWR,APP_KEY_EVENT_LONGPRESS},"app_ibrt_ui_test_key",app_ibrt_ui_test_key, NULL},
    {{APP_KEY_CODE_PWR,APP_KEY_EVENT_LONGLONGPRESS},"app_ibrt_ui_test_key",app_ibrt_ui_test_key, NULL},
    {{APP_KEY_CODE_PWR,APP_KEY_EVENT_DOUBLECLICK},"app_ibrt_ui_test_key",app_ibrt_ui_test_key, NULL},
    {{APP_KEY_CODE_PWR,APP_KEY_EVENT_TRIPLECLICK},"app_ibrt_ui_test_key",app_ibrt_ui_test_key, NULL},
    {{APP_KEY_CODE_PWR,APP_KEY_EVENT_ULTRACLICK},"app_ibrt_ui_test_key",app_ibrt_ui_test_key, NULL},
    {{APP_KEY_CODE_PWR,APP_KEY_EVENT_RAMPAGECLICK},"app_ibrt_ui_test_key",app_ibrt_ui_test_key, NULL},
    {{APP_KEY_CODE_PWR,APP_KEY_EVENT_RAMPAGECLICK},"bt i2c key",app_factorymode_i2c_switch, NULL},
    {{APP_KEY_CODE_FN1,APP_KEY_EVENT_CLICK},"app_ibrt_ui_test_key",app_ibrt_simulate_charger_plugin_key, NULL},
    {{APP_KEY_CODE_FN1,APP_KEY_EVENT_DOUBLECLICK},"app_ibrt_ui_test_key",app_ibrt_simulate_tws_role_switch, NULL},
    {{APP_KEY_CODE_FN1,APP_KEY_EVENT_CLICK},"app_ibrt_ui_test_key",app_ibrt_ui_test_key_io_event, NULL},
    {{APP_KEY_CODE_FN1,APP_KEY_EVENT_DOUBLECLICK},"app_ibrt_ui_test_key",app_ibrt_ui_test_key_io_event, NULL},
    {{APP_KEY_CODE_FN2,APP_KEY_EVENT_CLICK},"app_ibrt_ui_test_key",app_ibrt_ui_test_key_io_event, NULL},
    {{APP_KEY_CODE_FN2,APP_KEY_EVENT_DOUBLECLICK},"app_ibrt_ui_test_key",app_ibrt_ui_test_key_io_event, NULL},
    {{APP_KEY_CODE_FN3,APP_KEY_EVENT_CLICK},"app_ibrt_ui_test_key",app_ibrt_ui_test_key_io_event, NULL},
    {{APP_KEY_CODE_FN3,APP_KEY_EVENT_DOUBLECLICK},"app_ibrt_ui_test_key",app_ibrt_ui_test_key_io_event, NULL},
};

2、按键处理

上面的按键执行函数，例如：

void app_ibrt_ui_test_key_io_event(APP_KEY_STATUS *status, void *param)
void app_ibrt_simulate_charger_plugout_key(APP_KEY_STATUS *status, void *param)
void app_ibrt_simulate_tws_role_switch(APP_KEY_STATUS *status, void *param)
void app_ibrt_simulate_charger_plugout_key(APP_KEY_STATUS *status, void *param)
void app_factorymode_i2c_switch(APP_KEY_STATUS *status, void *param)
void app_ibrt_ui_test_key(APP_KEY_STATUS *status, void *param)
void app_ibrt_ui_test_key_local(APP_KEY_STATUS *status, void *param)
void app_ibrt_ui_test_voice_assistant_key(APP_KEY_STATUS *status, void *param)

此处单使用下面函数举例

void app_ibrt_ui_test_key(APP_KEY_STATUS *status, void *param)
{
    TRACE(3,"%s %d,%d",__func__, status->code, status->event);
#ifndef TILE_DATAPATH
    ibrt_ctrl_t *p_ibrt_ctrl = app_tws_ibrt_get_bt_ctrl_ctx();
    uint8_t shutdown_key = HAL_KEY_EVENT_LONGLONGPRESS;
#endif

#ifndef TILE_DATAPATH
    if (IBRT_SLAVE == p_ibrt_ctrl->current_role && status->event != shutdown_key)
    {
        app_ibrt_if_keyboard_notify(status,param);
    }
    else
#endif
    {
#ifdef IBRT_SEARCH_UI
        app_ibrt_search_ui_handle_key(status,param);
#else
        app_ibrt_normal_ui_handle_key(status,param);
#endif
    }
}

这里需要注意的地方就是需要区分主从耳的按键事件，Stereo方案就不需要这一步，收到按键直接执行即可。由于主耳按键和Stereo方案处理方式是一致的，这里就不多展开了，只需要在对应的键值下面做好需要执行的事件就行，下面的函数是按键响应的入口。

void app_ibrt_search_ui_handle_key(APP_KEY_STATUS *status, void *param)

对应的响应事件则通过对应的函数去实现，可以自由调用，例如双击事件。

void bt_key_handle_func_doubleclick()
{
    TRACE(0,"!!!APP_KEY_EVENT_DOUBLECLICK\n");
    if((app_bt_device.hfchan_callSetup[BT_DEVICE_ID_1] == BTIF_HF_CALL_SETUP_NONE)&&(app_bt_device.hfchan_call[BT_DEVICE_ID_1] == BTIF_HF_CALL_NONE)){
        hfp_handle_key(HFP_KEY_REDIAL_LAST_CALL);
    }
    if(app_bt_device.hf_audio_state[BT_DEVICE_ID_1] == BTIF_HF_AUDIO_CON){
        if(app_bt_device.hf_mute_flag == 0){
            hfp_handle_key(HFP_KEY_MUTE);
            app_bt_device.hf_mute_flag = 1;
        }else{
            hfp_handle_key(HFP_KEY_CLEAR_MUTE);
            app_bt_device.hf_mute_flag = 0;
        }
    }
}

此处根据当前的场景，双击事件有三个操作，无业务状态下，双击自动重拨，通话中，则自动在Mute麦克风和Open麦克风之间切换。这里需要注意的就是判断条件需要考虑周全，否则对应的按键起不到对应的效果。

对于从耳来说，执行相对复杂一点，不过也只是多了一步双耳之间按键同步的消息，不过也需要注意，若该操作仅从耳执行，那操作和主耳一致，判断按键事件，执行对应的操作即可，不需要同步，例如单耳关机。其中从耳执行流程如下：

int app_ibrt_if_keyboard_notify(APP_KEY_STATUS *status, void *param)
{
    if (app_tws_ibrt_slave_ibrt_link_connected())
    {
        tws_ctrl_send_cmd(APP_TWS_CMD_KEYBOARD_REQUEST, (uint8_t *)status,sizeof(APP_KEY_STATUS)); 
    }
    return 0;
}

其中下面的函数就是双耳同步消息的函数，此处不展开，暂时也不需要深入了解，知道函数咋用就行了。进阶后可以研究一下完整的流程和原理。

int tws_ctrl_send_cmd(uint32_t cmd_code, uint8_t *p_buff, uint16_t length)

从耳发出按键消息后，主耳会同步收到对应的消息，随后的流程和主耳执行的按键流程一致。对应的入口为：

void app_ibrt_keyboard_request_handler(uint16_t rsp_seq, uint8_t *p_buff, uint16_t length)
{
    if (app_tws_ibrt_mobile_link_connected())
    {
#ifdef IBRT_SEARCH_UI
        app_ibrt_search_ui_handle_key((APP_KEY_STATUS *)p_buff, NULL);
#else
        app_ibrt_normal_ui_handle_key((APP_KEY_STATUS *)p_buff, NULL);
#endif
#ifdef __AI_VOICE__
        app_ibrt_ui_test_voice_assistant_key((APP_KEY_STATUS *)p_buff, NULL);
#endif
    }
}

其中对应的按键响应入口和主耳操作一样。如下：

void app_ibrt_search_ui_handle_key(APP_KEY_STATUS *status, void *param)

四、补充

此处补充一下平时遇到的一些按键模块中的一些小问题。

1、按键响应函数中的事件处理不宜添加延时等阻塞型函数和锁函数，否则有可能导致系统死机和死锁；

2、有些用户需要修改双击和三击的间隔，而且还不一致，这个可以在驱动层做修改，不过需要注意其中的按键释放，否则可能会导致按键持续触发；

3、按键的GPIO映射时，对应的高低电平和触发需要注意，保持和原理图一致。GPIO的上下拉需要设定好。

{HAL_KEY_CODE_FN2,{HAL_IOMUX_PIN_P0_1, HAL_IOMUX_FUNC_AS_GPIO, HAL_IOMUX_PIN_VOLTAGE_VIO, HAL_IOMUX_PIN_PULLUP_ENABLE}},

4、给按键设置别名时，参考按键的功能。其中组合键可以将对应的按键或在一起。

#define   BTAPP_FUNC_KEY            APP_KEY_CODE_PWR
#define   BTAPP_VOLUME_DOWN_KEY     APP_KEY_CODE_FN1
#define   BTAPP_VOLUME_UP_KEY       APP_KEY_CODE_FN2
#define   BTAPP_PLAY_KEY            APP_KEY_CODE_FN3
#define   BTAPP_SLEEP_KEY           APP_KEY_CODE_FN4
#define   BTAPP_FUNC_UP_DOWN_KEY    (BTAPP_FUNC_KEY|BTAPP_VOLUME_DOWN_KEY|BTAPP_VOLUME_UP_KEY)

按键模块总体比较简单，对于其他类型的按键，例如触摸按键、ADC按键，以及其他类似按键（如佩戴、陀螺仪等外设，可以通过模拟成按键来操作）的处理，后续想到新的再补充。

pisces_3s
关注
专栏目录
BES2300x笔记（18） -- 按键梳理
文化人的博客
06-09 1684
哈喽大家好，这是该系列博文的第十八篇~ 篇~ <<【系列博文索引】快速通道 >> 一、前言 作为嵌入式三剑客之一的 Button，是我们必须要熟悉的模块。当我们熟悉了 Button 之后，对于可简化为IO操作（低端触摸或入耳检测）的外设应用，那就是小菜一碟了。那么这一篇 ，我们就来学习一下 Button 。 二、框架及代码分析 看一下按键的逻辑框图
BES IBRT SDK应用说明文档
06-01
内容包含BES IBRT SDK基础知识介绍, 官方开发板接线说明, SDK软件环境搭建说明和功能模块简单介绍
BES2500X开发---按键处理
orange123b的博客
04-21 879
一：按键配置 在tgt_hardware.c中对按键进行配置，包括按键名称、引脚映射、上下拉设置等，和LED的配置类似，且PWR按键无需单独配置 二：按键处理的流程 程序从main函数开始运行，并进入app_init()中，在app_init()函数中，对按键进行初始化 app_key_init(); void app_key_init(void)//注册上层按键处理事件 { #if defined(IBRT)//TWS工程，注册按键 app_ibrt_ui_test_key_ini
BES GPIO中断实验
xinbo7077的博客
08-25 584
extern bool connected_flag; //zk+ struct BT_DEVICE_T app_bt_device1; btif_device_record_t record;//zk+ //zk+ GPIO输出实验 OK 点亮红LED static const struct HAL_IOMUX_PIN_FUNCTION_MAP test_out_pin[] ={{HAL_IOMUX_PIN_LED1, HAL_IOMUX_FUNC_GPIO, HAL_IOMUX...
BES2500平台上入耳检测(体感篇)
weixin_44735216的博客
01-18 4193
项目入耳检测要求如下 1.通过触摸检测GPIO2的电平高低来确定是否入耳，当HAL_IOMUX_PIN_P0_2为低电平时，耳机佩戴；当入耳检测为高电平时，耳机取下 入耳检测实现功能： 单耳佩戴时：开启环境音模式 双耳佩戴时：开始降噪模式 双耳组队成功，双耳机佩戴成功播放音乐，否则音乐暂停 但耳机和手机连接后，佩戴播放音乐，取下音乐暂停 佩戴耳机触摸按键播放暂停有效，取下耳机触摸按键无效 入耳检测代码主程序： #if 1//20210104 const struct HAL_IOMUX_PIN_FUNCTI
Tlsr8258开发-设置GPIO输入输出
自学嵌入式
08-30 798
官方提供的开发板，按键是一个矩阵按键，为了简化，我直接利用外接出来的引脚去和GND相连来模拟按键。
一个常用的gpio驱动
上官绝痕的专栏
05-20 1329
分享一个gpio驱动，其中使用了gpio、pinctrl、irq、workqueue、input等知识，代码中有较详细的注释，不时可以来瞅一瞅！ 首先设备树中如下配置： &pio { touchsensor_pins_tp_int10: eint@10 { pins_cmd_dat { pins = <MT8163_PIN_32_EINT10__FUNC_GPIO32>; slew-rate = <0>; bias-disable; }; };
GPIO的一些标识和用法
永不秃头的程序员的博客
11-29 1517
文章目录一、gpio的标识用法二、GPIO的复用 一、gpio的标识用法 我们在dts文件里面经常可以看到这些词语 enable-gpio = <&gpio0 RK_PC5 GPIO_ACTIVE_HIGH>; IRQ_TYPE_NONE //默认值，无定义中断触发类型 IRQ_TYPE_EDGE_RISING //上升沿触发 IRQ_TYPE_EDGE_FALLING //下降沿触发 IRQ_TYPE_EDGE_BOTH //上升沿和下降沿都触发 IRQ_T
BES2300_API接口
296000的博客
07-19 398
-----------------------------apps.cpp初始化--------------------------------------------- app_status_indication_set| 灯配置高低电平切换 app_voice_report| 提示音播报，与灯状态同步 app_ibrt_remove_history_paired_device| 清除历史记录 osTimerCreate.
BES2600全系列datasheet
06-02
BES2600全系列的datasheet, BES资料挺不好找的, 辛苦搬运, 非常不错的资料, 对该芯片型号感兴趣的朋友可以研究研究. 包含BES2600Z/Y, BES2600YA/YP, BES2600IUC
BES推送应用实例演示与分析(含技术文档及源代码)
06-22
本文通过一个实际的应用案例ECL (Emergency Contact List ) ，来介绍经典的 BlackBerry 通过BES(BlackBerry Enterprise Server)数据推送的功能，包括了服务器端 和手机端的源代码。
BES2600YP参考原理图
06-02
【BES2600YP参考原理图】是专为从事BES硬件开发的工程师设计的官方原理图，提供了一套完整的电路设计方案。这个文档包含了关键的组件布局、信号路径和电源管理等重要信息，有助于理解和搭建基于BES2600YP芯片的硬件...
bes查看工具
10-08
"bes查看工具"是一款专为IT专业人士设计的实用软件，主要用于查看和分析二进制数据。这款工具的独特之处在于它支持以十六进制格式显示数据，同时提供了自定义长度查看的功能，使得用户可以根据需要查看任意长度的...
BES OTA APP
08-06
BES2000 OTA APP 支持BES2000 BES2000A BES2000L BES2000I
BES2500IM规格书
05-07
BES2500IM规格书BES2500IM规格书BES2500IM规格书BES2500IM规格书BES2500IM规格书BES2500IM规格书BES2500IM规格书BES2500IM规格书BES2500IM规格书BES2500IM规格书BES2500IM规格书
BES2500 SDK接口
yqluing的博客
10-20 808
app_tws_pairing_and_pairing_mode.cpp bool app_tws_role_is_master(void) 判断耳机是否为主耳 app_status_ind.c int app_status_indication_set(APP_STATUS_INDICATION_T status) 设置指示灯状态 APP_STATUS_INDICATION_T app_status_indication_g
BES（恒玄） 平台 复杂按键 实现
qq_34990604的博客
03-19 4661
昨天 有说到 LED 的配置 ，关于UI 的三大组件 ：LED 、按键 、提示音。今天就说下按键部. BES 平台里面 包含了 大部分按键代码 ： 按键l类型分power 、普通GPIO按键 ADC 按键 按键事件有单击 双击 长按 长长按 重复等。 先分析下 默认按键的实现逻辑。 一、普通按键实现逻辑分析： 1.先看下普通按键： 从上结构体 和按键注册表 可以得知 按键FN1对应的GPIO为 PIO_02，并且拉低（按下）有效，默认是高电平。 按键实现原理 ： 按键的按下和弹起会产.
BES------------GPIO的使用
最新发布
u010268337的博客
10-25 162
【代码】BES------------GPIO的使用。
BES平台 LED 配置（包括GPIO模拟呼吸灯实现）
qq_34990604的博客
03-18 2884
HI， 昨天我对BES 软件 框架做了简单的介绍，这篇文章就详细叙述下 BES 蓝牙模块 LED 的配置 和总结 。 一、简单LED闪烁 、常亮 这个模块在BES 默认的SDK 是有实现的，就是通过软件定时器对GPIO周期性控制拉高或拉低。 LED的控制全部在函数app_status_indication_set内设置，根据上层传送事件，来调用相应的LED控制。 #if (CFG_HW_PWL_NUM > 0) /*CFG_HW_PWL_NUM 是LED的个数*/ static voi
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值