安装系统到板载 UFS

主要介绍如何将系统安装到 Fogwise® AIRbox Q900 的板载 UFS 上。

配置说明

Fogwise® AIRbox Q900 板载 128GB UFS。

使用前提

进入 EDL 模式

EDL 模式

高通的 EDL 模式（Emergency Download Mode，紧急下载模式） 是一种专为高通芯片设备设计的底层救援机制，用于在设备因系统崩溃、刷机失败或硬件故障导致无法正常启动时，通过 USB 接口强制刷写固件或修复关键数据。

主板上电前，按住 EDL 按键；主板上电后，松开 EDL 按键，主板会自动进入 EDL 模式。

① : 使用插针或牙签按住 EDL 按键

② : 使用 12V DC 电源适配器给主板供电

③ : 松开 EDL 按键

④ : 使用双头 USB Type-A 数据线连接主板的 USB 3.1 OTG Type-A 接口和电脑的 USB Type-A 接口

验证 EDL 模式

主要介绍 Windows 和 Ubuntu 系统下验证 EDL 模式的方法。

Windows

• 下载 QDL 工具

进入 资源汇总下载 页面下载 QDL 工具并解压（QDL 工具包括 QDL 软件和 QDL 驱动）。

• 安装 QDL 驱动

打开解压后的 QDL 工具文件夹，找到 qcserlib.inf 文件，鼠标右击，选择 安装 选项。

• 验证 EDL 模式

安装驱动成功后，可以尝试插拔 USB Type-A 数据线，观察系统的设备管理器界面是否刷新以及出现 Qualcomm HS-USB QDLoader 9008 设备。

Ubuntu

1. 创建 udev 规则文件

使用以下命令创建 udev 规则文件。

Ubuntu$

sudo nano /etc/udev/rules.d/51-qcom-usb.rules

2. 添加以下内容

SUBSYSTEMS=="usb", ATTRS{idVendor}=="05c6", ATTRS{idProduct}=="9008", MODE="0666", GROUP="plugdev"

3. 保存文件后，重新加载 udev 规则并触发设备检测

Ubuntu$

sudo udevadm control --reload-rules
sudo udevadm trigger

4. 重新插拔 USB 数据线，使规则生效

5. 使用 lsusb 命令查看设备是否进入 QDL 模式

Ubuntu$

lsusb

若主板进入 QDL 模式，终端会输出类似以下结果：

Bus 001 Device 012: ID 05c6:9008 Qualcomm, Inc. Gobi Wireless Modem (QDL mode)

安装系统

主要介绍 Windows 和 Ubuntu 系统下安装系统到 Fogwise® AIRbox Q900 的板载 UFS 上的方法。

下载文件

进入 资源汇总下载 页面下载启动固件和系统镜像文件。

Windows

进入 资源汇总下载 页面下载启动固件和系统镜像文件和 QDL 工具。

Ubuntu 22.04 / 24.04

进入 资源汇总下载 页面下载启动固件和系统镜像文件和 QDL 工具。

Ubuntu 26.04

Ubuntu 26.04 需要自行编译 QDL 工具，编译步骤参考 QDL 官方文档。

1. 安装编译依赖

Ubuntu$

sudo apt install libxml2-dev libusb-1.0-0-dev libzip-dev meson ninja-build help2man

2. 下载 QDL 源码

Ubuntu$

git clone https://github.com/linux-msm/qdl.git
cd qdl

3. 编译 QDL

Ubuntu$

meson setup build
meson compile -C build

编译完成后，build/qdl 即为 QDL 可执行文件。

设置环境变量

设置环境变量，可以简化后续的烧录操作，简化命令。

Windows

1. 使用 Win + R 打开运行对话框，输入 sysdm.cpl，点击 确定。

2. 在 System Properties 选项窗口中，点击 Advanced 选项卡，点击 Environment Variable ... 按钮。

3. 在 Environment Variables 选项窗口中，双击 System variables 下的 Path 变量。

4. 在 Edit Environment Variable 选项窗口中，点击 New 按钮，输入 QDL 工具的路径，点击 OK 按钮。

5. 完成以上操作，重新打开终端，如果输入 qdl 命令可以查看到版本信息，说明设置成功。

Windows$

qdl

终端输出示例：

Usage: qdl [options] <prog.mbn> [<program> <patch> ...]
 -d, --debug                    Print detailed debug info
 -v, --version                  Print the current version and exit
 -n, --dry-run                  Dry run execution, no device reading or flashing
 -f, --allow-missing            Allow skipping of missing files during flashing
 -s, --storage=T                Set target storage type T: <emmc|nand|ufs>
 -l, --finalize-provisioning    Provision the target storage
 -i, --include=T                Set an optional folder T to search for files
 -S, --serial=T                 Select target by serial number T (e.g. <0AA94EFD>)
 -u, --out-chunk-size=T         Override chunk size for transaction with T
 -t, --create-digests=T         Generate table of digests in the T folder
 -D, --vip-table-path=T         Use digest tables in the T folder for VIP
 -h, --help                     Print this usage info

Example: qdl prog_firehose_ddr.elf rawprogram*.xml patch*.xml

Ubuntu

1. 查看路径

进入 QDL 工具的目录，使用 realpath 命令查看 QDL 工具的路径。

Ubuntu$

