目录引言一、 开发环境准备二、 IDE 的使用三、 烧录工具的使用Telink BDT四、 实战示例从编译到烧录五、 总结摘要本文面向初次接触 Telink BLE 芯片开发的工程师系统讲解从开发环境搭建、IDE 工程导入与编译到使用 Telink BDT 完成固件烧录的完整流程并通过实战示例帮助读者快速上手为后续 BLE 应用开发打下基础。引言本文面向初次接触 Telink BLE 芯片开发的工程师系统讲解从开发环境搭建到固件烧录的完整流程。通过本文你将掌握 IDE 的安装与工程导入、SDK 的编译方法以及使用 Telink BDT 烧录工具完成固件下载的实操步骤为后续 BLE 应用开发打下坚实基础。一、 开发环境准备1.1 工具链概览Telink IDE基于 Eclipse 的集成开发环境用于工程管理与代码编译Telink B85M SDKBLE 芯片官方软件开发套件提供协议栈与示例工程Telink BDT官方烧录工具用于将编译产物下载到芯片1.2 下载与安装从 Telink 官方 Wiki 下载 IDE、SDK 与 BDT 工具IDE 必须以管理员身份运行且必须安装到 C 盘根目录解压 SDK 时注意目录层级不宜过深建议新建 proj 文件夹作为导入路径二、 IDE 的使用2.1 工程导入打开 IDE将 proj 路径复制到导入位置点击 OK通过 File → Import 进入导入向导选择对应工程类型并点击 Next导入完成后在 vendor 目录下选择需要开发的目标工程2.2 工程编译与切换在右侧工程目录中选中目标工程点击菜单栏编译图标并勾选对应工程若工程文件显示为灰色需按步骤解锁后再进行编译编译完成后在工程根目录生成编译输出文件夹即为固件产物所在位置三、 烧录工具的使用Telink BDT3.1 烧录工具连接打开 Telink BDT 工具连接调试器与目标开发板确认芯片型号与烧录接口配置正确3.2 固件烧录流程在 BDT 中加载编译生成的固件文件点击烧录按钮等待下载完成并校验结果烧录成功后开发板即可运行新固件下面是 Telink BDT 烧录的完整流程正确错误成功失败打开 Telink BDT 工具连接调试器与目标开发板确认芯片型号与接口配置加载编译生成的固件文件点击烧录按钮等待下载完成校验结果开发板运行新固件整个烧录过程围绕「连接 → 加载 → 烧录 → 校验」四个核心环节展开。首先打开 BDT 工具并连接调试器与开发板确认芯片型号与烧录接口无误后加载编译生成的固件文件随后点击烧录按钮开始下载等待完成后进行结果校验。若校验失败需重新加载固件并再次烧录校验成功后开发板即可运行新固件。3.3 常见问题与排查问题一烧录失败现象点击烧录按钮后BDT 提示烧录失败或校验错误。原因分析固件文件未正确加载或文件损坏芯片处于写保护状态需先解锁烧录接口如 SWS接线松动或接触不良解决步骤重新加载编译生成的固件文件确认文件路径无中文或特殊字符检查调试器与开发板之间的接线确保 SWS、GND、VCC 连接牢固若芯片被写保护先在 BDT 中执行解锁操作再重新烧录更换 USB 数据线或接口排除供电不足导致的烧录中断错误提示截图占位此处可补充 BDT 烧录失败时的错误弹窗截图。问题二连接超时现象BDT 无法识别调试器提示连接超时或设备未找到。原因分析调试器驱动未正确安装USB 接口供电不足或数据线仅支持充电开发板未上电或复位电路异常解决步骤确认调试器驱动已安装可在设备管理器中查看是否识别到设备更换 USB 数据线优先使用带数据功能的高质量线缆为开发板单独供电避免仅依赖 USB 供电导致电压不稳重新插拔调试器或重启 BDT 工具后再尝试连接错误提示截图占位此处可补充 BDT 连接超时或设备未找到的提示截图。问题三芯片型号不识别现象BDT 无法识别当前芯片型号或识别到的型号与开发板实际芯片不一致。原因分析芯片型号选择错误与开发板实际芯片不匹配调试器固件版本过旧不支持当前芯片芯片未正确上电导致无法读取芯片信息解决步骤在 BDT 中手动选择与开发板一致的芯片型号如 B85M 系列升级 BDT 工具到最新版本确保支持当前芯片检查开发板供电是否正常确认芯片已上电后再重新识别若仍无法识别尝试更换调试器或联系 Telink 技术支持错误提示截图占位此处可补充 BDT 芯片型号识别失败的提示截图。常见问题快速排查表问题现象主要原因快速解决步骤烧录失败BDT 提示烧录失败或校验错误固件文件损坏、芯片写保护、接线松动重新加载固件 → 检查 SWS/GND/VCC 接线 → 解锁芯片 → 更换 USB 线连接超时无法识别调试器提示连接超时或设备未找到驱动未安装、供电不足、数据线仅支持充电安装驱动 → 更换数据线 → 单独供电 → 重启 BDT芯片型号不识别无法识别芯片型号或识别型号与实际不符型号选择错误、调试器固件过旧、芯片未上电手动选择正确型号 → 升级 BDT → 检查供电 → 更换调试器四、 实战示例从编译到烧录4.1 编译示例工程在 IDE 中打开 SDK 自带的 BLE 示例工程执行编译操作生成可烧录的固件文件下面是一个基于 Telink B85M SDK 的 BLE 示例工程骨架代码main.c涵盖系统初始化、BLE 广播、连接回调等核心流程#includedriver.h#includestack/ble/ble.h#includestack/ble/ble_common.h/* 广播数据包内容设备名称 厂商自定义数据 */staticconstu8 adv_data[]{0x02,0x01,0x06,// FlagsLE General Discoverable0x03,0x03,0x12,0x18,// Complete List of 16-bit Service UUIDs0x1812HID0x0B,0x09,T,e,l,i,n,k,// Complete Local NameTelink0x5F,0x42,0x4C,0x45};/* 连接参数间隔 30ms从机延迟 0超时 400ms */staticconstle_connection_parameter_tconn_param{.interval_min24,// 30ms单位 1.25ms.interval_max24,.latency0,.timeout320// 400ms单位 10ms};/* 连接状态回调处理连接建立与断开事件 */staticvoidapp_connect_callback(u8 e,u8*p,u8 n){if(eGAP_EVT_CONNECTED){/* 连接建立停止广播更新连接参数 */bls_ll_setAdvEnable(0);bls_l2cap_updateConnParameter(conn_param);printf(BLE connected!\r\n);}elseif(eGAP_EVT_TERMINATED){/* 连接断开恢复广播等待再次连接 */bls_ll_setAdvEnable(1);printf(BLE disconnected, restart adv...\r\n);}}/* 主函数系统初始化 BLE 协议栈初始化 广播启动 */intmain(void){/* 1. 系统时钟、GPIO、UART 等外设初始化 */cpu_wakeup_init();clock_init(SYS_CLK_16M_Crystal);gpio_set_func(GPIO_LED,AS_GPIO);gpio_set_output_en(GPIO_LED,1);uart_init(115200,UART_TX_PIN);/* 2. BLE 协议栈初始化注册连接回调 */blc_init();bls_ll_setAdvCustom(adv_data,sizeof(adv_data));bls_gap_setEventMask(GAP_EVT_MASK_CONNECTED|GAP_EVT_MASK_TERMINATED);bls_gap_registerEventCallback(app_connect_callback);/* 3. 启动广播等待主机扫描并连接 */bls_ll_setAdvEnable(1);printf(Telink BLE demo started!\r\n);/* 4. 主循环处理协议栈事件与低功耗调度 */while(1){blc_poll();// 处理 BLE 协议栈事件sleep_ms(1);// 简单延时降低功耗}}代码说明广播数据adv_data定义了设备广播时对外宣告的信息包括设备名称、支持的 Service UUID 等主机扫描时即可识别该设备。连接参数conn_param配置连接建立后的通信间隔、从机延迟与超时时间直接影响功耗与响应速度。连接回调app_connect_callback监听连接建立与断开事件。连接成功后停止广播并更新连接参数断开后恢复广播以便再次被连接。主函数main依次完成外设初始化、BLE 协议栈初始化、注册回调并启动广播最后进入主循环持续处理协议栈事件。4.2 烧录并验证使用 Telink BDT 将固件烧录到开发板通过串口或日志观察程序运行状态验证功能是否正常五、 总结本文从工具下载、IDE 安装、工程导入与编译到 BDT 烧录的完整链路进行了梳理。掌握这套流程后即可独立完成 Telink BLE 工程的开发与部署。后续可进一步深入学习 BLE 协议栈 API 与低功耗设计逐步进阶到实际产品开发。相关下载IDE下载SDK V3.4.2.1_Patch_0001烧录工具下载一、 IDE的使用必须以管理员身份运行必须安装到C:安装完毕后开始下面的导入SDK。解压压缩包如下(目录路径尽量不要嵌套文件夹太深新建 proj 文件夹作为导入路径。)打开 IDE 工具将 proj 路径 copy 到 3 位置作为工程导入路径点击 ok。E:\xxxxxx\proj点击 file进入 import 如下图操作最后点击 next。导入完成可以选择相应需要开发的工程应用工程在 vendor 目录下如图。IDE 编译工程切换操作在右边工程目录选择目标工程再点击菜单栏红框图标勾选对应工程。这时候工程还是没有被选中的如图文件都是灰色。如何解决上述问题看下面步骤点击ok后效果如图文件已经解锁。如何编译工程编译完成如图那么编译文件在位置呢在工程根目录会生成一个这样的文件夹二、 烧录工具的使用(Telink BDT)