使用 QDL 烧写 Ubuntu

​

下载 Ubuntu 镜像

1. 运行以下脚本下载并组装可烧写的镜像文件夹。根据所需镜像传入 --server 或 --desktop：
   ./prepare_iq8275_ubuntu_flashable.sh --server
   
   ./prepare_iq8275_ubuntu_flashable.sh --desktop
   
   这会在 iq8275_flash_prep_work/IQ8275_ubuntu_images 中生成可烧写的镜像 — 下文称为 <path-to-image>。
   要更新到新的 Canonical 版本，请编辑脚本中的 CANONICAL_BASE、SERVER_IMG_XZ、DESKTOP_IMG_XZ 和 BOOT_FW_URL_DEFAULT。
   prepare_iq8275_ubuntu_flashable.sh（完整脚本）

   #!/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'
   

​

下载 QDL

1. 下载 Linux (x64) 版 QDL 工具并解压。解压后的文件夹包含 qdl 二进制文件 — 下文称为 <qdl_dir>。
2. 安装所需的库（如已安装可跳过）：
   sudo apt-get install libxml2-dev libudev-dev libusb-1.0-0-dev
   
   我们建议将镜像文件夹和 QDL 解压到同一个父文件夹中。这样所有路径都在同一个根目录下。

​

设置 QDL 驱动

1. 检查规则是否已存在：
   ls /etc/udev/rules.d/51-qcom-usb.rules
   
2. 如果文件不存在，用一条命令创建它：
   echo 'SUBSYSTEMS=="usb", ATTRS{idVendor}=="05c6", ATTRS{idProduct}=="9008", MODE="0664", GROUP="plugdev"' | sudo tee /etc/udev/rules.d/51-qcom-usb.rules
   
   如果文件已存在，确认规则已包含在内：
   cat /etc/udev/rules.d/51-qcom-usb.rules
   
3. 重新加载 udev 以应用规则：
   sudo systemctl restart udev
   
   如果 USB 线缆已经连接，请断开并重新连接。

​

设置 QDL 路径

1. 使 QDL 可执行：
   chmod +x <qdl_dir>/qdl
   
2. 验证 QDL 是否正常工作：
   <qdl_dir>/qdl --help
   
   您应看到 QDL 的用法输出。如果出现错误，请检查路径。

​

使设备进入 EDL 模式

1. 打开 SW2-3 DIP 开关 — 向上推。
2. 将 12 V 电源连接到 EVK。
3. 将 USB Type-C 线缆从 EVK 上的 USB0 连接到您的主机。
4. 拨动电源开关打开设备。
5. 确认设备处于 EDL 模式：
   lsusb
   
   预期输出：
   Bus 002 Device 014: ID 05c6:9008 Qualcomm, Inc. Gobi Wireless Modem (QDL mode)
   
   如果设备未出现，请重新检查 SW2-3 和 USB-C 线缆。

​

配置 UFS（Provision）

• 这是一块从未烧写过的全新板卡。
• 您正在升级到新的镜像版本。
• 您正在切换发行版（Qualcomm Linux ↔ Ubuntu）。

1. 下载并解压 provision 文件：
   wget https://artifacts.codelinaro.org/artifactory/codelinaro-le/Qualcomm_Linux/QCS8300/provision.zip
   unzip provision.zip
   
2. 在解压后的 provision 目录中执行 UFS 配置：
   cd provision
   <qdl_dir>/qdl --storage ufs prog_firehose_ddr.elf provision_1_3.xml
   
   预期输出：
   UFS provisioning succeeded
   

​

烧写 CDT

1. 下载并解压 CDT 文件：
   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
   
2. 在解压后的目录中烧写 CDT：
   <qdl_dir>/qdl prog_firehose_ddr.elf rawprogram3.xml patch3.xml
   
   预期输出：
   flashed "cdt" successfully
   13 patches applied
   

​

烧写 SAIL 固件

1. 进入镜像文件夹内的 sail_nor 子文件夹：
   cd <path-to-image>/sail_nor
   
2. 烧写 SAIL 固件：
   <qdl_dir>/qdl --storage spinor prog_firehose_ddr.elf rawprogram0.xml patch0.xml
   
   预期输出：
   flashed "SAIL_HYP" successfully
   flashed "SAIL_SW1" successfully
   flashed "SAIL_HYP_BKUP" successfully
   flashed "SAIL_SW1_BKUP" successfully
   11 patches applied
   

​

烧写 Ubuntu

1. 进入主镜像文件夹：
   cd <path-to-image>
   
2. 烧写镜像：
   <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
   
   当最后一行显示如下内容时，烧写完成：
   partition 1 is now bootable