4. Qt EGLFS后端：EGLFS插件架构、KMS/DRM后端、eglfs_kms集成

EGLFS（EGL Full Screen）是Qt在嵌入式与显示驱动调试场景中最核心的平台后端之一。它绕过传统窗口系统（如X11/Wayland），直接通过EGL与底层显示硬件交互，为显示适配与性能调优提供了极低延迟的渲染路径。本章深入剖析EGLFS的插件化架构、KMS/DRM后端的核心机制，以及eglfs_kms集成的关键实现。

4.1 EGLFS插件架构

EGLFS采用插件化设计，通过动态加载不同的后端插件来适配多种显示硬件与图形栈。这种架构使得Qt可以在不修改核心代码的情况下，灵活支持DRM、X11、Wayland、Broadcom（树莓派）等底层接口。

4.2 KMS/DRM后端

KMS（Kernel Mode Setting）与DRM（Direct Rendering Manager）是Linux内核中负责显示输出与GPU内存管理的核心子系统。EGLFS的KMS后端直接操作DRM接口，实现无窗口系统的全屏渲染。

4.2.1 核心概念与数据结构

4.2.2 KMS/DRM初始化流程

1. 打开DRM设备：open("/dev/dri/card0", O_RDWR)，获取文件描述符。
2. 获取资源：调用 drmModeGetResources() 枚举CRTC、Encoder、Connector。
3. 选择Connector：遍历Connector，找到 connected == DRM_MODE_CONNECTED 且有效的显示接口。
4. 匹配Encoder与CRTC：根据Connector的encoder_id找到可用的CRTC。
5. 创建Framebuffer：通过 drmModeAddFB() 或 GEM API 分配显存并绑定。
6. 设置Mode：drmModeSetCrtc() 将CRTC与FB、Mode绑定，启动显示输出。
7. Page Flip：使用 drmModePageFlip() 实现无撕裂的双缓冲切换。

4.3 eglfs_kms集成

eglfs_kms 是Qt官方提供的KMS/DRM后端插件，它将EGL渲染与DRM页面翻转深度集成，是嵌入式显示适配的首选方案。

4.3.1 集成架构

4.3.2 关键类与职责

4.3.3 页面翻转（Page Flip）机制

eglfs_kms 使用 双缓冲 + VBlank同步 的页面翻转模式，确保渲染不撕裂：

// 伪代码：eglfs_kms 页面翻转流程
void QEglFSKmsWindow::present() {
    // 1. EGL渲染完成，调用 eglSwapBuffers()
    eglSwapBuffers(eglDisplay, eglSurface);

    // 2. 获取新渲染的FB ID (通过GBM或Dumb Buffer)
    uint32_t newFbId = gbm_bo_get_fd(gbmBuffer);

    // 3. 发起DRM页面翻转
    drmModePageFlip(drmFd, crtcId, newFbId,
                    DRM_MODE_PAGE_FLIP_EVENT, this);

    // 4. 等待VBlank事件回调
    // 在drmEventHandler中处理翻转完成信号
}

// VBlank事件回调
void flipHandler(int fd, unsigned int sequence,
                 unsigned int tv_sec, unsigned int tv_usec,
                 void *user_data) {
    QEglFSKmsWindow *win = static_cast<QEglFSKmsWindow*>(user_data);
    win->frameSwapped(); // 通知Qt渲染循环继续
}

4.3.4 环境变量与调试开关

4.4 多屏幕与热插拔支持

eglfs_kms 支持多显示器配置，通过 QEglFSKmsScreen 管理多个CRTC/Connector对。每个屏幕独立维护自己的渲染上下文与翻转队列。

• 屏幕枚举：启动时遍历所有 drmModeConnector，为每个已连接的显示器创建 QEglFSKmsScreen 实例。
• 热插拔：通过 drmSetClientCap(DRM_CLIENT_CAP_UNIVERSAL_PLANES, 1) 监听 DRM_EVENT_CONNECT 事件，动态添加/移除屏幕。
• 光标叠加：使用硬件Plane实现光标，避免软件合成带来的性能开销。