1. 为什么你需要自己编译Pluto固件?
如果你手上有一台ADI的PlutoSDR,并且已经按照官方Wiki或者一些入门教程,成功地在电脑上交叉编译了一个简单的“Hello World”程序,然后通过scp拷贝到Pluto上运行,那你可能会觉得,开发环境这不就搞定了吗?一开始我也是这么想的,觉得万事大吉。但很快,现实就给了我几个“耳光”。
第一个问题是,你编译的那个简单程序,很可能只链接了最基础的C库。一旦你想写个稍微复杂点的程序,比如想用Pluto的IIO库(libiio)去控制射频前端,或者想用一些数学库(libm)做信号处理,编译时就会疯狂报错,告诉你找不到头文件,或者链接时找不到库文件。这是因为你从官网下载的,或者别人预编译好的那个“SYSROOT”环境,它可能只包含了最基本的运行库,很多开发库是不全的。这就好比你想在家里做一顿大餐,但厨房里只有盐和酱油,连口锅都没有,这饭根本做不了。
第二个问题更烦人,那就是“掉电即失”。你辛辛苦苦编译好的程序,通过scp传到Pluto的/root目录下,运行得好好的。但只要Pluto一重启,这个程序就消失了。因为Pluto的根文件系统默认是只读的,或者每次启动都会从固件里重新解压一个干净的根文件系统出来。你传上去的文件,实际上只是保存在了内存里的一个临时文件系统(tmpfs)中。这就像你在沙滩上写字,海浪(重启)一来,就什么都没了。
所以,要想真正玩转Pluto,让它能稳定、持久地运行你自己写的复杂程序,最根本的解决方案就是:自己动手,编译一个属于你自己的、定制化的Pluto固件。编译固件不仅能让你获得一个完整的、包含所有开发库的SYSROOT环境(解决第一个问题),还能通过修改根文件系统,让你的程序在开机时自动运行,甚至直接“烧”进固件里(解决第二个问题)。这个过程听起来有点硬核,但别怕,我花了差不多一周时间,踩遍了能踩的坑,把这条路上的荆棘都给你捋平了。跟着我的步骤走,从Ubuntu系统选择到最终拿到SYSROOT,保证你能走通。
2. 战前准备:选择一个“正确”的Ubuntu系统
几乎所有嵌入式Linux开发教程的开头都会告诉你:“请在Ubuntu系统下进行”。但Ubuntu版本那么多,用哪个?这里就是第一个,也是最重要的一个坑。我强烈建议你,不要用最新版本,比如Ubuntu 22.04或者24.04。也别用原作者提到的20.04。我的血泪教训是:请直接使用Ubuntu 18.04 LTS。
为什么是18.04?关键就在于一个叫做libssl1.0-dev的依赖包。Pluto固件编译工具链(特别是其中老版本的buildroot)在构建过程中,会依赖这个特定版本的SSL开发库。在Ubuntu 20.04及以后的版本中,官方软件仓库已经移除了libssl1.0-dev,只提供libssl1.1-dev或更新版本。你强行安装会报错,找不到这个包。虽然网上有一些教你添加旧版本仓库的复杂方法,但极易引发其他依赖冲突,得不偿失。
而Ubuntu 18.04 LTS的官方仓库里,完美地包含了libssl1.0-dev。这就为我们扫清了第一个,也是最顽固的一个障碍。你可能会担心18.04是不是太老了?完全不用担心。对于这种针对特定硬件(Pluto用的Zynq芯片)的固件编译,稳定、可复现的环境比追求新特性重要一万倍。我们所有的工具链版本都是锁死的,跟宿主系统的新旧关系不大。
具体操作建议:
- 全新安装:在你的物理机或虚拟机(VMware/VirtualBox)上,安装一个干净的Ubuntu 18.04.6 LTS Desktop版本。分配至少100GB的硬盘空间(因为后续Vivado很大),内存建议8GB以上。
- 更新源:安装完成后,第一件事就是更新软件包列表,但不要执行全面的版本升级(即不要
sudo apt upgrade到新系统)。我们只需要更新现有18.04的软件包信息即可。sudo apt update - 配置终端:确保你有一个好用的终端,后续几乎所有操作都在这里完成。
把基础系统选对,相当于盖房子打好了地基,后面才能省心。我一开始头铁用了20.04,在这个libssl1.0-dev问题上折腾了大半天,最后乖乖重装了18.04,一分钟就装好了这个包,那种感觉真是又好气又好笑。
3. 安装依赖:一条命令搞定基础环境
系统准备好了,接下来就是安装编译所需的各种工具和库。这一步相对简单,但命令有点长。我把所有需要的包都整合在了一条命令里,你直接复制粘贴运行就行。这些包包括了编译器、构建工具、设备树处理工具、U-Boot工具以及一些必要的库文件。
打开你的终端,执行以下命令:
sudo apt-get install -y git build-essential ccache device-tree-compiler dfu-util fakeroot help2man libncurses5-dev libssl1.0-dev mtools rsync u-boot-tools bc python cpio zip unzip file wget libmpc-dev libgmp-dev flex bison
逐项解释一下,让你知道这些包都是干嘛的,心里有数:
git:版本控制工具,用来下载源代码。build-essential,ccache:C/C++编译的基础套件和编译缓存工具(加速后续编译)。device-tree-compiler:编译设备树源文件(.dts)为二进制文件(.dtb),Pluto启动必须。dfu-util:通过USB DFU模式给Pluto刷机的工具。fakeroot:模拟root权限进行打包等操作。libncurses5-dev,libssl1.0-dev:编译配置菜单(如make menuconfig)和SSL功能所需的开发库。u-boot-tools:处理U-Boot引导程序镜像的工具。bc,python:构建脚本中需要的计算器和脚本语言。cpio,zip, unzip:处理压缩包和文件系统镜像。libmpc-dev,libgmp-dev,flex,bison:编译GCC交叉工具链时需要的数学库和语法分析器。
运行这条命令后,系统会自动下载并安装所有这些包。如果一切顺利,你的基础开发环境就配置完成了。这个过程通常很快,取决于你的网速。
4. 获取源代码:如何优雅地“克隆”这个巨无霸项目
代码仓库在ADI的GitHub上:https://github.com/analogdevicesinc/plutosdr-fw。如果你直接使用git clone --recursive命令,理论上可以一次性下载主项目和所有子模块。但我强烈不推荐你这么做,尤其是国内网络环境。
这个项目包含了buildroot、hdl(硬件描述)、linux内核、u-boot-xlnx等好几个子模块,每个子模块本身都是一个庞大的项目。使用递归克隆,一旦某个子模块下载因网络波动中断,整个克隆过程就会失败,而且没有断点续传,之前下好的也白费了,非常浪费时间。
我推荐的方法是分步克隆,稳扎稳打:
-
克隆主仓库:
git clone https://github.com/analogdevicesinc/plutosdr-fw.git cd plutosdr-fw这一步通常很快,因为主仓库本身不大。
-
逐个克隆子模块:进入
plutosdr-fw目录后,分别克隆各个必须的子模块。它们的名字和仓库地址是固定的:git clone https://github.com/analogdevicesinc/buildroot git clone https://github.com/analogdevicesinc/hdl git clone https://github.com/analogdevicesinc/linux git clone https://github.com/analogdevicesinc/u-boot-xlnx请你务必一个一个执行,等上一个完全下载完成后再进行下一个。这样即使某个模块下载失败,也只会影响它自己,重试这个单独的模块即可。
版本选择的艺术:下载完代码,别急着编译。开源项目最大的挑战就是版本兼容性。你直接git clone下来的是最新的master分支代码(可能是v0.39)。但最新的代码往往依赖最新的工具(如Vivado 2023.2),而且编译脚本可能有变动。我参考的中文教程是基于v0.38固件和Vivado 2022.2的。为了最大限度地复现成功,减少未知错误,我决定将代码切换到与教程一致的v0.38版本。
但这不仅仅是切换主仓库的标签那么简单。你需要将每一个子模块都切换到与v0.38固件发布时相对应的那个提交(commit)上。具体怎么做呢?
- 在GitHub上打开
plutosdr-fw仓库,点击右上角的“commits”链接,查看提交历史。 - 在历史记录中,寻找描述类似“PlutoSDR: Prepare for v0.38 release”的提交。点进去,记下这个提交的哈希值(一长串字母数字,比如
0359a0b)。 - 同样在这个提交的页面上,往下翻,你会看到这次提交也更新了各个子模块的指针。页面上会显示类似
buildroot: update to commit xxxxxxx的信息。把每个子模块对应的这个哈希值也记下来。 - 回到你的终端,在
plutosdr-fw目录下,执行:git checkout 0359a0b # 替换成你找到的主仓库哈希值 - 然后,分别进入每个子模块目录,执行
git checkout切换到对应的哈希值。
这样,你就得到了一个完全匹配v0.38固件发布时刻的、所有组件版本一致的源代码树。这是成功编译的关键一步。cd buildroot && git checkout xxxxxxx && cd .. cd hdl && git checkout yyyyyyy && cd .. cd linux && git checkout zzzzzzz && cd .. cd u-boot-xlnx && git checkout aaaaaaa && cd ..
5. 安装Vivado:与版本号斗智斗勇
Pluto的硬件核心是Xilinx(现在叫AMD)的Zynq芯片。编译它的FPGA比特流和第一阶段引导程序(FSBL)需要用到Xilinx的Vivado设计套件。这是一个体积庞大(动辄几十GB)、安装过程复杂的商业软件,好在对于Pluto,我们可以使用免费的WebPACK版本。
第一步:注册与下载 你需要去AMD/Xilinx官网注册一个账号。然后找到下载页面。这里坑就来了:官网的页面布局和软件命名经常变化!我写这篇文章的时候,首页可能推的是“Vitis™ Core Development Kit 2024.2”。但我们要找的是 Vivado Design Suite - HLx Editions - 2022.2。
不要被“Vitis”这个名字迷惑,Vitis是新的统一开发平台,包含了Vivado。但我们只需要Vivado部分。在下载页面,通常会有个“Archived Versions”或“Older Version”的链接,点进去才能找到2022.2。找到后,选择 Linux Self Extracting Web Installer 进行下载。这个安装器很小(只有几十MB),它会在安装过程中下载所需的组件。
第二步:安装与组件选择 给下载的安装文件添加执行权限并运行:
chmod +x Xilinx_Unified_2022.2_1014_8888_Lin64.bin
./Xilinx_Unified_2022.2_1014_8888_Lin64.bin
会启动图形化安装界面。安装路径建议就用默认的/opt/Xilinx。在组件选择页面,务必精打细算:
- 勾选 Vivado。
- 在Vivado的子项里,只勾选 Design Tools -> Vivado Design Suite -> Vivado。
- 在器件支持里,只勾选 SoC -> Zynq-7000(Pluto使用的是Zynq 7010)。
- 其他所有东西,比如Vitis HLS、SDK、DocNav等等,全部取消勾选。
即使这样精简,安装完成后也会占用大约80GB的磁盘空间。如果全选,轻松突破100GB。安装过程需要持续联网,耗时较长,请保持网络稳定。
6. 配置环境变量与首次编译
安装好Vivado后,我们需要告诉系统交叉编译工具链在哪里。这里的环境变量配置很重要。
打开你的终端,最好将这些配置写入你的shell配置文件(如~/.bashrc),这样每次打开终端都自动生效。使用文本编辑器打开~/.bashrc文件,在末尾添加以下几行:
export CROSS_COMPILE=arm-linux-gnueabihf-
export PATH=$PATH:/opt/Xilinx/Vitis/2022.2/gnu/aarch32/lin/gcc-arm-linux-gnueabi/bin
export VIVADO_SETTINGS=/opt/Xilinx/Vivado/2022.2/settings64.sh
CROSS_COMPILE:定义了交叉编译工具的前缀。PATH:将Xilinx提供的ARM GCC工具链路径添加到系统路径中。VIVADO_SETTINGS:指向Vivado的环境设置脚本。
保存文件后,执行source ~/.bashrc让配置立即生效。然后,你可以验证一下工具链是否可用:
arm-linux-gnueabihf-gcc --version
如果能看到GCC的版本信息,说明工具链路径设置正确。
激动人心的编译时刻: 现在,进入你的plutosdr-fw源代码目录,执行一个简单的命令:
make
是的,就这么简单。make命令会读取目录下的Makefile,开始整个构建过程。这个过程会做以下几件事:
- 检查环境。
- 下载构建
buildroot系统所需的众多软件包(如busybox、各种lib库等)。这是最耗时且最依赖网络的部分。 - 使用Vivado生成FPGA比特流。
- 编译Linux内核和U-Boot。
- 将所有组件打包成最终的固件镜像。
关于网络和GCC版本的坑: 在make的过程中,你会看到脚本自动去下载一个linaro的交叉编译工具链。这正是我前面提到的,v0.38版本后,官方推荐使用Linaro的GCC而非Xilinx自带的。脚本已经帮你处理好了,不用担心版本冲突。
最大的挑战是网络。由于需要从国外服务器下载大量软件包(包括ad936x_ref_cal这个校准数据),很容易失败。我的经验是:
- 耐心重试:如果
make中途失败,通常再次运行make即可,它会继续之前未完成的工作。 - 选择网络好的时间:我个人发现,在清晨或者使用手机热点(非公司/校园网)时,成功率会高很多。
- 善用缓存:
buildroot会自动在dl/目录下缓存下载好的包,下次编译时无需重新下载。
编译过程视电脑性能和网络情况,可能需要数小时。当你在终端最后看到类似“Build completed successfully!”的字样时,恭喜你,最艰难的部分已经过去了!
7. 收获果实:获取SYSROOT与固件镜像
编译成功之后,我们来看看成果在哪里。在plutosdr-fw目录下,会生成一个build子目录。里面就是我们梦寐以求的东西。
获取完整的SYSROOT: 这是我们最初的主要目标之一。编译生成的、包含所有头文件和库的完整SYSROOT环境位于:
plutosdr-fw/buildroot/output/staging/
你可以把这个staging目录整个拷贝出来,或者将其路径作为你交叉编译器的--sysroot参数。现在,你就可以用这个环境编译任何调用Pluto系统库(如libiio, libad9361-iio)的复杂程序了,再也不会出现找不到头文件或库的链接错误。
生成的固件文件: 在build目录下,你会找到几个关键文件:
pluto.frm:这是官方刷机工具(dfu-util)使用的固件包。pluto.dfu:DFU格式的固件文件。boot.bin:包含FSBL、比特流和U-Boot的启动镜像。uImage:Linux内核镜像。devicetree.dtb:设备树二进制文件。rootfs.cpio.gz:根文件系统。
如果你想刷机,可以使用sudo dfu-util -D pluto.frm -a firmware.dfu命令(Pluto需进入DFU模式)。如果你想制作SD卡启动盘(一些国产兼容Pluto的方案),需要将这些文件按特定格式放置到SD卡上。不过,官方的plutosdr-fw默认的make并不直接生成SD卡镜像。你需要根据build目录下的文件,参考其他教程手动制作。
8. 进阶与排错:你可能遇到的问题
即使按照上述步骤,你也可能会遇到一些奇怪的问题。这里分享几个我踩过的坑和解决办法:
1. 编译过程中“下载失败” 这是最常见的问题。症状是make停在某个软件包下载处很久,最后报错。除了换网络、换时间重试外,你可以:
- 手动下载:查看
buildroot/package/下对应软件包的.mk文件,里面通常有SITE变量指明了下载地址。尝试用浏览器或wget手动下载,放到dl/目录下,再重新make。 - 使用代理:如果你有更稳定的网络访问方式,可以配置
git和wget使用代理。
2. Vivado许可证问题 第一次运行Vivado或编译过程中,可能会弹出许可证管理界面。对于Zynq-7000系列,WebPACK版本是免费的,但依然需要获取一个免费的许可证文件。按照界面指引,用官网账号登录并生成许可证,然后加载即可。
3. 硬盘空间不足 编译过程中,build目录和Vivado的临时文件会占用大量空间。确保你的虚拟机或硬盘分区有至少150GB的可用空间。如果空间不够,编译会中途失败。
4. 内存不足 在编译Linux内核或大型库时,如果内存不足(尤其是虚拟机分配内存较少),可能会被系统杀死进程(OOM Killer)。表现为编译突然中断。建议给虚拟机分配4GB以上内存,如果物理机编译,8GB或更多会更顺畅。
5. 版本不匹配的终极解法 如果你无论如何都编译不过,并且错误信息指向某个特定的组件(比如某个内核模块与内核版本不兼容),那很可能还是版本问题。这时,可以尝试去buildroot/package/目录下,找到对应软件包的.mk文件,将其版本号回退到更早的、已知稳定的版本。这需要一些经验和对错误日志的分析能力。
自己编译Pluto固件的过程,就像完成一个精密的拼图。每一步都需要严丝合缝,任何一个环节的版本错位都可能导致全盘失败。但一旦你成功完成第一次编译,那种对整个系统了然于胸的掌控感,是直接用现成固件无法比拟的。你不仅得到了一个强大的SYSROOT,更重要的是,你打通了从源代码到硬件运行的完整路径。以后你想修改内核参数、添加自定义驱动、或者预装自己的软件,都变得轻而易举。这,才是开源硬件真正的乐趣所在。
516



被折叠的 条评论
为什么被折叠?



