Radxa E54C 刷机教程：SD 卡、eMMC、NVMe 安装 Debian 与救砖

先确认是 E54C，以及有没有板载 eMMC

E54C 是 Radxa 的四网口小主机，主芯片 Rockchip RK3582，只支持 12V DC 供电。它和 Radxa E52C（两个 2.5G 网口、5V USB-C 供电、没有 HDMI）镜像不同，不能混用。

E54C 有带 eMMC（8–128 GB）和不带 eMMC 几种配置：

• 带 eMMC：出厂已装好 iStoreOS，上电就能用。想换成 Debian，按方法二线刷 eMMC。
• 不带 eMMC：用 microSD 卡（方法一），或者再装到 NVMe（方法三）。

准备

• 电源：12V DC 适配器（5.5 × 2.5 mm），Radxa 常见问题建议 12V/3A，推荐官方 DC12 36W。不要接 5V。
• microSD 卡和读卡器。
• 一根 USB-A 转 USB-C 数据线：接 Type-C 调试口，用来看串口和线刷。
• 一根插针或牙签（按 Maskrom 键）。
• 网线；需要时准备 M.2 2280 NVMe 固态硬盘。

下载哪个文件

打开 Radxa E54C 系统镜像页：

注意E54C 在 Radxa GitHub 上目前没有正式版。b2 和其他各版（b1、t1、t2）都标为预发布，而 Radxa 的版本说明写明不对预发布版提供支持。b2 是 Radxa 下载页指定的镜像，所以本站收录这一版；遇到问题时请以 Radxa 后续发布为准。

出厂的 iStoreOS、Radxa 页面上的 OpenWrt 镜像本站未收录。下载后核对页面上的 SHA-256，方法见 如何核对下载文件的 SHA-256。

方法一：装到 microSD 卡

1. 用 7-Zip 把 .img.xz 解压成 .img。Radxa 的教程要求用 balenaEtcher 写入前先解压；用 Raspberry Pi Imager 可以直接选 .img.xz。
2. 打开 balenaEtcher，点“从文件烧录”选镜像，点“选择目标”选你的 microSD 卡，再点“现在烧录”，等到显示完成。
3. 把卡插进 microSD 卡槽，插上 12V DC 电源。

应看到：SYS 指示灯开始闪烁，系统自动启动。

警告写入会清空整张卡。选目标时看清容量，别选成电脑上的硬盘。

提示带 eMMC 的 E54C 同时插着 SD 卡时先从哪个启动，Radxa 没有说明。想长期用 Debian，建议按方法二写进 eMMC 或按方法三装到 NVMe。

方法二：装到板载 eMMC（MaskROM 线刷）

需要本站的 RKDevTool 和驱动助手，以及 Radxa 下载页上的 Loader 文件 rk3588_spl_loader_recommended.bin（本站暂未收录，从文末“官方资料”进入 Radxa 页面获取）。刷 Debian 或别的镜像都用这个 Loader。RKDevTool 界面有中文和英文两种，下面按钮名两种都写上。

进入 MaskROM 模式

1. 断开电源。
2. 用 USB-A 转 USB-C 线，把电脑接到 E54C 的 Type-C 调试口。
3. 用插针按住 MASKROM 孔里的按键。
4. 按住不放，插上 12V DC 电源，然后松开。

应看到：电源指示灯常亮；RKDevTool 窗口底部显示“发现一个MASKROM设备”（英文界面为 Found One MASKROM Device）。在 Linux 上用 lsusb 会同时看到一个 CH340 串口设备和一个 Rockchip（2207）设备。

Windows：用 RKDevTool 写入

1. 运行驱动助手里的 DriverInstall.exe（以管理员身份运行），点“驱动安装（Install Driver）”。装过旧版就先点“驱动卸载（Uninstall Driver）”。
2. 用 7-Zip 把镜像解压成 .img。RKDevTool 不会自动解压。
3. 按上面的步骤进入 MaskROM 模式，打开 RKDevTool.exe。
4. 在“下载镜像（Download Image）”页：Loader 一栏选 rk3588_spl_loader_recommended.bin，镜像一栏选解压后的 .img；存储选 EMMC；勾选“强制按地址写（Write by Address）”；点“执行（Run）”。

应看到：提示下载完成，设备自动重启。

1. 拔掉 USB 线，重新上电，系统从 eMMC 启动。

Linux 和 macOS：用 rkdeveloptool

xz -d radxa-e54c_bookworm_cli_b2.output.img.xz
sudo rkdeveloptool ld
sudo rkdeveloptool db rk3588_spl_loader_recommended.bin
sudo rkdeveloptool wl 0 radxa-e54c_bookworm_cli_b2.output.img
sudo rkdeveloptool rd

ld 能列出一台 Maskrom 设备，才说明连接正常。

方法三：装到 NVMe 固态硬盘

E54C 要靠 SPI 闪存里的引导程序才能从 NVMe 启动。Radxa 的做法是先用 SD 卡（或 eMMC）开机，在系统里更新 SPI 引导，再把镜像写进 NVMe：

