1. 问题现象与背景分析
最近在调试杰理AC79系列蓝牙芯片时，遇到一个颇为棘手的问题：当设备开启小度语音助手功能后，蓝牙名称（BR/EDR）和低功耗蓝牙名称（BLE）无法被设置为不同的值。这个现象在智能音箱、蓝牙耳机等产品开发中尤为常见，很多开发者都曾在此处踩坑。
从技术实现角度看，杰理芯片的蓝牙协议栈默认会将BR/EDR和BLE的名称字段进行同步处理。但在实际产品中，我们往往需要区分两种蓝牙名称——例如BR/EDR显示为"XiaoDu_Speaker"，而BLE显示为"XD_SPK_BLE"用于后台服务连接。这种需求在需要同时支持传统蓝牙音频和低功耗蓝牙控制的设备上尤为普遍。
2. 协议栈默认行为解析
2.1 名称同步机制原理
杰理蓝牙协议栈内部通过一个名为btif_config_set_name()的函数统一处理名称设置。当调用esp_bt_dev_set_device_name()设置BR/EDR名称时，协议栈会自动将相同的值写入BLE的GAP设备名称特征（0x2A00）。这个设计初衷是为了简化基础开发，但却给需要差异化命名的场景带来了困扰。
关键代码段示意（基于AC79 SDK）：
c复制void btif_config_set_name(const char *name) {
// 同时写入BR/EDR和BLE配置区
nv_record_update_name(name);
ble_update_gap_name(name);
}
2.2 小度模式的特殊处理
当激活小度语音服务时，SDK会强制调用一次设备重命名流程。这个过程中，duer_profile_init()函数会覆盖开发者之前设置的独立名称，将其统一为小度服务要求的固定格式。这就是为什么在普通模式下可能正常的功能，开启小度后突然失效的根本原因。
3. 解决方案与实现步骤
3.1 修改协议栈名称处理逻辑
需要在SDK中定位以下关键文件进行修改：
components/bt/host/bluedroid/api/esp_gap_ble_api.ccomponents/duer_auth/duer_profile.c
具体修改方案：
c复制// 在duer_profile.c中禁用自动命名
void duer_profile_init(void) {
// 注释掉以下自动命名代码
// esp_bt_dev_set_device_name(duer_device_name);
// 保留其他初始化逻辑
duer_gatt_profile_init();
}
3.2 独立设置双模名称
通过以下API分别设置两种名称（注意调用顺序）：
c复制// 先设置BLE名称（会被后续BR/EDR设置覆盖）
esp_ble_gap_set_device_name("XD_SPK_BLE");
// 再设置BR/EDR名称
esp_bt_dev_set_device_name("XiaoDu_Speaker");
// 强制更新GATT数据库
esp_ble_gap_config_adv_data(&adv_data);
3.3 持久化存储处理
为避免重启后配置丢失，需要在NVRAM中分别存储两个名称：
c复制void save_dual_names(void) {
nv_record_bt_set_name("XiaoDu_Speaker");
nv_record_ble_set_name("XD_SPK_BLE");
}
4. 实测验证与异常处理
4.1 验证步骤
- 使用nRF Connect扫描确认BLE名称
- 通过手机蓝牙设置界面查看BR/EDR名称
- 使用Wireshark抓包分析ADV数据包
4.2 常见异常处理
现象1：名称恢复默认值
- 检查
duer_profile_init()是否完全禁用自动命名 - 确认NVRAM存储分区有足够空间
现象2：BLE名称显示乱码
- 确保名称不超过31字节（UTF-8编码）
- 检查adv_data中的name_len参数
现象3：部分手机无法识别
- 在ADV数据中添加完整的GAP服务UUID
- 增加SCAN_RSP数据包
5. 进阶配置建议
对于需要动态切换名称的场景，建议实现以下增强功能：
- 名称热切换机制：
c复制void switch_ble_name(const char *new_name) {
esp_ble_gap_set_device_name(new_name);
esp_ble_gap_config_adv_data(&adv_data);
vTaskDelay(100/portTICK_PERIOD_MS); // 等待协议栈处理
}
- 多语言支持：
在NVRAM中存储不同语言的名称对，根据系统语言自动切换：
c复制const char *ble_name_table[] = {
[LANG_EN] = "XD_SPK_BLE",
[LANG_CN] = "小度BLE",
[LANG_JP] = "小度_BLE_JP"
};
- 生产测试接口：
通过UART命令动态配置名称，方便产线测试：
shell复制# 命令格式：AT+NAME=<type>,<name>
AT+NAME=BR,Speaker_123
AT+NAME=BLE,SPK_BLE_123
在实际项目中，我们发现当BLE名称包含特定前缀时（如"XD_"），部分iOS设备会更快建立连接。这可能是由于苹果设备对知名厂商前缀有优化处理。建议在命名规则中加入这类优化前缀，但同时要确保符合蓝牙SIG的命名规范要求。