[技术分享] 从零开始搭建 telink_9118_wifi_sdk 开发环境并运行第一个示例

TL_XIAOCHEN

本文将向您介绍如何在 Windows 平台上从零开始搭建 telink\_9118\_wifi\_sdk 开发环境，并运行第一个示例程序。如需更详细的教程或是 Linux 版的配置方法，请参考官方[快速入门文档](https://doc.telink-semi.cn/doc/zh/software/res/sdk/wifi/getstarted/telink_9118_wifi_sdk_get_started_cn/)。 本文将分为以下四个部分：前期准备、Windows 开发环境的配置、构建并运行第一个示例、常见问题。 ## 1 前期准备 ### 1.1 SDK 简介 telink\_9118\_wifi\_sdk 适用于泰凌 TLSR9118 SoC 平台。 说明：关于支持的芯片型号、对应的开发板以及 SDK 版本信息，请参考[官网介绍](https://www.telink-semi.cn/products/wifi/tlsr9118)。 ### 1.2 软硬件清单 运行 SDK 前，请确保您已准备好以下软硬件。 | 硬件   | 说明              | | ------ | ----------------- | | PC     | Windows 10/11     | | 开发板 | TLSR9118 开发板   | | 连接线 | USB Type-C 数据线 | | 软件     | 说明                                                                                                                                         | | -------- | -------------------------------------------------------------------------------------------------------------------------------------------- | | 开发环境 | [VS Code](https://code.visualstudio.com/)                                                                                                    | | 串口工具 | 推荐使用 Tera Term                                                                                                                           | | 烧录工具 | [BDT (Burning and Debugging Tool)](https://doc.telink-semi.cn/tools/bdt/Windows/BDT.zip)                                                     | | SDK      | [Gitee](https://gitee.com/telink-semi/telink_9118_wifi_sdk/releases)/[GitHub](https://github.com/telink-semi/telink_9118_wifi_sdk/releases/) |

TL_XIAOCHEN

## 2 Windows 开发环境的配置 ## 2.1 安装 VS Code 请确保您的电脑上已安装最新版本的 [VS Code](https://code.visualstudio.com)。若 VS Code 版本过低，可能会导致泰凌 VS Code 扩展无法正常工作或功能异常。 ### 2.2 安装泰凌 VS Code 扩展 1. 启动 VS Code。 2. 点击左侧活动栏的扩展图标，或使用快捷键 **Ctrl+Shift+X**。 3. 在搜索框中输入 **Telink**。 4. 在搜索结果中找到 **Telink Development Tool**，点击 **Install**。  安装完成后，在 VS Code 左侧活动栏中将显示 **T** 图标。  ### 2.3 下载 SDK 点击此 [Gitee](https://gitee.com/telink-semi/telink_9118_wifi_sdk/releases) 或 [GitHub](https://github.com/telink-semi/telink_9118_wifi_sdk/releases) 链接，下载最新版本的 SDK 并解压至本地。 ### 2.4 安装烧录工具 1. 下载 BDT：[BDT (Windows)](https://doc.telink-semi.cn/tools/bdt/Windows/BDT.zip) 2. 解压缩工具包    1. 将下载的工具包解压到自定义的路径，例如 *D:\Telink\BDT*。    2. 进入解压后的发布目录，例如 *D:\Telink\BDT\release\_v5.9.4*。    3. 双击运行 **Telink BDT.exe** 即可启动该工具。        ### 2.5 配置 VS Code 开发环境 #### <a id="win-import-sdk"></a>2.5.1 导入 SDK 点击 VS Code 左上角的 **File → Open Folder**，进入 SDK 解压后的目录，选择导入 wits\_sdk 文件夹。  #### 2.5.2 下载工具链 1. 点击 VS Code 左侧活动栏的 **T** 图标，展开 **WIFI DEVELOPMENT** 树状菜单。 2. 在 **Tools and Settings** 列表下选中 **TL32 ELF MCULIB V5 GCC 10.3** 工具链，点击该工具链右侧安装按钮，等待安装完成。  安装完成后，VS Code 窗口右下角会弹出如下安装成功的提示。  #### 2.5.3 下载辅助工具（以 MenuConfig 为例） 1. 点击 VS Code 左侧活动栏的 **T** 图标，展开 **WIFI DEVELOPMENT** 树状菜单。 2. 在 **Tools and Settings** 列表下选中 **MenuConfig**，右键单击，在弹出的菜单中点击 **Install**。  安装完成后，VS Code 窗口右下角会弹出如下安装成功的提示。  > **提示**：安装完成后，点击 **Build Targets** 列表中的 **menuconfig** 即可在 VS Code 中调用该工具。 #### 2.5.4 安装 Python 依赖 1. 点击 VS Code 左侧活动栏的 **T** 图标，展开 **WIFI DEVELOPMENT** 树状菜单。 2. 在 Tools and Settings 列表下点击 Python Environment for WiFi SDK，等待安装完成。     安装完成后，VS Code 窗口右下角会弹出如下安装成功的提示。  至此，您已完成 Windows 开发环境的配置，接下来即可开始构建、烧录并运行第一个示例程序。 <i class="pstatus"> 本帖最后由 TL_XIAOCHEN 于 2026-9-8 10:36 编辑 </i><br /> <br />

TL_XIAOCHEN

## 3 构建并运行第一个示例 ### 3.1 构建工程 > **说明**：烧录过程需使用引导加载程序与主固件两个镜像文件。其中，引导加载程序（wits.tlsrboot.bin）仅在首次烧录或 Flash 被擦除后才需构建并烧录；其余情况下，无需重复处理引导加载程序，仅需构建并烧录主固件（wits.mcuboot.bin）。 1. 在 VS Code 中导入 SDK 后（详见 2.5.1 导入 SDK），点击左侧栏的 T 图标，进入 **WIFI DEVELOPMENT** 分区。 2. 按以下顺序，点击对应的按钮进行构建。    - **构建引导加载程序**：      1. 点击 **Build Targets** 下的 **distclean** 按钮清理残留文件。      2. 在 **Select Targets** 目录下选择 **tlsr9xxxs\_bl** 配置。      3. 构建完成后，可在 **Build Files** 目录下看到生成的 **wits.tlsrboot.bin** 文件，点击该文件右侧的文件夹图标，将其备份到其它任意目录。             - **构建主固件**（Command-line demo）：      1. 点击 **distclean** 按钮清理残留文件，为构建做准备。      2. 在 **Select Targets** 目录下选择 **tlsr9xxxs** 配置。      3. （可选）如需调整默认配置，点击 **Build Targets** 下的 **menuconfig** 按钮打开配置界面。      4. 点击 **Build Targets** 下的 **all** 按钮开始构建。               按照以上步骤操作时，**OUTPUT** 区会实时输出日志信息，当出现 **Process completed successfully （exit code: 0）** 时，表示该步骤成功完成。       构建完成后，可在 **Build Files** 目录下看到生成的 **wits.mcuboot.bin** 文件，点击该文件右侧的文件夹图标，将其备份到其它任意目录。 ### 3.2 烧录 #### 3.2.1 步骤一：连接硬件 请按照以下逻辑连接 PC 与开发板： - PC ↔ 开发板：使用 Type-C 数据线连接。若开发板 LED 灯正常点亮，表明开发板成功上电。    打开 PC 端的**设备管理器**，若**其它设备**列表中在出现了如下图所示的 **CP2102N** 设备，表明开发板已成功连接 PC ，但因尚未安装驱动而未被成功识别。  #### 3.2.2 步骤二：烧录固件 1. 双击运行 **Telink BDT.exe**，选择 **9118 Programmer**，程序会自动打开 **EMI Tool** 窗口。如下图所示：     2. 如未自动打开 EMI Tool，请手动点击 **Tool** 菜单中的 **EMI Tool**。     3. 点击 **Install Uart driver X64**，并完成安装程序以安装 UART 驱动（仅首次需要）。    完成驱动的安装后，再次打开**设备管理器**，在**端口（COM 和 LPT）**列表中会出现入下图所示的 **Silicon Labs CP210x USB to UART Bridge (COMx)** 设备，表明开发板已被 PC 成功识别。     4. 在 EMI Tool 的 **Firmware** 页面中：    1. 地址 0x80000000 行：点击**文件夹**图标，选择 wits.tlsrboot.bin    2. 地址 0x80080000 行：点击**文件夹**图标，选择 wits.mcuboot.bin    3. 在 **Operation** 分区中，选择开发板对应的 COM 端口，波特率设置为 2,000,000 bps。    4. 点击 **Download** 按钮开始烧录。烧录完成后开发板自动重启。        烧录完成后，BDT 界面会有如下日志显示：     #### 3.2.3 验证运行结果 通过串口工具打开开发板对应串口，并将比特率设置为 **115200 bps**。按下开发板上的 **RST** 按键（按键位置请参考硬件连接图红框位置），使开发板重新启动。待启动完成后，确认串口工具是否输出 `Hello world!` 信息，以验证运行结果。 > **提示**：以下以 Tera Term 为例进行详细说明，您也可根据自己习惯选择其他串口工具，但比特率必须设置为 **115200 bps**。  1. 打开 Tera Term 工具，在弹出的新建连接窗口中选择**串口**，并在**端口**下拉列表中选择开发板所在的 COM 口（可在设备管理器的"端口（COM 和 LPT）"中查看 CP210x 设备所在的端口）然后点击**确定**。  2. 点击**设置**，选择**串口**，选择比特率为 **115200**。   3. 切换到**终端**页面，设置 **接收(R)** 为 **AUTO**，**发送(M)** 为 **LF**。  4. 按下开发板上的 **RST** 按键，开发板会自动重启。 待重启完成后，若在 Tera Term 页面输出如下串口信息，则说明默认示例程序已成功运行。 ## 4 常见问题（FAQ） ### 4.1 烧录失败 **可能原因**：串口端口选择错误或 UART 驱动未正确安装。 **解决办法**： - 检查 USB 数据线连接是否正常，开发板上 RST 旁边的 LED 是否正常点亮。 - 在 BDT 中确认选择的 COM 端口正确。 - 打开 BDT → EMI Tool，点击 **Install Uart driver X64** 按钮重新安装配套驱动。 ### 4.2 串口无输出或输出异常 **可能原因**：串口终端参数设置不正确，或固件未正确烧录。 **解决办法**： - 确认串口端口正确且波特率为 **115200**。 - 重新执行烧录流程，确认烧录日志显示成功。 - 烧录完成后手动复位开发板。 - 调整串口软件的串口通信配置，确保**终端**配置页中的**接收为 AUTO，发送为 LF**，如下图所示：    <i class="pstatus"> 本帖最后由 TL_XIAOCHEN 于 2026-9-8 10:48 编辑 </i><br /> <br />

TL_JIALIN

windows得环境目前的支持是怎么样的  只支持win11么  win10  甚至win7的支持程度怎么样

jinsong

win10 也支持，win7待确认。

TL_SUNWEI

👍

TL_XIAOCHEN

Windows 10 与 11 都支持编译与烧录固件，Windows 7 并不支持。 <div class="quote"><blockquote><font size="2"><a href="https://forum.telink-semi.cn/forum.php?mod=redirect&goto=findpost&pid=102335&ptid=98596" target="_blank"><font color="#999999">TL_JIALIN 发表于 2026-9-4 11:49</font></a></font><br /> windows得环境目前的支持是怎么样的  只支持win11么  win10  甚至win7的支持程度怎么样<br /> ...</blockquote></div><br />