Image Flashing

2026-01-30

Before flashing images for Quectel Pi H1, please ensure that the Qualcomm_USB_Driver_v1.0.10065.1 driver has been installed. If not installed, you can click here to download and install the driver.

Use QDL Flash Software

Ensure ModemManager Tool is Not Running

  • Prerequisite: If you are using Linux distribution systemd, some Linux distributions may include the ModemManager tool, which allows configuration of mobile broadband. When a device is connected in USB mode, it will be recognized as a Qualcomm modem, and ModemManager will attempt to configure the device. Since this interferes with QDL flashing, ModemManager must be disabled before connecting the device. Please use the following command to disable the ModemManager tool:
sudo systemctl stop ModemManager

Flash Image

Open EMG_DOWNLOAD and power on the module. The module will enter QDL emergency download mode.

Note

If flashing fails, please perform the following steps and retry the flashing process:

  1. Turn off the device power.
  2. Disconnect from Quectel Pi H1.
  3. Restart Quectel Pi H1.

QFIL Image Flashing

If you have QFIL flashing software installed on your computer, you can use it to flash images.

Configure QFIL

Click the menu bar Tools → Configuration, and make the following settings in the configuration window:

  1. In Device Type, select ufs.
  2. In Validation Mode, select 0 - No Validation.
  3. Click OK to save the configuration.

Flashing Steps

1. Select Port

  • Long press the EMG_DOWNLOAD button on Quectel Pi H1 and power Quectel Pi H1 on at the same time.
  • Click the SelectPort button, select the 9008 port, and click OK.

2. Select Build Type

  • In Select Build Type, select Flat Build.

3. Select Programmer File

  • Click the Browse button.
  • Select the prog_firehose_Qcm6490_ddr.elf file.

4. Load XML Configuration Files

  • Click the Load XML button.
  • Select all rawprogram*.xml and patch*.xml files.

5. Start Flashing

  • Click the Download button to start flashing.
  • When the Status area displays Download Succeed, it indicates successful flashing.
  • The system will automatically restart.