Flash Ubuntu using QDL - Qualcomm Dragonwing Documentation

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-8275 EVK with 12 V power supply
USB Type-C cable (USB0 port on the EVK → host computer)
Host computer running Ubuntu, Windows, or macOS

Select your host OS and follow the complete path

Download QDL for your host OS from the Qualcomm Software Center.

Ubuntu
Windows
macOS

Download the Ubuntu image

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_iq8275_ubuntu_flashable.sh --server

./prepare_iq8275_ubuntu_flashable.sh --desktop

This generates the flashable images in iq8275_flash_prep_work/IQ8275_ubuntu_images — referred to as <path-to-image> below.

To update to a new Canonical release, edit CANONICAL_BASE, SERVER_IMG_XZ, DESKTOP_IMG_XZ, and BOOT_FW_URL_DEFAULT in the script.

prepare_iq8275_ubuntu_flashable.sh (full script)

#!/usr/bin/env bash
set -euo pipefail

FLAVOR="${FLAVOR:-server}"     # server | desktop
OUT_DIR="${OUT_DIR:-IQ8275_ubuntu_images}"
WORK_DIR="${WORK_DIR:-$PWD/iq8275_flash_prep_work}"

CANONICAL_BASE="https://people.canonical.com/~platform/images/qualcomm-iot/ubuntu-24.04/ubuntu-24.04-x08"
SERVER_DIR="${CANONICAL_BASE}/ubuntu-server-24.04"
DESKTOP_DIR="${CANONICAL_BASE}/ubuntu-desktop-24.04"

SERVER_IMG_XZ="iot-qualcomm-dragonwing-classic-server-2404-x08-20260210.4096b.img.xz"
DESKTOP_IMG_XZ="iot-qualcomm-dragonwing-classic-desktop-2404-x08-20260210.4096b.img.xz"

BOOT_FW_URL_DEFAULT="https://artifacts.codelinaro.org/artifactory/qli-ci/flashable-binaries/ubuntu-fw/QCS8300/QLI.1.7-Ver.1.1/QLI.1.7-Ver.1.1-ubuntu-QCS8300-nhlos-bins.tar.gz"
BOOT_FW_URL="${BOOT_FW_URL:-$BOOT_FW_URL_DEFAULT}"

usage() {
  cat <<EOF
Usage: $(basename "$0") [--server|--desktop] [--out <folder>] [--work <folder>]

Examples:
  ./prepare_iq8275_ubuntu_flashable.sh --server
  ./prepare_iq8275_ubuntu_flashable.sh --desktop --out IQ8275_ubuntu_images_desktop

Environment overrides:
  FLAVOR=server|desktop
  OUT_DIR=...
  WORK_DIR=...
  BOOT_FW_URL=...
EOF
}

while [[ $# -gt 0 ]]; do
  case "$1" in
    --server)  FLAVOR="server"; shift ;;
    --desktop) FLAVOR="desktop"; shift ;;
    --out)     OUT_DIR="$2"; shift 2 ;;
    --work)    WORK_DIR="$2"; shift 2 ;;
    -h|--help) usage; exit 0 ;;
    *) echo "Unknown option: $1"; usage; exit 1 ;;
  esac
done

need_cmd() { command -v "$1" >/dev/null 2>&1 || { echo "ERROR: missing '$1'"; exit 1; }; }
need_cmd curl; need_cmd tar; need_cmd unxz; need_cmd file
need_cmd find; need_cmd cp; need_cmd head; need_cmd ls; need_cmd mkdir; need_cmd rm

download() {
  local url="$1" dst="$2"
  echo "Downloading: $url"
  curl -L --fail --retry 3 --retry-delay 2 -o "$dst" "$url"
}

mkdir -p "$WORK_DIR" "$OUT_DIR"
cd "$WORK_DIR"

if [[ "$FLAVOR" == "server" ]]; then
  BASE_DIR="$SERVER_DIR"; IMG_XZ="$SERVER_IMG_XZ"
elif [[ "$FLAVOR" == "desktop" ]]; then
  BASE_DIR="$DESKTOP_DIR"; IMG_XZ="$DESKTOP_IMG_XZ"
