Buildroot与Qt5的X11VNC集成：解决EGLFS与XCB插件冲突的实践指南

1. 为什么需要X11VNC与Qt5集成？

在嵌入式开发中，远程调试图形界面是个常见需求。想象一下，你的设备可能放在工厂车间或者户外，每次修改代码后都要跑到设备前查看效果，这效率实在太低。X11VNC就像给你的设备装了个"远程显示器"，让你能在办公室电脑上直接操作和调试。

Qt5默认使用EGLFS插件（Embedded GL Full Screen），这是为嵌入式设备优化的显示后端。但问题来了：EGLFS直接操作GPU帧缓冲区，而X11VNC需要X11协议支持，两者就像说不同语言的人，根本没法直接沟通。这就是为什么我们常遇到黑屏、连接失败等问题。

我最近在RK3568平台上就踩过这个坑。编译出来的Qt程序默认用EGLFS，结果VNC连接后只能看到黑屏。折腾半天才发现，必须切换到XCB插件（X Protocol C Binding），它就像是X11和Qt之间的翻译官。

2. 环境准备与基础配置

2.1 Buildroot配置调整

首先得让Buildroot编译出我们需要的组件。就像搭积木，少一块都不行。这是我的配置清单：

# 基础X11环境 BR2_PACKAGE_XORG7=y BR2_PACKAGE_XSERVER_XORG_SERVER=y # 输入设备驱动 BR2_PACKAGE_XDRIVER_XF86_INPUT_KEYBOARD=y BR2_PACKAGE_XDRIVER_XF86_INPUT_MOUSE=y # 视频驱动（特别注意这个） BR2_PACKAGE_XDRIVER_XF86_VIDEO_FBDEV=y # 基础X11应用（用于测试） BR2_PACKAGE_XTERM=y BR2_PACKAGE_XAPP_XINIT=y

为什么要装这些？XORG7是X11的基础包，就像房子的地基。XSERVER是X11的服务端，没有它VNC连不上。FBDEV驱动特别重要，它让X11能使用帧缓冲区（framebuffer），相当于给X11和硬件显示之间搭了座桥。

2.2 Qt5编译选项

接下来是重头戏——Qt5的配置。在Buildroot的Qt5配置菜单里，找到这两个关键选项：

Qt5 graphical backend → xcb Qt5 EGLFS support → 不选

这步操作相当于告诉Qt："别用EGLFS了，改用XCB"。编译完成后，检查output/target/usr/lib/qt/plugins/platforms目录，应该能看到libqxcb.so文件。如果没有它，X11VNC就像没有钥匙的门，怎么也打不开。

3. 解决EGLFS与XCB的冲突

3.1 插件加载机制

Qt的插件系统很有意思，它会在运行时自动选择可用的显示插件。默认情况下，EGLFS的优先级比XCB高。这就好比有两个翻译员，EGLFS总是抢着说话，但我们实际需要的是XCB。

解决方法是在运行程序时显式指定平台：

./your_qt_app -platform xcb

我在RK3568上测试时发现，如果不加这个参数，即使编译了XCB插件，程序还是会偷偷用EGLFS，导致VNC连接失败。

3.2 常见问题排查

遇到过最头疼的问题是：明明配置都对，但VNC连接后鼠标键盘没反应。后来发现是缺少输入设备配置。在X11的配置文件中（通常是/etc/X11/xorg.conf）加入：

Section "InputDevice" Identifier "keyboard" Driver "kbd" EndSection Section "InputDevice" Identifier "mouse" Driver "mouse" Option "Protocol" "auto" Option "Device" "/dev/input/mice" EndSection

另一个坑是分辨率问题。建议在启动X11时指定分辨率：

startx -- -screen 0 1024x768x24

4. X11VNC的配置与优化

4.1 基础启动命令

X11VNC的启动命令看似简单，但参数配置很关键：

x11vnc -display :0 -forever -shared -repeat -noxdamage -nocursor -bg

解释几个重要参数：

• -forever：保持连接，不会自动退出
• -shared：允许多个VNC客户端同时连接
• -noxdamage：禁用X DAMAGE扩展，避免某些显卡兼容性问题
• -nocursor：隐藏本地鼠标光标，避免重影

4.2 性能优化技巧

在嵌入式设备上，VNC可能会卡顿。我试过这些优化方法：

1. 降低色深：使用-bgr233代替默认的24位色

   x11vnc -bgr233 -fast

2. 启用压缩：

   x11vnc -zlib -quality 5

3. 调整更新频率：

   x11vnc -wait 50 -defer 100

实测下来，-fast参数效果最明显，它能跳过某些检测步骤，直接进入数据传输。

5. 完整工作流程示例

5.1 启动顺序

正确的启动顺序很重要，就像先点火再踩油门：

1. 先启动X服务器：

   startx &

2. 启动Qt应用（注意放后台运行）：

   ./my_qt_app -platform xcb &

3. 最后启动X11VNC：

   x11vnc -display :0 -forever -shared -bg

5.2 自动化脚本

我习惯写个启动脚本start_vnc.sh：

#!/bin/sh export DISPLAY=:0 startx & sleep 3 # 等X服务器启动 ./my_qt_app -platform xcb & x11vnc -display :0 -forever -shared -passwd mypassword -bg echo "VNC running on port 5900, password: mypassword"

记得给执行权限：

chmod +x start_vnc.sh

6. 实际项目中的经验分享

在RK3568项目上，我们遇到了一个奇怪现象：VNC连接后画面是静止的。后来发现是Qt的渲染线程和X11的刷新不同步。解决方法是在Qt代码中加入：

QApplication::setAttribute(Qt::AA_X11InitThreads);

还有个坑是关于多屏显示的。如果设备有多个显示接口，需要明确指定显示设备：

export QT_QPA_EGLFS_FB=/dev/fb0

最后提醒一点：Buildroot的版本很重要。我们最初用2019.02版本遇到各种奇怪问题，升级到2022.02后很多问题自动消失了。