跳到主要内容

刷写镜像

本章介绍如何使用 QDL（Qualcomm Device Loader） 工具为魔方派 3 刷写 Android 15 镜像。

刷写前，请先确认当前系统版本。如果您的设备当前运行的是 Android、Qualcomm Linux (QLI)、Ubuntu 或其他系统，可参考本节内容使用 QDL（Qualcomm Device Loader） 将设备刷写为 Android 15。此操作需在 Ubuntu、Windows® 或 macOS® 主机上完成。

设备运行 Android 15 时，可在主机上执行以下命令：

adb shell getprop ro.build.version.release
adb shell getprop ro.build.display.id
adb shell getprop ro.build.fingerprint

示例输出：

15
qssi-userdebug 15 AQ3A.250612.001 45468 test-keys
Thundercomm/rubikpi/rubikpi:15/AQ3A.250612.001/45468:userdebug/test-keys
注意

刷写 Android 15 镜像会清除设备上的系统数据。请在继续操作之前备份重要文件，并确认镜像包与魔方派 3 硬件版本匹配。

信息
  • 开始前，请完成设备设置中的上电和线缆连接步骤。
  • 刷写前需要让设备进入 EDL 模式。
  • Android 15 镜像包通常以 FlatBuild 形式提供，刷写命令在镜像包的 ufs 目录中执行。

现在开始吧！​

1. 设置 QDL 工具​

Qualcomm Device Loader (QDL) 是一个跨平台刷写工具，可在 Windows、Ubuntu/Linux 和 macOS 主机上向 Qualcomm® USB 设备加载 firehose 程序并刷写软件镜像。

  1. 下载 QDL 工具：QDL tool。
  2. 解压 QDL 工具包。
  3. 根据主机系统完成以下准备工作。

执行以下命令安装 libusb 和 libxml2；如果已经安装，请跳过此步骤。

sudo apt-get install libxml2-dev libudev-dev libusb-1.0-0-dev

2. 下载 Android 15 镜像​

  1. 访问魔方派 3 系统镜像下载页面下载 Android 15 镜像。
  2. 解压 Android 15 FlatBuild 镜像包。
  3. 进入镜像包中的 ufs 目录。
  4. 将步骤 1 中对应主机架构的 QDL 可执行文件复制到 ufs 目录。
备注
  • Windows 主机请将 QDL 可执行文件和相关 DLL 文件一起复制到 ufs 目录。
  • Ubuntu 主机通常使用 QDL_Linux_x64 或 QDL_Linux_ARM 目录中的 qdl。
  • macOS 主机通常使用 QDL_Mac_x64 或 QDL_Mac_ARM 目录中的 qdl。

3. 刷写 Android 15 镜像​

确认设备已进入 EDL/9008 模式后，在 Android 15 FlatBuild 镜像包的 ufs 目录中执行刷写命令。

运行以下命令刷写 Android 15 镜像：

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

提示

如果刷写失败，断开并重新连接电源和 USB 数据线，重新让设备进入 EDL 模式，然后再次执行刷写操作。

4. 可选：重新配置 UFS​

如果刷写后设备无法启动，可尝试进入 FlatBuild 包中的 provision 目录，重新对 UFS 进行配置。

注意

进行 provision 后，UFS 中存储的一些信息会丢失，如 SN 号、以太网 MAC 地址等。仅在刷写后无法启动或明确需要重新配置 UFS 时执行此步骤。

根据主机架构将 QDL_Linux_x64 或 QDL_Linux_ARM 目录下的 qdl 拷贝到 provision 目录，然后运行：

./qdl prog_firehose_ddr.elf provision_ufs_1_3.xml

注意

Provision 刷写完成之后，需要手动插拔电源线和 USB 数据线重启设备，然后重新进行 Android 15 镜像刷写。

5. 验证软件版本​

刷写完成后，设备将自动重启。等待 Android 15 启动完成后，使用 USB Type-C 数据线连接主机，运行以下命令确认设备在线：

adb devices -l

运行以下命令确认 Android 版本：

adb shell getprop ro.build.version.release
adb shell getprop ro.build.display.id
adb shell getprop ro.build.fingerprint

示例输出：

15
qssi-userdebug 15 AQ3A.250612.001 45468 test-keys
Thundercomm/rubikpi/rubikpi:15/AQ3A.250612.001/45468:userdebug/test-keys

也可以通过 Android 图形界面确认软件版本。连接 HDMI 显示器、鼠标和键盘后，进入 Settings > About phone。在该页面可以查看设备名称、Android 版本、Build number 等系统信息；如果当前页面未显示版本字段，请向下滚动继续查看。

备注

图形界面中的 About phone 页面用于快速确认当前系统已经启动到 Android 15；ADB 命令输出可用于记录更完整的 build ID 和 fingerprint。

后续步骤
镜像刷写完成后，请参考设备设置继续完成 ADB 登录、软件版本验证、HDMI 显示器和鼠标键盘连接。