泰凌Telink IoT Studio开发指南：快速上手Telink芯片开发

关注

原创最新推荐文章于 2026-11-06 08:42:01 发布 1.9k 阅读 AI 写同款· GEO 优化 ›

Telink泰凌微TLSR8258蓝牙开发笔记（一）导入工程后，切换编译选项为825x_module，此时编译会出现错误。二、运行例程，并使能打印调试信息功能。8258开发板+烧录工具一套。1.1.3、蓝牙SDK。1.1.2、烧录工具。1.2、硬件开发环境。阅读详情

泰凌 TLSR8 系列 TLSR9 系列321x系列以及721x系列芯片采用自研内核，为了让开发者顺利开展基于这些芯片的项目开发，泰凌提供了专属的开发环境、烧录工具和量产工具。

今天，我们就来介绍 Telink IoT Studio 的使用方法，助你快速搭建开发环境，轻松导入SDK，开启物联网开发之旅。

一、Telink IoT Studio：专属开发环境

01 下载与安装

想要使用 Telink IoT Studio，首先需要进入泰凌官方wiki网站（https://wiki.telink-semi.cn/wiki/）下载安装包。

目前提供了 Windows_v2025.02 和 Linux_v2025.02 两个版本，大家可以根据自己的操作系统选择。

需要注意的是，安装前请务必卸载旧版本，并且使用管理员权限进行安装。同时，你可以根据自己的需求将安装路径更改到 D 盘等非系统盘。

图片2.png

02 workspace设置

第一次打开 Telink IoT Studio 时，会弹出 workspace 设置界面。建议设置一个有效的路径，比如 “D:\work\workspace”，这样可以将所有用到的软件 SDK 集中放在该目录下，方便管理多个 SDK。如果勾选 “Use this as the default...”，后续打开软件就不会再提示设置 workspace 了。

图片4.png

二、软件SDK：开发的得力助手

Telink 的软件 SDK 包含基础驱动库、协议栈、应用示例以及调试工具等，能帮助开发者快速上手。SDK 中的工程 Demo 覆盖了蓝牙连接、数据传输、设备控制等常见应用场景，开发者可参考或直接集成到自己的项目中。

不过要提醒大家，针对不同芯片和应用场景，泰凌提供了不同的 SDK 和工程 Demo，开发前一定要跟销售或 FAE 人员确认清楚哦！

01 软件SDK说明

泰凌官方提供的 SDK 与芯片型号对应，不同应用场景的 SDK 还对应不同的 Handbook，开发前仔细阅读手册能解决大部分问题。

例如基于B91系列常见的 SDK 有：

Bluetooth® LE Multi Connection：多连接应用 SDK，可同时连接多个从机，最大支持 4 主 4 从，例程中定义了具体配置方式。
Bluetooth® Mesh：也叫 SIG mesh，基于蓝牙官方 mesh spec 开发，可与其他厂商的 SIG mesh 设备互联互通。
Zigbee：基于 Zigbee 3.0 的 SDK。
Zigbee + Bluetooth® LE Concurrent Mode：Zigbee 3.0+ble 并发模式。
Platform：包含芯片各个外设的 demo 例程的外设驱动 SDK。

02 软件SDK导入

（1）路径选择

SDK 工程路径不要放置过深，否则可能出现编译错误。在路径中能查到版本号，方便追溯，当开发中遇到问题需要原厂帮忙分析时，提供对应的软件版本号能提高解决问题的效率。

图片6.png

（2）SDK 工程文件修改

由于 Telink IoT Studio 通过工程名字防止同一工程重复导入，所以导入多个 SDK 和工程时需要修改工程名字。

图片7.png

泰凌 SDK 会提供多个型号芯片的导入，在对应芯片型号目录下的.project 文件里进行修改即可。

图片8.png

图片9.png

（3）Telink IoT Studio 的导入

导入步骤如下：

