当前位置： 首页 > news >正文

Zephyr最简工程配置指南

news 2026/6/15 18:54:54

Zephyr最简工程配置指南：x86平台+QEMU运行

引言

在Zephyr RTOS开发中，配置一个最简工程是学习和测试的最佳起点。本文将详细介绍如何配置一个最小化的Zephyr工程，仅使用x86平台，并在QEMU模拟器中运行。

这种配置方式具有以下优势：

  • 快速入门：无需硬件设备即可体验Zephyr
  • 资源高效：仅包含必要组件
  • 易于调试：QEMU提供完整的调试支持
  • 跨平台：可在Windows、Linux、macOS上运行

一、环境准备

1.1 安装必要依赖

# Ubuntu/Debian系统sudoapt-getupdate&&sudoapt-getinstall-y\git\cmake\ninja-build\gperf\ccache\python3\python3-pip\python3-venv\device-tree-compiler\qemu-system-x86# QEMU x86模拟器# macOS系统（使用Homebrew）brewinstallgitcmake ninja gperf ccache python dtc qemu# Windows系统# 建议使用WSL2或直接安装Zephyr SDK

1.2 安装West工具

# 安装Westpipinstallwest# 验证安装west--version

1.3 获取Zephyr源码（最小化）

# 创建工作目录mkdir-p~/zephyrproject&&cd~/zephyrproject# 初始化West项目（只获取核心仓库）west init-mhttps://github.com/zephyrproject-rtos/zephyr--mrmain# 配置只下载必要组件west config manifest.project-filter -- -hal_* -lib_* -modules_*# 更新代码（仅核心仓库）west update--narrow# 安装Python依赖pipinstall-rzephyr/scripts/requirements.txt

二、最简工程结构

2.1 创建工程目录

# 创建工程目录mkdir-p~/zephyr-app&&cd~/zephyr-app# 创建必要文件touchCMakeLists.txt prj.conf src/main.c

2.2 工程文件结构

zephyr-app/ ├── CMakeLists.txt # CMake配置文件 ├── prj.conf # Kconfig配置文件 └── src/ └── main.c # 主程序入口

2.3 CMakeLists.txt配置

# CMakeLists.txt # 最低CMake版本要求 cmake_minimum_required(VERSION 3.20.0) # 包含Zephyr构建系统 find_package(Zephyr REQUIRED HINTS $ENV{ZEPHYR_BASE}) # 项目名称 project(my_minimal_app) # 添加源文件 target_sources(app PRIVATE src/main.c)

2.4 prj.conf配置（最简配置）

# prj.conf - 最简配置 # 基础配置 CONFIG_SOC_POSIX=y CONFIG_BOARD_QEMU_X86=y # 内核配置 CONFIG_KERNEL=y CONFIG_INIT_STACKS=y # 控制台输出 CONFIG_CONSOLE=y CONFIG_SERIAL=y CONFIG_UART_CONSOLE=y # 调试配置 CONFIG_DEBUG=y CONFIG_DEBUG_OPTIMIZATIONS=y # 系统时钟 CONFIG_SYS_CLOCK_HW_CYCLES_PER_SEC=100000000 # 定时器 CONFIG_TIMER=y CONFIG_SYS_CLOCK_TICKS_PER_SEC=100

三、编写最简应用代码

3.1 main.c 最小实现

/* src/main.c - 最简Zephyr应用 */#include<zephyr/kernel.h>#include<zephyr/sys/printk.h>/* 定义线程栈大小 */#defineSTACKSIZE1024/* 定义线程优先级 */#definePRIORITY7/* 线程函数 */voidmain_thread(void){intcount=0;while(1){printk("Hello Zephyr! Count: %d\n",count++);k_msleep(1000);}}/* 定义线程 */K_THREAD_DEFINE(main_tid,STACKSIZE,main_thread,NULL,NULL,NULL,PRIORITY,0,K_NO_WAIT);/* 主入口函数 */voidmain(void){printk("Zephyr minimal app started!\n");}

3.2 代码解释

部分说明
#include <zephyr/kernel.h>内核API头文件
#include <zephyr/sys/printk.h>打印函数头文件
K_THREAD_DEFINE定义静态线程
k_msleep()毫秒级延时函数
printk()内核打印函数

四、编译配置

4.1 设置环境变量

