开发套件

2026-02-25

Quectel Pi H1是移远通信推出的基于高通QCS6490高性能八核64位处理器（高达12 TOPS算力）和高通Adreno™ 643L GPU的智能主控板，拥有8 GB LPDDR4X存储，采用USB Type-C电源接口，可外接eMMC和SSD，支持Wi-Fi 2.4 & 5G，符合IEEE 802.11a/b/g/n/ac和蓝牙5.0协议，支持双显（DP和LCM或DP和Micro HDMI），性能强大，多媒体功能丰富，能够满足客户在工业和消费类应用中对高速率、多媒体功能以及算力的需求。

Quectel Pi H1集成了丰富的接口，极大地拓展了其在M2M领域的应用，可广泛应用于边缘计算、机器人、工控、多媒体终端、数字广告牌、智能安全以及工业级PDA等行业和设备，覆盖整个AIoT领域的各个行业。

Quectel Pi H1支持Yocto Linux/Debian操作系统，可满足大多数算法原型验证、推理应用开发的需求。

套件介绍

Quectel Pi H1开发套件以“核心硬件 + 适配配件”设计，确保即拿即用，套件内包含以下关键组件：

类别 配件名称 实物图 数量 核心规格/用途
核心硬件 Quectel Pi H1智能主控板 000005 1块 搭载高通 QCS6490 八核CPU，8 GB LPDDR4X + 128 GB UFS存储，双频Wi-Fi 5，承担计算、外设控制核心功能
供电配件 USB-A电源线 image-20251202190701154 1根 5A输出、1m线长，USB-A（公头）-USB-C（公头），适配后续推荐的电源适配器
显示配件 USB-C DP显示线 image-20251202190941509 1根 DP 1.4 规格、1m 线长，支持4K@60Hz高清显示
显示配件 HDMI 线 Snipaste_2025-12-02_18-06-28 1根 HDMI 2.0规格、1m线长，兼容传统HDMI显示设备
网络配件 千兆网线 image-20251202180802335 1根 1m线长，支持千兆速率数据传输
图像配件 IMX219 高清摄像头（带FPC排线） 1 个 800万像素、MIPI-CSI接口、120°视场角，支持图像采集与开源库调用

硬件资源

软件资源

Quectel Pi H1智能主控板提供丰富的软件资源帮助用户快速开发。在产品发布时，您可以获取全部的Linux AP源码及丰富的软件开发手册。

开发环境

可以在Quectel Pi H1智能主控板上基于Debian进行开发，也可以在PC机上基于yocto开发。

Yocto Linux的开发则需要在PC机上，对环境要求比较高。

详细开发细节请参考Yocto Linux开发环境搭建章节。

开发工具

详细内容请参考Yocto Linux系统工具与应用章节。

核心组件

类别 名称 描述信息 源码
Bootloader U-boot 第二引导启动程序 否
Linux内核 Linux Kernel 基于高通kernel_6.6版本定制 是
设备驱动 PMIC
EEPROM
USB Host
USB OTG
I2C
SPI
Ethernet
SDHI
HDMI
Audio
Camera(MIPI)
RTC
GPIO
UART
WiFi/BT
 适配中
适配中
USB Host驱动
USB OTG驱动
I2C总线驱动
SPI总线驱动
R8168驱动
eMMC/SD卡存储驱动
LT9611驱动
WCD937x驱动
IMX477摄像头驱动
-
通用GPIO驱动
串口驱动
Qca1023驱动
 是
是
是
是
是
是
是
是
是
是
是
是
是
是
是
文件系统 qcom-multimedia-image 以Yocto构建的全功能镜像 是

SDK目录介绍