1. 按方法一做好 SD 卡，确认能正常开机后关机断电，把 NVMe 装进 M.2 插槽。
2. 开机登录，运行 rsetup，依次选 System → System Update，按提示完成更新后重启。
3. 再次运行 rsetup，选 Overlays → Manage Overlays，找到 Enable SPI Flash，按空格打上 *，回车确认，完成后重启。SPI 闪存默认是关闭的，不打开就写不进去。
4. 再次运行 rsetup，选 System → Bootloader Management → Update SPI Bootloader，有多个选项时优先选带 spi 后缀的，按提示完成后重启。
5. 运行 lsblk，确认能看到 nvme0n1（SPI 闪存显示为 mtdblock0）。
6. 把镜像拷到板子上（wget、U 盘或 scp 都可以），写入 NVMe：

sudo xzcat ~/radxa-e54c_bookworm_cli_b2.output.img.xz | sudo dd of=/dev/nvme0n1 bs=1M status=progress

1. 运行 sudo shutdown -h now 关机，断电，取出 SD 卡，再上电。

应看到：系统起来后运行 lsblk 或 df -h，/dev/nvme0n1p3 挂载在根目录 /，说明已从 NVMe 启动。

警告dd 会覆盖目标盘的全部数据。执行前用 lsblk 再确认一次设备名是 nvme0n1。

第一次开机

• Debian 默认账号：radxa，密码 radxa。登录后请先改密码。出厂 iStoreOS 是另一套系统：后台地址 192.168.100.1，用户 root，密码 password。
• 主机名：radxa-e54c。
• SSH：把网口接到路由器，在路由器后台找名为 radxa-e54c 的设备，运行 ssh radxa@板子的IP。Radxa OS 文档说明，第一次开机没有接显示器时会自动开启 SSH。Radxa 没有说明 Debian 下哪个网口默认取得地址，找不到设备时换一个网口，或者用串口看 ip a。
• 串口：用 USB-A 转 USB-C 线接 Type-C 调试口，波特率 1500000、8N1、无流控。Windows 需要 CH340 驱动。
• 更多说明见 开发板第一次开机与登录。

刷坏了怎么救

• eMMC 里的系统起不来：按方法二进 MaskROM 模式，重新写一次 eMMC。
• 想清空 eMMC：进 MaskROM 后在 RKDevTool 里切到高级选项页（Advanced Function），选好 Loader 点“下载（Download）”，点 ReadCapability 读容量，选 EMMC 后点“切换存储（Switch Storage）”，再点“擦除所有（Erase ALL）”，最后点 ResetDevice 重启。Linux 下生成 64 MB 空文件 dd if=/dev/zero of=zero.img bs=1M count=64，载入 Loader 后 sudo rkdeveloptool wl 0 zero.img。
• 装了 NVMe 不启动：插回 SD 卡开机，在 rsetup 里换一个 Bootloader 选项重新执行 Update SPI Bootloader（优先选最新的），并重新插拔 NVMe。
• 系统启动异常，怀疑 SPI 引导坏了：E54C 出厂就在 SPI 闪存里写好了引导。Radxa 的处理方法是进 MaskROM，在 RKDevTool 里载入 Loader 后点“下载（Download）”，存储选 SPINOR，点“切换存储（Switch Storage）”再点“擦除所有（Erase ALL）”；然后在“下载镜像”页选 Loader、存储 SPINOR、镜像选 Radxa 下载页的 spi.img（本站暂未收录），勾选“强制按地址写（Write by Address）”后点“执行（Run）”重新写回。Linux 下擦除是 sudo rkdeveloptool ef，写回是 sudo rkdeveloptool wl 0 spi.img。

警告只擦除不写回的话，SPI 里的引导没了，依赖它的 NVMe 启动会失效。

• 想回到 iStoreOS：从 Radxa 下载页的 iStoreOS 链接获取镜像（本站暂未收录，文件是 .img.gz，先用 7-Zip 解压成 .img），再按方法二写进 eMMC。iStoreOS 正常运行时长按 USER 键 5 秒会恢复出厂设置；不要一上电就按住 USER 键，那会进入只能用串口操作的安全模式。
• 想看启动日志：接 Type-C 调试口的串口，详见 用 USB 转 TTL 串口调试开发板。E54C 的串口芯片在板上，不需要另外的 USB 转 TTL 线。

资料来源

按 Radxa 官方文档（E54C 资源下载汇总、快速上手、安装系统到 microSD 卡、安装系统到 eMMC、擦除 eMMC、擦除/烧录 SPI 启动固件、安装系统到 NVMe、串口调试、硬件接口说明、电源选择、常见问题，2026-10-22 查阅）和 Radxa 在 GitHub 发布的 rsdk-b2 版本说明整理。

提示本页按厂商官方文档整理，本站没有在实机上测试。按键位置和文件名以你的板子和 Radxa 官方说明为准。