跳到主要内容

快速开始

介绍​

魔方派 3（RUBIK Pi 3）基于高通 QCS6490 芯片，采用 Qualcomm® Kryo™ 670 CPU 和融合 AI 加速器架构的 Qualcomm® Hexagon™ 处理器，具备 12 TOPS 的卓越 AI 性能，适用于各种机器学习和人工智能应用场景。

RUBIK Pi 3 具有丰富的接口和功能设计，支持 USB、Camera、DP、HDMI、ETH、3.5mm 耳机、Wi-Fi、蓝牙、M.2 连接器、Fan、RTC、40 pin 排针连接器等，满足多样化的开发需求，方便开发者快速开发和调试。

RUBIK Pi 3 同样也支持多种系统，如 Qualcomm Linux、Debian 13、Canonical Ubuntu for Qualcomm Platforms*、Android 13 等，灵活满足开发者特定应用要求。

*Canonical Ubuntu for Qualcomm Platforms：计划中

参数​

RUBIK Pi 3
芯片QCS6490
处理器

1 x Cortex-A78 2.7GHz

3 x Cortex-A78 2.4GHz

4 x Cortex-A55 1.9GHz

GPUAdreno 643 GPU @ Up to 812 MHz
VPUAdreno 633 VPU
NPU12 TOPS
ISPSpectra ISP，可以做端侧的机器学习和机器处理
内存8 GB LPDDR4x
ROM128 GB UFS 2.2
Wi-Fi & 蓝牙Wi-Fi 5 和蓝牙 5.2
摄像头接口2 x 4-lane MIPI CSI D-PHY
USB

1 x USB Type-C (USB 3.1 Gen1)

2 x USB Type-A (USB 3.0)

1 x USB Type-A (USB 2.0)

GPIO28个 GPIO 引脚
网口1000M
M.2 接口M.2 Key M 2280（2-lane PCIe 3.0）
音频接口3.5mm 耳机接口

准备​

  • 装有 Windows 10 以上 或 Ubuntu18 - Ubuntu22 系统的电脑

  • RUBIK Pi 3

  • USB Type-A to Type-C 数据线

  • USB Type-A to Micro USB 数据线

  • 电源（12V 3A Type-C）

安装驱动​

Windows 环境下驱动安装​

安装 QUD​

  1. 点击此处下载 QUD（Qualcomm USB driver ）

  2. 将 qud.win.1.1_installer_10061.1.zip 解压，运行 setup.exe，如下图，点击 Next。

  1. 再次点击 Next。

  1. 选择 I accept the terms in the license agreement （我接受协议内容）后，点击 Next。

  1. 点击 Install。

  1. 点击 Finish，完成驱动安装。

安装 Tflash​

  1. 点击此处下载 Tflash(镜像烧录工具)

  2. 打开 TflashSetup_v1.2.0.4.exe 进行安装，选择需要的语言，点击 OK。

  1. 选择要安装的位置，点击 Next。

  1. 点击 Next。

  1. 勾选 Create a desktop shortcut （创建桌面快捷方式），点击 Next。

  1. 点击 Install 进行安装。

  1. 勾选 Launch Tflash，点击 Finish 完成安装。

  1. 如果出现下面报错，点击 是(Y)，进行跳转，按照提示下载需要的安装包。

  1. 双击下载的安装包， 点击 安装。

  1. 点击 关闭(C)， 完成安装。

  1. 安装完成后，可在桌面和“开始”菜单中看到 Tflash 图标，如下图所示：

Ubuntu 环境下驱动安装​

安装Tflash​

  1. 点击此处下载 Tflash(镜像烧录工具)

  2. 执行命令安装 Tflash。

    sudo dpkg -i Thundercomm-tflash-v1.0.0.deb

  3. 安装完成后，请在终端中执行 tflash 命令。如出现以下界面，表明 Tflash 已安装成功：

镜像下载​

RUBIK Pi 3 出厂预装 Linux 镜像供您快速进行开箱操作体验（非最新版本），如需体验最新版本的 Linux 镜像，或其他操作系统镜像，请访问 RUBIK Pi 3 官方网站 进行下载。

