博文

MCGS 触摸屏 Qt 页面项目笔记

本文为项目实战笔记,已做脱敏:设备 IP、用户名、密码以及本机路径均以占位符呈现,仅保留可复用的方法与技术细节。截图状态栏中的设备标识与 IP 亦已替换。

MCGS 触摸屏 Qt 页面项目笔记

项目:在 MCGS 嵌入式触摸屏(<设备IP>)上从零创建并显示一个 1366×768 的 Qt 页面。

状态:已完成,页面已在设备屏幕正确显示,并配置开机自启。

设备屏幕最终显示(fb0 读回,已脱敏)

1. 项目目标与成果

项目内容
目标在触摸屏显示一个 1366×768 的 Qt 页面
实现从零编写 Qt 4.8.7 嵌入式程序(main.cpp,无 Q_OBJECT,无需 moc)
成果页面正确显示:标题栏+时钟、左侧导航(主控/数据/报警/设置)、三状态卡片、仪表盘、运行信息、状态栏
设备<用户名>@<设备IP>(密码 <密码>),MCGS 嵌入式触摸屏
运行/root/page_app(nohup 后台),开机自启已配置(/etc/init.d/S99mcgs_app)
源码<项目目录>/main.cpp、build.sh、page_app(ARM 二进制)

2. 硬件与系统环境

2.1 设备概览

  • 主机名:MCGS
  • 内核:Linux 4.9.191 aarch64(内核 64 位)
  • 用户态:32 位 ARM(ELF32/Machine: ARM,hard-float FPv8/NEON)
  • 系统:Buildroot 2018.02.4
  • glibc:2.26(/lib/ld-2.26.so、/lib/libc-2.26.so)
  • 内存:256M,/ 约 208M 可用,/ 为 overlay,/boot 为 vfat mmcblk0p1
  • 设备无编译工具(buildroot runtime 移除 dev 文件,无 crt 启动文件、无 libc.so 链接脚本)

2.2 显示与帧缓冲

  • fb0 / fb1:物理 1366×768(U:1366x768p-59),32bpp
  • 帧缓冲布局:1366×768×4 = 4196352 字节/页;虚拟区 1366×1536(约 8392704 字节)
  • 颜色格式:rgba 8/16,8/8,8/0,8/24(B 偏移 16、G 偏移 8、R 偏移 0、A 偏移 24),小端
  • 关键坑:fb 驱动不提供 smem_len(sysfs 无 smem_len 节点),导致 Qt 的 Linuxfb mmap 失败(详见下文)

2.3 Qt 运行时(设备 /usr/lib)

  • Qt 4.8.7 嵌入式 ARM(QWS),libQtCore.so.4.8.7、libQtGui.so.4.8.7
  • 依赖:libts.so.0.9.0(tslib 触摸)、libglib-2.0.so.0.5400.2、libgthread-2.0.so.0.5400.2、libpcre.so.1.2.9
  • 字体:/tmp/qtembedded-0/fonts/simsun_*.qsf(simsun 宋体)

