Image Flashing

2025-11-28

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.

Using QDL Flash Software

Ensure ModemManager Tool is Not Running

  • Prerequisite: If the current Linux distribution uses systemd, some Linux distributions 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 stop 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.

Notes

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. Device Type select ufs
  2. Validation Mode select 0 - No Validation
  3. Click OK to save the configuration

Flashing Steps

1. Select Port

  • Hold down the EMG_DOWNLOAD button on Quectel Pi H1 and power on the system
  • Click the SelectPort button, select the 9008 port, and click OK

2. Select Build Type

  • 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