Zephyr 快速入门

作者: QuincyW | 来源:发表于2020-11-12 23:40 被阅读0次

    快速开始一个应用,一览 Zephyr 开发全貌。主要参考官方手册。

    准备工作

    必备软件

    下载安装上述软件(除了 west)。为了方便使用,建议把相关的可执行程序所在目录添加到环境变量 Path 中。

    其中,west 是一个 Python 包,在安装好 Python 后,可执行以下命令安装:

    pip install west
    

    除了上面提到的软件,开发 Zephyr 还会用到若干 Python 包,后续会说明如何安装。

    这里没有写文本编辑器,这个玩意是每个程序员必备的,用自己趁手的就可以。

    获取 Zephyr 源码

    在我的电脑上,设定工作目录被设定为 D:\zephyr ,以后的学习试验均在这个目录下完成。

    打开 cmd 命令行窗口,切换到工作目录:

    cd /d D:\zephyr
    

    分别执行以下3行命令:

    west init zephyrproject
    cd zephyrproject
    west update
    

    说明一下:
    第一句命令是初始化 Zephyr 代码空间到 zephyrproject 文件夹,并通过 git 拉取代码。
    第二句是切换目录到 zephyrproject 文件夹。
    第三句是拉取依赖的 modules ,可以理解为 Zephyr 需要的第三方代码库,包括半导体厂家的 HAL ,文件系统源码等等。

    上述命令会从 github 下载代码,根据你所处的网络环境,可能需要很长时间。如果第一条命令没能执行成功,请删除 zephyrproject 文件夹,重新执行命令。如果第三条命令执行不成功,可以直接重试。其实 modules 里的内容也不需要全部下载,如果你能分辨哪些暂时不会用到,即便下载失败,也可暂时置之不理;如果不能分辨哪些是必须的,请重复执行命令直至成功。

    下载成功后 zephyrproject 文件夹应该包含以下目录:

    .west
    bootloader
    modules
    tools
    zephyr
    

    接下来,安装必须的 Python 包:

    pip install -r zephyr\scripts\requirements.txt
    

    这个也会从网络下载很多内容,可能需要花些时间……

    最后的准备工作

    为了更高效的完成后面的学习,我写了两个批处理文件:

    • setup_env.bat 用于设置需要的环境变量
    • start.bat 用于打开 cmd 命令行并调用前一个批处理文件。

    日后需要进行 Zephyr 的开发时,直接双击 start.bat 文件即可。

    setup_env.bat 文件:

    @echo off
    rem setup_env.bat  设置开发 Zephyr 的环境
    
    set ZEPHYR_ROOT=D:\zephyr\zephyrproject
    set ZEPHYR_BASE=%ZEPHYR_ROOT%\zephyr
    set ZEPHYR_TOOLCHAIN_VARIANT=gnuarmemb
    
    set GNUARMEMB_TOOLCHAIN_PATH=D:\zephyr\tools\gcc-arm-none-eabi-9-2020-q2-update-win32
    set NINJA_ROOT=D:\zephyr\tools\ninja-win-1.10.1
    set GPERF_ROOT=D:\zephyr\tools\gperf-3.1
    set CMAKE_ROOT=D:\zephyr\tools\cmake-3.18.4-win32-x86\bin
    set GIT_ROOT=D:\zephyr\tools\PortableGit-2.29.2.2-32-bit\cmd
    
    set PYTHON_ROOT=C:\Python38
    set PYTHON_ROOT_EXT=C:\Users\DELL\AppData\Roaming\Python\Python38\Scripts
    
    set Path=C:\WINDOWS\system32;C:\WINDOWS;C:\WINDOWS\System32\Wbem;C:\WINDOWS\System32\WindowsPowerShell\v1.0
    
    set Path=%GNUARMEMB_TOOLCHAIN_PATH%\bin;%PYTHON_ROOT_EXT%;%NINJA_ROOT%;%GPERF_ROOT%;%CMAKE_ROOT%;%GIT_ROOT%;%PYTHON_ROOT%;%PYTHON_ROOT%\Scripts;%Path%
    
    echo 环境变量设置完成,请继续...
    

    需要说明的是,前面提到的必备软件,除了 Python 都是免安装版本,全部被我解压缩安置在 D:\zephyr\tools 目录下。setup_env.bat 里设置的环境变量,都只是必须的,其他不想干的没有加入。特别的,如果系统 Path 里的内容较多,可能导致一些莫名其妙的问题,建议设置最少可用的即可,也就是 setup_env.bat 里这样的示例。如果有读者采用类似的批处理文件,请特别注意各个工具软件的路径。

    start.bat 文件:

    @echo off
    rem start.bat
    
    cmd /K D:\zephyr\setup_env.bat
    

    首秀

    当你成功完成上述内容后,就可以编译一个示例工程,也就是嵌入式界的 Hello world:闪烁 LED 灯。

    Zephyr 支持 Out of tree build,也就是编译目录可以随意指定,而不必在 Zephyr 源码目录内。为了方便,我建立 D:\zephyr\practice 目录,在这个目录下进行我们的学习。

    一切就绪准备就绪,双击 start.bat 开始我们的体验……

    cd practice
    west build -b nucleo_f103rb ..\zephyrproject\zephyr\samples\basic\blinky
    

    稍等片刻,你看到类似这样的输出的话,说明编译成功:

    ……
    -- Configuring done
    -- Generating done
    -- Build files have been written to: D:/zephyr/practice/build
    -- west build: building application
    [119/124] Linking C executable zephyr\zephyr_prebuilt.elf
    Memory region         Used Size  Region Size  %age Used
               FLASH:       12244 B       128 KB      9.34%
                SRAM:        4088 B        20 KB     19.96%
            IDT_LIST:         120 B         2 KB      5.86%
    [124/124] Linking C executable zephyr\zephyr.elf
    

    编译的结果,可以查看 D:\zephyr\practice\build\zephyr 目录,有 zephyr.elf,zephyr.bin,zephyr.hex 等文件。

    下面用模拟器运行这个程序看看

    qemu-system-gnuarmeclipse -board NUCLEO-F103RB --image build\zephyr\zephyr.elf
    

    仔细找找,开发板上的 LED 在闪烁。成功~

    结语

    至此,Zephyr 的第一个程序顺利在模拟器上运行,如果你有实际的开发板,也可以真机实测。

    经过上述步骤,我们搭建了 Zephyr 的开发环境,体验了开发流程。后续我将会介绍更多好玩的内容……

    相关文章

      网友评论

        本文标题:Zephyr 快速入门

        本文链接:https://www.haomeiwen.com/subject/hurmbktx.html