Merge pull request #861 from EESN-W/rock5t

fix: modify rock5t emmc boot system

Author: jack-ma

docs/rock5/rock5t/getting-started/install-os/emmc_boot.md

@@ -2,12 +2,12 @@
 sidebar_position: 3
 ---
 
-# 安装系统到 eMMC 模块
+# 安装系统到 eMMC
 
-若您的瑞莎 ROCK 5T 板载 eMMC 模块，您可以在 MicroSD 卡启动主板的情况下，使用 `dd` 命令将系统镜像写入 eMMC 模块。
+若您的瑞莎 ROCK 5T 板载 eMMC，您可以在 MicroSD 卡启动主板的情况下，使用 `dd` 命令将系统镜像写入 eMMC。
 
 :::tip 注意事项
-安装系统会格式化 eMMC 模块，如果有重要数据请提前备份！
+安装系统会格式化 eMMC，如果有重要数据请提前备份！
 
 若您的系统目前还无法通过 MicroSD 卡启动，可以参考 [安装系统到 MicroSD 卡](./boot_from_sd_card.md) 教程。
 :::
@@ -20,7 +20,7 @@ sidebar_position: 3
 - 系统启动介质：MicroSD 卡
 - 电源适配器：标准 DC 12V/2A 电源适配器（DC-5525 接口）
 
-我们需要基于 MicroSD 卡启动主板系统，进入主板系统后下载系统镜像文件，然后使用 `dd` 命令将系统镜像写入 eMMC 模块。
+我们需要基于 MicroSD 卡启动主板系统，进入主板系统后下载系统镜像文件，然后使用 `dd` 命令将系统镜像写入 eMMC。
 
 :::tip 推荐配件
 瑞莎 ROCK 5T 仅支持 12V 电源输入，建议电流 2A 及以上，以确保所有外设稳定运行。
@@ -41,11 +41,14 @@ sidebar_position: 3
 
 您可以复制 [资源汇总下载](../../download) 页面的系统镜像文件链接，然后在主板上使用 `wget` 命令下载。
 
+<NewCodeBlock tip="radxa@device$" type="device">
 ```
 sudo apt install wget
 wget [url]
+# 示例
+wget https://github.com/radxa-build/rock-5t/releases/download/rsdk-b2/rock-5t_bookworm_kde_b2.output.img.xz
 ```
-
+</NewCodeBlock>
 参数解释：其中 `[url]` 需要替换成实际的系统镜像文件下载链接。
 
 - PC 下载
@@ -56,15 +59,29 @@ wget [url]
 
 ## 安装系统
 
-使用 `dd` 命令安装系统镜像到 eMMC 模块。
+使用 `dd` 命令安装系统镜像到 eMMC。
 
 :::tip 说明
 下载的系统镜像文件是压缩包，需要解压后才能使用。
 :::
 
+### 解压系统镜像
+
+使用 `unxz` 命令解压系统镜像文件。
+
+<NewCodeBlock tip="radxa@device$" type="device">
+```
+sudo apt install xz-utils
+unxz [image_path]
+# 示例
+unxz ~/rock-5t_bookworm_kde_b2.output.img.xz
+```
+</NewCodeBlock>
+参数解释：其中 `[image_path]` 需要替换成实际的系统镜像文件路径。
+
 ### 写入系统镜像
 
-将解压的系统镜像文件使用 `dd` 命令写入 eMMC 模块。
+将解压的系统镜像文件使用 `dd` 命令写入 eMMC。
 
 :::danger
 使用 `dd` 命令时，请确保选择正确的设备文件，否则会格式化错误的设备，造成数据丢失！
@@ -73,11 +90,16 @@ wget [url]
 <NewCodeBlock tip="radxa@device$" type="device">
 ```
 sudo dd if=[image_path] of=/dev/mmcblk0 bs=4M status=progress
+
+# 示例
+
+sudo dd if=~/rock-5t_bookworm_kde_b2.output.img of=/dev/mmcblk0 bs=4M status=progress
+
 ```
 </NewCodeBlock>
 参数说明：
 - `if`：指定写入文件，将 `[image_path]` 替换为解压后的系统镜像文件路径
-- `of`：指定写入设备，将 `/dev/mmcblk0` 替换为 eMMC 模块对应的设备文件(请根据实际设备修改)
+- `of`：指定写入设备，将 `/dev/mmcblk0` 替换为 eMMC 对应的设备文件(请根据实际设备修改)
 - `bs`：块大小，建议 4M
 - `status=progress`：显示写入状态
 
