System Installation

2026-01-30

Before flashing the image of Quectel Pi H1 Smart Single-Board Computer, please ensure that Qualcomm USB Driver v1.0.10065.1 driver is installed. If it is not installed, you can click here to download and install.

QDL Flashing Image

Disable ModemManager Tool

  • Prerequisite: If you are using a Linux distribution with systemd, and 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. This will interfere with the QDL flashing process. Therefore, 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

For Linux x64, click the link to download: https://developer.quectel.com/wp-content/uploads/2025/05/QDL_Linux_x64.zip

For Windows x64, click the link 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 program, 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 the message "partition 1 is now bootable" in the terminal window, it means the refresh is successful, as shown in the following figure:

  1. After successful flashing, running the lsusb command to see device information in the terminal window, as shown in the following figure:

Windows x64

  1. Install the Microsoft WinUSB driver.

  • Uninstall other drivers for this device (e.g., Qualcomm USB drivers). Open the Device Manager and confirm that the device does not appear under the "Port COM" category. If the device is listed there, ensure you select "Delete the driver software for this device" when uninstalling.

  • Right-click on the device (qcm6490-idp) in the Device Manager and select the following options in sequence:

    • Update driver.
    • Browse my computer for drivers.
    • Let me pick from a list of available drivers on my computer.
    • Select "WinUSB Device" in "Manufacturer", and select "WinUsb Device" in "Model".
    • Click "Next", and when the Update Driver Warning prompt box appears, click "Yes" to proceed with the installation.

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

  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 flashing is shown in the following figure:

Note

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 Flashing Image

QFIL (Qualcomm Flash Image Loader) is an official firmware flashing tool 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 the USB connection.

  • Please note that the "Erase All Before Download" option in the configuration cannot be ticked.




  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 device, click the "SelectPort" button, select port Qualcomm HS-USB QDLoader 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 flashing is successful and the system will automatically restart.