源码目录结构
Pi-H1-Linux-SDK/
├── build-qcom-wayland/ # Yocto的构建目录
├── downloads/ # 构建过程中，缓存下载的源码和工具（如开源软件包、内核源码等）
├── layers/ # 为了划分不同的用户自定义的项目工程模块，方便模块化的开发维护
├── quectel_build/ # 移远通信（Quectel）自定义的构建目录和脚本
├── sources/ # 内核源代码目录，存放项目本地开发的源码（非Yocto标准目录）
├── src/ # 存放项目本地开发的源码（非Yocto标准目录）和驱动相关设备树
├── sstate-cache/ # 共享状态缓存，如已编译的工具链、库的缓存
└── setup-environment  # 初始化构建环境的脚本
build-qcom-wayland/介绍
build-qcom-wayland/
├── buildhistory/ # 使能编译日志记录功能时，会生产的目录，包含每个包文件列表、编译依赖图等
├── cache/ # bitbake解析class文件的缓存
├── conf/ # 用户的配置文件
├── tmp-glibc/ # 构建时所有的输出都存放在该目录下
│      ├── cache/ # BitBake解析metedata(包括recipes和config文件)后，将解析的结果缓存在该目录，以提高后续效率
│      ├── deploy/ # 部署文件目录，最终需要的文件（boot、system、image等）都在该目录中
│      │   ├── images/ # 存放boot、system、image等文件
│      │   ├── ipk/ # 存放系统产生的所有ipk类型的安装包
│      │   └── licenses/ # 系统使用的各种软件的许可信息
│      ├── hosttools/
│      ├── log/ # bitbake日志信息
│      ├── pkgdata/
│      ├── sstate-control/ # 状态跟踪文件（OpenEmbedded构建系统将此目录用于共享状态清单文件。共享状态代码使用这些文件来记录由每个状态任务安装的文件，以便在清理recipes或即将安装新版本时可以删除这些文件。当一个任务的文件覆盖另一个任务的文件时，构建系统还使用清单检测并生成警告）
│      ├── stamps/ # 记录BitBake跟踪task执行时间的一些信息
│      ├── sysroots/ # 构建出的根文件系统内容
│      ├── sysroots-components/ # 制作sysroots前需要额外添加的一些组件
│      ├── sysroots-uninative/
│      ├── work/ # 包含和CPU架构相关的工作目录
│      └── work-shared/ # 各个recipes共享的内容，比如gcc工具链、系统库等
├── tmp-qcom-guestvm-glibc/
└── workspace/
layers/介绍
layers/
├── meta-openembedded/ # OpenEmbedded核心元数据的集合，包含大量共享的recipes（如工具链、库、应用等）, 扩展Yocto的软件包支持，提供额外的开源软件
│      │   ├── meta-oe/ # 通用软件
│      │   ├── meta-python/ # Python相关
│      │   └── meta-networking/ # 网络工具
├── meta-qcom/ # 高通（Qualcomm）硬件平台的BSP（Board Support Package）层, 内核、驱动、固件、硬件适配配置（如machine定义）等
├── meta-qcom-distro/ # 用户自定义的发行版（Distribution）配置层, 定制化的发行版策略（如DISTRO配置、镜像recipes、软件包组合等）
├── meta-qcom-hwe/ # 高通硬件增强（Hardware Enablement）相关功能，包含内核补丁、硬件加速支持（如GPU/VPU）、实时性扩展等
├── meta-qcom-qim-product-sdk/ 高通QIM产品的SDK扩展层，产品专用的软件栈、测试工具、示例代码等
├── meta-qt5/ # Qt 5框架的支持层，包含Qt库、工具（如qtcreator）和应用程序的recipes
├── meta-quectel/ # 移远通信（Quectel）模组（如4G/5G模组）的驱动和工具支持
├── meta-rust/ # Rust语言工具链和生态支持，Rust编译器（rustc）、Cargo包管理器和 Rust库
├── meta-security/ # 安全性增强工具和策略，如selinux、apparmor、加密工具（openssl 增强）等
├── meta-selinux/ # SELinux（安全增强Linux）的策略和工具，SELinux策略文件、标签配置等
├── meta-updater/ # 系统OTA（Over-The-Air）更新支持
├── meta-virtualization/ # 虚拟化技术支持（如容器/Docker、KVM）
└── poky/ # Yocto Project的核心层，基础构建系统（BitBake、OpenEmbedded Core）、核心 recipes（如busybox、glibc），提供构建嵌入式Linux系统的最小工具链和框架
quectel_build/介绍
quectel_build/ 构建
├── compile/
│      │   ├── quectel-features-config/        # 自动生成配置文件
│      │   ├── build.sh                         # 构建脚本，构建AP侧环境
│      │   ├── config_parser.py                  # 配置文件解析器
│      │   ├── export_sdk.sh                     # 打包交叉工具链sdk包
│      │   ├── version_parser_auto.py          # 配置文件解析器
│      │   └── version_parser.py                  # 配置文件解析器
├── config/ 定制项目列表
│      │   ├── quectel_project.conf
├── packaged_file/                        # 默认提供BP侧固件，后续更新于此处。
│      │   ├── bootbinaries/ # 系统启动（Boot）相关的二进制文件
│      │   ├── firehose/ # 芯片设备的底层刷机、诊断或固件编程相关，尤其在EDL（Emergency Download Mode）模式下使用
│      │   ├── partition/ # 磁盘分区、设备分区表或固件分区布局相关的文件
├── prebuilt_bpfw/  # 基线默认为将adsp，cdsp镜像编译进AP侧system镜像,下面三个压缩包来源于BP侧编译生成，提供给客户使用，客户特别定制联系移远开发人员。
│      │   ├── QCM6490_bootbinaries.zip
│      │   ├── QCM6490_dspso.zip
│      │   ├── QCM6490_fw.zip
├── QSM565DWFPARL1A01_BP01.001_Linux6.6.38_V01/   # Quectel Pi H1所需镜像文件（整合AP和BP文件）
└── a_key_generation.sh # 一键打包工具，用于整合系统镜像文件，如QSM565DWFPARL1A01_BP01.001_Linux6.6.38_V01
sources/quectel-src/介绍
sources/quectel-src/
├── kernel/ # 内核源码，本地化管理
src/介绍
src/
├── devicetree/ # 存放设备树源文件（DTS/DTSI），用于描述硬件配置（如外设、总线、中断等）
│      │   ├── camera-devicetree # 摄像头模组（如MIPI-CSI接口）的设备树配置，包括传感器型号、I2C地址、时钟配置等
│      │   ├── display-devicetree # 显示相关硬件（如MIPI-DSI屏幕、LVDS接口）的设备树节点，定义分辨率、时序参数（display-timings）、背光控制等
│      │   ├── graphics-devicetree # GPU或显示控制器（如高通Adreno GPU、DPU）的配置，可能涉及内存分配、时钟、电源管理
│      │   ├── video-devicetree # 视频编解码硬件（如VPU）的设备树节点，配置视频输入/输出接口（如HDMI、CSI）
│      │   ├── wlan-devicetree # 无线模块（如Qualcomm WCN6855）的配置，包括PCIe/SDIO接口、射频参数、固件加载路径
└── display-drives/ #存放显示相关的驱动和配套工具，通常包括内核驱动、固件、配置脚本等
│      │   ├── bridge-drivers/ # 桥接芯片驱动（如TI SN65DSI86：MIPI-DSI转LVDS的桥接芯片）
│      │   ├── config/  # 显示系统的配置文件（如色彩校准参数、EDID数据、屏幕旋转设置）
│      │   ├── Documentation/ # 驱动开发文档与硬件手册
│      │   ├── include/  # 头文件（Headers），定义数据结构、寄存器宏和API接口
│      │   ├── msm/ # 高通（Qualcomm MSM平台）专属显示驱动
│      │   ├── rotaror/ # 屏幕旋转/镜像的硬件加速驱动

