快速上手

本节教程将指导您快速上手使用瑞莎 NX4，配合瑞莎 NX4 载板，帮助您快速验证瑞莎 NX4 功能。

产品实物

瑞莎 NX4 开发套件由瑞莎 NX4 和瑞莎 NX4 载板组成，可用于快速验证核心板功能。

产品实物	序号	视图	序号	视图	序号	视图
瑞莎 NX4 开发套件	①	俯视图	②	侧视图	③	背视图

使用前提

您需要提前准备以下硬件设备：

• 瑞莎 NX4 开发套件
• 供电：DC 5525 电源适配器（9 - 20V）
• 系统启动介质：板载 eMMC
• 显示设备：HDMI 数据线和显示器
• 输入设备：键盘和鼠标（用于图形界面操作）

推荐配件

• 瑞莎 DC 60W 电源适配器(推荐使用)
• 支持 9-20V 的 DC 电源适配器进行供电，推荐功率 40W 及以上

安装系统

主要介绍安装系统到瑞莎 NX4 的板载 eMMC。

重要提醒

安装系统会完全格式化 eMMC，所有数据将被永久删除！

请在操作前确认：

• eMMC 中无重要数据或已完成资料备份

安装 RKDevTool

RKDevTool 是瑞芯微（Rockchip）平台为 Windows/Linux/macOS 平台下进行 USB 烧录所开发的软件，旨在简化和加速对瑞芯微系列芯片的开发、调试过程。

Windows

• 安装驱动

下载并解压 DriverAssistant v5.14 文件。

找到 DriverInstall.exe 文件并以管理员身份运行：

安装驱动： 点击 Install Driver 选项

卸载驱动： 点击 Uninstall Driver 选项

提示

若之前安装过其他版本驱动，请先卸载再安装驱动

• 下载 RKDevTool 工具

下载 RKDevTool 工具，然后解压下载的文件，其中 RKDevTool.exe 就是可执行程序，直接双击可以打开使用软件。

Linux

• 安装 rkdeveloptool

打开系统终端或命令行，运行以下命令进行安装。

Linux$

sudo apt-get update
sudo apt-get install -y libudev-dev libusb-1.0-0-dev dh-autoreconf pkg-config libusb-1.0 build-essential git wget
git clone https://github.com/rockchip-linux/rkdeveloptool
cd rkdeveloptool
autoreconf -i
./configure
make -j $(nproc)
sudo cp rkdeveloptool /usr/local/sbin/

• 验证版本号

完成 RKDevTool 安装后，使用以下命令可以查看 RKDevTool 版本号。

Linux$

rkdeveloptool -V

macOS

• 安装 HomeBrew

HomeBrew 是一个免费且开源的包管理器，它简化了 macOS 用户安装软件的过程。

若没有安装 HomeBrew，可以按照教程进行安装。

macOS$

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

• 安装 rkdeveloptool

打开系统终端或命令行，运行以下命令进行安装。

推荐

推荐通过第三方 Homebrew Tap 直接安装，无需手动编译：

macOS$

brew tap IgorKha/rkdeveloptool
brew install rkdeveloptool

从源码编译（备选）

如果 Tap 安装失败，也可以从源码编译。macOS 不支持 $(nproc)，请使用 make 直接编译。main.cpp 中使用了可变长度数组（VLA），macOS 的 Clang 默认不允许在 C++ 中使用 VLA，需要先将变量声明为 const。

macOS$

brew install automake autoconf libusb pkg-config
git clone https://github.com/rockchip-linux/rkdeveloptool
cd rkdeveloptool
autoreconf -i
./configure
sed -i '' 's/int nSectorSize = 512;/const int nSectorSize = 512;/' main.cpp
make
cp rkdeveloptool /opt/homebrew/bin/

• 验证版本号

完成 RKDevTool 安装后，使用以下命令可以查看 RKDevTool 版本号。

macOS$

rkdeveloptool -V

进入 Maskrom 模式

• Maskrom 模式说明

