Radxa ZERO 2 PRO 刷机教程：SD 卡与 eMMC 安装 Radxa OS

先确认是 ZERO 2 PRO

Radxa 的 ZERO 系列有三代，外形接近，但主芯片不同，系统镜像不能混用。

ZERO 2 PRO 的 eMMC 是可选配置，焊在板子背面；没有 eMMC 的版本只能用 microSD 卡。

准备

• 电源：5V，额定电流大于 2A，接 USB OTG（供电）口。Radxa 推荐官方 PD 30W 电源。
• microSD 卡（装桌面版至少 16 GB，推荐 32 GB）和读卡器。
• 显示器（可选）：Micro HDMI 转 HDMI 线。另一个 USB-C 是 USB 3.0 口，可以接 Hub，但不能输出画面。
• 刷板载 eMMC 时：一根 USB-A 转 USB-C 数据线和一台电脑。
• 联网：板子没有网口，用板载 Wi-Fi。

下载哪个文件

打开 Radxa ZERO 2 PRO 系统镜像页：

Radxa GitHub 上还有 t1、t2 等测试版（预发布），Radxa 说明不对预发布版提供支持。SD 卡和 eMMC 用的是同一个镜像。下载后核对页面上的 SHA-256，方法见 如何核对下载文件的 SHA-256。

方法一：装到 microSD 卡

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

应看到：系统开始启动，接了显示器的话会进入桌面。

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

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

ZERO 2 PRO 是 Amlogic 芯片，不用 Rockchip 的 RKDevTool，也不用 Amlogic 的 USB Burning Tool。Radxa 的做法是：先让板子进入 Maskrom 模式，从电脑加载一个“擦除 eMMC”的小程序 radxa-zero-2pro-erase-emmc.bin，它会清空 eMMC 并把 eMMC 变成电脑上的一个 U 盘，然后像写 SD 卡一样写进去。这个文件和下面的 Windows 工具本站暂未收录，从文末“官方资料”进入 Radxa 页面获取（Radxa 页面上显示的文件名是 radxa-zero2-2pro-erase-emmc.bin，以你实际下载到的文件名为准）。

警告这个加载器会清空板载 eMMC 里的全部数据。

进入 Maskrom 模式

1. 拔掉电源。建议同时取出 microSD 卡。
2. 按住 USB BOOT 按键（Radxa 硬件接口说明里叫 Maskrom 按钮）。板子边缘 Micro HDMI 和 USB-C 口之间有两个小按键，Radxa 写明一个是开关机用的 Power 按钮，一个是 Maskrom 按钮；具体哪一个以 Radxa 接线图为准。
3. 用 USB-A 转 USB-C 线，把电脑的 USB 口接到板子的 USB OTG 口。
4. 松开 USB BOOT 按键。

Windows

1. 用 Zadig 给板子装驱动：确认列表里显示的设备是 GX-CHIP、USB ID 是 1B8E:C003，驱动选 libusb-win32，点 Install Driver。
2. 打开 Radxa 的 RZ USB Boot Helper。

应看到：工具界面显示当前处于 Maskrom 模式。

1. 点 Select 选择 radxa-zero-2pro-erase-emmc.bin，再点 Run。

应看到：电脑上出现一个新的 USB 存储设备，这就是板子的 eMMC。

1. 打开 balenaEtcher，像方法一那样把镜像写到这个新出现的磁盘上。
2. 写完后拔掉 USB 线，接 5V 电源正常上电，系统从 eMMC 启动。

Linux 和 macOS

Radxa 用 Python 工具 pyamlboot 加载同一个文件：

sudo pip3 install pyamlboot
sudo boot-g12.py radxa-zero-2pro-erase-emmc.bin

macOS 先用 Homebrew 装好 python、libusb，再 pip3 install pyamlboot，命令不用加 sudo。之后电脑会认到一个 USB 存储设备，用 balenaEtcher 写入镜像即可。

提示eMMC 和 SD 卡里都有系统时先从哪个启动，Radxa 没有说明。装好后只保留一个系统盘最省事。

第一次开机

• 默认账号：radxa，密码 radxa。登录后请先改密码。
• 主机名：radxa-zero-2pro。
• 不接显示器时连 Wi-Fi：写完 SD 卡后先别拔，在卡上的配置分区里找到 before.txt，加一行 connect_wi-fi 你的WiFi名 你的WiFi密码，保存后再插回板子开机。
• SSH：Radxa 说明第一次开机时没有接显示器，系统会自动开启 SSH。接了显示器的话，在终端运行 sudo systemctl enable --now ssh 手动开启。
• 找 IP：在路由器后台找名为 radxa-zero-2pro 的设备，或者用串口登录后运行 ip a，然后在电脑上运行 ssh radxa@板子的IP。

刷坏了怎么救

• eMMC 里的系统起不来：按上面的方法进 Maskrom 模式，重新加载 radxa-zero-2pro-erase-emmc.bin，清空后再写一次镜像。
• 电脑认不到板子：Windows 下先确认 Zadig 装的是 libusb-win32 驱动，设备 ID 是 1B8E:C003；换一根能传数据的 USB 线，重新按住 USB BOOT 键再插线。
• 看启动日志：Amlogic 平台的串口参数是 115200、8N1、无流控。用 USB 转 TTL 串口接 40 针排针的 6 脚（GND）、8 脚（TX）、10 脚（RX），不要接串口线的供电线。详见 用 USB 转 TTL 串口调试开发板。

资料来源

按 Radxa 官方文档（ZERO 2 PRO 资源下载汇总、安装操作系统、安装系统到 eMMC、硬件接口说明、无屏模式、UART 串口控制台，2026-10-22 查阅）和 Radxa 在 GitHub 发布的 rsdk-r2 版本说明整理。

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