如何修改杰理蓝牙固件的默认蓝牙名称？

Question

如何修改杰理AC69系列蓝牙固件的默认蓝牙名称？在使用杰理（JL）AC69xx芯片开发蓝牙音频设备时，开发者常需自定义蓝牙配对名称（如“JL_Speaker”改为“CustomBT”）。该名称通常存储于固件的配置区或字符串表中。常见问题包括：修改后名称未生效、设备仍显示旧名称、或重命名后导致连接异常。需确认是否正确修改了SDK中的BT_NAME宏定义，或在资源文件中更新了对应语言的字符串表，并确保重新编译并烧录完整固件。此外，手机端可能缓存旧名称，需清除蓝牙配对记录验证。如何正确操作才能确保新名称稳定显示？

Answer 1

一、杰理AC69系列蓝牙名称修改：从基础到深入

在使用杰理（JL）AC69xx芯片开发蓝牙音频设备时，自定义蓝牙配对名称是一个常见且关键的配置需求。默认名称如“JL_Speaker”往往不符合产品品牌定位，开发者需要将其更改为“CustomBT”等更具辨识度的标识。本文将系统性地解析如何正确修改蓝牙名称，并确保其稳定生效。

1. 蓝牙名称的存储机制与作用域

杰理AC69系列芯片的蓝牙名称通常由固件中的字符串常量控制，该名称在BLE广播包和经典蓝牙SDP服务中对外广播。名称可能存在于以下两个位置之一：

• SDK宏定义：在工程配置头文件中通过#define BT_NAME "JL_Speaker"方式定义；
• 资源语言表：多语言支持下，名称可能存于res/language/zh_cn.str或类似资源文件中，以键值对形式存在。

理解名称来源是修改的第一步，否则即使修改了错误位置，也无法生效。

2. 修改方法路径分析

根据项目结构不同，存在两种主流修改方式：

修改方式	适用场景	文件路径示例	是否需重新编译
修改BT_NAME宏	单语言、SDK默认配置	app_config.h 或 bt_config.h	是
更新资源字符串表	支持多语言产品	res/language/en_us.str	是（需打包资源）
动态设置API调用	运行时个性化命名	app_main.c 中调用 bt_set_name()	否（但需烧录新逻辑）

3. 操作步骤详解

1. 确认当前名称来源：搜索整个工程目录中的“JL_Speaker”，定位其定义位置；
2. 若在bt_config.h中发现#define BT_NAME "JL_Speaker"，直接修改为#define BT_NAME "CustomBT"；
3. 若使用资源系统，打开对应语言的.str文件，查找ID_STR_BT_NAME=JL_Speaker并改为ID_STR_BT_NAME=CustomBT；
4. 保存更改后，清理工程（Clean Project），防止缓存导致旧字符串残留；
5. 重新编译生成完整固件（Full Image），确保所有段落（包括.rodata）被更新；
6. 使用烧录工具（如JLink或专用下载器）擦除整片Flash并写入新固件；
7. 上电后开启手机蓝牙扫描，观察设备是否显示新名称；
8. 若仍显示旧名，进入下一步排查；
9. 清除手机蓝牙配对记录，因Android/iOS会缓存远端设备名称；
10. 重启设备蓝牙模块，或断电再上电以触发重新广播。

4. 常见问题与深度排查

尽管按上述流程操作，仍可能出现名称未更新的情况。以下是典型问题及其根源：

• 问题1：修改后名称未生效 —— 可能未重新编译资源包，或修改了错误的语言文件；
• 问题2：部分手机显示旧名 —— 手机端蓝牙缓存未清除，建议在设置中“忘记此设备”；
• 问题3：连接异常或无法配对 —— 名称过长（超过24字节UTF-8编码）导致广播包溢出；
• 问题4：烧录后恢复默认名 —— 固件未完整烧录，或存在出厂配置区（如efuse）锁定名称；
• 问题5：双模蓝牙名称不一致 —— BLE与Classic BT分别设置，需检查两处配置。

5. 高级调试手段与验证流程

对于资深开发者，可借助专业工具进行底层验证：

// 示例：在app_main.c中动态设置蓝牙名称
void set_custom_bt_name() {
    const char *new_name = "CustomBT";
    bt_update_local_name(new_name);
    syscfg_write(CFG_ID_BT_NAME, (u8*)new_name, strlen(new_name));
}
    

通过调用bt_update_local_name()函数可在运行时更改名称，并持久化至syscfg分区。此外，使用nRF Connect或Wireshark抓取空中包（Over-the-Air Packet），可直接查看广播数据中的Local Name字段，确认是否已更新。

6. 流程图：蓝牙名称修改与验证全过程

graph TD
    A[开始] --> B{名称来源是宏定义还是资源?}
    B -->|宏定义| C[修改BT_NAME宏]
    B -->|资源文件| D[编辑对应语言.str文件]
    C --> E[清理并重新编译工程]
    D --> E
    E --> F[烧录完整固件到Flash]
    F --> G[设备上电启动]
    G --> H[手机扫描蓝牙设备]
    H --> I{显示CustomBT?}
    I -->|否| J[清除手机蓝牙缓存]
    J --> K[重新扫描]
    K --> L[确认是否生效]
    I -->|是| M[修改成功]
    L --> M
    

7. 稳定性保障建议

为确保新名称长期稳定显示，建议采取以下措施：

• 限制名称长度在18字符以内，避免UTF-8编码超出HCI限制；
• 在多个手机平台（Android 12+、iOS 16+）进行兼容性测试；
• 启用固件版本管理，记录每次名称变更的commit信息；
• 若支持OTA升级，确保新名称随固件同步下发；
• 避免在中断上下文或低功耗状态下修改名称，防止状态紊乱。