安装系统

2026-03-12

在烧录Quectel Pi M1智能主控板镜像前，请确保已安装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 M1切换到下载模式，按住Quectel Pi M1侧边的EMG_DOWNLOAD按键，并给模块上电，模块将进入EDL紧急下载模式。

Linux x64

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

./qdl --storage emmc prog_firehose_ddr.elf rawprogram_unsparse0.xml patch0.xml

注意：若rawprogram_unsparse0.xml文件中存在带erase标签的条目，必须将其删除。该标签用于确保分区区域被擦除，但QDL工具不支持此标签，保留会导致报错。

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

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

Windows x64

转换WinUSB驱动。

需在已安装Qualcomm_USB_Driver_v1.0.10065.1驱动程序的基础上，将设备驱动转换为WinUSB。

请点击该网站Zadig下载转换WinUSB驱动的工具，下载后以管理员方式打开。此时给主控板上电，使其进入紧急下载模式。在Zadig中点击“Options” → “List All Devices”，在下拉菜单中找到“QUS_BULK_CID:041C_SN:3D2E305E”，并在右侧选择“WinUSB”，点击“Replace Driver”即可完成转换。具体操作步骤如下图所示。

转换操作步骤1

转换操作步骤2

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

QDL_Win_x64>QDL.exe prog_firehose_ddr.elf rawprogram_unsparse0.xml patch0.xml

注意：若rawprogram_unsparse0.xml文件中存在带erase标签的条目，必须将其删除。该标签用于确保分区区域被擦除，但QDL工具不支持此标签，保留会导致报错。

烧写成功如下图所示：

备注

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

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

QFIL烧录镜像

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