安装系统¶

在烧录 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 点击链接下载

Windows x64 点击链接下载

进入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”，则表示刷新成功，如下图所示：

../../../_images/image_I521b4LQrowdwwxDBykc9CiLn7F.webp

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

../../../_images/image_PG8pbL8ZsoAdlkxrZpXcKjI9nIg.webp

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（是）”继续安装。

../../../_images/image_Eb5NbpRxyospP2xw38VcGrS3nRb.webp

解压 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

../../../_images/image_GDY1b8s4xoNYOdxRGuPcs3Wynne.webp

烧写成功如下图所示：

../../../_images/image_MLzmbKMERo2sqlxnbd7cKfajnZ9.webp

备注¶

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

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

QFIL烧录镜像¶

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