Skip to content

Commit 42a0792

Browse files
committed
fix: modify rock5t emmc boot system
1 parent f4e01a0 commit 42a0792

File tree

2 files changed

+58
-25
lines changed
  • docs/rock5/rock5t/getting-started/install-os
  • i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5t/getting-started/install-os

2 files changed

+58
-25
lines changed

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

Lines changed: 18 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,9 @@
22
sidebar_position: 3
33
---
44

5-
# 安装系统到 eMMC 模块
5+
# 安装系统到 eMMC
66

7-
若您的瑞莎 ROCK 5T 板载 eMMC 模块,您可以在 MicroSD 卡启动主板的情况下,使用 `dd` 命令将系统镜像写入 eMMC 模块
7+
若您的瑞莎 ROCK 5T 板载 eMMC,您可以在 MicroSD 卡启动主板的情况下,使用 `dd` 命令将系统镜像写入 eMMC。
88

99
:::tip 注意事项
1010
安装系统会格式化 eMMC 模块,如果有重要数据请提前备份!
@@ -44,6 +44,8 @@ sidebar_position: 3
4444
```
4545
sudo apt install wget
4646
wget [url]
47+
# 示例
48+
wget https://github.com/radxa-build/rock-5t/releases/download/rsdk-b2/rock-5t_bookworm_kde_b2.output.img.xz
4749
```
4850

4951
参数解释:其中 `[url]` 需要替换成实际的系统镜像文件下载链接。
@@ -62,6 +64,20 @@ wget [url]
6264
下载的系统镜像文件是压缩包,需要解压后才能使用。
6365
:::
6466

67+
### 解压系统镜像
68+
69+
使用 `unxz` 命令解压系统镜像文件。
70+
71+
<NewCodeBlock tip="radxa@device$" type="device">
72+
```
73+
sudo apt install xz-utils
74+
unxz [image_path]
75+
# 示例
76+
unxz ~/rock-5t_bookworm_kde_b2.output.img.xz
77+
```
78+
</NewCodeBlock>
79+
参数解释:其中 `[image_path]` 需要替换成实际的系统镜像文件路径。
80+
6581
### 写入系统镜像
6682

6783
将解压的系统镜像文件使用 `dd` 命令写入 eMMC 模块。

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

Lines changed: 40 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -2,11 +2,11 @@
22
sidebar_position: 3
33
---
44

5-
# Install OS to eMMC Module
5+
# Install the system to eMMC
66

7-
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.
7+
If your Radxa ROCK 5T has an onboard eMMC, you can use the `dd` command to write the system image to the eMMC while booting from a MicroSD card.
88

9-
:::tip Note
9+
:::tip Important Notes
1010
Installing the system will format the eMMC module. Please back up any important data in advance!
1111

