1. 没有板子也要验证 ARM 程序:QEMU 能替你做什么
手头一份交叉编译出来的 ARM 程序,板子还在采购流程里,怎么确认它能不能跑起来?我碰到这种情况不止一次,最后的办法是在 x86 开发机上装一套 QEMU,用软件模拟出一块 ARM 开发板。QEMU 属于代码开发工具里偏底层的那一类,它不替你写代码,而是把 CPU、内存、串口、中断控制器这些硬件行为用软件复现出来,让内核和用户态程序以为自己真跑在板子上。它解决的是“没有硬件也能反复启动、反复崩溃、反复重来”的问题,适合正在写启动代码、调驱动雏形、验证交叉编译产物的人。代价是外设只能模拟到“够用”的程度,别指望拿它测真实时序和模拟电路。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 依赖与源码准备:qemu-2.7.0 落地前的三件事
2.1 为什么先把目标板定在 Versatile Express-A9
QEMU 里 -M 能列出一长串 ARM 机器型号,多到第一次看会挑花眼。挑机器不是挑新的,而是挑“出问题时你能把责任分清楚”的那一块。Versatile Express-A9 用的是 Cortex-A9 核,外设构成相对克制:PL011 串口、SP804 定时器、GIC 中断控制器、一块 NOR/MMC 存储,启动链条是 kernel + dtb + rootfs 三件套,少一件会直接报错而不是静默卡死。这一点在排查时非常值钱。
我也试过更现代的 virt 机型,它启动更快、设备树由 QEMU 动态生成、几乎不需要额外文件,但它是一块“纯虚拟板”,没有对应的真实硬件路径。你在它上面跑通的板级初始化和驱动,搬到真实板子上往往要重写一遍。Realview 系列更老,内存映射和中断号与现在常见的学习资料对不上。所以如果目的是验证“板级代码能不能走通”,vexpress-a9 更接近真机那条路径;如果只是想快速跑个用户态程序,virt 更省事。这里选前者,因为后面要讲的内核启动、串口控制台、设备树加载,都是围绕它展开的。
还有一个现实原因:这块板子的启动参数在社区里被讨论得足够多,遇到问题能搜到同型号的报错,而不是对着一块冷门板子自己猜。选型阶段多花十分钟,后面能省掉一晚上的玄学调试。
2.2 六个依赖包,缺一个 configure 就过不去
QEMU 的构建依赖不算多,但每一个都是硬依赖,缺了不是警告而是直接中断。zlib1g-dev 提供压缩库头文件,QEMU 读写压缩镜像格式时要用;libglib2.0-0 是运行时库,libglib2.0-dev 是开发头文件,QEMU 内部大量使用 GLib 的哈希表、字符串和事件循环,这两个必须成对装,只装前者会在编译阶段报找不到 glib.h;autoconf 用来生成 configure 脚本;flex 和 bison 负责词法与语法分析,QEMU 的部分指令解析代码由它们生成;libtool 参与库的构建与链接。
bash复制sudo apt-get update
sudo apt-get install -y zlib1g-dev libglib2.0-0 libglib2.0-dev \
autoconf flex bison libtool
-y 是免交互确认,反斜杠是续行,把六个包写在一行里装完比一条一条敲省事。但如果你正在定位“到底缺哪个包”,建议还是拆成单条执行,报错会直接停在出问题的那一行,比装完一堆再看 configure 日志快得多。apt-get update 先跑一遍,否则老系统上的包索引可能指向已经下线的源。
装完可以用 dpkg -l | grep glib 之类的方式确认开发包真的落地了,而不是只看 apt 输出里的“已经是最新版”。这一步不算多余,后面 configure 报错时你会庆幸自己确认过。
2.3 解压源码包:别用 sudo
qemu-2.7.0 的源码包是 bz2 格式,tar 的 -j 参数对应 bzip2 解压,-x 解包、-v 显示过程、-f 指定文件,四个参数一个都不能少。
bash复制cd ~/work
tar -jxvf qemu-2.7.0.tar.bz2
cd qemu-2.7.0
ls
ls 之后你应该能看到 configure、Makefile、hw/、target-arm/ 这些目录。如果解压出来多了一层同名目录,说明压缩包内部带了顶层文件夹,cd 进去就行。
这里有个很容易被忽略的细节:很多教程写的是 sudo tar -jxvf。用 sudo 解压,包内所有文件的属主会变成 root,之后你用普通用户执行 make,编译器往源码树里写 .o 文件时会直接报 Permission denied,而且报错位置在编译到一半的时候,看起来像是代码问题。所以解压这一步不要 sudo,谁编译谁解压。真要用了 sudo,补救办法是 sudo chown -R $USER:$USER qemu-2.7.0,把属主改回来再继续。
源码树放哪个目录也有讲究。放在 ~ 下没问题,放在挂载的共享目录里编译会明显变慢,因为 QEMU 编译过程有大量小文件读写。我一般固定在 ~/work 下建一个源码目录,路径短、权限清晰、删起来也方便。
3. 配置与编译:configure 的取舍决定你等十分钟还是半小时
3.1 --target-list 只编需要的架构
QEMU 默认会为它支持的所有目标架构都编译一遍,x86、ARM、MIPS、PPC 全来,编译时间直接翻几倍,磁盘占用也跟着涨。我们只需要 ARM 的系统模拟,所以用 --target-list 把范围收窄到 arm-softmmu。softmmu 指的是系统级模拟,也就是能跑完整操作系统的那种;相对的 linux-user 是用户态模拟,只能跑单个程序,两者的能力边界完全不同,别选错。
bash复制./configure \
--target-list=arm-softmmu \
--prefix=/usr/local/qemu-2.7.0
--prefix 决定 make install 之后文件装到哪。装到独立目录而不是默认的 /usr/local,好处是以后想换版本、想删干净,直接删目录就行,不会和系统里已有的 QEMU 打架。装完记得把这个目录下的 bin 加进 PATH,否则你敲 qemu-system-arm 时系统找到的可能是另一个版本。
configure 跑完会打印一大段摘要,重点看三行:目标列表里是不是只有 arm-softmmu、GLib 的版本号有没有被识别出来、以及最后一行是不是 Install prefix。摘要里任何一项显示 no,都别急着 make,先回去补依赖。
3.2 并行编译:-j 开多大要看内存
QEMU 的编译单元不少,单线程编译很磨人。make -j 后面跟并行任务数,经验值是与 CPU 核心数持平,或者略高于核心数。
bash复制make -j$(nproc)
$(nproc) 会返回当前机器的可用核心数,这样写的好处是换机器不用改命令。但并行度不是越高越好:每个编译任务都要吃内存,核心数多的机器如果内存偏小,很容易在编译中途触发 OOM,表现是某个 cc1 进程被系统杀掉、make 报 Error 1 退出。遇到这种情况不要怀疑代码,先 dmesg | tail 看有没有 out of memory 的记录,然后把 -j 降到核心数的一半再试。
编译时间取决于机器,这段时间适合去把后面要用的内核和设备树准备好。中途想确认进度,看输出里滚动的文件名就行,卡在同一个文件超过几分钟,多半是内存或磁盘 IO 的问题,不是死锁。
3.3 安装与第一轮验证
编译通过只是说明代码能生成,装完能跑起来才算数。
bash复制sudo make install
export PATH=/usr/local/qemu-2.7.0/bin:$PATH
qemu-system-arm -M help | grep -i vexpress
第一行把产物装到 configure 时指定的前缀目录,需要写权限所以带 sudo。第二行把新装的 bin 目录放到 PATH 最前面,注意 export 只对当前终端有效,新开窗口要重新执行,想长期生效得写进 shell 的启动文件。第三行是最关键的验证:-M help 会列出所有支持的机器型号,用 grep 过滤出 vexpress 相关的条目。能看到 vexpress-a9 和 vexpress-a15,说明这套 QEMU 至少具备了跑目标板的能力。
如果 grep 什么都没输出,先确认 PATH 生效了没有,用 which qemu-system-arm 看指向的是不是刚装的那个。指向错了,你验证的其实是系统自带的老版本,后面所有参数都可能对不上。
从这一步起,qemu-system-arm 就是你的“板子”了。它没有电源键,也没有复位按钮,但参数配错它会用报错和黑屏告诉你。
4. 用 vexpress-a9 启动:一条命令里每个参数都在干活
4.1 启动命令拆解与参数表
一条典型的启动命令长这样,看起来参数很多,其实每个都对应一块硬件或者一个启动约定:
bash复制qemu-system-arm \
-M vexpress-a9 \
-m 512M \
-kernel zImage \
-dtb vexpress-v2p-ca9.dtb \
-append "root=/dev/mmcblk0 rw console=ttyAMA0" \
-sd rootfs.img \
-nographic
| 参数 | 作用 | 常见取值与注意点 |
|---|---|---|
-M |
指定模拟的机器型号 | vexpress-a9,必须与设备树文件匹配 |
-m |
分配给客户机的内存 | 512M,太小内核起不来,太大宿主机吃紧 |
-kernel |
指定内核镜像 | zImage,自编译压缩内核 |
-dtb |
指定设备树二进制 | vexpress-v2p-ca9.dtb,A9 与 A15 不通用 |
-append |
传给内核的命令行 | 根分区与控制台设备名写在这里 |
-sd |
挂一块 SD 卡镜像 | rootfs.img,作为根文件系统 |
-nographic |
关闭图形窗口,串口接到终端 | 调试阶段几乎必开 |
-m 的取值别照抄。512M 对 vexpress-a9 是够用的,但如果你的根文件系统里跑了比较重的服务,或者内核开了较大的内存保留区,可以考虑往上加,前提是宿主机本身内存充裕。反过来,如果只是想验证内核能不能启动到串口打印,256M 也能跑,省下来的内存留给编译。
4.2 控制台为什么必须是 ttyAMA0
这是最容易翻车的一个参数。vexpress-a9 板载的串口是 PL011 类型的 UART,在 Linux 内核里对应的设备节点名是 ttyAMA0;而很多 x86 或者其它 ARM 平台上常见的是 8250 系列串口,设备名是 ttyS0。两者的驱动完全不是一套。
如果你在 -append 里写了 console=ttyS0,现象是 QEMU 正常启动、不报错、终端一片漆黑,你会以为内核根本没跑起来,其实是内核把所有打印都送到一个不存在的设备上去了。改回 console=ttyAMA0 立刻就有输出。这个坑没有报错提示,纯靠经验。
root= 后面的 /dev/mmcblk0 对应 -sd 挂上去的那块卡。如果你没挂 -sd,内核会在挂载根文件系统时 panic,报 VFS: Unable to mount root fs,这属于预期行为,说明前面的启动流程其实是通的,只是缺了根文件系统。
4.3 怎么退出、怎么切监视器
-nographic 模式下,QEMU 把标准输入输出都接管了,Ctrl+C 不一定能干净地退出,正确做法是先按 Ctrl+A 松开再按 X,这是 QEMU 的退出组合键。另外 Ctrl+A 再按 C 会在客户机串口和 QEMU 监视器之间切换,监视器里可以查寄存器、看块设备、做内存 dump,调试时比反复重启有用。
有个细节值得记住:退出组合键是两段式的,先按住 Ctrl 和 A,松开,再单独按 X。第一次用的人经常三个键一起按,结果没反应,以为是 QEMU 卡死了。
5. 避坑:把 QEMU 当代码开发工具时最容易翻车的五件事
5.1 依赖与权限:报错信息永远不说人话
现象一:configure 跑到一半中断,末尾提示 glib-2.0 not found 或者 Please install libglib2.0-dev。
原因:系统里装的是 libglib2.0-0,这是运行时库,只包含 .so 文件,不含编译需要的头文件和 pkg-config 描述文件。QEMU 编译时要 include glib.h,找不到就停。
解决:补装 libglib2.0-dev,然后重新执行 configure。这里有个二次坑:装完直接跑 ./configure 有时仍然报同样的错,因为上一次失败留下的缓存还在。先 make distclean 清掉,再重新 configure。
现象二:编译到某个源文件时报 Permission denied,路径指向源码树内部的 .o 文件。
原因:解压时用了 sudo,源码树属主是 root,普通用户没有写权限。报错位置在编译中途,很容易被误判成代码或磁盘问题。
解决:sudo chown -R $USER:$USER 源码目录,把属主改回来。根治办法是解压这一步就别用 sudo。
5.2 启动之后没输出:先怀疑串口名,再怀疑内核
现象:敲完启动命令,QEMU 进程在跑,CPU 占用也不低,但终端没有任何输出,等几分钟还是黑的。
原因:绝大多数情况是 -append 里的 console= 写错了设备名。vexpress-a9 是 PL011,必须写 ttyAMA0;写成 ttyS0 内核照样启动,只是打印全丢。少数情况是 -dtb 用错了型号,比如把 a15 的设备树喂给 a9,内存映射对不上,内核早期就挂了,连串口都来不及初始化。
解决:先确认 console=ttyAMA0,再确认 dtb 文件名与 -M 的型号一致。两个都对了还没输出,就把 -nographic 去掉、改用图形窗口看,或者在命令里加 -serial mon:stdio 显式把串口接到标准输入输出,看是不是输出通道的问题而不是内核的问题。
5.3 资源与缓存:编译期的两个隐形杀手
现象三:make -j 跑到一半,输出里出现 internal compiler error 或者干脆 Killed,make 以 Error 1 退出。
原因:并行编译的每个任务都要占内存,核心数开满而内存不足时,系统的 OOM killer 会杀掉某个编译进程。日志里通常没有“内存不足”四个字,只有一个莫名其妙的失败。
解决:dmesg | tail 确认有没有 OOM 记录,然后把 -j 降到核心数的一半甚至四分之一,重新 make。已经编好的目标文件不会重编,不用从头来。
现象四:改了 configure 参数(比如换了 --target-list),重新执行 configure 也显示成功,但编出来的东西和之前一模一样,新架构根本没出现。
原因:源码树里残留着上一次的 config-host.mak 等缓存文件,configure 读取了旧配置。
解决:改配置之前先 make distclean,把生成物和缓存一起清掉。养成“改配置先 distclean”的习惯,能省掉大量“为什么没生效”的困惑。
6. 进阶:把 QEMU 固化成日常开发工具的参数模板
6.1 用 -s -S 接上 gdb,把黑屏变成可单步的现场
启动阶段出问题时,串口打印只能告诉你“到哪一步挂了”,看不到寄存器和栈。QEMU 内置 gdb stub,加两个参数就能把客户机变成可调试目标:
bash复制qemu-system-arm \
-M vexpress-a9 -m 512M \
-kernel zImage -dtb vexpress-v2p-ca9.dtb \
-append "console=ttyAMA0" \
-nographic -s -S
-s 是 -gdb tcp::1234 的简写,在 1234 端口开一个 gdb 服务;-S 表示启动后立即暂停,等调试器连上来才继续跑。两个参数少任何一个都不行:只加 -s 内核会一路跑到底,你连上去时现场早就过去了。
另一个终端里:
bash复制arm-none-linux-gnueabi-gdb vmlinux
(gdb) target remote :1234
(gdb) break start_kernel
(gdb) continue
vmlinux 是带符号的内核镜像,注意不是 zImage,压缩过的镜像里没有调试信息。连上之后能下断点、看寄存器、单步走早期初始化代码,比对着串口日志猜快得多。这套组合在调 MMU 开启前后的代码时尤其有用,因为那段代码一旦跑飞,串口还没初始化,什么输出都没有。
6.2 把参数写进脚本,别靠记忆和上下键
每条启动命令都有七八个参数,靠 shell 历史翻找迟早会敲错一个。我一般写一个 run.sh 放在工作目录:
bash复制#!/bin/bash
KERNEL=zImage
DTB=vexpress-v2p-ca9.dtb
ROOTFS=rootfs.img
MEM=512M
CMDLINE="root=/dev/mmcblk0 rw console=ttyAMA0"
exec qemu-system-arm \
-M vexpress-a9 \
-m ${MEM} \
-kernel ${KERNEL} \
-dtb ${DTB} \
-append "${CMDLINE}" \
-sd ${ROOTFS} \
-nographic \
"$@"
变量抽出来的好处是换内核、换根文件系统只改一行。末尾的 "$@" 把调用脚本时额外传的参数原样透传给 QEMU,这样临时想加 -s -S 或者换内存,直接 ./run.sh -s -S 就行,不用改脚本本身。exec 让 QEMU 顶替 shell 进程,退出时不会有残留。
再进一步,可以在这个脚本里根据参数切换“调试模式”和“日常模式”,调试模式带 -s -S,日常模式带 -snapshot。-snapshot 表示所有写操作都不落盘,客户机里怎么折腾,重启后镜像还是干净的,做破坏性实验时很省心,不用每次都重新烧一份 rootfs。
6.3 一套我自己会走的验证顺序
装完一套新环境,我不会直接上业务镜像,而是按固定顺序过一遍,出问题时能立刻定位到是哪一层:
| 步骤 | 验证内容 | 通过标志 |
|---|---|---|
| 1 | qemu-system-arm -M help 能列出 vexpress-a9 |
说明编译和安装成功 |
| 2 | 只带 -kernel 和 -nographic 启动 |
能看到内核早期解压信息 |
| 3 | 加上 -dtb 与 console=ttyAMA0 |
能看到完整启动日志直到挂载根文件系统 |
| 4 | 加上 -sd rootfs.img |
能进 shell 或看到 init 输出 |
| 5 | 加 -s -S 挂 gdb |
能停在 start_kernel 断点 |
这个顺序的价值在于每一步只增加一个变量。第 2 步失败说明内核镜像本身有问题,第 3 步失败说明设备树或串口参数不对,第 4 步失败才是根文件系统的事。很多人跳过前两步直接跑完整命令,黑屏之后不知道从哪查起,只能一条条参数删着试,反而是最慢的。
血泪经验是:QEMU 这东西不会骗你,它给的报错信息通常都是真的,只是位置离真正的原因有点远。configure 报缺 glib,问题可能出在半小时前那次没跑成功的 apt;启动黑屏,问题可能出在你复制粘贴时多带的一个空格。从那以后我每次搭新环境,都强制自己按上面那张表走一遍,不跳步、不抄长命令、每个参数都问一句“它对应哪块硬件”。环境这种东西,第一次多花二十分钟,后面能少掉很多个深夜。希望帮到你。
