杰理AC696N蓝牙名称修改失效问题解析与解决方案

1. 项目背景与问题描述

最近在调试JL杰理AC696N开发板时遇到了一个看似简单却让人头疼的问题：明明已经修改了配置文件中的蓝牙名称，但烧录后手机扫描到的设备名称依然没有变化。这种情况在蓝牙设备开发中并不罕见，但对于刚接触杰理平台的新手开发者来说，往往会花费大量时间在代码层面排查，而忽略了烧录工具本身的操作细节。

AC696N是杰理科技推出的一款高性能蓝牙音频SoC芯片，广泛应用于TWS耳机、蓝牙音箱等产品。其开发板配套的SDK提供了完整的蓝牙协议栈和音频处理功能，但在实际开发过程中，工具链的使用细节往往会影响基础功能的实现效果。蓝牙名称作为设备最直观的标识，其修改失败会导致产品无法正常展示品牌信息，影响用户体验和测试流程。

2. 蓝牙名称存储机制解析

2.1 配置信息的存储位置

在AC696N芯片架构中，蓝牙名称等设备配置信息存储在Flash存储器的特定区域。这个区域与程序固件（.fw文件）是分离的，通常位于Flash的配置分区。这种设计允许开发者在不重新烧录整个固件的情况下，单独更新设备配置。

芯片上电时，系统会从Flash的配置分区读取蓝牙名称等参数，并应用到蓝牙协议栈中。这意味着：

• 修改蓝牙名称需要确保新值被正确写入配置分区
• 旧的配置信息可能因为未被擦除而继续生效

2.2 两种烧录方式的差异

杰理开发环境提供了两种主要的固件烧录方式：

1. 批处理文件(.bat)烧录：

   • 执行完整的烧录流程
   • 会自动读取SDK中的配置文件（如bt_config.h）
   • 对Flash进行全量更新，包括程序区和配置区
   • 确保所有配置参数按最新设置生效

2. 固件升级工具直接烧录：

   • 仅针对.fw文件进行操作
   • 默认行为是增量更新，只覆盖程序区
   • 需要手动勾选"擦除整个Flash"才会更新配置区
   • 不擦除Flash时，原有配置信息保持不变

3. 问题根因与解决方案

3.1 问题复现与诊断

通过以下步骤可以复现该问题：

1. 修改SDK中的bt_config.h文件，更新BLUETOOTH_NAME定义
2. 使用固件升级工具烧录编译生成的.fw文件
3. 不勾选"擦除整个Flash"选项
4. 烧录完成后，手机扫描到的蓝牙名称仍为修改前的值

使用杰理调试工具读取Flash内容可以发现：

• 程序区已更新为新版本固件
• 配置区的蓝牙名称字段仍保持旧值
• 证明烧录方式影响了配置更新

3.2 可靠解决方案

根据不同的开发场景，推荐以下解决方案：

方案一：统一使用批处理烧录（推荐）

bash复制# 在SDK根目录执行烧录脚本
./download.bat AC696N_DEMO

优点：

• 自动处理所有配置更新
• 减少人为操作失误
• 确保配置与固件版本匹配

方案二：固件工具烧录时强制擦除

1. 打开杰理烧录工具
2. 选择目标.fw文件
3. 勾选"擦除整个Flash"选项
4. 点击"升级"按钮执行烧录

注意：频繁全擦除会降低Flash寿命，建议在调试阶段使用，量产时改用方案一

方案三：单独更新配置分区

1. 使用杰理配置工具生成.cfg文件
2. 通过专用命令只烧录配置分区：

bash复制program_config --chip AC696N --port COM3 --file new_config.cfg

4. 深入技术细节

4.1 Flash分区布局

AC696N的典型Flash布局如下：

蓝牙名称存储在Config分区的0x084100偏移地址处，长度为32字节。

4.2 名称更新流程

完整的蓝牙名称更新涉及以下步骤：

1. 编译时：

   • SDK从bt_config.h读取BLUETOOTH_NAME宏
   • 将字符串写入固件文件的配置段
   • 生成包含配置的完整.fw文件

2. 烧录时：

   • 烧录工具解析.fw文件
   • 根据选项决定是否擦除Config分区
   • 将新配置写入Flash

3. 运行时：

   • 蓝牙协议栈从Flash读取名称
   • 在广播包中携带该名称
   • 响应手机的名称查询请求

4.3 其他影响因素排查

如果按照正确方式烧录后名称仍未更新，还需检查：

1. 缓存问题：

   • 手机蓝牙缓存了旧名称
   • 解决方法：忘记设备后重新扫描

2. 广播间隔：

   • 过长的广播间隔导致更新延迟
   • 调整BLE_ADV_INTERVAL参数

3. 代码覆盖：

   • 应用程序动态修改了蓝牙名称
   • 检查是否有调用bt_set_device_name()

5. 开发实践建议

5.1 调试技巧

1. 名称验证工具：

c复制// 在应用中添加名称验证代码
printf("Current BT name: %s\n", bt_get_device_name());

2. Flash内容检查：

bash复制# 使用杰理调试工具dump Flash内容
jldbg --chip AC696N --read --addr 0x084100 --len 32 --output btname.bin

3. 广播包嗅探：

• 使用nRF Connect等工具捕获广播包
• 验证广播中的名称字段

5.2 量产注意事项

1. 批次一致性：

   • 确保所有设备使用相同的烧录流程
   • 建立烧录日志审计机制

2. 版本管理：

   • 固件版本与配置版本绑定
   • 实现配置回滚能力

3. 工具链选择：

   • 量产推荐使用批处理脚本
   • 配合自动化测试设备验证名称

5.3 扩展应用

利用配置分区还可以实现：

1. 动态名称更新：

   • 通过蓝牙服务修改名称
   • 需要实现配置分区的擦写驱动

2. 多语言支持：

   • 根据不同区域加载不同名称
   • 通过GPS或IP识别地区

3. OTA名称更新：

   • 在OTA包中包含新配置
   • 安全考虑：需要签名验证

6. 常见问题速查表

7. 工具链优化建议

1. 自定义烧录脚本：

python复制# 示例Python自动化烧录脚本
import serial
import time

def flash_firmware(port, fw_path):
    ser = serial.Serial(port, 115200, timeout=1)
    ser.write(b"erase_flash\n")
    time.sleep(5)  # 等待擦除完成
    with open(fw_path, 'rb') as f:
        ser.write(f.read())
    ser.close()

2. 持续集成集成：

• 在Jenkins/GitLab CI中添加名称验证步骤
• 自动对比配置文件和实际设备名称

3. 开发环境配置：
   • 统一团队的工具链版本
   • 建立标准的烧录流程文档
   • 在SDK中提供预配置的批处理文件

通过系统性地理解AC696N的配置管理机制，开发者可以避免蓝牙名称修改这类基础问题，将更多精力投入到产品核心功能的开发上。记住在嵌入式开发中，工具链的细节往往决定着调试效率，建立规范的操作流程至关重要。