Merge pull request #1041 from EESN-W/rock4d

feat: rock 4d mipi csi interface parameter and use tutorial

Author: jack-ma

docs/rock4/rock4d/hardware-use/mipi-csi.md

@@ -15,7 +15,57 @@ sidebar_position: 7
 
 ## 支持列表
 
-目前正在适配摄像头模块，后续会更新支持的摄像头模块列表。
+| 主板    | CSI 摄像头                                                              | 说明             |
+| ------- | ----------------------------------------------------------------------- | ---------------- |
+| ROCK 4D | [Camera 4K](https://radxa.com/products/accessories/camera4k)            |                  |
+| ROCK 4D | [Camera 13M 214](https://radxa.com/products/accessories/camera-13m-214) | 彩色预览效果较差 |
+| ROCK 4D | [Camera 8M 219](https://radxa.com/products/accessories/camera-8m-219)   | 彩色预览效果较差 |
+
+## 硬件连接
+
+使用主板的 MIPI CSI 接口连接摄像头，连接方式如下：以 4-lane MIPI CSI 接口连接 Camera 4K 为例
+
+①： 连接主板的 MIPI CSI 接口，金手指（金属接触点）朝向主板方向
+
+②： 连接摄像头的接口，金手指（金属接触点）朝向摄像头方向
+
+<div style={{textAlign: 'center'}}>
+  <img src="/img/rock4/4d/rock4d-mipi-csi.webp" style={{width: '100%', maxWidth: '1200px'}} alt="Camera 4K MIPI CSI Interface" />
+</div>
+
+## 软件使能
+
+在终端命令行输入 `rsetup` 命令，使用 Rsetup 工具设置摄像头选项。
+
+<NewCodeBlock tip="radxa@device$" type="device">
+
+```
+rsetup
+```
+
+</NewCodeBlock>
+
+1. 通过方向键选择 Overlays 选项，然后按回车键确认选择。
+
+<div style={{ textAlign: "center" }}>
+  <img
+    src="/img/common/radxa-os/system-config/rsetup-overlays.webp"
+    style={{ width: "100%", maxWidth: "1200px" }}
+  />
+</div>
+
+2. 通过方向键选择 Manage overlays 选项，然后按回车键确认选择。
+
+<div style={{ textAlign: "center" }}>
+  <img
+    src="/img/common/radxa-os/system-config/rsetup-overlays-manage.webp"
+    style={{ width: "100%", maxWidth: "1200px" }}
+  />
+</div>
+
+3. 通过方向键选择对应的 Camera 选项，按空格键并出现 `*` 代表启用该功能，然后回车键确认选择。
+
+4. 重启系统，配置生效。
 
 ## 接口规格
 
@@ -27,6 +77,11 @@ sidebar_position: 7
 
 <TabItem value="4-lane MIPI CSI">
 
+- 4-lane MIPI CSI 接口规格
+  - 型号：FH35C-31S-0.3SHW（50）
+  - 引脚间距：0.3mm
+  - 引脚数：31 Pin
+
 | Pin# | Name                   | Pin# | Name                      | Pin# | Name                  |
 | :--: | :--------------------- | :--: | :------------------------ | :--: | :-------------------- |
 |  1   | GND                    |  12  | MIPI_DPHY_CSI1_RX_D1P     |  23  | MIPI_CSI0_PDN1_H      |
@@ -45,6 +100,11 @@ sidebar_position: 7
 
 <TabItem value="2-lane MIPI CSI">
 
+- 2-lane MIPI CSI 接口规格
+  - 型号：FPC1030-15S-TAG
+  - 引脚间距：1 mm
+  - 引脚数：15 Pin
+
 | Pin# | Name                      | Pin# | Name                    | Pin# | Name                  |
 | :--: | :------------------------ | :--: | :---------------------- | :--: | :-------------------- |
 |  1   | VCC_3V3_S0                |  11  | GND                     |  21  | MIPI_DPHY_CSI0_RX_D1N |

i18n/en/docusaurus-plugin-content-docs/current/rock4/rock4d/hardware-use/mipi-csi.md

@@ -15,7 +15,57 @@ The two MIPI CSI interfaces include a 4-lane (4-channel) MIPI CSI and a 2-lane (
 
 ## Supported Cameras
 
-Camera module compatibility is currently being tested. A list of supported camera modules will be updated in the future.
+| Board   | CSI Camera                                                              | Notes                          |
+| ------- | ----------------------------------------------------------------------- | ------------------------------ |
+| ROCK 4D | [Camera 4K](https://radxa.com/products/accessories/camera4k)            |                                |
+| ROCK 4D | [Camera 13M 214](https://radxa.com/products/accessories/camera-13m-214) | Color preview is being adapted |
+| ROCK 4D | [Camera 8M 219](https://radxa.com/products/accessories/camera-8m-219)   | Color preview is being adapted |
+
+## Hardware Connection
+
+Use the board's MIPI CSI interface to connect the camera. The connection method is as follows: taking the 4-lane MIPI CSI interface connecting Camera 4K as an example
+
+①: Connect to the board's MIPI CSI interface, with the gold fingers (metal contacts) facing towards the board
+
+②: Connect to the camera's interface, with the gold fingers (metal contacts) facing towards the camera
+
+<div style={{textAlign: 'center'}}>
+  <img src="/en/img/rock4/4d/rock4d-mipi-csi.webp" style={{width: '100%', maxWidth: '1200px'}} alt="Camera 4K MIPI CSI Interface" />
+</div>
+
+## Software Enable
+
+Enter `rsetup` command in the terminal command line, and use the Rsetup tool to configure camera options.
+
+<NewCodeBlock tip="radxa@device$" type="device">
+
+```
+rsetup
+```
+
+</NewCodeBlock>
+
+1. Use the arrow keys to select the Overlays option, then press Enter to confirm the selection.
+
+<div style={{ textAlign: "center" }}>
+  <img
+    src="/en/img/common/radxa-os/system-config/rsetup-overlays.webp"
+    style={{ width: "100%", maxWidth: "1200px" }}
+  />
+</div>
+
+2. Use the arrow keys to select the Manage overlays option, then press Enter to confirm the selection.
+
+<div style={{ textAlign: "center" }}>
+  <img
+    src="/en/img/common/radxa-os/system-config/rsetup-overlays-manage.webp"
+    style={{ width: "100%", maxWidth: "1200px" }}
+  />
+</div>
+
+3. Use the arrow keys to select the corresponding Camera option, press the space key to enable the function (indicated by `*`), then press Enter to confirm the selection.
+
+4. Restart the system for the configuration to take effect.
 
 ## Interface Specifications
 
@@ -27,6 +77,11 @@ For detailed interface specifications, please refer to the [Hardware Design: Sch
 
 <TabItem value="4-lane MIPI CSI">
 
+- 4-lane MIPI CSI Interface Specifications
+  - Model: FH35C-31S-0.3SHW (50)
+  - Pin Pitch: 0.3mm
+  - Pin Count: 31 Pin
+
 | Pin# | Name                   | Pin# | Name                      | Pin# | Name                  |
 | :--: | :--------------------- | :--: | :------------------------ | :--: | :-------------------- |
 |  1   | GND                    |  12  | MIPI_DPHY_CSI1_RX_D1P     |  23  | MIPI_CSI0_PDN1_H      |
@@ -45,6 +100,11 @@ For detailed interface specifications, please refer to the [Hardware Design: Sch
 
 <TabItem value="2-lane MIPI CSI">
 
+- 2-lane MIPI CSI Interface Specifications
+  - Model: FPC1030-15S-TAG
+  - Pin Pitch: 1 mm
+  - Pin Count: 15 Pin
+
 | Pin# | Name                      | Pin# | Name                    | Pin# | Name                  |
 | :--: | :------------------------ | :--: | :---------------------- | :--: | :-------------------- |
 |  1   | VCC_3V3_S0                |  11  | GND                     |  21  | MIPI_DPHY_CSI0_RX_D1N |