Merge pull request #850 from EESN-W/rock5t

fix: modify rock5t nvme boot detail

Author: jack-ma

.github/CODEOWNERS

@@ -374,3 +374,4 @@ docs/e/e24c/README.md @jack-ma
 i18n/en/docusaurus-plugin-content-docs/current/orion/o6/bios/install-bios.md @melooooooooooo
 docs/orion/o6/app-development/artificial-intelligence/npu-introduction.md @vamrs-feng
 docs/common/radxa-os/_autologin.mdx @Ken-Vamrs
+docs/common/dev/_nvme.mdx @nascs

docs/common/dev/_nvme.mdx

@@ -1,30 +1,32 @@
 import { Image } from "@site/src/utils/docs";
 import { PreView } from "@site/src/utils/docs";
 
-### 整体步骤：
+## 整体步骤
 
-- 准备一张 SD 卡或者 eMMC Module， 充当启动盘
+- 准备一张 MicroSD 卡充当启动盘
 
 - 使用系统工具 rsetup 刷 SPI
 
 - 将系统镜像刷到 NVME SSD 里面
 
-- 拔掉 SD 卡, 从 NVME 启动
+- 拔掉 MicroSD 卡, 从 NVME 启动
 
-### 准备一张 SD 卡或者 eMMC Module， 充当启动盘
+## 正常启动系统
 
-参考<a href={props.etcher_path}>制作 MicroSD 启动盘部分</a>将系统安装在 SD 卡 当中。
+参考 <a href={props.etcher_path}>制作 MicroSD 启动盘部分</a> 将系统安装在 MicroSD 卡 当中。
 
-这里 SD 卡 的作用相当于 x86 的启动盘，目的是拿到 spi.img， 将 spi.img 刷到 spi flash 中。
+这里 MicroSD 卡 的作用相当于 x86 的启动盘，目的是拿到 spi.img， 将 spi.img 刷到 spi flash 中。
 
-从 SD 卡 启动后，执行一下命令以更新系统:
+从 MicroSD 卡 启动后，执行一下命令以更新系统:
 
 ```
 sudo apt-get update
 sudo apt-get full-upgrade
 ```
 
-### 使用系统工具 <a href={props.rsetup_path}> rsetup </a> 刷 SPI
+## 使用系统工具 <a href={props.rsetup_path}> rsetup </a> 刷 SPI
+
+选择`System Maintenance` 选项：
 
 <img
   src="/img/common/nvme/system_maintenance.webp"
@@ -33,24 +35,30 @@ sudo apt-get full-upgrade
   alt="system maintenance"
 />
 
+选择`Update SPI Bootloader` 选项：
+
 <img
   src="/img/common/nvme/update_spi_bootloader.webp"
   width="700"
   alt="update spi bootloader"
 />
 
+选择菜单栏候选框的文选项，然后按照提示更新 SPI Flash：
+
 <Image
   src="/img/common/nvme/rsetup-select-bootloader-#model#.webp"
   model={props.model}
   fallback={props.model}
   width="700"
 />
 
+等待更新完成。
+
 <img src="/img/common/nvme/writing_mtd.webp" width="700" alt="writing to mtd" />
 
 <img src="/img/common/nvme/success.webp" width="700" alt="success" />
 
-### 将系统镜像刷到 NVME SSD 里面
+## 将系统镜像刷到 NVME SSD 里面
 
 将 NVME SSD 插入到板子上，确认 NVME 是否被系统识别，
 
@@ -70,7 +78,13 @@ sudo apt-get full-upgrade
 
 如上所示系统已经识别到 NVME SSD 即 nvme0n1（在 Linux 中，NVMe 设备通常被识别为 nvmeXnY）
 
-从<a href={props.download_path}>资源下载汇总</a>下载系统镜像，将系统镜像拷贝到当前系统下。
+从<a href={props.download_path}>资源下载汇总</a>下载系统镜像到主板上，我这里演示使用 `wget` 命令在主板上下载系统镜像，其中网址链接可以进入<a href={props.download_path}>资源下载汇总</a>页面复制。
+
+:::tip 其他下载系统镜像方法
+
+1. 直接在主板访问 <a href={props.download_path}>资源下载汇总</a> 页面，然后通过浏览器下载系统镜像。
+2. 下载系统镜像在 PC 上，然后使用 U 盘或者在线传输（如 FTP、SCP 等）的方式将系统镜像文件复制到主板上。
+   :::
 
 <PreView
   params={{
@@ -80,13 +94,16 @@ sudo apt-get full-upgrade
   }}
 >
   {`
-  PC Host: scp  /path/to/img radxa@boardIP:/home/radxa/
-  例如：
-  scp ~/Download/#model#_xx.img.xz [email protected]:/home/radxa/
+# 安装 wget
+sudo apt-get install wget
+# 下载系统镜像文件
+wget [URL]
   `}
 </PreView>
 
