前言现在为止也开发了许多杰理TWS蓝牙耳机、音响项目SDK的案子在调试案子时不断的向前辈们学习到了很多关于蓝牙音响、蓝牙TWS耳机专业的知识。想在这里做一个学习汇总方便各位同行和对杰理芯片SDK感兴趣的小伙伴们学习本章详细讲解杰理SDK开发中实现清除手机APP用户配置功能、重置参数功能在我们进行杰理蓝牙耳机、蓝牙音响等蓝牙产品软件开发时往往根据现在的发展客户们都需要加入APP功能甚至离线语音功能加入APP功能后APP就可以修改我们产品的按键功能、LED灯效、EQ等一下配置。使得用户自己得到想要的功能在这里往往我们软件工程师做的功能逻辑会比较复杂就好比说单击功能在电话打入时单击为接听通话在电话通话时单击为挂断电话蓝牙未连接时单击为发送可发现可连接功能蓝牙连接时单击为控制音乐播放暂停这样我们软件工程师就依靠单击做出了4种功能可是用户在APP修改按键功能时往往是做不到这些功能的大多数只能修改成一种按键功能实现把软件工程师设计的按键功能给覆盖。这时候就需要一个清除APP用户配置功能、重置参数功能今天本博主就遇到了客户要求做一个五击出厂初始化配置功能要清除蓝牙连接记录并且恢复APP默认界面功能APP界面是跟着用户配置设置的。要恢复默认界面就需要实现清除手机APP用户配置功能、重置参数这也是本章的核心讲点实现方法1、首先先实现5击功能清除蓝牙连接记录这项功能代码展示2、实现清除APP用户配置、重置参数功能并耳机关机功能现在功能就实现啦下面本博主就详细讲解rcsp_setting_info_reset();app恢复默认配置函数清除用户配置、重置参数函数// #if (1) 是一个预编译指令因为条件为真(1)所以这整块代码都会被编译进最终的固件中。 // 这通常用于功能开关开发人员可以方便地通过改为 #if (0) 来禁用整个恢复出厂设置的功能。 #if (1) /** * brief 将数据写入系统配置VM/Flash的辅助函数 * param syscfg_id: 要写入的配置项的ID (例如CFG_RCSP_ADV_TIME_STAMP) * param buf: 指向要写入的数据的指针 * param buf_len: 数据的长度字节数 * return 无 * note 这是一个静态函数(static)意味着它只能在当前文件内被调用。 * 它封装了对 syscfg_write 的调用使代码更具可读性。 */ static void adv_reset_data_to_vm(u8 syscfg_id, u8 *buf, u8 buf_len) { u8 res 0; // 调用SDK提供的syscfg_write函数将buf中的数据写入到syscfg_id指定的配置地址。 // 这个函数会处理底层的Flash擦除和写入操作。 res syscfg_write(syscfg_id, buf, buf_len); // 注意这里的返回值res没有被使用。在实际产品中最好检查这个返回值以确保写入成功。 // if (res ! 0) { /* 处理写入失败的情况 */ } } /** * brief 恢复默认的APP设置恢复出厂设置的核心逻辑 * return u8: 返回0表示操作成功或无错误 * note 这个函数通过向VM中写入特定的“无效”或“默认”值来重置各项配置。 * 0xff 通常被用作“未设置”或“默认值”的标记。 */ u8 rcsp_setting_info_reset() //恢复默认的APP设置 { // 打印当前函数名用于调试日志。在最终发布版中可能会被移除。 printf(%s, __func__); // 1. 重置时间戳 u32 time_stamp 0xffffffff; // 0xffffffff是一个无效的时间戳表示从未设置过 // 将这个无效时间戳写入到 CFG_RCSP_ADV_TIME_STAMP 配置项中 adv_reset_data_to_vm(CFG_RCSP_ADV_TIME_STAMP, (u8 *)time_stamp, sizeof(time_stamp)); /* 下面这段代码被注释掉了说明“重置蓝牙名称”功能当前是禁用的。 如果启用它会把蓝牙名称设置为全0xff这通常会触发APP端显示一个默认名称或提示用户重新设置。 #if RCSP_ADV_NAME_SET_ENABLE u8 bt_name_info[32] {0}; memset(bt_name_info,0xff,32); // 用0xff填充32字节的缓冲区 adv_reset_data_to_vm(CFG_BT_NAME, bt_name_info, sizeof(bt_name_info)); #endif */ // 2. 重置按键设置 (如果宏 RCSP_ADV_KEY_SET_ENABLE 被定义为1) #if RCSP_ADV_KEY_SET_ENABLE u8 key_setting_info[4] {0}; memset(key_setting_info, 0xff, 4); // 将4字节的按键配置数据全部设置为0xff adv_reset_data_to_vm(CFG_RCSP_ADV_KEY_SETTING, key_setting_info, sizeof(key_setting_info)); #endif // 3. 重置LED灯设置 (如果宏 RCSP_ADV_LED_SET_ENABLE 被定义为1) #if RCSP_ADV_LED_SET_ENABLE u8 led_setting_info[3] {0}; memset(led_setting_info, 0xff, 3); // 将3字节的LED配置数据全部设置为0xff adv_reset_data_to_vm(CFG_RCSP_ADV_LED_SETTING, led_setting_info, sizeof(led_setting_info)); #endif // 4. 重置麦克风设置 (如果宏 RCSP_ADV_MIC_SET_ENABLE 被定义为1) #if RCSP_ADV_MIC_SET_ENABLE u8 mic_setting_info 0xff; // 单字节配置设置为0xff adv_reset_data_to_vm(CFG_RCSP_ADV_MIC_SETTING, mic_setting_info, sizeof(mic_setting_info)); #endif // 5. 重置工作模式设置 (如果宏 RCSP_ADV_WORK_SET_ENABLE 被定义为1) #if RCSP_ADV_WORK_SET_ENABLE u8 work_setting_info 0xff; // 单字节配置设置为0xff adv_reset_data_to_vm(CFG_RCSP_ADV_WORK_SETTING, work_setting_info, sizeof(work_setting_info)); #endif // 6. 重置EQ设置 (如果宏 RCSP_ADV_EQ_SET_ENABLE 被定义为1) #if RCSP_ADV_EQ_SET_ENABLE u8 eq_setting_info[10] {0}; u8 eq_setting_mode 0xff; memset(eq_setting_info, 0xff, 10); // 重置10字节的EQ数据 adv_reset_data_to_vm(CFG_RCSP_ADV_EQ_DATA_SETTING, eq_setting_info, sizeof(eq_setting_info)); // 写入EQ数据 adv_reset_data_to_vm(CFG_RCSP_ADV_EQ_MODE_SETTING, eq_setting_mode, sizeof(eq_setting_mode)); // 写入EQ模式 #endif // 7. 重置EQ高低音设置 (如果宏 RCSP_ADV_HIGH_LOW_SET被定义为1) //李永奉添加EQ高低音恢复出厂化函数// #if RCSP_ADV_HIGH_LOW_SET //1、定义一个结构体变量并初始化为默认值 struct _HIGL_LOW_VOL default_high_low_vol { .low_vol 12, .high_vol 12, }; // 2. 将这个默认值写入VM // 注意这里直接使用结构体变量而不是像其他模块一样用memset填充0xff // 因为我们的默认值是确定的12而不是一个表示“无效”的0xff。 // adv_reset_data_to_vm 函数内部实现可能类似于 syscfg_write直接写入数据。 adv_reset_data_to_vm(CFG_RCSP_ADV_HIGH_LOW_VOL, (u8 *)default_high_low_vol, sizeof(struct _HIGL_LOW_VOL)); #endif // 所有配置项重置完毕后返回0 return 0; } /** * brief 处理来自APP的充电仓相关命令 * param buf: 指向接收到的命令数据包的指针 * param len: 数据包的长度 * return u8: 返回1表示命令已处理返回0表示未处理或忽略 * note 这个函数是一个命令分发器根据buf[0]命令字来执行不同操作。 */ u8 remap_app_chargestore_data_deal(u8 *buf, u8 len) { u8 send_buf[30]; // 用于准备回复数据的缓冲区此函数中未使用 u8 ret 0; // 返回值默认为0未处理 send_buf[0] buf[0]; // 将收到的命令字复制到发送缓冲区可能用于回传确认 // 根据收到的命令字(buf[0])进行分支处理 switch (buf[0]) { case 0x08: // 命令字 0x08 代表“恢复出厂设置” // printf(\n\n\n\n\n\n---------------reset store sys\n); // 调试用的打印已注释 ret 1 ; // 标记此命令已被处理 // --- 开始执行恢复出厂设置的一系列操作 --- // 1. 声明并调用函数清除所有TWS配对信息 // bt_tws_remove_pairs() 函数会清除耳机之间以及耳机与手机之间的所有配对记录。 void bt_tws_remove_pairs(); bt_tws_remove_pairs(); // 2. 调用我们上面分析的核心函数重置所有APP相关的高级设置 extern u8 rcsp_setting_info_reset(); rcsp_setting_info_reset(); // 3. 发送一个用户控制命令删除所有远程设备信息 // USER_CTRL_DEL_ALL_REMOTE_INFO 是一个预定义的命令用于通知协议栈或其他模块清除已保存的设备信息。 user_send_cmd_prepare(USER_CTRL_DEL_ALL_REMOTE_INFO, 0, NULL); // 4. 延时60个系统时钟节拍ticks // 这个延时是为了确保前面的命令如Flash写入、消息发送有足够的时间完成。 // 具体的延时时间取决于系统的tick频率例如10ms/tick则延时600ms。 os_time_dly(60); // 5. 重启CPU // 这是最后一步也是最关键的一步。重启后系统会重新加载所有配置。 // 由于配置已经被重置为默认值耳机就恢复到了出厂状态。 cpu_reset(); break; // 处理完0x08命令后跳出switch default: // 如果收到的不是0x08命令 break; // 不做任何处理返回默认值0 } return ret; // 返回处理状态 } #endif // 结束 #if (1) #endif // 结束最外层的 #endif整体功能概述代码主要由三个部分组成1、adv_reset_data_to_vm一个辅助函数用于将数据写入系统配置VM通常指Flash中的一个区域。2、rcsp_setting_info_reset核心函数负责将所以与RCSP杰理自己的通信协议相关的高级设置恢复为默认值。3、remap_app_chargestore_data_deal命令分发函数它接收来之APP的命令。当收到特定的恢复出厂设置命令0x08时它会调用上述重置函数并执行一系列清理和重启操作。制作不易喜欢的小伙伴给个小赞赞喜欢我的小伙伴点个关注有不懂的地方和需要的资源随时问我哟