【中科蓝讯】SDK 环境搭建与烧录
发布时间:2026/8/6 21:59:10 作者:尧图编辑部 阅读量:1,286

以我最近实际接触的中科蓝讯 BT891x 项目为例刚开始最先要做的就是把开发环境搭起来准备资料和工具、打开工程、编译生成app.dcf再用 Downloader 完成后续烧录。不同 SDK 版本和开发板的目录、工具版本可能不一样最终以当前资料包和工程说明为准。一、准备资料和工具如果手上的 SDK 对应特定的 TWS 开发板原理图和相关硬件资料也要一并保存好后面核对硬件配置、下载和外设问题时都会用到。刚开始做 BT891x 时主要先准备下面四项资料和工具内容先拿它做什么BT891x 固件 SDK后续的功能开发主要就在这里进行CodeBlocks 开发环境打开.cbp工程并发起编译RV32 Toolchain供 CodeBlocks 调用的 RISC-V 编译工具链Downloader读取app.dcf进行配置和烧录处理如果当前使用的是串口下载方式还要保留蓝讯提供的串口驱动。资料包里的驱动通常以 CP210x 驱动包的形式提供用于让电脑识别 CP2102 或 XLink 模块对应的 COM 口。CodeBlocks 和 RV32 Toolchain 都是双击安装程序后按提示一路选择Next、默认路径安装即可。CodeBlocks 用来打开.cbp工程并编译RV32 Toolchain 是真正执行编译的工具。如果使用串口下载按当前下载器对应的驱动安装即可。下载器和设备接入电脑后系统能够识别出 COM 口Downloader 才能继续扫描设备。Downloader 不需要安装解压后直接运行Downloader.exe即可。二、编译与烧录环境装完后先在 CodeBlocks 中打开 SDK 里的.cbp工程并编译一次。第一次打开工程时可以在Settings - Compiler中确认当前编译器为RISCV32。如果列表里没有这个选项通常是 RV32 Toolchain 没有安装成功或者版本和 SDK 不匹配。确认后直接编译编译日志没有报错就说明环境基本跑通了。编译通过后到当前工程目录下的Output\bin查看构建产物。后面 Downloader 会使用其中的app.dcf。接入下载器和设备后打开 Downloader先让DownFile指向当前工程刚生成的Output\bin\app.dcf然后在“配置”中勾选当前工程对应的配置打开串口并确认 Downloader 已经识别到 COM 口。状态显示串口正常打开后再点击“开始”烧录。三、CP2102 和 XLink 两种串口模块下载时Downloader 是电脑端的软件它需要通过串口模块和耳机通信。以我看到的使用说明来说常见的是 CP2102 和 XLink 两种串口模块方案。CP2102 是常见的 USB 转串口模块。如果接到耳机的单线通信 IO 上需要在 TX 和 RX 之间增加 200 Ω 电阻把原本的双线串口方式转换成单线通信方式。XLink 可以理解为蓝讯提供的成品串口模块。它和 CP2102 的用途相同但模块内部已经在 TX 和 RX 之间集成了 200 Ω 电阻使用时不需要再自己额外加这一颗电阻。不管用哪种模块电脑端都是通过 Downloader 选择app.dcf、打开对应 COM 口后再发起烧录。四、写在最后前面这套流程里CodeBlocks 主要负责打开工程和编译Downloader 负责烧录。日常浏览、搜索和修改代码时我个人更习惯用 VS Code。它的插件生态比较丰富代码搜索、跳转和 C/C 语法提示用起来也更顺手。我会直接用 VS Code 打开 BT891x SDK 根目录后续改代码主要在这里完成需要生成固件时再回到 CodeBlocks 打开.cbp工程编译然后用 Downloader 烧录。