当前位置： 首页 > news >正文

保姆级教程：在Luckfox RV1106 Pro Max上，从SDK编译到Qt5应用部署全流程（Ubuntu 22.04）

news 2026/4/17 16:12:12

从零构建Luckfox RV1106 Pro Max的Qt5开发环境：完整实战指南

当一块搭载RV1106芯片的Luckfox开发板初次握在手中时，许多开发者都会面临一个现实问题：如何在这个资源受限的嵌入式平台上运行现代化的Qt图形界面？本文将带你完整走通从Ubuntu环境配置到Qt应用部署的全流程，特别针对Pro Max型号的SPI NAND版本，解决那些官方文档未曾提及的"坑"。

1. 开发环境准备与SDK获取

在Ubuntu 22.04 LTS上搭建基础环境是第一步。不同于常规嵌入式开发，Luckfox的Buildroot系统需要特定版本的依赖库。执行以下命令安装必备工具：

sudo apt update sudo apt install -y git ssh make gcc g++ gawk texinfo libssl-dev \ bison flex fakeroot cmake unzip gperf autoconf device-tree-compiler \ libncurses5-dev pkg-config bc python3 rsync

特别注意：如果之前安装过其他版本的工具链，建议使用docker run -it ubuntu:22.04创建纯净环境，避免库版本冲突。

获取官方SDK推荐使用国内镜像源：

mkdir -p ~/luckfox_ws && cd ~/luckfox_ws git clone https://gitee.com/LuckfoxTECH/luckfox-pico.git --depth=1

SDK目录结构关键部分说明：

luckfox-pico/ ├── project/ # 板级配置文件 ├── sysdrv/ # 内核与Buildroot源码 ├── tools/ # 交叉编译工具链 └── output/ # 编译输出目录

2. Buildroot系统定制与Qt5配置

进入Buildroot配置界面前，需要先设置目标板型号：

cd ~/luckfox_ws/luckfox-pico vim project/cfg/BoardConfig_IPC/BoardConfig-SPI_NAND-Buildroot-RV1106_Luckfox_Pico_Pro_Max-IPC.mk

确认包含export LF_TARGET_ROOTFS=buildroot

启动菜单配置：

cd sysdrv/source/buildroot/buildroot-2023.02.6/ make luckfox_pico_defconfig make menuconfig

Qt5相关配置路径及选项：

配置路径必选选项说明
Target Packages → Graphic libraries → qt5qt5base基础框架
qt5base子选项widgets, guiGUI组件支持
qt5base → OpenGLeglfs, linuxfb显示后端支持
Libraries → Graphicslibdrm, mesa3d硬件加速支持
Libraries → Othertslib触摸屏支持

关键技巧：使用/键搜索st7735快速定位到屏幕驱动配置项，确保以下选项启用：

Device Drivers → Staging drivers → Support for small TFT LCD display modules

3. 设备树与显示驱动深度配置

对于1.8寸ST7735S SPI屏幕，需要修改rv1103g-luckfox-pico-plus.dts文件：

// 禁用冲突的UART3 &uart3 { status = "disabled"; }; // 配置SPI0控制器 &spi0 { status = "okay"; pinctrl-names = "default"; pinctrl-0 = <&spi0m0_pins>; cs-gpios = <&gpio1 RK_PC0 GPIO_ACTIVE_LOW>; st7735s: st7735s@0 { compatible = "sitronix,st7735r"; reg = <0>; spi-max-frequency = <48000000>; reset-gpios = <&gpio1 RK_PD0 GPIO_ACTIVE_LOW>; dc-gpios = <&gpio1 RK_PD1 GPIO_ACTIVE_HIGH>; rotation = <90>; buswidth = <8>; fps = <30>; spi-cpol; spi-cpha; rgb; }; };

配置完成后，保存并编译内核：

cd ~/luckfox_ws/luckfox-pico/sysdrv/source/kernel make ARCH=arm savedefconfig cp defconfig arch/arm/configs/luckfox_rv1106_linux_defconfig

4. 系统编译与烧录实战

完整编译流程需要分步执行：

