System Install

2025-11-26

Before burning the Quectel Pi H1 image, please ensure that you have completed the installation of the Qualcomm USB Driver v1.0.10065.1 driver. If it is not installed, you can click here to download and install the driver.

QDL burning image

Close the ModemManager tool

  • Prerequisite: If the current Linux distribution is systemd, some Linux distributions include the ModemManager tool that allows for configuring 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. Due to this interfering with QDL refresh, ModemManager must be disabled before connecting the device. Please use the following command to stop the ModemManager tool:
sudo systemctl stop ModemManager

Download QDL tool

Linux x64 Click to Download: https://developer.quectel.com/wp-content/uploads/2025/05/QDL_Linux_x64.zip

Windows x64 Click to Download: https://developer.quectel.com/wp-content/uploads/2025/06/QDL_Win_x64.zip

Enter EDL mode

Press and hold the EMG_DOWNLOAD button on the side of Quectel Pi H1, and power on the module. The module will enter EDL emergency download mode.

Linux x64

  1. Extract the QDL_Linux-x64 compressed file and open a terminal window in the directory containing the firmware, rawprogram#.xml、patch#.xml, and QDL binary files.

  2. Use the following command to run the QDL executable file in the QDL_Linux-x64 directory for software refresh.

./qdl --storage ufs prog_firehose_Qcm6490_ddr.elf rawprogram*.xml patch*.xml
  1. If you see "partition 1 is now bootable" on the terminal window, it means the refresh is successful, as shown in the following message:

  1. After successful flashing, running the lsusb command can display device information in the terminal window, as shown below:

Windows x64

  1. Install Microsoft WinUSB

  • Uninstall other drivers for this device. Ensure that no drivers such as Qualcomm USB drivers are installed. You should not see this device under the COM port in the Device Manager. If you see this device under COM port, make sure to select "Delete driver software for this device".

  • Right click on the device (qcm6490-idp) in the Device Manager, then select "Update Drivers", choose "Browse My Computer to Find Driver Software", and when you enter the next page, select "Let me choose from the list of available drivers on my computer". You will see the prompt shown in the figure below to select WinUSB Device. Click Next, a warning will appear, and select Yes to update.

  1. Extract the QDL_Win-x64 compressed file, and put the firmware program together with rawprogram#.xml、patch#.xml and other files, as well as the QDL executable file.

  2. Open the CMD window and use the following command to run the QDL executable file in the QDL_Win-x64 directory.

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

The successful burning is shown in the following figure:

Remarks

If the refresh fails, please follow these steps and retry the refresh process:

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

QFIL burning image

QFIL (Qualcomm Flash Image Loader) is a firmware burning tool officially developed by Qualcomm, mainly used for embedded devices such as smartphones and tablets equipped with Qualcomm chips. Its core function is to flash or write firmware files (such as Bootloader, Recovery, kernel, etc.) into the device through USB connection.

  • Note that the Erase All Before Download option in the configuration cannot be checked.




  1. Click on the Configuration button, click on the FireHose Configuration button that pops up, select the Reset After Download option box, and click the OK button.





  1. Choose Flat Build as the build type and ufs as the storage type in the bottom right corner.




  1. Press and hold the EMG_DOWNLOAD button on Quectel Pi H1, power on the system, click the SelectPort button, select port 9008, and click the OK button.




  1. Click the Browse button and select the prog_firehose_Qcm6490uddr.elf file.




  1. Click the LoadXML button and select all rawprogram#.xml files and patch#.xml files.




  1. Click the Download button. When the words Download Succeed appear in the Status information box, it means that the burning is successful and the system will automatically restart.