Quectel Pi H1 是移远通信推出的基于高通 QCS6490 平台的智能主控板,集成高性能 64 位八核处理器 (高达 12 TOPS 算力)和高通 Adreno™ 643L GPU,支持 Yocto Linux/ Debian/ Ubuntu系统,拥有 8 GB LPDDR4X 存储,采用 USB Type-C 电源接口,可外接 eMMC 和 SSD,支持 Wi-Fi 2.4 & 5 GHz,符合 IEEE 802.11a/ b/ g/ n/ ac 和蓝牙 5.0 协议,支持双显 (DP 和 LCM 或DP 和 Micro HDMI),性能强大,多媒体功能丰富,能够满足客户在工业和消费类应用中对高速率、多媒体功能以及算力的需求。
主要优势
以 Quectel Pi H1开发套件为基础,讲解如何快速入门Quectel Pi H1单板电脑。


• 全套 Quectel Pi H1开发套件(按“套件清单”核对无缺失)。
• 支持 5V/5A、9V/3A 或 PD 快充协议的电源适配器。
• 支持 USB-C DP 或 HDMI 的显示器(分辨率建议 1080P 及以上)。
• USB 键盘+鼠标(有线/无线均可,需接入单板电脑的 USB 口)。
• 可联网的路由器(用于单板电脑联网调试)。
• 硬件使用规范(避免损坏)
° 请使用套件自带的 USB-A 电源线(5A),禁止使用低于 3A 电流的电源(如手机充电器),否则可能导致单板供电不足、频繁死机;若需外接大功率模块(如电机),需单独为模块供电,禁止通过单板 USB 口或 GPIO 口取电(避免过载烧板)。
° 插拔配件(如摄像头排线、网线)时必须先断开单板电源,带电插拔可能烧毁接口芯片;USB & DP 接口仅支持 DP 显示+供电输出,不可给单板电脑供电。
° 工作温度: -20 °C ~ +70 °C,禁止在高温(如阳光直射)、潮湿(湿度>80%)或多尘环境中使用;操作前先触摸金属物体释放静电,避免用手直接接触单板上的芯片引脚。
• 系统与软件注意事项
° 仅支持官方提供的系统镜像,禁止刷入其他单板(如树莓派)的镜像,否则会出现驱动不兼容、无法启动等问题;
° 若需自定义系统,需使用 Yocto Linux SDK 进行开发,确保内核版本、驱动模块与 Quectel Pi H1 匹配。
° 禁止修改 /boot 分区下的核心配置文件(如 config.txt),误修改可能导致系统无法启动(建议修改前备份该文件);
° 安装软件时优先使用 apt 命令从官方源下载,避免安装未知来源的 DEB 包,防止系统中毒或崩溃。
⚠️ 警告:连接过程中请先断开所有电源,避免带电插拔接口导致硬件损坏!
Quectel Pi H1单板电脑出厂默认搭载 Debian 13 系统镜像,因此无需再次烧录镜像。仅需按照如下步骤操作即可:
• 方案1(高清):将 USB-C DP 显示线一端接入单板电脑的 USB&DP 接口,另一端接入显示器的 USB-C 接口。
• 方案2(兼容):将 HDMI 线一端接入单板电脑的 HDMI 接口,另一端接入显示器的 HDMI 接口。

将 USB 键盘、鼠标接入单板电脑的两个 USB-A 接口上;若用无线键鼠,将接收器插入 USB 口即可。

用网线连接单板电脑网口和路由器的 LAN 口即可。

单板电脑左上角标有AUTO_POWER_ON丝印的排针,确保已经用跳线帽短接。

最后将 USB-A 电源线的 USB-A 端接入电源适配器,USB-C 端接入单板电脑的电源口(通常标注POWER IN)。

先将散热器的排线插入单板电脑的FAN插槽中,然后将散热器上的两端固定在单板电脑预留的插孔中。
(注:散热器不包含在开发套件中,推荐使用树莓派5代官方原装散热器)