# 设置Zephyr基础路径exportZEPHYR_BASE=~/zephyrproject/zephyr# 设置SDK路径（如果需要）# export ZEPHYR_SDK_INSTALL_DIR=/opt/zephyr-sdk-0.17.2# 验证设置echo$ZEPHYR_BASE

4.2 编译命令

# 进入工程目录cd~/zephyr-app# 编译（指定qemu_x86目标板）west build-bqemu_x86.# 查看编译结果ls-labuild/zephyr/

4.3 编译输出

# 编译成功输出示例[100%]Linking C executable zephyr/zephyr.elf[100%]Built target zephyr

五、在QEMU中运行

5.1 运行命令

# 方式1：使用west run命令west build-trun# 方式2：手动运行QEMUqemu-system-i386\-cpuqemu32\-nographic\-kernelbuild/zephyr/zephyr.elf\-machinepc# 方式3：带调试端口运行qemu-system-i386\-cpuqemu32\-nographic\-kernelbuild/zephyr/zephyr.elf\-machinepc\-s-S

5.2 运行输出

# 预期输出SeaBIOS(version rel-1.16.0-0-gd239552ce722-prebuilt.qemu.org)Booting from ROM..*** Booting Zephyr OS build zephyr-v3.5.0-xxx *** Zephyr minimal app started!Hello Zephyr!Count:0Hello Zephyr!Count:1Hello Zephyr!Count:2...

5.3 退出QEMU

# 按 Ctrl+A 然后按 X 退出QEMU

六、调试配置

6.1 使用GDB调试

# 启动QEMU并监听调试端口qemu-system-i386\-cpuqemu32\-nographic\-kernelbuild/zephyr/zephyr.elf\-machinepc\-s-S&# 启动GDBgdb-multiarch build/zephyr/zephyr.elf# GDB命令(gdb)target remote localhost:1234(gdb)breakmain(gdb)continue(gdb)info threads(gdb)next(gdb)print count

6.2 VS Code调试配置

创建.vscode/launch.json：

{"version":"0.2.0","configurations":[{"name":"Zephyr QEMU Debug","type":"cppvsdbg","request":"launch","program":"${workspaceFolder}/build/zephyr/zephyr.elf","args":[],"stopAtEntry":false,"cwd":"${workspaceFolder}","environment":[],"externalConsole":false,"preLaunchTask":"build","MIMode":"gdb","miDebuggerPath":"gdb-multiarch","miDebuggerServerAddress":"localhost:1234","setupCommands":[{"description":"Enable pretty-printing for gdb","text":"-enable-pretty-printing","ignoreFailures":true}]}]}

七、进阶配置

7.1 添加shell支持

修改prj.conf：

# 添加shell支持 CONFIG_SHELL=y CONFIG_SHELL_BACKEND_SERIAL=y CONFIG_SHELL_PROMPT="zephyr> "

运行效果：

*** Booting Zephyr OS build zephyr-v3.5.0-xxx *** Zephyr minimal app started!zephyr>helpAvailable commands:help:print thishelpkernel:kernel commands version:print kernel version zephyr>kernel threads Threads: 0x200003e0 main_tidprio=70x20000100 idleprio=31zephyr>

7.2 添加定时器功能

/* 在main.c中添加定时器 */#include<zephyr/kernel.h>#include<zephyr/sys/printk.h>#defineTIMER_STACKSIZE512#defineTIMER_PRIORITY5structk_timermy_timer;voidtimer_expiry_fn(structk_timer*timer_id){printk("Timer expired!\n");}voidtimer_stop_fn(structk_timer*timer_id){printk("Timer stopped!\n");}K_TIMER_DEFINE(my_timer,timer_expiry_fn,timer_stop_fn);voidmain(void){printk("Starting timer...\n");k_timer_start(&my_timer,K_SECONDS(1),K_SECONDS(1));while(1){k_msleep(500);}}

7.3 添加线程间通信

/* 添加信号量示例 */#include<zephyr/kernel.h>#include<zephyr/sys/printk.h>#defineSTACKSIZE1024#definePRIORITY7K_SEM_DEFINE(my_sem,0,1);voidthread1(void){while(1){printk("Thread 1: Waiting for semaphore\n");k_sem_take(&my_sem,K_FOREVER);printk("Thread 1: Got semaphore\n");k_msleep(1000);}}voidthread2(void){while(1){printk("Thread 2: Giving semaphore\n");k_sem_give(&my_sem);k_msleep(2000);}}K_THREAD_DEFINE(thread1_tid,STACKSIZE,thread1,NULL,NULL,NULL,PRIORITY,0,K_NO_WAIT);K_THREAD_DEFINE(thread2_tid,STACKSIZE,thread2,NULL,NULL,NULL,PRIORITY+1,0,K_NO_WAIT);voidmain(void){printk("Thread communication example\n");}

