一文看懂泰凌 SDK

TL_MENGWEI

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

一、先认识一下泰凌

泰凌微电子（Telink Semiconductor）致力于研发高性能、低功耗的物联网无线连接 SoC，产品覆盖蓝牙低功耗（BLE）、经典蓝牙、蓝牙 Mesh、Zigbee、Thread、Matter、Wi-Fi 以及 2.4GHz 私有协议等多种连接技术，广泛应用于智能家居、无线音频、人机交互设备（键鼠/遥控器）、智慧零售（ESL）、工业物联网与汽车电子等领域。

协议多，对应的 SDK 自然也多——这正是写这篇总览帖的原因。

二、我们的开源布局：代码、文档、论坛

我们把所有对外发布的 SDK 都放在开源社区上，欢迎 Star、Fork、提 Issue：

• Gitee：https://gitee.com/telink-semi
• GitHub：https://github.com/telink-semi
  

配套资源一站直达：

资源	链接	说明
官网	https://www.telink-semi.cn/	产品中心、应用方案、芯片选型与 SDK 版本对照
文档中心	https://doc.telink-semi.cn/doc/zh/	中英文开发手册、Get Started、Developer Handbook
技术论坛	https://forum.telink-semi.cn/	有问必答，技术团队支持

三、认识芯片：TC系列与TL系列

选 SDK 之前，先要知道自己用的是哪一系列芯片——Telink SDK 的命名规则与芯片系列直接对应：

	TC 系列	TL 系列
MCU 内核	Telink 自研 TC32 MCU core	RISC-V MCU core
典型型号	TLSR825X / TLSR827X / TC321X / TC122X / TC123X	TLSR951X / TLSR952X / TL751X / TL752X / TL721X / TL321X / TL322X / TL323X
对应驱动 SDK	tc_platform_sdk	tl_platform_sdk

小贴士：具体芯片选型及对应支持的SDK 信息，可从官网查看。


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

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

SDK架构图

五、SDK 家族详解

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

平台 SDK 提供芯片外设驱动（PWM / ADC / I2C / SPI / USB / GPIO / PM 等）与基础 API，是所有上层协议栈 SDK 的依赖基础，仓库内的 debug_demo 是入门示例。

• tc_platform_sdk：TC系列芯片驱动，MCU 为 Telink 自研 TC32 core，覆盖 TC321X、TC122X、TC123X、TLSR825X、TLSR827X 等。
• tl_platform_sdk：TL 系列芯片驱动，MCU 为 RISC-V 架构 core，覆盖 TL321X、TL322X、TL323X、TLSR951X、TLSR952X 等。
  

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 按「连接数 / 资源 / 系列」细分：

• tl_ble_sdk（TL 系列，BLE 多连接 + 2.4G）
• tc_ble_sdk（TC 系列，BLE 多连接 + 2.4G）
• tc_ble_single_sdk（TC 系列，BLE 单连接 + 2.4G）：典型用于资源相对紧凑场景。
• tc_ble_simple_sdk（TC 系列，超低资源 BLE 单连接 + 2.4G）：典型用于极小资源占用场景。
  

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）。

• telink_zigbee_sdk：支持所有有 Zigbee 规划的芯片，TL 系列支持 Zigbee 4.0。
• telink_802154_sdk：支持所有有 802.15.4 需求的芯片。
• telink_rf4ce_sdk：支持所有有 RF4CE 需求的芯片（如 RCU，含 IR DB 样例）。
• telink_zigbee_ble_concurrent_sdk：支持 TC 系列芯片，Zigbee/BLE 双模。
  

5.4 Matter

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

• tl_matter：Matter 协议实现。
• tl_openthread：Thread 协议栈。
  
  

5.5 SIG Mesh

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

• tl_ble_mesh：TL 系列 SIG Mesh。
• tc_ble_mesh：TC 系列 SIG Mesh。
  
  

5.6 Zephyr 生态

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

• tl_zephyr：Zephyr 生态
  
  

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 广播音频。

• tl_bluetooth_audio_sdk：音频通用 SDK
  

5.8 Wi-Fi SDK

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

• telink_9118_wifi_sdk
  
  

5.9 统一 SDK（unisdk，演进中）

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

• unisdk（演进中）
  

六、快速上手三步走

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

七、结尾互动

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