@@ -87,13 +109,16 @@ sudo dd if=[image_path] of=/dev/mmcblk0 bs=4M status=progress
 
 <NewCodeBlock tip="radxa@device$" type="device">
 ```
+
 sudo fdisk -l /dev/mmcblk0
+
 ```
 </NewCodeBlock>
 
 若系统成功写入，终端会输出类似以下的分区信息：
 
 ```
+
 Disk /dev/mmcblk0: 119.15 GiB, 127934660608 bytes, 31234048 sectors
 Disk model: KLUDG4UHDC-B0E1
 Units: sectors of 1 \* 4096 = 4096 bytes
@@ -106,11 +131,12 @@ Device Start End Sectors Size Type
 /dev/mmcblk0p1 32768 65535 32768 128M Linux filesystem
 /dev/mmcblk0p2 65536 679935 614400 2.3G EFI System
 /dev/mmcblk0p3 679936 31234014 30554079 116.6G EFI System
+
 ```
 
 ## 启动系统
 
-完成系统的安装后，将主板关机并断电，然后拔下 MicroSD 卡，重新插上电源适配器，系统会自动从 eMMC 模块启动。
+完成系统的安装后，将主板关机并断电，然后拔下 MicroSD 卡，重新插上电源适配器，系统会自动从 eMMC 启动。
 
 ## 系统信息
 
@@ -121,3 +147,4 @@ Device Start End Sectors Size Type
 用户账号：radxa
 
 用户密码：radxa
+```

i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5t/getting-started/install-os/emmc_boot.md

@@ -2,12 +2,12 @@
 sidebar_position: 3
 ---
 
-# Install OS to eMMC Module
+# Install the system to eMMC
 
-If your Radxa ROCK 5T has an onboard eMMC module, you can use the `dd` command to write the system image to the eMMC module while booting from a MicroSD card.
+If your Radxa ROCK 5T has onboard eMMC, you can use the `dd` command to write the system image to eMMC while booting from a MicroSD card.
 
-:::tip Note
-Installing the system will format the eMMC module. Please back up any important data in advance!
+:::tip Important Notes
+Installing the system will format the eMMC. Please back up any important data in advance!
 
 If your system cannot currently boot from a MicroSD card, you can refer to the [Install OS to MicroSD Card](./boot_from_sd_card.md) tutorial.
 :::
@@ -17,13 +17,13 @@ If your system cannot currently boot from a MicroSD card, you can refer to the [
 You will need the following hardware:
 
 - Board: Radxa ROCK 5T
-- System boot media: MicroSD card
+- Boot medium: MicroSD card
 - Power adapter: Standard DC 12V/2A power adapter (DC-5525 interface)
 
-We need to boot the board system from a MicroSD card, download the system image file after entering the board system, and then use the `dd` command to write the system image to the eMMC module.
+We will boot the system from the MicroSD card, download the system image file after entering the system, and then use the `dd` command to write the system image to eMMC.
 
 :::tip Recommended Accessories
-Radxa ROCK 5T only supports 12V power input. A current of 2A or higher is recommended to ensure stable operation of all peripherals.
+Radxa ROCK 5T only supports 12V power input, and a current of 2A or higher is recommended to ensure stable operation of all peripherals.
 
 - [Radxa DC12 36W Power Adapter](https://radxa.com/products/accessories/power-dc12-36w) (Recommended)
 - [Radxa DC12 60W Power Adapter](https://radxa.com/products/accessories/power-dc12-60w)
@@ -32,65 +32,85 @@ Radxa ROCK 5T only supports 12V power input. A current of 2A or higher is recomm
 
 ## Download System Image
 
-You can download the system image file by visiting the [Resource Download Center](../../download) page on the board.
+You can download the system image file by visiting the [Resource Download Center](../../download) page on your board.
 
-:::tip Download Suggestions
-We provide the following methods to download the system image file to the board. You can choose the appropriate method according to your actual situation:
+:::tip Download Recommendations
+We provide the following methods to download the system image file to your board. Please choose the appropriate method based on your situation:
 
-- Download using `wget` command
+- Using `wget` command
 
-You can copy the system image file link from the [Resource Download Center](../../download) page and use the `wget` command to download it on the board.
+You can copy the system image file link from the [Resource Download Center](../../download) page and use the `wget` command on your board to download it.
 
+<NewCodeBlock tip="radxa@device$" type="device">
 ```
 sudo apt install wget
 wget [url]
