Skip to content

docs: radxa nx5 update tutorial #1684

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Milir-Radxa merged 4 commits into from
Apr 16, 2026
Merged

docs: radxa nx5 update tutorial #1684

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
5ac3eb0
docs: radxa nx5 update tutorial
Milir-Radxa Apr 15, 2026
d3b56d8
docs: radxa nx5 update en tutorial
Milir-Radxa Apr 16, 2026
a4bf5b3
docs: radxa nx5 ai tutorial
Milir-Radxa Apr 16, 2026
4dcf9d4
docs: radxa nx5 android tutorial
Milir-Radxa Apr 16, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 22 additions & 11 deletions docs/common/dev/_rsdk.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@
1. 首先，请安装所需的依赖项：

<NewCodeBlock tip="x86 Linux PC" type="PC">

```bash
sudo apt-get update
sudo apt-get install git qemu-user-static binfmt-support
Expand All @@ -25,6 +26,7 @@ sudo usermod -a -G docker $USER
2. 使用以下命令克隆项目并安装 DevContainer：

<NewCodeBlock tip="x86 Linux PC" type="PC">

```bash
git clone --recurse-submodules https://github.com/RadxaOS-SDK/rsdk.git
cd rsdk
Expand All @@ -39,6 +41,7 @@ rsdk devcon
当终端出现以下所示，表明现在处于 rsdk 的 dev 容器 shell 中

<NewCodeBlock tip="x86 Linux PC" type="PC">

```bash
██████╗ ███████╗██████╗ ██╗ ██╗
██╔══██╗██╔════╝██╔══██╗██║ ██╔╝
Expand All @@ -61,12 +64,10 @@ direnv: export +AR +AS +CC +CONFIG_SHELL +CXX +DETERMINISTIC_BUILD +DEVENV_DOTFI

vscode ➜ /workspaces/rsdk (main) $

````
```

</NewCodeBlock>



