Skip to content

Ubuntu System Installation

Reminder

System flashing will format the system. Please back up your data in advance.

Flashing Tool Installation

Developers need to pre-install the necessary software on the local Windows computer before using Rhino Pi. The software includes:

  • USB Driver: USB_Driver_qud.win.1.1_installer_10061.1.zip
  • System Flashing Tool: QPST_2.7.496.zip
  • ADB Tool: platform-tools.zip

Software Download Link: Software Tool Installation Package Download Link

USB Driver Installation

  • Extract the USB_Driver_qud.win.1.1_installer_10061.1.zip file.

  • After extraction, double-click the setup.exe program and wait for the Qualcomm USB Drivers installation interface to appear. Follow the prompts and click next to complete the installation.

System Flashing Tool Installation

  • Extract the QPST_2.7.496.zip file to the current folder.

  • Navigate to the extracted QPST_2.7.496 directory and double-click the QPST.2.7.496.1.exe program to start the installation.

  • Follow the prompts and click next continuously to complete the installation.

  • Default installation path after completion: C:\Program Files (x86)\Qualcomm\QPST\bin.

  • You can navigate to this directory and send the QFIL.exe program to the desktop.

  • The desktop icon is as follows.

ADB Tool Installation

  1. Unzip
  • Extract the platform-tools.zip file to the D drive.
  1. Configure ADB Environment Variables
  • Copy the path of the extracted platform-tools folder.

  • Right-click "This PC" and select "Properties".

  • In the pop-up settings window, click "Advanced system settings".

  • In the Advanced tab of the pop-up System Properties window, click "Environment Variables".

  • In the pop-up Environment Variables window, select the Path variable in the "System variables" section and click "Edit" below.

  • In the pop-up Edit Environment Variable window, click "New" and add the previously copied platform-tools path.

  • Click "OK" in sequence to save the variable settings and exit.
  1. Verify if the ADB Environment Configuration is Available
  • Open the cmd window and enter adb. No error is reported.

Ubuntu System Installation

Switch to Flashing Mode

  • After powering on the device, use a USB TYPE-A to TYPE-C cable to connect the computer and the device. Plug the TYPE-A end into the computer's USB port, and the TYPE-C end into the device's port.

  • Once connected, press WIN+R on the Windows computer, enter cmd, and execute the command adb devices in the opened window. The connected devices will be listed. If no device is displayed, wait a moment, or unplug and re-plug the TYPE-C cable before executing the command again.

shell
adb devices

  • Switch to flashing mode by executing the commands: adb root;adb reboot edl.
shell
adb root
adb reboot edl

Configure QFIL's Configuration Item

  • Open QFIL and click the Configuration - FireHose Configuration option at the top.

  • Make the following settings in the pop-up Download Configuration window:
    • Select 0-Sahara for Download Protocol
    • Select ufs for Device Type
    • Check the Reset After Download option
    • Keep all other options consistent with the settings shown in the screenshot below.

  • Click OK to save the configuration after completion.

Select Flashing Port

  • Click the Select Port option. In the pop-up window, select the displayed 9008 port and click OK.

  • After switching to flashing mode as described in 9.2.1 Switch to Flashing Mode, the 9008 port should appear automatically in this window. If it does not, power off and restart the device, then perform the switching step again and wait for the port to appear.

Select Build Type

  • Locate the Select Build Type item and select Flat Build.

Select Flashing File

  • Extract the ROM file. Take the installation of version A8550BF1-Ubuntu-2025102910 as an example.

  • Locate the Select Programmer item, click Browse... next to Programmer Path, find the extracted path, and select the extracted ROM file.

  • Change the file viewing suffix to All Files(*.*).

  • Select the xbl_s_devprg_ns.melf file and click Open.

Select Flashing XML File

  • Locate the Select Flat Build item, click Load XML... below, and select the flashing XML file.

  • In the pop-up window, select All Files and click Open.

  • Another window will pop up automatically. Select All Files again and click Open.

Start Flashing

  • After completing all the above settings, click Download to start flashing.

  • Wait for approximately 5 minutes. The flashing is completed when the message successful appears. If flashing fails, please contact AgiX after-sales personnel.

  • The system will restart automatically after flashing is completed.