查看“︁Zephyr”︁的源代码

== 说明 ==
zephyr是一个RTOS生态。

== west工作环境 ==
zephyr可使用<code>west</code>（zephyr的元工具）管理源代码，因此无需手动调用<code>git</code>克隆源代码。

本章节的说明要求zephyr4.4及更新版本。

==== 搭建 ====
搭建环境的基本步骤如下(一般在单独创建目录搭建，步骤与官方文档的步骤类似):

* 初始化：<code>west init</code> ,初始化一般用于下载zephyr源代码。
* 更新：<code>west update</code>,更新一般用于更新zephyr源代码并下载子模块。
* 安装python依赖:<code>west packages pip --install</code> ,用于安装python脚本可能用到的依赖。'''注意:此步骤需要安装官方要求进入python的venv环境,否则无法执行。'''
* 获取二进制文件:<code>west blobs -a fetch</code>,某些芯片的某些功能不会发布源代码，因此需要下载其发布的二进制文件。'''注意:此步骤下载了所有支持的二进制文件，如仅需要部分芯片请查看官方说明。'''

* 安装SDK:<code>west sdk install</code>,'''注意:此步骤下载了所有支持的SDK工具，如仅需部分SDK工具请查看官方说明。'''

环境搭建完成后，每次进入目录并激活python的venv环境即可。

=== 使用 ===
使用时除了激活python的venv环境，当前目录还需要保持在west工作区(即包含.west的目录或其子目录)。

为了放置不必要的错误（如windows下跨盘符问题），本人推荐使用软链接将工作区外的应用目录链接至工作区内。

对于windows而言，可使用cmd.exe的<code>mklink</code>命令创建软链接。

对于非windows（如Linux）而言，可使用<code>ln</code>命令创建软链接。

== cmake环境 ==
cmake环境不可单独使用，需要先在west工作环境将zephyr配置好并且使用<code>west zephyr-export</code>将当前环境的zephyr导出。

当cmake环境配置好后，可使用cmake直接对zephyr的应用进行直接编译，无需借助west工具，但需要注意：

* BOARD选项通过<code>-DBOARD=BOARD名称</code>指定，不指定BOARD选项可能无法编译。
* 某些默认生成器因为对工具链的处理不同可能不可用（如Visual Studio），因此推荐使用<code>-G Ninja</code>指定Ninja。
* 在zephyr配置过程中需要运行python代码，因为官方要求的是venv环境，如果没有进入配置好的venv环境可能配置失败。如果不想每次都进入venv环境，可手动对全局python环境使用<code>pip install -r</code>安装zephyr源代码<code>scripts/requirements.txt</code> 。

== 官方资料 ==

* 网址:https://zephyrproject.org/
* github组织:https://github.com/zephyrproject-rtos