else
  echo "ERROR: FLAVOR must be 'server' or 'desktop'"; exit 1
fi

IMG_URL="${BASE_DIR}/${IMG_XZ}"
DTB_URL="${BASE_DIR}/dtb.bin"
RAWPROGRAM_URL="${BASE_DIR}/rawprogram0.xml"

download "$IMG_URL" "$IMG_XZ"
echo "Extracting OS image: $IMG_XZ"
unxz -f "$IMG_XZ"
IMG="${IMG_XZ%.xz}"

download "$DTB_URL" "dtb.bin"
download "$RAWPROGRAM_URL" "rawprogram0.xml"

BOOT_FW_TAR="$(basename "$BOOT_FW_URL")"
download "$BOOT_FW_URL" "$BOOT_FW_TAR"

if file "$BOOT_FW_TAR" | grep -qi "HTML"; then
  echo "ERROR: Boot firmware download is HTML, not a tar.gz. Use the direct /artifactory/ endpoint."; exit 1
fi

if ! tar -tzf "$BOOT_FW_TAR" >/dev/null 2>&1; then
  echo "ERROR: Boot firmware is not a valid gzip tarball."; exit 1
fi

BOOT_FW_EXTRACT_DIR="$WORK_DIR/boot_fw_extract"
rm -rf "$BOOT_FW_EXTRACT_DIR"; mkdir -p "$BOOT_FW_EXTRACT_DIR"
tar -xzf "$BOOT_FW_TAR" -C "$BOOT_FW_EXTRACT_DIR"

