: 环境搭建全攻略)
系列导读本系列共4篇带你从零开始掌握Qt Onboard开发套件在高通跃龙IQ-9075 EVK上快速构建边缘侧AI应用。本篇为第一篇聚焦环境搭建从Yocto深渊到分钟级上手。前言我们为什么需要Qt Onboard如果你做过嵌入式Linux开发一定对Yocto项目又爱又恨。便利性很显现它功能强大、灵活度高几乎能定制任何嵌入式Linux系统但麻烦也很明显构建一套工具链动辄数小时甚至数天配置BSP、适配驱动踩坑无数新人上手周期长学习曲线陡峭Qt与高通联合推出的Qt Onboard开发套件正是为了解决这些痛点而生。它以QBSPQt Board Support Package形式交付包含开箱即用的系统镜像与预配置工具链让你跳过Yocto的复杂性数分钟内完成环境搭建。本文将带你实战走完环境搭建全流程从申请评估许可到在高通跃龙IQ-9075 EVK上跑起第一个Qt应用。1、Qt Onboard整体架构在动手之前先搞清楚Qt Onboard的整体架构做到心中有数。开发工具层Qt Creator IDE、Qt Online Installer、Qt Design StudioQt Onboard QBSP层Qt Runtime 6.11、SDK交叉编译工具链、部署与调试工具系统软件层Qualcomm Linux基于Yocto、板级支持包BSP、设备驱动硬件层高通跃龙IQ-9075 EVK评估套件、Snapdragon SoC Hexagon HTP、外设接口关键理解Qt Onboard不是在Boot to Qt中添加高通板级支持而是直接在Qualcomm Linux发行版基础上构建QBSP保证了与原厂Linux的完全兼容。2、环境搭建流程图整个搭建流程可以用下面这张Mermaid图来概括申请90天免费评估许可登录Qt账户打开Qt Online Installer选择Extended Evaluation分类选中跃龙IQ-9075 QBSP下载并安装QBSP安装完成 - 获取SDK与镜像准备IQ-9075开发板烧录系统镜像到开发板连接网线与电源线开发板启动 - 进入Qt演示界面启动Qt Creator配置设备连接验证SDK工具链环境搭建完成 ✓整个流程分为三大阶段QBSP安装步骤A-G在PC端安装Qt Onboard开发套件设备准备步骤H-K烧录镜像并启动开发板IDE配置步骤L-OQt Creator中配置设备与SDK3、实战步骤详解3.1 阶段一申请评估许可与安装QBSP步骤1申请90天免费评估许可访问 Qt与高通合作伙伴页面填写以下信息申请评估许可字段说明姓名/公司如实填写邮箱建议使用企业邮箱开发板型号选择 Qualcomm IQ-9075 EVK用途描述简要说明你的项目方向如工业边缘AI应用开发⚠️注意评估许可审批通常需要1-2个工作日。审批通过后你会收到包含许可密钥和下载指引的邮件。步骤2安装Qt Online Installer如果你之前没有安装过Qt工具链需要先下载并安装Qt Online Installer访问 Qt官网下载页下载对应操作系统的Online Installer支持Windows/Linux/macOS运行安装程序使用收到的评估许可关联的Qt账号登录步骤3安装Qt Onboard QBSP登录后在安装界面中找到Extended Evaluation分类├── Qt 6.11.x │ ├── Desktop根据你的系统选择 │ └── ... └── Extended Evaluation ← 重点在这里 └── Qualcomm └── Qt Onboard for IQ-9075 EVK ← 勾选这个勾选Qt Onboard for IQ-9075 EVK后安装程序会自动下载✅ 预构建的Qualcomm Linux系统镜像✅ Qt 6.11运行时库✅ 交叉编译SDK工具链✅ Qt Creator部署插件小贴士整个QBSP包体积较大约5-8GB建议在网络环境好的时候下载。安装完成后可以在Qt安装目录的Tools/QtOnboard/下找到相关文件。3.2 阶段二烧录镜像并启动开发板步骤4认识跃龙IQ-9075评估套件在烧录之前先熟悉一下开发板的接口┌──────────────────────────────────────────┐ │ IQ-9075 Evaluation Kit │ │ │ USB-C │ ●●● USB3.0 ●● HDMI ● 以太网 │ 电源 调试 │ │ 按键 │ microSD ●● 摄像头接口 ●● 音频 │ └──────────────────────────────────────────┘关键接口说明USB-C调试口用于串口控制台访问和供电以太网口用于网络部署和SSH连接HDMI接口连接显示器查看Qt应用界面USB 3.0接口连接USB摄像头、U盘等外设microSD卡槽系统镜像通常烧录到SD卡中步骤5烧录系统镜像到SD卡找到QBSP安装目录下的镜像文件# Linux/macOS 路径示例~/Qt/6.11.x/QtOnboard/IQ-9075/images/qtonboard-iq9075.wic.gz# Windows 路径示例C:\Qt\6.11.x\QtOnboard\IQ-9075\images\qtonboard-iq9075.wic.gz使用balenaEtcher烧录推荐图形化操作下载并安装 balenaEtcher打开Etcher选择Flash from file选中.wic.gz镜像插入SD卡建议32GB以上Class 10选择目标SD卡点击Flash!等待烧录完成使用命令行烧录Linux/macOS# 1. 解压镜像gunzip qtonboard-iq9075.wic.gz# 2. 找到SD卡设备名注意替换成你的设备千万别搞错diskutil list# macOSlsblk# Linux# 3. 烧录示例假设SD卡是 /dev/disk4sudoddifqtonboard-iq9075.wicof/dev/disk4bs4Mstatusprogress# 4. 安全弹出diskutileject/dev/disk4# macOSsudoeject/dev/mmcblk0# Linux⚠️高危提示dd命令非常强大但也很危险请务必确认of后面的设备是你的SD卡否则可能擦除电脑硬盘步骤6启动开发板将烧录好的SD卡插入IQ-9075的microSD卡槽连接以太网线连接到你的局域网路由器HDMI显示器USB键盘/鼠标可选USB-C电源线按下电源按钮开发板启动启动成功后你会在显示器上看到Qt Onboard的默认演示界面。如果看到Qt的logo和演示应用说明系统镜像烧录成功步骤7获取开发板IP地址有几种方式可以获取开发板的IP方式一通过路由器后台查看登录你的路由器管理页面查看连接设备列表找到设备名类似qtonboard-iq9075的设备记录其IP地址方式二通过串口控制台查看使用USB-C线连接开发板调试口和电脑使用串口工具如PuTTY、minicom、screen连接波特率115200数据位8停止位1登录后执行ip addr show eth0查看IP方式三通过Qt Creator自动发现后面会讲Qt Creator可以自动扫描局域网中的Qt Onboard设备3.3 阶段三Qt Creator配置与验证步骤8配置设备连接打开Qt Creator按照以下路径配置工具 → 选项 → 设备 → 设备 → 添加选择Qt Onboard Device类型然后自动发现模式推荐点击自动发现设备Qt Creator会通过mDNS协议扫描局域网找到qtonboard-iq9075.local后选中它点击下一步完成配置手动配置模式设备类型Generic Linux Device名称IQ-9075 EVK自定义主机名/IP填入开发板的IP地址如192.168.1.100用户名root默认认证方式密码默认密码通常在文档中说明配置完成后点击测试按钮验证连接是否正常。如果显示Device test finished successfully说明连接成功。步骤9验证SDK工具链Qt Onboard的QBSP安装时已经自动配置了交叉编译工具链。可以在以下位置确认工具 → 选项 → Kits → Kits你应该能看到一个名为Qt 6.11.x QtOnboard IQ-9075的Kit包含设备IQ-9075 EVK编译器GCCaarch64 Yocto SDKQt版本Qt 6.11.xQtOnboardDebuggerGDB Multiarch验证小技巧创建一个Qt Quick示例项目选择QtOnboard Kit进行编译如果编译成功并能部署到设备上运行说明环境完全正常。4、常见问题与排错Q1Qt Online Installer中找不到Extended Evaluation分类可能原因你的Qt账户没有关联评估许可许可还未生效解决方法确认收到了许可批准邮件在Qt Online Installer中点击左上角账户信息选择Refresh刷新许可重启Installer后再查看Q2开发板启动后黑屏没有Qt界面排查步骤检查HDMI线是否插紧显示器是否切换到正确输入源通过串口查看启动日志dmesg | grep -i display确认SD卡烧录是否完整校验MD5尝试重新烧录镜像Q3Qt Creator无法发现设备排查步骤确认电脑和开发板在同一局域网尝试ping开发板IP确认网络连通检查开发板上的mDNS服务是否运行systemctl status avahi-daemon手动输入IP地址进行连接Q4交叉编译报错找不到头文件或库可能原因SDK环境没有正确加载解决方法# 手动加载SDK环境Linuxsource~/Qt/6.11.x/QtOnboard/IQ-9075/sdk/environment-setup-cortexa76-oe-linux5、总结与下一步恭喜你到这里Qt Onboard开发环境已经搭建完成。我们来回顾一下核心要点环节耗时传统Yocto方式Qt Onboard方式环境搭建数天 → 数分钟需要自行构建BSP和工具链QBSP开箱即用镜像烧录约15分钟需自行编译生成镜像预构建镜像直接烧录IDE配置约10分钟手动配置交叉编译环境自动识别和配置首个应用运行约30分钟需要解决各种依赖问题一键部署运行本篇核心收获✅ 理解Qt Onboard的四层架构✅ 掌握QBSP的安装方法✅ 学会系统镜像烧录与开发板启动✅ 完成Qt Creator设备配置与验证在下一篇中我们将深入Qt Creator交叉编译与一键部署的实战带你创建第一个Qt Quick应用并跑在IQ-9075上同时讲解远程调试的技巧。系列索引一环境搭建全攻略 · 二Qt Creator交叉编译与一键部署实战 · 三多媒体与摄像头集成· 四边缘AI应用如果本文对你有帮助欢迎点赞、收藏、关注有问题也欢迎在评论区交流~