2.4 QWS 显示环境(/etc/init.d/envs.d/*.env)

TSLIB_TSDEVICE=/dev/input/event0
QWS_MOUSE_PROTO="tslib:/dev/input/event0 intellimouse:/dev/input/mice"
MCGS_TRANSFORMED=Transformed:Rot180
QWS_DISPLAY="Multi:Transformed:Rot180:Linuxfb:/dev/fb0:depth=24 VNC:refreshrate=100:paintonscreen:size=<screen_size>:depth=24"
LD_LIBRARY_PATH=/usr/lib

MCGS 引擎由 /etc/init.d/S99mcgs_app 启动(load_environment 读取 envs.d,再 cd /root; ./demo_app -qws &)。

3. 交叉编译工具链

项值
工具链Bootlin armv7-eabihf--glibc--stable-2018.02-1
前缀arm-buildroot-linux-gnueabihf-(g++ / readelf)
gcc6.4.0
glibc2.26(与设备一致,保证二进制兼容)
下载https://toolchains.bootlin.com/downloads/releases/toolchains/armv7-eabihf/tarballs/armv7-eabihf--glibc--stable-2018.02-1.tar.bz2
解压需先 apt-get install -y bzip2(WSL),再 tar xjf
安装路径/opt/armv7-eabihf--glibc--stable-2018.02-1/

为什么用 Bootlin 6.4 而不是 Ubuntu gcc15:gcc15 链接的动态符号依赖 glibc 2.38+ 的 C23 符号(如 __isoc23_strtoul),设备 glibc 2.26 缺失,无法运行。Bootlin 6.4 + glibc 2.26 与设备完全匹配。

Qt4 头文件:来自 Ubuntu 16.04 libqt4-dev .deb(toolchain/qt4root/usr/include/qt4/),需编辑 qconfig.h:

  • 定义 QT_ARCH_ARM
  • 定义 QT_POINTER_SIZE 4

4. 关键技术难点与解决方案

4.1 不用 moc(无 Q_OBJECT)

设备 Qt 库无 moc 生成器,.deb 也不含 moc。避免 Q_OBJECT 和信号/槽宏:

  • 用 QWidget 虚函数:paintEvent / mousePressEvent / mouseReleaseEvent / timerEvent
  • 定时刷新用 startTimer(1000) + timerEvent(而非 QTimer 信号)
  • 绘制用 QPainter 直接画(无 QSS / 无 Q_OBJECT 属性)

4.2 必须动态链接 libstdc++

症状:加 -static-libstdc++ -static-libgcc 后,设备报 error while loading shared libraries: ./page_app: internal error。

原因:Bootlin 静态 libstdc++ 与设备 glibc 的 TLS/eh 不匹配。

解决:去掉 -static-libstdc++ -static-libgcc,动态链接 libstdc++(NEEDED 含 libstdc++.so.6、libgcc_s.so.1)。

4.3 QLinearGradient fillRect 段错误(关键坑 1)

症状:QLinearGradient 的 p.fillRect(rect, gradient) 在设备 QWS 上 SIGSEGV(exit 139)。paintEvent 中 QPainter 构造正常,QFont/drawText 正常,唯独渐变填充崩溃。

解决:全部改用纯色填充 p.fillRect(rect, QColor(...))。视觉上可接受;如需要渐变效果,用分条带纯色近似。

注意:QLinearGradient 对象构造本身不崩,崩溃发生在 fillRect(rect, gradient)。

4.4 Qt 不写 fb0(关键坑 2,根因)

症状:page_app 运行、QScreen 激活(qt_screen size=1366x768 depth=32)、paintEvent 正常执行,但 fb0 内容完全不变(读回全黑/旧内容)。直接 dd 写 fb0 却可正常显示(证明 fb0 显示路径正常)。

根因:设备 fb 驱动不提供 smem_len → Qt 的 QLinuxFbScreen::connect 里 fb->fix.smem_len == 0 → mmap 失败 → Qt 退化为内存缓冲(qt_screen->totalSize() == 0,qt_screen->base() 是 malloc 地址,不是 fb 映射)。QWidget 画到内存缓冲,从不写 fb0。

定位方法:打印 qt_screen->totalSize()、qt_screen->base()、qt_screen->isTransformed()(#include <qscreen_qws.h>)。

解决:手动把 Qt 渲染结果刷到 fb0(见 4.5)。

4.5 手动刷写 fb0(flushToFb)

因为 Qt 的内存缓冲从不提交到 fb0,在 Page 中加 flushToFb():

void flushToFb() {
    if (m_fb < 0) m_fb = ::open("/dev/fb0", O_WRONLY);
    if (m_fb >= 0 && qt_screen && qt_screen->base()) {
        static uchar* tmp = new uchar[1366*768*4];
        const uchar* src = qt_screen->base();
        int W = 1366, H = 768, stride = W*4;
        // Rot180: 逻辑坐标 -> 物理(上下翻转 + 左右镜像)
        for (int y = 0; y < H; y++) {
            const uchar* srow = src + (H-1-y)*stride;
            uchar* drow = tmp + y*stride;
            for (int x = 0; x < W; x++) {
                drow[x*4+0] = srow[(W-1-x)*4+0];
                drow[x*4+1] = srow[(W-1-x)*4+1];
                drow[x*4+2] = srow[(W-1-x)*4+2];
                drow[x*4+3] = srow[(W-1-x)*4+3];
            }
        }
        ::lseek(m_fb, 0, SEEK_SET);
        ::write(m_fb, tmp, 1366*768*4);
    }
}

在 timerEvent 中调用 update(); flushToFb();(每秒一次)。

4.6 Rot180 方向(关键坑 3)

症状:直接把 base() 写 fb0,画面上下颠倒 + 左右镜像。

原因:面板物理安装为旋转 180°(设备配置 Transformed:Rot180),而 base() 是逻辑坐标(未旋转)。

解决:flush 前对 base 做 180° 旋转(上下翻转 + 左右镜像,见 4.5 代码)。

验证:旋转后 fb0 内容(dd if=/dev/fb0 读回,不额外翻转)即为正确页面,物理屏幕正常显示。

4.7 其他

  • INTERP 路径:Bootlin 链接的 INTERP 为 /lib/ld-linux-armhf.so.3,设备只有 /lib/ld-linux.so.3 → 创建符号链接 /lib/ld-linux-armhf.so.3 -> /lib/ld-2.26.so。
  • 权限:上传后需 chmod +x /root/page_app(否则 nohup: can't execute)。
  • glibc 需求:page_app 只需 GLIBC_2.4(设备 2.26 满足)。

5. 构建与部署流程

5.1 编译(在 WSL Ubuntu,root)

wsl -d Ubuntu -u root -e bash <项目目录>/build.sh

build.sh 步骤:

  1. 拷贝 Qt4 头文件到 /root/mcgs_build/qt4
  2. 建 Qt 库符号链接(qtlib/,libQtGui.so.4.8.7 → libQtGui.so/.so.4)
  3. 建依赖符号链接(deps/:libts/libglib/libgthread/libpcre)
  4. 编译 main.cpp:
$TC/arm-buildroot-linux-gnueabihf-g++ \
  -std=gnu++98 -march=armv7-a -mfpu=neon -mfloat-abi=hard \
  -DQ_WS_QWS \
  -I$QTINC -I$QTINC/QtCore -I$QTINC/QtGui \
  -fPIC -O2 main.cpp \
  -L$QTLIB -Wl,-rpath-link,$QTLIB -Wl,-rpath-link,$DEPS \
  -lQtGui -lQtCore -o page_app -lm
  1. 验证:readelf -h(ELF32/ARM/EXEC)、-d(NEEDED 含 libQtGui/libQtCore/libstdc++)、-sW(GLIBC 版本)
  2. 复制到工作区 page_app

注意:WSL 的 /mnt/f(drvfs)不支持符号链接,所有链接操作在 WSL /root/mcgs_build 内完成。

5.2 部署与运行(设备)

# 上传
sshpass -p '<密码>' scp -P 22 -o StrictHostKeyChecking=no \
  page_app <用户名>@<设备IP>:/root/page_app
# 运行(后台)
ssh <用户名>@<设备IP> "chmod +x /root/page_app; \
  killall page_app 2>/dev/null; \
  cd /root; \
  export QWS_DISPLAY='Transformed:Rot180:Linuxfb:/dev/fb0:depth=24'; \
  export QWS_MOUSE_PROTO='tslib:/dev/input/event0 intellimouse:/dev/input/mice'; \
  export TSLIB_TSDEVICE='/dev/input/event0'; \
  nohup ./page_app -qws > /tmp/page_app.log 2>&1 < /dev/null &"

注意:必须用纯 Linuxfb QWS_DISPLAY(去掉 Multi/VNC),保证只走 Linuxfb 路径,flushToFb 才生效。

5.3 截屏验证(fb0 读回)

dd if=/dev/fb0 of=/tmp/fb.raw bs=4196352 count=1
# 下载到本机后转 PNG(注意 fb 为自顶向下,不额外翻转):
python -c "from PIL import Image; raw=open('fb.raw','rb').read(); \
Image.frombytes('RGBA',(1366,768),raw,'raw','RGBA').save('fb_view.png')"

5.4 开机自启

修改 /etc/init.d/S99mcgs_app(原脚本备份为 S99mcgs_app.bak):

app_name="page_app"
start() {
    cd /root
    export QWS_DISPLAY="Transformed:Rot180:Linuxfb:/dev/fb0:depth=24"
    export QWS_MOUSE_PROTO="tslib:/dev/input/event0 intellimouse:/dev/input/mice"
    export TSLIB_TSDEVICE="/dev/input/event0"
    ./$app_name -qws &
}

恢复 demo_app:cp /etc/init.d/S99mcgs_app.bak /etc/init.d/S99mcgs_app。

6. 项目文件结构

公开笔记只列出与理解构建/部署相关的文件,不包含工具链、设备库和调试产物本身。

<项目目录>/
├── main.cpp            # Qt 页面源码(无 Q_OBJECT,含 flushToFb/Rot180)
├── build.sh            # 交叉编译脚本(WSL root 运行)
├── page_app            # ARM 可执行(设备 /root/page_app)
├── toolchain/qt4root/  # Qt4 头文件(qconfig.h 已改 QT_ARCH_ARM/QT_POINTER_SIZE)
├── qtlib-arm/          # 设备 Qt 库 + 依赖(libQtGui/libQtCore/libts/...)
├── fb_view.png         # 最终显示截图
└── ...                 # 其余为本地调试脚本与 fb 原始数据,不公开

7. 后期扩展路线(围绕此硬件)

以下方向可基于现有 flushToFb + 导航框架继续开发:

  1. 真实数据接入:温度/压力/流量/负载用真实数据源(如串口 /dev/ttyS*、Modbus、socket),在 timerEvent 更新并 flushToFb。
  2. 触摸交互完善:mousePressEvent 已支持导航切换与开关;可扩展拖拽、滑块、多页滑动、长按。
  3. 页面扩展:在导航框架下新增页面(数据曲线页可接实时数据、报警页接真实报警队列、设置页做持久化配置)。
  4. VNC 远程调试:QWS_DISPLAY 加回 VNC:... 可同时输出到 VNC(注意当前手动 fb0 刷写与 VNC 的关系需单独验证)。
  5. 多屏/双缓冲:理解 fb0/fb1 与虚拟 1366×1536 双缓冲,可做无闪烁翻页。
  6. 中文字体:simsun .qsf 已加载;如需其他字体,放入 /tmp/qtembedded-0/fonts/ 或用 QFont::setPixelSize。
  7. 开机服务:把 page_app 做成完整服务(stop/restart/状态),对接 MCGS 原有 demo_app 回退。

8. 经验总结

  • 设备 Qt 与宿主 Qt 头文件版本需匹配(4.8.7),且必须 -DQ_WS_QWS 和正确的 qconfig.h(ARM/32 位)。
  • 工具链 glibc 必须 ≤ 设备 glibc(2.26),否则运行期缺符号。
  • 渐变 fillRect 在设备 QWS 上崩溃——统一用纯色。
  • fb 驱动无 smem_len → Qt 走内存缓冲 → 必须手动刷写 fb0,这是本设备 Qt 显示的核心绕行方案。
  • 屏幕物理为 Rot180 → flush 时旋转,否则倒置。
  • 先验证动态库与显示路径(hello 程序 / 纯色写 fb0),再叠加 Qt 渲染,可快速定位分层问题。

相关阅读

← 返回博文列表