Zephyr OS 入门与实战

第二章：开发环境搭建

开发环境搭建

本章将指导您完成Zephyr RTOS开发环境的搭建，包括Toolchain配置和west工具的使用。

准备工作

在开始之前，请确保您的系统满足以下要求：

至少4GB RAM（推荐8GB或更多）
10GB可用磁盘空间
稳定的互联网连接
管理员/root权限

1. 基于Windows/Linux的Toolchain配置

Windows

Linux

安装Zephyr SDK

Zephyr SDK包含了构建Zephyr应用程序所需的所有工具链和工具。

                        # 下载Zephyr SDK安装程序

                        https://github.com/zephyrproject-rtos/sdk-ng/releases

运行安装程序并按照提示完成安装。建议使用默认安装路径。

设置环境变量

安装完成后，需要设置环境变量以便系统能够找到Zephyr工具链。

                        # 设置Zephyr SDK环境变量

                        set ZEPHYR_TOOLCHAIN_VARIANT=zephyr

                        set ZEPHYR_SDK_INSTALL_DIR=C:\zephyr-sdk

注意：请将"C:\zephyr-sdk"替换为您实际的SDK安装路径。

安装依赖工具

Zephyr开发还需要以下工具：

Python 3.8或更高版本
Git
CMake 3.20.5或更高版本
Ninja构建系统

可以使用Chocolatey包管理器一键安装：

                        choco install cmake --installargs 'ADD_CMAKE_TO_PATH=System'

                        choco install ninja git python

安装Zephyr SDK

在Linux系统上安装Zephyr SDK的步骤如下：

                        # 下载Zephyr SDK

                        wget https://github.com/zephyrproject-rtos/sdk-ng/releases/download/v0.15.2/zephyr-sdk-0.15.2_linux-x86_64.tar.xz


                        
                        # 解压到/opt目录

                        tar xvf zephyr-sdk-0.15.2_linux-x86_64.tar.xz -C /opt


                        
                        # 运行安装脚本

                        cd /opt/zephyr-sdk-0.15.2

                        ./setup.sh

设置环境变量

将以下内容添加到您的~/.bashrc或~/.zshrc文件中：

                        export ZEPHYR_TOOLCHAIN_VARIANT=zephyr

                        export ZEPHYR_SDK_INSTALL_DIR=/opt/zephyr-sdk-0.15.2

然后执行：

                        source ~/.bashrc

安装依赖工具

对于基于Debian的系统（如Ubuntu）：

                        sudo apt update

                        sudo apt install --no-install-recommends git cmake ninja-build \

                        gperf ccache dfu-util device-tree-compiler wget \

                        python3-dev python3-pip python3-setuptools python3-tk python3-wheel \

                        xz-utils file make gcc gcc-multilib

对于基于RPM的系统（如Fedora）：

                        sudo dnf group install "Development Tools"

                        sudo dnf install git cmake ninja-build gperf \

                        ccache dfu-util dtc wget python3-pip python3-tkinter

验证安装：安装完成后，可以运行cmake --version、ninja --version和python3 --version来验证工具是否安装正确。

2. 使用west工具管理项目

west是Zephyr项目的元工具，用于管理多个Git仓库和构建系统。

安装west工具

使用pip安装west工具：

                    pip3 install west

验证安装：

                    west --version

初始化Zephyr工作区

创建一个工作目录并初始化Zephyr项目：

                    # 创建工作目录

                    mkdir zephyrproject && cd zephyrproject


                    
                    # 初始化west工作区

                    west init


                    
                    # 获取所有Zephyr仓库

                    west update

注意：west update会下载大量文件，请确保有稳定的网络连接。

导出Zephyr环境变量

每次开始工作前，需要导出Zephyr环境变量：

                    # 在Linux/macOS上

                    source zephyr/zephyr-env.sh


                    
                    # 在Windows上

                    zephyr\zephyr-env.cmd

为了方便，可以将此命令添加到shell配置文件中。

编译示例项目

编译一个简单的示例程序来验证环境：

                    # 进入示例目录

                    cd zephyr/samples/hello_world


                    
                    # 为qemu_x86构建

                    west build -b qemu_x86


                    
                    # 运行模拟器

                    west build -t run

如果一切正常，您应该看到"Hello World!"输出。

烧录到实际硬件

对于实际硬件设备，烧录命令类似：

                    # 为nrf52840dk_nrf52840构建

                    west build -b nrf52840dk_nrf52840


                    
                    # 烧录到开发板

                    west flash

注意：烧录前请确保开发板已正确连接，并安装了必要的驱动。

常用west命令

west init - 初始化工作区
west update - 更新所有仓库
west build - 构建项目
west flash - 烧录到设备
west debug - 启动调试会话
west zephyr-export - 导出Zephyr环境

故障排除

常见问题及解决方案

问题1：west命令找不到
解决方案：确保Python脚本目录在PATH环境变量中。

问题2：构建失败，缺少依赖
解决方案：根据错误信息安装缺少的依赖包。

问题3：烧录失败
解决方案：检查设备连接和驱动，确保有正确的烧录权限。

问题4：west update失败
解决方案：检查网络连接，或尝试使用GitHub镜像。

客服小姐姐(优先添加)