# 导读

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

---

# 文档简介

本文档是一份针对 **Quectel PI M1/L1** 智能主控板的全栈式软硬件开发手册。旨在协助不同基础的开发者，快速完成从“开箱上电”到“应用程序开发落地”的整个过程。本文档按照开发流程的逻辑层层递进，兼顾新手的上手需求与进阶开发者的功能查阅需求。

# 文档架构总览

本文档共分为八个核心模块，您可以先对整个结构建立初步认知：

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

- 使用指南：关于网络端口服务控制、设备连接方法、摄像头等多类外设的详细说明。

- 支持配件：列出主控板可适配的外设、配件支持情况。

- 操作系统：包含Debian、Yocto Linux、Android系统的镜像获取、烧录、应用开发等相关内容。

- 应用开发：面向应用层的开发指南，涵盖 Python/C GPIO开发、Qt/wx 图形界面的开发、开源项目以及一些工具的使用等。

- 边缘计算：针对Quectel Pi M1/L1的硬件加速单元，提供模型部署、推理计算等相关应用开发指南。

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

- FAQ：汇总收集的常见问题及故障排查解决方案，遇到报错可优先查阅此处。

# 阅读与使用建议

为了帮您节省时间，强烈建议根据您的自身情况选择阅读路径：

- 如果你是纯新手 / 刚拿到开发板：  
请务必从【快速上手】部分开始阅读。按顺序完成“认识你的Quectel Pi M1/L1智能主控板”、“首次启动”，跟着教程一步步点亮开发板、连上网络并运行第一个 Hello World。

- 如果你有一定 Linux 使用经验：  
【快速上手】中的 “Debian 快速入门”章节可以直接跳过。您可直接查看该章节下的“开发指引”，直达应用开发环节。

- 如果你关注智能应用：  
完成【快速上手】的基础环境搭建后，请重点关注 【边缘计算】 章节，这里提供了模型部署的具体应用方法和代码样例。

- 如果你在开发中遇到具体问题：  
优先查阅 【FAQ】 和 【组件和驱动支持清单】，这里通常能解决大部分硬件兼容或底层报错问题。

# 获取帮助

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