Merge pull request #649 from RadxaMitchell/main

feat: add cm3j zh/en docs

docs/Home.md

@@ -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",

docs/compute-module/_install_uninstall_coreboard_on_rpi-cm4-io_guide.mdx

@@ -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>

docs/compute-module/cm3j/README.md

@@ -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>

docs/compute-module/cm3j/app-development/README.md

@@ -0,0 +1,9 @@
+---
+sidebar_position: 5
+---
+
+# 应用开发
+
+主要介绍上层应用开发，比如 QT, WiringX, Mraa 等
+
+<DocCardList />

docs/compute-module/cm3j/app-development/gpiod.md

@@ -0,0 +1,9 @@
+---
+sidebar_position: 2
+---
+
+# GPIOD 使用
+
+import GPIOD from '../../../common/dev/\_gpiod.mdx';
+
+<GPIOD />

docs/compute-module/cm3j/app-development/opencv.md

@@ -0,0 +1,9 @@
+---
+sidebar_position: 5
+---
+
+# OpenCV
+
+import OPENCV from '../../../common/dev/\_opencv.mdx';
+
+<OPENCV />

docs/compute-module/cm3j/app-development/panfork.md

@@ -0,0 +1,9 @@
+---
+sidebar_position: 6
+---
+
+import Panfork from '../../../common/dev/\_panfork.mdx';
+
+# Panfork GPU Driver
+
+<Panfork />

docs/compute-module/cm3j/app-development/qt_cross_compile.md

@@ -0,0 +1,9 @@
+---
+sidebar_position: 7
+---
+
+# QT 交叉编译
+
+import QTCROSSCOMPILE from '../../../common/dev/\_qt-cross-compile.mdx';
+
+<QTCROSSCOMPILE />

docs/compute-module/cm3j/app-development/rknn_install.md

@@ -0,0 +1,9 @@
+---
+sidebar_position: 9
+---
+
+# RKNN 安装
+
+import RKNNinstall from '../../../common/dev/\_rknn-install.mdx';
+
+<RKNNinstall />

docs/compute-module/cm3j/app-development/rknn_quick_start.md

@@ -0,0 +1,9 @@
+---
+sidebar_position: 15
+---
+
+# RKNN 快速例子
+
+import Rknntoolkit2 from '../../../common/dev/\_rknn-toolkit2.mdx';
+
+<Rknntoolkit2 />

docs/compute-module/cm3j/app-development/rknn_toolkit2_pc.md

@@ -0,0 +1,10 @@
+---
+sidebar_position: 10
+description: "利用 RKNN 工具包，探索 AI 模型的模拟推理，体验智能图像分割的高效与精准"
+---
+
+# 模拟推理 YOLOv5 分割模型
+
+import RKNNTOOLKIT2PC from '../../../common/dev/\_rknn-toolkit2-pc.mdx';
+
+<RKNNTOOLKIT2PC />

docs/compute-module/cm3j/app-development/rknn_toolkit_lite2_yolov5.md

@@ -0,0 +1,9 @@
+---
+sidebar_position: 11
+---
+
+# 板端部署 YOLOv5 目标检测
+
+import RKNNTOOLKITLITE2YOLOV5 from '../../../common/dev/\_rknn-toolkit-lite2-yolov5.mdx';
+
+<RKNNTOOLKITLITE2YOLOV5 />

docs/compute-module/cm3j/app-development/rtsp.md

@@ -0,0 +1,9 @@
+---
+sidebar_position: 8
+---
+
+import Rtsp from '../../../common/dev/\_rtsp.mdx';
+
+# RTSP 推流
+
+<Rtsp />

docs/compute-module/cm3j/app-development/venv_usage.md

@@ -0,0 +1,9 @@
+---
+sidebar_position: 22
+---
+
+# Python 虚拟环境使用
+
+import VENVUSAGE from '../../../common/dev/\_venv_usage.mdx';
+
+<VENVUSAGE />

docs/compute-module/cm3j/download.md

@@ -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:
+
+- 系统镜像： [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)

docs/compute-module/cm3j/getting-started/README.md

@@ -0,0 +1,7 @@
+---
+sidebar_position: 1
+---
+
+# 上手指南
+
+<DocCardList />

docs/compute-module/cm3j/getting-started/install-os/README.md

@@ -0,0 +1,8 @@
+---
+sidebar_position: 3
+description: "安装系统的方式"
+---
+
+# 安装系统
+
+<DocCardList />

docs/compute-module/cm3j/getting-started/install-os/boot_from_sd_card.md

@@ -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/>

docs/compute-module/cm3j/getting-started/install-os/boot_from_ssd.md

@@ -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)