linux qws是什么
Linux QWS是Qt Embedded早期用于管理窗口和输入设备的窗口系统，在Qt 5后被Wayland取代，但目前仍有大量嵌入式设备运行在基于QWS的Qt 4.x上，理解和掌握其配置与调试方法对于维护旧系统至关重要。
QWS全称Qt Windowing System，是Qt Embedded 4.x及之前版本自带的窗口系统实现，它不依赖外部显示服务器，直接操作帧缓冲（frame buffer），负责窗口绘制、输入事件分发和屏幕管理，在嵌入式资源受限的环境下，QWS能提供轻量级的图形界面支持，一度成为工控、仪表、车载等领域的首选方案。
QWS的工作原理
QWS采用客户端-服务器架构，但不同于X11的复杂网络透明性，它的设计更精简，服务器进程（qws server）直接管理帧缓冲设备，各个QWS客户端通过共享内存或Unix域套接字与服务器通信，请求绘制窗口或接收输入事件，服务器还负责窗口叠加、焦点切换和屏幕旋转。
典型的QWS环境组成
- 帧缓冲设备：通常为
/dev/fb0,需要内核支持并正确配置驱动。 - QWS服务器：由Qt Embedded库自动启动，或通过设置
QWS_DISPLAY变量指定。 - 输入设备：通过
QWS_MOUSE_PROTO、QWS_KEYBOARD等环境变量指定鼠标、键盘、触摸屏输入协议。 - 字体与插件：使用QPF（Qt Pre-rendered Font）字体格式，插件系统加载显示驱动、输入驱动等。
linux qws配置方法
配置QWS环境主要围绕环境变量设置和启动参数调整，多数嵌入式Linux系统通过脚本或udev规则完成初始化，以下步骤适用于常见的Qt Embedded 4.8.x环境,可直接在开发板或旧设备上验证。
确认帧缓冲设备可用
检查/dev/fb0是否存在,并确保有读写权限：
ls -l /dev/fb0
如果设备不存在，需要加载内核帧缓冲驱动（如fbmem、xxxfb等），运行cat /dev/urandom > /dev/fb0可简单测试屏幕是否正常显示随机噪点。
设置核心环境变量
在启动Qt应用前，必须设置QWS_DISPLAY变量，格式为<驱动名>:<选项>,常用驱动包括：
LinuxFb：直接操作帧缓冲,最常用。QVFb：虚拟帧缓冲，用于开发调试（需编译时支持）。Transformed：支持旋转（如Transformed:Rot90）。
示例：
export QWS_DISPLAY=LinuxFb:/dev/fb0 export QWS_SIZE=800x600 # 可选，指定显示尺寸
配置输入设备
触摸屏：
export QWS_MOUSE_PROTO=Tslib:/dev/input/event0
其中Tslib表示使用tslib库校准的触摸输入，/dev/input/event0为实际输入事件节点。
鼠标：
export QWS_MOUSE_PROTO=MouseMan:/dev/input/mouse0
键盘：
export QWS_KEYBOARD=TTY:/dev/tty1
也可以指定USB协议用于USB键盘。
启动QWS服务器
Qt Embedded应用在启动时会自动创建QWS服务器进程，但也可以通过-qws参数强制以服务器模式运行：
./myapp -qws
如果希望单独启动一个空服务器，可使用qwsserver命令（部分发行版包含）或直接运行/path/to/qt/bin/qwsServer。
调试与验证
查看QWS服务器日志，设置QT_DEBUG_PLUGINS=1观察插件加载情况，使用xev类似工具（如Qt自带的qpe测试程序）检查事件是否正常传递，若显示异常，检查帧缓冲色彩深度与程序预期是否匹配（QWS_DISPLAY可指定如depth=16）。
linux qws与wayland对比
随着Qt 5对Wayland的正式支持，QWS逐渐退出主流舞台，但很多工业现场仍使用Qt 4.8,理解两者差异有助于制定迁移决策。
架构层面
| 特性 | QWS | Wayland |
|---|---|---|
| 显示后端 | 直接操作帧缓冲 | 通过兼容内核的DRM/KMS驱动 |
| 窗口管理 | 简单叠加，无复杂合成 | 支持合成器，可做酷炫特效 |
| 输入处理 | 传统输入协议，依赖tslib | 支持libinput、多点触摸、手势 |
| 安全模型 | 无沙箱，任何app可读帧缓冲 | 每个客户端被隔离，需通过合成器通信 |
| 网络透明性 | 不支持远程显示 | 可通过Wayland proxy扩展 |
性能与资源占用
QWS直接写帧缓冲，I/O路径短，在低端CPU（如ARM9）上延迟更低，但缺少硬件加速，2D/3D耗费CPU，Wayland结合DRM/GEM可实现零拷贝渲染，GPU加速下吞吐量更高,但依赖图形硬件能力。
维护与生态
Qt官方自Qt 5.0起已移除QWS支持，代码冻结在4.8.x，社区围绕Qt 4.8的补丁几乎停滞，Wayland则持续演进，主流桌面和嵌入式发行版均默认支持，新驱动、新硬件适配更及时。
行业共识认为，在硬件资源较充裕（如Cortex-A7以上、有GPU）的新项目中，直接采用Qt 5/6 + Wayland方案更利于长期维护，若设备仅支持Qt 4.8且无升级计划,加固现有QWS配置并做好文档归档是务实选择。
linux qws嵌入式开发要点
在嵌入式Linux设备上使用QWS，有些细节容易被忽略,但直接影响系统稳定性。
多进程窗口管理
QWS支持多窗口，但默认采用简单叠加，不支持透明窗口和复杂合成，若应用需要多个顶层窗口，需设置QT_QWS_TOPLEVELS环境变量或使用QWS_CUSTOM_LAYERS插件，常见做法是让一个主窗口全屏,其余窗口通过弹出式对话框实现。
显示旋转与双屏
旋转显示通过Transformed驱动实现，如QWS_DISPLAY=Transformed:Rot90:LinuxFb:/dev/fb0，双屏扩展需编译时开启QT_QWS_DUALHEAD,并分别指定两个显示设备，
export QWS_DISPLAY0=LinuxFb:/dev/fb0 export QWS_DISPLAY1=LinuxFb:/dev/fb1 export QT_QWS_DUALHEAD=1
输入校准与多点触控
QWS本身不支持多点触控，需要借助tslib进行单点校准，若使用电阻屏，务必在应用启动前运行ts_calibrate生成校准文件，并设置TSLIB_CALIBFILE指向该文件，对于电容屏，部分驱动可模拟单点，但体验较差,建议升级到Wayland。
性能优化技巧
- 关闭Qt的RGB转换：若帧缓冲格式与程序内部格式一致，设置
QT_QWS_DEPTH匹配减少转换开销。 - 使用预编译字体：QPF字体格式比TTF加载更快，尽量使用
makeqpf工具转换。 - 减少窗口刷新：利用
QWS_DOUBLE_BUFFER开启双缓冲，防止撕裂,但会额外占用内存。
linux qws常见问题
运行Qt应用时出现”QWS: Unable to connect to server”怎么办？
该错误通常表示QWS服务器未运行或环境变量配置错误，首先确认QWS_DISPLAY已正确设置，且帧缓冲设备存在且可写，若在多用户环境，需确保当前用户有权限访问/dev/fb0和输入设备节点，另一种可能是程序以非-qws模式启动，但系统中已有其他QWS服务器占用锁文件，删除/tmp/qtembedded-目录下的锁文件后重试。
linux qws设备价格差异很大，选购时重点关注什么？
同样基于QWS的工控设备，价格从几百到数千元不等，差异主要来自CPU性能、内存大小、屏幕尺寸和工业级温度范围，选购时优先确认Qt版本是否为4.8.x，以及BSP（板级支持包）是否完整提供帧缓冲和输入驱动，不要只看硬件，软件适配成本往往更高,建议要求供应商提供完整的QWS环境配置脚本和测试程序。
在旧设备上升级Qt版本，如何从QWS迁移到Wayland？
迁移分三步：第一步，确认硬件支持DRM/KMS，内核版本至少3.8以上；第二步，交叉编译Qt 5或Qt 6，启用-linuxfb后端作为过渡，确保图形能正常输出；第三步，安装weston或qtwayland，逐步替换应用启动命令，将-qws参数改为-platform wayland，注意输入设备可能需要重新适配，触摸屏尽量使用libinput驱动。
首发原创文章，作者：王坚，如若转载，请注明出处：https://idctop.com/linux-qws%e6%98%af%e4%bb%80%e4%b9%88%ef%bc%8c%e6%80%8e%e4%b9%88%e5%ae%89%e8%a3%85%e9%85%8d%e7%bd%ae%ef%bc%9f/
