diff --git a/docs/common/accessories/_rtc-bat.mdx b/docs/common/accessories/_rtc-bat.mdx new file mode 100644 index 000000000..2c08c003f --- /dev/null +++ b/docs/common/accessories/_rtc-bat.mdx @@ -0,0 +1,85 @@ +import { Image } from "@site/src/utils/docs"; + +{props.product} 的板载 RTC 电池接口用于为系统提供稳定的时钟信号，确保系统在断电后仍能保持时间。 + +## 接口规格 + +- 接口类型：{props.interface} +- 电池类型：{props.battery_type} +- 电池电压：{props.battery_voltage} + +## 硬件连接 + +{props.product} 连接 RTC 电池时，请注意正负极以及工作电压，避免损坏 {props.product}。 + + + +## 配置 RTC + +### 确认 RTC 硬件 + +使用以下命令来确认 RTC 硬件是否正常工作。 + + + +``` +sudo dmesg | grep rtc +``` + + + +终端输出类似信息：`registered as rtc0`，说明 RTC 电池被正确识别。 + +``` +[ 0.368528] msm_dpu ae01000.display-controller: [drm] Cannot find any crtc or sizes +[ 0.368720] msm_dpu ae01000.display-controller: [drm] Cannot find any crtc or sizes +[ 6.259233] rtc-ds1307 10-0068: registered as rtc0 +[ 6.260658] rtc-ds1307 10-0068: setting system clock to 2025-08-06T08:39:15 UTC (1754469555) +``` + +### 读取 RTC 时间 + +终端使用 `hwclock` 命令读取 RTC 芯片（/dev/rtc0）的当前时间。 + + + +``` +sudo apt update +sudo apt install util-linux util-linux-extra -y +sudo hwclock -r -f /dev/rtc0 +``` + + + +### 显示系统时间 + +使用 `date` 命令显示系统当前时间。 + + + +``` +date +``` + + + +### 设置 RTC 时间 + +若 RTC 时间和系统时间不一致，可以使用 `hwclock` 命令将系统当前时间写入 RTC。 + + + +``` +sudo hwclock -w -f /dev/rtc0 +``` + + + +### 验证 RTC 功能 + +记录当前系统时间，然后断开主板电源和网络，等待 10 分钟左右，然后重新连接电源，观察系统时间是否正常计时。 diff --git a/docs/common/radxa-os/rkdevtool/_emmc.mdx b/docs/common/radxa-os/rkdevtool/_emmc.mdx index fc446bec5..eaa43d13d 100644 --- a/docs/common/radxa-os/rkdevtool/_emmc.mdx +++ b/docs/common/radxa-os/rkdevtool/_emmc.mdx @@ -1,6 +1,10 @@ -主要介绍如何使用 RKDevTool 工具将系统镜像烧录到 eMMC 模块上。 +使用 RKDevTool 工具将系统镜像烧录到 eMMC 上。 -说明：需要确保主板已经进入 Maskrom 模式且被系统正常识别 +:::tip 重要提醒 +安装系统到 eMMC 中，需要确保主板已经进入 Maskrom 模式且被系统正常识别。 + +需要的 Loader 文件和系统镜像可以访问 资源汇总下载 页面下载。 +::: @@ -26,18 +30,18 @@ /> -断开主板与 PC 的连接，然后重新插拔电源，系统会自动从 eMMC 模块中启动。 +断开主板与 PC 的连接，然后重新插拔电源，系统会自动从 eMMC 启动。 - -在 Linux / MacOS 平台，我们可以终端命令行，然后按照以下步骤安装系统到 eMMC 上。 + +在 Linux / macOS 平台，我们可以终端命令行，然后按照以下步骤安装系统到 eMMC 上。 1. 运行 Loader 文件 将下面命令中的 `demo.bin` 替换为主板对应的 Loader 文件。 - + ``` sudo rkdeveloptool db demo.bin @@ -49,7 +53,7 @@ sudo rkdeveloptool db demo.bin 将下面命令中的 `demo.img` 替换为主板对应的系统镜像。 - + ``` sudo rkdeveloptool wl 0 demo.img @@ -61,7 +65,7 @@ sudo rkdeveloptool wl 0 demo.img 断开主板与 PC 的连接，然后重新插拔电源，系统会自动从 eMMC 中启动。 - + ``` sudo rkdeveloptool rd diff --git a/docs/common/radxa-os/rkdevtool/_maskrom.mdx b/docs/common/radxa-os/rkdevtool/_maskrom.mdx index 00fc2b6fe..3d5a44f11 100644 --- a/docs/common/radxa-os/rkdevtool/_maskrom.mdx +++ b/docs/common/radxa-os/rkdevtool/_maskrom.mdx @@ -1,6 +1,6 @@ import { Image } from "@site/src/utils/docs"; -## Maskrom 模式说明 +- Maskrom 模式说明 在瑞芯微（Rockchip）平台的开发中，RKDevTool 是常用的烧录工具，我们可以让主板进入 Maskrom 模式后使用 RKDevTool 进行固件的烧录。 @@ -10,7 +10,7 @@ Maskrom 模式是嵌入式设备的“硬件急救箱”，通过直接操作芯 Maskrom 模式是 Rockchip 芯片内置的底层恢复模式，当设备无法从任何启动介质( eMMC、 SD 卡等)加载有效引导程序时自动进入系统时，我们可以通过通过 RockUSB 协议重新烧写设备固件。 ::: -## 进入 Maskrom 模式 +- 进入 Maskrom 模式 我们的主板上有一个专用的 Maskrom 按键，在给主板上电前按住 Maskrom 按键，通电后系统检测到 Maskrom 按键被按下，主板就会自动进入 Maskrom 模式。 @@ -33,7 +33,7 @@ Maskrom 模式是 Rockchip 芯片内置的底层恢复模式，当设备无法 主板进入 Maskrom 模式后，我们可以使用 RKDevTool 工具验证主板是否进入 Maskrom 模式。 -## 验证 Maskrom 模式 +- 验证 Maskrom 模式 @@ -52,13 +52,13 @@ Maskrom 模式是 Rockchip 芯片内置的底层恢复模式，当设备无法 - + -在 Linux / MacOS 平台，我们可以使用 RKDevTool 工具验证主板是否进入 Maskrom 模式。 +在 Linux / macOS 平台，我们可以使用 RKDevTool 工具验证主板是否进入 Maskrom 模式。 使用 `rkdeveloptool ld` 命令可以查看主板是否进入 Maskrom 模式。 - + ``` sudo rkdeveloptool ld @@ -68,7 +68,7 @@ sudo rkdeveloptool ld 若系统终端输出类似以下信息，说明主板已经进入 Maskrom 模式。 - + ``` DevNo=1 Vid=0x2207,Pid=0x350e,LocationID=109 Maskrom diff --git a/docs/common/radxa-os/rkdevtool/_maskrom_two_device.mdx b/docs/common/radxa-os/rkdevtool/_maskrom_two_device.mdx index cad557428..8d430d281 100644 --- a/docs/common/radxa-os/rkdevtool/_maskrom_two_device.mdx +++ b/docs/common/radxa-os/rkdevtool/_maskrom_two_device.mdx @@ -77,13 +77,13 @@ Maskrom 模式是 Rockchip 芯片内置的底层恢复模式，当设备无法 - + -在 Linux / MacOS 平台，我们可以使用 RKDevTool 工具验证主板是否进入 Maskrom 模式。 +在 Linux / macOS 平台，我们可以使用 RKDevTool 工具验证主板是否进入 Maskrom 模式。 使用 `rkdeveloptool ld` 命令可以查看主板是否进入 Maskrom 模式。 - + ``` sudo rkdeveloptool ld @@ -93,7 +93,7 @@ sudo rkdeveloptool ld 若系统终端输出类似以下信息，说明主板已经进入 Maskrom 模式。 - + ``` DevNo=1 Vid=0x2207,Pid=0x350e,LocationID=109 Maskrom diff --git a/docs/common/radxa-os/rkdevtool/_spi.mdx b/docs/common/radxa-os/rkdevtool/_spi.mdx index 032486e53..07cb6ffbd 100644 --- a/docs/common/radxa-os/rkdevtool/_spi.mdx +++ b/docs/common/radxa-os/rkdevtool/_spi.mdx @@ -43,7 +43,7 @@ SPI启动固件（BootROM + 引导程序）的核心任务是分阶段初始化 - + 1. 确保主板处于 Maskrom 模式 @@ -118,7 +118,7 @@ sudo rkdeveloptool rd - + 1. 确保主板处于 Maskrom 模式 @@ -140,7 +140,7 @@ DevNo=1 Vid=0x2207,Pid=0x350e,LocationID=109 Maskrom 你需要将 `demo.bin` 换成主板对应的 Loader 文件 - + ``` sudo rkdeveloptool db demo.bin diff --git a/docs/common/radxa-os/rkdevtool/_use.mdx b/docs/common/radxa-os/rkdevtool/_use.mdx index a771b244a..d7c9be34d 100644 --- a/docs/common/radxa-os/rkdevtool/_use.mdx +++ b/docs/common/radxa-os/rkdevtool/_use.mdx @@ -1,4 +1,4 @@ -RKDevTool 是瑞芯微（Rockchip）平台为 Windows/Linux/MacOS 平台下进行 USB 烧录所开发的软件，旨在简化和加速对 Rockchip 系列芯片的开发、调试过程。 +RKDevTool 是瑞芯微（Rockchip）平台为 Windows/Linux/macOS 平台下进行 USB 烧录所开发的软件，旨在简化和加速对瑞芯微系列芯片的开发、调试过程。 @@ -21,7 +21,7 @@ RKDevTool 是瑞芯微（Rockchip）平台为 Windows/Linux/MacOS 平台下进
@@ -66,15 +66,15 @@ rkdeveloptool -V - + - 安装 HomeBrew -[HomeBrew](https://brew.sh/) 是一个免费且开源的包管理器，它简化了 MacOS 用户安装软件的过程。 +[HomeBrew](https://brew.sh/) 是一个免费且开源的包管理器，它简化了 macOS 用户安装软件的过程。 若没有安装 HomeBrew，可以按照教程进行安装。 - + ``` /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" @@ -86,7 +86,7 @@ rkdeveloptool -V 打开系统终端或命令行，运行以下命令进行安装。 - + ``` brew install automake autoconf libusb pkg-config git wget @@ -104,7 +104,7 @@ cp rkdeveloptool /opt/homebrew/bin/ 完成 RKDevTool 安装后，使用以下命令可以查看 RKDevTool 版本号。 - + ``` rkdeveloptool -V diff --git a/docs/som/nx/nx4/README.md b/docs/som/nx/nx4/README.md new file mode 100644 index 000000000..001091d38 --- /dev/null +++ b/docs/som/nx/nx4/README.md @@ -0,0 +1,154 @@ +--- +sidebar_position: 3 +--- + +# 瑞莎 NX4 + +## 产品介绍 + +瑞莎 NX4 是一款基于瑞芯微 RK3576(J) 的高性能 AI 计算核心板，采用 260-pin SO-DIMM 封装，尺寸仅 69.6mm × 45mm。 + +该核心板集成了 4 核 Cortex-A72 + 4 核 Cortex-A53 CPU、ARM Mali G52 MC3 GPU 和 6 TOPS@INT8 NPU，支持主流深度学习框架。提供丰富的接口和扩展能力，适用于边缘计算、机器视觉、智能终端等应用场景。 + +瑞莎 NX4 专为 Radxa NX4 打造，支持快速功能验证与原型搭建，方便用户在短时间内完成上电调试、接口评估及应用开发上手。 + +## 产品实物 + + + + + +| 产品实物 | 序号 | 视图 | 序号 | 视图 | +| :------: | :--: | :----: | :--: | :----: | +| 瑞莎 NX4 | ① | 俯视图 | ② | 背视图 | + +
+ +
+ + + + + +瑞莎 NX4 载板可用于快速验证瑞莎 NX4 功能，方便用户快速上手。 + +| 产品实物 | 序号 | 视图 | 序号 | 视图 | +| :-----------: | :--: | :----: | :--: | :----: | +| 瑞莎 NX4 载板 | ① | 俯视图 | ② | 背视图 | + +
+ +
+ + + + + +由瑞莎 NX4 和瑞莎 NX4 载板组成，可用于快速验证核心板功能、评估性能并搭建原型系统，帮助用户高效完成开发与方案验证。 + +| 产品实物 | 序号 | 视图 | 序号 | 视图 | 序号 | 视图 | +| :---------------: | :--: | :----: | :--: | :----: | :--: | :----: | +| 瑞莎 NX4 开发套件 | ① | 俯视图 | ② | 侧视图 | ③ | 背视图 | + +
+ +
+ + + + + +## 产品规格 + +| 产品型号 | 瑞莎 NX4 | +| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| SoC（主控） | 瑞芯微 RK3576(J) | +| CPU（中央处理器） | 4 核 Cortex-A72 + 4 核 Cortex-A53 | +| GPU（图形处理器） | ARM Mali G52 MC3
- 支持 OpenGL ES 1.1, 2.0 and 3.2, OpenCL 2.1, Vulkan 1.2 | +| NPU（神经网络处理器） | 6 TOPS@INT8
- 支持 INT4 / INT8 / INT16 / FP16 / BF16 / TF32 等计算精度
- 支持 TensorFlow, Caffe, Tflite, Pytorch, Onnx NN, Android NN 等深度学习框架 | +| 内存 | LPDDR5
- 容量：最高 16GB
- 内存总线宽度：32 位（双通道，每通道 16 位）
- 数据传输速率：最高 5500 MT/s | +| 视频编解码 | 视频编码
- 最高支持 4K@60fps 的 H.265 多路视频编码器
视频解码
- 最高支持 8K@30fps 或 4K@120fps 的 AV1 / AVS2 / VP9 / H.265 多路视频解码器
- 最高支持 4K@60fps 的 H.264 多路视频解码器 | +| 存储 | 可选 eMMC 或 UFS
- eMMC 5.1, 最大可选 256GB
- UFS 2.0, 最大可选 1TB
板载 SPI Flash（可选）
1x SDMMC | +| 网络 | 1x 千兆以太网
板载 WiFI 6 & BT5.4
- 板载天线接口 | +| 显示 | 1x HDMI 2.1
- 最高支持 4K@120Hz | +| 摄像头 | 2x MIPI 摄像头（4 通道） | +| USB | USB 3.2
USB 2.0 | +| PCIe | 1x PCIe2.0 x1 | +| 其它接口 | 支持 UART, I2C, I2S, CAN, PWM, GPIOs 等功能 | +| 连接器 | 260-pin SO-DIMM 连接器 | +| 操作系统 | 支持 Debian, Yocto, Buildroot, Android 14 | +| 机械尺寸 | 69.6 毫米 x 45 毫米 | +| 工作温度 | 0 - 60°C（商业级）
-40°C to 85°C（工业级） | + +## 接口说明 + + + + + +
+ +
+ +| 序号 | 说明 | 序号 | 说明 | 序号 | 说明 | +| :--: | :------------------- | :--: | :--------- | :--: | :--------------------- | +| 1 | WiFi 6 & BT 5.4 模组 | 2 | 天线接口 | 3 | SPI Flash (未焊接) | +| 4 | 瑞芯微 RK3576 | 5 | 状态指示灯 | 6 | LPDDR5 | +| 7 | Maskrom 按键 | 8 | 板载 eMMC | 9 | 260-pin SO-DIMM 连接器 | +| 10 | 板载 UFS (未焊接) | | | | | + + + + + +
+ +
+ +| 序号 | 说明 | 序号 | 说明 | 序号 | 说明 | +| :--: | :--------------------------------- | :--: | :----------------------------------------- | :--: | :----------------------------------------- | +| 1 | MIPI 摄像头（4 通道） | 2 | MIPI 摄像头（4 通道） | 3 | DC5525 供电接口（9V-20V） | +| 4 | PoE 反向供电接口 | 5 | HDMI 输出接口 | 6 | 按键接口 | +| 7 | 4x USB 3.2 Type-A | 8 | 260-pin SO-DIMM 插槽 | 9 | CAN 总线接口 | +| 10 | RJ45 千兆以太网口 | 11 | USB Type-C | 12 | 电源指示灯 | +| 13 | 40-Pin GPIO 排针 | 14 | M.2 M Key 2230 插槽
当前版本无法使用 | 15 | M.2 M Key 2280 插槽
当前版本无法使用 | +| 16 | M.2 E Key 2230 插槽（PCIe 2.0 x1） | 17 | RTC 电池接口 | 18 | PoE 接口 | +| 19 | PWM 风扇接口 | | | | | + +:::note 接口说明 + +瑞莎 NX4 搭配瑞莎 NX4 载板使用，M.2 M Key 2230 和 M.2 E Key 2230 插槽无法使用。 + +::: + + + + + +## 系统框图 + +
+ +
+ +## 应用场景 + +### 边缘计算与智能网关 + +依托 6 TOPS NPU 与千兆以太网、WiFi 6，无需依赖云端即可在本地完成视频分析、目标检测、人脸识别等 AI 推理任务，实现边缘侧智能决策与数据预处理，大幅降低网络带宽与云端算力压力。 + +### 机器视觉与工业自动化 + +可用于视觉检测、识别与测量等机器视觉场景，并与现场总线、工业控制设备协同工作，构建柔性生产线、自动检测工站和智能设备。 + +### 服务与移动机器人 + +多核 CPU + NPU 组合，配合 IMU 与各类传感器扩展以及有线/无线网络能力，可作为移动机器人或协作机器人主控平台，用于路径规划、环境感知、目标跟踪以及远程运维与状态监控等应用。 + +### 交互式终端与智能显示 + +适用于智能广告机、信息查询终端、自助设备、智慧零售终端等应用，通过高分辨率显示与本地智能分析，实现更丰富的人机交互体验。 + +### 教育培训与研发验证 + +可用于高校与培训机构的嵌入式与 AI 教学实践平台，也适合作为企业方案原型开发与功能验证的基础硬件平台，加速从概念设计到产品落地的过程。 diff --git a/docs/som/nx/nx4/accessories-use/README.md b/docs/som/nx/nx4/accessories-use/README.md new file mode 100644 index 000000000..5dd1a5a45 --- /dev/null +++ b/docs/som/nx/nx4/accessories-use/README.md @@ -0,0 +1,7 @@ +--- +sidebar_position: 20 +--- + +# 配件使用 + + diff --git a/docs/som/nx/nx4/accessories-use/rtc-bat.md b/docs/som/nx/nx4/accessories-use/rtc-bat.md new file mode 100644 index 000000000..fa11accc4 --- /dev/null +++ b/docs/som/nx/nx4/accessories-use/rtc-bat.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 1 +--- + +import RTC from '../../../../common/accessories/\_rtc-bat.mdx'; + +# RTC 电池 + + diff --git a/docs/som/nx/nx4/download.md b/docs/som/nx/nx4/download.md new file mode 100644 index 000000000..9673ea27d --- /dev/null +++ b/docs/som/nx/nx4/download.md @@ -0,0 +1,46 @@ +--- +sidebar_position: 150 +--- + +# 资源汇总下载 + +## 刷机工具 + +- [Balena Etcher](https://etcher.balena.io/) + +- [DriverAssistant v5.0](https://dl.radxa.com/tools/windows/DriverAssitant_v5.0.zip) + +- [RKDevTool](https://dl.radxa.com/tools/windows/RKDevTool_Release_v2.96-20221121.rar) + +## Loader 文件 + +用于初始化 USB 下载。 + +- [rk3576_spl_loader.bin](https://dl.radxa.com/rock4/4d/images/rk3576_spl_loader.bin) + +## 系统镜像 + +:::info 最新系统镜像发布页面 + +- [RK 3576 通用系统镜像](https://github.com/radxa-build/radxa-rk3576/releases) + +该页面会发布最新的正式版本和测试版本的系统镜像，测试版本以 `t` 开头，正式版本以 `r` 开头（旧版本的正式版本以 `b` 开头）。 + +::: + +- [radxa-rk3576_bookworm_kde_r4.output_512.img.xz](https://github.com/radxa-build/radxa-rk3576/releases/download/rsdk-r4/radxa-rk3576_bookworm_kde_r4.output_512.img.xz) + +## 硬件设计 + +### 瑞莎 NX4 + +- [原理图 V1.11](https://dl.radxa.com/nx/nx4/hw/radxa_nx4_schematic_v1.11.pdf) +- [位号图 V1.11](https://dl.radxa.com/nx/nx4/hw/radxa_nx4_components_placement_map_v1.11.pdf) +- [引脚定义表 V1.11](https://dl.radxa.com/nx/nx4/hw/radxa_nx4_pinout_v1.11.xlsx) +- [2D TOP DXF 文件 V1.11](https://dl.radxa.com/nx/nx4/hw/radxa_nx4_2d_top_v1.11.dxf) +- [2D BOTTOM DXF 文件 V1.11](https://dl.radxa.com/nx/nx4/hw/radxa_nx4_2d_bot_v1.11.dxf) +- [3D STP 文件 V1.11](https://dl.radxa.com/nx/nx4/hw/radxa_nx4_3d_stp_v1.11.stp) + +### 瑞莎 NX4 载板 + +- [设计参考资料](https://github.com/radxa/radxa-cm-projects/tree/main/nx4/radxa-nx4-io-board) diff --git a/docs/som/nx/nx4/getting-started/README.md b/docs/som/nx/nx4/getting-started/README.md new file mode 100644 index 000000000..6e45f7b62 --- /dev/null +++ b/docs/som/nx/nx4/getting-started/README.md @@ -0,0 +1,7 @@ +--- +sidebar_position: 5 +--- + +# 上手指南 + + diff --git a/docs/som/nx/nx4/getting-started/install-system/README.md b/docs/som/nx/nx4/getting-started/install-system/README.md new file mode 100644 index 000000000..9f016143a --- /dev/null +++ b/docs/som/nx/nx4/getting-started/install-system/README.md @@ -0,0 +1,7 @@ +--- +sidebar_position: 10 +--- + +# 安装系统 + + diff --git a/docs/som/nx/nx4/getting-started/install-system/emmc-system/README.md b/docs/som/nx/nx4/getting-started/install-system/emmc-system/README.md new file mode 100644 index 000000000..19a0fc2bf --- /dev/null +++ b/docs/som/nx/nx4/getting-started/install-system/emmc-system/README.md @@ -0,0 +1,7 @@ +--- +sidebar_position: 10 +--- + +# 安装系统到板载 eMMC + + diff --git a/docs/som/nx/nx4/getting-started/install-system/emmc-system/enter-maskrom.md b/docs/som/nx/nx4/getting-started/install-system/emmc-system/enter-maskrom.md new file mode 100644 index 000000000..bdf4ea277 --- /dev/null +++ b/docs/som/nx/nx4/getting-started/install-system/emmc-system/enter-maskrom.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 5 +--- + +import Maskrom from '../../../../../../common/radxa-os/rkdevtool/\_maskrom.mdx'; + +# 进入 Maskrom 模式 + + diff --git a/docs/som/nx/nx4/getting-started/install-system/emmc-system/install-emmc.md b/docs/som/nx/nx4/getting-started/install-system/emmc-system/install-emmc.md new file mode 100644 index 000000000..5b2ea214e --- /dev/null +++ b/docs/som/nx/nx4/getting-started/install-system/emmc-system/install-emmc.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 10 +--- + +import EMMC from '../../../../../../common/radxa-os/rkdevtool/\_emmc.mdx'; + +# 安装系统到板载 eMMC + + diff --git a/docs/som/nx/nx4/getting-started/install-system/emmc-system/install-rkdevtool.md b/docs/som/nx/nx4/getting-started/install-system/emmc-system/install-rkdevtool.md new file mode 100644 index 000000000..cf257f25d --- /dev/null +++ b/docs/som/nx/nx4/getting-started/install-system/emmc-system/install-rkdevtool.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 1 +--- + +import UseRKDevTool from '../../../../../../common/radxa-os/rkdevtool/\_use.mdx'; + +# 安装 RKDevTool + + diff --git a/docs/som/nx/nx4/getting-started/quickly-start.md b/docs/som/nx/nx4/getting-started/quickly-start.md new file mode 100644 index 000000000..3bd9edae7 --- /dev/null +++ b/docs/som/nx/nx4/getting-started/quickly-start.md @@ -0,0 +1,98 @@ +--- +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'; + +# 快速上手 + +本节教程将指导您快速上手使用瑞莎 NX4，配合瑞莎 NX4 载板，帮助您快速验证瑞莎 NX4 功能。 + +## 产品实物 + +瑞莎 NX4 开发套件由瑞莎 NX4 和瑞莎 NX4 载板组成，可用于快速验证核心板功能。 + +| 产品实物 | 序号 | 视图 | 序号 | 视图 | 序号 | 视图 | +| :---------------: | :--: | :----: | :--: | :----: | :--: | :----: | +| 瑞莎 NX4 开发套件 | ① | 俯视图 | ② | 侧视图 | ③ | 背视图 | + +
+ +
+ +## 使用前提 + +您需要提前准备以下硬件设备： + +- 瑞莎 NX4 开发套件 +- 供电：DC 5525 电源适配器（9 - 20V） +- 系统启动介质：板载 eMMC +- 显示设备：HDMI 数据线和显示器 +- 输入设备：键盘和鼠标（用于图形界面操作） + +:::tip 推荐配件 + +- [瑞莎 DC 60W 电源适配器(推荐使用)](https://radxa.com/products/accessories/power-dc12-60w) +- 支持 9-20V 的 DC 电源适配器进行供电，推荐功率 40W 及以上 + +::: + +## 安装系统 + +主要介绍安装系统到瑞莎 NX4 的板载 eMMC。 + +:::warning 重要提醒 + +**安装系统会完全格式化 eMMC，所有数据将被永久删除！** + +请在操作前确认： + +- eMMC 中无重要数据或已完成资料备份 + ::: + +### 安装 RKDevTool + + + +### 进入 Maskrom 模式 + + + +### 安装系统到 eMMC + + + +## 启动系统 + +完成系统的安装后，连接 HDMI 显示器，重新插拔电源适配器，即可启动系统。 + +
+ +
+ +① ：使用 HDMI 数据线连接显示器和主板 + +② ：使用电源适配器给瑞莎 NX4 开发套件供电 + +系统启动正常后，瑞莎 NX4 载板上的电源指示灯绿色亮起，瑞莎 NX4 上的状态指示灯蓝色闪烁。 + +## 登录系统 + +当您首次启动系统后，需要使用默认的用户名和密码登录。 + +Radxa OS 的默认凭据如下： + +| 项目 | 内容 | +| :----- | :------ | +| 用户名 | `radxa` | +| 密码 | `radxa` | + +## 使用系统 + +成功登录系统后，您就可以在瑞莎 NX4 开发套件上进行系统配置与开发。 + +
+ +
diff --git a/docs/som/nx/nx4/hardware-use/README.md b/docs/som/nx/nx4/hardware-use/README.md new file mode 100644 index 000000000..c0317ba6b --- /dev/null +++ b/docs/som/nx/nx4/hardware-use/README.md @@ -0,0 +1,7 @@ +--- +sidebar_position: 15 +--- + +# 硬件使用 + + diff --git a/docs/som/nx/nx4/hardware-use/gpio.md b/docs/som/nx/nx4/hardware-use/gpio.md new file mode 100644 index 000000000..dddb2f3d0 --- /dev/null +++ b/docs/som/nx/nx4/hardware-use/gpio.md @@ -0,0 +1,46 @@ +--- +sidebar_position: 5 +--- + +# 40-Pin GPIO 排针 + +瑞莎 NX4 载板板载 40-Pin GPIO（通用输入输出）接口，为硬件扩展提供了高度灵活的接口支持。 + +用户可以通过 40-Pin GPIO 接口连接各类传感器、执行器、通信模块、显示屏以及其他嵌入式外设，从而快速实现物联网、机器人控制、工业自动化等领域的原型开发与功能验证。 + +:::danger 使用说明 + +使用 40-Pin GPIO 接口时，请注意引脚和外设的接线，请确保引脚连接正确，不当操作可能导致设备硬件损坏。 + +::: + +## GPIO 功能 + + +
+ +| GPIO number | Function5 | Function4 | Function3 | Function2 | Function1 | Voltage | Pin# | Pin# | Voltage | Function1 | Function2 | Function3 | Function4 | Function5 | Function6 | GPIO number | +| :---------: | :---------: | :----------: | :---------: | :---------: | :-------: | :-----: | :------------------------------: | :-----------------------------: | :-----: | :-------: | :----------: | :---------: | :----------: | :---------: | :--------: | :---------: | +| | | | | | | 3.3V |
1
|
2
| 5V | | | | | | | | +| 55 | | | I2C8_SDA_M1 | UART2_RX_M0 | GPIO1_C7 | 3.3V |
3
|
4
| 5V | | | | | | | | +| 54 | | | I2C8_SCL_M1 | UART2_TX_M0 | GPIO1_C6 | 3.3V |
5
|
6
| GND | | | | | | | | +| 51 | | SPI2_CSN0_M1 | | | GPIO1_C3 | 3.3V |
7
|
8
| 3.3V | GPIO4_B4 | UART2_RX_M1 | | | | CAN1_RX_M2 | 140 | +| | | | | | | GND |
9
|
10
| 3.3V | GPIO4_B5 | UART2_TX_M1 | | | | CAN1_TX_M2 | 141 | +| 52 | | SPI2_MOSI_M1 | | UART4_TX_M1 | GPIO1_C4 | 3.3V |
11
|
12
| 3.3V | GPIO1_D1 | UART10_RX_M1 | | | | | 57 | +| 80 | PWM1_CH0_M2 | | | | GPIO2_C0 | 3.3V |
13
|
14
| GND | | | | | | | | +| 53 | | SPI2_MISO_M1 | | UART4_RX_M1 | GPIO1_C5 | 3.3V |
15
|
16
| 3.3V | GPIO2_B6 | UART7_TX_M0 | | | | | 78 | +| | | | | | | 3.3V |
17
|
18
| 3.3V | GPIO2_B7 | UART7_RX_M0 | | | | | 79 | +| 45 | PWM1_CH1_M1 | SPI1_MOSI_M0 | | | GPIO1_B5 | 3.3V |
19
|
20
| GND | | | | | | | | +| 46 | | SPI1_MISO_M0 | | | GPIO1_B6 | 3.3V |
21
|
22
| 3.3V | GPIO2_D7 | | | | PWM2_CH7_M2 | | 95 | +| 44 | PWM1_CH0_M1 | SPI1_CLK_M0 | | | GPIO1_B4 | 3.3V |
23
|
24
| 3.3V | GPIO1_B7 | | | SPI1_CSN0_M0 | | | 47 | +| | | | | | | GND |
25
|
26
| 3.3V | GPIO1_C0 | UART3_TX_M2 | | SPI1_CSN1_M0 | PWM0_CH0_M1 | | 48 | +| 151 | | | I2C6_SDA_M3 | | GPIO4_C7 | 3.3V |
27
|
28
| 3.3V | GPIO4_C6 | | I2C6_SCL_M3 | | | | 150 | +| 98 | | | | | GPIO3_A2 | 3.3V |
29
|
30
| GND | | | | | | | | +| 49 | | | | UART3_RX_M2 | GPIO1_C1 | 3.3V |
31
|
32
| 3.3V | GPIO1_D5 | | | SPI2_CLK_M1 | | | 61 | +| 50 | PWM1_CH2_M1 | SPI2_CSN1_M1 | | | GPIO1_C2 | 3.3V |
33
|
34
| GND | | | | | | | | +| 58 | PWM1_CH3_M1 | | | | GPIO1_D2 | 3.3V |
35
|
36
| 3.3V | GPIO1_D4 | | | | | | 60 | +| 99 | | | | | GPIO3_A3 | 3.3V |
37
|
38
| 3.3V | GPIO1_D3 | | | | PWM1_CH4_M1 | | 59 | +| | | | | | | GND |
39
|
40
| 3.3V | GPIO1_D0 | UART10_TX_M1 | | | | | 56 | + +
+ diff --git a/docs/som/nx/nx4/hardware-use/hardware_info.md b/docs/som/nx/nx4/hardware-use/hardware_info.md new file mode 100644 index 000000000..eb153a5d2 --- /dev/null +++ b/docs/som/nx/nx4/hardware-use/hardware_info.md @@ -0,0 +1,70 @@ +--- +sidebar_position: 1 +--- + +# 硬件信息 + +## 芯片框图 + +
+ +
+ +## 系统框图 + +
+ +
+ +## 接口说明 + + + + + +
+ +
+ +| 序号 | 说明 | 序号 | 说明 | 序号 | 说明 | +| :--: | :------------------- | :--: | :--------- | :--: | :--------------------- | +| 1 | WiFi 6 & BT 5.4 模组 | 2 | 天线接口 | 3 | SPI Flash (未焊接) | +| 4 | 瑞芯微 RK3576 | 5 | 状态指示灯 | 6 | LPDDR5 | +| 7 | Maskrom 按键 | 8 | 板载 eMMC | 9 | 260-pin SO-DIMM 连接器 | +| 10 | 板载 UFS (未焊接) | | | | | + + + + + +
+ +
+ +| 序号 | 说明 | 序号 | 说明 | 序号 | 说明 | +| :--: | :--------------------------------- | :--: | :----------------------------------------- | :--: | :----------------------------------------- | +| 1 | MIPI 摄像头（4 通道） | 2 | MIPI 摄像头（4 通道） | 3 | DC5525 供电接口（9V-20V） | +| 4 | PoE 反向供电接口 | 5 | HDMI 输出接口 | 6 | 按键接口 | +| 7 | 4x USB 3.2 Type-A | 8 | 260-pin SO-DIMM 插槽 | 9 | CAN 总线接口 | +| 10 | RJ45 千兆以太网口 | 11 | USB Type-C | 12 | 电源指示灯 | +| 13 | 40-Pin GPIO 排针 | 14 | M.2 M Key 2230 插槽
当前版本无法使用 | 15 | M.2 M Key 2280 插槽
当前版本无法使用 | +| 16 | M.2 E Key 2230 插槽（PCIe 2.0 x1） | 17 | RTC 电池接口 | 18 | PoE 接口 | +| 19 | PWM 风扇接口 | | | | | + +:::note 接口说明 + +瑞莎 NX4 搭配瑞莎 NX4 载板使用，M.2 M Key 2230 和 M.2 E Key 2230 插槽无法使用。 + +::: + + + + + +- 电源指示灯 + +正常状态下，瑞莎 NX4 载板的电源指示灯（绿色）亮起，表示电源正常。 + +- 用户指示灯 + +瑞莎 NX4 的状态指示灯（蓝色）闪烁，表示系统正常运行。 diff --git a/docs/som/nx/nx4/system-use/README.md b/docs/som/nx/nx4/system-use/README.md new file mode 100644 index 000000000..3451b46a7 --- /dev/null +++ b/docs/som/nx/nx4/system-use/README.md @@ -0,0 +1,7 @@ +--- +sidebar_position: 10 +--- + +# 系统使用 + + diff --git a/docs/som/nx/nx4/system-use/appuse.md b/docs/som/nx/nx4/system-use/appuse.md new file mode 100644 index 000000000..167b3162d --- /dev/null +++ b/docs/som/nx/nx4/system-use/appuse.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 7 +--- + +import AppUse from '../../../../common/radxa-os/system-config-debian12/\_appuse.mdx'; + +# 应用使用 + + diff --git a/docs/som/nx/nx4/system-use/audio.md b/docs/som/nx/nx4/system-use/audio.md new file mode 100644 index 000000000..e614128d9 --- /dev/null +++ b/docs/som/nx/nx4/system-use/audio.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 8 +--- + +import Audio from '../../../../common/radxa-os/system-config-debian12/\_audio.mdx'; + +# 音频管理 + +