# 安装系统

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

---

在烧录 **Quectel Pi H1** 智能主控板镜像前，请确保已安装 **Qualcomm_USB_Driver_v1.0.10065.1** 驱动程序。若尚未安装，可 [点此下载和安装](<https://www.quectel.com.cn/wp-content/uploads/2026/08/Qualcomm_USB_Driver_v1.0.10065.1.zip>)。

# QDL烧录镜像

## 关闭ModemManager工具

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

```bash
sudo systemctl stop ModemManager
```

## 下载QDL工具

Linux x64 [点击链接](<https://www.quectel.com.cn/wp-content/uploads/2026/08/QDL_Linux_x64.zip>) 下载

Windows x64 [点击链接](<https://www.quectel.com.cn/wp-content/uploads/2026/08/QDL_Win_x64.zip>) 下载

## 进入EDL模式

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

## Linux x64

1. 解压 **QDL_Linux_x64** 压缩包，在包含固件程序、**rawprogram#.xml**、**patch#.xml** 文件和 **QDL** 二进制文件的目录中打开终端窗口。

2. 使用以下命令在 **QDL_Linux_x64** 目录中运行 **QDL** 可执行文件以进行软件刷新。

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

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

```{image} images/image_AUZCbEYwooWCUExwL5nc1EcmnJd.webp
:width: 1064px
:height: 558px
```

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

```{image} images/image_Xiz8be08IopWtox0UKfcDoLSn0b.webp
:width: 808px
:height: 151px
```

## Windows x64

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

```{image} images/image_Rb9ZbEKnNo8RSZxASttcZkeZn4e.webp
:width: 854px
:height: 751px
```

2. 解压 **QDL_Win_x64** 压缩包，把固件程序和 **rawprogram#.xml**、**patch#.xml** 等文件和 **QDL** 可执行文件放在同一个文件夹。

3. 打开 **CMD** 窗口，使用以下命令在 **QDL_Win_x64** 目录中运行 **QDL** 可执行文件。

```plaintext
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
```

```{image} images/image_TIlbbY60poiPkJxzpA0cU10bn1g.webp
:width: 964px
:height: 161px
```

烧写成功如下图所示：

```{image} images/image_HG4Xb7B4hoSacRxOuPzc3ZSXnie.webp
:width: 964px
:height: 360px
:align: center
```

## 备注

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

1. 关闭设备电源；

2. 断开与 **Quectel Pi H1** 的连接；

3. 重新启动 **Quectel Pi H1**。

# QFIL烧录镜像

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

- 注意，请勿勾选配置中的“**Erase All Before Download**”。

```{image} images/image_OrsOb2Cf2oHpyCxWz6Nckxl5n7e.webp
:width: 800px
:height: 599px
```

1. 点击“**Configuration**”按钮，点击弹出的“**FireHose Configuration**”按钮，选中“**Reset After Download**”选项框，点击“**OK**”按钮。

```{image} images/image_EIppbPmKOohkkLx6qmIc8J7TnQc.webp
:width: 800px
:height: 599px
```

```{image} images/image_Q5PFbDLmkokQFIxlvUBcWnFTnge.webp
:width: 748px
:height: 361px
```

2. 构建类型选择“**Flat Build**”，右下角存储类型选择“**ufs**”。

```{image} images/image_EydMbIj57o0axAxt5v3cKHc9n7g.webp
:width: 800px
:height: 599px
```

3. 按住 **Quectel Pi H1** 的“**EMG_DOWNLOAD**”按键，给设备上电，点击“**SelectPort**”按钮，选择“**Qualcomm HS-USB QDLoader 9008**”端口，点击“**OK**”按钮。

```{image} images/image_HC0MbUR54oD9xQx6HcZcoHornbd.webp
:width: 800px
:height: 599px
```

4. 点击“**Browse**”按钮，选择 **prog_firehose_Qcm6490_ddr.elf** 文件。

```{image} images/image_RetWb2qbooNFguxCPO3c1aoFnEf.webp
:width: 800px
:height: 599px
```

5. 点击“**LoadXML**”按钮，选择所有的 **rawprogram#.xml** 文件和 **patch#.xml** 文件。

```{image} images/image_RZOwbTAuPoCcoYxGynPcY6jAn0c.webp
:width: 800px
:height: 599px
```

6. 点击“**Download**”按钮，当 **Status** 信息框中出现 **Download Succeed** 字样时，则表示烧录成功，系统将自动重启。

```{image} images/image_LFd9bcvUvoBQmfxUyNocEyi8nNh.webp
:width: 800px
:height: 599px
```