feat: add penta-sata-hat for 5a

docs/rock5/rock5a/getting-started/interface-usage/penta-sata-hat.md

@@ -0,0 +1,135 @@
+---
+sidebar_position: 10
+---
+
+# Penta SATA HAT 使用教程
+
+## 准备工作
+
+- 图片为带 Radxa PENTA SATA HAT 的 ROCK 5A。
+
+![ROCK5A Install Penta SATA HAT](/img/rock5a/rock5a-penta-sata-hat-05.webp)
+
+- 下图是 [RADXA Penta SATA HAT](/accessories/penta-sata-hat) 和包含的零件。
+
+![ROCK5A Install M.2 Extension Board](/img/accessories/penta-sata-hat-01.webp)
+
+- 请先区分 IPEX 线缆的正反面。 如图所示。 **我们为 ROCK5A 提供的 IPEX 线的两端方向相同。**
+
+![ROCK5A Install M.2 Extension Board](/img/accessories/m2-extension-board-04.webp)
+
+- 请注意，环扣需要卡入连接器中。
+
+![E key to M key](/img/accessories/ekey-to-mkey-01.webp)
+
+## 安装教程
+
+### 步骤
+
+1、M.2 E key to M.2 M key Board带 IPEX 电缆。 **注意这里安装的IPEX线是正面朝上的，环扣需要卡在接口上，确保固定。**
+
+![ROCK5A Install M.2 Extension Board](/img/accessories/m2-extension-board-02.webp)
+
+2、Radxa Penta SATA HAT 主板，带 IPEX 电缆。 **注意这里安装的IPEX线是正面朝上的，环扣需要卡在接口上，确保固定。**
+
+![ROCK5A Install Penta SATA HAT](/img/rock5a/rock5a-penta-sata-hat-04.webp)
+
+3、请将产品附带的M2.5x18+6铜柱和M2.5x5铜柱安装在ROCK5A上，如图所示。
+
+![ROCK5A Install M.2 Extension Board](/img/rock5a/rock5a-m2-extension-board-04.webp)
+
+4、请将 IPEX 线的一端连接到 M.2 E key to M Key board，另一端连接到 Radxa Penta SATA HAT 并将 M.2 E key to M key board 安装到 M.2 E key ROCK5A 的连接器。 如图所示。
+
+![ROCK5A Install Penta SATA HAT](/img/rock5a/rock5a-penta-sata-hat-03.webp)
+
+5、最后，使用 M2.5x5+5 铜柱组装 Radxa Penta SATA HAT。
+
+![ROCK5A Install Penta SATA HAT](/img/rock5a/rock5a-penta-sata-hat-01.webp)
+![ROCK5A Install Penta SATA HAT](/img/rock5a/rock5a-penta-sata-hat-02.webp)
+
+### 检查 Penta SATA HAT 挂载状态
+
+1、通过`lsblk`查看SATA设备是否被识别。
+
+```
+radxa@rock-5a:~$ lsblk
+NAME         MAJ:MIN RM   SIZE RO TYPE MOUNTPOINT
+sda            8:0    0 465.8G  0 disk
+└─sda1         8:1    0 465.8G  0 part
+sdb            8:16   0 465.8G  0 disk
+└─sdb1         8:17   0 465.8G  0 part
+sdc            8:32   0 465.8G  0 disk
+└─sdc1         8:33   0 465.8G  0 part
+sdd            8:48   0 465.8G  0 disk
+└─sdd1         8:49   0 465.8G  0 part
+mmcblk0      179:0    0  14.5G  0 disk
+├─mmcblk0p1  179:1    0    16M  0 part /config
+└─mmcblk0p2  179:2    0  14.4G  0 part /
+mmcblk0boot0 179:32   0     4M  1 disk
+mmcblk0boot1 179:64   0     4M  1 disk
+zram0        254:0    0   3.8G  0 disk [SWAP]
+radxa@rock-5a:~$
+```
+
+2、当系统识别到Penta SATA HAT时，你可以查看到 SATA devices(sda/sdb/sdc/sdd)。
+
+## 软件支持
+
+我们提供了一个安装脚本来帮助您安装我们提供的软件，它能让 Penta 顶板显示信息和控制风扇。
+
+```
+curl -sL https://rock.sh/get-rockpi-penta | sudo -E bash -
+```
+
+只需复制上面的命令并将其粘贴到终端并按回车键即可。
+
+### 软件配置
+
+编辑 /etc/rockpi-penta.conf, 并使用下面的命令使它生效。
+
+```
+sudo systemctl restart rockpi-penta.service
+```
+
+### 默认配置
+
+下面是 /etc/rockpi-penta.conf 的默认配置，你可以根据注释进行修改。
+
+```
+[fan]
+# When the temperature is above lv0 (35'C), the fan at 25% power,
+# and lv1 at 50% power, lv2 at 75% power, and lv3 at 100% power.
+# When the temperature is below lv0, the fan is turned off.
+# You can change these values if necessary.
+lv0 = 35
+lv1 = 40
+lv2 = 45
+lv3 = 50
+
+[key]
+# You can customize the function of the key, currently available functions are
+# slider: oled display next page
+# switch: fan turn on/off switch
+# reboot, poweroff
+# If you have any good suggestions for key functions,
+# please add an issue on https://rock.sh/rockpi-sata
+click = slider
+twice = switch
+press = none
+
+[time]
+# twice: maximum time between double clicking (seconds)
+# press: long press time (seconds)
+twice = 0.7
+press = 1.8
+
+[slider]
+# Whether the oled auto display next page and the time interval (seconds)
+auto = true
+time = 10
+
+[oled]
+# Whether rotate the text of oled 180 degrees, whether use Fahrenheit
+rotate = false
+f-temp = false
+```

