diff --git a/docs/common/dev/_rsdk.mdx b/docs/common/dev/_rsdk.mdx index 571cf3984..46475cb47 100644 --- a/docs/common/dev/_rsdk.mdx +++ b/docs/common/dev/_rsdk.mdx @@ -13,6 +13,7 @@ 1. 首先,请安装所需的依赖项: + ```bash sudo apt-get update sudo apt-get install git qemu-user-static binfmt-support @@ -25,6 +26,7 @@ sudo usermod -a -G docker $USER 2. 使用以下命令克隆项目并安装 DevContainer: + ```bash git clone --recurse-submodules https://github.com/RadxaOS-SDK/rsdk.git cd rsdk @@ -39,6 +41,7 @@ rsdk devcon 当终端出现以下所示,表明现在处于 rsdk 的 dev 容器 shell 中 + ```bash ██████╗ ███████╗██████╗ ██╗ ██╗ ██╔══██╗██╔════╝██╔══██╗██║ ██╔╝ @@ -61,12 +64,10 @@ direnv: export +AR +AS +CC +CONFIG_SHELL +CXX +DETERMINISTIC_BUILD +DEVENV_DOTFI vscode ➜ /workspaces/rsdk (main) $ -```` +``` - - 仓库详细使用,请参考 [rsdk](https://radxaos-sdk.github.io/rsdk/) 页面。 如需要在 `rsdk` 基础上进行二次开发,则请继续阅读文档 [Build customization](https://radxaos-sdk.github.io/rsdk/tutorials/customize.html)。 @@ -83,7 +84,7 @@ vscode ➜ /workspaces/rsdk (main) $ git clone --recurse-submodules https://github.com/RadxaOS-SDK/rsdk.git cd rsdk -```` +``` @@ -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. 安装构建相关依赖并准备构建环境: + ```bash sudo apt-get update sudo apt-get install devscripts dpkg-dev build-essential sudo apt build-dep . -```` +``` - 3. 构建 deb 包: + ```bash dpkg-buildpackage -us -uc -b -```` +``` 4. 构建成功后,生成的 deb 包位于上级目录(..),可通过以下命令安装: + ```bash sudo apt install ../rsdk\_\*.deb -```` +``` @@ -172,6 +175,7 @@ sudo apt install ../rsdk\_\*.deb - 在下面的示例中,我们选择 **Build system image**: + ```bash ┌─────────────────┤ RSDK ├──────────────────┐ │ Please select a task: │ @@ -183,7 +187,7 @@ sudo apt install ../rsdk\_\*.deb │ │ │ │ └───────────────────────────────────────────┘ -```` +``` @@ -196,7 +200,10 @@ sudo apt install ../rsdk\_\*.deb ::: +以 rock-5b 为例: + + ```bash ┌─────────────────┤ RSDK ├──────────────────┐ │ Please select a product: │ @@ -223,6 +230,7 @@ sudo apt install ../rsdk\_\*.deb 示例:选择 Radxa APT 镜像: + ```bash ┌─────────────────┤ RSDK ├──────────────────┐ │ Select Radxa APT mirror (radxa-deb): │ @@ -245,6 +253,7 @@ sudo apt install ../rsdk\_\*.deb 然后可以选择可选的 Debian/Ubuntu 镜像(或保留默认): + ```bash ┌─────────────────┤ RSDK ├──────────────────┐ │ Select Debian/Ubuntu mirror (optional): │ @@ -268,6 +277,7 @@ sudo apt install ../rsdk\_\*.deb 确认并开始构建:在镜像配置(如果有)完成后,向导会展示所选产品和镜像的汇总(对应于将要执行的最终 CLI 命令),请仔细检查摘要并选择 **Yes** 开始构建,或选择 **No** 返回修改: + ```bash ┌─────────────────┤ RSDK ├──────────────────┐ │ │ @@ -291,12 +301,13 @@ sudo apt install ../rsdk\_\*.deb 编译结束之后会生成一个 `out` 目录,`output.img` 即最终生成的镜像: + ```bash vscode ➜ /workspaces/rsdk (main) $ ls out/rock-5b_bookworm_kde/ build-image config.yaml debs manifest output.img rootfs.tar seed.tar.xz -```` +``` diff --git a/docs/common/dev/_u-boot.mdx b/docs/common/dev/_u-boot.mdx index a0fd7f660..e7f8c1e12 100644 --- a/docs/common/dev/_u-boot.mdx +++ b/docs/common/dev/_u-boot.mdx @@ -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 diff --git a/docs/common/radxa-os/rkdevtool/_use.mdx b/docs/common/radxa-os/rkdevtool/_use.mdx index 9a82ddd27..73aea7aae 100644 --- a/docs/common/radxa-os/rkdevtool/_use.mdx +++ b/docs/common/radxa-os/rkdevtool/_use.mdx @@ -99,7 +99,7 @@ brew install rkdeveloptool -:::details 从源码编译(备选) +:::tip 从源码编译(备选) 如果 Tap 安装失败,也可以从源码编译。macOS 不支持 `$(nproc)`,请使用 `make` 直接编译。`main.cpp` 中使用了可变长度数组(VLA),macOS 的 Clang 默认不允许在 C++ 中使用 VLA,需要先将变量声明为 `const`。 diff --git a/docs/common/radxa-os/system-config-debian12/_vnc.mdx b/docs/common/radxa-os/system-config-debian12/_vnc.mdx index ac87c3251..4ce6debfd 100644 --- a/docs/common/radxa-os/system-config-debian12/_vnc.mdx +++ b/docs/common/radxa-os/system-config-debian12/_vnc.mdx @@ -3,7 +3,7 @@ VNC 远程需要双方设备处于同一局域网下,且目标设备需要开启 VNC 服务。 :::tip 使用说明 -VNC 远程控制适合带有图形界面的系统,若系统没有图形化桌面,推荐使用 SSH 远程控制。 +VNC 远程控制适合带有图形界面的系统且没有外接显示器的情况,若系统没有图形化桌面,推荐使用 SSH 远程控制。 ::: ## 使用 VNC(远程设备) diff --git a/docs/som/nx/nx5/README.md b/docs/som/nx/nx5/README.md index a00863af3..f3209ac0f 100644 --- a/docs/som/nx/nx5/README.md +++ b/docs/som/nx/nx5/README.md @@ -1,81 +1,135 @@ --- -sidebar_position: 4 +sidebar_position: 3 --- # 瑞莎 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) +## 产品实物 -#### 特性 + -| Features | Description | -| -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| SoC | Rockchip RK3588S | -| CPU | Quad Cortex®‑A76 @ 2.2~2.4GHz and a quad Cortex®‑A55 @ 1.8GHz
based on Arm® DynamIQ™ configuration | -| GPU | Arm Mali™ G610MP4 GPU ‑ OpenGL® ES1.1, ES2.0, and ES3.2 ‑ OpenCL®
1.1, 1.2 and 2.2 ‑ Vulkan® 1.1 and 1.2 ‑ Embedded high performance 2D
image acceleration module | -| NPU | NPU supporting INT4 / INT8 / INT16 / FP16 / BF16 and TF32 acceleration
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
Supports SDMMC interface for data storage and OS booting using
SD cards | + + +
+ +
+ +
+ + + +瑞莎 NX5 载板集成了丰富的外部接口,可用于快速验证瑞莎 NX5 核心模组的功能,帮助用户轻松完成上电调试、接口评估及初步的应用开发评估。 + +
+ +
+ +
+ + + +瑞莎 NX5 开发套件由瑞莎 NX5 核心模组、瑞莎 NX5 载板组成,提供了完整的硬件开发平台,可用于快速验证核心板功能、评估性能并搭建原型系统,帮助用户高效完成开发与方案验证。 + +
+ +
- +
-#### 实物照片 +## 产品规格 + +| 产品型号 | 瑞莎 NX5 | +| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| SoC(主控) | 瑞芯微 RK3588S | +| CPU(中央处理器) | 4 核 Cortex-A76 + 4 核 Cortex-A55 | +| GPU(图形处理器) | ARM Mali-G610 MP4
- 支持 OpenGL ES 1.1, 2.0 and 3.2, OpenCL 1.1, 1.3 and 2.2, Vulkan 1.1 and 1.2
- 内嵌高性能2D图像加速模块 | +| NPU(神经网络处理器) | 6 TOPS@INT8
- 支持 INT4 / INT8 / INT16 / FP16 / BF16 / TF32 等计算精度
- 支持 TensorFlow, Caffe, Tflite, Pytorch, Onnx NN, Android NN 等深度学习框架 | +| 内存 | LPDDR4X
- 容量:最高可选 16GB | +| 视频编解码 | 视频编码
- 最高支持 8K@30fps 的 H.265 / H.264 视频编码
视频解码
- 最高支持 8K@60fps 的 AV1 / AVS2 / VP9 / H.265 / H.264 视频解码 | +| 存储 | 可选板载 eMMC
- eMMC 5.1, 最大可选 512GB
板载 SPI Flash(可选)
1x SDMMC | +| 网络 | 1x 千兆以太网 | +| 显示 | 1x HDMI TX
- 最高支持 8K@60Hz
1x eDP TX
- 最高支持 4K@60Hz
1x DP TX
- 最高支持 8K@30Hz
1x MIPI DSI(2 通道) | +| 摄像头 | 2x MIPI CSI(2 通道)或 1x MIPI CSI(4 通道)
1x MIPI CSI(4 通道)
1x MIPI CSI(2 通道) | +| USB | USB 3.1 Gen1
USB 2.0 | +| PCIe | PCIe2.0 | +| 其它接口 | 支持 UART, I2C, I2S, CAN, PWM, GPIOs 等功能 | +| 连接器 | 260-pin SO-DIMM 连接器 | +| 操作系统 | 支持 Debian, Yocto, Buildroot, Android 14 | +| 机械尺寸 | 70 毫米 x 45 毫米 | + +## 接口说明 + + + + + +
+ +
+ +| 序号 | 说明 | 序号 | 说明 | 序号 | 说明 | +| :--: | :-------------- | :--: | :------------- | :--: | :-------- | +| 1 | LPDDR4X | 2 | 瑞芯微 RK3588S | 3 | 板载 eMMC | +| 4 | 260-pin SO-DIMM | 5 | SPI Flash | | | + +
-- Radxa NX5-IO - ![Radxa NX5 IO](/img/nx5/nx5-io/nx5-io-overview.webp) + + +
+ +
+ +| 序号 | 说明 | 序号 | 说明 | 序号 | 说明 | +| :--: | :--------------------- | :--: | :----------------------------- | :--: | :------------------------- | +| 1 | 2x USB 3.1 Gen1 Type-A | 2 | 上:DP 输出
下: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 | + +
-- Radxa NX5 + NX5-IO - Radxa NX5 + IO + -#### 外设概述 +
+ 瑞莎 NX5 开发套件接口图 +
-- 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 |
-### 芯片框图 +## 应用场景 -### 系统框图 +### 边缘计算与智能网关 -## 文档使用指引 +依托 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 教学实践平台,也适合作为企业方案原型开发与功能验证的基础硬件平台,加速从概念设计到产品落地的过程。 diff --git a/docs/som/nx/nx5/accessories/camera.md b/docs/som/nx/nx5/accessories/camera.md deleted file mode 100644 index 65e9a661c..000000000 --- a/docs/som/nx/nx5/accessories/camera.md +++ /dev/null @@ -1,66 +0,0 @@ ---- -sidebar_position: 4 ---- - -# 摄像头 - -目前支持以下3款摄像头产品: - -1. OKDO 5MP Camera (ov5647) -2. Raspberry Camera v1.3 (ov5647) -3. Raspberry Camera v2 (imx219) - -以下采用 'Raspberry Camera v2' 演示操作的流程,其他摄像头类似。 - -## 配置 - -- 准备好 raspberry camera v2,通过 FPC 线接上 NX5 IO 的 CSI 接口。 - -- 打开终端运行 `sudo rsetup` 命令: - -```bash -radxa@radxa-nx5-io:~$ sudo rsetup -``` - -- 通过[设备树配置](../radxa-os/sys-config/rsetup#overlays)来启用摄像头的 overlay。 - -:::caution [注意] - -1. 请启用 `[] Enable Raspberry Pi Camera v2 on CAM0` 项 overlay。 -2. 在启用成功显示 `[*] Enable Raspberry Pi Camera v2 on CAM0` 回车键确认后退出重启才能使配置生效。 -3. 其他产品请根据描述开启相应的overlay。 - -::: - -## 图像预览 - -摄像头的实时预览推荐使用 cheese,运行以下命令安装 cheese: - -```bash -sudo apt update -sudo apt install cheese -``` - -进入桌面后打开终端执行以下命令即可开始实施预览摄像头: - -```bash -sudo cheese -``` - -你也可以使用终端命令打开相机预览: - -```bash -gst-launch-1.0 v4l2src device=/dev/video11 io-mode=4 ! videoconvert ! video/x-raw,format=NV12,width=1920,height=1080 ! xvimagesink -``` - -使用以下命令拍照: - -```bash -gst-launch-1.0 v4l2src device=/dev/video11 io-mode=4 ! videoconvert ! video/x-raw,format=NV12,width=1920,height=1080 ! jpegenc ! multifilesink location=file.name.jpg -``` - -使用以下命令拍摄视频: - -```bash -gst-launch-1.0 v4l2src num-buffers=512 device=/dev/video11 io-mode=4 ! videoconvert ! video/x-raw, format=NV12, width=1920, height=1080, framerate=30/1 ! tee name=t ! queue ! mpph264enc ! queue ! h264parse ! mpegtsmux ! filesink location=/home/radxa/file.name.mp4 -``` diff --git a/docs/som/nx/nx5/accessories/pd-30w.md b/docs/som/nx/nx5/accessories/pd-30w.md deleted file mode 100644 index bfe212f80..000000000 --- a/docs/som/nx/nx5/accessories/pd-30w.md +++ /dev/null @@ -1,9 +0,0 @@ -# Radxa Power PD 30W - -Radxa NX5-IO 仅支持 5V DC 供电(接口规格:DC 5525),建议电流 3A 及以上。 - -推荐使用我们的 [Radxa Power PD 30W](https://radxa.com/products/accessories/power-pd-30w) 电源适配器搭配 [Type-C 转 DC 口数据线](https://arace.tech/products/radxa-type-c-to-dc-5v-cable) 使用。 - -
- -
diff --git a/docs/som/nx/nx5/accessories/wifi_bt_access.md b/docs/som/nx/nx5/accessories/wifi_bt_access.md deleted file mode 100644 index 7525ae753..000000000 --- a/docs/som/nx/nx5/accessories/wifi_bt_access.md +++ /dev/null @@ -1,47 +0,0 @@ ---- -sidebar_position: 2 ---- - -# WIFI & BT - -## WIFI & BT 支持模块列表 - -| NO. | Model | Chip | WiFi | BT | WIFI Throughput | Remark | -| --- | ---------------------- | ----------- | ------------- | --- | ------------------------------------- | ------ | -| 1 | Radxa wireless A8 | RTL8852BE | 2.4G&5G&WIFI6 | 5.0 | up:600Mbits/sec down:900 Mbits/sec | | -| 2 | Intel AX210 (PCIE+USB) | Intel AX210 | WiFi 6 | 5.2 | up: 859 Mbits/sec down: 813 Mbits/sec | | - -- Radxa NX5 IO 没有板载WiFi/BT模块,需要外接模块。以上是支持并测试过的 WITI/BT 卡。 -- 这里演示的 M.2 无线模块是: Radxa 无线模块 A8。 - -[Radxa 无线模块A8](/zh/img/accessories/network/a8-module-01.webp) - -- 安装如图所示: - -[Radxa 无线模块A8](/zh/img/accessories/network/a8-module-02.webp) - -## WIFI 使用 - -1. 首先进入ROOT用户模式。 - -```bash -sudo su -``` - -2. 打开WIFI - -```bash -nmcli r wifi on -``` - -3. 扫描WIFI - -```bash -nmcli dev wifi -``` - -4. 连接wifi网络 - -```bash -nmcli dev wifi connect "wifi_name" password "wifi_password" -``` diff --git a/docs/som/nx/nx5/radxa-os/app-dev/ai/README.md b/docs/som/nx/nx5/ai-dev/README.md similarity index 82% rename from docs/som/nx/nx5/radxa-os/app-dev/ai/README.md rename to docs/som/nx/nx5/ai-dev/README.md index 1f4a63ff7..2f12f01c5 100644 --- a/docs/som/nx/nx5/radxa-os/app-dev/ai/README.md +++ b/docs/som/nx/nx5/ai-dev/README.md @@ -1,8 +1,8 @@ --- -sidebar_position: 50 +sidebar_position: 12 --- -# 人工智能 +# AI 开发 介绍人工智能相关应用,包括 RKNN 和 RKLLM 工具链使用,RKNN Model Zoo 模型示例仓库以及常见的模型部署流程。 diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/clip.md b/docs/som/nx/nx5/ai-dev/clip.md similarity index 71% rename from i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/clip.md rename to docs/som/nx/nx5/ai-dev/clip.md index f76c03e8b..4a2304fc9 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/clip.md +++ b/docs/som/nx/nx5/ai-dev/clip.md @@ -7,7 +7,7 @@ imports_resolve_to: - docs/common/ai/rockchip/_clip.mdx --- -import CLIP from "../../../../../../common/ai/rockchip/\_clip.mdx" +import CLIP from "../../../../common/ai/rockchip/\_clip.mdx" # CLIP diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/deeplabv3.md b/docs/som/nx/nx5/ai-dev/deeplabv3.md similarity index 70% rename from i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/deeplabv3.md rename to docs/som/nx/nx5/ai-dev/deeplabv3.md index b4af37b09..fd5f40742 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/deeplabv3.md +++ b/docs/som/nx/nx5/ai-dev/deeplabv3.md @@ -7,7 +7,7 @@ imports_resolve_to: - docs/common/ai/rockchip/_deeplabv3.mdx --- -import Deeplabv3 from "../../../../../../common/ai/rockchip/\_deeplabv3.mdx" +import Deeplabv3 from "../../../../common/ai/rockchip/\_deeplabv3.mdx" # DeepLabV3 diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/lprnet.md b/docs/som/nx/nx5/ai-dev/lprnet.md similarity index 70% rename from i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/lprnet.md rename to docs/som/nx/nx5/ai-dev/lprnet.md index e9f02866b..3a770d702 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/lprnet.md +++ b/docs/som/nx/nx5/ai-dev/lprnet.md @@ -7,7 +7,7 @@ imports_resolve_to: - docs/common/ai/rockchip/_lprnet.mdx --- -import LPRNet from "../../../../../../common/ai/rockchip/\_lprnet.mdx" +import LPRNet from "../../../../common/ai/rockchip/\_lprnet.mdx" # LPRNet diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/mobilenet.md b/docs/som/nx/nx5/ai-dev/mobilenet.md similarity index 70% rename from i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/mobilenet.md rename to docs/som/nx/nx5/ai-dev/mobilenet.md index 4184bc209..ff7d3c2b7 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/mobilenet.md +++ b/docs/som/nx/nx5/ai-dev/mobilenet.md @@ -7,7 +7,7 @@ imports_resolve_to: - docs/common/ai/rockchip/_mobilenet.mdx --- -import MobileNet from "../../../../../../common/ai/rockchip/\_mobilenet.mdx" +import MobileNet from "../../../../common/ai/rockchip/\_mobilenet.mdx" # MobileNet diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/mobilesam.md b/docs/som/nx/nx5/ai-dev/mobilesam.md similarity index 70% rename from i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/mobilesam.md rename to docs/som/nx/nx5/ai-dev/mobilesam.md index 419b08915..abd31796e 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/mobilesam.md +++ b/docs/som/nx/nx5/ai-dev/mobilesam.md @@ -7,7 +7,7 @@ imports_resolve_to: - docs/common/ai/rockchip/_mobilesam.mdx --- -import Mobilesam from "../../../../../../common/ai/rockchip/\_mobilesam.mdx" +import Mobilesam from "../../../../common/ai/rockchip/\_mobilesam.mdx" # MobileSAM diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/ppocr.md b/docs/som/nx/nx5/ai-dev/ppocr.md similarity index 71% rename from i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/ppocr.md rename to docs/som/nx/nx5/ai-dev/ppocr.md index ddf3ec47e..e96914a31 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/ppocr.md +++ b/docs/som/nx/nx5/ai-dev/ppocr.md @@ -7,7 +7,7 @@ imports_resolve_to: - docs/common/ai/rockchip/_ppocr.mdx --- -import PPOCR from "../../../../../../common/ai/rockchip/\_ppocr.mdx" +import PPOCR from "../../../../common/ai/rockchip/\_ppocr.mdx" # PP-OCR diff --git a/docs/som/nx/nx5/radxa-os/app-dev/ai/ppyoloe.md b/docs/som/nx/nx5/ai-dev/ppyoloe.md similarity index 70% rename from docs/som/nx/nx5/radxa-os/app-dev/ai/ppyoloe.md rename to docs/som/nx/nx5/ai-dev/ppyoloe.md index 1a32f6fcd..553c9e0a7 100644 --- a/docs/som/nx/nx5/radxa-os/app-dev/ai/ppyoloe.md +++ b/docs/som/nx/nx5/ai-dev/ppyoloe.md @@ -7,7 +7,7 @@ imports_resolve_to: - docs/common/ai/rockchip/_ppyoloe.mdx --- -import PPYOLOE from "../../../../../../common/ai/rockchip/\_ppyoloe.mdx" +import PPYOLOE from "../../../../common/ai/rockchip/\_ppyoloe.mdx" # PP-YOLOE diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/resnet.md b/docs/som/nx/nx5/ai-dev/resnet.md similarity index 70% rename from i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/resnet.md rename to docs/som/nx/nx5/ai-dev/resnet.md index 0664035a1..20fbbc6b7 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/resnet.md +++ b/docs/som/nx/nx5/ai-dev/resnet.md @@ -7,7 +7,7 @@ imports_resolve_to: - docs/common/ai/rockchip/_resnet.mdx --- -import ResNet from "../../../../../../common/ai/rockchip/\_resnet.mdx" +import ResNet from "../../../../common/ai/rockchip/\_resnet.mdx" # ResNet diff --git a/docs/som/nx/nx5/radxa-os/app-dev/ai/retinaface.md b/docs/som/nx/nx5/ai-dev/retinaface.md similarity index 70% rename from docs/som/nx/nx5/radxa-os/app-dev/ai/retinaface.md rename to docs/som/nx/nx5/ai-dev/retinaface.md index f83c6af73..df77a5b03 100644 --- a/docs/som/nx/nx5/radxa-os/app-dev/ai/retinaface.md +++ b/docs/som/nx/nx5/ai-dev/retinaface.md @@ -7,7 +7,7 @@ imports_resolve_to: - docs/common/ai/rockchip/_retinaface.mdx --- -import Retinaface from "../../../../../../common/ai/rockchip/\_retinaface.mdx" +import Retinaface from "../../../../common/ai/rockchip/\_retinaface.mdx" # RetinaFace diff --git a/docs/som/nx/nx5/radxa-os/app-dev/ai/rkllm-deepseek-r1.md b/docs/som/nx/nx5/ai-dev/rkllm-deepseek-r1.md similarity index 67% rename from docs/som/nx/nx5/radxa-os/app-dev/ai/rkllm-deepseek-r1.md rename to docs/som/nx/nx5/ai-dev/rkllm-deepseek-r1.md index 973cc6459..cdf4adc82 100644 --- a/docs/som/nx/nx5/radxa-os/app-dev/ai/rkllm-deepseek-r1.md +++ b/docs/som/nx/nx5/ai-dev/rkllm-deepseek-r1.md @@ -9,6 +9,6 @@ imports_resolve_to: # RKLLM DeepSeek-R1 -import RKLLMDEEPSEEKR1 from '../../../../../../common/dev/\_rkllm-deepseek-r1.mdx'; +import RKLLMDEEPSEEKR1 from '../../../../common/dev/\_rkllm-deepseek-r1.mdx'; diff --git a/docs/som/nx/nx5/radxa-os/app-dev/ai/rkllm-install.md b/docs/som/nx/nx5/ai-dev/rkllm-install.md similarity index 68% rename from docs/som/nx/nx5/radxa-os/app-dev/ai/rkllm-install.md rename to docs/som/nx/nx5/ai-dev/rkllm-install.md index 77cc4aaac..1c002b2c2 100644 --- a/docs/som/nx/nx5/radxa-os/app-dev/ai/rkllm-install.md +++ b/docs/som/nx/nx5/ai-dev/rkllm-install.md @@ -9,6 +9,6 @@ imports_resolve_to: # RKLLM 安装 -import Rkllminstall from '../../../../../../common/dev/\_rkllm-install.mdx'; +import Rkllminstall from '../../../../common/dev/\_rkllm-install.mdx'; diff --git a/docs/som/nx/nx5/radxa-os/app-dev/ai/rkllm-qwen2-vl.md b/docs/som/nx/nx5/ai-dev/rkllm-qwen2-vl.md similarity index 74% rename from docs/som/nx/nx5/radxa-os/app-dev/ai/rkllm-qwen2-vl.md rename to docs/som/nx/nx5/ai-dev/rkllm-qwen2-vl.md index 90eefbc1b..faae2f7c3 100644 --- a/docs/som/nx/nx5/radxa-os/app-dev/ai/rkllm-qwen2-vl.md +++ b/docs/som/nx/nx5/ai-dev/rkllm-qwen2-vl.md @@ -10,6 +10,6 @@ imports_resolve_to: # RKLLM Qwen2-VL -import RKLLMQWEN2VL from '../../../../../../common/dev/\_rkllm_qwen2_vl.mdx'; +import RKLLMQWEN2VL from '../../../../common/dev/\_rkllm_qwen2_vl.mdx'; diff --git a/docs/som/nx/nx5/radxa-os/app-dev/ai/rkllm-smolvlm2.md b/docs/som/nx/nx5/ai-dev/rkllm-smolvlm2.md similarity index 74% rename from docs/som/nx/nx5/radxa-os/app-dev/ai/rkllm-smolvlm2.md rename to docs/som/nx/nx5/ai-dev/rkllm-smolvlm2.md index b9fb280a1..d425d1265 100644 --- a/docs/som/nx/nx5/radxa-os/app-dev/ai/rkllm-smolvlm2.md +++ b/docs/som/nx/nx5/ai-dev/rkllm-smolvlm2.md @@ -10,6 +10,6 @@ imports_resolve_to: # RKLLM SmolVLM2 -import SMOLVLM2 from "../../../../../../common/ai/\_rkllm_smolvlm2.mdx"; +import SMOLVLM2 from "../../../../common/ai/\_rkllm_smolvlm2.mdx"; diff --git a/docs/som/nx/nx5/radxa-os/app-dev/ai/rkllm-usage.md b/docs/som/nx/nx5/ai-dev/rkllm-usage.md similarity index 71% rename from docs/som/nx/nx5/radxa-os/app-dev/ai/rkllm-usage.md rename to docs/som/nx/nx5/ai-dev/rkllm-usage.md index c027feeaa..90613e815 100644 --- a/docs/som/nx/nx5/radxa-os/app-dev/ai/rkllm-usage.md +++ b/docs/som/nx/nx5/ai-dev/rkllm-usage.md @@ -9,6 +9,6 @@ imports_resolve_to: # RKLLM 使用与大语言模型部署 -import Rkllmusage from '../../../../../../common/dev/\_rkllm-usage.mdx'; +import Rkllmusage from '../../../../common/dev/\_rkllm-usage.mdx'; diff --git a/docs/som/nx/nx5/radxa-os/app-dev/ai/rknn-custom-yolo.md b/docs/som/nx/nx5/ai-dev/rknn-custom-yolo.md similarity index 74% rename from docs/som/nx/nx5/radxa-os/app-dev/ai/rknn-custom-yolo.md rename to docs/som/nx/nx5/ai-dev/rknn-custom-yolo.md index 8eef61c6a..149ad4b67 100644 --- a/docs/som/nx/nx5/radxa-os/app-dev/ai/rknn-custom-yolo.md +++ b/docs/som/nx/nx5/ai-dev/rknn-custom-yolo.md @@ -10,6 +10,6 @@ imports_resolve_to: # 转换自训练 YOLO 模型 -import RKNNCUSTOMYOLO from '../../../../../../common/ai/\_rknn_custom_yolo.mdx'; +import RKNNCUSTOMYOLO from '../../../../common/ai/\_rknn_custom_yolo.mdx'; diff --git a/docs/som/nx/nx5/radxa-os/app-dev/ai/rknn-install.md b/docs/som/nx/nx5/ai-dev/rknn-install.md similarity index 68% rename from docs/som/nx/nx5/radxa-os/app-dev/ai/rknn-install.md rename to docs/som/nx/nx5/ai-dev/rknn-install.md index fa938335a..31b8bba13 100644 --- a/docs/som/nx/nx5/radxa-os/app-dev/ai/rknn-install.md +++ b/docs/som/nx/nx5/ai-dev/rknn-install.md @@ -9,6 +9,6 @@ imports_resolve_to: # RKNN 安装 -import RKNNinstall from '../../../../../../common/dev/\_rknn-install.mdx'; +import RKNNinstall from '../../../../common/dev/\_rknn-install.mdx'; diff --git a/docs/som/nx/nx5/radxa-os/app-dev/ai/rknn-model-zoo.md b/docs/som/nx/nx5/ai-dev/rknn-model-zoo.md similarity index 67% rename from docs/som/nx/nx5/radxa-os/app-dev/ai/rknn-model-zoo.md rename to docs/som/nx/nx5/ai-dev/rknn-model-zoo.md index 20b9e7abc..808aac1d5 100644 --- a/docs/som/nx/nx5/radxa-os/app-dev/ai/rknn-model-zoo.md +++ b/docs/som/nx/nx5/ai-dev/rknn-model-zoo.md @@ -9,6 +9,6 @@ imports_resolve_to: # RKNN Model Zoo -import RKNNModelZoo from "../../../../../../common/ai/rockchip/\_rknn_model_zoo.mdx" +import RKNNModelZoo from "../../../../common/ai/rockchip/\_rknn_model_zoo.mdx" diff --git a/docs/som/nx/nx5/radxa-os/app-dev/ai/rknn-quick-start.md b/docs/som/nx/nx5/ai-dev/rknn-quick-start.md similarity index 68% rename from docs/som/nx/nx5/radxa-os/app-dev/ai/rknn-quick-start.md rename to docs/som/nx/nx5/ai-dev/rknn-quick-start.md index d7925dab6..3412f4639 100644 --- a/docs/som/nx/nx5/radxa-os/app-dev/ai/rknn-quick-start.md +++ b/docs/som/nx/nx5/ai-dev/rknn-quick-start.md @@ -9,6 +9,6 @@ imports_resolve_to: # RKNN 快速例子 -import Rknntoolkit2 from '../../../../../../common/dev/\_rknn-toolkit2.mdx'; +import Rknntoolkit2 from '../../../../common/dev/\_rknn-toolkit2.mdx'; diff --git a/docs/som/nx/nx5/radxa-os/app-dev/ai/rknn-stable-diffusion.md b/docs/som/nx/nx5/ai-dev/rknn-stable-diffusion.md similarity index 72% rename from docs/som/nx/nx5/radxa-os/app-dev/ai/rknn-stable-diffusion.md rename to docs/som/nx/nx5/ai-dev/rknn-stable-diffusion.md index 9dc9bd6f7..c0d71a4e7 100644 --- a/docs/som/nx/nx5/radxa-os/app-dev/ai/rknn-stable-diffusion.md +++ b/docs/som/nx/nx5/ai-dev/rknn-stable-diffusion.md @@ -10,6 +10,6 @@ imports_resolve_to: # RKNN Stable Diffusion LCM -import StableDiffusionConvert from "../../../../../../common/ai/\_stable_diffusion_convert.mdx"; +import StableDiffusionConvert from "../../../../common/ai/\_stable_diffusion_convert.mdx"; diff --git a/docs/som/nx/nx5/radxa-os/app-dev/ai/rknn-toolkit-lite2-yolov5.md b/docs/som/nx/nx5/ai-dev/rknn-toolkit-lite2-yolov5.md similarity index 67% rename from docs/som/nx/nx5/radxa-os/app-dev/ai/rknn-toolkit-lite2-yolov5.md rename to docs/som/nx/nx5/ai-dev/rknn-toolkit-lite2-yolov5.md index 6619972e3..5c956c400 100644 --- a/docs/som/nx/nx5/radxa-os/app-dev/ai/rknn-toolkit-lite2-yolov5.md +++ b/docs/som/nx/nx5/ai-dev/rknn-toolkit-lite2-yolov5.md @@ -9,6 +9,6 @@ imports_resolve_to: # 板端部署 YOLOv5 目标检测 -import RKNNTOOLKITLITE2YOLOV5 from '../../../../../../common/dev/\_rknn-toolkit-lite2-yolov5.mdx'; +import RKNNTOOLKITLITE2YOLOV5 from '../../../../common/dev/\_rknn-toolkit-lite2-yolov5.mdx'; diff --git a/docs/som/nx/nx5/radxa-os/app-dev/ai/rknn-toolkit-lite2-yolov8.md b/docs/som/nx/nx5/ai-dev/rknn-toolkit-lite2-yolov8.md similarity index 78% rename from docs/som/nx/nx5/radxa-os/app-dev/ai/rknn-toolkit-lite2-yolov8.md rename to docs/som/nx/nx5/ai-dev/rknn-toolkit-lite2-yolov8.md index 3e1377bec..f872cd68b 100644 --- a/docs/som/nx/nx5/radxa-os/app-dev/ai/rknn-toolkit-lite2-yolov8.md +++ b/docs/som/nx/nx5/ai-dev/rknn-toolkit-lite2-yolov8.md @@ -10,6 +10,6 @@ imports_resolve_to: # 板端部署 YOLOv8 目标检测 -import RKNNTOOLKITLITE2YOLOV8 from '../../../../../../common/dev/\_rknn-toolkit-lite2-yolov8.mdx'; +import RKNNTOOLKITLITE2YOLOV8 from '../../../../common/dev/\_rknn-toolkit-lite2-yolov8.mdx'; diff --git a/docs/som/nx/nx5/radxa-os/app-dev/ai/rknn-toolkit2-pc.md b/docs/som/nx/nx5/ai-dev/rknn-toolkit2-pc.md similarity index 78% rename from docs/som/nx/nx5/radxa-os/app-dev/ai/rknn-toolkit2-pc.md rename to docs/som/nx/nx5/ai-dev/rknn-toolkit2-pc.md index e935a2fbf..5782f617a 100644 --- a/docs/som/nx/nx5/radxa-os/app-dev/ai/rknn-toolkit2-pc.md +++ b/docs/som/nx/nx5/ai-dev/rknn-toolkit2-pc.md @@ -10,6 +10,6 @@ imports_resolve_to: # 模拟推理 YOLOv5 分割模型 -import RKNNTOOLKIT2PC from '../../../../../../common/dev/\_rknn-toolkit2-pc.mdx'; +import RKNNTOOLKIT2PC from '../../../../common/dev/\_rknn-toolkit2-pc.mdx'; diff --git a/docs/som/nx/nx5/radxa-os/app-dev/ai/rknn-ultralytics.md b/docs/som/nx/nx5/ai-dev/rknn-ultralytics.md similarity index 80% rename from docs/som/nx/nx5/radxa-os/app-dev/ai/rknn-ultralytics.md rename to docs/som/nx/nx5/ai-dev/rknn-ultralytics.md index efec4a329..3906c6bab 100644 --- a/docs/som/nx/nx5/radxa-os/app-dev/ai/rknn-ultralytics.md +++ b/docs/som/nx/nx5/ai-dev/rknn-ultralytics.md @@ -10,6 +10,6 @@ imports_resolve_to: # RKNN Ultralytics YOLOv11 -import RKNNULTRALYTICS from '../../../../../../common/dev/\_rknn-ultralytics.mdx'; +import RKNNULTRALYTICS from '../../../../common/dev/\_rknn-ultralytics.mdx'; diff --git a/docs/som/nx/nx5/radxa-os/app-dev/ai/wav2vec2.md b/docs/som/nx/nx5/ai-dev/wav2vec2.md similarity index 70% rename from docs/som/nx/nx5/radxa-os/app-dev/ai/wav2vec2.md rename to docs/som/nx/nx5/ai-dev/wav2vec2.md index 22e99c9cb..ca6cbc883 100644 --- a/docs/som/nx/nx5/radxa-os/app-dev/ai/wav2vec2.md +++ b/docs/som/nx/nx5/ai-dev/wav2vec2.md @@ -7,7 +7,7 @@ imports_resolve_to: - docs/common/ai/rockchip/_wav2vec2.mdx --- -import Wav2vec2 from "../../../../../../common/ai/rockchip/\_wav2vec2.mdx" +import Wav2vec2 from "../../../../common/ai/rockchip/\_wav2vec2.mdx" # Wav2Vec 2.0 diff --git a/docs/som/nx/nx5/radxa-os/app-dev/ai/whisper.md b/docs/som/nx/nx5/ai-dev/whisper.md similarity index 70% rename from docs/som/nx/nx5/radxa-os/app-dev/ai/whisper.md rename to docs/som/nx/nx5/ai-dev/whisper.md index 42d5c498d..7a06512b4 100644 --- a/docs/som/nx/nx5/radxa-os/app-dev/ai/whisper.md +++ b/docs/som/nx/nx5/ai-dev/whisper.md @@ -7,7 +7,7 @@ imports_resolve_to: - docs/common/ai/rockchip/_whisper.mdx --- -import Whisper from "../../../../../../common/ai/rockchip/\_whisper.mdx" +import Whisper from "../../../../common/ai/rockchip/\_whisper.mdx" # Whisper diff --git a/docs/som/nx/nx5/radxa-os/app-dev/ai/yolo-world.md b/docs/som/nx/nx5/ai-dev/yolo-world.md similarity index 70% rename from docs/som/nx/nx5/radxa-os/app-dev/ai/yolo-world.md rename to docs/som/nx/nx5/ai-dev/yolo-world.md index 294185ad8..ea57cbad0 100644 --- a/docs/som/nx/nx5/radxa-os/app-dev/ai/yolo-world.md +++ b/docs/som/nx/nx5/ai-dev/yolo-world.md @@ -7,7 +7,7 @@ imports_resolve_to: - docs/common/ai/rockchip/_yolo_world.mdx --- -import YOLOWorld from "../../../../../../common/ai/rockchip/\_yolo_world.mdx" +import YOLOWorld from "../../../../common/ai/rockchip/\_yolo_world.mdx" # YOLO World diff --git a/docs/som/nx/nx5/radxa-os/app-dev/ai/yolov8-multi-stream.md b/docs/som/nx/nx5/ai-dev/yolov8-multi-stream.md similarity index 71% rename from docs/som/nx/nx5/radxa-os/app-dev/ai/yolov8-multi-stream.md rename to docs/som/nx/nx5/ai-dev/yolov8-multi-stream.md index 62fee0e91..5ce3ee814 100644 --- a/docs/som/nx/nx5/radxa-os/app-dev/ai/yolov8-multi-stream.md +++ b/docs/som/nx/nx5/ai-dev/yolov8-multi-stream.md @@ -10,6 +10,6 @@ imports_resolve_to: # YOLOv8 多路识别 -import RKNNYOLOV8MULTISTREAM from "../../../../../../common/ai/\_rknn_yolov8_multi_stream.mdx"; +import RKNNYOLOV8MULTISTREAM from "../../../../common/ai/\_rknn_yolov8_multi_stream.mdx"; diff --git a/docs/som/nx/nx5/radxa-os/app-dev/ai/yolov8-seg.md b/docs/som/nx/nx5/ai-dev/yolov8-seg.md similarity index 70% rename from docs/som/nx/nx5/radxa-os/app-dev/ai/yolov8-seg.md rename to docs/som/nx/nx5/ai-dev/yolov8-seg.md index a7bd22e42..b0f11f142 100644 --- a/docs/som/nx/nx5/radxa-os/app-dev/ai/yolov8-seg.md +++ b/docs/som/nx/nx5/ai-dev/yolov8-seg.md @@ -7,7 +7,7 @@ imports_resolve_to: - docs/common/ai/rockchip/_yolov8_seg.mdx --- -import YOLOv8Seg from "../../../../../../common/ai/rockchip/\_yolov8_seg.mdx" +import YOLOv8Seg from "../../../../common/ai/rockchip/\_yolov8_seg.mdx" # YOLOv8-Seg diff --git a/docs/som/nx/nx5/radxa-os/app-dev/ai/yolov8.md b/docs/som/nx/nx5/ai-dev/yolov8.md similarity index 70% rename from docs/som/nx/nx5/radxa-os/app-dev/ai/yolov8.md rename to docs/som/nx/nx5/ai-dev/yolov8.md index 72f565b27..2587d56c6 100644 --- a/docs/som/nx/nx5/radxa-os/app-dev/ai/yolov8.md +++ b/docs/som/nx/nx5/ai-dev/yolov8.md @@ -7,7 +7,7 @@ imports_resolve_to: - docs/common/ai/rockchip/_yolov8.mdx --- -import YOLOv8 from "../../../../../../common/ai/rockchip/\_yolov8.mdx" +import YOLOv8 from "../../../../common/ai/rockchip/\_yolov8.mdx" # YOLOv8 diff --git a/docs/som/nx/nx5/android/README.md b/docs/som/nx/nx5/android/README.md index 31c332227..9a106451c 100644 --- a/docs/som/nx/nx5/android/README.md +++ b/docs/som/nx/nx5/android/README.md @@ -1,9 +1,9 @@ --- -sidebar_position: 3 +sidebar_position: 25 --- # Android 系统 -主要介绍系统如何使用 +对瑞莎 NX5 的 Android 系统进行简单的使用和开发说明。 diff --git a/docs/som/nx/nx5/android/app-dev.md b/docs/som/nx/nx5/android/app-dev.md deleted file mode 100644 index 4e7b46df4..000000000 --- a/docs/som/nx/nx5/android/app-dev.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -sidebar_position: 5 ---- - -# 应用开发 diff --git a/docs/som/nx/nx5/android/getting-started.md b/docs/som/nx/nx5/android/getting-started.md new file mode 100644 index 000000000..b7577e1a7 --- /dev/null +++ b/docs/som/nx/nx5/android/getting-started.md @@ -0,0 +1,89 @@ +--- +sidebar_position: 2 +--- + +import UseRKDevTool from '../../../../common/radxa-os/rkdevtool/\_use.mdx'; +import EMMC from '../../../../common/radxa-os/rkdevtool/\_emmc.mdx'; +import Maskrom from '../../../../common/radxa-os/rkdevtool/\_maskrom.mdx'; + +# 快速上手 + +本节教程目的是为了让大家快速上手使用瑞莎 NX5 的 Android 系统。 + +## 产品实物 + +瑞莎 NX5 开发套件由瑞莎 NX5 核心模组和瑞莎 NX5 载板组成,提供了完整的硬件开发平台,可用于快速验证核心板功能、评估性能并搭建原型系统,帮助用户高效完成开发与方案验证。 + +说明:瑞莎 NX5 载板需要用户自行购买 + +
+ +
+ +## 使用前提 + +您需要提前准备以下硬件设备: + +- 瑞莎 NX5 开发套件 +- 供电:DC 5525 电源适配器(5V 输入) +- 系统启动介质:板载 eMMC +- 数据线:Micro USB 数据线(用于线刷系统到 eMMC) +- 显示设备:HDMI 数据线和显示器 +- 输入设备:键盘和鼠标(用于图形界面操作) + +:::tip 推荐配件 + +- 推荐使用 5V/3A 或以上规格的 DC 电源适配器进行供电 + +::: + +## 安装系统 + +:::tip 系统说明 + +若需要安装系统到 microSD 卡,请参考 [安装系统到 microSD 卡](./install-system/microsd-system.md) + +若 microSD 卡和板载 eMMC 均存在系统,系统将优先从 microSD 卡启动。 + +::: + +快速上手主要介绍安装系统到瑞莎 NX5 的板载 eMMC。 + +:::warning 重要提醒 + +**安装系统会完全格式化 eMMC,所有数据将被永久删除!** + +请在操作前确认: + +- eMMC 中无重要数据或已完成资料备份 + ::: + +### 安装 RKDevTool + + + +### 进入 Maskrom 模式 + + + +### 安装系统到 eMMC + + + +## 启动系统 + +完成系统的安装后,连接 HDMI 显示器,重新插拔电源适配器,即可启动系统。 + +
+ +
+ +① : 使用 HDMI 或 DP 数据线连接显示器和主板 + +② : 使用 USB-A 接口连接鼠标或键盘 + +③ : 使用 5V DC 电源适配器给主板供电 + +若主板供电正常,瑞莎 NX5 载板的电源指示灯亮绿色;显示器显示安卓系统桌面。 + +说明:瑞莎 NX5 载板的系统状态指示灯并不会亮起。 diff --git a/docs/som/nx/nx5/android/install-os.mdx b/docs/som/nx/nx5/android/install-os.mdx deleted file mode 100644 index 434e514b1..000000000 --- a/docs/som/nx/nx5/android/install-os.mdx +++ /dev/null @@ -1,112 +0,0 @@ ---- -sidebar_position: 2 -title: 系统安装 ---- - -本文档将介绍如何把 Android 镜像安装到 Radxa NX5。 - -NX5 可以从 microSD 卡启动,也可以从板载 EMMC 启动,基于不同的启动方式,安装系统到不同的介质上. - - - - - -## 准备工作 - -### 准备安装介质 - -- microSD 卡 (建议class10等级以上) - -- USB 读卡器 - -### 镜像下载 - -请到 [资源下载汇总](../getting-started/download) 下载对应的镜像文件 - -:::tip 镜像说明 -下载的系统镜像为压缩格式,使用 Balena Etcher 进行镜像烧录前,需先完成解压操作。 -::: - -## 系统安装 - -1. 下载 [Etcher](https://etcher.balena.io/)。 - ![ROCK5A via Etcher 01](/img/rock5a/rock5a-etcher.webp) - -2. 打开 Etcher,将准备的操作系统镜像刷写到 microSD 卡。在 Etcher 窗口中,单击 `Flash from file` 选择刚下载的操作系统镜像。 - ![ROCK5A via Etcher 02](/img/rock5a/rock5a-etcher-1.webp) - -3. 在 Etcher 窗口中,点击 `Select target`。 - ![ROCK5A via Etcher 03](/img/rock5a/rock5a-etcher-2.webp) - -4. 在 Etcher 窗口中,点击 `Flash!` 然后等待刷写进度条。 - ![ROCK5A via Etcher 04](/img/rock5a/rock5a-etcher-3.webp) - -5. 在 Etcher 窗口中,当刷写成功时将会显示 `Flash Complete!` - ![ROCK5A via Etcher 05](/img/rock5a/rock5a-etcher-4.webp) - -## 系统启动 - -### 启动 NX5 Kit(NX5 + NX5 IO) - -1. 插入安装好操作系统的microSD卡 -2. 通过适配器为 NX5 Kit 供电 -3. NX5 Kit 将在绿色电源 LED 亮起的情况下启动 - - - - - -## 准备工作 - -### 准备安装介质 - -- micro usb 转 typea usb 接口线缆 - -### 镜像下载 - -请到 [资源下载汇总](../getting-started/download) 下载对应的镜像文件 - -## 系统安装 - -### 系统安装 - -1. 将micro usb 线缆连接到主机 - -2. 按住 maskrom 按键后上电,此时会进入 maskrom 模式 - - - - - -#### Linux/Mac 系统使用 rkdeveloptool 写入 - - [rkdeveloptool](../radxa-os/low-level-dev/rkdeveloptool) - - [upgrade_tool](../radxa-os/low-level-dev/upgrade-tool)(可同时烧录多台设备) - - - - - -#### Windows 系统使用 rkdevetool 写入 - - [rkdevtool](../radxa-os/low-level-dev/rkdevtool) - - - - - -## 系统启动 - -### 启动 NX5 Kit(NX5 + NX5 IO) - -1. 通过适配器为 NX5 Kit 供电 -2. NX5 Kit 将在绿色电源 LED 亮起的情况下启动 - - - - - -## 常见问题 - -## 参考文档 diff --git a/docs/som/nx/nx5/android/install-system/README.md b/docs/som/nx/nx5/android/install-system/README.md new file mode 100644 index 000000000..b3b4f43fb --- /dev/null +++ b/docs/som/nx/nx5/android/install-system/README.md @@ -0,0 +1,7 @@ +--- +sidebar_position: 3 +--- + +# 安装系统 + + diff --git a/docs/som/nx/nx5/android/install-system/emmc-system/README.md b/docs/som/nx/nx5/android/install-system/emmc-system/README.md new file mode 100644 index 000000000..19a0fc2bf --- /dev/null +++ b/docs/som/nx/nx5/android/install-system/emmc-system/README.md @@ -0,0 +1,7 @@ +--- +sidebar_position: 10 +--- + +# 安装系统到板载 eMMC + + diff --git a/docs/som/nx/nx5/android/install-system/emmc-system/enter-maskrom.md b/docs/som/nx/nx5/android/install-system/emmc-system/enter-maskrom.md new file mode 100644 index 000000000..631e0d66c --- /dev/null +++ b/docs/som/nx/nx5/android/install-system/emmc-system/enter-maskrom.md @@ -0,0 +1,14 @@ +--- +sidebar_position: 5 + +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - docs/common/radxa-os/rkdevtool/_maskrom.mdx +--- + +import Maskrom from '../../../../../../common/radxa-os/rkdevtool/\_maskrom.mdx'; + +# 进入 Maskrom 模式 + + diff --git a/docs/som/nx/nx5/android/install-system/emmc-system/install-emmc.md b/docs/som/nx/nx5/android/install-system/emmc-system/install-emmc.md new file mode 100644 index 000000000..e97300408 --- /dev/null +++ b/docs/som/nx/nx5/android/install-system/emmc-system/install-emmc.md @@ -0,0 +1,34 @@ +--- +sidebar_position: 10 + +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - docs/common/radxa-os/rkdevtool/_emmc.mdx +--- + +import EMMC from '../../../../../../common/radxa-os/rkdevtool/\_emmc.mdx'; + +# 安装系统到板载 eMMC + +## 线刷系统 + + + +## 启动系统 + +完成系统的安装后,连接 HDMI 显示器,重新插拔电源适配器,即可启动系统。 + +
+ +
+ +① : 使用 HDMI 或 DP 数据线连接显示器和主板 + +② : 使用 USB-A 接口连接鼠标或键盘 + +③ : 使用 5V DC 电源适配器给主板供电 + +若主板供电正常,瑞莎 NX5 载板的电源指示灯亮绿色;显示器显示安卓系统桌面。 + +说明:瑞莎 NX5 载板的系统状态指示灯并不会亮起。 diff --git a/docs/som/nx/nx5/android/install-system/emmc-system/install-rkdevtool.md b/docs/som/nx/nx5/android/install-system/emmc-system/install-rkdevtool.md new file mode 100644 index 000000000..65d837ec3 --- /dev/null +++ b/docs/som/nx/nx5/android/install-system/emmc-system/install-rkdevtool.md @@ -0,0 +1,14 @@ +--- +sidebar_position: 1 + +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - docs/common/radxa-os/rkdevtool/_use.mdx +--- + +import UseRKDevTool from '../../../../../../common/radxa-os/rkdevtool/\_use.mdx'; + +# 安装 RKDevTool + + diff --git a/docs/som/nx/nx5/android/install-system/microsd-system.md b/docs/som/nx/nx5/android/install-system/microsd-system.md new file mode 100644 index 000000000..da7ddc62b --- /dev/null +++ b/docs/som/nx/nx5/android/install-system/microsd-system.md @@ -0,0 +1,27 @@ +--- +sidebar_position: 1 +--- + +import BalenaEtcherUse from '../../../../../common/radxa-os/install-system/\_use_etcher_sd.mdx'; + +# 安装系统到 microSD 卡 + + + +## 启动系统 + +
+ +
+ +① : 将 microSD 卡插入 microSD 卡槽 + +② : 使用 HDMI 或 DP 数据线连接显示器和主板 + +③ : 使用 USB-A 接口连接鼠标或键盘 + +④ : 使用 5V DC 电源适配器给主板供电 + +若主板供电正常,瑞莎 NX5 载板的电源指示灯亮绿色;显示器显示安卓系统桌面。 + +说明:瑞莎 NX5 载板的系统状态指示灯并不会亮起。 diff --git a/docs/som/nx/nx5/android/low-level-dev.md b/docs/som/nx/nx5/android/low-level-dev.md deleted file mode 100644 index bd2ca5b05..000000000 --- a/docs/som/nx/nx5/android/low-level-dev.md +++ /dev/null @@ -1,69 +0,0 @@ ---- -sidebar_position: 4 ---- - -# 底层开发 - -主要介绍 uboot, kernel, aosp 编译打包等内容 - -## 环境配置 - -建议使用 Ubuntu 20.04 及以上版本 - -## 源码下载 - -```bash - -$ repo init -u https://github.com/radxa/manifests.git -b Android12_Radxa_rk14 -m rockchip-s-release.xml -$ repo sync -d -c -j4 - -``` - -## 镜像编译 - -### 全部编译 - -适合第一次编译 - -```bash -android12 $ source build/envsetup.sh -android12 $ lunch RadxaRockNX5-userdebug -android12 $ ./build.sh -AUCKup -``` - -等待编译完成就可以在 IMAGE 目录找到镜像 - -### 单独编译 - -适合小修改后编译 - -例如,只修改过 - -U-boot - -```bash -radxa:rock-android12 $ source build/envsetup.sh -radxa:rock-android12 $ lunch RadxaRockNX5-userdebug -radxa:rock-android12 $ ./build.sh -AUup - -``` - -Kernel - -```bash -radxa:rock-android12 $ source build/envsetup.sh -radxa:rock-android12 $ lunch RadxaRocRadxaRockNX5k5B-userdebug -radxa:rock-android12 $ ./build.sh -ACKup -``` - -AOSP - -```bash -radxa:rock-android12 $ source build/envsetup.sh -radxa:rock-android12 $ lunch RadxaRockNX5-userdebug -radxa:rock-android12 $ ./build.sh -Aup -``` - -等待编译完成就可以在 IMAGE 目录找到镜像 - -## 常见问题 diff --git a/docs/som/nx/nx5/accessories/README.md b/docs/som/nx/nx5/android/low-level-dev/README.md similarity index 75% rename from docs/som/nx/nx5/accessories/README.md rename to docs/som/nx/nx5/android/low-level-dev/README.md index 5a417728e..1983ab73c 100644 --- a/docs/som/nx/nx5/accessories/README.md +++ b/docs/som/nx/nx5/android/low-level-dev/README.md @@ -2,6 +2,6 @@ sidebar_position: 5 --- -# 配件 +# 底层开发 diff --git a/docs/som/nx/nx5/android/low-level-dev/build-system.md b/docs/som/nx/nx5/android/low-level-dev/build-system.md new file mode 100644 index 000000000..d10ef9ba0 --- /dev/null +++ b/docs/som/nx/nx5/android/low-level-dev/build-system.md @@ -0,0 +1,88 @@ +--- +sidebar_position: 6 +--- + +# 构建系统 + +主要介绍 uboot, kernel, aosp 编译打包等内容。 + +## 环境配置 + +建议使用 Ubuntu 20.04 及以上版本。 + +## 源码下载 + + + +```bash +repo init -u https://github.com/radxa/manifests.git -b Android12_Radxa_rk14 -m rockchip-s-release.xml +repo sync +repo forall -c 'git lfs pull' +``` + + + +## 镜像编译 + +Android 系统支持两种编译方式: + +- **完整编译**:首次构建或需要完全重建时使用,耗时较长 +- **模块编译**:修改特定组件后使用,编译速度更快,例如仅修改内核时只需编译内核模块 + +### 全部编译 + +适合首次构建或需要完全重建时使用,耗时较长。 + + + +```bash +source build/envsetup.sh +lunch RadxaRockNX5-userdebug +./build.sh -UACKup +``` + + + +等待编译完成就可以在 `IMAGE` 目录找到镜像文件。 + +### 单独编译 + +适合修改特定组件后使用,编译速度更快。 + +#### Uboot + + + +```bash +source build/envsetup.sh +lunch RadxaRockNX5-userdebug +./build.sh -AUup +``` + + + +#### Kernel + + + +```bash +source build/envsetup.sh +lunch RadxaRockNX5-userdebug +./build.sh -ACKup +``` + + + +#### AOSP + + + +```bash +source build/envsetup.sh +lunch RadxaRockNX5-userdebug +./build.sh -Aup +``` + + + +等待编译完成就可以在 `IMAGE` 目录找到镜像文件。 diff --git a/docs/som/nx/nx5/android/remote-login.md b/docs/som/nx/nx5/android/remote-login.md deleted file mode 100644 index 332a16632..000000000 --- a/docs/som/nx/nx5/android/remote-login.md +++ /dev/null @@ -1,128 +0,0 @@ ---- -sidebar_position: 3 ---- - -import Serial from "../../../../common/general/\_serial.mdx" - -# 远程登录 - -本章节旨在向需要通过个人电脑(PC)远程访问 SBC 的用户介绍如何通过串口、adb 等方式进行远程登录 - - - - - - - - - - - -### 准备工作 - -adb(调试桥)安装: - - - - - -从Android[官方网站](https://source.android.com/docs/setup/build/adb)下载Windows版本的adb工具包,下载解压后需要配置环境变量: - -方式一:在终端窗口输入以下命令: - -```bash - -set HTTP_PROXY=myserver:1981 - -``` - -方式二:打开系统设置,修改环境变量:![NX5 adb](/img/nx5/adb_config.webp) - - - - - -使用以下命令安装即可: - -```bash - -sudo apt install adb - -``` - - - - - -从Android[官方网站](https://source.android.com/docs/setup/build/adb)下载Mac版本的adb工具包,下载解压后需要配置环境变量: -打开终端输入一下命令进行环境变量配置: - -```bash - -export PATH=${path}:~/platform-tools('~'代表解压出来的工具包路径) - -``` - - - - - - - - - -#### 要求 - -1. 一条USB 线 -2. 一台有安装 ADB 工具的电脑或笔记本 -3. 一个 Radxa NX5 - -#### 步骤 - -1. 用 USB 线连接计算机的 USB 接口和 Radxa NX5 的 OTG Type C 接口 -2. 打开计算机终端输入 adb devices 确认识别到 Radxa NX5 ,输入 adb shell 登录 - -```bash - -$ adb devices - List of devices attached - f94f8e0d28380ceb device - -$ adb shell - RadxaRockNX5:/ $ - -``` - - - - - -Android 11 版本以后支持无线 ADB 。 - -#### 要求 - -1. 一台有安装 ADB 工具的电脑或笔记本 ,ADB 版本需要大于 31.0.0 -2. 一个Radxa nx5,安卓镜像需要大于或等于 11 -3. 计算机和 Radxa NX5 需要在同一个局域网 - -#### 步骤 - -1. 启动 Radxa NX5 ,使用 wifi 连接 网络 -2. 进入开发着模式,点击7次版本号可进入开发着模式(设置 -> 关于平板电脑 -> 版本号) -3. 进入开发着选项(设置 -> 系统 -> 开发着选项),打开无线调试,记住IP地址和接(例:10.0.0.16:45613) -4. 打开计算机终端输入 adb connect 10.0.0.16:45613 连接 Radxa NX5 ,输入 adb shell 登录 - -```bash -$ adb connect 10.0.0.16:45613 - -$ adb shell - RadxaRockNX5:/ $ -``` - - - - - - - - diff --git a/docs/som/nx/nx5/android/serial-login.md b/docs/som/nx/nx5/android/serial-login.md new file mode 100644 index 000000000..c164210a2 --- /dev/null +++ b/docs/som/nx/nx5/android/serial-login.md @@ -0,0 +1,48 @@ +--- +sidebar_position: 4 +--- + +import UART_DEBUG from '../../../../common/other-system/android/\_uart_debug.mdx'; + +# 串口登录 + +## 使用前提 + +串口登录是嵌入式开发中通过串行通信接口 (UART) 与主板交互的核心手段,通过串口工具可以查看系统输出的日志和进行命令行交互。 + +:::danger +使用 USB 串口数据线和主板进行串口调试时,请确保引脚连接正确,接错引脚可能会导致主板硬件损坏。 + +不建议连接 USB 串口数据线的 VCC 接口(红色线),避免接错导致主板损坏。 +::: + +将 USB 串口数据线连接到瑞莎 NX5 开发套件的 UART2 接口,另一端连接到 PC 的 USB 端口。 + +说明:请根据厂商的 USB 串口线引脚定义进行连接,图中示例为常见的 USB 串口线引脚定义。 + +
+ +
+ +| 瑞莎 NX5 开发套件 | 连接方式 | +| ------------------ | ------------------------------------------------------------------------------ | +| GND(Pin6) | 瑞莎 NX5 开发套件的 GND 引脚连接 USB 串口数据线的 GND 引脚(黑色杜邦线) | +| UART2_TXD(Pin8) | 瑞莎 NX5 开发套件的 UART2_TXD 引脚连接 USB 串口数据线的 RXD 引脚(白色杜邦线) | +| UART2_RXD(Pin10) | 瑞莎 NX5 开发套件的 UART2_RXD 引脚连接 USB 串口数据线的 TXD 引脚(绿色杜邦线) | + +## 串口登录 + +:::tip 串口通讯参数 + +波特率:1500000 + +数据位:8 + +停止位:1 + +校验位:无 + +流控:无 +::: + + diff --git a/docs/som/nx/nx5/android/system-config.md b/docs/som/nx/nx5/android/system-config.md deleted file mode 100644 index c9a5b4543..000000000 --- a/docs/som/nx/nx5/android/system-config.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -sidebar_position: 6 ---- - -# 系统配置 diff --git a/docs/som/nx/nx5/download.md b/docs/som/nx/nx5/download.md new file mode 100644 index 000000000..298107bf2 --- /dev/null +++ b/docs/som/nx/nx5/download.md @@ -0,0 +1,53 @@ +--- +sidebar_position: 150 +--- + +# 资源汇总下载 + +## 刷机工具 + +- [Balena Etcher](https://etcher.balena.io/) + +- [DriverAssistant v5.14](https://dl.radxa.com/tools/windows/DriverAssitant_v5.14.zip) + +- [RKDevTool](https://dl.radxa.com/tools/windows/RKDevTool_Release_v2.96-20221121.rar) + +## Loader 文件 + +用于初始化 USB 下载。 + +- [rk3588_spl_loader.bin](https://dl.radxa.com/rock5/sw/images/loader/rock-5b/release/rk3588_spl_loader_v1.15.113.bin) + +## 系统镜像 + +### 瑞莎官方系统 + +:::info 最新系统镜像发布页面 + +- [瑞莎 NX5 载板系统镜像](https://github.com/radxa-build/radxa-nx5-io/releases/) + +该页面会发布最新的正式版本和测试版本的系统镜像,测试版本以 `t` 开头,正式版本以 `r` 开头(旧版本的正式版本以 `b` 开头)。 + +::: + +- [radxa-nx5-io_bookworm_kde_b2.output.img.xz](https://github.com/radxa-build/radxa-nx5-io/releases/download/rsdk-b2/radxa-nx5-io_bookworm_kde_b2.output.img.xz) + +### 安卓系统 + +- [Radxa-NX5-Android12-rkr14-20240326-gpt.zip](https://github.com/radxa/manifests/releases/download/radxa-nx5-android12-rkr14-20240326/Radxa-NX5-Android12-rkr14-20240326-gpt.zip) + +## 硬件设计 + +### 瑞莎 NX5 + +- [原理图 V1.1](https://dl.radxa.com/nx5/radxa_nx5_schematic_v1100.pdf) +- [位号图 V1.1](https://dl.radxa.com/nx5/radxa_nx5_components_placement_map_v1100.pdf) +- [引脚定义表 V1.1](https://dl.radxa.com/nx5/radxa_nx5_pinout_v1.1.xlsx) +- [2D DXF 文件 V1.1](https://dl.radxa.com/nx5/radxa_nx5_2d_dxf.zip) +- [3D STP 文件 V1.1](https://dl.radxa.com/nx5/radxa_nx5_v1.1_3d_stp.zip) + +### 瑞莎 NX5 载板 + +- [原理图 V1.4](https://dl.radxa.com/nx5/nx5-io-board/radxa_nx5_io_board_v1400_schematic.pdf) +- [位号图 V1.4](https://dl.radxa.com/nx5/nx5-io-board/radxa_nx5_io_board_v1400_components_placement_map.pdf) +- [设计参考资料](https://github.com/radxa/radxa-som-projects/tree/main/nx5/radxa-nx5-io-board) diff --git a/docs/som/nx/nx5/getting-started/README.md b/docs/som/nx/nx5/getting-started/README.md index 8d33dfa23..6e45f7b62 100644 --- a/docs/som/nx/nx5/getting-started/README.md +++ b/docs/som/nx/nx5/getting-started/README.md @@ -1,7 +1,7 @@ --- -sidebar_position: 1 +sidebar_position: 5 --- -# 快速上手 +# 上手指南 diff --git a/docs/som/nx/nx5/getting-started/accessory-usage.md b/docs/som/nx/nx5/getting-started/accessory-usage.md deleted file mode 100644 index f60dc3993..000000000 --- a/docs/som/nx/nx5/getting-started/accessory-usage.md +++ /dev/null @@ -1,61 +0,0 @@ ---- -sidebar_position: 3 ---- - -# 配件使用说明 - -主要介绍支持该产品的配件有哪些及介绍如何使用 - -## 接口总览 - -nx5_io_interface_overview - -## 摄像头 - -RADXA NX5 IO 带有两个 2-lane 的 CSI 接口。以下是目前支持的摄像头列表: - - - - - - - - - - - - - - - - - - - - - - -
Camera NameSensor 型号分辨率
OKDO 5MP CameraOV5647500万像素
Raspberry Pi Camera V1.3OV5647500万像素
Raspberry Pi Camera V2IMX219800万像素
- -更多相关信息请参考 [摄像头配件](../accessories/camera)。 - -## WIFI/BT - -RADXA NX5 IO 带有1个 M.2 Key, 以下是目前支持模组列表: - - - - - - - - - - - - - - -
模组名 描述
Radxa Wireless Module A8 Realtek RTL8852BE 的标准 M.2 2230 无线模块
AX210 Intel AX210 无线模块
- -更多相关信息请参考 [wifi/bt 配件](../accessories/wifi_bt_access)。 diff --git a/docs/som/nx/nx5/getting-started/download.md b/docs/som/nx/nx5/getting-started/download.md deleted file mode 100644 index 73a5bd992..000000000 --- a/docs/som/nx/nx5/getting-started/download.md +++ /dev/null @@ -1,43 +0,0 @@ ---- -sidebar_position: 4 ---- - -# 资源下载汇总 - -### 硬件设计 - -核心板和底板 - -[NX5 V1.1 原理图 pdf](https://dl.radxa.com/nx5/radxa_nx5_v1100_schematic.pdf) - -[NX5 V1.1 位号图 pdf](https://dl.radxa.com/nx5/radxa_nx5_v1100_smd.pdf) - -[NX5 V1.1 平面图 dxf](https://dl.radxa.com/nx5/nx5-io-board/radxa_nx5_v1100_2d.dxf) - -[NX5 IO V1.4 原理图 pdf](https://dl.radxa.com/nx5/nx5-io-board/radxa_nx5_io_board_v1400_schematic.pdf) - -[NX5 IO V1.4 位号图 pdf](https://dl.radxa.com/nx5/nx5-io-board/radxa_nx5_io_board_v1400_components_placement_map.pdf) - -[NX5 IO V1.4 平面图 dxf](https://dl.radxa.com/nx5/nx5-io-board/radxa_nx5_io_board_v1400_top_2d.dxf) - -[NX5 引脚定义 V1.1 xlsx](https://dl.radxa.com/nx5/radxa_nx5_pinout_v1.1.xlsx) - -[NX5 IO 板设计资料](https://github.com/radxa/radxa-cm-projects/tree/main/nx5/radxa-nx5-io-board) - -### 刷机工具 - -1. [Etcher](https://etcher.balena.io/#download-etcher/) -2. [rkdeveloptool 开源版本](https://opensource.rock-chips.com/wiki_Rkdeveloptool) -3. [RKDevTool v2.96](https://dl.radxa.com/tools/windows/RKDevTool_Release_v2.96_zh.zip) (含中文使用文档) -4. [DriverAssistant v5.14](https://dl.radxa.com/tools/windows/DriverAssitant_v5.14.zip)(相关驱动) - -### 操作系统镜像 - -- Radxa OS - - Radxa NX5 IO(6.1 内核): [radxa-nx5-io_debian_bookworm_kde_b2.img.xz](https://github.com/radxa-build/radxa-nx5-io/releases/download/rsdk-b2/radxa-nx5-io_bookworm_kde_b2.output.img.xz) - -- Android - Radxa NX5 IO Adroid: [radxa nx5 android12 rkr14](https://github.com/radxa/manifests/releases/download/radxa-nx5-android12-rkr14-20240326/Radxa-NX5-Android12-rkr14-20240326-update.zip) - -### 质量认证 diff --git a/docs/som/nx/nx5/getting-started/install-os.mdx b/docs/som/nx/nx5/getting-started/install-os.mdx deleted file mode 100644 index 467bcc460..000000000 --- a/docs/som/nx/nx5/getting-started/install-os.mdx +++ /dev/null @@ -1,27 +0,0 @@ ---- -sidebar_position: 2 - -doc_kind: wrapper -source_of_truth: local -imports_resolve_to: - - docs/som/nx/nx5/radxa-os/install-os.mdx - - docs/som/nx/nx5/android/install-os.mdx ---- - -import Installdebian from "../radxa-os/install-os.mdx"; -import Installandroid from "../android/install-os.mdx"; - -# 安装系统 - - - - - - - - - - - - - diff --git a/docs/som/nx/nx5/getting-started/install-system/README.md b/docs/som/nx/nx5/getting-started/install-system/README.md new file mode 100644 index 000000000..9f016143a --- /dev/null +++ b/docs/som/nx/nx5/getting-started/install-system/README.md @@ -0,0 +1,7 @@ +--- +sidebar_position: 10 +--- + +# 安装系统 + + diff --git a/docs/som/nx/nx5/getting-started/install-system/emmc-system/README.md b/docs/som/nx/nx5/getting-started/install-system/emmc-system/README.md new file mode 100644 index 000000000..19a0fc2bf --- /dev/null +++ b/docs/som/nx/nx5/getting-started/install-system/emmc-system/README.md @@ -0,0 +1,7 @@ +--- +sidebar_position: 10 +--- + +# 安装系统到板载 eMMC + + diff --git a/docs/som/nx/nx5/getting-started/install-system/emmc-system/enter-maskrom.md b/docs/som/nx/nx5/getting-started/install-system/emmc-system/enter-maskrom.md new file mode 100644 index 000000000..631e0d66c --- /dev/null +++ b/docs/som/nx/nx5/getting-started/install-system/emmc-system/enter-maskrom.md @@ -0,0 +1,14 @@ +--- +sidebar_position: 5 + +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - docs/common/radxa-os/rkdevtool/_maskrom.mdx +--- + +import Maskrom from '../../../../../../common/radxa-os/rkdevtool/\_maskrom.mdx'; + +# 进入 Maskrom 模式 + + diff --git a/docs/som/nx/nx5/getting-started/install-system/emmc-system/install-emmc.md b/docs/som/nx/nx5/getting-started/install-system/emmc-system/install-emmc.md new file mode 100644 index 000000000..0dc61ba22 --- /dev/null +++ b/docs/som/nx/nx5/getting-started/install-system/emmc-system/install-emmc.md @@ -0,0 +1,43 @@ +--- +sidebar_position: 10 + +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - docs/common/radxa-os/rkdevtool/_emmc.mdx +--- + +import EMMC from '../../../../../../common/radxa-os/rkdevtool/\_emmc.mdx'; + +# 安装系统到板载 eMMC + +## 线刷系统 + + + +## 启动系统 + +完成系统的安装后,连接 HDMI 显示器,重新插拔电源适配器,即可启动系统。 + +
+ +
+ +① : 使用 HDMI 或 DP 数据线连接显示器和主板 + +② : 使用 USB-A 接口连接鼠标或键盘 + +③ : 使用 5V DC 电源适配器给主板供电 + +若主板供电正常,瑞莎 NX5 系统指示灯和瑞莎 NX5 载板的电源指示灯亮绿色;若系统启动正常,瑞莎 NX5 系统指示灯绿色闪烁,瑞莎 NX5 载板的状态指示灯蓝色闪烁。 + +## 登录系统 + +当您首次启动系统后,需要使用默认的用户名和密码登录。 + +Radxa OS 的默认凭据如下: + +| 项目 | 内容 | +| :----- | :------ | +| 用户名 | `radxa` | +| 密码 | `radxa` | diff --git a/docs/som/nx/nx5/getting-started/install-system/emmc-system/install-rkdevtool.md b/docs/som/nx/nx5/getting-started/install-system/emmc-system/install-rkdevtool.md new file mode 100644 index 000000000..65d837ec3 --- /dev/null +++ b/docs/som/nx/nx5/getting-started/install-system/emmc-system/install-rkdevtool.md @@ -0,0 +1,14 @@ +--- +sidebar_position: 1 + +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - docs/common/radxa-os/rkdevtool/_use.mdx +--- + +import UseRKDevTool from '../../../../../../common/radxa-os/rkdevtool/\_use.mdx'; + +# 安装 RKDevTool + + diff --git a/docs/som/nx/nx5/getting-started/install-system/microsd-system.md b/docs/som/nx/nx5/getting-started/install-system/microsd-system.md new file mode 100644 index 000000000..4cd913833 --- /dev/null +++ b/docs/som/nx/nx5/getting-started/install-system/microsd-system.md @@ -0,0 +1,36 @@ +--- +sidebar_position: 1 +--- + +import BalenaEtcherUse from '../../../../../common/radxa-os/install-system/\_use_etcher_sd.mdx'; + +# 安装系统到 microSD 卡 + + + +## 启动系统 + +① : 将 microSD 卡插入 microSD 卡槽 + +② : 使用 HDMI 或 DP 数据线连接显示器和主板 + +③ : 使用 USB-A 接口连接鼠标或键盘 + +④ : 使用 5V DC 电源适配器给主板供电 + +若主板供电正常,瑞莎 NX5 系统指示灯和瑞莎 NX5 载板的电源指示灯亮绿色;若系统启动正常,瑞莎 NX5 系统指示灯绿色闪烁,瑞莎 NX5 载板的状态指示灯蓝色闪烁。 + +
+ +
+ +成功启动系统后,显示器会显示系统桌面,你可以根据系统信息登录并使用系统。 + +## 系统信息 + +使用官方系统镜像时,请使用以下默认登录凭据: + +| 项目 | 内容 | +| :----- | :------ | +| 用户名 | `radxa` | +| 密码 | `radxa` | diff --git a/docs/som/nx/nx5/getting-started/preparation.md b/docs/som/nx/nx5/getting-started/preparation.md deleted file mode 100644 index 68d50e1db..000000000 --- a/docs/som/nx/nx5/getting-started/preparation.md +++ /dev/null @@ -1,38 +0,0 @@ ---- -sidebar_position: 1 ---- - -# 准备工作 - -## 开发准备 - -### 供电 - -RADXA NX5 IO 采用 DC 接口供电,仅支持 5V 输入 - -:::tip -瑞莎推荐使用 [Radxa Power PD30W](../accessories/power/pd_30w) -::: - -### 存储 - -microSD 卡,容量不小于 8GB, 用于系统启动盘 - -### 显示 - -带有 HDMI 或 DP 接口的显示器,HDMI 最高可支持8K显示输出 - -### 网络连接 - -- NX5 IO 提供以太网口可接入1000M 以太网 -- 提供 M.2 KEY 接口,可兼容市面上常见的 PCIe 协议网卡,如 AX210, A8 模组 - -### USB 鼠标/键盘 - -可插入标准的鼠标键盘外设,用于系统调试和操作 - -## 常见问题 - -## 注意事项 - -## 参考文档 diff --git a/docs/som/nx/nx5/getting-started/quickly-start.md b/docs/som/nx/nx5/getting-started/quickly-start.md new file mode 100644 index 000000000..8d6779c5e --- /dev/null +++ b/docs/som/nx/nx5/getting-started/quickly-start.md @@ -0,0 +1,102 @@ +--- +sidebar_position: 1 +--- + +import UseRKDevTool from '../../../../common/radxa-os/rkdevtool/\_use.mdx'; +import EMMC from '../../../../common/radxa-os/rkdevtool/\_emmc.mdx'; +import Maskrom from '../../../../common/radxa-os/rkdevtool/\_maskrom.mdx'; + +# 快速上手 + +本节教程将指导您快速上手使用瑞莎 NX5 开发套件,帮助您快速验证瑞莎 NX5 的功能。 + +## 产品实物 + +瑞莎 NX5 开发套件由瑞莎 NX5 核心模组和瑞莎 NX5 载板组成,提供了完整的硬件开发平台,可用于快速验证核心板功能、评估性能并搭建原型系统,帮助用户高效完成开发与方案验证。 + +说明:瑞莎 NX5 载板需要用户自行购买 + +
+ +
+ +## 使用前提 + +您需要提前准备以下硬件设备: + +- 瑞莎 NX5 开发套件 +- 供电:DC 5525 电源适配器(5V 输入) +- 系统启动介质:板载 eMMC +- 数据线:Micro USB 数据线(用于线刷系统到 eMMC) +- 显示设备:HDMI 数据线和显示器 +- 输入设备:键盘和鼠标(用于图形界面操作) + +:::tip 推荐配件 + +- 推荐使用 5V/3A 或以上规格的 DC 电源适配器进行供电 + +::: + +## 安装系统 + +:::tip 系统说明 + +若需要安装系统到 microSD 卡,请参考 [安装系统到 microSD 卡](./install-system/microsd-system.md) + +若 microSD 卡和板载 eMMC 均存在系统,系统将优先从 microSD 卡启动。 + +::: + +快速上手主要介绍安装系统到瑞莎 NX5 的板载 eMMC。 + +:::warning 重要提醒 + +**安装系统会完全格式化 eMMC,所有数据将被永久删除!** + +请在操作前确认: + +- eMMC 中无重要数据或已完成资料备份 + ::: + +### 安装 RKDevTool + + + +### 进入 Maskrom 模式 + + + +### 安装系统到 eMMC + + + +## 启动系统 + +完成系统的安装后,连接 HDMI 显示器,重新插拔电源适配器,即可启动系统。 + +
+ +
+ +① : 使用 HDMI 或 DP 数据线连接显示器和主板 + +② : 使用 USB-A 接口连接鼠标或键盘 + +③ : 使用 5V DC 电源适配器给主板供电 + +若主板供电正常,瑞莎 NX5 系统指示灯和瑞莎 NX5 载板的电源指示灯亮绿色;若系统启动正常,瑞莎 NX5 系统指示灯绿色闪烁,瑞莎 NX5 载板的状态指示灯蓝色闪烁。 + +## 登录系统 + +当您首次启动系统后,需要使用默认的用户名和密码登录。 + +Radxa OS 的默认凭据如下: + +| 项目 | 内容 | +| :----- | :------ | +| 用户名 | `radxa` | +| 密码 | `radxa` | + +## 使用系统 + +成功登录系统后,您就可以在瑞莎 NX5 开发套件上进行系统配置与开发。 diff --git a/docs/som/nx/nx5/hardware-use/README.md b/docs/som/nx/nx5/hardware-use/README.md new file mode 100644 index 000000000..c0317ba6b --- /dev/null +++ b/docs/som/nx/nx5/hardware-use/README.md @@ -0,0 +1,7 @@ +--- +sidebar_position: 15 +--- + +# 硬件使用 + + diff --git a/docs/som/nx/nx5/hardware/hw-interface.md b/docs/som/nx/nx5/hardware-use/gpio.md similarity index 83% rename from docs/som/nx/nx5/hardware/hw-interface.md rename to docs/som/nx/nx5/hardware-use/gpio.md index bb3215deb..401d18467 100644 --- a/docs/som/nx/nx5/hardware/hw-interface.md +++ b/docs/som/nx/nx5/hardware-use/gpio.md @@ -1,57 +1,23 @@ --- -sidebar_position: 4 +sidebar_position: 5 --- -# 硬件接口说明 +# 40-Pin GPIO 排针 -## 接口总览 +瑞莎 NX5 载板板载 40-Pin GPIO(通用输入输出)接口,为硬件扩展提供了高度灵活的接口支持。 -![Radxa NX5](/img/nx5/nx5-overview.webp) -![Radxa NX5 IO](/img/nx5/nx5-io/nx5-io-overview.webp) +用户可以通过 40-Pin GPIO 接口连接各类传感器、执行器、通信模块、显示屏以及其他嵌入式外设,从而快速实现物联网、机器人控制、工业自动化等领域的原型开发与功能验证。 -- 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 +:::danger 使用说明 -## 电源接口 +使用 40-Pin GPIO 接口时,请注意引脚和外设的接线,请确保引脚连接正确,不当操作可能导致设备硬件损坏。 -采用 DC 电源接口供电,仅支持 5V 输入 +::: -## 调试串口 +## GPIO 功能 -用于系统调试,底层日志消息输出 -参考 [串口调试](../radxa-os/low-level-dev/serial) - -## 有线网口 - -提供以太网接口,可接入千兆以太网 - -## 40 PIN GPIO - -### GPIO 电压 - -| GPIO | 电压 | 最高 | -| ---------- | ---- | ----- | -| 所有的GPIO | 3.3V | 3.63V | -| SARADC_IN4 | 1.8V | 1.98V | - -### GPIO 接口 - -Radxa NX5 IO 提供了一个40pin针脚的GPIO座子,兼容于市面上大部分传感器的应用。 -**_提示:_ 实际兼容情况以使用为准。** - -
+ +
| GPIO number | Function7 | Function6 | Function5 | Function4 | Function3 | Function2 | Function1 | Pin# | Pin# | Function1 | Function2 | Function3 | Function4 | Function5 | Function6 | Function7 | GPIO number | | :---------: | :-------: | :----------: | :-----------: | :----------: | :--------: | :---------: | :-------: | :------------------------------: | :-----------------------------: | :-------: | :---------: | :---------: | :----------: | :---------------------------------------: | :----------: | :--------: | :---------: | @@ -76,24 +42,5 @@ Radxa NX5 IO 提供了一个40pin针脚的GPIO座子,兼容于市面上大部 | 57 | I2S0_SDI3 | I2S0_SDO2 | UART6_RX_M2 | SPI1_MOSI_M2 | | I2C7_SDA_M0 | GPIO1_D1 |
37
|
38
| GPIO1_D4 | | | | | I2S0_SDI0 | | 60 | | | | | | | | | GND |
39
|
40
| GPIO1_C7 | I2C4_SCL_M4 | | | UART4_CTSN | I2S0_SDO0 | | 55 | -
- -## WIFI/BT - -提供 M.2 KEY 接口,可兼容市面上常见的 PCIe 协议网卡,如 Radxa Wireless A8 模组 - -## HDMI/DP - -配备全尺寸 HDMI 和 DP 接口,支持常规的4K、2K、1080P等分辨率, HDMI 接口最高支持 8K 分辨率 - -## USB - -提供 4 个 USB3.0 端口,兼容 USB2.0 - -## MIPI CSI - -支持 MIPI 摄像头 - -## MicroSD - -可用于系统启动盘,也可以充当存储介质使用 +
+
diff --git a/docs/som/nx/nx5/hardware-use/hardware-info.md b/docs/som/nx/nx5/hardware-use/hardware-info.md new file mode 100644 index 000000000..228ee153b --- /dev/null +++ b/docs/som/nx/nx5/hardware-use/hardware-info.md @@ -0,0 +1,66 @@ +--- +sidebar_position: 1 +--- + +# 硬件信息 + +## 芯片框图 + +
+ +
+ +## 接口说明 + + + + + +
+ +
+ +| 序号 | 说明 | 序号 | 说明 | 序号 | 说明 | +| :--: | :-------------- | :--: | :------------- | :--: | :-------- | +| 1 | LPDDR4X | 2 | 瑞芯微 RK3588S | 3 | 板载 eMMC | +| 4 | 260-pin SO-DIMM | 5 | SPI Flash | | | + +
+ + + +
+ +
+ +| 序号 | 说明 | 序号 | 说明 | 序号 | 说明 | +| :--: | :--------------------- | :--: | :----------------------------- | :--: | :------------------------- | +| 1 | 2x USB 3.1 Gen1 Type-A | 2 | 上:DP 输出
下: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 | + +
+ + + +
+ 瑞莎 NX5 开发套件接口图 +
+ +| 序号 | 说明 | 序号 | 说明 | +| :--: | :------------ | :--: | :------- | +| 1 | 瑞莎 NX5 载板 | 2 | 瑞莎 NX5 | + +
+ +
+ +- 瑞莎 NX5 + +瑞莎 NX5 板载一个系统状态指示灯,绿色常亮说明供电正常,绿色闪烁说明系统启动正常。 + +- 瑞莎 NX5 载板 + +瑞莎 NX5 载板板载电源指示灯和系统状态指示灯,电源指示灯绿色常亮说明供电正常,系统状态指示灯蓝色闪缩说明系统启动正常。 diff --git a/docs/som/nx/nx5/hardware/README.md b/docs/som/nx/nx5/hardware/README.md deleted file mode 100644 index 80c494934..000000000 --- a/docs/som/nx/nx5/hardware/README.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -sidebar_position: 4 ---- - -# 硬件信息 - - diff --git a/docs/som/nx/nx5/hardware/hw-revision.md b/docs/som/nx/nx5/hardware/hw-revision.md deleted file mode 100644 index 4f64731a3..000000000 --- a/docs/som/nx/nx5/hardware/hw-revision.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -sidebar_position: 4 ---- - -# 硬件版本 - -## V1.11 - -- 版本丝印更新为 V1.11 -- 删除 Maskrom 按键 diff --git a/docs/som/nx/nx5/low-level-dev/README.md b/docs/som/nx/nx5/low-level-dev/README.md new file mode 100644 index 000000000..9a90303dd --- /dev/null +++ b/docs/som/nx/nx5/low-level-dev/README.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 17 +--- + +# 底层开发 + +对瑞莎 NX5 进行底层开发做简单的介绍。 + + diff --git a/docs/som/nx/nx5/low-level-dev/kernel.md b/docs/som/nx/nx5/low-level-dev/kernel.md new file mode 100644 index 000000000..212a73506 --- /dev/null +++ b/docs/som/nx/nx5/low-level-dev/kernel.md @@ -0,0 +1,15 @@ +--- +sidebar_position: 2 +description: "用 Radxa BSP 工具,轻松构建个性化 Linux 内核,享受定制化硬件开发的乐趣" + +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - docs/common/dev/_kernel.mdx +--- + +import KERNEL from '../../../../common/dev/\_kernel.mdx' + +# Kernel 开发 + + diff --git a/docs/som/nx/nx5/radxa-os/low-level-dev/rsdk.md b/docs/som/nx/nx5/low-level-dev/rsdk.md similarity index 50% rename from docs/som/nx/nx5/radxa-os/low-level-dev/rsdk.md rename to docs/som/nx/nx5/low-level-dev/rsdk.md index 3d29cf383..3fc726fcb 100644 --- a/docs/som/nx/nx5/radxa-os/low-level-dev/rsdk.md +++ b/docs/som/nx/nx5/low-level-dev/rsdk.md @@ -1,6 +1,6 @@ --- -sidebar_position: 4 -description: "使用 rsdk 工具定制您的系统" +sidebar_position: 3 +description: "使用 RSDK 工具定制您的系统" doc_kind: wrapper source_of_truth: common @@ -8,7 +8,7 @@ imports_resolve_to: - docs/common/dev/_rsdk.mdx --- -import RSDK from '../../../../../common/dev/\_rsdk.mdx' +import RSDK from '../../../../common/dev/\_rsdk.mdx' # 编译 RadxaOS diff --git a/docs/som/nx/nx5/low-level-dev/u-boot.md b/docs/som/nx/nx5/low-level-dev/u-boot.md new file mode 100644 index 000000000..a2392d10c --- /dev/null +++ b/docs/som/nx/nx5/low-level-dev/u-boot.md @@ -0,0 +1,15 @@ +--- +sidebar_position: 1 +description: "用 Radxa BSP 工具,轻松构建个性化 U-boot,开启智能硬件的创新之旅" + +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - docs/common/dev/_u-boot.mdx +--- + +import UBOOT from '../../../../common/dev/\_u-boot.mdx' + +# U-boot 开发 + + diff --git a/docs/som/nx/nx5/radxa-os/README.md b/docs/som/nx/nx5/radxa-os/README.md deleted file mode 100644 index a496da5ef..000000000 --- a/docs/som/nx/nx5/radxa-os/README.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -sidebar_position: 2 ---- - -# 瑞莎系统 - - diff --git a/docs/som/nx/nx5/radxa-os/ap.md b/docs/som/nx/nx5/radxa-os/ap.md deleted file mode 100644 index 9bccc8a04..000000000 --- a/docs/som/nx/nx5/radxa-os/ap.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -doc_kind: wrapper -source_of_truth: common -imports_resolve_to: - - docs/common/radxa-os/_ap.mdx ---- - -import AP from "../../../../common/radxa-os/\_ap.mdx"; - -# Wi-Fi 热点 - - diff --git a/docs/som/nx/nx5/radxa-os/app-dev/README.md b/docs/som/nx/nx5/radxa-os/app-dev/README.md deleted file mode 100644 index 56feb7ca7..000000000 --- a/docs/som/nx/nx5/radxa-os/app-dev/README.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -sidebar_position: 5 ---- - -# 应用开发 - -主要介绍上层应用开发,比如QT, Mraa 等 - - diff --git a/docs/som/nx/nx5/radxa-os/app-dev/mraa.md b/docs/som/nx/nx5/radxa-os/app-dev/mraa.md deleted file mode 100644 index 9be1ca84d..000000000 --- a/docs/som/nx/nx5/radxa-os/app-dev/mraa.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -sidebar_position: 1 - -doc_kind: wrapper -source_of_truth: common -imports_resolve_to: - - docs/common/dev/_mraa.mdx ---- - -# Mraa 使用 - -import MRAA from '../../../../../common/dev/\_mraa.mdx'; - - diff --git a/docs/som/nx/nx5/radxa-os/app-dev/venv_usage.md b/docs/som/nx/nx5/radxa-os/app-dev/venv_usage.md deleted file mode 100644 index 0130b5009..000000000 --- a/docs/som/nx/nx5/radxa-os/app-dev/venv_usage.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -sidebar_position: 2 - -doc_kind: wrapper -source_of_truth: common -imports_resolve_to: - - docs/common/dev/_venv_usage.mdx ---- - -# Python 虚拟环境使用 - -import VENVUSAGE from '../../../../../common/dev/\_venv_usage.mdx'; - - diff --git a/docs/som/nx/nx5/radxa-os/apps-deploy/README.md b/docs/som/nx/nx5/radxa-os/apps-deploy/README.md deleted file mode 100644 index 7ead9e508..000000000 --- a/docs/som/nx/nx5/radxa-os/apps-deploy/README.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -sidebar_position: 4 ---- - -# 应用部署 - -主要介绍类似 Samba, Docker, PVE, OMV, LAMP, Cheese, 远程控制面板等常见应用的配置及使用 - - diff --git a/docs/som/nx/nx5/radxa-os/apps-deploy/docker.md b/docs/som/nx/nx5/radxa-os/apps-deploy/docker.md deleted file mode 100644 index 42e7d614c..000000000 --- a/docs/som/nx/nx5/radxa-os/apps-deploy/docker.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -sidebar_position: 1 ---- - -# Docker - -Radxa Debian 在内核已经开启 Docker 相关的配置,只需安装 Docker 应用即可开始使用。 - -1. 安装 Docker - -```bash -sudo apt-get update -sudo apt-get install docker.io -``` - -2. 安装完成后执行以下两条命令 - -```bash -sudo update-alternatives --set iptables /usr/sbin/iptables-legacy -sudo update-alternatives --set ip6tables /usr/sbin/ip6tables-legacy -sudo reboot -``` - -3. 重启后运行 docker test,查看 运行状态 - -```bash -sudo docker run hello-world -sudo systemctl status docker -``` diff --git a/docs/som/nx/nx5/radxa-os/apps-deploy/samba.md b/docs/som/nx/nx5/radxa-os/apps-deploy/samba.md deleted file mode 100644 index a4e6386ca..000000000 --- a/docs/som/nx/nx5/radxa-os/apps-deploy/samba.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -sidebar_position: 2 ---- - -# Samba diff --git a/docs/som/nx/nx5/radxa-os/fcitx-usage.md b/docs/som/nx/nx5/radxa-os/fcitx-usage.md deleted file mode 100644 index 1dc8d4fe8..000000000 --- a/docs/som/nx/nx5/radxa-os/fcitx-usage.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -sidebar_position: 10 -description: "Fcitx5 输入法安装与使用" - -doc_kind: wrapper -source_of_truth: common -imports_resolve_to: - - docs/common/radxa-os/system-config/_fcitx_usage.mdx ---- - -import FCITX from "../../../../common/radxa-os/system-config/\_fcitx_usage.mdx"; - -# 输入法使用 - - diff --git a/docs/som/nx/nx5/radxa-os/install-os.mdx b/docs/som/nx/nx5/radxa-os/install-os.mdx deleted file mode 100644 index d9ccdd54c..000000000 --- a/docs/som/nx/nx5/radxa-os/install-os.mdx +++ /dev/null @@ -1,112 +0,0 @@ ---- -sidebar_position: 1 -title: 系统安装 ---- - -本文档将介绍如何把 Radxa OS 镜像安装到 Radxa NX5。 - -NX5 可以从 microSD 卡启动,也可以从板载 EMMC 启动,基于不同的启动方式,安装系统到不同的介质上. - - - - - -## 准备工作 - -### 准备安装介质 - -- microSD 卡 (建议class10等级以上) - -- USB 读卡器 - -### 镜像下载 - -请到 [资源下载汇总](../getting-started/download) 下载对应的镜像文件 - -:::tip 镜像说明 -下载的系统镜像为压缩格式,使用 Balena Etcher 进行镜像烧录前,需先完成解压操作。 -::: - -## 系统安装 - -1. 下载 [Etcher](https://etcher.balena.io/)。 - ![ROCK5A via Etcher 01](/img/rock5a/rock5a-etcher.webp) - -2. 打开 Etcher,将准备的操作系统镜像刷写到 microSD 卡。在 Etcher 窗口中,单击 `Flash from file` 选择刚下载的操作系统镜像。 - ![ROCK5A via Etcher 02](/img/rock5a/rock5a-etcher-1.webp) - -3. 在 Etcher 窗口中,点击 `Select target`。 - ![ROCK5A via Etcher 03](/img/rock5a/rock5a-etcher-2.webp) - -4. 在 Etcher 窗口中,点击 `Flash!` 然后等待刷写进度条。 - ![ROCK5A via Etcher 04](/img/rock5a/rock5a-etcher-3.webp) - -5. 在 Etcher 窗口中,当刷写成功时将会显示 `Flash Complete!` - ![ROCK5A via Etcher 05](/img/rock5a/rock5a-etcher-4.webp) - -## 系统启动 - -### 启动 NX5 IO - -1. 插入安装好操作系统的microSD卡 -2. 通过适配器为 NX5 IO 供电 -3. NX5 IO 将在绿色电源 LED 亮起的情况下启动, 进入系统后蓝色 LED 开始闪烁 - - - - - -## 准备工作 - -### 准备安装介质 - -- micro usb 转 typea usb 接口线缆 - -### 镜像下载 - -请到 [资源下载汇总](../getting-started/download) 下载对应的镜像文件 - -## 系统安装 - -### 系统安装 - -1. 将micro usb 线缆连接到主机 - -2. 按住 maskrom 按键后上电,此时会进入 maskrom 模式 - - - - - -#### Linux/Mac 系统使用 rkdeveloptool 写入 - -[rkdeveloptool](/compute-module/nx5/radxa-os/low-level-dev/rkdeveloptool) - -[upgrade_tool](/compute-module/nx5/radxa-os/low-level-dev/upgrade-tool)(可同时烧录多台设备) - - - - - -#### Windows 系统使用 rkdeveloptool 写入 - -[rkdevtool](/compute-module/nx5/radxa-os/low-level-dev/rkdevtool) - - - - - -## 系统启动 - -### 启动 NX5 IO - -1. 通过适配器为 NX5 IO 供电 -2. NX5 IO 将在绿色电源 LED 亮起的情况下启动, 进入系统后蓝色 LED 开始闪烁 - - - - - -## 常见问题 - -## 参考文档 diff --git a/docs/som/nx/nx5/radxa-os/low-level-dev/README.md b/docs/som/nx/nx5/radxa-os/low-level-dev/README.md deleted file mode 100644 index 817ef793b..000000000 --- a/docs/som/nx/nx5/radxa-os/low-level-dev/README.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -sidebar_position: 7 ---- - -# 底层开发 - -主要介绍 uboot, kernel, debian os 编译打包等内容 - - diff --git a/docs/som/nx/nx5/radxa-os/low-level-dev/kernel.md b/docs/som/nx/nx5/radxa-os/low-level-dev/kernel.md deleted file mode 100644 index dff8ea195..000000000 --- a/docs/som/nx/nx5/radxa-os/low-level-dev/kernel.md +++ /dev/null @@ -1,52 +0,0 @@ ---- -sidebar_position: 2 ---- - -# Kernel - -## 环境配置 - -[bsp](https://github.com/radxa-repo/bsp) 是 Radxa 提供的一套快速构建 U-Boot Kernel 的工具,使用 bsp 非常方便就能构建出自己的 U-Boot 和 Kernel. -下面将为您展示如何使用 bsp 构建 Radxa NX5 IO 的内核 - -[bsp 环境配置](https://radxa-repo.github.io/bsp/) - -## 编译内核 - -完成 bsp 环境配置后,需要先编译一次内核才会从仓库拉取内核代码,可以执行`./bsp linux rockchip`构建内核, 内核源码的路径位于 bsp 目录下的 `.src/linux` - -```shell -cd bsp -mkdir output -cd output -../bsp --no-prepare-source linux rockchip -r 1 - -参数说明: ---no-prepare-source # 使用本地修改进行编译,如果不加这个参数将会从 Radxa kernel 仓库同步最新代码并覆盖本地修改 --r 1 # 指定内核的版本号为 1, 用于指定不同内核版本的启动顺序 -``` - -:::note - -配置的内核版本号需要大于当前内核版本号才会默认使用新内核启动 - -::: - -更多 bsp 参数使用说明可以执行 `./bsp`查看 - -编译完成后会在 bsp/output 目录生成许多 `deb` 包, 只需要安装下面两个 `deb` 即可 - -```shell -linux-headers-5.10.110-1-rockchip_5.10.110-1_arm64.deb -linux-image-5.10.110-1-rockchip_5.10.110-1_arm64.deb -``` - -将上面两个 `deb` 包复制到板子上使用 `dpkg` 指令安装即可完成内核安装 - -```shell -sudo dpkg -i linux-headers-5.10.110-1-rockchip_5.10.110-1_arm64.deb -sudo dpkg -i linux-image-5.10.110-1-rockchip_5.10.110-1_arm64.deb -sudo reboot -``` - -重启完成后可以通过 `uname -a` 查看当前启动的内核版本号来查看是否安装成功 diff --git a/docs/som/nx/nx5/radxa-os/low-level-dev/rk_anti_copy_board.md b/docs/som/nx/nx5/radxa-os/low-level-dev/rk_anti_copy_board.md deleted file mode 100644 index c1f1bd90a..000000000 --- a/docs/som/nx/nx5/radxa-os/low-level-dev/rk_anti_copy_board.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -sidebar_position: 5 -description: "Rockchip 芯片提供防抄板技术,保护客户的固件、私有数据、核心代码。" - -doc_kind: wrapper -source_of_truth: common -imports_resolve_to: - - docs/common/dev/_rk_anti_copy_board.mdx ---- - -import ANTICOPY from '../../../../../common/dev/\_rk_anti_copy_board.mdx' - -# Rockchip 防抄板技术 - -Rockchip 芯片提供防抄板技术,保护客户的固件、私有数据、核心代码。 -防抄板技术主要用于防止客户的固件和私有数据被非授权用户非法拷贝并使用,避免被抄板造成商业上的损失。 - - diff --git a/docs/som/nx/nx5/radxa-os/low-level-dev/rkdeveloptool.md b/docs/som/nx/nx5/radxa-os/low-level-dev/rkdeveloptool.md deleted file mode 100644 index 96f0f9dd0..000000000 --- a/docs/som/nx/nx5/radxa-os/low-level-dev/rkdeveloptool.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -doc_kind: wrapper -source_of_truth: common -imports_resolve_to: - - docs/common/dev/_rkdeveloptool.mdx ---- - -import Rkdeveloptool from "../../../../../common/dev/\_rkdeveloptool.mdx"; - - diff --git a/docs/som/nx/nx5/radxa-os/low-level-dev/rkdevtool.md b/docs/som/nx/nx5/radxa-os/low-level-dev/rkdevtool.md deleted file mode 100644 index 1079cb552..000000000 --- a/docs/som/nx/nx5/radxa-os/low-level-dev/rkdevtool.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -doc_kind: wrapper -source_of_truth: common -imports_resolve_to: - - docs/common/dev/_rkdevtool.mdx ---- - -import RKDevTool from "../../../../../common/dev/\_rkdevtool.mdx" - -# RKDevTool - - diff --git a/docs/som/nx/nx5/radxa-os/low-level-dev/serial.md b/docs/som/nx/nx5/radxa-os/low-level-dev/serial.md deleted file mode 100644 index 6292a0df1..000000000 --- a/docs/som/nx/nx5/radxa-os/low-level-dev/serial.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -doc_kind: wrapper -source_of_truth: common -imports_resolve_to: - - docs/common/general/_serial.mdx ---- - -import Serial from "../../../../../common/general/\_serial.mdx" - -# UART 串口控制台 - - diff --git a/docs/som/nx/nx5/radxa-os/low-level-dev/u-boot.md b/docs/som/nx/nx5/radxa-os/low-level-dev/u-boot.md deleted file mode 100644 index 09c28b08d..000000000 --- a/docs/som/nx/nx5/radxa-os/low-level-dev/u-boot.md +++ /dev/null @@ -1,50 +0,0 @@ ---- -sidebar_position: 2 ---- - -# U-boot - -## 环境配置 - -[bsp](https://github.com/radxa-repo/bsp) 是 Radxa 提供的一套快速构建 U-Boot Kernel 的工具,使用 bsp 非常方便就能构建出自己的 U-Boot 和 Kernel. -下面将为您展示如何使用 bsp 构建 Radxa NX5 IO 的 U-Boot - -[bsp 环境配置](https://radxa-repo.github.io/bsp/) - -## 编译 U-Boot - -完成 bsp 环境配置后,需要先编译一次 U-Boot 才会从仓库拉取相关代码,可以执行`./bsp u-boot rknext radxa-nx5-io`构建 U-Boot, U-Boot 源码的路径位于 bsp 目录下的 `.src/u-boot` - -```shell -cd bsp -mkdir output -cd output -../bsp --no-prepare-source u-boot rknext radxa-nx5-io - -参数说明: ---no-prepare-source # 使用本地修改进行编译,如果不加这个参数将会从 Radxa U-Boot 仓库同步最新代码并覆盖本地修改 -``` - -更多 bsp 参数使用说明可以执行 `./bsp`查看 - -编译完成后会在 bsp/output 目录生成许多 `deb` 包, 只需要安装下面的 `deb` 即可 - -```shell -u-boot-rknext_2017.09-1_arm64.deb -``` - -将上面 `deb` 包复制到板子上使用 `dpkg` 指令安装即可完成 U-Boot 导入 - -```shell -sudo dpkg -i u-boot-rknext_2017.09-1_arm64.deb -``` - -导入完成后需要将 U-Boot 刷到启动介质中 - -```shell -cd /usr/lib/u-boot/radxa-nx5-io/ -sudo ./setup.sh update_bootloader /dev/mmcblk1 #/dev/mmcblk1 为你当前使用的启动介质,需要根据实际使用的设备来选择 -sudo reboot -``` - -重启后可以观察 U-Boot 启动日志查看 U-Boot 是否更新成功 diff --git a/docs/som/nx/nx5/radxa-os/low-level-dev/upgrade-tool.md b/docs/som/nx/nx5/radxa-os/low-level-dev/upgrade-tool.md deleted file mode 100644 index 95fb02636..000000000 --- a/docs/som/nx/nx5/radxa-os/low-level-dev/upgrade-tool.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -doc_kind: wrapper -source_of_truth: common -imports_resolve_to: - - docs/common/dev/_upgrade-tool.mdx ---- - -import UpgradeTool from "../../../../../common/dev/\_upgrade-tool.mdx" - -# upgrade_tool - - diff --git a/docs/som/nx/nx5/radxa-os/mali-gpu.md b/docs/som/nx/nx5/radxa-os/mali-gpu.md deleted file mode 100644 index bb285cc11..000000000 --- a/docs/som/nx/nx5/radxa-os/mali-gpu.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -doc_kind: wrapper -source_of_truth: common -imports_resolve_to: - - docs/common/radxa-os/_mali-gpu.mdx ---- - -import Mali from "../../../../common/radxa-os/\_mali-gpu.mdx"; - -# 切换 GPU 驱动 - - diff --git a/docs/som/nx/nx5/radxa-os/os-usage/README.md b/docs/som/nx/nx5/radxa-os/os-usage/README.md deleted file mode 100644 index 47349f28e..000000000 --- a/docs/som/nx/nx5/radxa-os/os-usage/README.md +++ /dev/null @@ -1,174 +0,0 @@ ---- -sidebar_position: 2 ---- - -import Serial from "../../../../../common/general/\_serial.mdx" - -# 系统使用 - -主要介绍 Radxa OS 系统的基本使用方法,帮助你快速了解常用的系统的配置。 - -## 用户名和密码 - -Radxa ROCK 系列默认添加的用户名和密码为: - -```text -用户名:radxa/rock -密码: radxa/rock -``` - -## 串口登录 - - - -## 设置网络 - -### 连接WiFi - -### 以太网连接 - -## 自动登录 - -为了更快进入桌面,可以设置桌面自动登录,修改 `/etc/lightdm/lightdm.conf` 文件 - -```bash -sudo vim /etc/lightdm/lightdm.conf -找到 [Seat:*] 下的 #autologin-user= ,将这个配置修改为你需要登录的用户 - -[Seat:*] -... -autologin-user=radxa -autologin-user-timeout=0 -... -``` - -## 语言设置 - -1. 安装简体中文字体: - -```bash -sudo apt-get install fonts-wqy-zenhei -``` - -2. 设置系统语言为中文桌面: - -```bash -sudo dpkg-reconfigure locales -``` - -3. 选择中文语言 - -![set language1 ](/img/zero/zero3/set-language1.webp) - -![set language2 ](/img/zero/zero3/set-language2.webp) - -4. 重启系统后即可 - -```bash -sudo reboot -``` - -其他语言的配置可以参照上述配置步骤。 - -## 远程登录 - -### SSH 登录 - -在连接上网络后可以通过 SSH 远程调试,官方Debian 镜像已默认开启 SSH ,只需要获取到板子的 IP 即可使用 SSH 连接。 - -- Debian/Ubuntu - -```bash -ssh [username]@[hostname] -or -ssh [username]@[IP address] -例如: -ssh radxa@192.168.1.100 -输入用户密码后即可连接到Debian系统。 -``` - -- Windows - -Windows 有许多 SSH 工具,这里以 [Mobaxterm](https://mobaxterm.mobatek.net/) 为你展示连接方法 - -点击左上角的 `Session` 新建 SSH 连接,在 `Remote host` 处输入板子的 IP,勾选 `Specify usernema` 并填入登录的用户, 双击会话开始连接后输入登录密码即可连接。 - -![mobaxterm ssh ](/img/zero/zero3/mobaxterm-ssh.webp) - -### VNC 远程桌面 - -- 安装 VNC 服务器 - -1. 安装 TigerVNC Server 和 dbus-x11 依赖项 - -```bash -sudo apt-get update -sudo apt-get install tigervnc-standalone-server -sudo apt-get install dbus-x11 -``` - -2. 安装后完成VNC服务器的初始配置,请使用vncserver命令来设置安全密码并创建初始配置文件: - -```text -vncserver -``` - -:::tip -Would you like to enter a view-only password (y/n)? n 提示是否只是观看,建议选择no,输入n,这样远程就可以操作,而不是仅仅观看,可以自身实际情况选择 -::: - -3. 配置 VNC 服务器 - -```text -vncserver -kill :* -touch ~/.vnc/xstartup -chmod +x ~/.vnc/xstartup -``` - -编辑 `~/.vnc/xstartup`,将下列的配置复制进去并保存 - -```text -#!/bin/sh -unset SESSION_MANAGER -unset DBUS_SESSION_BUS_ADDRESS -unset XDG_RUNTIME_DIR -/etc/X11/xinit/xinitrc -[ -x /etc/vnc/xstartup ] && exec /etc/vnc/xstartup -[ -r $HOME/.Xresources ] && xrdb $HOME/.Xresources -xsetroot -solid grey -#vncconfig -iconic & -startkde & -``` - -4. 配置编辑好后,重新启动VNC服务器: - -```text -vncserver -localhost no -``` - -5. 查看 VNC 服务器 - -```bash -radxa@radxa-zero3:~$ vncserver -list - -TigerVNC server sessions: - -X DISPLAY # RFB PORT # PROCESS ID SERVER -:1 5901 4029 (stale) Xtigervnc -``` - -6. 使用 mobaxterm 连接远程桌面 - -点击左上角的 `Session` 新建 VNC 连接,在 `Remote hostname of IP address` 处输入板子的 IP,Port为 `vncserver -list` 获取到的端口号 - -![mobaxterm vnc ](/img/zero/zero3/mobaxterm-vnc.webp) - -## 音视频 - -## 聊天视频 - -## 游戏 - -## 办公 - -## Android In Container diff --git a/docs/som/nx/nx5/radxa-os/sys-config/README.md b/docs/som/nx/nx5/radxa-os/sys-config/README.md deleted file mode 100644 index 34b6bda35..000000000 --- a/docs/som/nx/nx5/radxa-os/sys-config/README.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -sidebar_position: 3 ---- - -# 系统配置 - -介绍如何通过工具(例如rsetup)或者命令行去使用设备或者功能。 - - diff --git a/docs/som/nx/nx5/radxa-os/sys-config/bootparam.md b/docs/som/nx/nx5/radxa-os/sys-config/bootparam.md deleted file mode 100644 index 8631d7f81..000000000 --- a/docs/som/nx/nx5/radxa-os/sys-config/bootparam.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -doc_kind: wrapper -source_of_truth: common -imports_resolve_to: - - docs/common/radxa-os/_bootparam.mdx ---- - -import Bootparam from "../../../../../common/radxa-os/\_bootparam.mdx"; - -# 启动参数 - - diff --git a/docs/som/nx/nx5/radxa-os/sys-config/rsetup.md b/docs/som/nx/nx5/radxa-os/sys-config/rsetup.md deleted file mode 100644 index 38c698025..000000000 --- a/docs/som/nx/nx5/radxa-os/sys-config/rsetup.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -doc_kind: wrapper -source_of_truth: common -imports_resolve_to: - - docs/common/config/_rsetup.mdx ---- - -import Rsetup from "../../../../../common/config/\_rsetup.mdx"; - - diff --git a/docs/som/nx/nx5/radxa-os/wayland.md b/docs/som/nx/nx5/radxa-os/wayland.md deleted file mode 100644 index f91fc81e4..000000000 --- a/docs/som/nx/nx5/radxa-os/wayland.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -doc_kind: wrapper -source_of_truth: common -imports_resolve_to: - - docs/common/radxa-os/_wayland.mdx ---- - -import Wayland from "../../../../common/radxa-os/\_wayland.mdx"; - -# 开启 Wayland 会话 - - diff --git a/docs/som/nx/nx5/system-use/README.md b/docs/som/nx/nx5/system-use/README.md new file mode 100644 index 000000000..3451b46a7 --- /dev/null +++ b/docs/som/nx/nx5/system-use/README.md @@ -0,0 +1,7 @@ +--- +sidebar_position: 10 +--- + +# 系统使用 + + diff --git a/docs/som/nx/nx5/system-use/appuse.md b/docs/som/nx/nx5/system-use/appuse.md new file mode 100644 index 000000000..8981cb066 --- /dev/null +++ b/docs/som/nx/nx5/system-use/appuse.md @@ -0,0 +1,14 @@ +--- +sidebar_position: 7 + +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - docs/common/radxa-os/system-config-debian12/_appuse.mdx +--- + +import AppUse from '../../../../common/radxa-os/system-config-debian12/\_appuse.mdx'; + +# 应用使用 + + diff --git a/docs/som/nx/nx5/system-use/audio.md b/docs/som/nx/nx5/system-use/audio.md new file mode 100644 index 000000000..67ec908cc --- /dev/null +++ b/docs/som/nx/nx5/system-use/audio.md @@ -0,0 +1,14 @@ +--- +sidebar_position: 8 + +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - docs/common/radxa-os/system-config-debian12/_audio.mdx +--- + +import Audio from '../../../../common/radxa-os/system-config-debian12/\_audio.mdx'; + +# 音频管理 + +
-:::details Compile from source (alternative) +:::tip Compile from source (alternative) If the Tap installation fails, you can also compile from source. macOS does not support `$(nproc)`, use `make` directly. `main.cpp` uses variable-length arrays (VLA), macOS Clang does not allow VLA in C++ by default, so you need to declare the variable as `const` first. diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/README.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/README.md index 108079603..a35dbcb80 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/README.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/README.md @@ -1,78 +1,135 @@ --- -sidebar_position: 4 +sidebar_position: 3 --- # Radxa NX5 -## Product Description +## Product Overview - - +The Radxa NX5 is a high-performance compute module based on the Rockchip RK3588S, integrating a 4-core Cortex-A76 + 4-core Cortex-A55 CPU, ARM Mali-G610 MP4 GPU, and 6 TOPS@INT8 NPU, supporting mainstream deep learning frameworks. It offers rich I/O and expansion capabilities with 8K video codec support, suitable for edge computing, machine vision, smart terminals, multimedia processing, and more. -- Radxa NX5 - ![Radxa NX5](/img/nx5/nx5-overview.webp) +The Radxa NX5 can be paired with the official IO board for quick feature validation and prototyping, helping users complete power-on debugging, interface evaluation, and application development in a short time. -#### Features +## Product Images -| Features | Description | -| -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| SoC | Rockchip RK3588S | -| CPU | Quad Cortex®‑A76 @ 2.2~2.4GHz and a quad Cortex®‑A55 @ 1.8GHz
based on Arm® DynamIQ™ configuration | -| GPU | Arm Mali™ G610MP4 GPU ‑ OpenGL® ES1.1, ES2.0, and ES3.2 ‑ OpenCL®
1.1, 1.2 and 2.2 ‑ Vulkan® 1.1 and 1.2 ‑ Embedded high performance 2D
image acceleration module | -| NPU | NPU supporting INT4 / INT8 / INT16 / FP16 / BF16 and TF32 acceleration
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
Supports SDMMC interface for data storage and OS booting using
SD cards | + + + + +
+ +
+ +
+ + + +The Radxa NX5 IO Board integrates rich external interfaces for quick validation of the Radxa NX5 compute module's features, helping users easily complete power-on debugging, interface evaluation, and preliminary application development. + +
+ +
+ +
+ + + +The Radxa NX5 Development Kit consists of the Radxa NX5 compute module and Radxa NX5 IO Board, providing a complete hardware development platform for quick validation of compute module features, performance evaluation, and prototype system building, helping users efficiently complete development and solution verification. + +
+ +
+ +
+ +
+ +## Specifications + +| Model | Radxa NX5 | +| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| SoC | Rockchip RK3588S | +| CPU | 4-core Cortex-A76 + 4-core Cortex-A55 | +| GPU | ARM Mali-G610 MP4
- Supports OpenGL ES 1.1, 2.0 and 3.2, OpenCL 1.1, 1.3 and 2.2, Vulkan 1.1 and 1.2
- High-performance 2D image acceleration module embedded | +| NPU | 6 TOPS@INT8
- Supports INT4 / INT8 / INT16 / FP16 / BF16 / TF32 compute precision
- Supports TensorFlow, Caffe, Tflite, Pytorch, Onnx NN, Android NN and other deep learning frameworks | +| Memory | LPDDR4X
- Capacity: up to 16GB | +| Video codec | Video encoding
- Up to 8K@30fps H.265 / H.264 encoding
Video decoding
- Up to 8K@60fps AV1 / AVS2 / VP9 / H.265 / H.264 decoding | +| Storage | Optional onboard eMMC
- eMMC 5.1, up to 512GB
Onboard SPI Flash (optional)
1x SDMMC | +| Networking | 1x Gigabit Ethernet | +| Display | 1x HDMI TX
- Up to 8K@60Hz
1x eDP TX
- Up to 4K@60Hz
1x DP TX
- Up to 8K@30Hz
1x MIPI DSI (2-lane) | +| Camera | 2x MIPI CSI (2-lane) or 1x MIPI CSI (4-lane)
1x MIPI CSI (4-lane)
1x MIPI CSI (2-lane) | +| USB | USB 3.1 Gen1
USB 2.0 | +| PCIe | PCIe2.0 | +| Other interfaces | Supports UART, I2C, I2S, CAN, PWM, GPIOs and more | +| Connector | 260-pin SO-DIMM connector | +| OS | Supports Debian, Yocto, Buildroot, Android 14 | +| Dimensions | 70 mm x 45 mm | + +## Interface Description + + + + + +
+ +
+ +| No. | Description | No. | Description | No. | Description | +| :-: | :-------------- | :-: | :--------------- | :-: | :----------- | +| 1 | LPDDR4X | 2 | Rockchip RK3588S | 3 | Onboard eMMC | +| 4 | 260-pin SO-DIMM | 5 | SPI Flash | | |
- + + +
+ +
-- Radxa NX5-IO - ![Radxa NX5 IO](/img/nx5/nx5-io/nx5-io-overview.webp) +| No. | Description | No. | Description | No. | Description | +| :-: | :------------------------ | :-: | :------------------------------------- | :-: | :--------------------------- | +| 1 | 2x USB 3.1 Gen1 Type-A | 2 | Top: DP output
Bottom: HDMI output | 3 | DC5525 power jack (5V input) | +| 4 | Fan header | 5 | MIPI camera interface | 6 | MIPI camera interface | +| 7 | Power button | 8 | Maskrom button | 9 | microSD card slot | +| 10 | M.2 E Key 2230 slot | 11 | 40-pin GPIO header | 12 | 260-pin SO-DIMM slot | +| 13 | micro USB interface (OTG) | 14 | Gigabit Ethernet port | 15 | 2x USB 3.1 Gen1 Type-A | + +
-- Radxa NX5 + NX5-IO - Radxa NX5 + IO + -#### Peripherals Overview +
+ Radxa NX5 Development Kit interface diagram +
-- 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 +| No. | Description | No. | Description | +| :-: | :----------------- | :-: | :---------- | +| 1 | Radxa NX5 IO Board | 2 | Radxa NX5 |
-### Chip Block Diagram +## Application Scenarios -### System block diagram +### Edge Computing and Smart Gateways -## Documentation guidelines +With a 6 TOPS NPU and Gigabit Ethernet, it can perform AI inference tasks such as video analytics, object detection, and face recognition locally without relying on the cloud. This enables edge-side intelligent decision-making and data pre-processing, significantly reducing network bandwidth and cloud computing pressure. -### [Getting Started](/compute-module/nx5/getting-started) +### Machine Vision and Industrial Automation -Introduces system installation, system login, accessory usage, etc. to let user can get started quickly. +It can be used for machine vision scenarios such as visual inspection, recognition, and measurement. With support for CAN bus and other industrial interfaces, it can work with fieldbuses and industrial control equipment to build flexible production lines, automated inspection stations, and smart devices. -### [Radxa OS](/compute-module/nx5/radxa-os) +### Multimedia Processing and Smart Displays -Radxa OS is an operating system customized by Radxa based on Debian OS. -This chapter introduces system login, network connection, etc to let user to be familiar with the system quickly. +Supports 8K@60fps video decoding and 8K@30fps video encoding, suitable for digital signage, video surveillance, video conferencing, smart advertising displays, information kiosks, self-service devices, smart retail terminals, and other multimedia applications. High-resolution display output combined with local intelligent analysis enables richer human-machine interaction experiences. -### [Android](/compute-module/nx5/android) +### Service and Mobile Robots -### [Hareware Info](/compute-module/nx5/hardware) +The 8-core CPU combined with NPU offers various sensor expansion interfaces and wired networking capabilities. It can serve as a main controller platform for mobile or collaborative robots, used for path planning, environmental perception, target tracking, and remote operations and status monitoring. -### [Accessories](/compute-module/nx5/accessories) +### Education, Training, and R&D Validation -Introduces supported accessory models and instructions for use. +Suitable as an embedded and AI teaching practice platform for universities and training institutions. It is also ideal as a basic hardware platform for enterprise solution prototyping and functional validation, accelerating the process from concept design to product launch. diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/accessories/README.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/accessories/README.md deleted file mode 100644 index 03ff454eb..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/accessories/README.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -sidebar_position: 5 ---- - -# Accessories - - diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/accessories/camera.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/accessories/camera.md deleted file mode 100644 index e4fd818d4..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/accessories/camera.md +++ /dev/null @@ -1,66 +0,0 @@ ---- -sidebar_position: 4 ---- - -# Camera - -The following 3 camera products are currently supported: - -1. OKDO 5MP Camera (ov5647) -2. Raspberry Camera v1.3 (ov5647) -3. Raspberry Camera v2 (imx219) - -The following is a demonstration of the operation of 'Raspberry Camera v2', and other cameras are similar. - -## Configuration - -- Prepare the raspberry camera v2 and connect it to the NX5 IO via the FPC cable. - -- Open console and run `sudo rsetup` command. - -```bash -radxa@radxa-nx5-io:~$ sudo rsetup -``` - -- Pass the [device tree configuration](../radxa-os/sys-config/rsetup#overlays) to enable overlay for the camera. - -:::caution [Caution] - -1. Please enable the `[] Enable Raspberry Pi Camera v2 on CAM0` item overlay. -2. Quit and reboot after enabling successfully displaying `[*] Enable Raspberry Pi Camera v2 on CAM0` for the configuration to take effect. -3. For other products, please enable the appropriate overlay according to the description. - -::: - -## Image Preview - -The live preview of the camera is recommended to use cheese, run the following command to install cheese: - -```sh -sudo apt update -sudo apt install cheese -``` - -After entering the desktop, open the terminal and execute the following commands to start the implementation of the preview camera: - -```sh -sudo cheese -``` - -You can also open the camera preview using the terminal command. - -```bash -gst-launch-1.0 v4l2src device=/dev/video11 io-mode=4 ! videoconvert ! video/x-raw,format=NV12,width=1920,height=1080 ! xvimagesink -``` - -Take a picture with the following command. - -```bash -gst-launch-1.0 v4l2src device=/dev/video11 io-mode=4 ! videoconvert ! video/x-raw,format=NV12,width=1920,height=1080 ! jpegenc ! multifilesink location=file.name.jpg -``` - -Take a video with the following command: - -```bash -gst-launch-1.0 v4l2src num-buffers=512 device=/dev/video11 io-mode=4 ! videoconvert ! video/x-raw, format=NV12, width=1920, height=1080, framerate=30/1 ! tee name=t ! queue ! mpph264enc ! queue ! h264parse ! mpegtsmux ! filesink location=/home/radxa/file.name.mp4 -``` diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/accessories/pd-30w.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/accessories/pd-30w.md deleted file mode 100644 index 1340a1e1a..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/accessories/pd-30w.md +++ /dev/null @@ -1,9 +0,0 @@ -# Radxa Power PD 30W - -The Radxa NX5-IO only supports 5V DC power supply (connector specification: DC 5525), with a recommended current of 3A or higher. - -We recommend using our [Radxa Power PD 30W](https://radxa.com/products/accessories/power-pd-30w) power adapter with a [Type-C to DC cable](https://arace.tech/products/radxa-type-c-to-dc-5v-cable). - -
- -
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/accessories/wifi_bt_access.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/accessories/wifi_bt_access.md deleted file mode 100644 index 62b866cc5..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/accessories/wifi_bt_access.md +++ /dev/null @@ -1,47 +0,0 @@ ---- -sidebar_position: 2 ---- - -# WIFI & BT - -## List of WIFI & BT support modules - -| NO. | Model | Chip | WiFi | BT | WIFI Throughput | Remark | -| --- | ---------------------- | ----------- | ------------- | --- | ------------------------------------- | ------ | -| 1 | Radxa wireless A8 | RTL8852BE | 2.4G&5G&WIFI6 | 5.0 | up:600Mbits/sec down:900 Mbits/sec | | -| 2 | Intel AX210 (PCIE+USB) | Intel AX210 | WiFi 6 | 5.2 | up: 859 Mbits/sec down: 813 Mbits/sec | | - -- Radxa NX5 IO does not have onboard WiFi/BT module and requires an external module. These are the WITI/BT cards that have been supported and tested. -- The M.2 wireless module demonstrated here is: Radxa wireless Module A8. - -[Radxa wireless module A8](/zh/img/accessories/network/a8-module-01.webp) - -- Installation is shown as follows: - -[Radxa wireless module A8](/zh/img/accessories/network/a8-module-02.webp) - -## WIFI Usage - -1. Switch to the ROOT user mode. - -```bash -sudo su -``` - -2. Turn on the WIFI - -```bash -nmcli r wifi on -``` - -3. Scan WIFI - -```bash -nmcli dev wifi -``` - -4. Connect to the wifi network - -```bash -nmcli dev wifi connect "wifi_name" password "wifi_password" -``` diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/README.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/README.md new file mode 100644 index 000000000..9c87ca9e3 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/README.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 12 +--- + +# AI Development + +This section introduces AI applications, including the RKNN and RKLLM toolchains, the RKNN Model Zoo examples, and common model deployment workflows. + + diff --git a/docs/som/nx/nx5/radxa-os/app-dev/ai/clip.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/clip.md similarity index 71% rename from docs/som/nx/nx5/radxa-os/app-dev/ai/clip.md rename to i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/clip.md index f76c03e8b..0b8eefd42 100644 --- a/docs/som/nx/nx5/radxa-os/app-dev/ai/clip.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/clip.md @@ -7,7 +7,7 @@ imports_resolve_to: - docs/common/ai/rockchip/_clip.mdx --- -import CLIP from "../../../../../../common/ai/rockchip/\_clip.mdx" +import CLIP from '../../../../common/ai/rockchip/\_clip.mdx' # CLIP diff --git a/docs/som/nx/nx5/radxa-os/app-dev/ai/deeplabv3.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/deeplabv3.md similarity index 70% rename from docs/som/nx/nx5/radxa-os/app-dev/ai/deeplabv3.md rename to i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/deeplabv3.md index b4af37b09..d6f4f996f 100644 --- a/docs/som/nx/nx5/radxa-os/app-dev/ai/deeplabv3.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/deeplabv3.md @@ -7,7 +7,7 @@ imports_resolve_to: - docs/common/ai/rockchip/_deeplabv3.mdx --- -import Deeplabv3 from "../../../../../../common/ai/rockchip/\_deeplabv3.mdx" +import Deeplabv3 from '../../../../common/ai/rockchip/\_deeplabv3.mdx' # DeepLabV3 diff --git a/docs/som/nx/nx5/radxa-os/app-dev/ai/lprnet.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/lprnet.md similarity index 70% rename from docs/som/nx/nx5/radxa-os/app-dev/ai/lprnet.md rename to i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/lprnet.md index e9f02866b..fbf5a02f7 100644 --- a/docs/som/nx/nx5/radxa-os/app-dev/ai/lprnet.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/lprnet.md @@ -7,7 +7,7 @@ imports_resolve_to: - docs/common/ai/rockchip/_lprnet.mdx --- -import LPRNet from "../../../../../../common/ai/rockchip/\_lprnet.mdx" +import LPRNet from '../../../../common/ai/rockchip/\_lprnet.mdx' # LPRNet diff --git a/docs/som/nx/nx5/radxa-os/app-dev/ai/mobilenet.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/mobilenet.md similarity index 70% rename from docs/som/nx/nx5/radxa-os/app-dev/ai/mobilenet.md rename to i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/mobilenet.md index 4184bc209..b9eb08f5e 100644 --- a/docs/som/nx/nx5/radxa-os/app-dev/ai/mobilenet.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/mobilenet.md @@ -7,7 +7,7 @@ imports_resolve_to: - docs/common/ai/rockchip/_mobilenet.mdx --- -import MobileNet from "../../../../../../common/ai/rockchip/\_mobilenet.mdx" +import MobileNet from '../../../../common/ai/rockchip/\_mobilenet.mdx' # MobileNet diff --git a/docs/som/nx/nx5/radxa-os/app-dev/ai/mobilesam.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/mobilesam.md similarity index 70% rename from docs/som/nx/nx5/radxa-os/app-dev/ai/mobilesam.md rename to i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/mobilesam.md index 419b08915..b84c14a48 100644 --- a/docs/som/nx/nx5/radxa-os/app-dev/ai/mobilesam.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/mobilesam.md @@ -7,7 +7,7 @@ imports_resolve_to: - docs/common/ai/rockchip/_mobilesam.mdx --- -import Mobilesam from "../../../../../../common/ai/rockchip/\_mobilesam.mdx" +import Mobilesam from '../../../../common/ai/rockchip/\_mobilesam.mdx' # MobileSAM diff --git a/docs/som/nx/nx5/radxa-os/app-dev/ai/ppocr.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/ppocr.md similarity index 71% rename from docs/som/nx/nx5/radxa-os/app-dev/ai/ppocr.md rename to i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/ppocr.md index ddf3ec47e..3d29ee7d9 100644 --- a/docs/som/nx/nx5/radxa-os/app-dev/ai/ppocr.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/ppocr.md @@ -7,7 +7,7 @@ imports_resolve_to: - docs/common/ai/rockchip/_ppocr.mdx --- -import PPOCR from "../../../../../../common/ai/rockchip/\_ppocr.mdx" +import PPOCR from '../../../../common/ai/rockchip/\_ppocr.mdx' # PP-OCR diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/ppyoloe.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/ppyoloe.md similarity index 70% rename from i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/ppyoloe.md rename to i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/ppyoloe.md index 1a32f6fcd..4ece49bb9 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/ppyoloe.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/ppyoloe.md @@ -7,7 +7,7 @@ imports_resolve_to: - docs/common/ai/rockchip/_ppyoloe.mdx --- -import PPYOLOE from "../../../../../../common/ai/rockchip/\_ppyoloe.mdx" +import PPYOLOE from '../../../../common/ai/rockchip/\_ppyoloe.mdx' # PP-YOLOE diff --git a/docs/som/nx/nx5/radxa-os/app-dev/ai/resnet.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/resnet.md similarity index 70% rename from docs/som/nx/nx5/radxa-os/app-dev/ai/resnet.md rename to i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/resnet.md index 0664035a1..5885ce099 100644 --- a/docs/som/nx/nx5/radxa-os/app-dev/ai/resnet.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/resnet.md @@ -7,7 +7,7 @@ imports_resolve_to: - docs/common/ai/rockchip/_resnet.mdx --- -import ResNet from "../../../../../../common/ai/rockchip/\_resnet.mdx" +import ResNet from '../../../../common/ai/rockchip/\_resnet.mdx' # ResNet diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/retinaface.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/retinaface.md similarity index 70% rename from i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/retinaface.md rename to i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/retinaface.md index f83c6af73..03b6dd823 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/retinaface.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/retinaface.md @@ -7,7 +7,7 @@ imports_resolve_to: - docs/common/ai/rockchip/_retinaface.mdx --- -import Retinaface from "../../../../../../common/ai/rockchip/\_retinaface.mdx" +import Retinaface from '../../../../common/ai/rockchip/\_retinaface.mdx' # RetinaFace diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/rkllm-deepseek-r1.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/rkllm-deepseek-r1.md new file mode 100644 index 000000000..a521220b5 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/rkllm-deepseek-r1.md @@ -0,0 +1,14 @@ +--- +sidebar_position: 12 + +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - docs/common/dev/_rkllm-deepseek-r1.mdx +--- + +import RKLLMDEEPSEEKR1 from '../../../../common/dev/\_rkllm-deepseek-r1.mdx' + +# RKLLM DeepSeek-R1 + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/rkllm-install.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/rkllm-install.md new file mode 100644 index 000000000..921bf9ea2 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/rkllm-install.md @@ -0,0 +1,14 @@ +--- +sidebar_position: 3 + +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - docs/common/dev/_rkllm-install.mdx +--- + +import Rkllminstall from '../../../../common/dev/\_rkllm-install.mdx' + +# RKLLM Installation + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/rkllm-qwen2-vl.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/rkllm-qwen2-vl.md new file mode 100644 index 000000000..6ef2537b5 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/rkllm-qwen2-vl.md @@ -0,0 +1,14 @@ +--- +sidebar_position: 13 + +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - docs/common/dev/_rkllm_qwen2_vl.mdx +--- + +import RKLLMQWEN2VL from '../../../../common/dev/\_rkllm_qwen2_vl.mdx' + +# RKLLM Qwen2-VL + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/rkllm-smolvlm2.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/rkllm-smolvlm2.md similarity index 55% rename from i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/rkllm-smolvlm2.md rename to i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/rkllm-smolvlm2.md index 363354a20..9cec6672c 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/rkllm-smolvlm2.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/rkllm-smolvlm2.md @@ -1,6 +1,5 @@ --- sidebar_position: 28 -description: Use RKNN to convert Stable Diffusion models doc_kind: wrapper source_of_truth: common @@ -8,8 +7,8 @@ imports_resolve_to: - docs/common/ai/_rkllm_smolvlm2.mdx --- -# RKLLM SmolVLM2 +import SMOLVLM2 from '../../../../common/ai/\_rkllm_smolvlm2.mdx' -import SMOLVLM2 from "../../../../../../common/ai/\_rkllm_smolvlm2.mdx"; +# RKLLM SmolVLM2 diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/rkllm-usage.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/rkllm-usage.md new file mode 100644 index 000000000..3d7b9227b --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/rkllm-usage.md @@ -0,0 +1,14 @@ +--- +sidebar_position: 4 + +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - docs/common/dev/_rkllm-usage.mdx +--- + +import Rkllmusage from '../../../../common/dev/\_rkllm-usage.mdx' + +# RKLLM Usage + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/rknn-custom-yolo.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/rknn-custom-yolo.md new file mode 100644 index 000000000..751b1da8b --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/rknn-custom-yolo.md @@ -0,0 +1,14 @@ +--- +sidebar_position: 10 + +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - docs/common/ai/_rknn_custom_yolo.mdx +--- + +import RKNNCUSTOMYOLO from '../../../../common/ai/\_rknn_custom_yolo.mdx' + +# Convert Custom YOLO Models + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/rknn-install.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/rknn-install.md new file mode 100644 index 000000000..39a88eae9 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/rknn-install.md @@ -0,0 +1,14 @@ +--- +sidebar_position: 1 + +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - docs/common/dev/_rknn-install.mdx +--- + +import RKNNinstall from '../../../../common/dev/\_rknn-install.mdx' + +# RKNN Installation + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/rknn-model-zoo.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/rknn-model-zoo.md similarity index 67% rename from i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/rknn-model-zoo.md rename to i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/rknn-model-zoo.md index 20b9e7abc..4d02f00c6 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/rknn-model-zoo.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/rknn-model-zoo.md @@ -7,8 +7,8 @@ imports_resolve_to: - docs/common/ai/rockchip/_rknn_model_zoo.mdx --- -# RKNN Model Zoo +import RKNNModelZoo from '../../../../common/ai/rockchip/\_rknn_model_zoo.mdx' -import RKNNModelZoo from "../../../../../../common/ai/rockchip/\_rknn_model_zoo.mdx" +# RKNN Model Zoo diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/rknn-quick-start.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/rknn-quick-start.md new file mode 100644 index 000000000..f805a2924 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/rknn-quick-start.md @@ -0,0 +1,14 @@ +--- +sidebar_position: 5 + +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - docs/common/dev/_rknn-toolkit2.mdx +--- + +import Rknntoolkit2 from '../../../../common/dev/\_rknn-toolkit2.mdx' + +# RKNN Quick Start + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/rknn-stable-diffusion.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/rknn-stable-diffusion.md similarity index 56% rename from i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/rknn-stable-diffusion.md rename to i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/rknn-stable-diffusion.md index 5b58ddcee..9c176d24f 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/rknn-stable-diffusion.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/rknn-stable-diffusion.md @@ -1,6 +1,5 @@ --- sidebar_position: 11 -description: Use RKNN to convert Stable Diffusion models doc_kind: wrapper source_of_truth: common @@ -8,8 +7,8 @@ imports_resolve_to: - docs/common/ai/_stable_diffusion_convert.mdx --- -# RKNN Stable Diffusion LCM +import StableDiffusionConvert from '../../../../common/ai/\_stable_diffusion_convert.mdx' -import StableDiffusionConvert from "../../../../../../common/ai/\_stable_diffusion_convert.mdx"; +# RKNN Stable Diffusion LCM diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/rknn-toolkit-lite2-yolov5.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/rknn-toolkit-lite2-yolov5.md new file mode 100644 index 000000000..1bf286565 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/rknn-toolkit-lite2-yolov5.md @@ -0,0 +1,14 @@ +--- +sidebar_position: 7 + +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - docs/common/dev/_rknn-toolkit-lite2-yolov5.mdx +--- + +import RKNNTOOLKITLITE2YOLOV5 from '../../../../common/dev/\_rknn-toolkit-lite2-yolov5.mdx' + +# YOLOv5 Object Detection on Device + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/rknn-toolkit-lite2-yolov8.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/rknn-toolkit-lite2-yolov8.md new file mode 100644 index 000000000..1495e8586 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/rknn-toolkit-lite2-yolov8.md @@ -0,0 +1,14 @@ +--- +sidebar_position: 8 + +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - docs/common/dev/_rknn-toolkit-lite2-yolov8.mdx +--- + +import RKNNTOOLKITLITE2YOLOV8 from '../../../../common/dev/\_rknn-toolkit-lite2-yolov8.mdx' + +# YOLOv8 Object Detection on Device + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/rknn-toolkit2-pc.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/rknn-toolkit2-pc.md new file mode 100644 index 000000000..3dfe66e0f --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/rknn-toolkit2-pc.md @@ -0,0 +1,14 @@ +--- +sidebar_position: 6 + +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - docs/common/dev/_rknn-toolkit2-pc.mdx +--- + +import RKNNTOOLKIT2PC from '../../../../common/dev/\_rknn-toolkit2-pc.mdx' + +# Simulated Inference YOLOv5 Segmentation Model + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/rknn-ultralytics.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/rknn-ultralytics.md new file mode 100644 index 000000000..20b51934f --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/rknn-ultralytics.md @@ -0,0 +1,14 @@ +--- +sidebar_position: 9 + +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - docs/common/dev/_rknn-ultralytics.mdx +--- + +import RKNNULTRALYTICS from '../../../../common/dev/\_rknn-ultralytics.mdx' + +# RKNN Ultralytics YOLOv11 + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/wav2vec2.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/wav2vec2.md similarity index 70% rename from i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/wav2vec2.md rename to i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/wav2vec2.md index 22e99c9cb..28e8bbbcf 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/wav2vec2.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/wav2vec2.md @@ -7,7 +7,7 @@ imports_resolve_to: - docs/common/ai/rockchip/_wav2vec2.mdx --- -import Wav2vec2 from "../../../../../../common/ai/rockchip/\_wav2vec2.mdx" +import Wav2vec2 from '../../../../common/ai/rockchip/\_wav2vec2.mdx' # Wav2Vec 2.0 diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/whisper.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/whisper.md similarity index 70% rename from i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/whisper.md rename to i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/whisper.md index 42d5c498d..932d21981 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/whisper.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/whisper.md @@ -7,7 +7,7 @@ imports_resolve_to: - docs/common/ai/rockchip/_whisper.mdx --- -import Whisper from "../../../../../../common/ai/rockchip/\_whisper.mdx" +import Whisper from '../../../../common/ai/rockchip/\_whisper.mdx' # Whisper diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/yolo-world.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/yolo-world.md similarity index 70% rename from i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/yolo-world.md rename to i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/yolo-world.md index 294185ad8..164a66a75 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/yolo-world.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/yolo-world.md @@ -7,7 +7,7 @@ imports_resolve_to: - docs/common/ai/rockchip/_yolo_world.mdx --- -import YOLOWorld from "../../../../../../common/ai/rockchip/\_yolo_world.mdx" +import YOLOWorld from '../../../../common/ai/rockchip/\_yolo_world.mdx' # YOLO World diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/yolov8-multi-stream.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/yolov8-multi-stream.md new file mode 100644 index 000000000..6bf9160d5 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/yolov8-multi-stream.md @@ -0,0 +1,14 @@ +--- +sidebar_position: 29 + +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - docs/common/ai/_rknn_yolov8_multi_stream.mdx +--- + +import RKNNYOLOV8MULTISTREAM from '../../../../common/ai/\_rknn_yolov8_multi_stream.mdx' + +# YOLOv8 Multi-Stream + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/yolov8-seg.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/yolov8-seg.md similarity index 70% rename from i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/yolov8-seg.md rename to i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/yolov8-seg.md index a7bd22e42..565fa439e 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/yolov8-seg.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/yolov8-seg.md @@ -7,7 +7,7 @@ imports_resolve_to: - docs/common/ai/rockchip/_yolov8_seg.mdx --- -import YOLOv8Seg from "../../../../../../common/ai/rockchip/\_yolov8_seg.mdx" +import YOLOv8Seg from '../../../../common/ai/rockchip/\_yolov8_seg.mdx' # YOLOv8-Seg diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/yolov8.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/yolov8.md similarity index 70% rename from i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/yolov8.md rename to i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/yolov8.md index 72f565b27..a4f9ccc67 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/yolov8.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/ai-dev/yolov8.md @@ -7,7 +7,7 @@ imports_resolve_to: - docs/common/ai/rockchip/_yolov8.mdx --- -import YOLOv8 from "../../../../../../common/ai/rockchip/\_yolov8.mdx" +import YOLOv8 from '../../../../common/ai/rockchip/\_yolov8.mdx' # YOLOv8 diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/README.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/README.md index 20285e99d..6b9c70a34 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/README.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/README.md @@ -1,9 +1,9 @@ --- -sidebar_position: 3 +sidebar_position: 25 --- -# Android +# Android System -Introduces how to build and use Android System +This section provides a brief introduction to using and developing the Android system on Radxa NX5. - + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/app-dev.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/app-dev.md deleted file mode 100644 index 0c04eabd0..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/app-dev.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -sidebar_position: 5 ---- - -# Application Development diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/getting-started.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/getting-started.md new file mode 100644 index 000000000..21204a844 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/getting-started.md @@ -0,0 +1,89 @@ +--- +sidebar_position: 2 +--- + +import UseRKDevTool from '../../../../common/radxa-os/rkdevtool/\_use.mdx'; +import EMMC from '../../../../common/radxa-os/rkdevtool/\_emmc.mdx'; +import Maskrom from '../../../../common/radxa-os/rkdevtool/\_maskrom.mdx'; + +# Quick Start + +This guide will help you quickly get started with the Android system on Radxa NX5. + +## Product Image + +The Radxa NX5 Development Kit consists of the Radxa NX5 compute module and Radxa NX5 IO Board, providing a complete hardware development platform for quick validation of compute module functionality, performance evaluation, and prototype system building to help users efficiently complete development and solution verification. + +Note: The Radxa NX5 IO Board needs to be purchased separately by the user. + +
+ +
+ +## Prerequisites + +You need to prepare the following hardware in advance: + +- Radxa NX5 Development Kit +- Power supply: DC 5525 power adapter (5V input) +- System boot media: Onboard eMMC +- Data cable: Micro USB data cable (for flashing system to eMMC) +- Display device: HDMI cable and monitor +- Input devices: Keyboard and mouse (for GUI operation) + +:::tip Recommended Accessories + +- It is recommended to use a 5V/3A or higher DC power adapter for power supply. + +::: + +## Install the System + +:::tip System Note + +If you need to install the system to a microSD card, please refer to [Install System to microSD Card](./install-system/microsd-system.md) + +If both microSD card and onboard eMMC have systems installed, the system will boot from the microSD card first. + +::: + +The quick start guide mainly introduces installing the system to the onboard eMMC of Radxa NX5. + +:::warning Important Reminder + +**Installing the system will completely format the eMMC. All data will be permanently deleted!** + +Please confirm before proceeding: + +- There is no important data on the eMMC, or you have completed a backup. + ::: + +### Install RKDevTool + + + +### Enter Maskrom Mode + + + +### Install System to eMMC + + + +## Boot the System + +After the system installation is complete, connect the HDMI display, then re-plug the power adapter to boot the system. + +
+ +
+ +①: Connect the display and the board using an HDMI or DP cable + +②: Connect a mouse or keyboard using the USB-A interface + +③: Power the board using a 5V DC power adapter + +If the board is powered normally, the Radxa NX5 IO Board power indicator LED will light up green. The monitor will display the Android system desktop. + +Note: The Radxa NX5 IO Board system status indicator LED will not light up. diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/install-os.mdx b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/install-os.mdx deleted file mode 100644 index 05f400481..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/install-os.mdx +++ /dev/null @@ -1,110 +0,0 @@ ---- -sidebar_position: 2 -title: Install OS ---- - -This document introduces how to install Android image to Radxa NX5. - -NX5 can boot from microSD card or eMMC, so install os on microSD card or eMMC based on your choose. - - - - - -## Preparation - -### Prepare the installation media - -- microSD card (recommended class10 rating or higher) - -- USB card reader - -### Prepare the image file - -Please go to [Download Summary](../getting-started/download) to download image. - -:::tip Image Note -The downloaded system image is in compressed format. You must decompress it first before using Balena Etcher for image flashing. -::: - -## System installation - -1. Download [Etcher](https://etcher.balena.io/) - ![ROCK5A via Etcher 01](/img/rock5a/rock5a-etcher.webp) - -2. Open Etcher and flash the prepared OS image to the microSD card. In the Etcher window, click `Flash from file` to select the OS image you just downloaded. - ![ROCK5A via Etcher 02](/img/rock5a/rock5a-etcher-1.webp) - -3. In the Etcher window, click `Select target`. - ![ROCK5A via Etcher 03](/img/rock5a/rock5a-etcher-2.webp) - -4. In the Etcher window, click `Flash!` and wait for a progress bar to be flushed. - ![ROCK5A via Etcher 04](/img/rock5a/rock5a-etcher-3.webp) - -5. In the Etcher window, `Flash Complete!` will be displayed when the flash is successful. - ![ROCK5A via Etcher 05](/img/rock5a/rock5a-etcher-4.webp) - -## System startup - -### NX5 Kit (NX5 + NX5 IO) - -1. Insert the microSD card with the operating system installed -2. Power up the NX5 Kit via the DC adapter. -3. The NX5 Kit will boot up with the green power LED on. - - - - - -## Preparation - -### Prepare the installation media - -- micro usb to typea usb interface cable - -### Prepare the image file - -Please go to [Download Summary](../getting-started/download) to download image. - -## System installation - -1. Connect the micro usb cable to the host computer. - -2. Press and hold the maskrom button and power on the device. - - - - - -#### Linux/Mac systems use rkdeveloptool to write to - - [rkdeveloptool](../radxa-os/low-level-dev/rkdeveloptool) - - [upgrade_tool](../radxa-os/low-level-dev/upgrade-tool) (Can be installed to multiple devices simultaneously) - - - - - -#### Windows system write with rkdevtool - - [rkdevtool](../radxa-os/low-level-dev/rkdevtool) - - - - - -## System startup - -### NX5 Kit(NX5 + NX5 IO) - -1. Power on the NX5 Kit via the DC adapter. -2. The NX5 Kit will boot up with the green power LED on. - - - - - -## Frequently Asked Questions - -## Reference diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/install-system/README.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/install-system/README.md new file mode 100644 index 000000000..ae2bd4609 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/install-system/README.md @@ -0,0 +1,7 @@ +--- +sidebar_position: 3 +--- + +# Install System + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/install-system/emmc-system/README.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/install-system/emmc-system/README.md new file mode 100644 index 000000000..18eaa667c --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/install-system/emmc-system/README.md @@ -0,0 +1,7 @@ +--- +sidebar_position: 10 +--- + +# Install System to Onboard eMMC + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/install-system/emmc-system/enter-maskrom.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/install-system/emmc-system/enter-maskrom.md new file mode 100644 index 000000000..c1077d127 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/install-system/emmc-system/enter-maskrom.md @@ -0,0 +1,14 @@ +--- +sidebar_position: 5 + +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - docs/common/radxa-os/rkdevtool/_maskrom.mdx +--- + +import Maskrom from '../../../../../../common/radxa-os/rkdevtool/\_maskrom.mdx'; + +# Enter Maskrom Mode + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/install-system/emmc-system/install-emmc.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/install-system/emmc-system/install-emmc.md new file mode 100644 index 000000000..c05e9275a --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/install-system/emmc-system/install-emmc.md @@ -0,0 +1,34 @@ +--- +sidebar_position: 10 + +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - docs/common/radxa-os/rkdevtool/_emmc.mdx +--- + +import EMMC from '../../../../../../common/radxa-os/rkdevtool/\_emmc.mdx'; + +# Install System to Onboard eMMC + +## Flash System Image + + + +## Boot the System + +After the system installation is complete, connect the HDMI display, then re-plug the power adapter to boot the system. + +
+ +
+ +①: Connect the display and the board using an HDMI or DP cable + +②: Connect a mouse or keyboard using the USB-A interface + +③: Power the board using a 5V DC power adapter + +If the board is powered normally, the Radxa NX5 IO Board power indicator LED will light up green. The monitor will display the Android system desktop. + +Note: The Radxa NX5 IO Board system status indicator LED will not light up. diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/install-system/emmc-system/install-rkdevtool.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/install-system/emmc-system/install-rkdevtool.md new file mode 100644 index 000000000..7d1dba436 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/install-system/emmc-system/install-rkdevtool.md @@ -0,0 +1,14 @@ +--- +sidebar_position: 1 + +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - docs/common/radxa-os/rkdevtool/_use.mdx +--- + +import UseRKDevTool from '../../../../../../common/radxa-os/rkdevtool/\_use.mdx'; + +# Install RKDevTool + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/install-system/microsd-system.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/install-system/microsd-system.md new file mode 100644 index 000000000..6e33d76a0 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/install-system/microsd-system.md @@ -0,0 +1,27 @@ +--- +sidebar_position: 1 +--- + +import BalenaEtcherUse from '../../../../../common/radxa-os/install-system/\_use_etcher_sd.mdx'; + +# Install System to microSD Card + + + +## Boot the System + +
+ +
+ +①: Insert the microSD card into the microSD card slot + +②: Connect the display and the board using an HDMI or DP cable + +③: Connect a mouse or keyboard using the USB-A interface + +④: Power the board using a 5V DC power adapter + +If the board is powered normally, the Radxa NX5 IO Board power indicator LED will light up green. The monitor will display the Android system desktop. + +Note: The Radxa NX5 IO Board system status indicator LED will not light up. diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/low-level-dev.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/low-level-dev.md deleted file mode 100644 index 611ceff34..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/low-level-dev.md +++ /dev/null @@ -1,66 +0,0 @@ ---- -sidebar_position: 4 ---- - -# Low-Level development - -Introduces how to download and build uboot, kernel, os etc. - -## Environment configuration - -Ubuntu 20.04 and above are recommended - -## code download - -```bash - -$ repo init -u https://github.com/radxa/manifests.git -b Android12_Radxa_rk14 -m rockchip-s-release.xml -$ repo sync -d -c -j4 - -``` - -## build - -Suitable for first compilation - -```bash -radxa:rock-android12 $ source build/envsetup.sh -radxa:rock-android12 $ lunch RadxaRockNX5-userdebug -radxa:rock-android12 $ ./build.sh -UACKup -# get images from IMAGE directory -``` - -Wait for the compilation to complete and you can find the image in the IMAGE directory - -### Compile separately - -Suitable for compiling after minor modifications - -For example, only modify - -U-boot - -```bash -radxa:rock-android12 $ source build/envsetup.sh -radxa:rock-android12 $ lunch RadxaRockNX5-userdebug -radxa:rock-android12 $ ./build.sh -AUup - -``` - -Kernel - -```bash -radxa:rock-android12 $ source build/envsetup.sh -radxa:rock-android12 $ lunch RadxaRockNX5-userdebug -radxa:rock-android12 $ ./build.sh -ACKup -``` - -AOSP - -```bash -radxa:rock-android12 $ source build/envsetup.sh -radxa:rock-android12 $ lunch RadxaRockNX5-userdebug -radxa:rock-android12 $ ./build.sh -Aup -``` - -Wait for the compilation to complete and you can find the image in the IMAGE directory diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/low-level-dev/README.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/low-level-dev/README.md new file mode 100644 index 000000000..30b9e421f --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/low-level-dev/README.md @@ -0,0 +1,7 @@ +--- +sidebar_position: 5 +--- + +# Low-Level Development + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/low-level-dev/build-system.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/low-level-dev/build-system.md new file mode 100644 index 000000000..299479909 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/low-level-dev/build-system.md @@ -0,0 +1,88 @@ +--- +sidebar_position: 6 +--- + +# Build System + +This section mainly covers u-boot, kernel, and AOSP compilation and packaging. + +## Environment Setup + +Ubuntu 20.04 or higher is recommended. + +## Download Source Code + + + +```bash +repo init -u https://github.com/radxa/manifests.git -b Android12_Radxa_rk14 -m rockchip-s-release.xml +repo sync +repo forall -c 'git lfs pull' +``` + + + +## Build System Image + +Android system supports two build methods: + +- **Full Build**: Used for initial build or when complete rebuild is needed, takes longer +- **Module Build**: Used after modifying specific components, faster compilation speed, e.g., when only modifying kernel + +### Full Build + +Suitable for initial build or when complete rebuild is needed, takes longer. + + + +```bash +source build/envsetup.sh +lunch RadxaRockNX5-userdebug +./build.sh -UACKup +``` + + + +Wait for the build to complete, and you can find the image files in the `IMAGE` directory. + +### Individual Component Build + +Suitable for use after modifying specific components, faster compilation speed. + +#### U-Boot + + + +```bash +source build/envsetup.sh +lunch RadxaRockNX5-userdebug +./build.sh -AUup +``` + + + +#### Kernel + + + +```bash +source build/envsetup.sh +lunch RadxaRockNX5-userdebug +./build.sh -ACKup +``` + + + +#### AOSP + + + +```bash +source build/envsetup.sh +lunch RadxaRockNX5-userdebug +./build.sh -Aup +``` + + + +Wait for the build to complete, and you can find the image files in the `IMAGE` directory. diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/remote-login.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/remote-login.md deleted file mode 100644 index aed4b8bc6..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/remote-login.md +++ /dev/null @@ -1,128 +0,0 @@ ---- -sidebar_position: 3 ---- - -import Serial from "../../../../common/general/\_serial.mdx" - -# Remote login - -Introduce how to access SBC through a personal computer (PC) via serial port,adb,etc. - - - - - - - - - - - -ADB is a bridge between your Android device and your computer, and is used to fully operate and manage your Android device on your computer. - -### preparation - -install adb(Android Debug Bridge): - - - - - -Download the Windows version of the adb toolkit from [Android](https://source.android.com/docs/setup/build/adb),and after downloading and decompressing,you need to configure the environment variables: - -Method 1:Enter the following command in the terminal window: - -```bash - -set HTTP_PROXY=myserver:1981 - -``` - -Method 2:Open system settings and modify environment variables:![NX5 adb](/img/nx5/adb_config_en.webp) - - - - - -Use the following command to install: - -```bash - -sudo apt install adb - -``` - - - - - -Download the Mac version of the adb toolkit from [Android](https://source.android.com/docs/setup/build/adb),and after downloading and decompressing,you need to configure the environment variables: - -```bash -export PATH=${path}:~/platform-tools( '~' is the path of the extracted toolkit) -``` - - - - - - - - - -#### Requirements - -- 1 x USB cable -- 1 x computer or laptop with the ADB tool installed on it -- 1 x Radxa NX5 - -#### Steps - -1. Connect the USB cable between the USB connector of the computer and the OTG Type C connector of the Radxa NX5. -2. Open the computer terminal and enter adb devices to confirm that the Radxa NX5 is recognized.Type adb shell to login. - -```bash - -$ adb devices - List of devices attached - f94f8e0d28380ceb device - -$ adb shell - RadxaRockNX5:/ $ - -``` - - - - - -Wireless ADB is supported on Android 11 and later. - -#### Requirements - -1. a computer or laptop with ADB tools installed and ADB version greater than 31.0.0. -2. a Radxa NX5 with an Android image greater than or equal to 11. -3. the computer and Radxa NX5 need to be on the same LAN. - -#### Steps - -1. Start Radxa NX5 and connect to the network using wifi. -2. Enter the Developing mode by tapping the version number 7 times (Settings -> About Tablet -> Version Number). -3. Go to Developing Options (Settings -> System -> Developing Options),turn on wireless debugging and memorize the IP address and interface (example: 10.0.0.16:45613). -4. Open a computer terminal and type adb connect 10.0.0.16:45613 to connect to the Radxa NX5,type adb shell to login. - -```bash - -$ adb connect 10.0.0.16:45613 -$ adb shell - RadxaRockNX5:/ $ - -``` - - - - - - - - diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/serial-login.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/serial-login.md new file mode 100644 index 000000000..e73657abc --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/serial-login.md @@ -0,0 +1,48 @@ +--- +sidebar_position: 4 +--- + +import UART_DEBUG from '../../../../common/other-system/android/\_uart_debug.mdx'; + +# Serial Login + +## Prerequisites + +Serial login is a core method for interacting with the board via serial communication interface (UART) in embedded development. Through serial tools, you can view system logs and perform command-line interactions. + +:::danger +When using a USB serial data cable to connect to the board for serial debugging, please ensure the pin connections are correct. Connecting pins incorrectly may cause hardware damage to the board. + +Do not connect the USB serial data cable's VCC interface (red wire). Connecting it incorrectly may damage the board. +::: + +Connect the USB serial data cable to the UART2 interface on the Radxa NX5 Development Kit, and the other end to the PC's USB port. + +Note: Please follow the USB serial cable manufacturer's pin definitions for connection. The diagram shows common USB serial cable pin definitions. + +
+ +
+ +| Radxa NX5 Development Kit | Connection Method | +| ------------------------- | --------------------------------------------------------------------------------------------------------------------- | +| GND (Pin 6) | Connect the GND pin of the Radxa NX5 Development Kit to the GND pin of the USB serial cable (black Dupont wire) | +| UART2_TXD (Pin 8) | Connect the UART2_TXD pin of the Radxa NX5 Development Kit to the RXD pin of the USB serial cable (white Dupont wire) | +| UART2_RXD (Pin 10) | Connect the UART2_RXD pin of the Radxa NX5 Development Kit to the TXD pin of the USB serial cable (green Dupont wire) | + +## Serial Login + +:::tip Serial Communication Parameters + +Baud Rate: 1500000 + +Data Bits: 8 + +Stop Bits: 1 + +Parity: None + +Flow Control: None +::: + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/system-config.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/system-config.md deleted file mode 100644 index c1ef7ed73..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/system-config.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -sidebar_position: 6 ---- - -# System Configuration diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/download.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/download.md new file mode 100644 index 000000000..100d484ca --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/download.md @@ -0,0 +1,53 @@ +--- +sidebar_position: 150 +--- + +# Downloads + +## Flashing Tools + +- [Balena Etcher](https://etcher.balena.io/) + +- [DriverAssistant v5.14](https://dl.radxa.com/tools/windows/DriverAssitant_v5.14.zip) + +- [RKDevTool](https://dl.radxa.com/tools/windows/RKDevTool_Release_v2.96-20221121.rar) + +## Loader File + +Used for USB download initialization. + +- [rk3588_spl_loader.bin](https://dl.radxa.com/rock5/sw/images/loader/rock-5b/release/rk3588_spl_loader_v1.15.113.bin) + +## System Images + +### Radxa Official System + +:::info Latest System Image Release Page + +- [Radxa NX5 IO Board System Images](https://github.com/radxa-build/radxa-nx5-io/releases/) + +This page releases the latest stable and beta system images. Beta versions start with `t`, stable versions start with `r` (older stable versions started with `b`). + +::: + +- [radxa-nx5-io_bookworm_kde_b2.output.img.xz](https://github.com/radxa-build/radxa-nx5-io/releases/download/rsdk-b2/radxa-nx5-io_bookworm_kde_b2.output.img.xz) + +### Android System + +- [Radxa-NX5-Android12-rkr14-20240326-gpt.zip](https://github.com/radxa/manifests/releases/download/radxa-nx5-android12-rkr14-20240326/Radxa-NX5-Android12-rkr14-20240326-gpt.zip) + +## Hardware Design + +### Radxa NX5 + +- [Schematic V1.1](https://dl.radxa.com/nx5/radxa_nx5_schematic_v1100.pdf) +- [Components Placement Map V1.1](https://dl.radxa.com/nx5/radxa_nx5_components_placement_map_v1100.pdf) +- [Pinout Table V1.1](https://dl.radxa.com/nx5/radxa_nx5_pinout_v1.1.xlsx) +- [2D DXF File V1.1](https://dl.radxa.com/nx5/radxa_nx5_2d_dxf.zip) +- [3D STP File V1.1](https://dl.radxa.com/nx5/radxa_nx5_v1.1_3d_stp.zip) + +### Radxa NX5 IO Board + +- [Schematic V1.4](https://dl.radxa.com/nx5/nx5-io-board/radxa_nx5_io_board_v1400_schematic.pdf) +- [Components Placement Map V1.4](https://dl.radxa.com/nx5/nx5-io-board/radxa_nx5_io_board_v1400_components_placement_map.pdf) +- [Design Reference Materials](https://github.com/radxa/radxa-som-projects/tree/main/nx5/radxa-nx5-io-board) diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/getting-started/README.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/getting-started/README.md index 6d7ad7d1c..b4cf0fd7b 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/getting-started/README.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/getting-started/README.md @@ -1,7 +1,7 @@ --- -sidebar_position: 1 +sidebar_position: 5 --- # Getting Started - + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/getting-started/accessory-usage.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/getting-started/accessory-usage.md deleted file mode 100644 index 1610c1ef1..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/getting-started/accessory-usage.md +++ /dev/null @@ -1,61 +0,0 @@ ---- -sidebar_position: 3 ---- - -# Accessory instructions - -This section describes the supported accessories and how to use them. - -## Interface Overview - -![nx5_io_interface_overview](/img/nx5/nx5-io/nx5_io_interface_overview.webp) - -## Camera - -RADXA NX5 IO comes with two 2-lane CSI interfaces. The following is a list of currently supported cameras: - - - - - - - - - - - - - - - - - - - - - - -
Camera NameSensor typeresolution
OKDO 5MP CameraOV56475 megapixels
Raspberry Pi Camera V1.3OV56475 megapixels
Raspberry Pi Camera V2IMX2198 megapixels
- -For more information please refer to [camera accessories](../accessories/camera). - -## WIFI/BT - -RADXA NX5 IO has 1 M.2 Key interface. The following is the current list of supported modules: - - - - - - - - - - - - - - -
Module name brief
Radxa Wireless Module A8 Standard M.2 2230 wireless module for Realtek RTL8852BE
AX210 Intel AX210 wireless module
- -For more information please refer to [wifi_bt_access](../accessories/wifi_bt_access). diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/getting-started/download.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/getting-started/download.md deleted file mode 100644 index 330877d0c..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/getting-started/download.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -sidebar_position: 4 -title: Resource Download ---- - -# Resource Download - -## Hardware Info - -NX5 & NX5 IO Board - -[NX5 V1.1 Schematic pdf](https://dl.radxa.com/nx5/radxa_nx5_v1100_schematic.pdf) - -[NX5 V1.1 Components Placement map pdf](https://dl.radxa.com/nx5/radxa_nx5_v1100_smd.pdf) - -[NX5 V1.1 2D dxf](https://dl.radxa.com/nx5/nx5-io-board/radxa_nx5_v1100_2d.dxf) - -[NX5 IO V1.4 Schematic pdf](https://dl.radxa.com/nx5/nx5-io-board/radxa_nx5_io_board_v1400_schematic.pdf) - -[NX5 IO V1.4 Components Placement map pdf](https://dl.radxa.com/nx5/nx5-io-board/radxa_nx5_io_board_v1400_components_placement_map.pdf) - -[NX5 IO V1.4 2D dxf](https://dl.radxa.com/nx5/nx5-io-board/radxa_nx5_io_board_v1400_top_2d.dxf) - -[NX5 Pinout Definition V1.1 xlsx](https://dl.radxa.com/nx5/radxa_nx5_pinout_v1.1.xlsx) - -[NX5 IO Board Design Resources](https://github.com/radxa/radxa-cm-projects/tree/main/nx5/radxa-nx5-io-board) - -## Tools - -1. [Etcher](https://etcher.balena.io/#download-etcher/) -2. [rkdeveloptool open source version](https://opensource.rock-chips.com/wiki_Rkdeveloptool) -3. [RKDevTool v2.96](https://dl.radxa.com/tools/windows/RKDevTool_Release_v2.96_zh.zip) -4. [DriverAssistant v5.14](https://dl.radxa.com/tools/windows/DriverAssitant_v5.14.zip)(related driver) - -## Images - -- Radxa OS - - Radxa NX5 IO (Kernel 6.1): [radxa-nx5-io_debian_bookworm_kde_b2.img.xz](https://github.com/radxa-build/radxa-nx5-io/releases/download/rsdk-b2/radxa-nx5-io_bookworm_kde_b2.output.img.xz) - -- Android - Radxa NX5 IO Adroid: [radxa nx5 android12 rkr14](https://github.com/radxa/manifests/releases/download/radxa-nx5-android12-rkr14-20240326/Radxa-NX5-Android12-rkr14-20240326-update.zip) - -## Quality Certification diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/getting-started/install-os.mdx b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/getting-started/install-os.mdx deleted file mode 100644 index 07e0465e2..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/getting-started/install-os.mdx +++ /dev/null @@ -1,27 +0,0 @@ ---- -sidebar_position: 2 - -doc_kind: wrapper -source_of_truth: local -imports_resolve_to: - - i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/install-os.mdx - - i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/android/install-os.mdx ---- - -import Installdebian from "../radxa-os/install-os.mdx"; -import Installandroid from "../android/install-os.mdx"; - -# System Installation - - - - - - - - - - - - - diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/getting-started/install-system/README.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/getting-started/install-system/README.md new file mode 100644 index 000000000..47f41fc4c --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/getting-started/install-system/README.md @@ -0,0 +1,7 @@ +--- +sidebar_position: 10 +--- + +# Install System + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/getting-started/install-system/emmc-system/README.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/getting-started/install-system/emmc-system/README.md new file mode 100644 index 000000000..18eaa667c --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/getting-started/install-system/emmc-system/README.md @@ -0,0 +1,7 @@ +--- +sidebar_position: 10 +--- + +# Install System to Onboard eMMC + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/getting-started/install-system/emmc-system/enter-maskrom.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/getting-started/install-system/emmc-system/enter-maskrom.md new file mode 100644 index 000000000..c1077d127 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/getting-started/install-system/emmc-system/enter-maskrom.md @@ -0,0 +1,14 @@ +--- +sidebar_position: 5 + +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - docs/common/radxa-os/rkdevtool/_maskrom.mdx +--- + +import Maskrom from '../../../../../../common/radxa-os/rkdevtool/\_maskrom.mdx'; + +# Enter Maskrom Mode + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/getting-started/install-system/emmc-system/install-emmc.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/getting-started/install-system/emmc-system/install-emmc.md new file mode 100644 index 000000000..bf8b4fa71 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/getting-started/install-system/emmc-system/install-emmc.md @@ -0,0 +1,43 @@ +--- +sidebar_position: 10 + +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - docs/common/radxa-os/rkdevtool/_emmc.mdx +--- + +import EMMC from '../../../../../../common/radxa-os/rkdevtool/\_emmc.mdx'; + +# Install System to Onboard eMMC + +## Flash System + + + +## Boot the System + +After the system installation is complete, connect the HDMI display, then re-plug the power adapter to boot the system. + +
+ +
+ +①: Connect the display and the board using an HDMI or DP cable + +②: Connect a mouse or keyboard using the USB-A interface + +③: Power the board using a 5V DC power adapter + +If the board is powered normally, the Radxa NX5 system indicator LED and the Radxa NX5 IO Board power indicator LED will light up green. If the system boots normally, the Radxa NX5 system indicator LED will blink green, and the Radxa NX5 IO Board status indicator LED will blink blue. + +## Log In + +When you first boot the system, you need to log in using the default username and password. + +The default credentials for Radxa OS are: + +| Item | Value | +| :------- | :------ | +| Username | `radxa` | +| Password | `radxa` | diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/getting-started/install-system/emmc-system/install-rkdevtool.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/getting-started/install-system/emmc-system/install-rkdevtool.md new file mode 100644 index 000000000..7d1dba436 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/getting-started/install-system/emmc-system/install-rkdevtool.md @@ -0,0 +1,14 @@ +--- +sidebar_position: 1 + +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - docs/common/radxa-os/rkdevtool/_use.mdx +--- + +import UseRKDevTool from '../../../../../../common/radxa-os/rkdevtool/\_use.mdx'; + +# Install RKDevTool + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/getting-started/install-system/microsd-system.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/getting-started/install-system/microsd-system.md new file mode 100644 index 000000000..c51e06165 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/getting-started/install-system/microsd-system.md @@ -0,0 +1,36 @@ +--- +sidebar_position: 1 +--- + +import BalenaEtcherUse from '../../../../../common/radxa-os/install-system/\_use_etcher_sd.mdx'; + +# Install System to microSD Card + + + +## Boot the System + +①: Insert the microSD card into the microSD card slot + +②: Connect the display and the board using an HDMI or DP cable + +③: Connect a mouse or keyboard using the USB-A interface + +④: Power the board using a 5V DC power adapter + +If the board is powered normally, the Radxa NX5 system indicator LED and the Radxa NX5 IO Board power indicator LED will light up green. If the system boots normally, the Radxa NX5 system indicator LED will blink green, and the Radxa NX5 IO Board status indicator LED will blink blue. + +
+ +
+ +After successfully booting the system, the monitor will display the system desktop. You can log in and use the system based on the system information. + +## System Information + +When using the official system image, use the following default login credentials: + +| Item | Value | +| :------- | :------ | +| Username | `radxa` | +| Password | `radxa` | diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/getting-started/preparation.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/getting-started/preparation.md deleted file mode 100644 index 310f0456b..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/getting-started/preparation.md +++ /dev/null @@ -1,38 +0,0 @@ ---- -sidebar_position: 1 ---- - -# Preparation - -## Development preparation - -### Power Supply - -The RADXA NX5 IO is powered by the DC connector and supports 5V input only. - -:::tip -RADXA recommends using the [Radxa Power PD30W](../accessories/power/pd_30w) -::: - -### Storage - -microSD card with a capacity of at least 8GB for the system boot disk. - -### Display - -Display with HDMI or DP connector, HDMI can support up to 8K display output. - -### Network connection - -- NX5 IO provides an Ethernet port for 1000M Ethernet access. -- Provide M.2 KEY interface, which is compatible with common PCIe protocol NICs in the market, such as AX210, A8 modules. - -### USB Mouse/Keyboard - -Standard mouse and keyboard peripherals can be inserted for system debugging and operation. - -## FAQ - -## Precautions - -## Reference diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/getting-started/quickly-start.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/getting-started/quickly-start.md new file mode 100644 index 000000000..56481b74f --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/getting-started/quickly-start.md @@ -0,0 +1,102 @@ +--- +sidebar_position: 1 +--- + +import UseRKDevTool from '../../../../common/radxa-os/rkdevtool/\_use.mdx'; +import EMMC from '../../../../common/radxa-os/rkdevtool/\_emmc.mdx'; +import Maskrom from '../../../../common/radxa-os/rkdevtool/\_maskrom.mdx'; + +# Quick Start + +This guide will help you quickly get started with the Radxa NX5 Development Kit and quickly validate the features of Radxa NX5. + +## Product Image + +The Radxa NX5 Development Kit consists of the Radxa NX5 compute module and Radxa NX5 IO Board, providing a complete hardware development platform for quick validation of compute module functionality, performance evaluation, and prototype system building to help users efficiently complete development and solution verification. + +Note: The Radxa NX5 IO Board needs to be purchased separately by the user. + +
+ +
+ +## Prerequisites + +You need to prepare the following hardware in advance: + +- Radxa NX5 Development Kit +- Power supply: DC 5525 power adapter (5V input) +- System boot media: Onboard eMMC +- Data cable: Micro USB data cable (for flashing system to eMMC) +- Display device: HDMI cable and monitor +- Input devices: Keyboard and mouse (for GUI operation) + +:::tip Recommended Accessories + +- It is recommended to use a 5V/3A or higher DC power adapter for power supply. + +::: + +## Install the System + +:::tip System Note + +If you need to install the system to a microSD card, please refer to [Install System to microSD Card](./install-system/microsd-system.md) + +If both microSD card and onboard eMMC have systems installed, the system will boot from the microSD card first. + +::: + +The quick start guide mainly introduces installing the system to the onboard eMMC of Radxa NX5. + +:::warning Important Reminder + +**Installing the system will completely format the eMMC. All data will be permanently deleted!** + +Please confirm before proceeding: + +- There is no important data on the eMMC, or you have completed a backup. + ::: + +### Install RKDevTool + + + +### Enter Maskrom Mode + + + +### Install System to eMMC + + + +## Boot the System + +After the system installation is complete, connect the HDMI display, then re-plug the power adapter to boot the system. + +
+ +
+ +①: Connect the display and the board using an HDMI or DP cable + +②: Connect a mouse or keyboard using the USB-A interface + +③: Power the board using a 5V DC power adapter + +If the board is powered normally, the Radxa NX5 system indicator LED and the Radxa NX5 IO Board power indicator LED will light up green. If the system boots normally, the Radxa NX5 system indicator LED will blink green, and the Radxa NX5 IO Board status indicator LED will blink blue. + +## Log In + +When you first boot the system, you need to log in using the default username and password. + +The default credentials for Radxa OS are: + +| Item | Value | +| :------- | :------ | +| Username | `radxa` | +| Password | `radxa` | + +## Use the System + +After successfully logging in, you can configure the system and develop on the Radxa NX5 Development Kit. diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/hardware-use/README.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/hardware-use/README.md new file mode 100644 index 000000000..c33f98f56 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/hardware-use/README.md @@ -0,0 +1,7 @@ +--- +sidebar_position: 15 +--- + +# Hardware Usage + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/hardware/hw-interface.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/hardware-use/gpio.md similarity index 82% rename from i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/hardware/hw-interface.md rename to i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/hardware-use/gpio.md index 4e9256e97..2b632f5e1 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/hardware/hw-interface.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/hardware-use/gpio.md @@ -1,58 +1,23 @@ --- -sidebar_position: 4 +sidebar_position: 5 --- -# Hardware interface description +# 40-Pin GPIO Header -## Interface overview +The Radxa NX5 IO Board is equipped with a 40-pin GPIO (General Purpose Input/Output) interface, providing highly flexible interface support for hardware expansion. -![Radxa NX5](/img/nx5/nx5-overview.webp) -![Radxa NX5 IO](/img/nx5/nx5-io/nx5-io-overview.webp) +Users can connect various sensors, actuators, communication modules, displays, and other embedded peripherals through the 40-pin GPIO interface to quickly implement prototype development and feature validation in IoT, robotics control, industrial automation, and other fields. -- 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 +:::danger Usage Warning -## Power +When using the 40-pin GPIO interface, please pay attention to the pin and peripheral wiring. Ensure the pin connections are correct, as improper operation may cause damage to the device hardware. -Powered by DC power connector, supports 5V input only. +::: -## Debug Serial Port +## GPIO Functions -For system debugging, low-level log message output. -Refer to [Serial Debugging](../radxa-os/low-level-dev/serial). - -## Ethernet Port - -Provides Ethernet interface to Gigabit Ethernet. - -## 40 PIN GPIO - -### GPIO voltage - -| GPIO | Voltage | Max Voltage | -| ---------- | ------- | ----------- | -| All GPIO | 3.3V | 3.63V | -| SARADC_IN4 | 1.8V | 1.98V | - -### GPIO interface - -Radxa NX5 IO provides a 40pin GPIO socket, which is compatible with most sensor applications on the market. - -**_Tips:_ The actual compatibility is subject to usage. ** - -
+ +
| GPIO number | Function7 | Function6 | Function5 | Function4 | Function3 | Function2 | Function1 | Pin# | Pin# | Function1 | Function2 | Function3 | Function4 | Function5 | Function6 | Function7 | GPIO number | | :---------: | :-------: | :----------: | :-----------: | :----------: | :--------: | :---------: | :-------: | :------------------------------: | :-----------------------------: | :-------: | :---------: | :---------: | :----------: | :---------------------------------------: | :----------: | :--------: | :---------: | @@ -77,24 +42,5 @@ Radxa NX5 IO provides a 40pin GPIO socket, which is compatible with most sensor | 57 | I2S0_SDI3 | I2S0_SDO2 | UART6_RX_M2 | SPI1_MOSI_M2 | | I2C7_SDA_M0 | GPIO1_D1 |
37
|
38
| GPIO1_D4 | | | | | I2S0_SDI0 | | 60 | | | | | | | | | GND |
39
|
40
| GPIO1_C7 | I2C4_SCL_M4 | | | UART4_CTSN | I2S0_SDO0 | | 55 | -
- -## WIFI/BT - -Provides M.2 KEY interface, which is compatible with common PCIe protocol NICs in the market, such as Radxa Wireless A8 modules. - -## HDMI/DP - -Equipped with full-size HDMI and DP connectors, supporting regular 4K, 2K, 1080P resolutions, the HDMI interface supports resolutions up to 8K. - -## USB - -Provides 4x USB3.0 ports, compatible with USB2.0. - -## MIPI CSI - -MIPI camera support. - -## MicroSD - -Can be used as a system boot disk or as a storage medium. +
+
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/hardware-use/hardware-info.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/hardware-use/hardware-info.md new file mode 100644 index 000000000..f3ee87a55 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/hardware-use/hardware-info.md @@ -0,0 +1,68 @@ +--- +sidebar_position: 1 +--- + +# Hardware Information + +## Chip Block Diagram + +
+ +
+ +## Interface Description + + + + + +
+ +
+ +| No. | Description | No. | Description | No. | Description | +| :-: | :-------------- | :-: | :--------------- | :-: | :----------- | +| 1 | LPDDR4X | 2 | Rockchip RK3588S | 3 | Onboard eMMC | +| 4 | 260-pin SO-DIMM | 5 | SPI Flash | | | + +
+ + + +
+ +
+ +| No. | Description | No. | Description | No. | Description | +| :-: | :------------------------ | :-: | :------------------------------------- | :-: | :--------------------------- | +| 1 | 2x USB 3.1 Gen1 Type-A | 2 | Top: DP output
Bottom: HDMI output | 3 | DC5525 power jack (5V input) | +| 4 | Fan header | 5 | MIPI camera interface | 6 | MIPI camera interface | +| 7 | Power button | 8 | Maskrom button | 9 | microSD card slot | +| 10 | M.2 E Key 2230 slot | 11 | 40-pin GPIO header | 12 | 260-pin SO-DIMM slot | +| 13 | micro USB interface (OTG) | 14 | Gigabit Ethernet port | 15 | 2x USB 3.1 Gen1 Type-A | + +
+ + + +
+ Radxa NX5 Development Kit interface diagram +
+ +| No. | Description | No. | Description | +| :-: | :----------------- | :-: | :---------- | +| 1 | Radxa NX5 IO Board | 2 | Radxa NX5 | + +
+ +
+ +## LED Indicators + +- Radxa NX5 + +The Radxa NX5 has one system status indicator LED. A solid green light indicates normal power supply, and blinking green indicates the system has booted normally. + +- Radxa NX5 IO Board + +The Radxa NX5 IO Board has a power indicator LED and a system status indicator LED. A solid green power indicator LED indicates normal power supply, and blinking blue status indicator LED indicates the system has booted normally. diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/hardware/README.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/hardware/README.md deleted file mode 100644 index 88bb47783..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/hardware/README.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -sidebar_position: 4 ---- - -# Hardware Info - - diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/hardware/hw-revision.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/hardware/hw-revision.md deleted file mode 100644 index 250201fc5..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/hardware/hw-revision.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -sidebar_position: 4 ---- - -# Hardware Revision - -## V1.11 - -- Update the version silk screen to V1.11 -- Remove the Maskrom button diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/low-level-dev/README.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/low-level-dev/README.md new file mode 100644 index 000000000..6d876d3e5 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/low-level-dev/README.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 17 +--- + +# Low-Level Development + +This section provides a brief introduction to low-level development for Radxa NX5. + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/low-level-dev/kernel.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/low-level-dev/kernel.md new file mode 100644 index 000000000..923f71a16 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/low-level-dev/kernel.md @@ -0,0 +1,15 @@ +--- +sidebar_position: 2 +description: "Build a personalized Linux kernel with Radxa BSP tools and enjoy customized hardware development" + +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - docs/common/dev/_kernel.mdx +--- + +import KERNEL from '../../../../common/dev/\_kernel.mdx' + +# Kernel Development + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/low-level-dev/rsdk.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/low-level-dev/rsdk.md new file mode 100644 index 000000000..ad0e3fad1 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/low-level-dev/rsdk.md @@ -0,0 +1,15 @@ +--- +sidebar_position: 3 +description: "Customize your system using RSDK tools" + +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - docs/common/dev/_rsdk.mdx +--- + +import RSDK from '../../../../common/dev/\_rsdk.mdx' + +# Build RadxaOS + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/low-level-dev/u-boot.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/low-level-dev/u-boot.md new file mode 100644 index 000000000..053d472da --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/low-level-dev/u-boot.md @@ -0,0 +1,15 @@ +--- +sidebar_position: 1 +description: "Build a personalized U-Boot with Radxa BSP tools and embark on an innovation journey for smart hardware" + +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - docs/common/dev/_u-boot.mdx +--- + +import UBOOT from '../../../../common/dev/\_u-boot.mdx' + +# U-Boot Development + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/README.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/README.md deleted file mode 100644 index a9795db0d..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/README.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -sidebar_position: 2 ---- - -# Radxa OS - - diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/ap.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/ap.md deleted file mode 100644 index e53a31fc0..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/ap.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -doc_kind: wrapper -source_of_truth: common -imports_resolve_to: - - i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/_ap.mdx ---- - -import AP from "../../../../common/radxa-os/\_ap.mdx"; - -# Wi-Fi hotspot - - diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/README.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/README.md deleted file mode 100644 index b29933241..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/README.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -sidebar_position: 5 ---- - -# Application Development - -Introduces upper-layer application development, such as QT, Mraa, etc. - - diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/README.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/README.md deleted file mode 100644 index 9365e2262..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/README.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -sidebar_position: 50 ---- - -# Artificial Intelligence - -This section covers AI applications, including RKNN and RKLLM toolchain usage, RKNN Model Zoo model examples, and common model deployment workflows. - - diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/rkllm-deepseek-r1.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/rkllm-deepseek-r1.md deleted file mode 100644 index a0b3e4b7d..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/rkllm-deepseek-r1.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -sidebar_position: 12 - -doc_kind: wrapper -source_of_truth: common -imports_resolve_to: - - i18n/en/docusaurus-plugin-content-docs/current/common/dev/_rkllm-deepseek-r1.mdx ---- - -# RKLLM DeepSeek-R1 - -import RKLLMDEEPSEEKR1 from '../../../../../../common/dev/\_rkllm-deepseek-r1.mdx'; - - diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/rkllm-install.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/rkllm-install.md deleted file mode 100644 index d24b53e1f..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/rkllm-install.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -sidebar_position: 3 -description: "Start the journey of efficient deployment of intelligent language models with RKLLM installation, bringing technology and human intelligence together" - -doc_kind: wrapper -source_of_truth: common -imports_resolve_to: - - i18n/en/docusaurus-plugin-content-docs/current/common/dev/_rkllm-install.mdx ---- - -# RKLLM Installation - -import Rkllminstall from '../../../../../../common/dev/\_rkllm-install.mdx'; - - diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/rkllm-qwen2-vl.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/rkllm-qwen2-vl.md deleted file mode 100644 index 16ed1a0cd..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/rkllm-qwen2-vl.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -sidebar_position: 13 -description: "Run the Qwen2_VL large language model using RKLLM" - -doc_kind: wrapper -source_of_truth: common -imports_resolve_to: - - i18n/en/docusaurus-plugin-content-docs/current/common/dev/_rkllm_qwen2_vl.mdx ---- - -# RKLLM Qwen2-VL - -import RKLLMQWEN2VL from '../../../../../../common/dev/\_rkllm_qwen2_vl.mdx'; - - diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/rkllm-usage.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/rkllm-usage.md deleted file mode 100644 index ce180fdca..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/rkllm-usage.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -sidebar_position: 4 -description: "Efficient hardware acceleration of large language models using RKLLM technology for a new chapter in intelligent dialogue" - -doc_kind: wrapper -source_of_truth: common -imports_resolve_to: - - i18n/en/docusaurus-plugin-content-docs/current/common/dev/_rkllm-usage.mdx ---- - -# RKLLM Usage and Deploy LLM - -import Rkllmusage from '../../../../../../common/dev/\_rkllm-usage.mdx'; - - diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/rknn-custom-yolo.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/rknn-custom-yolo.md deleted file mode 100644 index 1c8b7c266..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/rknn-custom-yolo.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -sidebar_position: 10 -description: "Convert Custom Trained YOLO Models" - -doc_kind: wrapper -source_of_truth: common -imports_resolve_to: - - i18n/en/docusaurus-plugin-content-docs/current/common/ai/_rknn_custom_yolo.mdx ---- - -# Convert Custom Trained YOLO Models - -import RKNNCUSTOMYOLO from '../../../../../../common/ai/\_rknn_custom_yolo.mdx'; - - diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/rknn-install.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/rknn-install.md deleted file mode 100644 index 06fbe49f7..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/rknn-install.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -sidebar_position: 1 -description: "Start the journey of efficient inference of AI models on Rockchip NPU through RKNN installation, and feel the perfect fusion of technology and humanities" - -doc_kind: wrapper -source_of_truth: common -imports_resolve_to: - - i18n/en/docusaurus-plugin-content-docs/current/common/dev/_rknn-install.mdx ---- - -# RKNN Installation - -import RKNNinstall from '../../../../../../common/dev/\_rknn-install.mdx'; - - diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/rknn-quick-start.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/rknn-quick-start.md deleted file mode 100644 index 4e6f2e430..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/rknn-quick-start.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -sidebar_position: 5 - -doc_kind: wrapper -source_of_truth: common -imports_resolve_to: - - i18n/en/docusaurus-plugin-content-docs/current/common/dev/_rknn-toolkit2.mdx ---- - -# RKNN Quick Example - -import Rknntoolkit2 from '../../../../../../common/dev/\_rknn-toolkit2.mdx'; - - diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/rknn-toolkit-lite2-yolov5.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/rknn-toolkit-lite2-yolov5.md deleted file mode 100644 index 7e370e53f..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/rknn-toolkit-lite2-yolov5.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -sidebar_position: 7 - -doc_kind: wrapper -source_of_truth: common -imports_resolve_to: - - i18n/en/docusaurus-plugin-content-docs/current/common/dev/_rknn-toolkit-lite2-yolov5.mdx ---- - -# Deploy YOLOv5 Object Detection on the Board - -import RKNNTOOLKITLITE2YOLOV5 from '../../../../../../common/dev/\_rknn-toolkit-lite2-yolov5.mdx'; - - diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/rknn-toolkit-lite2-yolov8.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/rknn-toolkit-lite2-yolov8.md deleted file mode 100644 index 3576f3ede..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/rknn-toolkit-lite2-yolov8.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -sidebar_position: 8 -description: "Deploying YOLOv8 on the RK3588 board side opens a new era of intelligent target detection, allowing technology and humanistic care to merge perfectly in accurate identification" - -doc_kind: wrapper -source_of_truth: common -imports_resolve_to: - - i18n/en/docusaurus-plugin-content-docs/current/common/dev/_rknn-toolkit-lite2-yolov8.mdx ---- - -# Deploy YOLOv8 Object Detection on the Board - -import RKNNTOOLKITLITE2YOLOV8 from '../../../../../../common/dev/\_rknn-toolkit-lite2-yolov8.mdx'; - - diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/rknn-toolkit2-pc.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/rknn-toolkit2-pc.md deleted file mode 100644 index a24664748..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/rknn-toolkit2-pc.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -sidebar_position: 6 -description: "Explore simulated inference of AI models with the RKNN toolkit and experience the efficiency and precision of intelligent image segmentation" - -doc_kind: wrapper -source_of_truth: common -imports_resolve_to: - - i18n/en/docusaurus-plugin-content-docs/current/common/dev/_rknn-toolkit2-pc.mdx ---- - -# Simulate YOLOv5 Segmentation Inference - -import RKNNTOOLKIT2PC from '../../../../../../common/dev/\_rknn-toolkit2-pc.mdx'; - - diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/rknn-ultralytics.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/rknn-ultralytics.md deleted file mode 100644 index 520dfc239..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/rknn-ultralytics.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -sidebar_position: 9 -description: "Deploying YOLOv11 on the RK3588/356X board side opens a new era of intelligent target detection, allowing technology and humanistic care to merge perfectly in accurate identification" - -doc_kind: wrapper -source_of_truth: common -imports_resolve_to: - - i18n/en/docusaurus-plugin-content-docs/current/common/dev/_rknn-ultralytics.mdx ---- - -# RKNN Ultralytics YOLOv11 - -import RKNNULTRALYTICS from '../../../../../../common/dev/\_rknn-ultralytics.mdx'; - - diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/yolov8-multi-stream.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/yolov8-multi-stream.md deleted file mode 100644 index c9084cb7e..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/ai/yolov8-multi-stream.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -sidebar_position: 29 -description: Use RKNN for YOLOv8 Multi-stream Recognition - -doc_kind: wrapper -source_of_truth: common -imports_resolve_to: - - docs/common/ai/_rknn_yolov8_multi_stream.mdx ---- - -# YOLOv8 Multi-stream Recognition - -import RKNNYOLOV8MULTISTREAM from "../../../../../../common/ai/\_rknn_yolov8_multi_stream.mdx"; - - diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/mraa.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/mraa.md deleted file mode 100644 index 58c38e152..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/mraa.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -sidebar_position: 2 - -doc_kind: wrapper -source_of_truth: common -imports_resolve_to: - - i18n/en/docusaurus-plugin-content-docs/current/common/dev/_mraa.mdx ---- - -# Mraa - -import MRAA from '../../../../../common/dev/\_mraa.mdx'; - - diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/venv_usage.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/venv_usage.md deleted file mode 100644 index 3584e4b0d..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/app-dev/venv_usage.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -sidebar_position: 22 - -doc_kind: wrapper -source_of_truth: common -imports_resolve_to: - - i18n/en/docusaurus-plugin-content-docs/current/common/dev/_venv_usage.mdx ---- - -# Python Virtual Environment Usage - -import VENVUSAGE from '../../../../../common/dev/\_venv_usage.mdx'; - - diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/apps-deploy/README.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/apps-deploy/README.md deleted file mode 100644 index 1f920cdca..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/apps-deploy/README.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -sidebar_position: 4 ---- - -# Application Deployment - -Mainly introduces the configuration and use of common applications such as Samba, Docker, PVE, OMV, LAMP, Cheese, remote control panel and so on. - - diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/apps-deploy/docker.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/apps-deploy/docker.md deleted file mode 100644 index 708dde57d..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/apps-deploy/docker.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -sidebar_position: 1 ---- - -# Docker - -Radxa Debian already has Docker-related configuration enabled in the kernel, so you just need to install the Docker application to get started. - -1. Install Docker - -```bash -sudo apt-get update -sudo apt-get install docker.io -``` - -2. After the installation is complete, execute the following two commands - -```bash -sudo update-alternatives --set iptables /usr/sbin/iptables-legacy -sudo update-alternatives --set ip6tables /usr/sbin/ip6tables-legacy -sudo reboot -``` - -3. Run docker test after reboot and check the status. - -```bash -sudo docker run hello-world -sudo systemctl status docker -``` diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/apps-deploy/samba.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/apps-deploy/samba.md deleted file mode 100644 index 48cf46d16..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/apps-deploy/samba.md +++ /dev/null @@ -1,74 +0,0 @@ ---- -sidebar_position: 2 ---- - -# Samba - -Samba is a popular SMB/CIFS tool for Linux. With Samba, you can share files with many different operating systems, including Windows and Android. - -1. Install samba - -```bash -sudo apt-get update -sudo apt-get install samba -``` - -2. Editing the Samba Configuration File `/etc/samba/smb.conf` - -```bash -sudo vim /etc/samba/smb.conf -``` - -3. Add the following configuration to the end of the file - -```text -[radxa] -comment = Shared from my Radxa device -path = /media/samba -available = yes -valid users = radxa -public = yes -writable = yes -``` - -4. Creating a shared folder - -```bash -sudo mkdir /media/samba -sudo chmod 755 /media/samba -``` - -5. Create Samba user and password - -```bash -sudo smbpasswd -a radxa -``` - -6. Restart the Samba service to load the updated configuration - -```bash -sudo systemctl restart -``` - -7. Execute `systemctl status smbd` to check the status of samba - -```bash -radxa@radxa-zero3:~$ systemctl status smbd -● smbd.service - Samba SMB Daemon - Loaded: loaded (/lib/systemd/system/smbd.service; enabled; vendor preset: > - Active: active (running) since Tue 2023-12-19 03:24:00 UTC; 14s ago - Docs: man:smbd(8) - man:samba(7) - man:smb.conf(5) - Process: 1963 ExecStartPre=/usr/share/samba/update-apparmor-samba-profile (> - Main PID: 1964 (smbd) - Status: "smbd: ready to serve connections..." - Tasks: 4 (limit: 9191) - Memory: 6.5M - CPU: 564ms - CGroup: /system.slice/smbd.service - ├─1964 /usr/sbin/smbd --foreground --no-process-group - ├─1966 /usr/sbin/smbd --foreground --no-process-group - ├─1967 /usr/sbin/smbd --foreground --no-process-group - └─1968 /usr/sbin/smbd --foreground --no-process-group -``` diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/fcitx-usage.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/fcitx-usage.md deleted file mode 100644 index 99ad8c811..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/fcitx-usage.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -sidebar_position: 10 - -doc_kind: wrapper -source_of_truth: common -imports_resolve_to: - - i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/system-config/_fcitx_usage.mdx ---- - -import FCITX from "../../../../common/radxa-os/system-config/\_fcitx_usage.mdx"; - -# Input Method Usage - - diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/install-os.mdx b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/install-os.mdx deleted file mode 100644 index dc7944328..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/install-os.mdx +++ /dev/null @@ -1,110 +0,0 @@ ---- -sidebar_position: 1 -title: Install OS ---- - -This document introduces how to install Radxa OS image to Radxa NX5. - -NX5 can boot from microSD card or eMMC, so install os on microSD card or eMMC based on your choose. - - - - - -## Preparation - -### Prepare the installation media - -- microSD card (recommended class10 rating or higher) - -- USB card reader - -### Prepare the image file - -Please go to [Download Summary](../getting-started/download) to download image. - -:::tip Image Note -The downloaded system image is in compressed format. You must decompress it first before using Balena Etcher for image flashing. -::: - -## System installation - -1. Download [Etcher](https://etcher.balena.io/) - ![ROCK5A via Etcher 01](/img/rock5a/rock5a-etcher.webp) - -2. Open Etcher and flash the prepared OS image to the microSD card. In the Etcher window, click `Flash from file` to select the OS image you just downloaded. - ![ROCK5A via Etcher 02](/img/rock5a/rock5a-etcher-1.webp) - -3. In the Etcher window, click `Select target`. - ![ROCK5A via Etcher 03](/img/rock5a/rock5a-etcher-2.webp) - -4. In the Etcher window, click `Flash!` and wait for a progress bar to be flushed. - ![ROCK5A via Etcher 04](/img/rock5a/rock5a-etcher-3.webp) - -5. In the Etcher window, `Flash Complete!` will be displayed when the flash is successful. - ![ROCK5A via Etcher 05](/img/rock5a/rock5a-etcher-4.webp) - -## System startup - -### NX5 IO - -1. Insert the microSD card with the operating system installed -2. Power up the NX5 IO via the DC adapter. -3. The NX5 IO will boot up with the green power LED on, and the blue LED will start blinking after entering the system. - - - - - -## Preparation - -### Prepare the installation media - -- micro usb to typea usb interface cable - -### Prepare the image file - -Please go to [Download Summary](../getting-started/download) to download image. - -## System installation - -1. Connect the micro usb cable to the host computer. - -2. Press and hold the maskrom button and power on the device. - - - - - -#### Linux/Mac systems use rkdeveloptool to write to - -[rkdeveloptool](/compute-module/nx5/radxa-os/low-level-dev/rkdeveloptool) - -[upgrade_tool](/compute-module/nx5/radxa-os/low-level-dev/upgrade-tool) (Can be installed to multiple devices simultaneously) - - - - - -#### Windows system write with rkdeveloptool - -[rkdevtool](/compute-module/nx5/radxa-os/low-level-dev/rkdevtool) - - - - - -## System startup - -### NX5 IO - -1. Power on the NX5 IO via the DC adapter. -2. The NX5 IO will boot up with the green power LED on, and the blue LED will start blinking after entering the system. - - - - - -## Frequently Asked Questions - -## Reference diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/low-level-dev/README.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/low-level-dev/README.md deleted file mode 100644 index 5bdb10967..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/low-level-dev/README.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -sidebar_position: 7 ---- - -# Low level Development - -Introduces how to build and pack uboot, kernel, debian os and so on. - - diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/low-level-dev/kernel.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/low-level-dev/kernel.md deleted file mode 100644 index 3c41edb18..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/low-level-dev/kernel.md +++ /dev/null @@ -1,56 +0,0 @@ ---- -sidebar_position: 2 ---- - -# Kernel - -## Environment Configuration - -BSP is a set of tools provided by Radxa to quickly build U-Boot Kernel. It is very convenient to use bsp to build your own U-Boot and Kernel. -The following will show you how to use bsp to build the kernel of Radxa NX5 IO. - -[bsp Environment configuration](https://radxa-repo.github.io/bsp/) - -## Build Kernel - -After completing the bsp environment configuration, you need to compile the kernel first before pulling the kernel code from the warehouse. -You can execute `./bsp linux rockchip` to build the kernel. The path to the kernel source code is located in the bsp directory. `.src/linux` - -```shell -cd bsp -mkdir output -cd output -../bsp --no-prepare-source linux rockchip -r 1 - -Parameter Description: ---no-prepare-source -# Compile using local modifications. If this parameter is not added, the latest code will be synchronized from the Radxa kernel warehouse and the local modifications will be overwritten. - --r 1 -# Specify the kernel version number as 1 -``` - -:::note - -The configured kernel version number needs to be greater than the current kernel to boot with the new kernel by default - -::: - -For more bsp parameter usage instructions, you can execute `./bsp` to view. - -After compilation is completed, many `deb` packages will be generated in the bsp/output directory. You only need to install the following two `deb` packages. - -```shell -linux-headers-5.10.110-1-rockchip_5.10.110-1_arm64.deb -linux-image-5.10.110-1-rockchip_5.10.110-1_arm64.deb -``` - -Copy the above two `deb` packages to the board and use the `dpkg` command to install them to complete the kernel installation. - -```shell -sudo dpkg -i linux-headers-5.10.110-1-rockchip_5.10.110-1_arm64.deb -sudo dpkg -i linux-image-5.10.110-1-rockchip_5.10.110-1_arm64.deb -sudo reboot -``` - -After the restart is complete, you can use `uname -a` to check the currently started kernel version number to see whether the installation was successful. diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/low-level-dev/rk_anti_copy_board.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/low-level-dev/rk_anti_copy_board.md deleted file mode 100644 index 66b7baf71..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/low-level-dev/rk_anti_copy_board.md +++ /dev/null @@ -1,19 +0,0 @@ ---- -sidebar_position: 5 -description: "Rockchip provides anti copying board technology to protect customers' firmware, private data, and core code." - -doc_kind: wrapper -source_of_truth: common -imports_resolve_to: - - i18n/en/docusaurus-plugin-content-docs/current/common/dev/_rk_anti_copy_board.mdx ---- - -import ANTICOPY from '../../../../../common/dev/\_rk_anti_copy_board.mdx' - -# Rockchip Anti Copy Board - -Rockchip provides anti copying board technology to protect customers' firmware, private data, and core code. -Anti copying board technology is mainly used to prevent customers' firmware and private data from being -illegally copied and used by unauthorized users, and to avoid commercial losses caused by copying. - - diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/low-level-dev/rkdeveloptool.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/low-level-dev/rkdeveloptool.md deleted file mode 100644 index 3aadd9002..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/low-level-dev/rkdeveloptool.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -doc_kind: wrapper -source_of_truth: common -imports_resolve_to: - - i18n/en/docusaurus-plugin-content-docs/current/common/dev/_rkdeveloptool.mdx ---- - -import Rkdeveloptool from "../../../../../common/dev/\_rkdeveloptool.mdx"; - - diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/low-level-dev/rkdevtool.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/low-level-dev/rkdevtool.md deleted file mode 100644 index 37552785e..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/low-level-dev/rkdevtool.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -doc_kind: wrapper -source_of_truth: common -imports_resolve_to: - - i18n/en/docusaurus-plugin-content-docs/current/common/dev/_rkdevtool.mdx ---- - -import RKDevTool from "../../../../../common/dev/\_rkdevtool.mdx" - -# RKDevTool - - diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/low-level-dev/rsdk.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/low-level-dev/rsdk.md deleted file mode 100644 index 613c2ed52..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/low-level-dev/rsdk.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -sidebar_position: 4 -description: "Customize your system with the rsdk tool" - -doc_kind: wrapper -source_of_truth: common -imports_resolve_to: - - i18n/en/docusaurus-plugin-content-docs/current/common/dev/_rsdk.mdx ---- - -import RSDK from '../../../../../common/dev/\_rsdk.mdx' - -# Build RadxaOS - - diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/low-level-dev/serial.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/low-level-dev/serial.md deleted file mode 100644 index 7e3495a66..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/low-level-dev/serial.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -doc_kind: wrapper -source_of_truth: common -imports_resolve_to: - - i18n/en/docusaurus-plugin-content-docs/current/common/general/_serial.mdx ---- - -import Serial from "../../../../../common/general/\_serial.mdx" - -# UART Serial Console - - diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/low-level-dev/u-boot.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/low-level-dev/u-boot.md deleted file mode 100644 index 49a613c2c..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/low-level-dev/u-boot.md +++ /dev/null @@ -1,53 +0,0 @@ ---- -sidebar_position: 2 ---- - -# U-boot - -## Environment Configuration - -BSP is a set of tools provided by Radxa to quickly build U-Boot Kernel. It is very convenient to use bsp to build your own U-Boot and Kernel. -The following will show you how to use bsp to build the U-Boot of Radxa NX5 IO. - -[bsp Environment configuration](https://radxa-repo.github.io/bsp/) - -## Build U-Boot - -After completing the bsp environment configuration, you need to compile U-Boot once before pulling the relevant code from the repository. -you can execute `. /bsp u-boot rknext radxa-nx5-io` to build U-Boot, the path to the U-Boot source code is located in the bsp directory under `.src/u-boot`. - -```shell -cd bsp -mkdir output -cd output -../bsp --no-prepare-source u-boot rknext radxa-nx5-io - -Parameter Description: ---no-prepare-source -#Compile with local changes, if you don't add this parameter it will sync the -#latest code from the Radxa U-Boot repository and overwrite the local changes. -``` - -For more bsp parameter usage instructions, you can execute `./bsp` to view. - -After compilation, many `deb` packages will be generated in the bsp/output directory, you just need to install the following `deb` packages. - -```shell -u-boot-rknext_2017.09-1_arm64.deb -``` - -Copy the above `deb` packages to the board and install them with the `dpkg` command to complete the U-Boot file update. - -```shell -sudo dpkg -i u-boot-rknext_2017.09-1_arm64.deb -``` - -U-Boot needs to be flashed onto the boot media after the 'dpkg -i' is complete. - -```shell -cd /usr/lib/u-boot/radxa-nx5-io/ -sudo ./setup.sh update_bootloader /dev/mmcblk1 #/dev/mmcblk1 is the boot media you are currently using, you need to select it according to the actual device you are using -sudo reboot -``` - -After reboot, you can observe the U-Boot boot log to see if U-Boot has been successfully updated. diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/low-level-dev/upgrade-tool.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/low-level-dev/upgrade-tool.md deleted file mode 100644 index 82f30c56b..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/low-level-dev/upgrade-tool.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -doc_kind: wrapper -source_of_truth: common -imports_resolve_to: - - i18n/en/docusaurus-plugin-content-docs/current/common/dev/_upgrade-tool.mdx ---- - -import UpgradeTool from "../../../../../common/dev/\_upgrade-tool.mdx" - -# upgrade_tool - - diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/mali-gpu.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/mali-gpu.md deleted file mode 100644 index 7941221bd..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/mali-gpu.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -doc_kind: wrapper -source_of_truth: common -imports_resolve_to: - - i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/_mali-gpu.mdx ---- - -import Mali from "../../../../common/radxa-os/\_mali-gpu.mdx"; - -# Switch GPU driver - - diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/os-usage/README.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/os-usage/README.md deleted file mode 100644 index 1a5ae2e65..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/os-usage/README.md +++ /dev/null @@ -1,180 +0,0 @@ ---- -sidebar_position: 2 ---- - -import Serial from "../../../../../common/general/\_serial.mdx" - -# Radxa OS Usage - -Introduces system login, network connection, etc to let user to be familiar with the system quickly. - -## User name and Password - -The user name and password added by default to the Radxa ZERO 3 series are: - -```text -User name:radxa/rock -Password: radxa/rock -``` - -## Serial Debug - - - -## Setting Network - -### Connect WiFi - -```bash -nmcli device wifi #Scan WiFi -sudo nmcli device wifi connect password #Connect WiFi -``` - -### Ethernet - -## Automatic login - -For faster access to the desktop, you can set the desktop to log you in automatically by modifying the `/etc/lightdm/lightdm.conf` file. - -```bash -sudo vim /etc/lightdm/lightdm.conf -Find [Seat:*] configured #autologin-user= ,modify this configuration to the user you need to log in as - -[Seat:*] -... -autologin-user=radxa -autologin-user-timeout=0 -... -``` - -## Language Settings - -1. Install Simplified Chinese fonts: - -```bash -sudo apt-get install fonts-wqy-zenhei -``` - -2. Set the system language to Chinese desktop: - -```bash -sudo dpkg-reconfigure locales -``` - -3. Select Chinese Language - -![set language1 ](/img/zero/zero3/set-language1.webp) - -![set language2 ](/img/zero/zero3/set-language2.webp) - -4. Just reboot the system - -```bash -sudo reboot -``` - -For other languages, you can refer to the configuration steps above. - -## Remote Login - -### SSH Login - -After connecting to the network, you can use SSH to debug remotely, the official Debian image has enabled SSH by default, you just need to get the IP of the board to use SSH to connect. - -- Debian/Ubuntu - -```bash -ssh [username]@[hostname] -or -ssh [username]@[IP address] -Example: -ssh radxa@192.168.1.100 -You can connect to the Debian system after entering your user password. -``` - -- Windows - -There are a number of SSH tools available for Windows, here's [Mobaxterm](https://mobaxterm.mobatek.net/) to show you how to connect. - -Click `Session` in the upper left corner to create a new SSH connection, enter the IP of the board in the `Remote host` field, tick `Specify usernema` and fill in the user who logs in, and then double-click on the session to start the connection and enter the login password to connect. - -![mobaxterm ssh ](/img/zero/zero3/mobaxterm-ssh.webp) - -### VNC remote desktop - -- Installing the VNC Server - -1. Installing TigerVNC Server and dbus-x11 dependencies - -```bash -sudo apt-get update -sudo apt-get install tigervnc-standalone-server -sudo apt-get install dbus-x11 -``` - -2. To complete the initial configuration of the VNC server after installation, use the vncserver command to set the security password and create the initial configuration file: - -```text -vncserver -``` - -:::tip -Would you like to enter a view-only password (y/n)? n -Prompt whether just watch, it is recommended to choose no, enter n, so that the remote can be operated, rather than just watch, you can choose their own practical situation -::: - -3. Configuring the VNC Server - -```text -vncserver -kill :* -touch ~/.vnc/xstartup -chmod +x ~/.vnc/xstartup -``` - -Edit `~/.vnc/xstartup`, copy the following configuration in and save it - -```text -#!/bin/sh -unset SESSION_MANAGER -unset DBUS_SESSION_BUS_ADDRESS -unset XDG_RUNTIME_DIR -/etc/X11/xinit/xinitrc -[ -x /etc/vnc/xstartup ] && exec /etc/vnc/xstartup -[ -r $HOME/.Xresources ] && xrdb $HOME/.Xresources -xsetroot -solid grey -#vncconfig -iconic & -startkde & -``` - -4. Once the configuration is edited, restart the VNC server: - -```text -vncserver -localhost no -``` - -5. Viewing the VNC Server - -```bash -radxa@radxa-zero3:~$ vncserver -list - -TigerVNC server sessions: - -X DISPLAY # RFB PORT # PROCESS ID SERVER -:1 5901 4029 (stale) Xtigervnc -``` - -6. Using mobaxterm to connect to remote desktop - -Click `Session` in the upper left corner to create a new VNC connection, enter the board's IP in the `Remote hostname of IP address` field, and the port number obtained by `vncserver -list`. - -![mobaxterm vnc ](/img/zero/zero3/mobaxterm-vnc.webp) - -## Audio and video usage - -## Chat video use - -## Game - -## Office - -## Android In Container diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/sys-config/README.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/sys-config/README.md deleted file mode 100644 index e47ba0c8c..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/sys-config/README.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -sidebar_position: 3 ---- - -# System Configuration - -Introduces how to use tools (such as rsetup) or command line to use some devices or functions. - - diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/sys-config/bootparam.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/sys-config/bootparam.md deleted file mode 100644 index 5cc7958d4..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/sys-config/bootparam.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -doc_kind: wrapper -source_of_truth: common -imports_resolve_to: - - i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/_bootparam.mdx ---- - -import Bootparam from "../../../../../common/radxa-os/\_bootparam.mdx"; - -# Boot Parameters - - diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/sys-config/rsetup.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/sys-config/rsetup.md deleted file mode 100644 index 7f8fe9603..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/sys-config/rsetup.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -doc_kind: wrapper -source_of_truth: common -imports_resolve_to: - - i18n/en/docusaurus-plugin-content-docs/current/common/config/_rsetup.mdx ---- - -import Rsetup from "../../../../../common/config/\_rsetup.mdx"; - - diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/wayland.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/wayland.md deleted file mode 100644 index da63bb328..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/radxa-os/wayland.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -doc_kind: wrapper -source_of_truth: common -imports_resolve_to: - - i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/_wayland.mdx ---- - -import Wayland from "../../../../common/radxa-os/\_wayland.mdx"; - -# Enabling Wayland Session - - diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/system-use/README.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/system-use/README.md new file mode 100644 index 000000000..1ac06e6af --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/system-use/README.md @@ -0,0 +1,7 @@ +--- +sidebar_position: 10 +--- + +# System Usage + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/system-use/appuse.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/system-use/appuse.md new file mode 100644 index 000000000..c8bb1d87a --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/system-use/appuse.md @@ -0,0 +1,14 @@ +--- +sidebar_position: 7 + +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - docs/common/radxa-os/system-config-debian12/_appuse.mdx +--- + +import AppUse from '../../../../common/radxa-os/system-config-debian12/\_appuse.mdx'; + +# Application Usage + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/system-use/audio.md b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/system-use/audio.md new file mode 100644 index 000000000..3bfd4f3c9 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/nx/nx5/system-use/audio.md @@ -0,0 +1,14 @@ +--- +sidebar_position: 8 + +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - docs/common/radxa-os/system-config-debian12/_audio.mdx +--- + +import Audio from '../../../../common/radxa-os/system-config-debian12/\_audio.mdx'; + +# Audio Management + +