八、常见问题与解决方案

8.1 QEMU未找到

问题：qemu-system-i386: command not found

解决：

# Ubuntu/Debiansudoapt-getinstallqemu-system-x86# macOSbrewinstallqemu# 验证安装qemu-system-i386--version

8.2 编译错误 - 缺少工具链

问题：arm-zephyr-eabi-gcc: command not found

解决：

# 对于x86平台，通常不需要额外工具链# 如果需要SDK，安装Zephyr SDKwgethttps://github.com/zephyrproject-rtos/sdk-ng/releases/download/v0.17.2/zephyr-sdk-0.17.2-setup.runchmod+x zephyr-sdk-0.17.2-setup.run ./zephyr-sdk-0.17.2-setup.run --include-i686 --include-qemu

8.3 链接错误 - undefined reference

问题：undefined reference to 'printk'

解决：

# 在prj.conf中添加 CONFIG_CONSOLE=y CONFIG_SERIAL=y CONFIG_UART_CONSOLE=y

8.4 QEMU运行无输出

问题：运行QEMU后没有输出

解决：

# 确保使用-nographic选项qemu-system-i386-nographic-kernelbuild/zephyr/zephyr.elf# 检查串口配置# 在prj.conf中添加CONFIG_UART_CONSOLE_ON_DEV_NAME="uart0"

九、最简工程模板

9.1 完整工程打包

# 创建模板目录结构mkdir-pzephyr-minimal-app/{src,config}cdzephyr-minimal-app# 创建CMakeLists.txtcat>CMakeLists.txt<<'EOF' cmake_minimum_required(VERSION 3.20.0) find_package(Zephyr REQUIRED HINTS $ENV{ZEPHYR_BASE}) project(minimal_app) target_sources(app PRIVATE src/main.c) EOF# 创建prj.confcat>prj.conf<<'EOF' CONFIG_SOC_POSIX=y CONFIG_BOARD_QEMU_X86=y CONFIG_KERNEL=y CONFIG_INIT_STACKS=y CONFIG_CONSOLE=y CONFIG_SERIAL=y CONFIG_UART_CONSOLE=y CONFIG_DEBUG=y CONFIG_DEBUG_OPTIMIZATIONS=y CONFIG_SYS_CLOCK_HW_CYCLES_PER_SEC=100000000 CONFIG_TIMER=y CONFIG_SYS_CLOCK_TICKS_PER_SEC=100 EOF# 创建main.ccat>src/main.c<<'EOF' #include <zephyr/kernel.h> #include <zephyr/sys/printk.h> #define STACKSIZE 1024 #define PRIORITY 7 void main_thread(void) { int count = 0; while (1) { printk("Hello Zephyr! Count: %d\n", count++); k_msleep(1000); } } K_THREAD_DEFINE(main_tid, STACKSIZE, main_thread, NULL, NULL, NULL, PRIORITY, 0, K_NO_WAIT); void main(void) { printk("Zephyr minimal app started!\n"); } EOFecho"Minimal Zephyr app created successfully!"

9.2 使用模板

# 使用模板创建工程mkdir-p~/myapp&&cd~/myappcp-r/path/to/zephyr-minimal-app/*.# 设置环境变量exportZEPHYR_BASE=~/zephyrproject/zephyr# 编译运行west build-bqemu_x86.west build-trun

十、性能优化建议

10.1 优化编译配置

# prj.conf - 优化配置 # 关闭调试信息（发布版本） CONFIG_DEBUG=n CONFIG_DEBUG_OPTIMIZATIONS=n CONFIG_OPTIMIZE_FOR_SIZE=y # 关闭不需要的功能 CONFIG_ASSERT=n CONFIG_LOG=n CONFIG_SHELL=n # 优化内存 CONFIG_HEAP_MEM_POOL_SIZE=2048 CONFIG_KERNEL_MEM_POOL_SIZE=1024

10.2 优化代码