realpath qdl

终端输出示例：

/home/user_name/download/QDL_2.3.9.2_Linux_x64/qdl

2. 可执行权限

使用 chmod 命令为 QDL 工具添加可执行权限。

Ubuntu$

sudo chmod 777 qdl

3. 创建软链接

Ubuntu$

sudo ln -s /home/user_name/download/QDL_2.3.9.2_Linux_x64/qdl /usr/local/bin/qdl

4. 验证

在任意位置打开终端，如果可以使用 qdl 命令查看到版本信息，说明设置成功。

Ubuntu$

qdl

终端输出示例：

Usage: qdl [options] <prog.mbn> [<program> <patch> ...]
 -d, --debug                    Print detailed debug info
 -v, --version                  Print the current version and exit
 -n, --dry-run                  Dry run execution, no device reading or flashing
 -f, --allow-missing            Allow skipping of missing files during flashing
 -s, --storage=T                Set target storage type T: <emmc|nand|ufs>
 -l, --finalize-provisioning    Provision the target storage
 -i, --include=T                Set an optional folder T to search for files
 -S, --serial=T                 Select target by serial number T (e.g. <0AA94EFD>)
 -u, --out-chunk-size=T         Override chunk size for transaction with T
 -t, --create-digests=T         Generate table of digests in the T folder
 -D, --vip-table-path=T         Use digest tables in the T folder for VIP
 -h, --help                     Print this usage info

Example: qdl prog_firehose_ddr.elf rawprogram*.xml patch*.xml

配置 UFS

进入 qcs9075-provision 文件夹下，打开终端，使用以下命令配置 UFS。

PC$

qdl --storage ufs prog_firehose_ddr.elf provision_1_2.xml

终端输出示例：

Waiting for EDL device
waiting for programmer...
UFS provisioning succeeded

烧录 SAIL

进入 radxa-airbox-q900_noble_gnome_xxx\sail_nor 文件夹下，打开终端，使用以下命令烧录 SAIL。

PC$

qdl --storage spinor prog_firehose_ddr.elf rawprogram0.xml patch0.xml

Waiting for EDL device
waiting for programmer...
flashed "SAIL_HYP" successfully
flashed "SAIL_HYP_BKUP" successfully
flashed "PrimaryGPT" successfully
flashed "BackupGPT" successfully
11 patches applied

烧录系统镜像

进入 radxa-airbox-q900_noble_gnome_xxx 文件夹下，打开终端，使用以下命令烧录系统镜像。

PC$

qdl --storage ufs prog_firehose_ddr.elf rawprogram*.xml patch*.xml

终端输出示例：

Waiting for EDL device
waiting for programmer...
flashed "efi" successfully at 40329kB/s
flashed "system" successfully at 3630kB/s
flashed "PrimaryGPT" successfully
flashed "BackupGPT" successfully
flashed "xbl_a" successfully
flashed "xbl_b" successfully
flashed "xbl_config_a" successfully
flashed "xbl_config_b" successfully
flashed "PrimaryGPT" successfully
flashed "BackupGPT" successfully
flashed "xbl_a" successfully
flashed "xbl_b" successfully
flashed "xbl_config_a" successfully
flashed "xbl_config_b" successfully
flashed "PrimaryGPT" successfully
flashed "BackupGPT" successfully
flashed "PrimaryGPT" successfully
flashed "BackupGPT" successfully
flashed "aop_a" successfully
flashed "shrm_a" successfully
flashed "uefi_a" successfully
flashed "uefisecapp_a" successfully
flashed "xbl_ramdump_a" successfully
flashed "dtb_a" successfully at 32768kB/s
flashed "tz_a" successfully
flashed "hyp_a" successfully
flashed "devcfg_a" successfully
flashed "cpucp_a" successfully
flashed "multiimgoem_a" successfully
flashed "multiimgqti_a" successfully
flashed "imagefv_a" successfully
flashed "aop_b" successfully
flashed "dtb_b" successfully at 65536kB/s
flashed "imagefv_b" successfully
flashed "shrm_b" successfully
flashed "uefi_b" successfully at 3912kB/s
flashed "uefisecapp_b" successfully
flashed "xbl_ramdump_b" successfully
flashed "tz_b" successfully
flashed "hyp_b" successfully
flashed "devcfg_b" successfully
flashed "cpucp_b" successfully
flashed "multiimgoem_b" successfully
flashed "multiimgqti_b" successfully
flashed "toolsfv" successfully
flashed "PrimaryGPT" successfully
flashed "BackupGPT" successfully
65 patches applied
partition 1 is now bootable

使用系统

完成以上操作，可以按照 快速上手 教程使用 Fogwise® AIRbox Q900。

其他操作

擦除 UFS

1，先令 AIRbox Q900 进入 EDL 模式。

2，进入 radxa-airbox-q900_noble_gnome_xxx/partition_ufs 文件夹下，打开终端，使用以下命令擦除 UFS。

PC$

qdl --storage ufs ../prog_firehose_ddr.elf rawprogram*_BLANK_GPT.xml

终端输出示例：

flashed "PrimaryGPT" successfully
flashed "PrimaryGPT" successfully
flashed "PrimaryGPT" successfully
flashed "PrimaryGPT" successfully
flashed "PrimaryGPT" successfully
0 patches applied