1. 项目缘起为什么要在reTerminal上折腾Buildroot如果你手头有一块reTerminal大概率是看中了它那块5英寸的电容触摸屏、丰富的接口HDMI、USB、GPIO以及内置的树莓派CM4计算模块。官方默认提供的Raspberry Pi OS镜像开箱即用确实方便。但用久了尤其是在一些对系统体积、启动速度、资源占用有严格要求的嵌入式或工业边缘计算场景里你可能会觉得它有点“胖”和“慢”。这就是我决定在reTerminal上从头构建一个基于Buildroot的定制化Linux系统的原因。Buildroot不是一个发行版而是一个构建系统它通过交叉编译帮你生成一个完整的、高度定制化的嵌入式Linux系统包括引导程序、内核、根文件系统以及你指定的应用集合。整个过程就像是在为你的硬件量身定做一件“紧身衣”去掉所有冗余只保留必需的组件。对于reTerminal这样的设备使用Buildroot意味着你可以极致精简最终的系统镜像可能只有几十到几百MB远小于动辄几个GB的桌面级系统。快速启动从按下电源到应用就绪时间可以压缩到10秒以内这对于需要快速响应的设备至关重要。完全掌控你可以精确控制内核版本、驱动、库版本以及预装软件避免不必要的后台服务系统行为完全可预测。资源高效极低的内存和CPU占用让更多资源留给你的核心应用。听起来很美好但这个过程绝非一帆风顺。reTerminal的硬件组合CM4 定制底板带来了一些特有的挑战官方文档对此着墨不多。接下来我将分享从零开始为reTerminal构建一个精简、可用的Buildroot系统的完整过程、踩过的坑以及最终验证的方案。2. 环境搭建与Buildroot基础配置工欲善其事必先利其器。构建过程主要在x86_64的Linux开发机Ubuntu 22.04上完成通过交叉编译为ARM架构的CM4生成系统。2.1 获取与初始化Buildroot首先获取Buildroot的稳定版本。我选择了当时最新的LTS版本以获得较好的长期支持。# 下载Buildroot wget https://buildroot.org/downloads/buildroot-2024.02.tar.xz tar xf buildroot-2024.02.tar.xz cd buildroot-2024.02进入目录后最重要的一步是选择正确的默认配置作为起点。Buildroot为许多流行板卡提供了预置配置。树莓派CM4的核心部分与树莓派4B相同因此我们以raspberrypi4_defconfig为基础。# 使用树莓派4的默认配置 make raspberrypi4_defconfig执行这个命令后Buildroot会加载针对树莓派4优化过的默认配置包括正确的CPU架构ARM Cortex-A72、内核版本、驱动等。这是成功的第一步因为它确保了为CM4的SoCBroadcom BCM2711生成正确的二进制代码。2.2 核心配置调整适配reTerminal硬件特性运行make menuconfig进入配置界面这里才是定制化的核心。基于raspberrypi4_defconfig我们需要进行几项关键修改以适配reTerminal的独特硬件。1. 系统配置系统主机名可以设置为reterminal。Init系统对于嵌入式系统BusyBox init是更轻量、更直接的选择。Systemd功能强大但更重。我选择了BusyBox init以追求极简。/dev管理选择Dynamic using devtmpfs eudev。eudev是systemd-udev的独立版本能自动在/dev下创建设备节点这对于识别reTerminal的触摸屏、USB转串口等外设至关重要。2. 内核配置Buildroot会自动下载并构建Linux内核。关键是要确保内核包含了reTerminal底板所需的所有设备驱动。内核版本我选择了与树莓派官方内核保持一致的长期支持版本例如6.1.y。更高的版本可能带来新特性但对驱动的兼容性需要更多测试。内核配置无需手动执行make linux-menuconfig但我们需要通过Buildroot的配置来确保驱动被启用。这主要通过后续的“设备支持”包来实现。一个重要的经验是务必勾选BR2_LINUX_KERNEL_NEEDS_HOST_OPENSSL选项。这是因为树莓派的内核模块在构建时可能需要签名依赖主机上的OpenSSL库。如果缺少在构建内核模块时可能会失败。3. 目标包选择这是决定系统功能的关键。对于reTerminal的一个基础UI演示系统我选择了以下包基础工具busybox(已默认包含)、eudev。图形与显示mesa3d、mesa3d-headers提供开源OpenGL驱动。libdrm直接渲染管理器图形栈的基础。libinput处理输入设备如触摸屏的库。tslib用于校准和过滤触摸屏输入对于电容屏的精准触控很有帮助。weston我选择了Wayland合成器参考实现Weston作为显示服务器。它比完整的桌面环境如Xfce轻量得多更适合嵌入式场景。同时勾选weston的kiosk-shell选项它可以创建一个全屏、无边框的单一应用界面。应用qt5选择Qt5作为GUI应用框架。在配置中需要仔细选择模块。至少需要qt5base、qt5declarative(QML支持)、qt5quickcontrols2。为了节省空间可以去掉qt5script、qt5svg等不用的模块。特别注意必须勾选BR2_PACKAGE_QT5BASE_OPENGL_ES2因为树莓派的VideoCore GPU只支持OpenGL ES。一个简单的自制QML应用包后续会讲到如何创建。硬件相关raspberrypi-firmware提供GPU固件/opt/vc目录下的内容没有它硬件加速的图形将无法工作。rpi-userland提供访问GPU和某些硬件的用户态库如libbcm_host。linux-firmware包含无线网卡Wi-Fi/蓝牙的固件。reTerminal的CM4模块如果选配了无线功能就需要这个。4. 文件系统镜像格式为了便于在SD卡上使用我选择了ext4格式的根文件系统并勾选了tar归档格式方便在构建后查看内容。配置完成后保存退出。这些配置保存在.config文件中。一个良好的习惯是备份这个配置cp .config config_reterminal_qt_weston。3. 解决reTerminal特有硬件支持问题直接使用为树莓派4优化的配置大部分核心功能CPU、内存、标准USB都能工作但reTerminal的定制底板带来了三个关键挑战GPIO扩展芯片驱动、触摸屏驱动以及USB转串口控制台。3.1 GPIO扩展与FT4232H芯片驱动reTerminal通过一个FTDI FT4232H芯片扩展出了额外的串口和GPIO。在默认的树莓派内核中这个芯片的驱动通常已经包含ftdi_sio和usbserial模块但需要确保它们被正确编译并加载。在Buildroot中配置在make menuconfig的Target packages - Hardware handling - Hardware monitoring下确保libraspberrypi和相关的内核模块支持已启用。但更关键的是内核配置。更可靠的做法在内核构建后我们可以在输出目录手动检查并调整内核配置确保相关驱动为内置y而非模块m。可以创建一个内核配置片段文件如linux/linux-extras.configCONFIG_USB_SERIALy CONFIG_USB_SERIAL_FTDI_SIOy然后在Buildroot配置中指定这个额外的片段文件BR2_LINUX_KERNEL_CONFIG_FRAGMENT_FILESboard/reterminal/linux-extras.config。这样就能确保驱动直接编译进内核无需在根文件系统中额外放置模块文件。3.2 触摸屏驱动与校准reTerminal使用的5英寸电容屏其触控IC通常是Goodix GT911或类似的。在较新的Linux内核5.x以上中Goodix触摸屏驱动已经集成到主线的hid-multitouch驱动中或者有独立的goodix驱动。问题与排查系统启动后触摸屏可能无反应。首先通过cat /proc/bus/input/devices命令查看输入设备列表。如果触摸屏被识别你会看到类似Goodix Capacitive TouchScreen的设备。如果没看到可能是I2C通信问题。reTerminal的触摸屏通常通过I2C总线连接需要检查设备树Device Tree中是否正确启用了对应的I2C接口和触控设备节点。解决方案树莓派的内核使用设备树覆盖Device Tree Overlay来动态配置硬件。对于reTerminal我们需要确保加载了正确的覆盖文件。在Buildroot中这通过rpi-firmware包配置。我们需要在board/reterminal/目录下创建一个自定义的config.txt文件并在其中指定覆盖文件。一个关键步骤是启用I2C并指定触控屏的覆盖。例如在config.txt中添加# 启用I2C1GPIO2/3 dtparami2c_armon # 加载针对特定触控IC的覆盖文件名称需根据实际硬件确定 dtoverlaygoodix,interrupt25,reset24具体的GPIO引脚号interrupt,reset必须参考reTerminal的官方原理图或文档。将这些文件放入board/reterminal/目录并在Buildroot配置中通过BR2_ROOTFS_OVERLAY指定该目录使其覆盖到最终的根文件系统并确保config.txt被放置到启动分区/boot的正确位置。tslib校准即使驱动正常触摸坐标也可能不准。这就需要tslib。在Weston启动前需要设置环境变量来指定tslib为输入设备export TSLIB_TSDEVICE/dev/input/touchscreen0 export TSLIB_CALIBFILE/etc/pointercal export TSLIB_CONFFILE/etc/ts.conf export TSLIB_PLUGINDIR/usr/lib/ts然后运行ts_calibrate进行五点校准。校准后坐标信息会写入/etc/pointercal。为了让Weston使用校准后的数据需要在其配置文件中指定输入设备并使用libinput的校准矩阵功能或者通过一个包装脚本在启动Weston前设置LIBINPUT_CALIBRATION_MATRIX环境变量。3.3 系统控制台的重定向reTerminal的另一个特点是它的调试串口不是通过CM4本身的UARTGPIO14/15引出而是通过FT4232H芯片的其中一个串口通常标记为UART2实现的。这意味着如果你希望通过串口登录系统需要让内核控制台输出到这个USB串口上。内核引导参数配置在Buildroot的System configuration - Kernel bootloader中我们使用U-Boot。需要在U-Boot环境中或通过修改cmdline.txt来设置内核命令行参数。关键参数是consolettyUSB0,115200 consoletty1ttyUSB0就是FT4232H创建的USB串口设备。tty1是第一个虚拟终端在HDMI/屏幕上显示。这样内核日志和登录提示会同时输出到串口和屏幕。确保串口驱动就绪如前所述必须确保ftdi_sio驱动在内核启动早期就可用最好是内置否则在驱动加载前ttyUSB0不存在控制台无法重定向你会看到一片寂静的串口。这是最容易导致“启动后串口无任何输出”问题的原因。将驱动编译进内核y是解决此问题的最可靠方法。4. 构建、部署与系统优化完成所有配置后就可以开始构建了。这个过程耗时较长取决于网络速度和主机性能。# 开始构建使用4个并行任务加速 make -j4构建过程会依次下载所有选中的源码包、配置、交叉编译并最终生成系统镜像。如果一切顺利在output/images/目录下会找到sdcard.img可以直接用dd或Raspberry Pi Imager写入SD卡的完整镜像。rootfs.tar根文件系统的归档可用于检查内容。zImage内核镜像。*.dtb设备树二进制文件。4.1 首次启动与基础调试将镜像写入SD卡插入reTerminal连接USB转串口线到开发机使用串口终端工具如minicom或screen以115200波特率连接。上电后你应该能在串口看到U-Boot和内核的启动日志。常见启动问题排查无任何输出检查串口线连接、端口号ttyUSB0或ttyACM0和波特率。最可能的原因是内核控制台未正确重定向到USB串口回顾3.3节的配置。卡在U-Boot可能是config.txt或设备树文件有误导致内核无法加载。检查boot分区下的config.txt文件内容是否正确。内核Panic通常是根文件系统挂载失败。检查cmdline.txt中的root参数指定的设备是否正确例如root/dev/mmcblk0p2。启动后无法登录检查是否在Buildroot中设置了root密码或者是否允许了无密码登录。在System configuration - Root filesystem overlay中可以提前准备一个设置了密码的/etc/shadow文件。4.2 集成自定义应用与启动自动化我们的目标是启动后自动运行一个全屏的Qt应用。这需要几个步骤1. 创建自定义软件包在Buildroot的package/目录下创建一个新目录例如myapp/里面包含Config.in包的配置描述。myapp.mk包的构建规则指定源码位置可以是本地目录或Git仓库、构建方法通常使用qmake或CMake和安装步骤。你的应用源码或通过myapp.mk从指定位置下载。2. 编写应用启动脚本我们不希望启动完整的桌面环境。而是让Weston以kiosk模式启动并直接运行我们的Qt应用。可以创建一个System V init脚本或更简单的BusyBox init脚本/etc/init.d/S99myapp#!/bin/sh # 设置Qt和Wayland环境变量 export QT_QPA_PLATFORMwayland-egl export QT_WAYLAND_DISABLE_WINDOWDECORATION1 export XDG_RUNTIME_DIR/run/user/0 # 启动Weston指定kiosk-shell并以后台方式运行 weston --backenddrm-backend.so --shellkiosk-shell.so --log/var/log/weston.log # 等待Weston完全启动 sleep 3 # 启动我们的Qt应用 /myapp/bin/my_qt_application 记得给脚本加上执行权限chmod x /etc/init.d/S99myapp。在Buildroot中可以通过根文件系统覆盖BR2_ROOTFS_OVERLAY的方式提前将这个脚本放到镜像里。3. 禁用不必要的服务为了加快启动速度检查/etc/init.d/目录禁用所有不需要的服务如网络管理、蓝牙等除非你的应用需要。可以通过移除它们的执行权限或删除符号链接来实现。4.3 性能与尺寸优化构建完成后还可以进行深度优化清理构建目录运行make clean会删除所有构建产物但保留下载的源码和配置。make distclean会清理得更加彻底回到初始状态。在发布最终镜像前可以使用make source下载所有源码然后在一个干净的环境中构建避免残留中间文件。分析文件系统大小使用du -sh output/target/* | sort -h可以查看根文件系统中各个目录的大小找出可以进一步精简的“大户”例如文档、本地语言包、不必要的库文件等。使用BusyBox的AppletsBusyBox将许多常用工具集成到一个二进制文件中极大地节省了空间。在make busybox-menuconfig中可以进一步裁剪掉用不到的命令。内核裁剪对于最终产品可以运行make linux-menuconfig根据硬件实际情况移除所有用不到的驱动和内核特性如不需要的USB设备驱动、文件系统支持、网络协议等。这是一个精细活但能显著减小内核大小和内存占用。5. 实测效果与经验总结经过上述步骤我成功为reTerminal构建了一个基于Buildroot的系统。最终的镜像大小约为350MB其中内核和驱动模块占了一部分写入SD卡后首次启动从上电到Qt应用界面完全显示耗时约8秒。系统空闲时内存占用不到100MB触摸响应流畅。过程中几个关键的经验点设备树是硬件适配的灵魂对于reTerminal这类非标准底板设备树覆盖.dtbo文件的正确配置是驱动外设尤其是触摸屏、特殊GPIO的关键。务必仔细核对硬件原理图与内核文档中覆盖文件的参数。驱动内置优于模块对于系统启动所必需的基础驱动如USB串口驱动、I2C控制器驱动尽量编译进内核y而不是作为模块m。这能避免因模块加载顺序或依赖问题导致的启动失败尤其是在initramfs很小或没有的情况下。交叉编译工具链的版本一致性Buildroot自带工具链通常没问题。但如果需要额外编译第三方闭源库如某些图形SDK务必使用Buildroot生成的工具链位于output/host/bin/并设置对应的sysroot避免库版本冲突。利用Overlay进行灵活定制BR2_ROOTFS_OVERLAY目录极其有用。你可以把定制化的配置文件如网络配置、启动脚本、应用二进制文件都放在这里它们会被直接复制到根文件系统无需修改Buildroot内部包的构建规则。串口是救命稻草在调试早期阶段确保串口控制台畅通无比重要。它不仅是观察启动过程的窗口也是系统无法正常启动时唯一的交互手段。在配置内核命令行时把consolettyUSB0放在前面是明智的。为reTerminal构建Buildroot系统是一个从通用硬件配置深入到特定硬件细节的过程。它需要你不仅理解Buildroot的构建流程还要对Linux内核、设备树、驱动模型以及目标硬件有清晰的认知。虽然过程充满挑战但最终获得一个完全受控、精简高效的系统对于嵌入式产品开发来说这种投入是非常值得的。当你看到自己定制的系统在硬件上快速启动并稳定运行时那种成就感是使用现成发行版无法比拟的。
