1. 项目缘起与整体设计思路1.1 为什么选择Zynq7020做Linux实验Zynq7020这颗芯片在嵌入式圈子里算是老面孔了但它的生命力一直很旺盛。核心原因在于它的架构——PS端双核Cortex-A9加上PL端Artix-7 FPGA逻辑这种ARMFPGA的异构组合让它在工业控制、图像处理、通信加速等领域有天然优势。我选择在这个平台上跑Linux实验不是为了赶时髦而是因为它的软硬件协同能力确实能解决很多纯ARM或纯FPGA方案搞不定的问题。具体到这块开发板它的外设配置比较齐全千兆网口、USB Host、SD卡槽、QSPI Flash、DDR3内存、HDMI输出、音频编解码器还有一堆扩展IO。这些资源对于学习Linux系统移植、驱动开发、设备树配置来说素材足够丰富。而且社区资料相对成熟遇到问题不至于完全抓瞎。这个实验项目的目标很明确从零开始把Linux系统在这块板子上跑起来然后逐步验证各个外设的功能最后能自己写一些简单的驱动和应用程序。适合的读者是有一定C语言基础、了解基本数字电路、但没怎么接触过嵌入式Linux的开发者。如果你之前只玩过单片机裸机开发这个项目会是一个很好的进阶跳板。1.2 整体方案选型与架构拆解整个实验的架构可以分成三个层次来理解。最底层是硬件平台包括Zynq芯片本身和板载外设中间层是启动引导链从BootROM到FSBL再到U-Boot最后加载Linux内核最上层是根文件系统和用户空间应用。启动流程这块Zynq有个特殊之处它上电后先执行芯片内部固化的BootROM然后根据启动模式引脚选择从QSPI、SD卡还是JTAG加载FSBL。FSBL负责初始化DDR、配置PL端比特流、加载U-Boot。U-Boot再加载内核和设备树最后挂载根文件系统。这个链条里任何一环出问题系统都起不来。方案选型上我对比过几种常见做法。一种是直接用Xilinx的PetaLinux工具链优点是自动化程度高一条命令生成所有镜像缺点是封装太深出了问题不好排查。另一种是手动构建用官方的FSBL源码、U-Boot源码、内核源码分别编译再自己制作根文件系统。我最终选择手动构建为主、PetaLinux为辅的方式。原因很简单手动构建能让你真正理解每个环节在干什么遇到启动失败时知道从哪查起。PetaLinux可以用来快速验证硬件配置是否正确但学习阶段不建议完全依赖它。根文件系统方面我用了BusyBox加上手动编译的一些库和工具。BusyBox的好处是体积小、可裁剪适合嵌入式场景。但要注意BusyBox的某些命令和桌面Linux上的GNU版本行为有差异写脚本时得留个心眼。比如ps命令的参数支持就不太一样这个后面会细说。2. 开发环境搭建与核心工具链配置2.1 交叉编译工具链的选择与安装交叉编译工具链是整个开发流程的基础。Zynq7020的PS端是Cortex-A9属于ARMv7-A架构带硬件浮点单元。所以工具链要选arm-linux-gnueabihfhf后缀表示硬浮点。如果误用了软浮点的arm-linux-gnueabi编译出来的程序性能会差很多而且某些依赖浮点运算的库可能直接跑不起来。我推荐用Linaro或者ARM官方发布的工具链。安装步骤不复杂下载压缩包后解压到/opt目录然后把bin目录加到PATH环境变量里。验证是否安装成功可以执行arm-linux-gnueabihf-gcc -v看看版本信息是否正常输出。这里有个细节要注意工具链的版本和内核版本要匹配。太新的工具链编译老内核可能会报错太老的又可能不支持某些新特性。我一般选择比内核版本晚一到两年的工具链兼容性比较稳。比如内核用4.14版本工具链选7.3或8.2的都行。提示安装完工具链后建议在~/.bashrc里设置好环境变量避免每次打开终端都要手动export。同时把工具链的sysroot路径记下来编译某些库时需要指定。2.2 源码获取与版本管理策略这个项目涉及多个源码包FSBL、U-Boot、Linux内核、设备树、BusyBox。每个包的版本选择都很关键。我的建议是尽量用Xilinx官方发布的对应版本因为他们在自己的分支里加了一些针对Zynq的补丁直接用主线版本可能会缺少某些驱动支持。U-Boot我选的是2017.01版本内核是4.14.0。这两个版本搭配比较成熟社区里踩过的坑基本都有记录。设备树用的是内核自带的zynq-zed相关文件做参考然后根据自己板子的实际硬件连接修改。源码管理上我习惯用Git做版本控制。每修改一个关键配置就提交一次写清楚改了什么、为什么改。这样后面如果系统起不来可以快速回退到上一个能工作的状态。别小看这个习惯调试启动问题时能省下大量时间。2.3 硬件连接与串口终端配置调试嵌入式Linux串口是生命线。板子上的UART接口通过USB转串口芯片连接到电脑在电脑上会识别出一个/dev/ttyUSBx设备。Linux下可以用minicom或picocomWindows下用SecureCRT或Putty。串口参数一般是115200波特率、8数据位、无校验、1停止位、无流控。连接成功后上电就能看到FSBL和U-Boot的打印信息。如果乱码先检查波特率对不对如果完全没输出检查串口线是否接对、板子是否正常供电。我习惯在串口终端里开启日志记录功能把整个启动过程保存到文件里。这样系统启动失败时可以慢慢翻看是哪一步卡住了。另外U-Boot阶段可以通过串口发送文件比如用loady命令通过YMODEM协议传输镜像这比反复拔插SD卡方便多了。3. 启动链路的逐级实现与关键细节3.1 FSBL的编译与启动模式配置FSBL全称First Stage Boot Loader是Zynq启动流程中第一个由用户编写的程序。它的主要任务包括初始化DDR控制器、配置时钟、加载PL端比特流、加载U-Boot到DDR、跳转到U-Boot执行。编译FSBL需要用到Xilinx的SDK或者Vitis工具。新建一个FSBL工程选择对应的硬件平台描述文件然后直接编译就能生成fsbl.elf。但这里有个关键点FSBL的代码里会根据启动模式引脚判断从哪里加载后续镜像。如果启动模式设置不对FSBL会卡在等待状态。Zynq7020的启动模式由MIO[8:6]三个引脚决定。常见配置是SD卡启动对应001QSPI启动对应010JTAG启动对应000。板子上一般有跳线帽或者拨码开关来选择。我建议调试阶段用SD卡启动因为把镜像文件拷到SD卡里最方便改完重新插卡就行。制作启动镜像时需要把FSBL的elf文件、PL的bit文件、U-Boot的elf文件打包成一个BOOT.BIN。Xilinx提供了bootgen工具来做这件事需要一个.bif配置文件描述各个镜像的加载地址和顺序。这个文件写错了启动就会失败而且报错信息往往很模糊得靠经验判断。3.2 U-Boot的移植与环境变量调优U-Boot的移植工作量主要集中在板级配置文件和设备树。Zynq的U-Boot源码里已经有zynq_common相关的通用配置我们需要做的是根据自己的硬件修改DDR参数、串口配置、网络PHY地址等。DDR参数尤其重要。Zynq7020支持DDR3但不同板子用的内存颗粒型号可能不同时序参数需要对应调整。Xilinx提供了一个DDR配置工具可以根据颗粒手册生成参数。如果DDR参数不对系统可能在FSBL阶段就挂了或者跑起来后频繁死机。U-Boot的环境变量保存在QSPI或者SD卡的一个分区里。我习惯把bootargs和bootcmd设置好让U-Boot自动加载内核。bootargs里要指定控制台设备、根文件系统位置、内存大小等。比如setenv bootargs consolettyPS0,115200 root/dev/mmcblk0p2 rw rootwait earlyprintk setenv bootcmd fatload mmc 0 0x3000000 zImage; fatload mmc 0 0x2A00000 devicetree.dtb; bootz 0x3000000 - 0x2A00000 saveenv这段配置的意思是从SD卡第一个分区加载内核和设备树到指定内存地址然后启动。地址不能随便写要避开U-Boot自身占用的区域和FSBL保留区域。一般内核加载地址用0x3000000设备树用0x2A00000这是比较安全的。注意修改环境变量后一定要执行saveenv保存否则重启就丢了。如果改错了导致起不来可以在U-Boot启动时按任意键进入命令行用setenv恢复默认值。3.3 内核配置与设备树编写要点内核配置是个体力活。Zynq平台需要开启的东西不少串口驱动、MMC驱动、网络驱动、USB驱动、GPIO驱动、中断控制器、时钟框架等等。我一般先用xilinx_zynq_defconfig作为基础然后在此基础上增删。设备树是内核识别硬件的关键。Zynq的设备树文件一般放在arch/arm/boot/dts/目录下。我们需要描述的内容包括内存大小和地址、串口寄存器地址和中断号、MMC控制器、以太网PHY、USB PHY、QSPI控制器、GPIO引脚分配等。写设备树最容易出错的地方是寄存器地址和中断号。这些信息要从Zynq的技术参考手册里查不能凭感觉写。比如UART0的寄存器基地址是0xE0000000中断号是59。写错了内核启动时就会报错或者设备根本识别不到。PL端的设备如果要在Linux里访问也需要在设备树里描述。比如通过AXI总线挂载的自定义IP核需要添加对应的节点指定兼容性字符串、寄存器范围、中断等。这部分内容比较进阶建议先把PS端的外设调通再折腾。4. 根文件系统制作与外设功能验证4.1 BusyBox根文件系统的构建流程根文件系统是Linux启动后挂载的第一个文件系统里面包含了/bin、/sbin、/etc、/dev等基本目录结构和必要的命令。用BusyBox构建根文件系统的步骤大致如下第一步下载BusyBox源码配置交叉编译选项。在make menuconfig里设置CONFIG_PREFIX为你的目标目录比如/home/user/rootfs。然后选择需要的命令和功能不需要的可以去掉以减小体积。第二步执行make和make installBusyBox会把编译好的二进制文件和符号链接安装到目标目录。第三步创建必要的目录和设备节点。/dev目录下需要手动创建console和null两个设备节点否则内核启动时会报错。命令是sudo mknod dev/console c 5 1 sudo mknod dev/null c 1 3第四步编写/etc/inittab和/etc/init.d/rcS启动脚本。inittab定义系统启动后执行哪些程序rcS里可以挂载proc、sysfs、tmpfs等虚拟文件系统设置网络参数等。第五步把整个根文件系统打包成镜像文件或者直接拷贝到SD卡的某个分区。我一般用ext4格式的分区把rootfs内容拷进去就行。4.2 网络与存储外设的功能验证系统跑起来后第一件事是验证网络。Zynq的千兆网口在Linux下一般识别为eth0。用ifconfig eth0 192.168.1.100设置IP然后ping一下同网段的设备。如果ping不通先检查PHY芯片的复位引脚和MDIO地址在设备树里写对没有。存储方面SD卡在Linux下识别为/dev/mmcblk0分区是mmcblk0p1、mmcblk0p2等。可以用mount命令挂载然后读写测试。QSPI Flash一般识别为/dev/mtd0可以用flash_erase和nandwrite等工具操作但要注意别把启动镜像给擦了。USB Host功能验证可以插个U盘看看系统有没有识别到/dev/sda。如果没反应检查USB PHY的复位和时钟配置。HDMI输出需要内核开启DRM驱动配置正确的话可以在/dev/fb0看到帧缓冲设备。4.3 GPIO与中断的应用程序开发GPIO是最基础的外设也是验证驱动是否正常的好方法。Zynq的GPIO通过/sys/class/gpio接口操作。比如要控制MIO第50号引脚先echo 50 /sys/class/gpio/export然后设置方向为输出再写值。中断实验稍微复杂一点。可以用PL端的GPIO产生中断信号然后在Linux里注册中断处理函数。写一个简单的字符设备驱动在open时申请GPIO和中断在中断处理函数里打印信息或者唤醒等待队列。应用程序通过read系统调用阻塞等待中断事件。这里有个坑要注意Zynq的中断控制器是GICPL端的中断需要正确配置interrupt-parent和interrupts属性。中断号的计算方式是SPI中断号 32 PL中断编号。比如PL的第0号中断在设备树里要写成0 32 4其中4表示高电平触发。5. 常见问题排查与实操避坑指南5.1 启动失败类问题速查启动失败是最让人头疼的问题因为现象往往只是一行报错或者完全没输出。我整理了一个排查表按启动阶段分类故障现象可能原因排查方法串口无任何输出供电不足、串口线接错、启动模式不对测电压、换线、检查跳线FSBL打印后卡住DDR参数错误、PL比特流加载失败用JTAG调试、检查bif文件U-Boot能启动但找不到内核加载地址冲突、文件系统格式不对检查bootcmd、确认FAT分区内核启动后panic设备树错误、根文件系统挂载失败看panic信息、检查bootargs系统起来但外设不工作驱动未编译、设备树节点缺失查dmesg、对比参考设备树JTAG调试是排查启动问题的终极手段。通过Xilinx的硬件服务器连接板子可以单步执行FSBL看它到底卡在哪一行。虽然麻烦但比盲目猜要高效得多。5.2 驱动加载与设备识别问题有时候内核起来了但某个外设就是识别不到。首先用dmesg | grep xxx看内核日志里有没有相关打印。如果完全没有说明设备树里可能没写这个节点或者状态是disabled。如果有打印但报错根据错误码判断是时钟问题、引脚复用问题还是电源问题。引脚复用是Zynq特有的坑。一个MIO引脚可能被多个功能复用比如UART和GPIO可能共用同一个引脚。如果设备树里同时使能了这两个功能就会冲突。解决方法是检查pinctrl配置确保每个引脚只分配给一个功能。提示修改设备树后不需要重新编译整个内核只需要重新编译dtb文件然后替换SD卡里的dtb即可。命令是make dtbs生成的文件在arch/arm/boot/dts/目录下。5.3 性能调优与稳定性经验系统跑起来之后如果发现响应慢或者偶尔死机可以从几个方面排查。首先是DDR频率和时序用memtester跑一下内存测试看有没有错误。其次是CPU频率Zynq7020的PS端可以跑到666MHz或766MHz检查时钟配置是否正确。电源稳定性也很关键。Zynq对核心电压和DDR电压的纹波比较敏感如果板子供电设计一般高负载时可能掉电重启。可以用示波器观察电源纹波必要时加滤波电容。软件层面关闭不需要的内核调试选项可以提升性能。比如CONFIG_DEBUG_INFO、CONFIG_FTRACE这些在正式使用时可以关掉。文件系统用ext4比jffs2性能好但要注意断电保护。我个人在实际操作中的体会是嵌入式Linux调试最耗时的不是写代码而是定位问题。一个启动失败可能涉及硬件、FSBL、U-Boot、内核、设备树、根文件系统六个环节。我的习惯是每完成一个环节就做一次完整测试确保这一层没问题再往下走。这样出问题时排查范围就缩小到最近改动的那一层效率会高很多。最后再分享一个小技巧在U-Boot里可以用md命令查看内存内容用mm命令修改内存。调试内核启动参数时可以先在U-Boot里手动设置bootargs启动成功后再写回环境变量。这样避免反复烧录节省大量时间。