⚠️ 若前面硬件连接时,没有将标有AUTO_POWER_ON丝印的排针使用跳线帽短接,则需要先长按单板电脑右侧的PWRKEY按钮,再接通电源,直到系统启动。
• 打开显示器电源,确认显示器输入源已切换到对应的接口(如 USB-C 或 HDMI)。
• 接通单板电源(插好电源线),此时单板电脑的电源灯(通常为红色)会常亮,系统灯(通常为绿色)会闪烁,表明系统正在启动。
• 等待约 1-2 分钟,显示器将显示系统登录界面。
登陆用户名及密码设置参考系统登录章节

打开终端(快捷键 Ctrl+Alt+T),输入以下命令更新系统(确保网络已通):
‼️若系统无法正常启动,请重刷系统镜像
- 点击下载 Debian13 镜像下载
- 点此下载和安装 USB 驱动
- 使用符合要求的电源适配器给单板电脑供电
- 将单板电脑的 USB&DP 接口连接到电脑
- 镜像烧录教程
启动完成后,快速验证核心配件是否正常工作:
• 显示验证:确认显示器能清晰显示桌面,拖动窗口无卡顿、无花屏;
• 网络验证:打开浏览器,输入任意网址(如 www.baidu.com/www.google.com),或在终端输入ping 8.8.8.8(测试通外网),若有数据包返回则网络正常;
• USB外设验证:用键盘输入字符、鼠标拖动窗口,确认键鼠响应正常。
• 系统语言:打开设置配置中文显示,设置好后重新登陆即可生效。

• 输入法及键盘布局:使用系统默认配置即可

根据 Wi-Fi 名称输入密码连接。

⚠️使用 USB 串口数据线和单板电脑进行串口登录时,请确保引脚连接正确,接错引脚可能会导致主板硬件损坏。

• 连接方式
° Quectel Pi H1单板电脑 的 GND 引脚连接 USB 串口数据线的 GND 引脚
° Quectel Pi H1单板电脑 的 DBG_TXD 引脚连接 USB 串口数据线的 RXD 引脚
° Quectel Pi H1单板电脑 的 DBG_RXD 引脚连接 USB 串口数据线的 TXD 引脚
• 使用跳线帽在USB转TTL串口小板上选择3.3V电源

前提:系统必须要先安装CH340驱动,要不然无法识别串口。
推荐使用 PuTTY 软件进行串口连接。
1.打开设备管理器查看串口。

2.双击打开PuTTY,配置USB串口并设置波特率为115200,然后点击open。

3.在终端输入系统的用户名和密码进行登陆(终端输入密码不会显示出来,输入完密码按回车登陆)。

4.登陆成功后,即可通过串口查看日志及运行命令进行调试 。
串口控制台主要用于通过串口连接查看系统日志、运行命令进行调试,以及在图形界面不可用时作为系统访问的备用方式。它是嵌入式Linux系统开发和维护的重要工具,特别适用于底层调试和故障排查。
登录到Quectel Pi H1的Debian 系统后,打开终端窗口,输入以下命令并回车,安装必要的开发环境:
sudo apt update && sudo apt installvim gawk gcc g++ build-essential chrpath socat wget diffstat file unzip tar locales zstd debianutils iputils-ping cpio python3 python3-pip net-tools git make cmake
1.在/Desktop目录下创建helloworld.c文件。
2.复制以下代码段,粘贴在helloworld.c文件内:
3.执行以下命令,编译代码:
4.执行以下命令,运行 helloworld 程序:
5.程序运行结果打印:
交叉编译是在一种平台(如 x86 PC)上,生成可以在另一种不同体系结构的平台(如 ARM 嵌入式设备)上运行的可执行程序。
以64位计算机为例,在主机上执行如下步骤:

按下ESC + i,输入下面代码,然后再按下ESC + "shift + : " ,在命令台输入“wq+Enter”保存退出。

编译成功如下所示:

将主机上的编译文件下载到本地,然后在windows控制台通过SCP命令上传编译文件至Quectel Pi H1开发板。

在Quectel Pi H1开发板终端上为编译文件设置权限并执行。

HelloWorld程序主要用于验证开发环境搭建是否成功,通过编写、编译和运行一个简单的C语言程序来测试系统的基本功能,包括编译器、运行时环境等是否正常工作,是嵌入式开发入门的基础实践。
• 设备连接
• 使用指南