如您需要 Linux 源码，请访问 GitHub 进行下载。

  • Qualcomm Linux ：基于weston的桌面系统，系统较为精简，适合具备 Linux 开发经验，追求深度开发体验的开发者。

  • Debian 13：基于GNOME 48 桌面系统，系统功能完善，丰富的软件包资源，有更多的桌面应用，更好的使用体验，较多的开发资料，适合追求开发便捷的开发者。

  • 安卓 13：基于谷歌 AOSP，系统完善，有更好的使用体验，适合想做安卓应用的开发者。

镜像烧录​

镜像烧录前，首先进入烧录模式（9008模式）：

注意

  • 请勿徒手接触 PCB 板载元件及金属触点

  • 操作前需通过接地设备（如防静电工作台/腕带）释放静电

  • 禁止将电路板直接置于导电表面（金属台面/未接地机箱等）

方法1：

  1. 按住上图 12 的 EDL 按钮。

  2. 将供电线接入到上图 10。

  3. Type-C 数据线插入上图 5 等待 3 秒，进入 9008 模式。

方法2：

  1. 将供电线接入到上图 10。

  2. Type-C 数据线插入上图 5。

  3. 在 RUBIK Pi 3 开机后，输入如下命令，进入 9008 模式。

    adb shell reboot edl

Windows 烧录方法​

操作流程​

  1. 打开 Tflash 软件， 如下图，确定设备进入 9008 模式：

  2. 根据需要烧写设备的存储类型，选择正确的 Storage Type ，RUBIK Pi 3 为 UFS。

  1. 按需选择 Reset After Download 和 Erase All Before Download，请谨慎选择 Erase All Before Download。

    • Reset After Download：勾选后，烧写完成后设备将自动重启。

    • Erase All Before Download：勾选后，烧写前会对 RUBIK Pi 3 UFS 各分区中的数据进行擦除。

    备注
    • Reset After Download 和 Erase All Before Download 并不是必选项，可以都不勾选。
    • 只有烧写前后的 UFS 分区一致，勾选 Erase all Before Download 才会擦除数据。
    • 不同系统的镜像互相烧录时，如安卓 -> Debian，推荐勾选 Erase all Before Download。

  2. 烧写 FlatBuild Image：

    1. 点击Browse。

    2. 进入 FlatBuild 目录 ，选择 Programmer File，并选择 prog_firehose_ddr.elf，点击打开。

    3. 选择所有名称以 “rawprogram” 开头的 xml 文件，点击打开。

    4. 选择所有名称以 "patch" 开头的 xml 文件，点击打开。

      设置完成后，可从 Tflash 界面获取相关设置。

    5. 点击 Download 开始刷机。

      备注

      烧写时间因个人电脑而异。在烧写过程中，可通过绿色进度条查看烧写进度。

      烧写成功后，界面会显示如下 log：

    • 如已勾选 Reset After Download，则开发板将在烧写完成后自动重启；

    • 如未勾选 Reset AfterDownload，断开电源线和 USB 线，使 RUBIK Pi 3 断电，再重连电源并按下 PWR 按钮启动开发板。

烧录后无法启动的解决方法​

若烧录失败或烧录后无法启动（下图红框中的心跳灯始终未闪烁），可尝试对 UFS 重新进行配置（provision）。

注意

进行 provision 后，UFS 中存储的一些信息会丢失，如 SN号、以太网 MAC 地址等。

UFS 重新配置过程：

  1. 进入 9008 模式。

  2. Storage Type 选择 UFS ，并勾选 Provision。

  3. 烧写 Provision 文件。

    1. 点击 Browse。

    2. 进入镜像包中的 provision 目录，选择 prog_firehose_ddr.elf，并点击 打开。

    3. 选择 provision_ufs_1_3 文件，并点击 打开。

    4. Log 中显示 “Load Image PATCH Successfully!” 后，点击 Download ，开始 Provision 刷机。

      Provison 刷机完成后，界面会显示如下 log:

      注意

      Provison 刷机完成之后，需要手动插拔电源线和 USB 线重启设备。

Ubuntu 烧录方法​