在瑞芯微（Rockchip）平台的开发中，RKDevTool 是常用的烧录工具，我们可以让主板进入 Maskrom 模式后使用 RKDevTool 进行固件的烧录。

提示

Maskrom 模式是嵌入式设备的“硬件急救箱”，通过直接操作芯片底层接口实现设备修复。

Maskrom 模式是 Rockchip 芯片内置的底层恢复模式，当设备无法从任何启动介质( eMMC、 SD 卡等)加载有效引导程序时自动进入系统时，我们可以通过通过 RockUSB 协议重新烧写设备固件。

• 进入 Maskrom 模式

我们的主板上有一个专用的 Maskrom 按键，在给主板上电前按住 Maskrom 按键，通电后系统检测到 Maskrom 按键被按下，主板就会自动进入 Maskrom 模式。

详细步骤：

① : 按住 Maskrom 按键

② : 使用电源适配器给主板上电

③ : 松开 Maskrom 按键

④ : 使用数据线连接主板的 OTG 端口和电脑的 USB 端口

主板进入 Maskrom 模式后，我们可以使用 RKDevTool 工具验证主板是否进入 Maskrom 模式。

• 验证 Maskrom 模式

Windows

在 Windows 平台，我们可以打开 RKDevTool 工具，软件会自动识别主板是否进入 Maskrom 模式。

若主板进入 Maskrom 模式，软件左下角会显示 Found One MASKROM Device。

Linux / macOS

在 Linux / macOS 平台，我们可以使用 RKDevTool 工具验证主板是否进入 Maskrom 模式。

使用 rkdeveloptool ld 命令可以查看主板是否进入 Maskrom 模式。

Linux / macOS$

sudo rkdeveloptool ld

若系统终端输出类似以下信息，说明主板已经进入 Maskrom 模式。

Linux / macOS$

DevNo=1	Vid=0x2207,Pid=0x350e,LocationID=109 Maskrom

安装系统到 eMMC

使用 RKDevTool 工具将系统镜像烧录到 eMMC 上。

重要提醒

安装系统到 eMMC 中，需要确保主板已经进入 Maskrom 模式且被系统正常识别。

需要的 Loader 文件和系统镜像可以访问 资源汇总下载 页面下载。

Windows

在 Windows 平台，我们可以打开 RKDevTool 工具，然后按照以下步骤安装系统到 eMMC 上。

① : 选择主板对应的 Loader 文件

② : 选择主板对应的系统镜像文件（下载后的镜像压缩包需要先解压）

③ : 选择 eMMC 选项作为系统存储介质

④ : 勾选 Write by Address 选项

⑤ : 点击 RUN 选项执行所有操作

⑥ : 可以通过该界面观察操作进度

断开主板与 PC 的连接，然后重新插拔电源，系统会自动从 eMMC 启动。

Linux / macOS

在 Linux / macOS 平台，我们可以终端命令行，然后按照以下步骤安装系统到 eMMC 上。

1. 运行 Loader 文件

将下面命令中的 demo.bin 替换为主板对应的 Loader 文件。

Linux / macOS$

sudo rkdeveloptool db demo.bin

2. 安装系统镜像

将下面命令中的 demo.img 替换为主板对应的系统镜像。

Linux / macOS$

sudo rkdeveloptool wl 0 demo.img

3. 重启系统

断开主板与 PC 的连接，然后重新插拔电源，系统会自动从 eMMC 中启动。

Linux / macOS$

sudo rkdeveloptool rd

启动系统

完成系统的安装后，连接 HDMI 显示器，重新插拔电源适配器，即可启动系统。

① ：使用 HDMI 数据线连接显示器和主板

② ：使用电源适配器给瑞莎 NX4 开发套件供电

系统启动正常后，瑞莎 NX4 载板上的电源指示灯绿色亮起，瑞莎 NX4 上的状态指示灯蓝色闪烁。

登录系统

当您首次启动系统后，需要使用默认的用户名和密码登录。

Radxa OS 的默认凭据如下：

项目	内容
用户名	radxa
密码	radxa

使用系统

成功登录系统后，您就可以在瑞莎 NX4 开发套件上进行系统配置与开发。