1212
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 [
1717
You will need the following hardware:
1818

1919
- Board: Radxa ROCK 5T
20-
- System boot media: MicroSD card
20+
- Boot medium: MicroSD card
2121
- Power adapter: Standard DC 12V/2A power adapter (DC-5525 interface)
2222

23-
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.
23+
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 the eMMC module.
2424

2525
:::tip Recommended Accessories
26-
Radxa ROCK 5T only supports 12V power input. A current of 2A or higher is recommended to ensure stable operation of all peripherals.
26+
Radxa ROCK 5T only supports 12V power input, and a current of 2A or higher is recommended to ensure stable operation of all peripherals.
2727

2828
- [Radxa DC12 36W Power Adapter](https://radxa.com/products/accessories/power-dc12-36w) (Recommended)
2929
- [Radxa DC12 60W Power Adapter](https://radxa.com/products/accessories/power-dc12-60w)
@@ -32,41 +32,58 @@ Radxa ROCK 5T only supports 12V power input. A current of 2A or higher is recomm
3232

3333
## Download System Image
3434

35-
You can download the system image file by visiting the [Resource Download Center](../../download) page on the board.
35+
You can download the system image file by visiting the [Resource Download Center](../../download) page on your board.
3636

37-
:::tip Download Suggestions
38-
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:
37+
:::tip Download Recommendations
38+
We provide the following methods to download the system image file to your board. Please choose the appropriate method based on your situation:
3939

40-
- Download using `wget` command
40+
- Using `wget` command
4141

42-
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.
42+
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.
4343

4444
```
4545
sudo apt install wget
4646
wget [url]
47+
# Example
48+
wget https://github.com/radxa-build/rock-5t/releases/download/rsdk-b2/rock-5t_bookworm_kde_b2.output.img.xz
4749
```
4850

49-
Parameter explanation: Replace `[url]` with the actual system image file download link.
51+
Parameter explanation: Replace `[url]` with the actual system image download link.
5052

5153
- PC Download
5254

53-
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.
55+
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.
56+
5457
:::
5558

5659
## Install System
5760

5861
Use the `dd` command to install the system image to the eMMC module.
5962

6063
:::tip Note
61-
The downloaded system image file is a compressed package and needs to be extracted before use.
64+
The downloaded system image file is compressed and needs to be extracted before use.
6265
:::
6366

67+
### Extract System Image
68+
69+
Use the `unxz` command to extract the system image file.
70+
71+
<NewCodeBlock tip="radxa@device$" type="device">
72+
```
73+
sudo apt install xz-utils
74+
unxz [image_path]
75+
# Example
76+
unxz ~/rock-5t_bookworm_kde_b2.output.img.xz
77+
```
78+
</NewCodeBlock>
79+
Parameter explanation: Replace `[image_path]` with the actual path to the system image file.
80+
6481
### Write System Image
6582

66-
Use the `dd` command to write the extracted system image file to the eMMC module.
83+
Use the `dd` command to write the extracted system image to the eMMC module.
6784

6885
:::danger
69-
When using the `dd` command, make sure to select the correct device file, otherwise it may format the wrong device, resulting in data loss!
86+
When using the `dd` command, make sure to select the correct device file to avoid formatting the wrong device and causing data loss!
7087
:::
7188

7289
<NewCodeBlock tip="radxa@device$" type="device">
@@ -75,22 +92,22 @@ sudo dd if=[image_path] of=/dev/mmcblk0 bs=4M status=progress
7592
```
7693
</NewCodeBlock>
7794
Parameter explanation:
78-
- `if`: Specify the input file, replace `[image_path]` with the path to the extracted system image file
79-
- `of`: Specify the output device, replace `/dev/mmcblk0` with the device file corresponding to the eMMC module (please modify according to the actual device)
95+
- `if`: Specify the input file. Replace `[image_path]` with the path to the extracted system image file
96+
- `of`: Specify the output device. Replace `/dev/mmcblk0` with the device file corresponding to your eMMC module (please modify according to your actual device)
8097
- `bs`: Block size, recommended 4M
8198
- `status=progress`: Show write progress
8299

83100
### Verify System Image
84101

85-
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.
102+
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.
86103

87104
<NewCodeBlock tip="radxa@device$" type="device">
88105
```
89106
sudo fdisk -l /dev/mmcblk0
90107
```
91108
</NewCodeBlock>
92109

93-
If the system is successfully written, the terminal will output partition information similar to the following:
110+
If the system was written successfully, the terminal will output partition information similar to the following:
94111

95112
```
96113
Disk /dev/mmcblk0: 119.15 GiB, 127934660608 bytes, 31234048 sectors
@@ -107,13 +124,13 @@ Device Start End Sectors Size Type
107124
/dev/mmcblk0p3 679936 31234014 30554079 116.6G EFI System
108125
```
109126

110-
## Boot System
127+
## Boot the System
111128

112-
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.
129+
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 the eMMC module.
113130

114131
## System Information
115132

116-
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.
133+
When using our provided system image, you will need to log in with the following default credentials:
117134

118135
- Debian Linux
119136

0 commit comments

Comments
 (0)