点击 File --> Import，或者在 project explorer 区域右键选择 “Import”。
在Import 窗口中选择 “Existing Projects into Workspace”，点击 “Next”。
点击“Browse...”，选择 SDK 工程路径，比如 “D:\Telink_customer_new_ide\test\tl_ble_sdk-V4.0.4.4” 文件夹并确认，此时 Projects 区域会显示可导入的工程名称，与修改后的名称一致。
最后点击 “Finish” 完成导入。如果工程名称灰掉不能选择，说明已存在同名称工程，需修改名称后再次导入。

03 常见操作及注意事项

（1）project build 和 project clean

以多连接为例，软件 SDK 中有很多编译选项，以B91 ble多连接sdk为例，如 acl_central_demo、acl_peripheral_demo 等例程。点击小锤子后面的下拉三角号，选择要编译的例程即可。若不切换例程，重复编译同一例程，也可点击 Project --> build project 进行编译。

点击 Project --> Clean...，在弹出的界面选择对应的 project，点击 OK 即可 Clean project。

图片13.png

（2）文件修改注意事项

在IDE里面修改了.h文件，一定要clean后再编译。且修改了.c和.h文件一定要手动保存，否则修改不生效。

（3）函数跳转

跟踪函数实现有两种方式：

按住 Ctrl 键，当鼠标光标变成手型时，点击鼠标左键。
右键该函数，点击 “Open Declaration”。

（4）查找

使用快捷键 “Ctrl + H” 打开 Search 窗口，在 File Search 页面，Containing text 中输入要查找的函数名称，点击 “Choose...” 选择文件类型，再点击 Search，即可显示该 project 中所有用到该函数的地方。

如下图所示，在Search窗口中，会显示出来该project中，所有用到 blc_ll_setScanParameter()函数的地方。

图片14.png

图片15.png

（5）固件大小

编译成功后，在 Console 窗口会显示编译结果，其中 dec 是十进制显示的固件大小，hex 是十六进制显示的固件大小。

图片16.png

（6）加快编译速度

受电脑性能影响，编译工程可能较慢。可以按照以下步骤设置：Project --> Properties --> C/C++ Build --> Behaviour --> 勾选 “Use Parallel build” --> Apply and Close，使能并行编译加快速度。

图片17.png

（7）禁止自动编译

若自动编译给开发带来不便，可按照以下方式禁止：Project --> Build Automatically，去掉 Build Automatically 前面的对号。

图片18.png

（8）隐藏打印边距

图片19.png

默认情况下，代码编辑器中会显示一条垂直线作为打印边距。如果想隐藏，可点击 Window --> Preferences，在弹出的界面选择 General --> Text Editors，取消勾选 “Show print margin”，然后点击 Apply and Close。

图片20.png

三、给开发者的建议

基于TLSR8系列芯片的软件 SDK 都是裸机的，没有操作系统，而且芯片不支持中断的嵌套和中断的抢占，所以在中断处理上要优先处理蓝牙协议栈的中断。

蓝牙是强时序要求的协议栈，像蓝牙包的间隔和 ack 的回复要求都是 us 级别的，这对软件设计提出了较高要求，要避免关闭中断或者让中断代码处理占用太长时间。

在代码流程设计和 debug 方面，有这些小技巧：

谨慎使用 WaitUs ()、WaitMs ()、sleep_ms () 等函数，它们通过 while 等待实现，会浪费 MCU 时间。可以使用 clock_time_exceed () 函数做查询式处理，或用软件定时器处理。
Flash 的读写擦操作会关闭中断，操作不当会导致蓝牙时序混乱，要参考 handbook 的 “Flash” 章节。
调试过程中多使用 log 打印，清楚数据的来龙去脉，也可以用加减法的思路定位问题，即增加或减少模块功能来验证问题是否复现。

如果开发中需要外部资源协助，要把问题描述得越详细准确越好，包括问题的背景、复现步骤、具体现象、自己 debug 的调试信息，以及在默认 SDK 代码上做最小改动复现问题的情况，这样能帮助他人更好地诊断问题。

希望这份指南能帮助你顺利使用 Telink IoT Studio 开展开发工作，如果你还有其他疑问，欢迎在评论区留言交流！

了解更多产品信息，请联系我们的销售团队或访问泰凌微官网。