【Telink Zephyr 环境搭建】(三) 获取源码与 HAL

TL_WUHAO

1. 获取源码 上一期我们完成了依赖安装和 west 工具的配置，这一期拉取 Telink Zephyr 源码并获取 HAL。 第一步：初始化 west 工作区（创建 ~/zephyrproject 工作区，并把上游 Zephyr 仓库克隆为 manifest 仓库） ``` west init ~/zephyrproject cd ~/zephyrproject west update ``` 注：国内网络环境下，west init 和 west update 拉取 Zephyr 源码可能耗时较长，部分项目可能因国外服务器问题更新失败。建议使用镜像或代理，或单独下载源码包。 第二步：导出 Zephyr CMake 包，让 find_package(Zephyr) 能定位到这份代码 ``` west zephyr-export ``` 第三步：安装 Zephyr 的 Python 依赖 ``` pip3 install -r ~/zephyrproject/zephyr/scripts/requirements.txt ``` 第四步：添加 Telink remote 并切换到 Telink 的 release-v1.0-v4.1-branch 分支 ``` cd ~/zephyrproject/zephyr git remote add telink https://github.com/telink-semi/tl_zephyr git fetch telink git checkout release-v1.0-v4.1-branch cd .. west update ``` 2. 获取 HAL Telink 的 BLE 协议栈（HAL）以二进制形式发布，获取方式取决于芯片系列： hal_v1 芯片（TLSR9518ADK80D、TLSR9528A、TL321X、TLSR9118），使用 west blobs 获取；切换分支或更新工作区后需要重新执行： ``` west blobs fetch hal_telink ``` hal_v2 芯片（TL322X、TL323X、TL721X），通过 fetch_sdk.sh 脚本获取： ``` cd ~/zephyrproject/modules/hal/telink/hal_v2 chmod +x fetch_sdk.sh ./fetch_sdk.sh ``` 注：fetch_sdk.sh 默认使用 telink-semi/tl_ble_sdk_zephyr 仓库的最新提交。如需固定仓库与提交，可以作为参数传入： ``` ./fetch_sdk.sh https://github.com/telink-semi/tl_ble_sdk_zephyr.git f50d422d780efb73af93b650ef7b8c6bf5a0b99b ``` 以本教程使用的 TL323X 为例： | HAL 版本 | 适用芯片 | 获取命令              | | -------- | -------- | --------------------- | | hal_v2   | TL323X   | ./hal_v2/fetch_sdk.sh | 下一篇预告：【Telink Zephyr 环境搭建】(四) 安装 Zephyr SDK 工具链 —— 敬请期待 <i class="pstatus"> 本帖最后由 TL_WUHAO 于 2026-9-20 16:11 编辑 </i><br /> <br />