一文看懂泰凌 SDK

TL_MENGWEI · 发表于 3 小时前

社区里新朋友最常问的一个问题是：“泰凌的 SDK 仓库这么多，我到底该选择哪一个？”这篇帖子就是为回答它而写的。我们把 Gitee / GitHub 上对外发布的 SDK 梳理成一张地图，讲清楚三条主线——芯片系列、软件体系、无线协议。读完这五分钟，你应该能直接定位到适合自己的那个仓库，并且知道下一步去哪里。

一、先认识一下泰凌

<div align="left">泰凌微电子（Telink Semiconductor）致力于研发高性能、低功耗的物联网无线连接 SoC，产品覆盖蓝牙低功耗（BLE）、经典蓝牙、蓝牙 Mesh、Zigbee、Thread、Matter、Wi-Fi 以及 2.4GHz 私有协议等多种连接技术，广泛应用于智能家居、无线音频、人机交互设备（键鼠/遥控器）、智慧零售（ESL）、工业物联网与汽车电子等领域。</div><div align="left">协议多，对应的 SDK 自然也多——这正是写这篇总览帖的原因。</div><div align="left">
</div>二、我们的开源布局：代码、文档、论坛

我们把所有对外发布的 SDK 都放在开源社区上，欢迎 Star、Fork、提 Issue：
<ul><li>Gitee：<a href="https://gitee.com/telink-semi" target="_blank">https://gitee.com/telink-semi</a><li>GitHub：<a href="https://github.com/telink-semi" target="_blank">https://github.com/telink-semi</a>
</ul><div align="left">
</div><div align="left">配套资源一站直达：
<table cellspacing="0" class="t_table" ><tr><td>资源
</td><td>链接
</td><td>说明
</td></tr><tr><td>官网
</td><td><a href="https://www.telink-semi.cn/" target="_blank">https://www.telink-semi.cn/</a>
</td><td>产品中心、应用方案、芯片选型与 SDK 版本对照</td></tr><tr><td>文档中心
</td><td><a href="https://doc.telink-semi.cn/doc/zh/" target="_blank">https://doc.telink-semi.cn/doc/zh/</a>
</td><td>中英文开发手册、Get Started、Developer Handbook</td></tr><tr><td>技术论坛
</td><td><a href="https://forum.telink-semi.cn/" target="_blank">https://forum.telink-semi.cn/</a>
</td><td>有问必答，技术团队支持
</td></tr></table>

三、认识芯片：TC系列与TL系列</div>
选 SDK 之前，先要知道自己用的是哪一系列芯片——Telink SDK 的命名规则与芯片系列直接对应：

<table cellspacing="0" class="t_table" ><tr><td>
</td><td>TC 系列
</td><td>TL 系列
</td></tr><tr><td>MCU 内核
</td><td>Telink 自研 TC32 MCU core
</td><td>RISC-V MCU core
</td></tr><tr><td>典型型号
</td><td>TLSR825X / TLSR827X / TC321X / TC122X / TC123X
</td><td>TLSR951X / TLSR952X / TL751X / TL752X / TL721X / TL321X / TL322X / TL323X
</td></tr><tr><td>对应驱动 SDK
</td><td>tc_platform_sdk
</td><td>tl_platform_sdk
</td></tr></table>
小贴士：具体芯片选型及对应支持的SDK 信息，可从<a href="https://www.telink-semi.cn/" target="_blank">官网</a>查看。

四、SDK 总体架构：三层结构，层层递进

Telink 的 SDK 体系可以概括为「平台驱动层 → 协议栈层 → 应用与垂直方案层」的分层架构：

<ignore_js_op>
SDK架构图
<img src="data/attachment/forum/202609/03/233417pfv7nzhhrt72sasr.png" alt="SDK架构图" title="SDK架构图" />

</ignore_js_op>

五、SDK 家族详解

5.1 平台（驱动）SDK：一切 SDK 的地基

平台 SDK 提供芯片外设驱动（PWM / ADC / I2C / SPI / USB / GPIO / PM 等）与基础 API，是所有上层协议栈 SDK 的依赖基础，仓库内的 debug_demo 是入门示例。
<ul><li><a href="https://github.com/telink-semi/tl_platform_sdk" target="_blank">tc_platform_sdk</a>：TC系列芯片驱动，MCU 为 Telink 自研 TC32 core，覆盖 TC321X、TC122X、TC123X、TLSR825X、TLSR827X 等。<li><a href="https://github.com/telink-semi/tc_platform_sdk" target="_blank">tl_platform_sdk</a>：TL 系列芯片驱动，MCU 为 RISC-V 架构 core，覆盖 TL321X、TL322X、TL323X、TLSR951X、TLSR952X 等。
</ul>

5.2 Bluetooth LE SDK

