MCGS 触摸屏 Qt 页面项目笔记
本文为项目实战笔记,已做脱敏:设备 IP、用户名、密码以及本机路径均以占位符呈现,仅保留可复用的方法与技术细节。截图状态栏中的设备标识与 IP 亦已替换。
MCGS 触摸屏 Qt 页面项目笔记
项目:在 MCGS 嵌入式触摸屏(<设备IP>)上从零创建并显示一个 1366×768 的 Qt 页面。
状态:已完成,页面已在设备屏幕正确显示,并配置开机自启。

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 的 Linuxfbmmap失败(详见下文)
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) |
| gcc | 6.4.0 |
| glibc | 2.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 步骤:
- 拷贝 Qt4 头文件到
/root/mcgs_build/qt4 - 建 Qt 库符号链接(
qtlib/,libQtGui.so.4.8.7→libQtGui.so/.so.4) - 建依赖符号链接(
deps/:libts/libglib/libgthread/libpcre) - 编译
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
- 验证:
readelf -h(ELF32/ARM/EXEC)、-d(NEEDED 含 libQtGui/libQtCore/libstdc++)、-sW(GLIBC 版本) - 复制到工作区
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 + 导航框架继续开发:
- 真实数据接入:温度/压力/流量/负载用真实数据源(如串口
/dev/ttyS*、Modbus、socket),在timerEvent更新并flushToFb。 - 触摸交互完善:
mousePressEvent已支持导航切换与开关;可扩展拖拽、滑块、多页滑动、长按。 - 页面扩展:在导航框架下新增页面(数据曲线页可接实时数据、报警页接真实报警队列、设置页做持久化配置)。
- VNC 远程调试:QWS_DISPLAY 加回
VNC:...可同时输出到 VNC(注意当前手动 fb0 刷写与 VNC 的关系需单独验证)。 - 多屏/双缓冲:理解 fb0/fb1 与虚拟 1366×1536 双缓冲,可做无闪烁翻页。
- 中文字体:simsun
.qsf已加载;如需其他字体,放入/tmp/qtembedded-0/fonts/或用QFont::setPixelSize。 - 开机服务:把 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 渲染,可快速定位分层问题。