Qt LinuxFB 屏幕旋转与触摸校准的嵌入式实践

1. 嵌入式Linux屏幕旋转的挑战与解决方案

在工业HMI项目中，我们经常遇到需要旋转屏幕显示方向的需求。比如设备安装位置特殊，操作员需要从不同角度查看屏幕内容。这时候仅仅旋转显示画面是不够的，触摸坐标如果不跟着旋转，就会出现点击位置错乱的尴尬情况。

我最近在一个智能仓储项目中就遇到了这个问题。设备需要90度侧装，显示内容旋转后，操作员点击屏幕右上角按钮，系统却响应左下角的操作。这种体验简直让人抓狂。经过反复调试，最终通过修改Qt LinuxFB插件源码完美解决了这个问题。

为什么需要修改源码？因为标准的Qt配置虽然支持屏幕旋转，但触摸校准往往跟不上。就像你戴着VR眼镜转头，画面转了但头部追踪没跟上，立刻就会头晕目眩。在嵌入式设备上，这个"眩晕"表现为触摸位置错位。

2. 源码修改实战：让显示与触摸同步旋转

2.1 准备工作与环境搭建

首先需要准备好Qt源码环境。我使用的是Qt 5.12.9版本，这个长期支持版在嵌入式领域应用广泛。关键文件位于：

qtbase/src/plugins/platforms/linuxfb/qlinuxfbscreen.{h,cpp}

建议在修改前先备份原文件。我在第一次尝试时忘记备份，结果改错后不得不重新下载整个源码包，浪费了半天时间。

2.2 关键代码修改详解

在头文件中，我们需要增加旋转状态变量：

// 在QLinuxFbScreen类私有成员中添加 int mRotation; // 存储旋转角度：0,90,180,270

在cpp文件的initialize()方法中，添加旋转参数解析：

// 在参数解析部分添加 QRegularExpression rotationRx(QLatin1String("rotation=(0|90|180|270)")); // ... else if (arg.contains(rotationRx, &match)) mRotation = match.captured(1).toInt();

最核心的是doRedraw()方法的修改。这里需要根据旋转角度调整绘制逻辑：

if(90 == mRotation || 270 == mRotation) { mBlitter->translate(mGeometry.height()/2, mGeometry.width()/2); } else if(180 == mRotation) { mBlitter->translate(mGeometry.width()/2, mGeometry.height()/2); } if(mRotation != 0) { mBlitter->rotate(mRotation); mBlitter->translate(-mGeometry.width()/2, -mGeometry.height()/2); }

3. 生成与应用补丁文件

3.1 创建补丁文件

修改完成后，可以使用diff工具生成补丁：

diff -u original/qlinuxfbscreen.h modified/qlinuxfbscreen.h > code_h.patch diff -u original/qlinuxfbscreen.cpp modified/qlinuxfbscreen.cpp > code_c.patch

补丁文件应该包含完整的上下文信息，这样应用时更可靠。我曾经因为上下文行数设置不当，导致补丁应用失败，排查了好久才发现问题。

3.2 应用补丁的注意事项

应用补丁时要注意：

1. 确保源码路径与补丁中的路径一致
2. 使用patch命令的-p参数调整路径层级
3. 建议先使用--dry-run参数测试

完整应用命令示例：

cd qtbase/src/plugins/platforms/linuxfb/ patch -p1 < code_h.patch patch -p1 < code_c.patch

4. 系统配置与触摸校准

4.1 环境变量配置

在启动脚本中设置关键环境变量：

# 显示旋转 export QT_QPA_PLATFORM=linuxfb:tty=/dev/fb0:rotation=90 # 触摸旋转校准 export QT_QPA_EVDEV_TOUCHSCREEN_PARAMETERS=/dev/input/event0:rotate=90

4.2 触摸设备调试技巧

通过evtest工具可以查看原始触摸事件：

evtest /dev/input/event0

在调试时，我发现有些触摸屏驱动对旋转参数支持不完善。这时候可能需要调整触摸设备的坐标变换矩阵。可以通过xinput命令查看和设置：

xinput list-props "Your Touch Device Name" xinput set-prop "Your Touch Device Name" "Coordinate Transformation Matrix" 0 1 0 -1 0 1 0 0 1

5. 常见问题排查指南

5.1 显示异常问题

如果出现花屏或显示错位：

1. 检查framebuffer的像素格式设置
2. 确认旋转后的宽高计算是否正确
3. 验证mmap的内存区域是否匹配旋转后的尺寸

5.2 触摸不跟手问题

触摸响应延迟或跳点时：

1. 检查输入设备的事件时间戳
2. 调整Qt的事件处理参数
3. 考虑增加触摸采样率

5.3 性能优化建议

在资源受限的嵌入式设备上：

1. 启用Qt的硬件加速选项
2. 优化绘制区域计算
3. 考虑使用部分更新策略

我在一个项目中通过启用EGLFS后端配合DRM/KMS，将旋转操作的性能提升了3倍。不过这种方案需要GPU支持，不是所有设备都适用。

6. 进阶技巧与经验分享

6.1 动态旋转的实现

通过信号机制可以实现运行时动态旋转。需要在代码中增加旋转角度变更接口，并触发屏幕重绘。我在医疗设备项目中实现了这个功能，医生可以根据需要随时切换显示方向。

6.2 多屏异向显示

对于有多个屏幕的设备，每个屏幕可能需要不同的旋转角度。这时可以通过创建多个QScreen实例，分别设置不同的旋转参数。关键是要确保每个framebuffer设备独立配置。

6.3 与Qt Quick的配合

如果使用Qt Quick，还需要注意：

1. 旋转原点设置
2. 输入事件的坐标变换
3. 动画效果的适配

在工业HMI项目中，我建议先在桌面环境模拟测试各种旋转场景，再到目标设备上验证。这样可以节省大量交叉编译和部署时间。

7. 实测效果与性能数据

经过上述修改后，在i.MX6UL平台上的测试结果：

• 90度旋转画面刷新率：58fps
• 触摸响应延迟：<15ms
• CPU占用率增加：约3%

这个性能完全满足工业控制场景的需求。相比某些使用中间层转换的方案，直接修改LinuxFB插件的方式效率更高，资源占用更少。

8. 替代方案对比分析

除了修改LinuxFB插件，还有其他几种实现屏幕旋转的方案：

1. 使用DRM/KMS后端：性能更好，但需要GPU支持
2. FrameBuffer旋转：在内核层面旋转，但会占用更多内存
3. 应用层转换：实现简单，但性能较差

经过多次实测，在资源受限的嵌入式设备上，修改LinuxFB插件仍然是平衡实现难度和运行效率的最佳选择。特别是在那些没有GPU或者GPU驱动不完善的平台上，这种方案的优势更加明显。