Use the Qualcomm Device Loader (QDL) command-line tool to flash Ubuntu onto the IQ-9075 EVK from Ubuntu, Windows, or macOS hosts.
Qualcomm Device Loader (QDL) is a cross-platform command-line flashing tool for Qualcomm devices. Use this method when you need full control over the flash process, are running in a headless environment, or want to script automated flashing.For a GUI-based alternative, see Flash Ubuntu using Qualcomm Launcher.
Flashing erases all data on the device. Back up anything important before you begin.
What you need
IQ-9075 EVK with 12 V power supply
USB Type-C cable (USB0 port on the EVK → host computer)
We recommend extracting the image folder and QDL into the same parent folder. This keeps all paths under one root.
Set up QDL driver
Ubuntu requires a udev rule so the kernel grants your user permission to communicate with the device when it enters EDL mode.
Check whether the rule already exists:
ls /etc/udev/rules.d/51-qcom-usb.rules
If the file is not present, create it in one command:
echo 'SUBSYSTEMS=="usb", ATTRS{idVendor}=="05c6", ATTRS{idProduct}=="9008", MODE="0664", GROUP="plugdev"' | sudo tee /etc/udev/rules.d/51-qcom-usb.rules
If the file already exists, verify the rule is present:
cat /etc/udev/rules.d/51-qcom-usb.rules
Reload udev to apply the rule:
sudo systemctl restart udev
If the USB cable was already connected, disconnect and reconnect it.
Set up QDL path
Make QDL executable:
chmod +x <qdl_dir>/qdl
Verify QDL is working:
<qdl_dir>/qdl --help
You should see the QDL usage output. If you get an error, check the path.
Put the device in EDL mode
Turn on the SW2-3 DIP switch — push it up.
Connect the 12 V power supply to the EVK.
Connect the USB Type-C cable from USB0 on the EVK to your host.
Toggle the power switch to turn on the device.
Confirm the device is in EDL mode:
lsusb
Expected output:
Bus 002 Device 014: ID 05c6:9008 Qualcomm, Inc. Gobi Wireless Modem (QDL mode)
If the device doesn’t appear, recheck SW2-3 and the USB-C cable.
Provision UFS
UFS (Universal Flash Storage) provisioning divides the internal storage into separate logical unit numbers (LUNs). This step is required when switching from Qualcomm Linux to Ubuntu.Run UFS provisioning if any of the following apply:
This is a brand-new board that has never been flashed.
You are upgrading to a new image version.
You are switching distributions (Qualcomm Linux ↔ Ubuntu).
Provision UFS from the unzipped provision directory:
cd provision<qdl_dir>/qdl --storage ufs prog_firehose_ddr.elf provision_1_2.xml
Expected output:
UFS provisioning succeeded
After UFS provisioning completes, the device disconnects from USB. Toggle the power switch off and on to reboot it back into EDL mode before continuing.
Flash CDT
CDT provides platform-dependent data used by drivers and firmware to initialize the platform correctly.
After CDT flashing completes, the device disconnects from USB. Toggle the power switch off and on to reboot it back into EDL mode before continuing.
Flash SAIL firmware
The Safety Island (SAIL) is a separate, isolated processor that handles safety-critical functions independently from the main application processor. Its firmware lives on a dedicated spinor flash partition.
Navigate to the sail_nor subfolder inside the image folder:
@echo onsetlocal EnableExtensions EnableDelayedExpansionset "FLAVOR=server"set "OUT_DIR_NAME=IQ9075_ubuntu_images"set "SCRIPT_ROOT=%CD%"set "WORK_DIR=%SCRIPT_ROOT%\iq9075_flash_prep_work"set "OUT_DIR=%SCRIPT_ROOT%\%OUT_DIR_NAME%"set "CURL_FLAGS=--ssl-no-revoke -L --fail --retry 3 --retry-delay 2"if not "%~1"=="" ( if /I "%~1"=="server" set "FLAVOR=server" if /I "%~1"=="desktop" set "FLAVOR=desktop")set "CANONICAL_BASE=https://people.canonical.com/~platform/images/qualcomm-iot/ubuntu-24.04/ubuntu-24.04-x15"set "SERVER_DIR=%CANONICAL_BASE%/ubuntu-server-24.04"set "DESKTOP_DIR=%CANONICAL_BASE%/ubuntu-desktop-24.04"set "SERVER_IMG_XZ=ubuntu-24.04-preinstalled-server-arm64+dragonwing-x15-20260925.img.xz"set "DESKTOP_IMG_XZ=ubuntu-24.04-preinstalled-desktop-arm64+dragonwing-x15-20260925.img.xz"set "BOOT_FW_URL=https://artifacts.codelinaro.org/artifactory/qli-ci/flashable-binaries/ubuntu-fw/QCS9100/QLI.1.8-Ver.1.1/QLI.1.8-Ver.1.1-ubuntu-QCS9100-nhlos-bins.tar.gz"set "BOOT_FW_TAR=QLI.1.8-Ver.1.1-ubuntu-QCS9100-nhlos-bins.tar.gz"if /I "%FLAVOR%"=="server" ( set "BASE_DIR=%SERVER_DIR%" & set "IMG_XZ=%SERVER_IMG_XZ%") else ( set "BASE_DIR=%DESKTOP_DIR%" & set "IMG_XZ=%DESKTOP_IMG_XZ%")set "IMG_URL=%BASE_DIR%/%IMG_XZ%"set "DTB_URL=%BASE_DIR%/dtb.bin"set "RAWPROGRAM_URL=%BASE_DIR%/rawprogram0.xml"where curl >nul 2>&1 || (echo ERROR: curl.exe not found & goto :FAIL)where tar >nul 2>&1 || (echo ERROR: tar.exe not found & goto :FAIL)where robocopy >nul 2>&1 || (echo ERROR: robocopy not found & goto :FAIL)set "SEVENZIP="if exist "%ProgramFiles%\7-Zip\7z.exe" set "SEVENZIP=%ProgramFiles%\7-Zip\7z.exe"if exist "%ProgramFiles(x86)%\7-Zip\7z.exe" set "SEVENZIP=%ProgramFiles(x86)%\7-Zip\7z.exe"if not exist "%WORK_DIR%" mkdir "%WORK_DIR%"if not exist "%OUT_DIR%" mkdir "%OUT_DIR%"pushd "%WORK_DIR%"curl %CURL_FLAGS% -o "%IMG_XZ%" "%IMG_URL%"if errorlevel 1 (echo ERROR: download system image failed & popd & goto :FAIL)set "IMG=%IMG_XZ:.xz=%"if defined SEVENZIP ( "%SEVENZIP%" x -y "%IMG_XZ%") else ( tar -xf "%IMG_XZ%" if errorlevel 1 (echo ERROR: tar could not extract .xz; install 7-Zip and rerun & popd & goto :FAIL))if not exist "%IMG%" (echo ERROR: expected image not found & popd & goto :FAIL)curl %CURL_FLAGS% -o "dtb.bin" "%DTB_URL%"if errorlevel 1 (echo ERROR: download dtb.bin failed & popd & goto :FAIL)curl %CURL_FLAGS% -o "rawprogram0.xml" "%RAWPROGRAM_URL%"if errorlevel 1 (echo ERROR: download rawprogram0.xml failed & popd & goto :FAIL)curl %CURL_FLAGS% -o "%BOOT_FW_TAR%" "%BOOT_FW_URL%"if errorlevel 1 (echo ERROR: download boot firmware failed & popd & goto :FAIL)findstr /I /M "<html" "%BOOT_FW_TAR%" >nul 2>&1if not errorlevel 1 (echo ERROR: boot firmware is HTML, not tar.gz & popd & goto :FAIL)set "BOOT_EXTRACT=%WORK_DIR%\boot_fw_extract"if exist "%BOOT_EXTRACT%" rmdir /S /Q "%BOOT_EXTRACT%"mkdir "%BOOT_EXTRACT%"tar -xf "%BOOT_FW_TAR%" -C "%BOOT_EXTRACT%"if errorlevel 1 (echo ERROR: extract boot firmware failed & popd & goto :FAIL)set "TOPDIR=" & set "DIRCOUNT=0"for /f "delims=" %%D in ('dir /b /ad "%BOOT_EXTRACT%"') do ( set /a DIRCOUNT+=1 if "!DIRCOUNT!"=="1" set "TOPDIR=%BOOT_EXTRACT%\%%D")if "%DIRCOUNT%"=="1" ( robocopy "%TOPDIR%" "%OUT_DIR%" /E /COPY:DAT /R:2 /W:2) else ( robocopy "%BOOT_EXTRACT%" "%OUT_DIR%" /E /COPY:DAT /R:2 /W:2)if %errorlevel% GEQ 8 (echo ERROR: robocopy failed & popd & goto :FAIL)copy /Y "dtb.bin" "%OUT_DIR%\" & copy /Y "rawprogram0.xml" "%OUT_DIR%\" & copy /Y "%IMG%" "%OUT_DIR%\"popdecho SUCCESS. Flashable folder ready: %OUT_DIR%dir "%OUT_DIR%" /A:-Dpauseexit /b 0:FAILecho FAILED. Check messages above.pauseexit /b 1
Download QDL
Download the QDL tool for Windows and extract it. The extracted folder contains qdl.exe — referred to as <qdl_dir> below.
We recommend extracting the image folder and QDL into the same parent folder (for example C:\Users\you\Downloads\qualcomm-flash\). This keeps all paths under one root.
Set up QDL driver
Uninstall any existing Qualcomm USB drivers (QUD) — they conflict with the QDL driver. Open Device Manager, find your device, and uninstall any existing drivers. The device should not appear under COM Ports.
Run install_driver.bat from the unzipped QDL folder to install the WinUSB driver.
Put the device in EDL mode
Turn on the SW2-3 DIP switch — push it up.
Connect the 12 V power supply to the EVK.
Connect the USB Type-C cable from USB0 on the EVK to your host.
Toggle the power switch to turn on the device.
Open Device Manager and confirm a Qualcomm USB device appears (not under COM Ports).
Provision UFS
UFS (Universal Flash Storage) provisioning divides the internal storage into separate logical unit numbers (LUNs). This step is required when switching from Qualcomm Linux to Ubuntu.Run UFS provisioning if any of the following apply:
This is a brand-new board that has never been flashed.
You are upgrading to a new image version.
You are switching distributions (Qualcomm Linux ↔ Ubuntu).
After UFS provisioning completes, the device disconnects from USB. Toggle the power switch off and on to reboot it back into EDL mode before continuing.
Flash CDT
CDT provides platform-dependent data used by drivers and firmware to initialize the platform correctly.
After CDT flashing completes, the device disconnects from USB. Toggle the power switch off and on to reboot it back into EDL mode before continuing.
Flash SAIL firmware
The Safety Island (SAIL) is a separate, isolated processor that handles safety-critical functions independently from the main application processor. Its firmware lives on a dedicated spinor flash partition.
Navigate to the sail_nor subfolder inside the image folder:
Download the prebuilt Ubuntu image and boot firmware from the Canonical Ubuntu site.
Always verify the latest build availability on the Canonical Ubuntu website. The links below are pinned to the latest validated release.
Run the following script to download and assemble the flashable image folder. Pass --server or --desktop depending on the image you want:
./prepare_iq9075_ubuntu_flashable.sh --server
./prepare_iq9075_ubuntu_flashable.sh --desktop
This generates the flashable images in iq9075_flash_prep_work/IQ9075_ubuntu_images — referred to as <path-to-image> below. See the Ubuntu tab for the full script.
Download QDL
Download the QDL tool for macOS (Apple Silicon) and unzip it. The unzipped folder contains the qdl binary — referred to as <qdl_dir> below.
We recommend extracting the image folder and QDL into the same parent folder. This keeps all paths under one root.
Set up QDL path
Install required libraries via Homebrew (skip if already installed):
brew install libusb libxml2
Make QDL executable and clear the macOS quarantine flag so Gatekeeper allows it to run:
sudo is needed because some bundled libraries are read-only. If macOS still blocks the tool after this step, allow it under System Settings → Privacy & Security.
Verify QDL is working:
<qdl_dir>/qdl --help
You should see the QDL usage output. If you get an error, check the path.
Put the device in EDL mode
Turn on the SW2-3 DIP switch — push it up.
Connect the 12 V power supply to the EVK.
Connect the USB Type-C cable from USB0 on the EVK to your host.
Product ID: 0x9008 confirms the device is in EDL mode. If it doesn’t appear, recheck SW2-3 and the USB-C cable.
Provision UFS
UFS (Universal Flash Storage) provisioning divides the internal storage into separate logical unit numbers (LUNs). This step is required when switching from Qualcomm Linux to Ubuntu.Run UFS provisioning if any of the following apply:
This is a brand-new board that has never been flashed.
You are upgrading to a new image version.
You are switching distributions (Qualcomm Linux ↔ Ubuntu).
Move the provision files and the QDL binary into the same folder, then run from there:
On macOS, the qdl binary and its supporting libraries must be in the same directory as the provision files. Copy the provision files into <qdl_dir>, then run the command from there.
After UFS provisioning completes, the device disconnects from USB. Toggle the power switch off and on to reboot it back into EDL mode before continuing.
Flash CDT
CDT provides platform-dependent data used by drivers and firmware to initialize the platform correctly.
After CDT flashing completes, the device disconnects from USB. Toggle the power switch off and on to reboot it back into EDL mode before continuing.
Flash SAIL firmware
The Safety Island (SAIL) is a separate, isolated processor that handles safety-critical functions independently from the main application processor. Its firmware lives on a dedicated spinor flash partition.
Navigate to the sail_nor subfolder inside the image folder: