一文看懂 Telink SDK之二：有哪些、怎么选

TL_SHUJUAN

# 一文看懂 Telink SDK：有哪些、怎么选 > 读完本文，你能回答两个问题：**① Telink 有哪些 SDK？② 我该用哪一个？** > > 只想快速选型的朋友，可以直接跳到「四、如何选择 SDK」；想全面了解可从头读起。文中各仓库支持芯片均整理自其最新 Release Notes 的 Chip Version 字段。 ## 一、先认识芯片：TC 与 TL 两大系列 选 SDK 之前，先搞清楚你用的是哪一类芯片。Telink 的芯片分为 **TC 系列**和 **TL 系列**，SDK 的命名规律与芯片系列直接对应——**仓库名前缀** **`tc_`** **对应 TC 系列，`tl_`** **对应 TL 系列**。 | <br />        | **TC 系列**                                                                                     | **TL 系列**                                                                      | | ------------- | ----------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | | MCU 内核      | Telink 自研**TC32 core**                                                                        | **RISC-V core**                                                                  | | 典型型号      | TLSR8366、TLSR8208/TLSR8373、TLSR825X/TLSR8359、<br />TLSR827X/TLSR8355、TC321X、TC122X、TC123X | TLSR951X、TLSR952X、TL751X、TL752X、TL721X、<br />TL321X、TL322X、TL323X、TL521X | | 对应 SDK 前缀 | `tc_`                                                                                           | `tl_`                                                                            | > 小提示：个别历史命名的仓库（如 `telink_zigbee_sdk`、`telink_802154_sdk`）不含 `tc_`/`tl_` 前缀，但它们支持的芯片仍分属 TC / TL 平台，具体见各仓库支持列表。 ## 二、一图看懂 SDK 全景  Telink 的 SDK 体系可以概括为**三层结构**，从下到上依次是： ``` ┌─────────────────────────────────────┐ │        应用与垂直方案层（顶层）          │  ← 面向行业的完整参考设计/方案 ├─────────────────────────────────────┤ │        协议栈层（中层）                │  ← BLE / Mesh / Zigbee / Matter / Wi-Fi / 音频 ├─────────────────────────────────────┤ │        平台驱动层（底层）              │  ← 外设驱动 + 射频/电源管理，一切的地基 └─────────────────────────────────────┘ ``` - **平台驱动层**：提供芯片外设驱动与基础 API，是所有上层 SDK 的依赖地基。 - **协议栈层**：提供标准无线协议栈与应用 SDK，是绝大多数开发者直接使用的层。 - **应用与垂直方案层**：面向智能家居、工业、消费电子、汽车等行业的完整参考设计与方案。 理解了这个分层，就理解了 SDK 家族的分类逻辑，下面逐一展开。 ## 三、SDK 家族速览 Telink 的 SDK 按协议与场景分为 7 大家族： | 家族                      | 定位                   | 对应仓库                                                                                                                                                                                                                                                                                                                                                                                   | | ------------------------- | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | 平台 SDK                  | 底层驱动地基           | [`tc_platform_sdk`](https://gitee.com/telink-semi/tc_platform_sdk)、[`tl_platform_sdk`](https://gitee.com/telink-semi/tl_platform_sdk)                                                                                                                                                                                                                                                     | | BLE / Bluetooth Mesh      | 蓝牙低功耗 + 私有 2.4G | [`tl_ble_sdk`](https://gitee.com/telink-semi/tl_ble_sdk)、[`tc_ble_sdk`](https://gitee.com/telink-semi/tc_ble_sdk)、[`tc_ble_single_sdk`](https://gitee.com/telink-semi/tc_ble_single_sdk)、[`tc_ble_simple_sdk`](https://gitee.com/telink-semi/tc_ble_simple_sdk)、[`tl_ble_mesh`](https://gitee.com/telink-semi/tl_ble_mesh)、[`tc_ble_mesh`](https://gitee.com/telink-semi/tc_ble_mesh) | | Zigbee / 802.15.4 / RF4CE | 低功耗网状网与遥控     | [`telink_zigbee_sdk`](https://gitee.com/telink-semi/telink_zigbee_sdk)、[`telink_802154_sdk`](https://gitee.com/telink-semi/telink_802154_sdk)、[`telink_rf4ce_sdk`](https://gitee.com/telink-semi/telink_rf4ce_sdk)                                                                                                                                                                       | | Matter / Thread           | 智能家居统一标准       | [`tl_matter`](https://github.com/telink-semi/tl_matter)（含 Matter over Thread 与 Matter over Wi-Fi 分支）                                                                                                                                                                                                                                                                                 | | Zephyr 生态               | 开源 RTOS 多协议平台   | [`tl_zephyr`](https://github.com/telink-semi/tl_zephyr)                                                                                                                                                                                                                                                                                                                                    | | 音频                      | 经典音频 + LE Audio    | [`tl_bluetooth_audio_sdk`](https://gitee.com/telink-semi/tl_bluetooth_audio_sdk)                                                                                                                                                                                                                                                                                                           | | Wi-Fi                     | Wi-Fi/BLE 双模         | [`telink_9118_wifi_sdk`](https://gitee.com/telink-semi/telink_9118_wifi_sdk)                                                                                                                                                                                                                                                                                                               | 各家族详细说明见文末「六、SDK 家族详解」，选型只看这一张表 + 第四章即可。 ## 四、如何选择 SDK（三步决策） 选型分三步：**先按应用方向选家族，再按芯片平台定前缀，最后在同家族内按资源细分。** ### Step 1：按应用方向选 SDK 家族 ``` 开始 ├─ 做音频类产品（耳机/TWS/音箱等）？ → 音频家族（tl_bluetooth_audio_sdk） └─ 做通用 IoT 产品？       ├─ 基于标准协议开发（BLE / Mesh / Zigbee / Matter / Wi-Fi）？       │     → 直接选对应标准协议 SDK       └─ 不用标准协议，需要私有/自定义无线？             ├─ 想要现成的 2.4G 私有协议能力 → 选 BLE 家族中的 2.4G 能力             └─ 想完全从底层自己搭 → 选平台 SDK ``` ### Step 2：按芯片平台确定前缀 选定家族后，根据你的芯片是 TC 还是 TL 系列，确定仓库前缀 `tc_` 或 `tl_`。例如做 BLE 多连接应用： - 用 TC 系列芯片 → [`tc_ble_sdk`](https://gitee.com/telink-semi/tc_ble_sdk) - 用 TL 系列芯片 → [`tl_ble_sdk`](https://gitee.com/telink-semi/tl_ble_sdk) ### Step 3：同家族内按资源/连接能力细分 以 **BLE 家族**为例，它包含 4 个 BLE 仓库 + 2 个 Mesh 仓库，差异在"连接能力"与"片上资源"： | 仓库                                                                   | 芯片平台 | 连接能力      | 适用场景                              | | ---------------------------------------------------------------------- | -------- | ------------- | ------------------------------------- | | [`tl_ble_sdk`](https://gitee.com/telink-semi/tl_ble_sdk)               | TL       | 多连接 + 2.4G | 常规 BLE 多连接应用                   | | [`tc_ble_sdk`](https://gitee.com/telink-semi/tc_ble_sdk)               | TC       | 多连接 + 2.4G | 常规 BLE 多连接应用                   | | [`tc_ble_single_sdk`](https://gitee.com/telink-semi/tc_ble_single_sdk) | TC       | 单连接 + 2.4G | 片上资源相对有限的芯片                | | [`tc_ble_simple_sdk`](https://gitee.com/telink-semi/tc_ble_simple_sdk) | TC       | 单连接 + 2.4G | 资源极有限（如仅 OTP 无 Flash）的芯片 | | [`tl_ble_mesh`](https://gitee.com/telink-semi/tl_ble_mesh)             | TL       | Mesh          | TL 系列 SIG Mesh 应用                 | | [`tc_ble_mesh`](https://gitee.com/telink-semi/tc_ble_mesh)             | TC       | Mesh          | TC 系列 SIG Mesh 应用                 | > 注意：并非所有 SDK 支持所有芯片，具体某仓库支持哪些芯片，以该仓库 README / 文档 / Release Notes 为准。 ## 五、速查表：仓库 ↔ 支持芯片 下面按仓库列出各 SDK 最新 Release 支持的全部芯片，方便收藏对照。"早期版本另含"表示该仓库早期版本曾支持、最新版已移出的芯片。 | 仓库                                                                             | 支持芯片（最新 Release）                                                                           | | -------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | | [`tc_platform_sdk`](https://gitee.com/telink-semi/tc_platform_sdk)               | TLSR8208/TLSR8373、TLSR8208(B)、TLSR825X/TLSR8359、<br />TLSR827X/TLSR8355、TC321X、TC122X、TC123X | | [`tl_platform_sdk`](https://gitee.com/telink-semi/tl_platform_sdk)               | TLSR921X/TLSR951X、TLSR922X/TLSR952X、TL751X、<br />TL721X、TL321X、TL322X、TL323X、TL752X、TL521X | | [`tl_ble_sdk`](https://gitee.com/telink-semi/tl_ble_sdk)                         | TLSR921X、TLSR922X/TLSR952X、TL721X、TL321X、<br />TL322X、TL323X、TL521X                          | | [`tc_ble_sdk`](https://gitee.com/telink-semi/tc_ble_sdk)                         | TLSR825X、TLSR827X、TC321X、TC123X                                                                 | | [`tc_ble_single_sdk`](https://gitee.com/telink-semi/tc_ble_single_sdk)           | TLSR825X、TLSR827X、TC321X                                                                         | | [`tc_ble_simple_sdk`](https://gitee.com/telink-semi/tc_ble_simple_sdk)           | TLSR8208、TLSR8208(B)                                                                              | | [`tl_ble_mesh`](https://gitee.com/telink-semi/tl_ble_mesh)                       | TLSR921X、TL321X、TLSR922X/TLSR952X                                                                | | [`tc_ble_mesh`](https://gitee.com/telink-semi/tc_ble_mesh)                       | TLSR825X、TLSR827X、TC321X                                                                         | | [`telink_zigbee_sdk`](https://gitee.com/telink-semi/telink_zigbee_sdk)           | TLSR921X/TL321X/TL323X/TL521X<br />（早期版本另含 TLSR8269/TLSR8258/TLSR8278 及 TLSR952X/TL721X）  | | [`telink_802154_sdk`](https://gitee.com/telink-semi/telink_802154_sdk)           | TLSR8269/TLSR8258/TLSR8278、TLSR951X                                                               | | [`telink_rf4ce_sdk`](https://gitee.com/telink-semi/telink_rf4ce_sdk)             | TLSR8269/TLSR8258/TLSR8278、TLSR952X/TL321X                                                        | | [`tl_matter`](https://github.com/telink-semi/tl_matter)                          | TL521X/TL323X/TL721X/TLSR9118                                                                      | | [`tl_zephyr`](https://github.com/telink-semi/tl_zephyr)                          | TL521X/TL323X/TL322X/TL321X/TL721X                                                                 | | [`tl_bluetooth_audio_sdk`](https://gitee.com/telink-semi/tl_bluetooth_audio_sdk) | TLSR952X、TL721X、TL751X、TL322X                                                                   | | [`telink_9118_wifi_sdk`](https://gitee.com/telink-semi/telink_9118_wifi_sdk)     | TLSR9118                                                                                           | > 仓库地址：Gitee 见 [https://gitee.com/telink-semi](https://gitee.com/telink-semi)，搜索上表仓库名即可。 ## 六、SDK 家族详解 ### 6.1 平台 SDK **功能**：提供芯片外设驱动（PWM / ADC / I2C / SPI / USB / GPIO / PM 等）与射频、电源管理等基础 API，是所有上层协议栈 SDK 的依赖地基。做标准协议应用可直接选对应标准 SDK，想从底层 Driver 开发则选平台 SDK。 - [`tc_platform_sdk`](https://gitee.com/telink-semi/tc_platform_sdk)：TC 系列平台 SDK，MCU 为自研 TC32 core。支持芯片（V3.5.2）：TLSR8208/TLSR8373、TLSR8208(B)、TLSR825X/TLSR8359、TLSR827X/TLSR8355、TC321X、TC122X、TC123X。 - [`tl_platform_sdk`](https://gitee.com/telink-semi/tl_platform_sdk)：TL 系列平台 SDK，MCU 为 RISC-V core。支持芯片（V4.0.1）：TLSR921X/TLSR951X、TLSR922X/TLSR952X、TL751X、TL721X、TL321X、TL322X、TL323X、TL752X、TL521X。 ### 6.2 BLE / Bluetooth Mesh **功能**： - **BLE**：多连接/单连接协议栈 + 2.4G 私有协议（含 TPLL/GenFsk 模式），含 HCI 透传、遥控器、HID dongle 等参考应用，集成 PM/OTA/Flash 写保护/电池电压检测。 - **Mesh**：Bluetooth Mesh v1.1 全特性协议栈（远程配网、Mesh OTA、定向转发、证书配网、私有信标、子网桥、Opcode 聚合、NLC profiles）。 **适用场景**：BLE 应用（HID 键鼠/遥控器/传感器/信标/透传模块/ESL 等 IoT 应用）、2.4G 私有协议（ESL/RFID/灯/遥控器等）、智能照明与大规模 Mesh 网络。 仓库（差异见第四章 Step 3）： - [`tl_ble_sdk`](https://gitee.com/telink-semi/tl_ble_sdk)：TL 系列多连接，支持 TLSR921X、TLSR922X/TLSR952X、TL721X、TL321X、TL322X、TL323X、TL521X。 - [`tc_ble_sdk`](https://gitee.com/telink-semi/tc_ble_sdk)：TC 系列多连接，支持 TLSR825X、TLSR827X、TC321X、TC123X。 - [`tc_ble_single_sdk`](https://gitee.com/telink-semi/tc_ble_single_sdk)：TC 系列单连接（资源有限），支持 TLSR825X、TLSR827X、TC321X。 - [`tc_ble_simple_sdk`](https://gitee.com/telink-semi/tc_ble_simple_sdk)：TC 系列单连接（超低资源），支持 TLSR8208、TLSR8208(B)。 - [`tl_ble_mesh`](https://gitee.com/telink-semi/tl_ble_mesh)：TL 系列 Mesh，支持 TLSR921X、TL321X、TLSR922X/TLSR952X。 - [`tc_ble_mesh`](https://gitee.com/telink-semi/tc_ble_mesh)：TC 系列 Mesh，支持 TLSR825X、TLSR827X、TC321X。 ### 6.3 Zigbee / 802.15.4 / RF4CE **功能**：Zigbee 协议栈（支持 Zigbee/BLE 双模并发）、802.15.4 MAC 层、RF4CE 远程控制协议。 **适用场景**：智能照明与家居控制（Zigbee 路灯/开关/插座/传感器）、工业传感器网（802.15.4）、遥控器/IR 遥控（RF4CE）。 仓库： - [`telink_zigbee_sdk`](https://gitee.com/telink-semi/telink_zigbee_sdk)：支持 TLSR921X/TL321X/TL323X/TL521X（早期版本另含 TLSR8269/TLSR8258/TLSR8278 及 TLSR952X/TL721X）。 - [`telink_802154_sdk`](https://gitee.com/telink-semi/telink_802154_sdk)：支持 TLSR8269/TLSR8258/TLSR8278、TLSR951X。 - [`telink_rf4ce_sdk`](https://gitee.com/telink-semi/telink_rf4ce_sdk)：支持 TLSR8269/TLSR8258/TLSR8278、TLSR952X/TL321X。 ### 6.4 Matter / Thread **功能**：Matter 智能家居统一标准协议。`tl_matter` 主线为 Matter over Thread，另有一个分支支持 **Matter over Wi-Fi**；支持 BLE/Thread 并发模式、Channel Sounding 信道探测等能力。 **适用场景**：Matter 智能家居（照明/开关/传感器/门锁/温控器等多品类）、Thread 边界路由器与终端设备。 **支持芯片**：TL521X、TL323X、TL721X、TLSR9118。 仓库：[`tl_matter`](https://github.com/telink-semi/tl_matter)。 ### 6.5 Zephyr 生态 **功能**：基于 Zephyr RTOS 的多协议开发平台，用于开发 Matter、键鼠等应用，通过统一工具链管理多仓库依赖。 **适用场景**：Zephyr 生态开发者、多协议融合产品（Matter + BLE + Thread）。 **支持芯片**：TL521X、TL323X、TL322X、TL321X、TL721X。 仓库：[`tl_zephyr`](https://github.com/telink-semi/tl_zephyr)。 ### 6.6 音频 SDK **功能**： - **BT 经典音频**：A2DP 音乐播放（SBC）、HFP 通话（CVSD/MSBC）、BT Multipoint 多设备连接 - **LE Audio**：LC3 编解码、Unicast 单播（音乐/通话）、Auracast 广播（A2DP to BIS 收发） - **2.4G 私有 TPSLL**：超低延迟音频（17ms+）、双模在线 24ms+、BT+TPSLL 混音 - **算法能力**：NN 降噪、AGC 自动增益、混音算法 内置参考设计：BT/BLE 双模耳机（btble\_headset）、TPSLL 超低延迟 TWS/头戴耳机（bttpsll\_tws/headset）、音频 Dongle（tpsll\_audio\_dongle、btble\_audio\_source）、Auracast 广播（btble\_a2dp\_to\_bis）、录音卡（recording\_card）、对讲机（bt\_interphone）、LE Audio 示例（le\_example）等。 **适用场景**：TWS 耳机、头戴式耳机、音频 Dongle、录音卡、低延迟游戏音频、多模音频、LE Audio/Auracast 广播音频等。 **支持芯片**（V6.1.0.0）：TLSR952X、TL721X、TL751X、TL322X。 > 注意：LC3 / LC3+ 编解码器可能涉及版权费用，需与 Fraunhofer / Ericsson 签订许可协议，详见仓库 release note。 仓库：[`tl_bluetooth_audio_sdk`](https://gitee.com/telink-semi/tl_bluetooth_audio_sdk)。 ### 6.7 Wi-Fi SDK **功能**：TLSR9118 Wi-Fi/BLE 双模协议栈，支持 Wi-Fi 联网与 BLE 共存；提供丰富 AT 命令、TLS 1.3、PPP、硬件加速加密、自定义 MAC、UART DMA 变长接收等能力。 **适用场景**：需要 Wi-Fi 联网能力的 IoT 产品（智能家居网关/插座/摄像头配网）、Wi-Fi + BLE 双模设备。 **支持芯片**（V1.1.3.3）：TLSR9118。 仓库：[`telink_9118_wifi_sdk`](https://gitee.com/telink-semi/telink_9118_wifi_sdk)。 ## 七、配套资源与下一步 拿到 SDK 之后的建议路径： 1. **获取 SDK**：到 Gitee 搜索对应仓库名，clone 即用 2. **读文档**：文档中心有规格书、SDK 入门指南、软件开发手册与应用指南（Application Note） 3. **跑示例**：从 `debug_demo` 或示例工程入手，先跑通再改造 4. **遇到问题**：到技术论坛发帖，泰凌专业技术团队为你解答 | 资源         | 链接                                                                     | 说明                                            | | ------------ | ------------------------------------------------------------------------ | ----------------------------------------------- | | 官网         | [https://www.telink-semi.cn/](https://www.telink-semi.cn/)               | 产品中心、应用方案、芯片选型与 SDK 版本对照     | | 产品选型工具 | [https://products.telink-semi.cn/](https://products.telink-semi.cn/)     | 芯片选型查询                                    | | 文档中心     | [https://doc.telink-semi.cn/doc/zh/](https://doc.telink-semi.cn/doc/zh/) | 中英文开发手册、Get Started、Developer Handbook | | 技术论坛     | [https://forum.telink-semi.cn/](https://forum.telink-semi.cn/)           | 有问必答，技术团队支持                          | | Gitee        | [https://gitee.com/telink-semi](https://gitee.com/telink-semi)           | 官方 SDK 仓库                                   |

TL_JUNNAN

很好的帖子！感谢分享，受益匪浅。[日期]