Git配置更新

检查是否在.gitconfig中配置了标识。

git config --get user.email
git config --get user.name

如果没有在.gitconfig中设置帐户标识，请运行以下命令。

git config --global user.email <Your email ID>
git config --global user.name <"Your Name">

为控制台的输出添加以下UI颜色选项（可选）。

git config --global color.ui auto

添加以下git配置来获取大型存储库并避免不可靠的连接。

git config --global http.postBuffer 1048576000
git config --global http.maxRequestBuffer 1048576000
git config --global http.lowSpeedLimit 0
git config --global http.lowSpeedTime 999999

应用演示

应用场景

结合市面上的热门开发板应用场景调研，包括树莓派、英伟达、香橙派等，整理出不同领域的应用场景。结合Quectel Pi H1特性功能，适合Quectel Pi H1的应用场景开发如下。

音视频（camera）场景

  • 家庭媒体中心
  • 简易人脸识别
  • 拍立得相机
  • B站直播 "点歌台"
  • 猫头鹰[僵尸]探测器

游戏场景

  • Switch游戏机
  • AR智能眼镜
  • 木制LED游戏显示器

办公场景

  • 无线路由器
  • BT下载服务器
  • 文件服务器
  • 私有云网盘
  • 掌上电脑

物联网场景

  • 室内温度监控
  • 智能萌宠喂食机

工业场景

  • 行走的机器狗

AI 场景

  • 图像识别: Quectel宝维塔模型
  • 深度学习/语言模型：deepseek

教育场景

  • 编程教育

Demo示例

Q&A

常见故障

故障现象 排查方向
智能主控板无法开机 1. 电源适配器是否满足5V/5A、9V/3A或PD快充协议；
2. AUTO_POWER_ON排针是否短接
显示无信号/黑屏 1. 显示器输入源是否切换正确；
2. DSI排线/HDMI接口是否插紧
摄像头无法识别 1. 摄像头排线是否按正确方向插入；
2. 排线是否插紧；
网络无连接 1. 网线是否插紧；
2. 路由器是否联网；
3. 智能主控板是否正常获取IP地址

套件维护

  • 配件收纳：套件电源线、显示线、网线等需单独整理，避免弯折损坏接口；摄像头需防潮存放，避免排线氧化。

  • 智能主控板保护：长期不用时需用防尘袋包裹，避免灰尘覆盖芯片；搬运时避免挤压，防止板载元件脱落。

  • 文档与固件更新：通过资源下载获取套件最新规格、系统镜像及驱动更新。

注：若系统彻底无法启动，需重刷官方Debian 13镜像，镜像烧录教程可参考镜像烧录教程

资源获取与开发助力

论坛技术支持

移远开发者论坛是面向物联网开发者的专业平台，可为Quectel Pi H1开发套件使用者提供技术资源查阅、开发难题解答及实战经验交流的一站式支持。

资源更新

资源更新是Quectel Pi H1开发套件资源更新与系统维护的核心资源入口，可为开发者提供全方位支持：不仅能获取套件的系统镜像（如Debian、Linux）、USB驱动等基础更新资源，还提供编译工具链、Ubuntu Docker编译环境等配套工具，助力固件自定义开发与本地升级；下载前建议核对资源版本与套件型号匹配性，确保更新安全稳定。

产品总结

Quectel Pi H1开发套件可高效助力开发者快速构建物联网产品，核心路径清晰：访问移远开发者官网，能获取套件全套技术文档与示例代码，为开发奠定基础；搭配论坛支持可实时解决开发难题，通过资源下载入口保障固件更新与系统稳定；整合官网资源、文档指导与代码参考，能大幅缩短从开发调试到产品落地的周期，加速物联网产品快速构建与迭代。