+# Example
+wget https://github.com/radxa-build/rock-5t/releases/download/rsdk-b2/rock-5t_bookworm_kde_b2.output.img.xz
 ```
-
-Parameter explanation: Replace `[url]` with the actual system image file download link.
+</NewCodeBlock>
+Parameter explanation: Replace `[url]` with the actual system image download link.
 
 - PC Download
 
-You can download the system image file on your PC by visiting the [Resource Download Center](../../download) page, and then transfer the system image file to the board via USB flash drive, FTP, SCP, etc.
+You can download the system image file from the [Resource Download Center](../../download) page on your PC, then transfer it to the board using a USB drive, FTP, SCP, or other methods.
+
 :::
 
 ## Install System
 
-Use the `dd` command to install the system image to the eMMC module.
+Use the `dd` command to install the system image to eMMC.
 
 :::tip Note
-The downloaded system image file is a compressed package and needs to be extracted before use.
+The downloaded system image file is compressed and needs to be extracted before use.
 :::
 
+### Extract System Image
+
+Use the `unxz` command to extract the system image file.
+
+<NewCodeBlock tip="radxa@device$" type="device">
+```
+sudo apt install xz-utils
+unxz [image_path]
+# Example
+unxz ~/rock-5t_bookworm_kde_b2.output.img.xz
+```
+</NewCodeBlock>
+Parameter explanation: Replace `[image_path]` with the actual path to the system image file.
+
 ### Write System Image
 
-Use the `dd` command to write the extracted system image file to the eMMC module.
+Use the `dd` command to write the extracted system image to eMMC.
 
 :::danger
-When using the `dd` command, make sure to select the correct device file, otherwise it may format the wrong device, resulting in data loss!
+When using the `dd` command, make sure to select the correct device file to avoid formatting the wrong device and causing data loss!
 :::
 
 <NewCodeBlock tip="radxa@device$" type="device">
 ```
 sudo dd if=[image_path] of=/dev/mmcblk0 bs=4M status=progress
+# Example
+sudo dd if=~/rock-5t_bookworm_kde_b2.output.img of=/dev/mmcblk0 bs=4M status=progress
 ```
 </NewCodeBlock>
 Parameter explanation:
-- `if`: Specify the input file, replace `[image_path]` with the path to the extracted system image file
-- `of`: Specify the output device, replace `/dev/mmcblk0` with the device file corresponding to the eMMC module (please modify according to the actual device)
-- `bs`: Block size, recommended 4M
-- `status=progress`: Show write progress
+- `if`: Specify the input file. Replace `[image_path]` with the path to the extracted system image file.
+- `of`: Specify the output device. Replace `/dev/mmcblk0` with the device file corresponding to your eMMC (please modify according to your actual device).
+- `bs`: Block size, recommended 4M.
+- `status=progress`: Show write progress.
 
 ### Verify System Image
 
-After writing the system image, you can use the `fdisk` command to view the partition information of the target boot medium to confirm whether the system image was written successfully.
+After writing the system image, you can use the `fdisk` command to view the partition information of the boot medium to confirm if the system image was written successfully.
 
 <NewCodeBlock tip="radxa@device$" type="device">
 ```
 sudo fdisk -l /dev/mmcblk0
 ```
 </NewCodeBlock>
 
-If the system is successfully written, the terminal will output partition information similar to the following:
+If the system was written successfully, the terminal will output partition information similar to the following:
 
 ```
 Disk /dev/mmcblk0: 119.15 GiB, 127934660608 bytes, 31234048 sectors
@@ -107,13 +127,13 @@ Device Start End Sectors Size Type
 /dev/mmcblk0p3 679936 31234014 30554079 116.6G EFI System
 ```
 
-## Boot System
+## Boot the System
 
-After completing the system installation, power off the board, unplug the MicroSD card, and then reconnect the power adapter. The system will automatically boot from the eMMC module.
+After completing the system installation, power off the board, remove the MicroSD card, and then reconnect the power adapter. The system will automatically boot from eMMC.
 
 ## System Information
 
-When using our provided system image, you need to log in to the system using the username and password we set for the first time.
+When using our provided system image, you will need to log in with the following default credentials:
 
 - Debian Linux