mapfile -t TOP_LEVEL_DIRS < <(find "$BOOT_FW_EXTRACT_DIR" -mindepth 1 -maxdepth 1 -type d)
TOP_DIR="${#TOP_LEVEL_DIRS[@]}" && [[ ${#TOP_LEVEL_DIRS[@]} -eq 1 ]] && TOP_DIR="${TOP_LEVEL_DIRS[0]}" || TOP_DIR="$BOOT_FW_EXTRACT_DIR"
cp -a "$TOP_DIR"/. "$OUT_DIR"/
cp -a "dtb.bin" "$OUT_DIR"/ && cp -a "rawprogram0.xml" "$OUT_DIR"/ && cp -a "$IMG" "$OUT_DIR"/

echo "✅ Flashable folder ready: $(realpath "$OUT_DIR")"
ls -lh "$OUT_DIR" | sed -n '1,200p'

Download QDL

Download the QDL tool for Linux (x64) and unzip it. The unzipped folder contains the qdl binary — referred to as <qdl_dir> below.
Install the required libraries (skip if already installed):
sudo apt-get install libxml2-dev libudev-dev libusb-1.0-0-dev
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).

Download and unzip the provision file:

wget https://artifacts.codelinaro.org/artifactory/codelinaro-le/Qualcomm_Linux/QCS8300/provision.zip
unzip provision.zip

Provision UFS from the unzipped provision directory:

cd provision
<qdl_dir>/qdl --storage ufs prog_firehose_ddr.elf provision_1_3.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.

Download and unzip the CDT file:

wget https://artifacts.codelinaro.org/artifactory/codelinaro-le/Qualcomm_Linux/QCS8300/cdt/qcs8275-iq-8275-evk-pro-sku.zip
unzip qcs8275-iq-8275-evk-pro-sku.zip

Flash CDT from the unzipped directory:

<qdl_dir>/qdl prog_firehose_ddr.elf rawprogram3.xml patch3.xml

Expected output:

flashed "cdt" successfully
13 patches applied

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:
cd <path-to-image>/sail_nor

Flash the SAIL firmware:

<qdl_dir>/qdl --storage spinor prog_firehose_ddr.elf rawprogram0.xml patch0.xml

Expected output:

flashed "SAIL_HYP" successfully
flashed "SAIL_SW1" successfully
flashed "SAIL_HYP_BKUP" successfully
flashed "SAIL_SW1_BKUP" successfully
11 patches applied

Flash Ubuntu

Navigate to the main image folder:
cd <path-to-image>

Flash the image:

<qdl_dir>/qdl prog_firehose_ddr.elf rawprogram0.xml rawprogram1.xml rawprogram2.xml rawprogram3.xml rawprogram4.xml patch1.xml patch2.xml patch3.xml patch4.xml

The flash is complete when the final line reads:

partition 1 is now bootable

Download the Ubuntu image

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 as an argument:

prepare_iq8275_windows_flashable.bat server

prepare_iq8275_windows_flashable.bat desktop

This generates the flashable images in IQ8275_ubuntu_images — referred to as <path-to-image> below.

To update to a new Canonical release, edit CANONICAL_BASE, SERVER_IMG_XZ, DESKTOP_IMG_XZ, and BOOT_FW_URL in the script.

prepare_iq8275_windows_flashable.bat (full script)

@echo on
setlocal EnableExtensions EnableDelayedExpansion

set "FLAVOR=server"
set "OUT_DIR_NAME=IQ8275_ubuntu_images"
set "SCRIPT_ROOT=%CD%"
set "WORK_DIR=%SCRIPT_ROOT%\iq8275_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-x08"
set "SERVER_DIR=%CANONICAL_BASE%/ubuntu-server-24.04"
set "DESKTOP_DIR=%CANONICAL_BASE%/ubuntu-desktop-24.04"

set "SERVER_IMG_XZ=iot-qualcomm-dragonwing-classic-server-2404-x08-20260210.4096b.img.xz"
set "DESKTOP_IMG_XZ=iot-qualcomm-dragonwing-classic-desktop-2404-x08-20260210.4096b.img.xz"

set "BOOT_FW_URL=https://artifacts.codelinaro.org/artifactory/qli-ci/flashable-binaries/ubuntu-fw/QCS8300/QLI.1.7-Ver.1.1/QLI.1.7-Ver.1.1-ubuntu-QCS8300-nhlos-bins.tar.gz"
set "BOOT_FW_TAR=QLI.1.7-Ver.1.1-ubuntu-QCS8300-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>&1
if 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%\"
popd

echo SUCCESS. Flashable folder ready: %OUT_DIR%
dir "%OUT_DIR%" /A:-D
pause
exit /b 0

:FAIL
echo FAILED. Check messages above.
pause
exit /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

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).

Download provision.zip and extract it.

Navigate to the extracted provision folder and provision UFS: Command Prompt:

"<qdl_dir>\qdl.exe" --storage ufs prog_firehose_ddr.elf provision_1_3.xml

PowerShell:

& "<qdl_dir>\qdl.exe" --storage ufs prog_firehose_ddr.elf provision_1_3.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.

Download IQ8275 CDT and extract it.

Flash CDT from the extracted directory: Command Prompt:

"<qdl_dir>\qdl.exe" prog_firehose_ddr.elf rawprogram3.xml patch3.xml

PowerShell:

& "<qdl_dir>\qdl.exe" prog_firehose_ddr.elf rawprogram3.xml patch3.xml

Expected output:

flashed "cdt" successfully
13 patches applied

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

Navigate to the sail_nor subfolder inside the image folder:
cd <path-to-image>\sail_nor

Flash the SAIL firmware: Command Prompt:

"<qdl_dir>\qdl.exe" --storage spinor prog_firehose_ddr.elf rawprogram0.xml patch0.xml

PowerShell:

& "<qdl_dir>\qdl.exe" --storage spinor prog_firehose_ddr.elf rawprogram0.xml patch0.xml

Expected output:

flashed "SAIL_HYP" successfully
flashed "SAIL_SW1" successfully
flashed "SAIL_HYP_BKUP" successfully
flashed "SAIL_SW1_BKUP" successfully
11 patches applied

Flash Ubuntu

Navigate to the main image folder:
cd <path-to-image>

Flash the image (Windows does not support wildcards — list all files explicitly): Command Prompt:

"<qdl_dir>\qdl.exe" prog_firehose_ddr.elf rawprogram0.xml rawprogram1.xml rawprogram2.xml rawprogram3.xml rawprogram4.xml patch1.xml patch2.xml patch3.xml patch4.xml

PowerShell:

& "<qdl_dir>\qdl.exe" prog_firehose_ddr.elf rawprogram0.xml rawprogram1.xml rawprogram2.xml rawprogram3.xml rawprogram4.xml patch1.xml patch2.xml patch3.xml patch4.xml

The flash is complete when the final line reads:

partition 1 is now bootable

Download the Ubuntu image

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_iq8275_ubuntu_flashable.sh --server
./prepare_iq8275_ubuntu_flashable.sh --desktop
This generates the flashable images in iq8275_flash_prep_work/IQ8275_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:
chmod +x <qdl_dir>/qdl sudo xattr -dr com.apple.quarantine <qdl_dir>
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.
Toggle the power switch to turn on the device.

Confirm the device is in EDL mode:

system_profiler SPUSBDataType | grep -A4 -i qualcomm

Expected output:

Product ID: 0x9008
Vendor ID: 0x05c6  (Qualcomm, Inc)
Manufacturer: Qualcomm CDMA Technologies MSM

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

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).

