【QT】深入QT_QPA_EGLFS_KMS_CONFIG：解析ARM32平台下DRM/KMS显示框架与QT透明渲染的底层关联

1. ARM32平台下QT透明渲染问题的本质

最近在RK3288芯片上折腾QT界面透明效果时，遇到了一个典型问题：明明设置了setAttribute(Qt::WA_TranslucentBackground)，窗口却始终显示为黑底。这个问题在ARM32平台上特别常见，尤其是使用QT5.9以上版本配合linuxfb插件时。经过三天三夜的源码追踪和实验，终于搞清了背后的技术链条。

问题的核心在于像素格式的匹配。当我们设置透明属性时，QT会尝试使用ARGB8888格式（带Alpha通道），但很多嵌入式设备的DRM驱动默认输出RGB565或XRGB8888格式。这就好比你想用透明玻璃杯装水，系统却给你换成了不透明的陶瓷杯——无论怎么设置透明度参数都无效。

关键点在于QT的渲染路径选择。即使使用linuxfb插件，当启用QT_QPA_FB_DRM=1时，QT会通过DRM/KMS框架与显示设备交互。这时实际生效的是DRM层的像素格式设置，而非应用层的透明参数。我在瑞芯微平台上实测发现，必须同时满足三个条件：

1. DRM驱动支持ARGB8888格式
2. QT正确识别显示接口
3. 通过KMS配置强制指定像素格式

2. DRM/KMS框架与QT的交互机制

2.1 Linux显示栈的底层架构

现代Linux图形栈就像多层蛋糕：

• 最底层是DRM（Direct Rendering Manager）：负责直接管理GPU和显示控制器
• 中间层是KMS（Kernel Mode Setting）：处理显示模式设置和帧缓冲切换
• 上层是QT的QPA插件：作为抽象层适配不同显示系统

当使用linuxfb插件时，传统做法是通过framebuffer设备直接写入像素数据。但启用DRM支持后，QT会绕过fbdev直接调用libdrm接口。这就解释了为什么QT_QPA_EGLFS_KMS_CONFIG这个本该属于eglfs的配置会对linuxfb生效。

2.2 像素格式的传递链条

透明渲染的关键在于Alpha通道的完整传递：

code复制QT应用层(setAttribute)
↓ 
QPA插件(linuxfb)
↓ 
DRM驱动(检查format)
↓ 
硬件显示控制器(实际输出)

如果其中任何一环丢失Alpha通道（比如DRM层配置为RGB565），透明效果就会失效。通过内核调试接口可以验证这一点：

bash复制# 查看当前连接的显示接口信息
cat /sys/kernel/debug/dri/0/connector/*/modes

3. 实战配置QT_QPA_EGLFS_KMS_CONFIG

3.1 配置文件详解

正确的JSON配置应该包含三个关键部分：

json复制{
  "device": "/dev/dri/card0",
  "outputs": [
    {
      "name": "DSI-1",
      "mode": "1024x600",
      "format": "ARGB8888"
    }
  ]
}

其中name参数最容易出错。在我的RK3399开发板上，通过以下命令找到正确的接口名：

bash复制grep -r "connected" /sys/kernel/debug/dri/*/status

3.2 常见配置误区

踩过的坑包括：

1. 使用错误的设备节点（card0 vs card1）
2. 接口名大小写不匹配（HDMI1 vs hdmi1）
3. 未关闭不需要的输出接口
4. 忘记设置hwcursor和pbuffers参数

一个完整的配置示例：

json复制{
  "device": "/dev/dri/card1",
  "hwcursor": false,
  "pbuffers": true,
  "outputs": [
    {
      "name": "HDMI-A-1",
      "mode": "off"
    },
    {
      "name": "DSI-1",
      "mode": "800x480",
      "format": "ARGB8888",
      "primary": true
    }
  ]
}

4. 深度调试技巧

4.1 内核级调试

当配置不生效时，可以检查DRM驱动的日志：

bash复制dmesg | grep -i drm

重点关注以下关键词：

• atomic_commit：模式设置是否成功
• format：实际使用的像素格式
• connector：接口连接状态

4.2 QT源码级验证

在QT源码中定位qkmsdevice.cpp文件，找到createScreenForConnector函数，添加调试打印：

cpp复制qDebug() << "Connector name:" << connector->connector_type;
qDebug() << "Supported formats:" << drmModeGetPlaneResources(device->fd());

重新编译QT后运行应用，可以在日志中看到实际识别的接口信息。

5. 跨平台兼容方案

针对不同ARM平台的特殊处理：

全志平台：

json复制{
  "name": "LCD-1",
  "format": "XR24"
}

i.MX6平台：

json复制{
  "name": "LVDS-1",
  "format": "AR24"
}

关键是要理解DRM FourCC格式编码：

• AR24 = ARGB8888
• XR24 = XRGB8888
• RG16 = RGB565

可以通过modetest工具验证硬件支持情况：

bash复制modetest -M rockchip | grep -A 10 "Formats:"

6. 性能优化建议

启用透明渲染后可能遇到性能问题，可以通过以下方式优化：

1. 减少重绘区域：

cpp复制// 在paintEvent中只更新需要透明的区域
void Widget::paintEvent(QPaintEvent *event) {
    QPainter painter(this);
    painter.setClipRect(event->rect());
    // ...
}

2. 启用硬件加速：

bash复制export QT_QPA_EGLFS_HIDECURSOR=1
export QT_QPA_EGLFS_FORCE888=1

3. 调整DRM原子模式：

json复制{
  "atomic": true,
  "pageflip": false
}

7. 疑难问题排查

遇到黑屏问题时，建议按以下步骤排查：

1. 确认DRM设备权限：

bash复制ls -l /dev/dri/card*

2. 检查当前显示模式：

bash复制cat /sys/class/graphics/fb0/mode

3. 验证QT实际使用的插件：

bash复制export QT_DEBUG_PLUGINS=1
./your_app 2>&1 | grep "Loading plugin"

4. 强制指定像素格式测试：

bash复制echo "format=ARGB8888" > /sys/class/graphics/fb0/device/video_mode

8. 进阶：多屏显示配置

对于多屏场景，需要特别注意z-order设置：

json复制{
  "outputs": [
    {
      "name": "HDMI-1",
      "mode": "1920x1080",
      "format": "XRGB8888",
      "zpos": 1
    },
    {
      "name": "DSI-1",
      "mode": "1024x768",
      "format": "ARGB8888",
      "zpos": 0
    }
  ]
}

可以通过以下命令验证图层叠加状态：

bash复制cat /sys/kernel/debug/dri/0/state