仓库详细使用，请参考 [rsdk](https://radxaos-sdk.github.io/rsdk/) 页面。

如需要在 `rsdk` 基础上进行二次开发，则请继续阅读文档 [Build customization](https://radxaos-sdk.github.io/rsdk/tutorials/customize.html)。
Expand All @@ -83,7 +84,7 @@ vscode ➜ /workspaces/rsdk (main) $
git clone --recurse-submodules https://github.com/RadxaOS-SDK/rsdk.git
cd rsdk

````
```

</NewCodeBlock>

Expand Down Expand Up @@ -119,43 +120,45 @@ sudo apt-get update
git clone https://gitcode.com/radxaos-sdk/rsdk.git
sudo tee /etc/apt/sources.list.d/70-radxa.list <<< "deb [trusted=yes] https://mirrors.sdu.edu.cn/radxa-repo/bookworm/ bookworm main"

````
```

:::

2. 安装构建相关依赖并准备构建环境：

<NewCodeBlock tip="x86 Linux PC" type="PC">

```bash

sudo apt-get update
sudo apt-get install devscripts dpkg-dev build-essential
sudo apt build-dep .

````
```

</NewCodeBlock>


3. 构建 deb 包：

<NewCodeBlock tip="x86 Linux PC" type="PC">

```bash

dpkg-buildpackage -us -uc -b

````
```

</NewCodeBlock>

4. 构建成功后，生成的 deb 包位于上级目录（..），可通过以下命令安装：

<NewCodeBlock tip="x86 Linux PC" type="PC">

```bash

sudo apt install ../rsdk\_\*.deb

````
```

</NewCodeBlock>

Expand All @@ -172,6 +175,7 @@ sudo apt install ../rsdk\_\*.deb
- 在下面的示例中，我们选择 **Build system image**：

<NewCodeBlock tip="x86 Linux PC" type="PC">

```bash
┌─────────────────┤ RSDK ├──────────────────┐
│ Please select a task: │
Expand All @@ -183,7 +187,7 @@ sudo apt install ../rsdk\_\*.deb
│ <Ok> <Cancel> │
│ │
└───────────────────────────────────────────┘
````
```

</NewCodeBlock>

Expand All @@ -196,7 +200,10 @@ sudo apt install ../rsdk\_\*.deb

:::

以 rock-5b 为例：

<NewCodeBlock tip="x86 Linux PC" type="PC">

```bash
┌─────────────────┤ RSDK ├──────────────────┐
│ Please select a product: │
Expand All @@ -223,6 +230,7 @@ sudo apt install ../rsdk\_\*.deb
示例：选择 Radxa APT 镜像：

<NewCodeBlock tip="x86 Linux PC" type="PC">

```bash
┌─────────────────┤ RSDK ├──────────────────┐
│ Select Radxa APT mirror (radxa-deb): │
Expand All @@ -245,6 +253,7 @@ sudo apt install ../rsdk\_\*.deb
然后可以选择可选的 Debian/Ubuntu 镜像（或保留默认）：

<NewCodeBlock tip="x86 Linux PC" type="PC">

```bash
┌─────────────────┤ RSDK ├──────────────────┐
│ Select Debian/Ubuntu mirror (optional): │
Expand All @@ -268,6 +277,7 @@ sudo apt install ../rsdk\_\*.deb
确认并开始构建：在镜像配置（如果有）完成后，向导会展示所选产品和镜像的汇总（对应于将要执行的最终 CLI 命令），请仔细检查摘要并选择 **Yes** 开始构建，或选择 **No** 返回修改：

<NewCodeBlock tip="x86 Linux PC" type="PC">

```bash
┌─────────────────┤ RSDK ├──────────────────┐
│ │
Expand All @@ -291,12 +301,13 @@ sudo apt install ../rsdk\_\*.deb
编译结束之后会生成一个 `out` 目录，`output.img` 即最终生成的镜像：

<NewCodeBlock tip="x86 Linux PC" type="PC">

```bash

vscode ➜ /workspaces/rsdk (main) $ ls out/rock-5b_bookworm_kde/
build-image config.yaml debs manifest output.img rootfs.tar seed.tar.xz

````
```

</NewCodeBlock>

Expand Down
2 changes: 1 addition & 1 deletion docs/common/dev/_u-boot.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -75,7 +75,7 @@ cd bsp

:::

然后将产品对应 `profile`: `rk2410` 填入 `bsp` 命令的 `profile` 参数即可拉取与配置代码，例如：
然后将产品对应 `profile`: `rk2410` 填入 `bsp` 命令的 `profile` 参数即可拉取与配置代码，例如：以 rock-5b 为例

```bash
./bsp u-boot rk2410 rock-5b --no-build
Expand Down
2 changes: 1 addition & 1 deletion docs/common/radxa-os/rkdevtool/_use.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -99,7 +99,7 @@ brew install rkdeveloptool

</NewCodeBlock>

:::details 从源码编译（备选）
:::tip 从源码编译（备选）

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

Expand Down
2 changes: 1 addition & 1 deletion docs/common/radxa-os/system-config-debian12/_vnc.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
VNC 远程需要双方设备处于同一局域网下，且目标设备需要开启 VNC 服务。

:::tip 使用说明
VNC 远程控制适合带有图形界面的系统，若系统没有图形化桌面，推荐使用 SSH 远程控制。
VNC 远程控制适合带有图形界面的系统且没有外接显示器的情况，若系统没有图形化桌面，推荐使用 SSH 远程控制。
:::

## 使用 VNC(远程设备)
Expand Down
148 changes: 101 additions & 47 deletions docs/som/nx/nx5/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,81 +1,135 @@
---
sidebar_position: 4
sidebar_position: 3
---

# 瑞莎 NX5

## 产品介绍

<Tabs queryString="target">
<TabItem value="nx5" label="NX5 核心板">
瑞莎 NX5 是一款基于瑞芯微 RK3588S 的高性能核心模组，集成了 4 核 Cortex-A76 + 4 核 Cortex-A55 CPU、ARM Mali-G610 MP4 GPU 和 6 TOPS@INT8 NPU，支持主流深度学习框架。提供丰富的接口和扩展能力，支持 8K 视频编解码，适用于边缘计算、机器视觉、智能终端、多媒体处理等应用场景。

#### 实物照片
瑞莎 NX5 可搭配官方载板快速实现功能验证与原型搭建，方便用户在短时间内完成上电调试、接口评估及应用开发。

- Radxa NX5
![Radxa NX5](/img/nx5/nx5-overview.webp)
## 产品实物

#### 特性
<Tabs queryString="board model">

| Features | Description |
| -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| SoC | Rockchip RK3588S |
| CPU | Quad Cortex®‑A76 @ 2.2~2.4GHz and a quad Cortex®‑A55 @ 1.8GHz<br/>based on Arm® DynamIQ™ configuration |
| GPU | Arm Mali™ G610MP4 GPU ‑ OpenGL® ES1.1, ES2.0, and ES3.2 ‑ OpenCL®<br/>1.1, 1.2 and 2.2 ‑ Vulkan® 1.1 and 1.2 ‑ Embedded high performance 2D<br/>image acceleration module |
| NPU | NPU supporting INT4 / INT8 / INT16 / FP16 / BF16 and TF32 acceleration<br/>and computing power is up to 6TOPs |
| Memory | 1GB, 2GB, 4GB, 8GB or 16GB LPDDR4X (depending on SKU) |
| Storage | Optional 4GB / 8GB / 16GB / 32GB, up to 512GB Onboard eMMC Compatible with eMMC 5.1<br />Supports SDMMC interface for data storage and OS booting using<br />SD cards |
<TabItem value="瑞莎 NX5">

<div style={{textAlign: 'center'}}>
<img src="/img/nx5/radxa-nx5-view.webp" style={{width: '100%', maxWidth: '1200px'}} />
</div>

</TabItem>

<TabItem value="瑞莎 NX5 载板">

瑞莎 NX5 载板集成了丰富的外部接口，可用于快速验证瑞莎 NX5 核心模组的功能，帮助用户轻松完成上电调试、接口评估及初步的应用开发评估。

<div style={{textAlign: 'center'}}>
<img src="/img/nx5/radxa-nx5-io-board-view.webp" style={{width: '100%', maxWidth: '1200px'}} />
</div>

</TabItem>

<TabItem value="瑞莎 NX5 开发套件">

瑞莎 NX5 开发套件由瑞莎 NX5 核心模组、瑞莎 NX5 载板组成，提供了完整的硬件开发平台，可用于快速验证核心板功能、评估性能并搭建原型系统，帮助用户高效完成开发与方案验证。

<div style={{textAlign: 'center'}}>
<img src="/img/nx5/radxa-nx5-dev-kit-view.webp" style={{width: '100%', maxWidth: '1200px'}} />
</div>

</TabItem>

<TabItem value="nx5-io-board" label="NX5 底板">
</Tabs>

#### 实物照片
## 产品规格

| 产品型号 | 瑞莎 NX5 |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| SoC（主控） | 瑞芯微 RK3588S |
| CPU（中央处理器） | 4 核 Cortex-A76 + 4 核 Cortex-A55 |
| GPU（图形处理器） | ARM Mali-G610 MP4<br/>- 支持 OpenGL ES 1.1, 2.0 and 3.2, OpenCL 1.1, 1.3 and 2.2, Vulkan 1.1 and 1.2<br/>- 内嵌高性能2D图像加速模块 |
| NPU（神经网络处理器） | 6 TOPS@INT8<br/>- 支持 INT4 / INT8 / INT16 / FP16 / BF16 / TF32 等计算精度<br/>- 支持 TensorFlow, Caffe, Tflite, Pytorch, Onnx NN, Android NN 等深度学习框架 |
| 内存 | LPDDR4X<br/>- 容量：最高可选 16GB |
| 视频编解码 | 视频编码<br/>- 最高支持 8K@30fps 的 H.265 / H.264 视频编码<br/>视频解码<br/>- 最高支持 8K@60fps 的 AV1 / AVS2 / VP9 / H.265 / H.264 视频解码 |
| 存储 | 可选板载 eMMC<br/>- eMMC 5.1, 最大可选 512GB<br/>板载 SPI Flash（可选）<br/>1x SDMMC |
| 网络 | 1x 千兆以太网 |
| 显示 | 1x HDMI TX<br/>- 最高支持 8K@60Hz<br/>1x eDP TX<br/>- 最高支持 4K@60Hz<br/>1x DP TX<br/>- 最高支持 8K@30Hz<br/>1x MIPI DSI（2 通道） |
| 摄像头 | 2x MIPI CSI（2 通道）或 1x MIPI CSI（4 通道）<br/>1x MIPI CSI（4 通道）<br/>1x MIPI CSI（2 通道） |
| USB | USB 3.1 Gen1<br/> USB 2.0 |
| PCIe | PCIe2.0 |
| 其它接口 | 支持 UART, I2C, I2S, CAN, PWM, GPIOs 等功能 |
| 连接器 | 260-pin SO-DIMM 连接器 |
| 操作系统 | 支持 Debian, Yocto, Buildroot, Android 14 |
| 机械尺寸 | 70 毫米 x 45 毫米 |

## 接口说明

<Tabs queryString="board interface">

<TabItem value="瑞莎 NX5">

<div style={{textAlign: 'center'}}>
<img src="/img/nx5/radxa-nx5-interface.webp" style={{width: '75%', maxWidth: '1200px'}} />
</div>

| 序号 | 说明 | 序号 | 说明 | 序号 | 说明 |
| :--: | :-------------- | :--: | :------------- | :--: | :-------- |
| 1 | LPDDR4X | 2 | 瑞芯微 RK3588S | 3 | 板载 eMMC |
| 4 | 260-pin SO-DIMM | 5 | SPI Flash | | |

</TabItem>

- Radxa NX5-IO
![Radxa NX5 IO](/img/nx5/nx5-io/nx5-io-overview.webp)
<TabItem value="瑞莎 NX5 载板">

<div style={{textAlign: 'center'}}>
<img src="/img/nx5/radxa-nx5-io-board-interface.webp" style={{width: '75%', maxWidth: '1200px'}} />
</div>

| 序号 | 说明 | 序号 | 说明 | 序号 | 说明 |
| :--: | :--------------------- | :--: | :----------------------------- | :--: | :------------------------- |
| 1 | 2x USB 3.1 Gen1 Type-A | 2 | 上：DP 输出 <br/>下：HDMI 输出 | 3 | DC5525 供电接口（5V 输入） |
| 4 | 风扇接口 | 5 | MIPI 摄像头接口 | 6 | MIPI 摄像头接口 |
| 7 | 电源按键 | 8 | Maskrom 按键 | 9 | microSD 卡槽 |
| 10 | M.2 E Key 2230 插槽 | 11 | 40-Pin GPIO 排针 | 12 | 260-pin SO-DIMM 插槽 |
| 13 | micro USB 接口（OTG） | 14 | 千兆以太网接口 | 15 | 2x USB 3.1 Gen1 Type-A |

</TabItem>

- Radxa NX5 + NX5-IO
<img src="/img/nx5/nx5-io/nx5-io-with-module.webp" width = "350" alt="Radxa NX5 + IO" />
<TabItem value="瑞莎 NX5 开发套件">

#### 外设概述
<div style={{textAlign: 'center'}}>
<img src="/img/nx5/radxa-nx5-devkit-interface.webp" alt="瑞莎 NX5 开发套件接口图" style={{width: '75%', maxWidth: '1200px'}} />
</div>

- 4x USB3.0 Host
- 1x Micro USB 2.0 OTG
- 2x MIPI CSI
- 1x M.2 E Key
- 1x TF Card Slot
- 1x DP
- 1x HDMI
- 1x Gigabit Ethernet
- 1x 40 PIN IO
- 1x Fan Header
- 2x LED Light
- 1x Power Input
- 1x Maskrom Key
- 1x Power Key
| 序号 | 说明 | 序号 | 说明 |
| :--: | :------------ | :--: | :------- |
| 1 | 瑞莎 NX5 载板 | 2 | 瑞莎 NX5 |

</TabItem>

</Tabs>

### 芯片框图
## 应用场景

### 系统框图
### 边缘计算与智能网关

## 文档使用指引
依托 6 TOPS NPU 与千兆以太网，无需依赖云端即可在本地完成视频分析、目标检测、人脸识别等 AI 推理任务，实现边缘侧智能决策与数据预处理，大幅降低网络带宽与云端算力压力。

### [快速上手](/compute-module/nx5/getting-started)
### 机器视觉与工业自动化

介绍系统烧录，系统登录，配件使用等内容让用户能快速的上手使用。
可用于视觉检测、识别与测量等机器视觉场景，支持 CAN 总线等工业接口，可与现场总线、工业控制设备协同工作，构建柔性生产线、自动检测工站和智能设备。

### [Radxa OS](/compute-module/nx5/radxa-os)
### 多媒体处理与智能显示

### [Android](/compute-module/nx5/android)
支持 8K@60fps 视频解码和 8K@30fps 视频编码，适用于数字标牌、视频监控、视频会议、智能广告机、信息查询终端、自助设备、智慧零售终端等多媒体应用，通过高分辨率显示与本地智能分析，实现更丰富的人机交互体验。

### [硬件开发](/compute-module/nx5/hardware)
### 服务与移动机器人

介绍硬件信息，例如硬件接口，支持的配件等。
8 核 CPU 配合 NPU 组合，具备各类传感器扩展接口以及有线网络能力，可作为移动机器人或协作机器人主控平台，用于路径规划、环境感知、目标跟踪以及远程运维与状态监控等应用。

### [配件](/compute-module/nx5/accessories)
### 教育培训与研发验证

介绍支持的配件型号及使用说明。
适用于高校与培训机构的嵌入式与 AI 教学实践平台，也适合作为企业方案原型开发与功能验证的基础硬件平台，加速从概念设计到产品落地的过程。
Loading
Loading