i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5a/getting-started/interface-usage/penta-sata-hat.md

@@ -0,0 +1,137 @@
+---
+sidebar_position: 10
+---
+
+# Penta SATA HAT Usage Tutorial
+
+## Preparation
+
+- Picture of ROCK 5A with Radxa PENTA SATA HAT.
+
+![ROCK5A Install Penta SATA HAT](/img/rock5a/rock5a-penta-sata-hat-05.webp)
+
+- The following pictures show the [RADXA Penta SATA HAT](/accessories/penta-sata-hat) and the parts included.
+
+![ROCK5A Install M.2 Extension Board](/img/accessories/penta-sata-hat-01.webp)
+
+- Please distinguish between the front and back side of the IPEX cable. As shown in the figure.
+
+**The IPEX cables we provide for the ROCK5A have the same direction at both ends.**
+
+![ROCK5A Install M.2 Extension Board](/img/accessories/m2-extension-board-04.webp)
+
+- Please note that the ring clips need to snap into the connectors.
+
+![E key to M key](/img/accessories/ekey-to-mkey-01.webp)
+
+## Installation Tutorial
+
+### Steps
+
+1, M.2 E key to M.2 M key Board with IPEX cable. **Note that the IPEX cable is installed here with the front side up, and the ring clips need to snap onto the connector to ensure that it is fixed.**
+
+![ROCK5A Install M.2 Extension Board](/img/accessories/m2-extension-board-02.webp)
+
+2. Radxa Penta SATA HAT motherboard with IPEX cable. **Note that the IPEX cable installed here is face up, and the ring clips need to snap onto the connector to ensure fixation.**
+
+![ROCK5A Install Penta SATA HAT](/img/rock5a/rock5a-penta-sata-hat-04.webp)
+
+3. Please install the M2.5x18+6 copper post and M2.5x5 copper post supplied with the product on the ROCK5A as shown in the picture.
+
+![ROCK5A Install M.2 Extension Board](/img/rock5a/rock5a-m2-extension-board-04.webp)
+
+4. Please connect one end of the IPEX cable to the M.2 E key to M Key board and the other end to the Radxa Penta SATA HAT and install the M.2 E key to M key board to the connector of the M.2 E key ROCK5A. As shown in the figure.
+
+![ROCK5A Install Penta SATA HAT](/img/rock5a/rock5a-penta-sata-hat-03.webp)
+
+5. Finally, assemble the Radxa Penta SATA HAT using M2.5x5+5 copper posts.
+
+![ROCK5A Install Penta SATA HAT](/img/rock5a/rock5a-penta-sata-hat-01.webp)
+![ROCK5A Install Penta SATA HAT](/img/rock5a/rock5a-penta-sata-hat-02.webp)
+
+### Checking the Penta SATA HAT mount status
+
+1. Check if the SATA device is recognized by `lsblk`.
+
+```
+radxa@rock-5a:~$ lsblk
+NAME         MAJ:MIN RM   SIZE RO TYPE MOUNTPOINT
+sda            8:0    0 465.8G  0 disk
+└─sda1         8:1    0 465.8G  0 part
+sdb            8:16   0 465.8G  0 disk
+└─sdb1         8:17   0 465.8G  0 part
+sdc            8:32   0 465.8G  0 disk
+└─sdc1         8:33   0 465.8G  0 part
+sdd            8:48   0 465.8G  0 disk
+└─sdd1         8:49   0 465.8G  0 part
+mmcblk0      179:0    0  14.5G  0 disk
+├─mmcblk0p1  179:1    0    16M  0 part /config
+└─mmcblk0p2  179:2    0  14.4G  0 part /
+mmcblk0boot0 179:32   0     4M  1 disk
+mmcblk0boot1 179:64   0     4M  1 disk
+zram0        254:0    0   3.8G  0 disk [SWAP]
+radxa@rock-5a:~$
+```
+
+2. When the system recognizes the Penta SATA HAT, you can view the SATA devices (sda/sdb/sdc/sdd).
+
+## Software Support
+
+We provide an installation script to help you install the software we provide that enables the Penta top panel to display information and control fans.
+
+```
+curl -sL https://rock.sh/get-rockpi-penta | sudo -E bash -
+```
+
+Simply copy the above command and paste it into the terminal and press enter.
+
+### Software configuration
+
+Edit /etc/rockpi-penta.conf, and enable it with the following command.
+
+```
+sudo systemctl restart rockpi-penta.service
+```
+
+### Default configuration
+
+The following is the default configuration of /etc/rockpi-penta.conf, which you can modify according to the comments.
+
+```
+[fan]
+# When the temperature is above lv0 (35'C), the fan at 25% power,
+# and lv1 at 50% power, lv2 at 75% power, and lv3 at 100% power.
+# When the temperature is below lv0, the fan is turned off.
+# You can change these values if necessary.
+lv0 = 35
+lv1 = 40
+lv2 = 45
+lv3 = 50
+
+[key]
+# You can customize the function of the key, currently available functions are
+# slider: oled display next page
+# switch: fan turn on/off switch
+# reboot, poweroff
+# If you have any good suggestions for key functions,
+# please add an issue on https://rock.sh/rockpi-sata
+click = slider
+twice = switch
+press = none
+
+[time]
+# twice: maximum time between double clicking (seconds)
+# press: long press time (seconds)
+twice = 0.7
+press = 1.8
+
+[slider]
+# Whether the oled auto display next page and the time interval (seconds)
+auto = true
+time = 10
+
+[oled]
+# Whether rotate the text of oled 180 degrees, whether use Fahrenheit
+rotate = false
+f-temp = false
+```