在i.MX6ULL开发板上，用Buildroot配置Qt5+tslib触摸屏的完整环境搭建笔记
在i.MX6ULL开发板上构建Qt5+tslib嵌入式GUI开发环境实战指南
当我们需要在资源受限的嵌入式设备上开发图形用户界面时，Qt框架凭借其跨平台特性和丰富的功能库成为首选。i.MX6ULL作为一款广泛应用于工业控制、智能家居等领域的ARM Cortex-A7处理器，搭配Buildroot构建轻量级Linux系统，能够为Qt应用提供稳定高效的运行环境。本文将手把手带你完成从Buildroot配置到Qt应用实际运行的完整流程，特别针对触摸屏校准、字体显示等实际部署中的痛点问题提供解决方案。
1. 开发环境准备与工具链配置
在开始Qt5环境搭建之前，我们需要确保基础工具链的兼容性。i.MX6ULL开发板通常采用ARMv7架构，而Buildroot 2023.02版本中默认的gcc 4.9.4编译器无法满足Qt5的最低要求（需要gcc 5.0+）。
1.1 获取Linaro交叉编译工具链
Linaro提供的ARM交叉编译工具链是嵌入式开发的行业标准选择。以下是获取和配置步骤：
访问Linaro官网下载稳定版本：
wget https://releases.linaro.org/components/toolchain/binaries/6.4-2018.05/arm-linux-gnueabihf/gcc-linaro-6.4.1-2018.05-x86_64_arm-linux-gnueabihf.tar.xz解压到工具链目录：
mkdir -p ~/toolchains tar -xvf gcc-linaro-6.4.1-2018.05-x86_64_arm-linux-gnueabihf.tar.xz -C ~/toolchains配置环境变量（添加到~/.bashrc）：
export PATH=$PATH:~/toolchains/gcc-linaro-6.4.1-2018.05-x86_64_arm-linux-gnueabihf/bin
提示：执行
source ~/.bashrc使配置生效，通过arm-linux-gnueabihf-gcc -v验证安装
1.2 Buildroot外部工具链配置
在Buildroot中配置外部工具链需要特别注意内核头文件版本匹配问题：
| 配置项 | 推荐值 | 说明 |
|---|---|---|
| Toolchain type | External toolchain | 使用自定义工具链 |
| Toolchain | Custom toolchain | 指定Linaro工具链路径 |
| Toolchain path | /path/to/gcc-linaro-6.4.1... | 工具链绝对路径 |
| External toolchain gcc version | 6.x | 匹配Linaro版本 |
| External toolchain kernel headers | 4.1.x | 需与实际内核头文件一致 |
若遇到内核版本不匹配错误（如提示"expected 4.1.x, got 4.0.x"），需要修改工具链中的版本标识：
vim ~/toolchains/gcc-linaro-6.4.1-2018.05-x86_64_arm-linux-gnueabihf/arm-linux-gnueabihf/libc/usr/include/linux/version.h将LINUX_VERSION_CODE改为262415（对应4.1.15内核）。
2. Buildroot中Qt5模块的定制化配置
2.1 基础Qt5组件选择
在Buildroot的menuconfig中，需要精心选择Qt5模块组合以平衡功能与体积：
Target packages → Graphic libraries and applications → Qt5关键配置选项：
- qt5base：必选，核心模块
- gui module：启用GUI支持
- widgets module：传统Widgets应用开发
- linuxfb support：帧缓冲显示输出
- Enable Tslib support：触摸屏支持
- harfbuzz support：高级字体渲染
- Image formats：根据需要选择JPEG/PNG/GIF
2.2 字体与国际化支持
嵌入式系统常因缺少字体导致Qt应用显示异常。推荐以下解决方案：
在Buildroot中配置字体支持：
Target packages → Fonts and font utilities → [*] wqy-zenhei (Chinese font) [*] dejavu (Western font)手动添加字体文件（如果Buildroot未包含所需字体）：
# 下载文泉驿字体 wget https://nchc.dl.sourceforge.net/project/wqy/wqy-zenhei/0.9.45%28Fighting-state%20RC1%29/wqy-zenhei-0.9.45.tar.gz # 解压到根文件系统 tar -xvf wqy-zenhei-0.9.45.tar.gz -C output/target/usr/share/fonts/
2.3 编译与系统构建
完成配置后执行编译：
make -j$(nproc)编译完成后，系统镜像将生成在output/images/目录，包含：
rootfs.tar- 根文件系统zImage- 内核镜像*.dtb- 设备树文件
3. 触摸屏环境配置与校准
3.1 tslib环境变量配置
在output/target/etc/profile.d/下创建qt_env.sh，配置Qt和tslib环境：
#!/bin/sh # tslib配置 export TSLIB_CONSOLEDEVICE=none export TSLIB_FBDEVICE=/dev/fb0 export TSLIB_TSDEVICE=$(ls /dev/input/event* | head -n 1) export TSLIB_CALIBFILE=/etc/pointercal export TSLIB_CONFFILE=/etc/ts.conf export TSLIB_PLUGINDIR=/usr/lib/ts # Qt5配置 export QT_QPA_PLATFORM=linuxfb:fb=/dev/fb0 export QT_QPA_GENERIC_PLUGINS=tslib:$TSLIB_TSDEVICE export QT_QPA_FONTDIR=/usr/share/fonts export QT_PLUGIN_PATH=/usr/lib/qt/plugins export QT_QPA_FB_TSLIB=13.2 tslib配置文件优化
修改output/target/etc/ts.conf，启用必要的过滤插件：
module_raw input module pthres pmin=1 module debounce drop_threshold=200 module dejitter delta=100 module linear常用插件功能说明：
| 插件 | 参数 | 作用 |
|---|---|---|
| pthres | pmin=1 | 压力阈值过滤 |
| debounce | drop_threshold=200 | 防抖处理 |
| dejitter | delta=100 | 消除坐标抖动 |
| linear | - | 坐标线性校准 |
3.3 触摸屏校准实操
烧录系统到开发板后，执行校准流程：
ts_calibrate校准过程中依次点击屏幕显示的五个十字标记，完成后校准数据将保存到/etc/pointercal。可通过ts_test验证触摸效果。
4. Qt应用开发与部署实战
4.1 开发主机环境搭建
在开发主机上配置Qt Creator支持交叉编译：
添加qmake工具：
Tools → Options → Kits → Qt Versions → Add 路径：output/host/bin/qmake配置交叉编译工具链：
C编译器：arm-linux-gnueabihf-gcc C++编译器：arm-linux-gnueabihf-g++创建Kit组合上述配置
4.2 典型问题解决方案
触摸无响应问题排查：
- 确认
/dev/input/eventX设备节点存在 - 检查环境变量
TSLIB_TSDEVICE设置正确 - 通过
evtest工具验证原始触摸数据 - 查看
ts_test是否能正常响应
字体显示异常处理：
- 确认
QT_QPA_FONTDIR指向正确字体目录 - 检查字体文件权限（至少644）
- 在应用中指定回退字体：
QFont font("WenQuanYi Zen Hei"); QApplication::setFont(font);
性能优化技巧：
- 在
QT_QPA_PLATFORM中添加:size=800x480匹配屏幕分辨率 - 启用OpenGL加速（如果SoC支持）：
export QT_QPA_PLATFORM=linuxfb:fb=/dev/fb0:rotation=0:gl=on - 禁用不需要的Qt模块减小体积
4.3 应用打包与自动启动
将编译好的Qt应用部署到开发板：
- 可执行文件放到
/usr/bin - 创建启动脚本
/etc/init.d/S99myapp：#!/bin/sh export QT_QPA_PLATFORM=linuxfb:fb=/dev/fb0 /usr/bin/myapp -qws & - 设置可执行权限：
chmod +x /etc/init.d/S99myapp
对于需要显示中文的应用，确保在项目文件(.pro)中包含：
TRANSLATIONS += myapp_zh_CN.ts QMAKE_EXTRA_COMPILERS += lrelease在实际项目中，我们发现触摸屏的响应延迟问题往往与tslib的debounce参数设置不当有关。通过反复测试，将drop_threshold调整为150-300之间的值，既能过滤误触又不影响正常操作。此外，在低温环境下，适当提高pmin值可以避免手套误触发。