Download provision.zip and unzip it.
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.
<qdl_dir>/qdl --storage ufs prog_firehose_ddr.elf provision_1_3.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.

Download IQ8275 CDT and unzip it.

Flash CDT from the unzipped directory:

<qdl_dir>/qdl prog_firehose_ddr.elf rawprogram3.xml patch3.xml

Expected output:

flashed "cdt" successfully
13 patches applied

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

Navigate to the sail_nor subfolder inside the image folder:
cd <path-to-image>/sail_nor

Flash the SAIL firmware:

<qdl_dir>/qdl --storage spinor prog_firehose_ddr.elf rawprogram0.xml patch0.xml

Expected output:

flashed "SAIL_HYP" successfully
flashed "SAIL_SW1" successfully
flashed "SAIL_HYP_BKUP" successfully
flashed "SAIL_SW1_BKUP" successfully
11 patches applied

Flash Ubuntu

Navigate to the main image folder:
cd <path-to-image>

Flash the image:

<qdl_dir>/qdl prog_firehose_ddr.elf rawprogram0.xml rawprogram1.xml rawprogram2.xml rawprogram3.xml rawprogram4.xml patch1.xml patch2.xml patch3.xml patch4.xml

The flash is complete when the final line reads:

partition 1 is now bootable

If flashing fails at any point, disconnect the USB cable and power supply, reconnect them, and retry from the EDL mode step.

Finish

Turn off the SW2-3 DIP switch — push it down.
Power-cycle the device. It boots into the newly flashed Ubuntu image.

Next steps

Continue to Set up the device to connect the serial console, verify the software version, and bring up the network, SSH, and display.

​What you need

​Select your host OS and follow the complete path

​Download the Ubuntu image

​Download QDL

​Set up QDL driver

​Set up QDL path

​Put the device in EDL mode

​Provision UFS

​Flash CDT

​Flash SAIL firmware

​Flash Ubuntu

​Download the Ubuntu image

​Download QDL

​Set up QDL driver

​Put the device in EDL mode

​Provision UFS

​Flash CDT

​Flash SAIL firmware

​Flash Ubuntu

​Download the Ubuntu image

​Download QDL

​Set up QDL path

​Put the device in EDL mode

​Provision UFS

​Flash CDT

​Flash SAIL firmware

​Flash Ubuntu

​Finish

​Next steps

What you need

Select your host OS and follow the complete path

Download the Ubuntu image

Download QDL

Set up QDL driver

Set up QDL path

Put the device in EDL mode

Provision UFS

Flash CDT

Flash SAIL firmware

Flash Ubuntu

Download the Ubuntu image

Download QDL

Set up QDL driver

Put the device in EDL mode

Provision UFS

Flash CDT

Flash SAIL firmware

Flash Ubuntu

Download the Ubuntu image

Download QDL

Set up QDL path

Put the device in EDL mode

Provision UFS

Flash CDT

Flash SAIL firmware

Flash Ubuntu

Finish

Next steps