// 优化后的main.c#include<zephyr/kernel.h>#include<zephyr/sys/printk.h>#defineSTACKSIZE512// 减小栈大小#definePRIORITY7voidmain_thread(void){staticintcount;// 使用静态变量节省栈空间for(;;){printk("Count: %d\n",count++);k_sleep(K_MSEC(1000));// 使用k_sleep替代k_msleep}}K_THREAD_DEFINE(main_tid,STACKSIZE,main_thread,NULL,NULL,NULL,PRIORITY,0,K_NO_WAIT);voidmain(void){}// 简化主函数

结束语

通过本文的介绍，您已经掌握了如何配置一个最简的Zephyr工程：

步骤内容
环境准备安装QEMU、West工具
工程结构CMakeLists.txt + prj.conf + src/main.c
编译命令west build -b qemu_x86 .
运行命令west build -t run
调试方法GDB + QEMU远程调试

最简工程的优势：

  1. 快速上手：无需硬件设备，QEMU即可运行
  2. 资源高效：只包含必要组件，编译速度快
  3. 易于学习：代码量少，便于理解Zephyr核心概念
  4. 可扩展性：可以逐步添加功能

建议在掌握最简工程后，尝试添加更多功能：

  • Shell交互
  • 定时器
  • 线程间通信
  • 文件系统
  • 网络功能

参考资料：

  • Zephyr官方文档
  • Zephyr快速入门
  • QEMU官方文档
  • Zephyr GitHub仓库
http://www.zskr.cn/news/1530334.html

相关文章：

  • 2026-06-15：频率唯一的第一个元素。用go语言，从左到右扫描数组，统计每个元素出现的次数。对每个元素判断它的出现频率是否与其他元素不同：也就是它的出现次数在所有元素中是唯一的那种。找到最先满足
  • 企业AI可见度怎么检测？中科信枢带你理清优化思路
  • wx-charts：微信小程序图表库的技术演进与架构解析
  • 终极暗黑2现代化补丁：d2dx优化方案全面解析
  • 2026年沈阳香港留学申请哪家专业:五家优选深度解析 - 科技焦点
  • 计算机毕业设计之jspm学生信息管理系统
  • 2026衡水缆索护栏厂家实力排行：5家合规供应商盘点 - 奔跑123
  • Windows Defender彻底移除指南：3种高效方案解决顽固安全中心问题
  • STM51单片机学习（五）
  • 深入解析PowerPC评估板Yellowknife X4：硬件架构、跳线配置与调试实战
  • Windows 安卓应用安装终极指南：APK-Installer完整使用教程
  • 厦门闲置黄金变现指南 揭秘回收套路与靠谱门店 - 余生黄金回收
  • 2026常州黄金白银回收实体门店 可上门服务靠谱机构盘点 - 开心测评
  • GeoJSON.io完全指南：5分钟学会免费在线地理数据编辑
  • 免费开源歌唱语音转换神器：DDSP-SVC完整指南 [特殊字符]
  • 2026东莞上门收黄金 免费估价现款现结 靠谱回收商家口碑榜 - 开心测评
  • 2026年茂名汽车贴膜门店盘点，IASCA裁判技术标准解析 - 国麟测评
  • 2026上海百达翡丽手表快速变现指南：收的顶报价实在当场结算，不压价 - 奢侈品回收评测
  • 2026西安名表回收测评｜劳力士百达翡丽高价变现门店排名 - 名奢变现站
  • 雏菊工具箱：一个不偷你数据、不弹广告、不拖慢你电脑的在线工具站
  • 2026年无锡专业研究生留学中介推荐:五家优选深度解析 - 科技焦点
  • 计算机毕业设计之基于web的团员信息管理系统
  • AI时代生存指南：收藏这份未来程序员金字塔，小白也能轻松入行！
  • Platinum-MD：现代NetMD设备无损音频传输终极指南
  • 3步解锁网易游戏NPK文件：新手也能掌握的完整解包指南
  • 直播过程中被竞争对手举报？黄金6小时危机公关
  • 2026青岛LV包包回收TOP5测评｜本土正规门店行情实测 - 奢侈品回收测评
  • 快速构建专业动漫库：Jellyfin Bangumi插件完整指南
  • 西安老金、旧黄金怎么卖？6 家回收门店实测，老金变现不踩坑 - 奢侈品回收测评
  • 汕头卖黄金避坑攻略 2026优质回收商家汇总 - 余生黄金回收