中科蓝讯SDK开发-中科蓝讯蓝牙测试盒使用教程
前言现在为止也开发了许多杰理和中科蓝讯蓝牙芯片的TWS蓝牙耳机、音响项目 SDK 的案子在调试案子时不断的向前辈们学习到了很多关于蓝牙音响、蓝牙TWS耳机专业的知识。想在这里做一个学习汇总方便各位同行和对中科蓝汛芯片SDK感兴趣的小伙伴们学习本章详细讲解中科蓝讯蓝牙测试盒使用教程本文档基于官方原版手册重构按「入门操作→核心功能→进阶配置→固件维护→故障排查」的逻辑重新梳理优化操作步骤与重点提示更适合产线快速查阅与新手上手。一、产品概述与硬件说明本设备是中科蓝讯专为 TWS 蓝牙耳机产线设计的双通道蓝牙测试盒支持蓝牙搜索连接、音乐 / 通话测试、频偏校准、快速配对、OTA 升级、芯片筛选等全流程产测功能适配蓝讯全系列蓝牙音频芯片。硬件显示界面标识1、12V 电源接口设备直流供电输入2、电源开关控制整机通断电3、双通道显示屏上下分区对应通道 1#1、通道 2#2可显示蓝牙名称、连接状态、频偏值、蓝牙地址、测试进度等信息4、通道 1 / 通道 2 按键分别对应两个通道的功能操作支持短按、长按、双击三种触发方式5、拨码开关硬件级功能切换共 3 位6、TF 卡 / USB 接口用于固件升级拨码开关功能速查表拨码编号拨至 ON 状态功能拨至 OFF 状态功能1频偏校准值自动回写到样机芯片仅测量频偏数值不写入样机2保留未定义功能保留3通话测试使用测试盒自带喇叭发声通话音频输出至样机端二、基础功能操作指南蓝牙搜索与连接1、打开电源开关测试盒自动进入蓝牙搜索模式通道 1 显示Inquiry代表正在搜索2、搜索到周围蓝牙设备后屏幕显示设备名称与蓝牙地址3、测试盒自动与目标设备建立蓝牙连接连接成功后进入默认测试流程发射功率调节用于适配不同距离、不同 RF 性能的耳机调节结果会开机默认保存。1、双击通道 1 按键进入发射功率TXPWR调节界面界面通过的数量直观显示当前功率等级2、短按通道1按键减小发送功率/长按通道1按键快速减小发送功率短按通道2按键增加发送功率/长按通道2按键快速增加发送功率3、3秒无按键操作设置自动保存并退出当前界面音乐与通话测试1、蓝牙连接成功后测试盒自动播放内置测试音乐进入音乐测试状态2、按下样机的通话 / 回拨按键可自动接通通话通路测试上行、下行音频质量3、配合拨码 3 可切换通话音频的输出端测试盒喇叭 / 耳机端频偏测试与校准测试过程中自动实时测量样机蓝牙频偏计算校准值。1、屏幕显示格式示例cc: -15k [25]前者为当前实测频偏值后者为校准值2、将拨码 1 拨至 ON校准值会自动写入样机芯片完成频偏校准拨至 OFF 仅测量不写入按键功能测试在音乐 / 通话状态下按下样机的播放暂停、上下曲、音量加减按键1、测试盒屏幕会同步显示对应按键功能名称2、蜂鸣器发出「滴」的一声提示识别成功3、5 秒后按键显示自动消失等待下一次按键触发三、快速测试/配对VUSB专题该功能通过充电仓 VUSB 引脚与耳机通讯实现 2 秒快速配对、4 秒完成全功能测试是产线提速的核心功能。两种模式区别模式功能范围适用场景快测完成左右耳配对 蓝牙连接 全项功能测试成品综合测试工位快配仅完成左右耳配对不连接蓝牙、不做功能测试单纯配对工位速度更快硬件要求1、xlink 调试器硬件版本必须为 V4.0烧录 v022 及以上带vusb标识的固件背面 R4 阻值 1K、R1 阻值 2K2、测试盒改造更换分压电阻推荐 39K:11K比例约 3.5:1 即可3、配对充电仓仓内不能有额外电路板避免左右耳 VUSB 信号4、测试盒固件更新至蓝皮书发布的最新版本插入 xlink 后屏幕显示xlinking、xlink 红灯持续闪烁代表通讯正常耳机端软件配置在SDK中将VUSB快速测试的功能打开测试盒端程序配置在测试盒配置工具的「快速测试 / 配对」页面按需开启对应功能1、配对响声使能配对成功后蜂鸣器提示2、XLINK 模式选择切换快测 / 快配模式3、耳机拿起后状态设置耳机离开仓后的默认动作4、蓝牙地址显示、校验码匹配、版本号匹配等辅助功能标准操作步骤将左右耳机同时放入支持 VUSB 的充电仓充电仓对接 xlink测试盒自动识别并启动对应流程屏幕显示「已配对」代表配对完成快测模式会自动接续蓝牙测试若耳机固件固定了左右声道测试盒会显示 L/R 标识自动分配声道的机型不显示【注意】单耳入仓不会触发配对地址写入必须双耳同时在仓内才能完成完整配对。序号功能名称功能说明支持版本要求1XLINK 快速测试 / 配对三种模式可选仅连接测试、配对 全测试、仅配对全版本支持2升级完成后自动快测 / 快配OTA 升级结束后自动执行对应操作全版本支持3耳机拿起后状态可选关机、复位、断开蓝牙后关机、断开蓝牙后复位OTP 芯片暂不支持4显示蓝牙地址使能连接后在屏幕显示样机蓝牙地址全版本支持5耳机校验码匹配使能左右耳校验码不一致则配对失败防止混料892×2 S1079 / 889X S2316 / 5656A2 S650 及以上6耳机版本号匹配使能配对 ID 一致才可配对防跨版本混料892×2 S1079 / 889X S2316 / 5656A2 S617 及以上7显示耳机信息使能屏幕显示耳机校验码与配对 ID892×2 S1079 / 889X S2316 / 5656A2 S617 及以上8向耳机传入参数写入 1 字节数据耳机端可自定义触发动作892×2 S1079 / 889X S2316 / 5656A2 S617 及以上9获取耳机配对情况检测配对状态异常时显示对应错误码5656A2 S650 及以上10程序筛选校验码与预设校验码不一致则报警防错料错版本全版本支持掉配对问题专项排查常见原因1、左右耳固件版本、GUID、蓝牙名、校验码不一致2、耳机被单独清除过连接信息或测试盒配对流程执行失败3、产线混料左右耳不属于同一配对组4、配对完成后单耳单独入仓触发了配对信息清除5、多台耳机同时裸机开机自由配对冲掉原有配对关系6、OTA 升级过程中清除了配对信息产线预防方案1、优先更新测试盒至最新固件修复配对流程已知问题2、配对完成后禁止单耳单独入仓必须双耳同时存放3、开启「TWS 单次配对」功能禁止耳机出厂后自由重配对4、优化清除配对的触发逻辑避免误触发5、5376T2/5616E2 芯片不支持测试盒配置拿起状态需在耳机固件内单独设置四、测试盒固件升级与维护方式一UPD 文件升级产线推荐无需安装工具适合批量快速升级。1、将tsbox_v1.upd固件文件放入 FAT32 格式的 TF 卡 / U 盘根目录2、测试盒断电状态下将存储设备插入通道 1 接口3、开机后自动启动升级V267 及以上版本显示Update Fw4、通道 1 升级完成并重启后再将存储设备插入通道 2 接口完成第二通道升级5、通道 2 显示ok新版或pause旧版代表升级完成手动重启整机【重要】两个通道必须升级同版本固件否则会出现通道 2 工作异常。方式二DCF 文件升级改配置用适合修改功能参数、匹配规则后烧录。1、打开 Downloader 工具加载测试盒 DCF 配置文件选择「testbox」配置项2、修改对应参数后保存3、测试盒保持断电点击工具下载按钮显示「扫描中」后再打开测试盒电源4、分别完成通道 1、通道 2 的烧录【高危警告】严禁点击工具中的「擦除」按钮擦除后校准数据丢失必须寄回原厂恢复。五、更换测试盒内置测试音频使用官方音频转换工具将目标音频转为testsong.sbc格式双声道方案使用专属转换工具替换工具路径下TBOX\Settings\Resources\TestSong\en\中的同名文件重新下载固件到测试盒即可生效六、故障排查大全通用常见故障故障现象原因解决方法开机一直显示 Inquiry搜不到设备开启了蓝牙名称匹配周围无符合设备通过 DCF 配置关闭名称匹配重新烧录固件通道 2 显示异常一直横杠或 pause两通道固件版本不一致使用同版本固件重新升级通道 2快测 / 配对类故障快测无反应、无显示软件排查用标准 SDK 公版 demo 测试公版正常则排查客户固件修改点确认 VUSB 宏已开启硬件排查拆掉配对仓内电路板确认 xlink 为 V4.0 且固件正确用示波器测 xlink RX 脚是否有 5V/0V 跳变波形显示 Connect 但蓝牙连不上调大测试盒发射功率重试用手机搜索耳机若也搜不到则判定为耳机 RF 硬件故障检查芯片与天线电路配对失败错误码速查错误码失败原因排查方向01蓝牙名称不匹配确认左右耳名称一致与测试盒配置匹配02GUID 不匹配确认左右耳固件 GUID 设置一致03声道分配异常确认耳机不是同左 / 同右声道配置正确04特征值不匹配确认左右耳固件功能配置、版本一致05校验码不匹配确认左右耳为同一版本固件无混料06配对码不匹配确认左右耳配对码配置一致6.3 升级错误码速查通用错误码测试盒 V169 及以上错误码错误原因排查方向2_X配置信息检测异常X1蓝牙名超长X2空 OTP 不支持改名3_0下载驱动异常重新获取完整升级文件4_0驱动校验错误格式化 TF 卡重新拷贝文件6_0芯片 key 不匹配确认升级文件与芯片带 key / 不带 key对应7_0进入升级失败检查耳机 RF、固件升级协议兼容性8_0读取文件头异常格式化存储设备检查文件完整性11_0Flash 写入异常检查耳机 Flash 焊接与质量16_0OTP 预校验异常升级文件与芯片原有程序不对应21_0GUID / 地址错误升级文件 GUID 与耳机不一致Init(50/51)进入升级失败检查耳机 RF、软件与文件兼容性AB530X/AB532X 系列专属错误错误码含义-1升级文件无效-2文件头 CRC 错误-5项目不匹配-6Key ID 不匹配七、OTA升级1、务必先用Downloader设置匹配蓝牙名称使用dcf下载注意有两个通道2、将待升级的文件fw5000.upd拷入TF卡并插入测试盒TF卡座3、测试盒上电左上角显示心形图标4、测试盒搜索到后自动OTA升级5、升级完毕样机自动复位6、样机重新开机后再次被测试盒连上进入音乐测试OTA实用功能配置八、OTP升级将OTPfw5000.upd升级文件放入TF卡或者U盘中测试盒会有如下显示按提示单击对应通道的按钮即可进入OTP升级操作。非OTP升级文件没有这个操作该操作是为了提醒操作人员此为OTP升级九、注意事项升级过程中严禁断电避免测试盒或耳机变砖测试盒校准数据不可擦除日常升级仅使用 UPD 或正常下载模式产线批量使用时建议定期核对测试盒固件版本保持工位版本一致测试盒固件与技术文档可通过中科蓝讯蓝皮书平台获取