Radxa Cubie A5E 刷机教程:SD 卡、eMMC、NVMe 安装 Radxa OS
Cubie A5E 装系统:选 r7 KDE 或 CLI 镜像写入 microSD 卡,从 SD 卡用 dd 装进板载 eMMC,用 rsetup 写 SPI 引导后装到 NVMe,附默认账号、SSH 和救砖方法。约 20 分钟。
适用于Radxa Cubie A5E 官方系统镜像
先确认是 Cubie A5E
Cubie A5E 用的是全志 A527(工业版为 T527)芯片,和同系列的 Cubie A7A、A7S、A7Z(全志 A733)不能互刷镜像。
| 看哪里 | Cubie A5E | Cubie A7A / A7S / A7Z |
|---|---|---|
| 芯片 | 全志 A527 或 T527 | 全志 A733 |
| 网口 | 2 个千兆网口 | A7A、A7S 各 1 个,A7Z 没有网口 |
| 固态硬盘 | 板上直接有 M.2 M Key 2230 插槽 | 需要通过 PCIe FPC 排线扩展 |
| 系统存储 | microSD + 可选板载 eMMC | 各型号不同,见 Cubie A7A / A7S / A7Z 刷机教程 |
Radxa 的 Cubie A5E 下载页只列出一套镜像,没有按 A527 / T527 分别提供。板载 eMMC 是选配的(8 GB、16 GB、32 GB),没有 eMMC 的版本在 eMMC 位置是空焊盘。
准备
- 电源:5V USB-C 电源,支持 PD,电流 3A 以上。Radxa 推荐官方 PD 30W 电源。
- 存储:microSD 卡(U1 或更高等级)。装到 eMMC 或 NVMe 也要先用 SD 卡开机。
- 一台电脑和读卡器。
- 想装到固态硬盘时:一块 M.2 2230 NVMe 固态硬盘。
下载哪个文件
打开 Radxa Cubie A5E 系统镜像页,当前版本是 rsdk-r7,有两个文件:
| 文件 | 说明 |
|---|---|
radxa-cubie-a5e_bullseye_kde_r7.output_512.img.xz | Debian 11 KDE 桌面版,接显示器用,新手选这个 |
radxa-cubie-a5e_bullseye_cli_r7.output_512.img.xz | Debian 11 命令行版,没有桌面,适合不接显示器 |
两个都是带 GPT 分区表的整盘镜像(Radxa 称为“GPT 系统镜像”),可以写入 microSD 卡、板载 eMMC 或 NVMe。Radxa 下载页把 r7 标为“最新”并推荐使用。
注意Radxa 在 GitHub 上把 Cubie A5E 的所有版本(包括 r7)都标成了预发布,版本说明里写着不对预发布和测试版提供支持。GitHub 上还有 t 开头的更新测试版,Radxa 下载页没有列出,本站也没有收录。
下载后核对页面上的 SHA-256,方法见 如何核对下载文件的 SHA-256。
方法一:装到 microSD 卡(最简单)
- 用 7-Zip 把
.img.xz解压成.img。Radxa 要求用 balenaEtcher 写入前先解压;用 Raspberry Pi Imager 可以直接选.img.xz。 - 打开 balenaEtcher,点“从文件烧录”(Flash from file)选镜像,点“选择目标”(Select target)选你的 microSD 卡,再点“现在烧录”(Flash!),等写入和校验都完成。
- 把卡插进板子的 microSD 卡槽,接好 HDMI 显示器、键盘鼠标,最后插上 USB-C 电源。
应看到:电源指示灯亮绿色;系统正常启动后,状态指示灯蓝色闪烁,显示器出现桌面。
警告写入会清空整张卡。选目标时看清容量,别选成电脑上的硬盘。
方法二:装到板载 eMMC
只适用于带板载 eMMC 的版本。Radxa 的做法是先用 SD 卡开机,再在板子上用 dd 写入。
- 按方法一做好 SD 卡并开机,连上网络。
- 把镜像文件拷到板子上(浏览器下载、U 盘或 scp 都可以),然后解压:
sudo apt install xz-utils -y
unxz radxa-cubie-a5e_bullseye_kde_r7.output_512.img.xz- 运行
lsblk,按容量找出 eMMC。eMMC 一般显示为/dev/mmcblk开头的设备,Radxa 的示例里是mmcblk1;当前正在运行的 SD 卡也是mmcblk开头,别选错。 - 写入 eMMC(把
mmcblk1换成你确认过的设备名):
sudo dd if=radxa-cubie-a5e_bullseye_kde_r7.output_512.img of=/dev/mmcblk1 bs=4M status=progress- 写完再运行一次
lsblk,应看到 eMMC 下出现 3 个新分区。 - 关机、断电,取下 microSD 卡,再插电源。
应看到:绿灯亮、蓝灯闪烁,系统从 eMMC 启动。
警告dd 会覆盖目标盘的全部数据。设备名写错可能把正在用的 SD 卡或别的盘清空。
提示Radxa 另有一种 FEL 镜像,用 PhoenixSuit 工具通过 USB 线刷 eMMC(按住 UBOOT 键接电脑进入 FEL 模式)。那是另一类镜像,本站暂未收录,本页的 GPT 镜像不需要这个工具。
方法三:装到 NVMe 固态硬盘
Cubie A5E 要先往板载 SPI 闪存里写入引导程序,才能从 NVMe 启动。
- 按方法一做好 SD 卡并开机,连上网络。
- 运行
sudo rsetup,进入 System → System Update,按提示更新系统,完成后sudo reboot重启。 - 再次运行
sudo rsetup,进入 System → Bootloader Management → Update SPI Bootloader,用空格键选中radxa-cubie-a5e(出现*),按回车,按提示完成后重启。 - 写入系统。有 NVMe 硬盘盒的话,在电脑上用 balenaEtcher 把解压后的
.img写入固态硬盘,方法同方法一;没有硬盘盒就把固态硬盘装进板子的 M.2 2230 插槽,在板子上运行lsblk确认看到nvme0n1,然后执行:
sudo dd if=radxa-cubie-a5e_bullseye_kde_r7.output_512.img of=/dev/nvme0n1 bs=4M status=progress- 关机、断电,取下 microSD 卡,装好固态硬盘后上电。
应看到:绿灯亮、蓝灯闪烁,系统从 NVMe 启动。
提示几种存储同时插着时,Radxa 公布的启动顺序是 microSD 卡 > NVMe > 板载 eMMC。只要插着能启动的 SD 卡,就会先从 SD 卡启动。
第一次开机
- 默认账号:
radxa,密码radxa。登录后请先改密码。 - 主机名:
radxa-cubie-a5e。 - SSH:第一次开机时没有接显示器,系统会自动开启 SSH。接了显示器的话,在终端运行
sudo systemctl enable --now ssh开启;提示没有这个服务就先运行sudo apt update && sudo apt install openssh-server -y。 - 找 IP:登录路由器后台看名为
radxa-cubie-a5e的设备,然后在电脑上运行ssh radxa@板子的IP。 - 不接网线用 Wi-Fi:写好 SD 卡后先别拔,打开卡上的
before.txt,加一行connect_wi-fi 你的WiFi名 你的WiFi密码,保存后再插回板子。板载 Wi-Fi 要装上随板附带的天线,信号才稳定。更多方法见 开发板无显示器首次配置。
刷坏了怎么救
- eMMC 或 NVMe 里的系统起不来:因为 microSD 卡启动优先,重新做一张 SD 卡插上就能开机,再按方法二或方法三重新写入。
- 装了 NVMe 不启动:从 SD 卡开机,在
rsetup里重新执行 Update SPI Bootloader,确认选的是radxa-cubie-a5e。 - 想取消 NVMe 引导:在
rsetup里选 System → Bootloader Management → Erase SPI Bootloader。擦除后就不能从 NVMe 启动了。 - 系统没起来、蓝灯不闪:先确认写入的是解压后的
.img,重新下载并核对 SHA-256 后再写一次;再检查电源是否达到 5V 3A。 - 想看启动日志:用 USB 转 TTL 串口,波特率 115200,接 40 针排针的 6 号脚(GND)、8 号脚(TX)、10 号脚(RX),不要接 VCC。详见 用 USB 转 TTL 串口调试开发板。
资料来源
按 Radxa 官方文档(Cubie A5E 快速上手、安装系统、硬件接口、系统配置与资源汇总下载,2026-10-22 查阅)和 Radxa 在 GitHub 发布的 rsdk-r7 版本说明整理。
提示本页按厂商官方文档整理,本站没有在实机上测试。按键位置和文件名以你的板子和 Radxa 官方说明为准。
整理:AppGoBox · 依据 · 本站未在实机上逐一验证