【瑞萨RA × Zephyr评测】Zephyr RTOS保姆级环境构建与编译下载踩坑版

张一西succeed 2026-01-10 9631

电子说

1.4w人已加入

描述

Zephyr 环境构建是个相对比较复杂的系统，

涉及各种工具链
Python脚本自动化
仓库管理以及设备配置等等，
所以其安装起来相对复杂，且环境依赖也特别多，笔者在这里介绍一下其环境构建与编译下载

1、环境安装

首先安装基本的环境：包括Python、CMake、Ninja等，与VS Code插件中所需要的软件包一样
python

这里是使用winget下载的，普通下载可能会下载失败，需要科学上网才可以下载

python

使用上很灵活，环境配置异常麻烦，所以大家要准备好耐心配置环境 。

West环境安装

首先需要使用west 来下载代码以及编译构建代码，所以需要安装West，这里值得一提Python版本需要高版本（例如14版本即可，实测3.10及以下低版本会报错）
python

这里笔者使用Python 14版本，正常安装，最好安装在Python虚拟环境里面，因为Zephyr需要Python包一大堆

pip install west 

west --version

python

2、Zephyr代码下载

west init zephyrproject # 初始化 Zephyr 环境并获取源码
cd zephyrproject        # 进入 Renesas 目录
west update       # 更新 Zephyr 源码

python

成功下载

python

接着安装Zephyr的Python包，

pip install -r zephyrscriptsrequirements.txt

注意可能碰到如下错误，然后可以先注释掉windows-curses，继续安装

python

接着碰到patoolib没有的错误，但是直接装，也没有这个库

python

结果这个库不叫这个名字，而是patool，则可以正常安装，所以需要注意

python

最终安装一个tqdm，则可以正常安装 sdk

python

还有一个Python的elftools lib库没有，直接安装也不行。

值得一提的是：（所以Python安装lib的时候需要注意，发现没有安装包的错误，安装包不一定就是pip install的包，可能需要查一下，最终的包名称是什么）

python

实际安装包名称为：pyelftools，然后安装成功即可。

python

不过最终还是有Python包安装失败了，后续再继续解决

python

3、Zephyr代码更新

Zephyr代码更新时间较长

python

如果到这里就算更新完成了

python

4、Zephyr sdk 工具链安装

工具链是github下载的，所以很容易出现下载失败问题：

python

遇到工具链无法安装，直接github上面下载

python

https://github.com/zephyrproject-rtos/sdk-ng/releases/download/v0.17.4/zephyr-sdk-0.17.4_windows-x86_64.7z

然后浏览器可以下载到安装包

python

然后解压，设置环境变量等，解压到这里就成功了。

7z x zephyr-sdk-0.17.4_windows-x86_64.7z
cd zephyr-sdk-0.17.4
.setup.cmd

python

值得注意的是，预留足够的空间，这个工具链占用10GB，支持各种架构的工具链：支持aarch64、arm、arc、arc64、mips、riscv64等

python

5、Zephyr 代码编译与下载

到这里之后Zephyr 开发环境就搭建OK，可以编译和下载代码：

west build -p always -b fpb_ra6e2 .samplesbasicblinky

python

下载代码尝试west flash，但是其报错了，查找了很多Python 库，都没找到什么库异常，

west flash

python

之前使用过vs code，了解其可以用JLink下载，然后这里可以用JFlash代替，可以看到LED闪烁以及串口打印，环境搭建完成。

python
python
python

6、参考

1、Zephyr新手必读：常见编译错误解决方案

2、安装python 中的 patoolib 库时报错

打开APP阅读更多精彩内容