FAQ
包装内容
- 
魔方派 3 
- 
魔方派贴纸 
- 
快速入门指南卡 
电源适配器规格
魔方派 3 没有附带电源适配器。魔方派 3 集成了 Power Delivery 协议协商 IC,最高支持 PD 3.0。为了获得最佳体验,请使用12V 3A PD 3.0 Type-C 电源适配器。经验证的配件列表,请见外设兼容列表。
此外,您可以使用输出接近 12V 3A 的电源适配器。但请注意,电量不足可能会导致系统无法正常启动,或某些外设在启动后无法正常工作等问题。
风扇
魔方派 3 没有配备风扇。在计算需求较高的场景下,建议购买并安装风扇。详情请见 外设兼容列表。
如何恢复设备?
- 
下载软件。 
- 
强制设备进入紧急下载 (EDL) 模式。 
- 
刷入下载的软件。 
如何刷写配置数据表 (CDT)?
CDT 提供平台或设备相关数据,例如平台 ID、子类型和版本。各种软件(驱动程序/固件)模块使用此信息来动态检测和初始化平台。CDT 已经默认集成到软件包中,如有需要,可执行以下步骤。
确保设备处于 EDL 模式。更多信息请见进入 EDL 模式。
- 
点击 此处 下载所需的 CDT。 
- 
运行以下命令刷写 CDT: 
../qdl prog_firehose_ddr.elf rawprogram3.xml patch3.xml
如何配置通用闪存存储(UFS)?
如何强制设备进入紧急下载(EDL)模式?
- 请参考 进入 EDL 模式。
如何在主机上安装和连接 Android Debug Bridge (ADB)?
adb命令可以简化各种设备操作,例如调试、捕获内核日志以及将应用程序和文件推送到目标设备。
- 
点击 此处 下载 QUD 驱动程序。 
- 
在Linux主机上运行以下命令。 
sudo apt install git android-tools-adb android-tools-fastboot wget
- 要验证 Linux 主机上的 ADB 版本,请运行以下命令:
adb --version
- 使用 USB Type-C 线将魔方派设备连接到主机。确保该设备显示为 ADB 设备。
adb devices
- 运行以下命令进入shell:
adb shell
已经连接到网络的情况下,如何重新连接到其他网络?
- 要断开当前网络,请运行以下命令:
sudo nmcli c down <WiFi-SSID>
示例
sudo nmcli c down RUBIKPiWiFi
Connection 'RUBIKPiWiFi' successfully deactivated (D-Bus active path: /org/freedesktop/NetworkManager/ActiveConnection/2)
- 要验证是否已断开连接,请运行以下命令:
nmcli -p device

- 要连接到不同的 Wi-Fi 网络,请运行以下命令:
nmcli dev wifi connect <WiFi-SSID> password <WiFi-password>
示例
nmcli dev wifi connect RUBIKPiWiFi password 1234567890
Device 'wlan0' successfully activated with 'd7b990bd-3b77-4b13-b239-b706553abaf8'.
如何使用 Minicom 设置调试 UART?
- 请见 设置调试 UART。
如何切换到 root 用户?
运行以下命令:
sudo -i
如何从桌面版切换到服务器版?
- 
请见 连接到网络。确保网络连接正常。 
- 
运行以下命令从桌面版切换到服务器版。 
sudo add-apt-repository ppa:ubuntu-qcom-iot/qcom-noble-ppa
sudo apt update
sudo apt upgrade -y
sudo apt-get install qcom-adreno1
sudo apt-get remove ubuntu-desktop
sudo apt remove gdm3
sudo reboot
如何从服务器版本切换到桌面版本?
- 
请见 连接到网络。确保网络连接正常。 
- 
运行以下命令从服务器版本切换到桌面版本。 
sudo add-apt-repository ppa:ubuntu-qcom-iot/qcom-noble-ppa
sudo apt update
sudo apt upgrade -y
sudo apt install qcom-adreno1- libgbm-msm1- libegl-mesa0 libegl1 libgles2 libglvnd0 libvulkan1
sudo apt install ubuntu-desktop
sudo reboot
如何更新 USB 和以太网控制器固件?
步骤
- 
点击 此处 下载固件包。 
- 
要以Fastboot模式启动设备,运行以下命令: 
adb root
adb shell
reboot bootloader
- 设备处于Fastboot模式时,运行以下命令:
fastboot devices
示例输出
7dc85f5e         fastboot
- 要将usb_fw.img镜像刷入设备,运行以下命令:
fastboot erase usb_fw
fastboot flash usb_fw usb_fw.img
fastboot reboot
- 运行以下命令验证固件是否已成功更新:
adb shell dmesg
示例输出
[    6.589462] usbcore: registered new device driver onboard-usb-hub
[    6.653277] usb 2-1: new SuperSpeed USB device number 2 using xhci_hcd
[    7.013061] usb 2-1.1: new SuperSpeed USB device number 3 using xhci_hcd
[    7.120657] ax88179_178a 2-1.1:1.0 eth0: register ‘ax88179_178a’ at usb-0001:04:00.0-1.1, ASIX AX88179 USB 3.0 Gigabit Ethernet, 3e:9e:5e:ff:d3:fb
[    7.120767] usbcore: registered new interface driver ax88179_178a
如何解决与刷机相关的问题?
Ensure that the host is not running the ModemManager tool, as it can interfere with QDL flashing.
如果您使用的是带有 systemd 的 Linux 发行版,请使用以下命令停止 ModemManager 工具:
sudo systemctl stop ModemManager
- 如果需要使用 ModemManager 工具,请在刷机过程完成后重新启动它。
如果刷机过程失败,请按照以下步骤操作,然后重试刷机过程:
- 
关闭设备电源。 
- 
断开设备与主机的连接。 
- 
重新启动主机。 
如何在魔方派 3 上退出fastboot模式?
使用以下方法之一退出fastboot模式:
- 在串口终端按Enter。
- 在主机输入fastboot reboot命令。
- 拔掉电源,然后重启设备。
可以在哪里获取魔方派 3 的 3D 模型?
访问 硬件资料 页面下载 3D 模型。