-然后在**板子**上将系统镜像 dd 到 NVME 中。
+- wget : 下载文件，将 [URL] 替换成实际下载链接。
+
+然后在**主板**上使用 `dd` 命令将系统镜像写入 NVME SSD 中。
 
 <PreView
   params={{
@@ -96,13 +113,18 @@ sudo apt-get full-upgrade
   }}
 >
   {`
-  On Board：
   sudo xzcat /path/to/img | sudo dd of=/path/to/nvme bs=1M status=progress
-  例如：
+  示例：
   sudo xzcat /home/radxa/#model#_xx.img.xz | sudo dd of=/dev/nvme0n1 bs=1M status=progress
   `}
 </PreView>
 
-### 拔掉 SD 卡, 从 NVME 启动
+- xzcat : 解压 xz 格式的系统镜像文件
+- dd : 复制并写入到 NVMe SSD 设备（⚠️注意：使用 `dd` 命令时请确认设备名称，错误的设备名可能导致数据丢失）
+- of=/dev/nvme0n1 : 指定写入的设备为 nvme0n1（可以根据实际情况修改）
+- bs=1M : 指定写入的块大小为 1M，提高写入速度
+- status=progress : 显示写入进度，让您了解写入状态
+
+## 拔掉 SD 卡, 从 NVME 启动
 
 拔掉 SD 卡后，使用 {props.pwr} 电源适配器上电，然后系统开始从 NVME 中启动，HDMI显示桌面。

i18n/en/docusaurus-plugin-content-docs/current/common/dev/_nvme.mdx

@@ -1,90 +1,94 @@
 import { Image } from "@site/src/utils/docs";
 import { PreView } from "@site/src/utils/docs";
 
-### Overall steps:
+## Overall Steps
 
-- Prepare an SD card or eMMC Module as a boot disk.
+- Prepare a MicroSD card as a boot disk
 
-- Use the system utility rsetup to flash the SPI.
+- Use the system tool rsetup to flash SPI
 
-- Flash the system image to the NVME SSD.
+- Flash the system image to the NVMe SSD
 
-- Unplug the SD card and boot from NVME.
+- Remove the MicroSD card and boot from NVMe
 
-### Prepare an SD card or eMMC Module as a boot disk.
+## Booting the System Normally
 
-Refer to the section on <a href={props.etcher_path}> making a MicroSD boot disc </a> to install the system on the SD card.
+Refer to the <a href={props.etcher_path}>Create MicroSD Boot Disk</a> section to install the system on a MicroSD card.
 
-Here the SD card acts as a boot disk for x86, the purpose is to get the spi.img, and flash the spi.img to the spi flash.
+The MicroSD card here serves a similar purpose to a boot disk in x86 systems, which is to obtain spi.img and flash it to the SPI flash.
 
-After booting from the SD card, execute the following command to update the system.
+After booting from the MicroSD card, run the following commands to update the system:
 
 ```
 sudo apt-get update
 sudo apt-get full-upgrade
 ```
 
-### Use the system utility <a href={props.rsetup_path}> rsetup </a> to flash the SPI.
+## Using System Tool <a href={props.rsetup_path}>rsetup</a> to Flash SPI
+
+Select the `System Maintenance` option:
 
 <img
-  src="/img/common/nvme/system_maintenance.webp"
+  src="/en/img/common/nvme/system_maintenance.webp"
   width="700"
   height="500"
   alt="system maintenance"
 />
 
+Select the `Update SPI Bootloader` option:
+
 <img
-  src="/img/common/nvme/update_spi_bootloader.webp"
+  src="/en/img/common/nvme/update_spi_bootloader.webp"
   width="700"
   alt="update spi bootloader"
 />
 
+Select the bootloader option from the menu, then follow the prompts to update the SPI Flash:
+
 <Image
-  src="/img/common/nvme/rsetup-select-bootloader-#model#.webp"
+  src="/en/img/common/nvme/rsetup-select-bootloader-#model#.webp"
   model={props.model}
   fallback={props.model}
   width="700"
 />
 
-<img src="/img/common/nvme/writing_mtd.webp" width="700" alt="writing to mtd" />
+Wait for the update to complete.
 
