安装系统

2026-01-30

在烧录Quectel Pi H1智能主控板镜像前，请确保已安装 Qualcomm_USB_Driver_v1.0.10065.1 驱动程序。若尚未安装，可点此下载和安装。

QDL烧录镜像

关闭ModemManager工具

前提条件：如果您使用的Linux发行版采用systemd，部分发行版包含ModemManager工具，该工具用于配置移动宽带。当设备以USB模式连接时，会被识别为高通调制解调器，ModemManager会尝试对其进行配置，这会干扰QDL刷机过程。因此，必须在连接设备前禁用ModemManager。请使用以下命令停止ModemManager工具：

sudo systemctl stop ModemManager

下载QDL工具

Linux x64 点击链接下载：https://developer.quectel.com/wp-content/uploads/2025/05/QDL_Linux_x64.zip

Windows x64 点击链接下载：https://developer.quectel.com/wp-content/uploads/2025/06/QDL_Win_x64.zip

进入EDL模式

按住Quectel Pi H1侧边的EMG_DOWNLOAD按键，并给模块上电，模块将进入EDL紧急下载模式。

Linux x64

解压QDL_Linux_x64压缩包，在包含固件程序、rawprogram#.xml、patch#.xml文件和QDL二进制文件的目录中打开终端窗口。
使用以下命令在QDL_Linux_x64目录中运行QDL可执行文件以进行软件刷新。

./qdl --storage ufs prog_firehose_Qcm6490_ddr.elf rawprogram*.xml patch*.xml

如果在终端窗口上看到 "partition 1 is now bootable"，则表示刷新成功，如下图所示：

刷机成功后，运行lsusb命令可以在终端窗口看到设备信息，如下图所示：

Windows x64

安装Microsoft WinUSB驱动。

卸载该设备的其他驱动程序（例如高通 USB 驱动程序）。打开设备管理器，确认设备未出现在“COM 端口”类别下。如果设备已出现在“COM 端口”类别中，请确保选中“删除此设备的驱动程序软件”。
在设备管理器中右键点击该设备（qcm6490-idp），依次点击：
- Update driver（更新驱动程序）
- Browse my computer for drivers（浏览我的计算机以查找驱动程序软件）
- Let me pick from a list of available drivers on my computer（从计算机上的可用驱动程序列表中选取）
- 在“Manufacturer”中选择“WinUsb Device”，在“Model”中选择“WinUsb Device”，与下图界面一致；
- 点击“Next（下一步）”，弹出Update Driver Warning提示框时，点击“Yes（是）”继续安装。

解压QDL_Win_x64压缩包，把固件程序和 rawprogram#.xml、patch#.xml等文件和QDL可执行文件放在同一个文件夹。
打开CMD窗口，使用以下命令在QDL_Win_x64目录中运行QDL可执行文件。

QDL_Win_x64>QDL.exe prog_firehose_Qcm6490_ddr.elf rawprogram0.xml rawprogram1.xml rawprogram2.xml rawprogram3.xml rawprogram4.xml rawprogram5.xml patch0.xml patch1.xml patch2.xml patch3.xml patch4.xml patch5.xml

烧写成功如下图所示：

备注

如果刷新失败，请执行以下步骤并重试刷新过程：

关闭设备电源；
断开与Quectel Pi H1的连接；
重新启动Quectel Pi H1。

QFIL烧录镜像

QFIL（Qualcomm Flash Image Loader）是一款由高通（Qualcomm）官方开发的固件烧录工具，主要用于搭载高通芯片的智能手机、平板电脑等嵌入式设备。它的核心功能是通过USB连接，将固件文件（如Bootloader、Recovery、内核等）刷入或写入设备。