主要功能简述：BLE 多连接/单连接协议栈 + 2.4G 私有协议。支持 1M/2M PHY、Coded PHY（S2/S8）、扩展广播；含 HCI controller、透传模块、遥控器、HID dongle 等参考应用；集成 PM/OTA/Flash 写保护/电池电压检测。 适用应用场景：BLE 应用（HID 键鼠/遥控器/传感器/信标/透传模块/ESL等 IOT 应用）、2.4G 私有协议(ESL/RFID/灯/遥控器等 IOT 应用)。 Telink BLE SDK 按「连接数 / 资源 / 系列」细分：
<ul><li>tl_ble_sdk（TL 系列，BLE 多连接 + 2.4G）<li>tc_ble_sdk（TC 系列，BLE 多连接 + 2.4G）<li>tc_ble_single_sdk（TC 系列，BLE 单连接 + 2.4G）：典型用于资源相对紧凑场景。<li>tc_ble_simple_sdk（TC 系列，超低资源 BLE 单连接 + 2.4G）：典型用于极小资源占用场景。
</ul>

5.3 Zigbee / 802.15.4 / RF4CE

主要功能简述：Zigbee 4.0/3.0、802.15.4 MAC 层、RF4CE 远程控制协议，Zigbee SDK 同时自带 BLE 用于配网与双模场景。 适用应用场景：智能照明与家居控制（Zigbee 路灯/开关/插座/传感器）、工业传感器网（802.15.4）、遥控器/IR 遥控（RF4CE）。
<ul><li>telink_zigbee_sdk：支持所有有 Zigbee 规划的芯片，TL 系列支持 Zigbee 4.0。<li>telink_802154_sdk：支持所有有 802.15.4 需求的芯片。<li>telink_rf4ce_sdk：支持所有有 RF4CE 需求的芯片（如 RCU，含 IR DB 样例）。<li>telink_zigbee_ble_concurrent_sdk：支持 TC 系列芯片，Zigbee/BLE 双模。
</ul>
5.4 Matter

主要功能简述：Matter 协议 over thread。 适用应用场景：Matter 智能家居（照明/开关/传感器/门锁/温控器等多品类）、Thread 边界路由器与终端设备。
<ul><li>tl_matter：Matter 协议实现。<li>tl_openthread：Thread 协议栈。

</ul>
5.5 SIG Mesh

主要功能简述：Bluetooth SIG Mesh v1.1 全特性协议栈——远程配网、Mesh OTA、定向转发、证书配网、私有信标、子网桥、Opcode 聚合、NLC profiles（照明/传感器等）。 适用应用场景：智能照明（商用/家用灯具、开关、调光器）、智能家居控制、大规模 Mesh 网络（楼宇/园区照明管理）。
<ul><li>tl_ble_mesh：TL 系列 SIG Mesh。<li>tc_ble_mesh：TC 系列 SIG Mesh。

</ul>
5.6 Zephyr 生态

主要功能简述：基于 Zephyr RTOS 的多协议开发平台，通过 west.yml 统一管理多个仓库（zephyr + hal_telink + BLE 协议栈库 + mcuboot 安全启动 ），支持 Matter/键鼠/Zephyr BLE 应用。 适用应用场景：Zephyr 生态开发者、多协议融合产品（Matter + BLE + Thread）、需要 RTOS 与统一工具链的 IoT 项目。
<ul><li>tl_zephyr：Zephyr 生态

</ul>
5.7 音频 SDK

主要功能简述：蓝牙经典音频 + LE Audio + 2.4G TPSLL 低延迟音频的多模音频平台。支持单模（BT 经典/LE Audio）、多模（BT+LE Audio/BT+TPSLL/BTBLE+2.4G）与 dual-pair/concurrent 模式。含 BT 经典 Headset/TWS/MultiPoint、LE Audio Unicast/Auracast、Soundbar 等参考应用。 适用应用场景：TWS 耳机、头戴式耳机、Soundbar、游戏耳机（低延迟）、多模音频 Dongle、Auracast 广播音频。
<ul><li>tl_bluetooth_audio_sdk：音频通用 SDK
</ul>

5.8 Wi-Fi SDK

主要功能简述：TLSR9118 Wi-Fi/BLE 双模协议栈，支持 Wi-Fi 联网与 BLE 共存。 适用应用场景：需要 Wi-Fi 联网能力的 IoT 产品（智能家居网关/插座/摄像头配网）、Wi-Fi + BLE 双模设备。
<ul><li>telink_9118_wifi_sdk

</ul>


5.9 统一 SDK（unisdk，演进中）

主要功能简述：新一代 all-in-one 统一 SDK，集成芯片驱动、协议栈、适配多种生态/操作系统的中间件、工具链、调试/量产工具的一站式物联网开发套件，解决此前「工具零散、配置复杂、生态割裂、量产落地难」的痛点。unisdk-ble_controller 为其 BLE controller 子仓库。 适用应用场景：希望一站式开发体验、简化工具链与量产流程的客户；未来 Telink SDK 的统一入口（演进中）。
<ul><li>unisdk（演进中）
</ul>

六、快速上手三步走

<ul><li>获取 SDK：Gitee / GitHub 搜索对应仓库名，clone 即用<li>阅读文档：文档中心有规格书、SDK 入门指南、软件开发手册与应用指南（Application Note）<li>遇到问题：到技术论坛发帖，泰凌专业技术团队为您解答
</ul>

七、结尾互动

以上就是对泰凌 SDK 家族的全景介绍。你最常用哪一款 SDK？希望我们开源哪些参考设计？欢迎在评论区留言，也欢迎到各仓库提 Issue / PR，和我们一起把 Telink 的开源生态做得更好。

[Others] 一文看懂泰凌 SDK