Skip to content

Commit

Permalink
feat: add cm3j zh/en docs
Browse files Browse the repository at this point in the history
Signed-off-by: Mitchell Ma <[email protected]>
  • Loading branch information
RadxaMitchell committed Jan 17, 2025
1 parent 2190449 commit 28bf555
Show file tree
Hide file tree
Showing 214 changed files with 4,126 additions and 0 deletions.
16 changes: 16 additions & 0 deletions docs/Home.md
Original file line number Diff line number Diff line change
Expand Up @@ -399,6 +399,22 @@ sidebar_custom_props:
},
],
},
{
products_name: "Radxa CM3J",
products_photo_url: "/home/product-pictures/cm3j.webp",
products_link: "/compute-module/cm3j",
docs:
[
{
docs_link: "/compute-module/cm3j",
docs_photo_type: "Overview",
docs_name_en: "Overview",
docs_name_zh: "Radxa CM3J 概览",
docs_info_en: "Overview of the Radxa CM3J",
docs_info_zh: "Radxa CM3J 概览",
},
],
},
{
products_name: "Radxa CM3S",
products_photo_url: "/home/product-pictures/cm3s.webp",
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
<Tabs queryString="组装">

<TabItem value="安装核心板">

首先将核心板上的四个固定孔和底板上的**四个固定孔对齐**,然后先**轻轻按压一边**到差不多一半的深度,然后再按压另外的边到一半,确认好槽位都对齐后,再依次按压边到底部。

注意: ***按压的时候,不要用力按压中部悬空区域,则PCB产生应力导致器件松动或者损坏,比如 DDR 松动,电阻断裂等。***

![注意事项](/img/cm3j/install-core-board-on-rpi-cm4-io.webp)

</TabItem>

<TabItem value="卸载核心板">
使用一些类似下面的工具,从四个角依次撬开,不要用手或者工具从中间及单边强制掰开。

![卸载核心板](/img/cm3j/uninstall-core-board-on-rpi-cm4-io.webp)
</TabItem>

</Tabs>
104 changes: 104 additions & 0 deletions docs/compute-module/cm3j/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,104 @@
---
sidebar_position: 1
---

# 瑞莎 CM3J

# 产品介绍

Radxa CM3J 是基于 Rockchip RK3568J 片上系统 (SoC) 的一款功能丰富的工业级计算模块。CM3J 集成了中央处理器 (CPU)、电源管理单元 (PMU)、DRAM 存储器、eMMC 存储器和无线连接(WiFi 5 和 BT 5.0),外形小巧,仅为 55 毫米 x 40 毫米。CM3J 为许多不同的工业应用提供了高性价比的解决方案。

## 主要特性

### 强大的多媒体处理能力

CPU 采用了先进的 ARM Cortex-A55 架构,集成了强大的图像处理单元(GPU),支持高清视频解码和编码,能够处理多种视频格式和分辨率。此外,RK3568J还配备了高性能的 DSP 和 NPU(神经网络处理单元),用于音频处理和人工智能应用,使其在多媒体处理方面表现出色。

### 潜在的开发潜力

作为一款强大的开发平台 Radxa CM3J 对于人工智能、边缘计算、嵌入式系统等领域具有较大的潜力。

### 兼容性

Radxa CM3J 在兼容 [Raspberry Pi CM4 IO Board](https://www.raspberrypi.com/products/compute-module-4-io-board/) 的同时也兼容 [WaveShare CM4-POE-UPS-BASE](https://www.waveshare.net/shop/CM4-POE-UPS-BASE.htm)[WaveShare CM4-IO-BASE-B](https://www.waveshare.net/shop/CM4-IO-BASE-B.htm)[WaveShare CM4-NANO-B](https://www.waveshare.net/shop/CM4-NANO-B.htm)

## 主板预览

<img src="/img/cm3j/cm3j-package.webp" alt="Radxa CM3J 核心板" style={{ width: "60%" }} />

## 芯片框图

<img src="/img/rock3/3b/rk3568-block-diagram.webp" alt="rk3568 chip block diagram" style={{ width: "80%" }} />

## 系统框图

<img src="/img/cm3j/radxa-cm3j-System-block-diagram.webp" alt="cm3j board block diagram" style={{ width: "80%" }} />

## 参数配置

<table>
<tr>
<td align="center">型号</td>
<td align="center">CM3J 核心板</td>
</tr>
<tr>
<td align="center">CPU</td>
<td align="center">Rockchip RK3568J, Quad core Cortex-A55 (ARM v8) 64-bit SoC @ **2.0GHz**</td>
</tr>
<tr>
<td align="center">GPU</td>
<td align="center">ARM G52-2EE GPU<br/>OpenGL® ES1.1/2.0/3.0/3.1/3.2<br/>OpenCL® 2.1<br/>Vulkan® 1.1</td>
</tr>
<tr>
<td align="center">NPU</td>
<td align="center">NPU 支持 INT8/INT16/FP16/BFP16,计算能力高达 1TOPs@INT8</td>
</tr>
<tr>
<td align="center">内存</td>
<td align="center">2GB 或 4GB LPDDR4X(视机型而定)</td>
</tr>
<tr>
<td align="center">存储</td>
<td align="center">可选 4GB/8GB/16GB/32GB,板载 eMMC 与 eMMC 5.1 兼容<br/>1x SPI Flash<br/>1x SDMMC0</td>
</tr>
<tr>
<td align="center">显示</td>
<td align="center">1x HDMI TX up to 4096X2160@60Hz<br/>1x 2‑lane MIPI DSI for MIPI LCD 和 1x 4‑lane MIPI DSI for MIPI LCD<br/>1x LVDS four lanes(与 MIPI DSI0 复用)</td>
</tr>
<tr>
<td align="center">硬件编解码</td>
<td align="center">VP9/H.265/H.264 decode 4K@60fps<br/>H.264/H.265 encoder 1080pK@60fps</td>
</tr>
<tr>
<td align="center">摄像头接口</td>
<td align="center">1x 4-lane MIPI CSI RX 和 2x 2-lane MIPI CSI RX</td>
</tr>
<tr>
<td align="center">音频接口</td>
<td align="center">I2S<br/>PDM,支持麦克风阵列<br/>SPDIF_TX</td>
</tr>
<tr>
<td align="center">输入功率</td>
<td align="center">5V DC</td>
</tr>
<tr>
<td align="center">运行温度</td>
<td align="center">RK3568J: -40° to 85° 摄氏度</td>
</tr>
<tr>
<td align="center">安全性</td>
<td align="center">OTP<br/>安全启动<br/>Arm TrustZone® 安全扩展<br/>安全视频路径、安全 JTAG 调试<br/>加密 (AES/TDES/SM4/SM3/SHA256/SHA512/RSA)</td>
</tr>
<tr>
<td align="center">以太网</td>
<td align="center">1000M 以太网物理层(RTL8211FSI-VS)</td>
</tr>
<tr>
<td align="center">无线网络</td>
<td align="center">IEEE 802.11 b/g/n/ac 无线局域网(Wi-Fi 5),带外置天线连接器<br/>带 BLE 的 BT 5.0</td>
</tr>
<tr>
<td align="center">尺寸</td>
<td align="center">50 mm × 40 mm </td>
</tr>
</table>
9 changes: 9 additions & 0 deletions docs/compute-module/cm3j/app-development/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
---
sidebar_position: 5
---

# 应用开发

主要介绍上层应用开发,比如 QT, WiringX, Mraa 等

<DocCardList />
9 changes: 9 additions & 0 deletions docs/compute-module/cm3j/app-development/gpiod.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
---
sidebar_position: 2
---

# GPIOD 使用

import GPIOD from '../../../common/dev/\_gpiod.mdx';

<GPIOD />
9 changes: 9 additions & 0 deletions docs/compute-module/cm3j/app-development/opencv.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
---
sidebar_position: 5
---

# OpenCV

import OPENCV from '../../../common/dev/\_opencv.mdx';

<OPENCV />
9 changes: 9 additions & 0 deletions docs/compute-module/cm3j/app-development/panfork.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
---
sidebar_position: 6
---

import Panfork from '../../../common/dev/\_panfork.mdx';

# Panfork GPU Driver

<Panfork />
9 changes: 9 additions & 0 deletions docs/compute-module/cm3j/app-development/qt_cross_compile.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
---
sidebar_position: 7
---

# QT 交叉编译

import QTCROSSCOMPILE from '../../../common/dev/\_qt-cross-compile.mdx';

<QTCROSSCOMPILE />
9 changes: 9 additions & 0 deletions docs/compute-module/cm3j/app-development/rknn_install.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
---
sidebar_position: 9
---

# RKNN 安装

import RKNNinstall from '../../../common/dev/\_rknn-install.mdx';

<RKNNinstall />
9 changes: 9 additions & 0 deletions docs/compute-module/cm3j/app-development/rknn_quick_start.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
---
sidebar_position: 15
---

# RKNN 快速例子

import Rknntoolkit2 from '../../../common/dev/\_rknn-toolkit2.mdx';

<Rknntoolkit2 />
10 changes: 10 additions & 0 deletions docs/compute-module/cm3j/app-development/rknn_toolkit2_pc.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
---
sidebar_position: 10
description: "利用 RKNN 工具包,探索 AI 模型的模拟推理,体验智能图像分割的高效与精准"
---

# 模拟推理 YOLOv5 分割模型

import RKNNTOOLKIT2PC from '../../../common/dev/\_rknn-toolkit2-pc.mdx';

<RKNNTOOLKIT2PC />
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
---
sidebar_position: 11
---

# 板端部署 YOLOv5 目标检测

import RKNNTOOLKITLITE2YOLOV5 from '../../../common/dev/\_rknn-toolkit-lite2-yolov5.mdx';

<RKNNTOOLKITLITE2YOLOV5 />
9 changes: 9 additions & 0 deletions docs/compute-module/cm3j/app-development/rtsp.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
---
sidebar_position: 8
---

import Rtsp from '../../../common/dev/\_rtsp.mdx';

# RTSP 推流

<Rtsp />
9 changes: 9 additions & 0 deletions docs/compute-module/cm3j/app-development/venv_usage.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
---
sidebar_position: 22
---

# Python 虚拟环境使用

import VENVUSAGE from '../../../common/dev/\_venv_usage.mdx';

<VENVUSAGE />
41 changes: 41 additions & 0 deletions docs/compute-module/cm3j/download.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
---
sidebar_position: 2
---

# 资源下载汇总

## 官方引导加载程序和系统镜像

### SPL Loader

- [Loader: rk356x_spl_loader_ddr1056_v1.12.109_no_check_todly.bin](https://dl.radxa.com/cm3j/images/rk356x_spl_loader_ddr1056_v1.12.109_no_check_todly.bin)

### SPI Images

- [radxa-cm3j-spi-image](https://dl.radxa.com/cm3j/images/radxa-cm3j-rpi-cm4-io_spi.img)

- [zero image](https://dl.radxa.com/cm3j/images/zero.img)

### 操作系统镜像

Debian OS:

- Radxa CM3J + Rpi CM4 IO Board 系统镜像: [Radxa CM3J With Raspberry CM4 IO Board Debian b1](https://github.com/radxa-build/radxa-cm3j-rpi-cm4-io/releases/download/rsdk-b1/radxa-cm3j-rpi-cm4-io_bullseye_xfce_b1.output.img.xz)

## 硬件设计

- 数据手册

[Raspberry CM4 IO Board Datasheet](https://datasheets.raspberrypi.com/cm4io/cm4io-datasheet.pdf)

- 原理图

[Radxa CM3J V1.2 Schematic](https://dl.radxa.com/cm3j/docs/hw/radxa_cm3j_schematic_v1.2_20250115.pdf)

- 位号图

[Radxa CM3J V1.2 Placement Map](https://dl.radxa.com/cm3j/docs/hw/radxa_cm3j_components_placement_map_v1.2_20250110.pdf)

- 核心板连接器 PINOUT

[Radxa CM3J V1.2 PinOut](https://dl.radxa.com/cm3j/docs/hw/radxa_cm3j_pinout_v1.2.xlsx)
7 changes: 7 additions & 0 deletions docs/compute-module/cm3j/getting-started/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
sidebar_position: 1
---

# 上手指南

<DocCardList />
8 changes: 8 additions & 0 deletions docs/compute-module/cm3j/getting-started/install-os/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
---
sidebar_position: 3
description: "安装系统的方式"
---

# 安装系统

<DocCardList />
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
---
sidebar_position: 1
description: "安装系统到 SD 卡"
---

import Etcher from '../../../../common/general/\_etcherV2.mdx';

# 安装系统到 SD 卡启动

## 文件下载

请到[资源下载汇总](../../download.md)部分下载对应的 Image

## MicroSD 卡准备

将 MicroSD 卡插入到 SD 卡读卡器中,然后将读卡器插入到 PC 的 USB 端口上

## 镜像烧录

<Etcher/>
Original file line number Diff line number Diff line change
@@ -0,0 +1,57 @@
---
sidebar_position: 3
description: "从 SSD 启动"
---

# 安装系统到 SSD 启动

## 安装系统

- 使用硬盘盒将系统烧录到 SSD 中。烧录可参照[安装系统](../install-os/boot_from_sd_card.md)

## 向 SPI Flash 中烧写 Bootloader

有两种方式可以向 SPI Flash 里面烧写 Bootloader

- 在板子上操作:

- 如果板子上的系统能正常运行,可以通过系统自带的 rsetup 工具进行操作。

- 在 PC 上操作:

- 如果板子不能正常启动或者不想在板子上进行操作,我们可以通过 USB 线连接 PC 和板子,在 PC 端通过工具进行烧写。

### 在板子上操作

- 打开终端,执行 rsetup。

- 选择 "System",按回车键。

<img src="/img/cm3j/rsetup/main-menu.webp" alt="main menu" style={{ width: "80%" }} />

- 然后选择 "Bootloader Management",按回车键。

<img src="/img/cm3j/rsetup/bootloader-management.webp" alt="bootloader management" style={{ width: "80%" }} />

- 接着选择 "Update SPI Bootloader" 之后,按回车,接着选中 "yes" 再按回车键。

<img src="/img/cm3j/rsetup/update-spi.webp" alt="rsetup spi" style={{ width: "80%" }} />
<img src="/img/cm3j/rsetup/yes.webp" alt="rsetup yes" style={{ width: "80%" }} />

- 最后空格选中 "radxa-cm3j-rpi-cm4-io" 选项,按回车后开始向 SPI Flash 中烧录。

<img src="/img/cm3j/rsetup/rsetup-radxa-cm3j-rpi-cm4-io.webp" alt="rsetup radxa cm3j" style={{ width: "80%" }} />

### 在 PC 上操作

在 PC 端需要通过 USB 向 SPI Flash 中烧录 Bootloader,这个过程同样需要进入 Maskrom 模式,使用 RKdevtools 工具烧录。

进入 Maskrom 的步骤和[安装系统到 eMMC](./maskrom/)基本一样,只需修改以下内容:

- 上电时需要按下 SPI Flash Button

![spi flash](/img/cm3j/radxa-cm3j-spi-flash-1.webp)

- 将 RKdevtools 工具中的 image 选项改为使用[资源下载汇总](../../download.md)中的 SPI Image。

![spi flash](/img/cm3j/radxa-cm3j-spi-flash-2.webp)
Loading

0 comments on commit 28bf555

Please sign in to comment.