Ubuntu 系统安装

本文介绍如何为 Rhino Pi IQ9N 烧录 Ubuntu 24.04 系统镜像。

提醒

刷机会格式化系统，请提前备份好数据。

准备工作

物品	说明
Rhino Pi IQ9N	待烧录的设备
系统镜像	从 镜像下载 页面获取的 Ubuntu 24.04 镜像
Windows 电脑	用于安装刷机工具
USB TYPE-A 转 TYPE-C 数据线	连接电脑与设备，TYPE-A 端接电脑，TYPE-C 端接设备
DC 电源适配器	DC 19V / 65W

刷机工具安装

开发者在使用 Rhino Pi IQ9N 时，需要提前在本地 Windows 电脑上预装必要的软件：

• USB 驱动：USB_Driver_qud.win.1.1_installer_10061.1.zip
• 系统刷机工具：QPST_2.7.496.zip
• ADB 工具：platform-tools.zip

软件下载链接参见工具资源下载链接。

USB 驱动安装

• 解压 USB_Driver_qud.win.1.1_installer_10061.1.zip 文件。

• 解压后，双击 setup.exe 程序，等待跳出 Qualcomm USB Drivers 安装界面，根据提示点击 next 即可。

系统刷机工具安装

• 解压 QPST_2.7.496.zip 文件到当前文件夹。

• 进入到解压后的 QPST_2.7.496 目录，双击 QPST.2.7.496.1.exe 程序，进行安装。

• 根据提示，一直点击 next 即可完成安装。

• 安装完成后的默认路径：C:\Program Files (x86)\Qualcomm\QPST\bin 。

• 可进入该目录，将 QFIL.exe 程序发送到桌面。

• 桌面图标如下。

ADB 工具安装

1. 解压

• 将 platform-tools.zip 文件解压到 D 盘。

2. 配置 adb 环境变量

• 复制解压后的 platform-tools 路径。

• 鼠标右键点击此"电脑-属性"。

• 在弹出的设置窗口，点击"高级系统设置"。

• 在弹出的系统属性窗口-高级页，点击"环境变量"。

• 在弹出的环境变量窗口中，选中"系统变量"栏的Path变量，点击下方的"编辑"。

• 在弹出的编辑环境变量窗口中，点击"新建"，并添加前面复制的platform-tools路径。

• 依次点击"确认"来保存设置的变量，并退出。

3. 验证 adb 环境配置是否可用

• 打开 cmd 窗口，输入 adb，无报错。

切换到烧录模式

方法一：通过 ADB 切换（系统可正常启动）

1. 使用 USB TYPE-A 转 TYPE-C 数据线连接电脑与设备。

2. 在 Windows 电脑端按 WIN + R 输入 cmd，在打开的窗口执行 adb devices，确认能列出设备。

   • 若设备状态显示 offline 或未列出，请多等待一会后重新执行 adb devices，状态变为 device 即可继续；仍不行时拔插一次线缆后重试。

adb devices

3. 执行以下命令，将设备重启至 EDL 模式。

adb root
adb shell reboot edl

方法二：通过按键进入（系统无法启动）

1. 断开设备 DC 电源，使设备处于断电状态。
2. 按住 RTSS BOOT 按键（对应信号 FORCE_BOOT_S）不放，再按开机按键上电，设备即进入 EDL 模式，随后可松开按键。

按键位置与操作时序参见按键，模式说明参见 EDL 强制下载模式。

使用 QFIL 烧录

配置 Configuration 项

• 打开 QFIL，点击上方 Configuration - FireHose Configuration 选项。

• 在弹出的 Download Configuration 窗口里做如下设置：

选项	取值
Download Protocol	0-Sahara
Device Type	ufs
Reset After Download	勾选

其他选项保持默认后点击 OK 保存。

选择烧录端口

• 点击 Select Port，在弹出的端口列表中应能看到 Qualcomm HS-USB QDLoader 9008 (COMx)，选中后点击 OK。

• 若未出现 9008 端口，请断电重启后重新执行切换到烧录模式并等待端口出现。

选择 Build Type

• 找到 Select Build Type 项，选择 Flat Build。

选择烧录文件

• 解压 IQ9N 的系统镜像 ROM 包。

• 在 Select Programmer 项点击 Programmer Path 后的 Browse...，文件框已默认为 FireHose Programmer 类型，直接选择 ROM 包内的 prog_firehose_ddr.elf 并点击 打开即可，无需切换文件后缀。

• 选择完成后，Programmer Path 与 Search Path 会自动填入所选 ROM 包的路径。

选择烧录 XML 文件

• 在 Select Flat Build 项点击 Load XML...。

• 在弹出的窗口中全选 XML 文件并打开。

• 界面会自动再弹出一个窗口，同样全选 XML 文件后打开。

• XML 全部加载完成后，RawProgram 与 Patch 列表会列出已选中的文件。

提示

不同版本 ROM 包内的文件名可能略有差异，请以实际解压出的文件为准。

开始烧录

• 以上选项全部配置完成后，点击 Download 开始烧录。

• 等待约 5 分钟，出现 Download Succeed 表示烧录完成，设备会自动重启。若烧录失败，请联系阿加犀售后人员。

验证烧录结果

系统启动后，通过 显示器直连 或 ADB 登录系统，执行以下命令确认系统版本：

cat /etc/os-release

输出中 VERSION_ID 应为 24.04。

注意事项

• 烧录过程中请勿断电、拔插线缆或操作设备，否则可能导致设备无法启动。
• 烧录会清除目标存储上的全部数据，请提前备份。
• 请使用与当前系统版本匹配的刷机工具与 USB 驱动版本，避免兼容性问题。