# 导读

***Copyright © Quectel Wireless Solutions Co., Ltd. 2026. All rights reserved.***

---

# 文档说明

本文档介绍Quectel Pi H1智能主控板的软硬件开发，涵盖从开箱上电到应用开发的完整流程。内容按照开发流程循序组织，既便于新手入门，也便于有经验的开发者按需查阅。

# 架构总览

本文档包含八个主要模块，结构如下：

- 快速上手：面向新手的入门模块，包含硬件认知、系统首次启动、Linux基础快速入门、第一个硬件项目，以及通用的开发指引。

- 使用指南：介绍网络端口服务控制、设备连接方式，以及摄像头等外设的使用方法。

- 支持配件：列出Quectel Pi H1智能主控板对外设与配件的适配支持情况。

- 操作系统：介绍Debian和Yocto Linux系统镜像的获取、烧录与应用开发等相关内容。

- 应用开发：介绍使用Python和C进行GPIO开发、使用Qt和wx开发图形界面，以及开源项目和常用工具。

- 边缘计算：针对Quectel Pi H1智能主控板的NPU硬件加速单元，提供模型部署、推理计算等指南。

- 支持清单：列出开发调试工具、核心驱动和多媒体组件等的支持情况。

- FAQ：汇总常见问题及排查方法，遇到问题时可优先查阅。

# 阅读与使用建议

为提高阅读效率，建议根据您的经验和目标选择阅读路径：

- 如果您是新手，或初次接触Quectel Pi H1智能主控板：  
建议从【快速上手】开始，依次阅读“认识Quectel Pi H1智能主控板”和“首次启动”，完成Quectel Pi H1智能主控板启动、网络连接，并运行第一个Hello World程序。

- 如果您有一定Linux使用经验：  
可跳过【快速上手】中的“Debian快速入门”，直接阅读“进阶开发指引”。

- 如果您关注智能应用：  
完成【快速上手】中的基础环境搭建后，重点阅读【NPU应用】，了解模型部署方法和示例代码。

- 如果您在开发中遇到具体问题：  
优先查阅【FAQ】和【组件和驱动支持清单】，查找硬件兼容性问题和底层错误的处理方法。

# 获取帮助

如果在阅读或操作过程中遇到问题，可以前往 [移远开发者论坛](<https://forumschinese.quectel.com/c/quectel-pi/58>) 获取技术支持。