操作流程​

  1. 进入 FlatBuild 包目录。

  2. 执行 tflash -r。

    备注

    • 更多参数，可使用 tflash -h 命令查看。这里 -r 表示烧录完成后重启 RUBIK Pi 3。

    • 不同系统的镜像互相烧录时，如安卓 -> Debian，推荐加入-e参数（Erase All Before Download）。

  3. 屏幕上出现提示 “Stop the ModemManager on your host PC and press Enter on your keyboard to continue...” 时，按 Enter 键进行刷机；

    tflash 运行结束后，如显示以下界面，则说明烧写成功。

备注

在 PC 上执行 tflash 时，需根据提示输入个人电脑的登录密码。

  • 使用-r参数烧写成功后，RUBIK Pi 3 自动重启。
烧录后无法启动的解决方法​

若烧录失败或烧录后无法启动（下图红框中的心跳灯始终未闪烁），可尝试对 UFS 重新进行配置（provision）。

注意

进行 provision 后，UFS 中存储的一些信息会丢失，如 SN号、以太网MAC地址等。

  • UFS重新配置过程：
  1. 进入9008模式。

  1. 进入镜像包的 provision 目录，运行 tflash -E 命令，输入y，回车。

  1. 屏幕上出现提示 “Stop the ModemManager on your host PC and press Enter on your keyboard to continue...” 时，按 Enter 键进行刷机；

tflash 运行结束后，如显示以下界面，则说明烧写成功。

注意

Provison 刷机完成之后，需要手动插拔电源线和 USB 线重启设备。

开机​

对于旧版本的 RUBIK Pi 3 开发板，接入电源并按下 PWR 按键开机。对于 V02 及后续版本的开发板，接入电源后自动触发开机。

登录​

连接 HDMI 显示器开机，并接入鼠标键盘；首次开机时会运行初始化程序，如下所示。

按照指引完成语言、时区、Wi-Fi、帐号的注册，即可登录到 GNOME 桌面。

备注

在 Debian 13 镜像中，默认已经注册了 root 用户，也可使用如下命令，在未使用图形引导程序时登录 root 用户。

adb shell
su

关机​

  • 点击桌面右上角图标后，点击下图位置关机。

  • 或在终端中输入 poweroff 命令关机。

重启​

选择如下一种方法重启：

  • 点击桌面右上角图标后，点击下图位置重启。

  • 或在终端中输入 sudo reboot 命令重启。

  • 或长按 12 秒电源 PWR 按键重启。

串口登录​

Windows​

  1. 将下图 2 号接口使用串口线连接到电脑。

  2. 打开电脑设置，查看设备管理器对应的 COM 口并记录下来。

  3. 访问 https://mobaxterm.mobatek.net/ 下载 MobaXterm ，解压后即可使用。

  4. 打开 MobaXterm ，选择 Session > Serial，设置串口的波特率为 115200。

  5. 点击 OK，按下回车，输入在 登录小节中注册的用户名和对应的密码登录

    root 用户登录：

    帐号：root

    密码：root

Ubuntu​

  1. 连接下图 2 中的串口线到电脑。

  2. 执行命令安装 minicom。

    sudo apt update
    sudo apt install minicom

  3. 输入以下命令检查 USB 端口。

    ls /dev/ttyACM*

  • 输入下面命令打开 minicom， 按下回车，输入在 登录小节中注册的用户名和对应的密码登录。

    sudo minicom -D /dev/ttyACM0 -b 115200

    root 用户登录：

    帐号：root

    密码：root

ADB 登录​

Windows​

准备​

  1. 访问 https://developer.android.google.cn/tools/releases/platform-tools 下载 ADB 和 Fastboot 安装包并进行解压。

  2. 右键 我的电脑 > 属性 > 高级系统设置 > 环境变量；或右键 我的电脑 > 属性， 在搜索栏中输入高级系统设置 > 环境变量。

  3. 选择系统变量中的 Path，点击编辑。

  4. 点击 新建，将 platform-tools 工具在步骤 1 解压的路径填写进去，点击 确定 保存环境变量。

ADB 登录​

按下 Win+R 输入cmd 打开 Windows 终端，在终端输入如下登录到 RUBIK Pi 3：

adb devices # 查看是否有设备连接
adb shell   # 打开adb终端
su # 切换到 root 用户，开启命令补全