-<img src="/img/common/nvme/success.webp" width="700" alt="success" />
+<img
+  src="/en/img/common/nvme/writing_mtd.webp"
+  width="700"
+  alt="writing to mtd"
+/>
+
+<img src="/en/img/common/nvme/success.webp" width="700" alt="success" />
 
-### Flashing the system image to the NVME SSD
+## Flashing the System Image to NVMe SSD
 
-Insert the NVME SSD into the board and verify that the NVME is recognized by the system,
+Insert the NVMe SSD into the board and verify that the system recognizes it,
 
 <PreView params={{ model: props.model }}>
   {`
   radxa@#model#:~$ lsblk
-  NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT
-  mmcblk0 179:0 0 14.5G 0 disk
-  ├─mmcblk0p1 179:1 0 16M 0 part /config
-  └─mmcblk0p2 179:2 0 14.4G 0 part /config
-  mmcblk0boot0 179:32 0 4M 1 disk
-  mmcblk0boot1 179:64 0 4M 1 disk
-  zram0 254:0 0 3.8G 0 disk [SWAP]
-  nvme0n1 259:0 0 238.5G 0 disk
+  NAME         MAJ:MIN RM   SIZE RO TYPE MOUNTPOINT
+  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]
+  nvme0n1      259:0    0 238.5G  0 disk
   `}
 </PreView>
 
-As shown above the system already recognizes the NVME SSD as nvme0n1 (in Linux NVMe devices are usually recognized as nvmeXnY)
+As shown above, the system has recognized the NVMe SSD as nvme0n1 (in Linux, NVMe devices are typically recognized as nvmeXnY)
 
-Download the following system image to your PC,
+Download the system image to the board from the <a href={props.download_path}>Resource Download</a>. Here we'll demonstrate using the `wget` command to download the system image on the board. You can copy the URL from the <a href={props.download_path}>Resource Download</a> page.
 
-<PreView
-  params={{
-    model: props.model,
-    release_num: props.release_num,
-    desktop: props.desktop,
-  }}
->
-  {`
-https://github.com/radxa-build/#model#/releases/download/#release_num#/#model#_debian_bullseye_#desktop#_#release_num#.img.xz
-`}
-</PreView>
+:::tip Alternative Methods to Download System Image
 
-Copy the system image to the current system,
+1. Access the <a href={props.download_path}>Resource Download</a> directly on the board and download the system image through the browser.
+2. Download the system image on your PC, then transfer it to the board using a USB drive or online transfer (such as FTP, SCP, etc.).
+   :::
 
 <PreView
   params={{
@@ -94,13 +98,16 @@ Copy the system image to the current system,
   }}
 >
   {`
-  PC Host: scp  /path/to/img radxa@boardIP:/home/radxa/
-  eg:
-  scp ~/Download/#model#_debian_bullseye_#desktop#_#release_num#.img.xz [email protected]:/home/radxa/
+# Install wget
+sudo apt-get install wget
+# Download system image
+wget [URL]
   `}
 </PreView>
 
-Then dd the system image into NVME on the **board**.
+- wget : Download files, replace [URL] with the actual download link.
+
+Then use the `dd` command on the **board** to write the system image to the NVMe SSD.
 
 <PreView
   params={{
@@ -110,13 +117,18 @@ Then dd the system image into NVME on the **board**.
   }}
 >
   {`
-  On Board：
-  sudo xzcat /path/to/img | dd of=/path/to/nvme bs=1M status=progress
-  eg:
-  sudo xzcat /home/radxa/#model#_debian_bullseye_#desktop#_#release_num#.img.xz | sudo dd of=/dev/nvme0n1 bs=1M status=progress
+  sudo xzcat /path/to/img | sudo dd of=/path/to/nvme bs=1M status=progress
+  Example:
+  sudo xzcat /home/radxa/#model#_xx.img.xz | sudo dd of=/dev/nvme0n1 bs=1M status=progress
   `}
 </PreView>
 
-### Unplug the SD card and boot from NVME
+- xzcat : Decompress the xz-format system image file
+- dd : Copy and write to the NVMe SSD device (⚠️Warning: Verify the device name when using the `dd` command, as incorrect device names may cause data loss)
+- of=/dev/nvme0n1 : Specify the target device as nvme0n1 (can be modified according to actual situation)
+- bs=1M : Set the block size to 1M to improve write speed
+- status=progress : Show write progress to monitor the status
+
+## Remove SD Card and Boot from NVMe
 
-After removing the SD card, power up the system using the {props.pwr} power adapter, then the system starts booting from NVME and HDMI displays the desktop.
+After removing the SD card, power on the device using the {props.pwr} power adapter. The system will then boot from the NVMe drive, and the desktop will be displayed via HDMI.