docs: add rock 5c contents

Signed-off-by: Feng Zhang <[email protected]>
radxa-docs · Apr 3, 2024 · c2743b8 · c2743b8
1 parent 71ab53b
commit c2743b8
Show file tree

Hide file tree

Showing 110 changed files with 1,884 additions and 2 deletions.
diff --git a/docs/rock5/rock5a/README.md b/docs/rock5/rock5a/README.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 10
+sidebar_position: 1
 ---
 
 # ROCK 5A

diff --git a/docs/rock5/rock5c/README.md b/docs/rock5/rock5c/README.md
@@ -0,0 +1,161 @@
+---
+sidebar_position: 5
+---
+
+# ROCK 5C
+
+## 产品介绍
+
+Radxa ROCK 5C 是一款紧凑型单板计算机（SBC），拥有一系列领先的功能、特性和扩展选项。对于创客、物联网爱好者、业余爱好者、游戏玩家、PC用户以及所有追求卓越性能和可靠性的高规格平台的人来说，ROCK 5C 是理想的选择。ROCK 5C 提供两个版本：标准版（基于RK3588S2）和 Lite 版（基于RK3582）。这两个版本在大部分功能上相同，唯一的区别在于 SoC（片上系统）。在后续的文档中，除非特别说明，"ROCK 5C" 指的是 ROCK 5C 标准版和 5C Lite 版本。
+
+ROCK 5C 可作为：
+
+- 个人桌面计算机
+- 个人私有服务器
+- 安卓影音播放器
+- 机器人控制器
+- 区块链节点
+
+其他更多使用场景，等你来发掘！
+
+### 实物照片
+
+<Tabs queryString="target">
+
+  <TabItem value="rock-5c" label="ROCK 5C">
+  <img src="/img/rock5c/rock-5c-overview.webp" alt="rock 5c overview" width="700" />
+  </TabItem>
+
+  <TabItem value="rock-5c-lite" label="ROCK 5C Lite">
+  <img src="/img/rock5c/rock-5c-lite-overview.webp" alt="rock 5c lite overview" width="700" />
+  </TabItem>
+
+</Tabs>
+
+### 芯片框图
+
+<Tabs queryString="target">
+
+  <TabItem value="rk3588s2" label="RK3588S2">
+  <img src="/img/rock5c/rk3588s2_blockdiagram.webp" alt="rock 5c overview" width="700" />
+  </TabItem>
+
+  <TabItem value="rk3582" label="RK3582">
+  <img src="/img/rock5c/rk3582_blockdiagram.webp" alt="rock 5c lite overview" width="700" />
+  </TabItem>
+
+</Tabs>
+
+### 特性
+
+<table>
+    <tr>
+        <td align="center">型号</td>
+        <td align="center">ROCK 5C</td>
+        <td align="center">ROCK 5C Lite</td>
+    </tr>
+    <tr>
+        <td align="center">处理器</td>
+        <td align="center">Rockchip RK3588S2</td>
+        <td align="center">Rockchip RK3582</td>
+    </tr>
+    <tr>
+        <td align="center">CPU</td>
+        <td align="center">Quad-core Cortex-A76 主频最高达 2.4 GHz<br/>Quad-core Cortex-A55 主频最高达 1.8GHz</td>
+        <td align="center">Dual-core Cortex-A76 主频最高达 2.4 GHz<br/>Quad-core Cortex-A55 主频最高达 1.8GHz</td>
+    </tr>
+    <tr>
+        <td align="center">GPU</td>
+        <td align="center"> Arm Mali‑G610MC4 </td>
+        <td align="center"> N/A </td>
+    </tr>
+    <tr>
+        <td align="center">内存</td>
+        <td align="center">2/4/8/16/32GB 64位 LPDDR4x</td>
+        <td align="center">1/2/4/8/16GB 64位 LPDDR4x</td>
+    </tr>
+    <tr>
+        <td align="center">存储</td>
+        <td align="center" colspan="2"> 1x eMMC 座子 <br/> 1x microSD 卡座 <br/> 无 SPI Flash </td>
+    </tr>
+    <tr>
+        <td align="center">视频输出</td>
+        <td align="center" colspan="2">1x HDMI 2.1 支持最高8K画面输出<br/>1x MIPI DSI 最高2K画面输出</td>
+    </tr>
+    <tr>
+        <td align="center">多媒体</td>
+        <td align="center">H.265 / VP9 8K@60fps 解码<br/>H.264 8K@30fps 解码<br/>AV1 4K@60fps 解码<br/>H.264 / H.265 8K@30fps 编码</td>
+        <td align="center">H.264 / H.265 4K@60fps 编码</td>
+    </tr>
+    <tr>
+        <td align="center">以太网</td>
+        <td align="center" colspan="2">支持PoE 功能的千兆以太网口<br/>PoE 需要额外的 HAT</td>
+    </tr>
+    <tr>
+        <td align="center">无线网</td>
+        <td align="center" colspan="2">1x WiFi6 / BT5.4 带外部天线接口</td>
+    </tr>
+    <tr>
+        <td align="center">USB</td>
+        <td align="center" colspan="2">2x USB2.0 端口<br/>1x USB3.0 Host 端口, 1x USB3.0 OTG 端口</td>
+    </tr>
+    <tr>
+        <td align="center">摄像头</td>
+        <td align="center" colspan="2"> 1x 4通道 MIPI CSI 接口</td>
+    </tr>
+    <tr>
+        <td align="center">其他</td>
+        <td align="center" colspan="2">40 针脚扩展座</td>
+    </tr>
+        <tr>
+        <td align="center">供电</td>
+        <td align="center" colspan="2">支持 5V</td>
+    </tr>
+        <tr>
+        <td align="center">尺寸</td>
+        <td align="center" colspan="2">86 x 56 mm</td>
+    </tr>
+</table>
+
+## 文档使用指引
+
+:::tip
+除了下面的 **其他系统** 目录外，其他内容都是围绕 Radxa OS (Radxa 基于 Debian 定制的系统) 展开。
+:::
+
+### [快速上手](/rock5/rock5c/getting-started)
+
+介绍系统烧录，系统登录，配件使用等内容让用户能快速的上手使用。
+
+### [瑞莎系统](/rock5/rock5c/radxa-os)
+
+瑞莎系统 (Radxa OS) 是 Radxa 基于Debian OS 定制的一套操作系统，这里主要介绍 系统登录，网络连接等内容，
+方便用户快速的熟悉并使用系统。
+
+### [系统配置](/rock5/rock5c/os-config)
+
+介绍如何使用通过工具（例如rsetup）或者命令去使用设备或者功能。
+
+### [应用部署](/rock5/rock5c/apps-deployment)
+
+介绍类似 Samba, Docker, PVE, OMV, LAMP, Cheese, 远程控制等常见应用的配置及使用。
+
+### [应用开发](/rock5/rock5c/app-development)
+
+介绍上层应用开发，比如QT, WiringX, Mraa 等。
+
+### [硬件开发](/rock5/rock5c/hardware-design)
+
+介绍硬件信息，例如硬件接口，支持的配件等。
+
+### [底层开发](/rock5/rock5c/low-level-dev)
+
+介绍 uboot, kernel, debian os 编译打包等内容。
+
+### [其他系统](/rock5/rock5c/other-os)
+
+介绍非 Radxa OS的其他系统，例如 Android。
+
+### [配件列表](/rock5/rock5c/accessories)
+
+介绍支持的配件型号及使用说明。
diff --git a/docs/rock5/rock5c/accessories/README.md b/docs/rock5/rock5c/accessories/README.md
@@ -0,0 +1,9 @@
+---
+sidebar_position: 9
+---
+
+# 配件
+
+使用 ROCK 5C 配件。
+
+<DocCardList />
diff --git a/docs/rock5/rock5c/accessories/camera.md b/docs/rock5/rock5c/accessories/camera.md
@@ -0,0 +1,84 @@
+---
+sidebar_position: 4
+---
+
+# 摄像头
+
+目前支持以下几款摄像头:
+
+<table>
+  <tr>
+    <th>Camera Name</th>
+    <th>Sensor Type</th>
+    <th>Resolution</th>
+  </tr>
+  <tr>
+    <td>OKDO 5MP Camera</td>
+    <td>OV5647</td>
+    <td>5 megapixels</td>
+  </tr>
+  <tr>
+    <td>Radxa Camera 4K</td>
+    <td>IMX415</td>
+    <td>8.29 megapixels</td>
+  </tr>
+  <tr>
+    <td>Raspberry Pi Camera V2</td>
+    <td>IMX219</td>
+    <td>8 megapixels</td>
+  </tr>
+  <tr>
+    <td>Raspberry Pi Camera v1.3</td>
+    <td>OV5647</td>
+    <td>5 megapixels</td>
+  </tr>
+</table>
+
+## 配置
+
+以 Radxa Camera 4K 摄像头为例：
+
+<!-- ![Camera-4K 安装-01](/img/rock5c/accessories/camera/rock5c-with-4k-camera-FPC.webp)
+![Camera-4K 安装-02](/img/rock5c/accessories/camera/rock5c-4k-camera-connected.webp)
+![Camera-4K 安装-03](/img/rock5c/accessories/camera/rock5c-4k-camera.webp) -->
+
+- 准备好 Radxa Camera 4K，通过 FPC 线接上 ROCK 5C。
+
+- 通过左下角 Application Launcher 打开 Kconsole 终端, 运行 `rsetup` 命令。
+
+```bash
+radxa@rock-5c:~$ rsetup
+```
+
+通过[设备树配置](../os-config/rsetup#overlays)来启用瑞莎 4K 摄像头的 Overlay。
+
+:::caution [注意]
+
+1. 请启用 `[] Enable Radxa Camera 4K` 项 Overlay。
+2. 在启用成功显示 `[*] Enable Radxa Camera 4K` 后退出重启才能使配置生效。
+
+:::
+
+## 图像预览
+
+你也可以使用终端命令打开相机预览:
+
+```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
+```
+
+## 购买链接
+
+[Radxa Camera 4K](https://radxa.com/products/accessories/camera4k)
diff --git a/docs/rock5/rock5c/accessories/display.md b/docs/rock5/rock5c/accessories/display.md
@@ -0,0 +1,63 @@
+---
+sidebar_position: 3
+---
+
+# 显示屏
+
+目前支持的显示屏如下：
+
+<table>
+  <tr>
+    <th>Screen Name</th>
+    <th>分辨率</th>
+  </tr>
+  <tr>
+    <td>ALLNET 5 inch DSI Display</td>
+    <td>800 ×3(RGB) ×480 像素</td>
+  </tr>
+  <tr>
+    <td>Radxa Display 8 HD</td>
+    <td>800x1280 像素</td>
+  </tr>
+  <tr>
+    <td>Radxa Display 10HD</td>
+    <td>800x1280 像素</td>
+  </tr>
+  <tr>
+    <td>Radxa Display 10FHD</td>
+    <td>1200x1920 像素 </td>
+  </tr>
+  <tr>
+    <td>Raspberry Pi 7 inch Touchscreen</td>
+    <td>800 x 480 像素</td>
+  </tr>
+</table>
+
+## 配置
+
+以 `radxa 8hd display` 为例：
+
+<!-- ![显示屏安装-01](/img/rock5c/accessories/display/rock5c-display-8hd-FPC.webp)
+![显示屏安装-02](/img/rock5c/accessories/display/rock5c-display-8hd-connected.webp) -->
+
+- 准备好 Radxa Display 8HD 或者 Radxa Display 10HD，通过 FPC 线接上 ROCK 5C。
+
+- 通过左下角 Application Launcher 打开 Kconsole 终端, 运行 `rsetup` 命令：
+
+```bash
+radxa@rock-5c:~$ rsetup
+```
+
+- 通过[设备树配置](../os-config/rsetup#overlays)来启用瑞莎 8 寸触摸屏的 Overlay。
+
+:::caution [注意]
+
+1. 请启用 `[] Enable Radxa Display 8 HD` 项 Overlay。
+2. 在启用成功显示 `[*] Enable Radxa Display 8 HD` 后退出重启才能使配置生效。
+
+:::
+
+## 购买链接
+
+- [Radxa 8HD Display](https://radxa.com/products/accessories/display-8hd)
+- [Radxa 10FHD Display](https://radxa.com/products/accessories/display-10fhd)
diff --git a/docs/rock5/rock5c/accessories/emmc_module.md b/docs/rock5/rock5c/accessories/emmc_module.md
@@ -0,0 +1,38 @@
+---
+sidebar_position: 5
+---
+
+# eMMC 模块
+
+Radxa eMMC模块采用eMMC 5.1规范，提供四种容量选择： 16g / 32g / 64g / 128g。同时，你可以选择支持工业级长寿命的型号。此外，该模块支持JEDEC的标准eMMC命令集，并为高速读写而设计，使数据传输更快。
+
+![eMMC Module](/img/accessories/emmc-module.webp)
+
+## 读 / 写速度测试
+
+我们使用的eMMC芯片的是Foresee，由深圳嵌入式存储公司Longsys生产，他们在2017年收购了Lexar品牌。
+
+下面是我们对不同品牌的eMMC芯片做的测试。
+
+| Capacity | Brand       | Read    | Write    |
+| -------- | ----------- | ------- | -------- |
+| 8G       | Sandisk     | 270MB/s | 39.4MB/s |
+| 16G      | Sandisk     | 230MB/s | 79.6MB/s |
+| 16G      | Kingston    | 160MB/s | 50.1MB/s |
+| 16G      | **Foresee** | 189MB/s | 74.4MB/s |
+| 16G      | **Foresee** | 241MB/s | 79.5MB/s |
+| 32G      | Sandisk     | 263MB/s | 139MB/s  |
+| 32G      | Samsung     | 263MB/s | 78.3MB/s |
+| 32G      | Kingston    | 152MB/s | 87.2MB/s |
+| 64G      | Sandisk     | 207MB/s | 100MB/s  |
+| 64G      | **Foresee** | 215MB/s | 148MB/s  |
+| 64G      | **Foresee** | 194MB/s | 148MB/s  |
+| 128G     | Toshiba     | 217MB/s | 143MB/s  |
+
+## 规格
+
+- JEDEC 标准: v5.1
+- B2B连接器规格： GB042-34S-H10（插座-34针）+ GB042-30S-H10（插座-30针）
+- 存储选项：16G / 32G / 64G / 128G
+- 兼容性: 兼容 ROCK 3A / 3B / 3C / 4A / 4B / 4C / 4C PLUS / 4SE / 5A / 5B
+- 尺寸：13mm x 18mm x 1.5mm
diff --git a/docs/rock5/rock5c/accessories/emmc_reader.md b/docs/rock5/rock5c/accessories/emmc_reader.md
@@ -0,0 +1,23 @@
+---
+sidebar_position: 3
+---
+
+# Radxa eMMC Reader
+
+Radxa eMMC USB3读卡器是一款真正具有USB3.0性能的eMMC读卡器。基于GL3227E芯片设计。GL3227E是一个USB 3.1 Gen1 eMMC控制器，它提供单一的LUN（逻辑单元编号），可以支持eMMC v5.0、1/4/8bit数据总线、高速SDR /高速DDR / HS200 / HS400模式。
+
+![eMMC Reader](/img/accessories/emmc-reader.webp)
+
+## 特征
+
+- 高速 USB3.1 Gen2 GL3227E 控制器
+- 支持 eMMC HS400 模式
+- 稳固的双 B2B 连接座固定
+- 支持 Radxa eMMC 模块，最高可达 256GB
+- 兼容 Odroid / PINE64 eMMC 模块
+- 支持 Linux / Windows / MacOS 主机
+- 支持 GPT 分区表和固件
+
+## 尺寸
+
+- 大小: 55 x 20 x 5 mm
diff --git a/docs/rock5/rock5c/accessories/pd-30w.md b/docs/rock5/rock5c/accessories/pd-30w.md
@@ -0,0 +1,5 @@
+import Content from '../../../common/accessories/\_pd-30w.mdx'
+
+# Radxa Power PD 30W
+
+<Content />