Ubuntu​

准备​

  1. 输入如下命令安装 ADB 和 Fastboot 工具：

    sudo apt install git android-tools-adb android-tools-fastboot wget

  2. 更新 udev rules 文件

    1. 使用如下命令打开并修改 51-qcom-usb.rules 文件。

      sudo vi /etc/udev/rules.d/51-qcom-usb.rules

    2. 将如下内容，添加到文件中；若如下内容已经存在，可忽略这一步骤。

      SUBSYSTEMS=="usb", ATTRS{idVendor}=="05c6", ATTRS{idProduct}=="9008", MODE="0666", GROUP="plugdev"

    3. 使用下面命令，重启 udev。

      sudo systemctl restart udev
    备注

    如果 RUBIK Pi 3 已经通过 USB 连接到个人电脑，请插拔 USB 线，重新连接，以使更新的规则生效。

ADB 登录​

在终端输入如下命令登录到 RUBIK Pi 3：

adb devices # 查看是否有设备连接
adb shell   # 打开 adb 终端
su # 切换到 root 用户，开启命令补全

SSH 登录​

Windows​

  1. 获取 IP 地址。

    1. 登录路由器后台或使用其他 IP 扫描软件获取 RUBIK Pi 3 的 IP 地址。

    2. ADB 登录到 RUBIK Pi 3 ，使用 ifconfig 命令获取 IP 地址。

    信息

    IP 地址会随网络环境变化而改变，RUBIK Pi 3 设备名称为 rubikpi。

    1. 按下 Win+R 按键，在弹出的窗口中输入 cmd，点击 确定。

    1. 在终端中输入 ping <IP> 命令，若 RUBIK Pi 3 的 IP 为 10.9.5.59 ，如下所示，查看执行结果。
    ping 10.9.5.59

  2. 进行 SSH 登录。

    1. 打开 MobaXterm 软件。

    1. 点击 Session ，在弹出的界面中选择 SSH。

    1. 输入要登录 RUBIK Pi 3 的 IP，点击 OK。

    1. 输入要登录的用户名回车后，再输入密码，再次回车登录 RUBIK Pi 3。

    1. 成功登录。

Ubuntu​

  1. 确定连接状态

    1. 登录路由器后台或使用其他 IP 扫描软件获取 RUBIK Pi 3 的 IP 地址。

      注意

      IP 地址会随网络环境变化而改变，RUBIK Pi 3 设备名称为 rubikpi。

      IP 地址也可以 ADB 登录到 RUBIK Pi 3 ，使用 ifconfig 命令获取。

    2. 在 Ubuntu 终端中输入 ping <IP> 命令，若 RUBIK Pi 3 的 IP 为 10.9.5.59，执行如下命令，查看执行结果。

      ping 10.9.5.59

  2. 进行 SSH 登录

    1. 在 Ubuntu 终端中输入ssh <user>@<IP>命令后回车，如下所示，其中 root 表示要登录的用户，10.9.5.59 表示 RUBIK Pi 3 的 IP。
    ssh root@10.9.5.59
    1. 输入密码后回车，成功登录。

文件传输​

ADB​

  • 在PC终端中使用下面命令，上传文件 test.txt 到 /opt目录。

    adb push test.txt /opt

  • 在 PC 终端中使用下面命令，下载文件 test.txt 到 PC 当前目录。

    adb pull /opt/test.txt ./

SCP​

SCP 传输需要 RUBIK Pi 3 正常联网，若 RUBIK Pi 3 的 IP 为 10.9.5.59， 在终端可输入下面命令：

备注

RUBIK Pi 3 的 IP 可通过在 RUBIK Pi 3 中输入ifconfig命令获取。

  • 在 PC 终端中使用下面命令，上传文件 test.txt 到 /opt目录。

    scp test.txt root@10.9.5.59:/opt

  • 在 PC 终端中使用下面命令，下载文件到 PC 当前目录。

    scp root@10.9.5.59:/opt/test.txt ./

Linux kernel​

备注

Debian V1.0.0 版本镜像未提供 linux kernel 源码，linux kernel 源码将在后续发布的稳定版本中提供。