# 安装工具链 source ~/luckfox_ws/luckfox-pico/tools/linux/toolchain/arm-rockchip830-linux-uclibcgnueabihf/env_install_toolchain.sh # 设置环境变量 echo 'export PATH=$PATH:~/luckfox_ws/luckfox-pico/tools/linux/toolchain/arm-rockchip830-linux-uclibcgnueabihf/bin' >> ~/.bashrc source ~/.bashrc # 完整编译 cd ~/luckfox_ws/luckfox-pico echo 8 | ./build.sh lunch ./build.sh

编译完成后，在output/image目录会生成以下关键文件：

  • luckfox-pico-pro-max-spi-nand-ipc.img系统镜像
  • boot.img启动分区
  • env.txt环境变量配置

使用瑞芯微开发工具RKDevTool烧录时，常见问题解决方案：

  1. 设备无法进入Loader模式：

    • 按住BOOT键再插USB
    • 执行lsusb确认出现2207:350a设备

  2. 烧录失败错误码7：

    sudo apt install libusb-1.0-0-dev sudo chmod a+rw /dev/bus/usb/*

5. Qt Creator交叉编译环境配置

在Ubuntu主机上配置Qt Creator的完整流程：

  1. 工具链设置：

    • 编译器路径：
      ~/luckfox_ws/luckfox-pico/sysdrv/source/buildroot/buildroot-2023.02.6/output/host/bin/arm-rockchip830-linux-uclibcgnueabihf-g++
    • qmake路径：
      ~/luckfox_ws/luckfox-pico/sysdrv/source/buildroot/buildroot-2023.02.6/output/host/bin/qmake

  2. Kit配置关键参数：

    [Device] Type=Generic Name=Luckfox RV1106 [Build] SysRoot=~/luckfox_ws/luckfox-pico/sysdrv/source/buildroot/buildroot-2023.02.6/output/host/arm-buildroot-linux-uclibcgnueabihf/sysroot [Debug] Debugger=~/luckfox_ws/luckfox-pico/tools/linux/toolchain/arm-rockchip830-linux-uclibcgnueabihf/bin/arm-rockchip830-linux-uclibcgnueabihf-gdb

  3. 部署配置示例：

    target.path = /userdata INSTALLS += target QMAKE_LFLAGS += -Wl,-rpath-link,/usr/lib

6. 实战：部署analogclock示例

在开发板上配置Qt运行环境：

vi /etc/profile

添加以下内容：

export QT_QPA_PLATFORM=linuxfb:fb=/dev/fb0 export QT_QPA_FONTDIR=/usr/share/fonts export QT_QPA_GENERIC_PLUGINS=tslib:/dev/input/event0 export TSLIB_TSDEVICE=/dev/input/event0 export TSLIB_CONFFILE=/etc/ts.conf

通过SCP部署程序：

scp analogclock root@192.168.1.100:/userdata ssh root@192.168.1.100 "chmod +x /userdata/analogclock"

性能优化技巧：

  • 在main.cpp中添加qputenv("QT_LOGGING_RULES", "qt.qpa.*=false");禁用冗余日志
  • 使用-platform linuxfb:fb=/dev/fb0:size=160x128指定精确分辨率
  • 启用硬件加速时添加QT_OPENGL=software环境变量

7. 高级调试与问题排查

当遇到显示异常时，按以下步骤排查：

  1. 检查帧缓冲区：

    cat /dev/urandom > /dev/fb0

    应该看到屏幕出现随机噪点

  2. 验证输入设备：

    evtest /dev/input/event0

    触摸屏幕应有事件输出

  3. Qt调试输出：

    export QT_DEBUG_PLUGINS=1 ./analogclock -platform linuxfb 2>&1 | tee qt.log

常见错误解决方案表：

错误现象可能原因解决方案
黑屏无输出屏幕驱动未加载检查dmesg输出，确认spi设备注册
花屏/错位设备树rotation参数错误尝试0/90/180/270不同角度值
触摸无响应tslib配置错误校准触摸屏：ts_calibrate
段错误库路径不匹配使用ldd检查依赖关系

8. 扩展应用：自定义Qt控件开发

在资源受限的RV1106上开发Qt应用需要特别注意：

  1. 内存优化技巧：

    • 在.pro文件中添加：
      QMAKE_CXXFLAGS += -Os DEFINES += QT_NO_DEBUG_OUTPUT
    • 使用QWidget::setAttribute(Qt::WA_DeleteOnClose)

  2. 高效绘图方案：

    // 使用QPainter的硬件加速路径 QPainter painter(this); painter.setRenderHint(QPainter::Antialiasing, false); painter.setRenderHint(QPainter::SmoothPixmapTransform, false);

  3. 资源文件优化：

    rcc -binary myres.qrc -o myres.rcc

    将生成的rcc文件放入开发板/usr/share/qt5/resources/目录

通过完整的开发环境搭建、系统定制到应用部署的闭环实践，Luckfox RV1106 Pro Max完全能够胜任各类工业级Qt应用场景。实际项目中，建议将编译好的根文件系统制作为SDK供团队共享使用，大幅提升后续开发效率。

http://www.jsqmd.com/news/656213/

相关文章：

  • 【智能代码生成×代码搜索融合实战指南】：20年架构师亲授3大落地场景与5个避坑红线
  • 2026年好用的室外装饰线条制造商推荐，哪家比较靠谱盘点 - myqiye
  • 总结口碑好的印刷优质供应商，推荐哪家更靠谱 - 工业品网
  • 2026【机房噪声处理行业】正规机构选择避坑指南（实操落地版） - 深度智识库
  • Redmi AC2100解锁SSH与Breed刷入实战：从零到一的固件自由之路
  • 解析人人专业吊装服务规模，其口碑究竟好不好 - 工业设备
  • 别再只会用mean了！用Matlab filter函数实现滑动平均滤波，5分钟搞定数据降噪
  • 7-Zip：开源压缩工具如何帮你节省硬盘空间并保护数据安全
  • 2026耐腐蚀真空泵厂家推荐：品牌口碑、产品性能、服务能力综合评测报告 - 品牌推荐大师1
  • 机械臂力控（5）--笛卡尔阻抗控制器实现
  • 大模型部署卡顿诊断手册（SITS2026内部调优清单首次公开）
  • 支付宝立减金套装正规回收渠道，别让福利闲置作废！ - 圆圆收
  • 3个维度深度解析：如何用Path of Building将流放之路Build规划效率提升10倍
  • 嵊泗青年旅行社哪家性价比高，揭秘行业口碑与客户满意度 - 工业品网
  • 基于STM32的正弦波测频计设计与实现（优化篇）
  • 5个理由告诉你为什么FieldTrip是神经科学研究的终极工具箱
  • C语言动态内存分配实战：打造高效通讯录管理系统
  • 标准功能【自动高度】在云之家无效，需要手工计算动态高度
  • 新航道等五家留学机构深度解读：选择要点、服务透明化与实操建议 - 品牌2025
  • AMD GPU如何驱动kohya_ss：ROCm技术栈完整实现与优化实战
  • 从MATLAB到Tecplot：手把手教你搞定复杂非结构网格（含FEPolygon/FEPolyhedron）的数据转换
  • 推荐几家Facebook推广获客服务商，搭配海外营销推广代运营公司，解锁外贸AI营销平台高效获客新模式（附带联系方式） - 品牌2026
  • kube-proxy ipvs 与 iptables 区别
  • Proteus仿真避坑指南：手把手教你用51单片机+DS18B20做个带报警的数码管温度计
  • Claude Code配置教程
  • 2026现阶段西安美缝市场：谁在定义高品质与可靠服务的新标准？ - 2026年企业推荐榜
  • 机械臂力控（6）--李群李代数
  • 智能代码生成≠免责金牌：ISO/IEC 27001认证团队强制执行的6项代码溯源与权限控制标准
  • 拆解 Hermes Agent 的动态 Prompt 和 learning loop 架构
  • 从原型到量产：基于RK3326PX30的嵌入式Android/Linux双系统开发实战指南