嵌入式Qt无桌面环境下如何实现屏幕旋转？

Question

在嵌入式Qt无桌面环境下，如何实现屏幕旋转（如90°、180°、270°）是一个常见挑战。由于缺乏窗口系统和显示管理器，无法依赖X11或Wayland等传统机制进行旋转配置。通常需从底层入手，结合帧缓冲（framebuffer）与Qt的渲染机制。常见问题是：即使通过`QT_QPA_EGLFS_ROTATION`环境变量设置旋转角度，画面仍显示异常或触摸坐标未同步。其根源在于图形驱动、输入设备校准与Qt平台插件之间的协同问题。例如，EGLFS插件虽支持旋转，但若GPU驱动不完整支持，或tslib未根据屏幕方向调整触控映射，则会导致图像错位或触摸偏移。如何在无桌面环境中统一协调显示输出与输入事件的旋转一致性，成为实际部署中的关键技术难点。

Answer 1

嵌入式Qt无桌面环境下屏幕旋转的深度实现与协同机制

1. 背景与挑战概述

在嵌入式系统中，Qt常以无桌面环境（如EGLFS平台插件）运行于Linux帧缓冲（framebuffer）之上。此类场景下，缺乏X11或Wayland等窗口管理器支持，导致传统显示旋转配置方式失效。开发者需直接干预底层图形栈与输入子系统。

常见现象包括：通过QT_QPA_EGLFS_ROTATION=90设置后图像部分旋转但UI错位、触摸坐标偏移严重、部分控件渲染异常等。这些问题并非孤立存在，而是涉及显示驱动、GPU加速、Qt渲染管线及触控校准的系统级耦合问题。

2. 基础实现路径：从环境变量到平台插件

Qt for Embedded Linux提供了eglfs平台插件，支持通过环境变量控制旋转：

export QT_QPA_PLATFORM=eglfs
export QT_QPA_EGLFS_ROTATION=90
./myqtapp

该设置会通知Qt在渲染前对整个场景进行几何变换。然而，这仅作用于Qt自身绘制内容，不保证底层帧缓冲或GPU输出真正旋转。

关键限制在于：若GPU驱动未启用硬件旋转或DRM/KMS未配置相应模式，实际显示可能仍为原始方向。

3. 深层架构分析：三层协同模型

实现完整旋转需协调以下三个层级：

层级	组件	职责	典型问题
显示层	Framebuffer / DRM-KMS / GPU Driver	物理像素输出方向	未支持旋转模式
渲染层	Qt EGLFS + OpenGL ES	UI内容旋转渲染	坐标系错乱
输入层	tslib / libinput / evdev	触摸坐标映射	触摸偏移/反转

4. 显示层旋转：内核与驱动级配置

对于使用标准帧缓冲的系统，可通过设备树（Device Tree）指定显示方向：

panel@0 {
        compatible = "your,panel";
        rotation = <1>; /* 0=0°, 1=90°, 2=180°, 3=270° */
    };

现代系统多采用DRM/KMS接口，可在用户空间通过modetest工具验证和设置：

modetest -M imx -s 32:1920x1080@ARGB8888@90

此命令强制将连接ID为32的显示器设置为90度旋转输出，依赖GPU驱动（如i.MX的imx-drm）支持。

5. 渲染层同步：Qt内部坐标系调整

当底层已正确旋转时，Qt仍需匹配其逻辑坐标系。除QT_QPA_EGLFS_ROTATION外，还可编程设置：

// main.cpp
QGuiApplication app(argc, argv);
app.setAttribute(Qt::AA_EnableHighDpiScaling);
qputenv("QT_QPA_EGLFS_ROTATION", "90"); // 或动态设置

注意：若同时启用QT_QPA_GENERIC_PLUGINS=evdevtouch，则必须确保输入设备独立校准。

6. 输入层校准：触摸坐标映射一致性

tslib是嵌入式Linux常用触控校准库。其配置文件ts.conf需加载正确模块链：

# ts.conf
module_raw input
module pthres pmin=1
module variance delta=30
module dejitter delta=100
module linear rotate=90  # 关键：与显示旋转一致

若使用evdevtouch插件，则需通过环境变量传递旋转参数：

export QT_QPA_EVDEV_TOUCHSCREEN_PARAMETERS="rotate=90;invertY=1"

7. 系统集成流程图

graph TD
            A[应用启动] --> B{检查旋转需求}
            B -->|是| C[设置QT_QPA_EGLFS_ROTATION]
            B -->|否| D[正常启动]
            C --> E[内核DRM/KMS设置旋转模式]
            E --> F[GPU驱动执行硬件旋转]
            F --> G[Qt EGLFS应用旋转渲染]
            G --> H[tslib或evdevtouch加载rotate参数]
            H --> I[触摸坐标映射调整]
            I --> J[UI与触摸完全同步]

8. 常见问题排查清单

• 画面旋转但触摸反向？→ 检查linear rotate=N或rotate=参数是否匹配
• 部分区域无法点击？→ 验证ts_calibrate生成的pointercal.xinput是否更新
• 文字模糊或拉伸？→ 确认 framebuffer resolution 与旋转后逻辑分辨率匹配
• EGL初始化失败？→ 检查GPU驱动是否支持旋转后的缓冲格式
• 旋转后黑屏？→ 使用fbgrab抓取帧缓冲确认数据是否已旋转
• 多屏场景混乱？→ 每个屏幕需独立配置rotation与input绑定
• Qt Quick Controls 2布局错乱？→ 启用QT_QUICK_CONTROLS_MOBILE主题适配
• 性能下降明显？→ 禁用软件旋转，优先使用GPU硬件旋转功能
• 横竖屏切换闪屏？→ 实现双缓冲或热重载机制避免重启应用
• 旋转角度不生效？→ 查看Qt日志：QT_LOGGING_RULES='qt.qpa.*=true'

9. 高级方案：运行时动态旋转支持

某些工业HMI需要运行时切换屏幕方向。可结合DBus信号触发以下操作序列：

void rotateScreen(int degree) {
        // 1. 通知KMS更改CRTC rotation property
        drmModeObjectSetProperty(fd, crtc_id, DRM_MODE_OBJECT_CRTC,
                                 DRM_MODE_PROP_ROTATION,
                                 (1U << (DRM_MODE_ROTATE_90 * (degree/90))));

        // 2. 重启Qt应用或发送自定义事件重置QWindowGeometry
        QProcess::execute("killall myqtapp && env QT_QPA_EGLFS_ROTATION=" +
                          QString::number(degree) + " ./myqtapp &");
    }

更优雅的方式是利用Qt的QScreen::orientationChanged()信号配合自定义PlatformIntegration。

10. 结论性思考：构建可维护的旋转框架

真正的解决方案不是单一配置项，而是建立“显示-渲染-输入”三位一体的旋转管理模块。建议封装为系统服务，统一管理旋转状态、持久化配置、自动重校准触摸，并提供API供HMI应用查询当前UI方向。

未来趋势是向libinput迁移，其原生支持坐标变换，减少对tslib的依赖；同时采用Wayland compositor轻量实现（如Weston），即使在“类无桌面”环境中也能获得更好的旋转管理能力。