跳到主要内容

设备设置

本章是在UbuntuWindows®macOS®环境中设置魔方派 3开发板的简化指南。无论您是第一次打开设备电源、配置调试串口进行访问,还是建立网络和 SSH 连接,本章确保顺畅可靠的入门体验。
此外本章还涵盖了一些关键步骤,例如进入EDL 模式 进行固件刷新和验证您的Ubuntu 24.04 安装,这是 AI、多媒体和嵌入式开发工作流程的基础。

让我们开始吧!

设备上电

连接 12V、3A Type-C 电源适配器。

注意

魔方派 3 支持 Power Delivery (PD) 3.0 电源输入。请使用支持12V 3A PD 3.0协议的Type-C 接口电源适配器。经验证的配件列表,请见外设兼容列表

如果电源适配器满足要求并且电源协商成功,电源端口附近的电源指示灯 LED 将亮起。如果适配器不符合要求,LED 将保持熄灭状态,并且设备将无法启动。

备注

插入 USB Type-C 转 USB Type-A 或 Type-C 线缆以建立连接进行刷机操作。

开发板V02及更新版本支持连接电源适配器后自动开机。您可以在开发板如下位置查看硬件版本号。在下面的示例中,硬件版本是 V02。

备注

如果开发板上的蓝色 LED 持续亮起,则表示电源按钮按下的时间过长,并且开发板处于fastboot模式。请参阅FAQ退出fastboot模式。

设置调试 UART

调试 UART 显示诊断消息并通过 UART shell 提供对设备的访问。

1️⃣将 Micro-USB 电缆连接到魔方派 3 上的 Micro-USB 端口。

2️⃣将Micro-USB线的另一端连接到主机。根据主机操作系统,按照以下说明之一进行操作。

1️⃣运行以下命令来安装用于访问 UART 控制台的屏幕。

sudo apt update
sudo apt install screen

2️⃣运行以下命令检查USB端口:

ls /dev/ttyACM*

示例输出

/dev/ttyACM0

3️⃣运行以下命令打开调试 UART 会话。

sudo screen <serial_port> <baud_rate>

示例:sudo screen /dev/ttyACM0 115200
4️⃣打开调试UART接口,按Enter键显示身份验证提示。
5️⃣如果设备上已经刷入了 Canonical Ubuntu,请通过 UART 控制台登录并继续重置用户密码。

  • 帐户:ubuntu
  • 密码: ubuntu
提示
  • 如果无法正常登录,请检查您的魔方派 3 是否已升级到 Ubuntu 24.04。详细升级步骤请参考更新软件
  • 如果您没有按预期看到身份验证控制台,请检查 USB 连接。如有必要,请断开并重新连接 Micro USB 线。

连接到网络

使用以下方法之一建立互联网连接并获取设备的 IP 地址。

设备在 Wi-Fi 站点模式下运行。设备启动时,初始化Wi-Fi主机驱动程序并执行网络管理认证。用户可以使用nmcli命令行工具建立无线连接。

1️⃣运行以下命令连接到无线接入点(Wi-Fi路由器):

sudo nmcli dev wifi connect <WiFi-SSID> password <WiFi-password>

示例

sudo nmcli dev wifi connect RUBIKPiWiFi password 1234567890
Device 'wlan0' successfully activated with 'd7b990bd-3b77-4b13-b239-b706553abaf8'.

2️⃣运行以下命令来验证连接和设备状态:

sudo nmcli -p device

3️⃣运行以下命令来验证WLAN连接状态和IP地址。

ip addr

4️⃣为确保连接处于活动状态,请对魔方派 等网站执行 ping 操作:

ping yahoo.com

建立 SSH 连接

安全外壳协议 (SSH) 用于主机和魔方派 3 之间的安全文件传输。

在连接到 SSH 之前,请确保网络连接已建立。

1️⃣要根据网络连接类型查找 IP 地址,请在 UART 控制台中运行以下命令:

ip addr

2️⃣从主机运行以下命令与设备建立 SSH 连接。使用步骤 1 中获得的 IP 地址。

ssh <user name>@ip-address

示例

ssh ubuntu@192.168.0.222

3️⃣要连接到 SSH,请在提示时输入用户密码。

备注

确保主机与设备连接到同一网络。

验证软件版本

完成设置后,一旦设备成功启动,在设备 shell 中运行以下命令来验证操作系统版本:

cat /etc/os-release 

输出:

NAME="Ubuntu"
VERSION_ID="24.04"
VERSION="24.04.2 LTS (Noble Numbat)"
VERSION_CODENAME=noble
ID=ubuntu
ID_LIKE=debian
HOME_URL="https://www.ubuntu.com/"
SUPPORT_URL="https://help.ubuntu.com/"
BUG_REPORT_URL="https://bugs.launchpad.net/ubuntu/"
PRIVACY_POLICY_URL="https://www.ubuntu.com/legal/terms-and-policies/privacy-policy"
UBUNTU_CODENAME=noble
LOGO=ubuntu-logo
备注

根据您当前的软件版本选择合适的软件升级

连接 HDMI 显示器

要连接 HDMI 显示器并查看 Wayland 输出和示例应用程序的输出,请按照以下步骤操作:
1️⃣将 HDMI 线的一端连接到魔方派 3 上的 HDMI 端口。
2️⃣将HDMI 线的另一端连接到显示器。

3️⃣打开设备电源并检查 HDMI 显示。在应用任何包更新之前,应该看到默认的 Canonical Ubuntu 屏幕。

连接到 SBC 的键盘和鼠标

将 USB 键盘和鼠标连接到 Type-A 端口:

基本端口连接详情

进入EDL模式

通过高通QDL工具向魔方派 3 刷入固件与系统镜像,必须进入EDL 模式。
如果设备已预先刷写并完全配置,则可以在初始设置期间跳过 EDL 模式。

1️⃣ 断开端口10的电源连接和端口5的Type-C连接线。

2️⃣ 按住上图 12 的 [EDL] 按钮。

3️⃣ 按住 [EDL] 按钮的同时,将电源线接到端口 10,如下图。

4️⃣ 按住 [EDL] 按钮的同时,将Type-C连接线接到端口 5,等待 3 秒进入 9008 模式。

5️⃣ 松开 [EDL] 按钮。