Skip to content

Commit 64101fe

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

File tree

2 files changed

+32
-18
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

+32
-18
lines changed

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

Lines changed: 18 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ sidebar_position: 3
77
若您的瑞莎 ROCK 5T 板载 eMMC,您可以在 MicroSD 卡启动主板的情况下,使用 `dd` 命令将系统镜像写入 eMMC。
88

99
:::tip 注意事项
10-
安装系统会格式化 eMMC 模块,如果有重要数据请提前备份!
10+
安装系统会格式化 eMMC,如果有重要数据请提前备份!
1111

1212
若您的系统目前还无法通过 MicroSD 卡启动,可以参考 [安装系统到 MicroSD 卡](./boot_from_sd_card.md) 教程。
1313
:::
@@ -20,7 +20,7 @@ sidebar_position: 3
2020
- 系统启动介质:MicroSD 卡
2121
- 电源适配器:标准 DC 12V/2A 电源适配器(DC-5525 接口)
2222

23-
我们需要基于 MicroSD 卡启动主板系统,进入主板系统后下载系统镜像文件,然后使用 `dd` 命令将系统镜像写入 eMMC 模块
23+
我们需要基于 MicroSD 卡启动主板系统,进入主板系统后下载系统镜像文件,然后使用 `dd` 命令将系统镜像写入 eMMC。
2424

2525
:::tip 推荐配件
2626
瑞莎 ROCK 5T 仅支持 12V 电源输入,建议电流 2A 及以上,以确保所有外设稳定运行。
@@ -41,13 +41,14 @@ sidebar_position: 3
4141

4242
您可以复制 [资源汇总下载](../../download) 页面的系统镜像文件链接,然后在主板上使用 `wget` 命令下载。
4343

44+
<NewCodeBlock tip="radxa@device$" type="device">
4445
```
4546
sudo apt install wget
4647
wget [url]
4748
# 示例
4849
wget https://github.com/radxa-build/rock-5t/releases/download/rsdk-b2/rock-5t_bookworm_kde_b2.output.img.xz
4950
```
50-
51+
</NewCodeBlock>
5152
参数解释:其中 `[url]` 需要替换成实际的系统镜像文件下载链接。
5253

5354
- PC 下载
@@ -58,7 +59,7 @@ wget https://github.com/radxa-build/rock-5t/releases/download/rsdk-b2/rock-5t_bo
5859

5960
## 安装系统
6061

61-
使用 `dd` 命令安装系统镜像到 eMMC 模块
62+
使用 `dd` 命令安装系统镜像到 eMMC。
6263

6364
:::tip 说明
6465
下载的系统镜像文件是压缩包,需要解压后才能使用。
@@ -80,7 +81,7 @@ unxz ~/rock-5t_bookworm_kde_b2.output.img.xz
8081

8182
### 写入系统镜像
8283

83-
将解压的系统镜像文件使用 `dd` 命令写入 eMMC 模块
84+
将解压的系统镜像文件使用 `dd` 命令写入 eMMC。
8485

8586
:::danger
8687
使用 `dd` 命令时,请确保选择正确的设备文件,否则会格式化错误的设备,造成数据丢失!
@@ -89,11 +90,16 @@ unxz ~/rock-5t_bookworm_kde_b2.output.img.xz
8990
<NewCodeBlock tip="radxa@device$" type="device">
9091
```
9192
sudo dd if=[image_path] of=/dev/mmcblk0 bs=4M status=progress
93+
94+
# 示例
95+
96+
sudo dd if=~/rock-5t_bookworm_kde_b2.output.img of=/dev/mmcblk0 bs=4M status=progress
97+
9298
```
9399
</NewCodeBlock>
94100
参数说明:
95101
- `if`:指定写入文件,将 `[image_path]` 替换为解压后的系统镜像文件路径
96-
- `of`:指定写入设备,将 `/dev/mmcblk0` 替换为 eMMC 模块对应的设备文件(请根据实际设备修改)
102+
- `of`:指定写入设备,将 `/dev/mmcblk0` 替换为 eMMC 对应的设备文件(请根据实际设备修改)
97103
- `bs`:块大小,建议 4M
98104
- `status=progress`:显示写入状态
99105

@@ -103,13 +109,16 @@ sudo dd if=[image_path] of=/dev/mmcblk0 bs=4M status=progress
103109

104110
<NewCodeBlock tip="radxa@device$" type="device">
105111
```
112+
106113
sudo fdisk -l /dev/mmcblk0
114+
107115
```
108116
</NewCodeBlock>
109117

110118
若系统成功写入,终端会输出类似以下的分区信息:
111119

112120
```
121+
113122
Disk /dev/mmcblk0: 119.15 GiB, 127934660608 bytes, 31234048 sectors
114123
Disk model: KLUDG4UHDC-B0E1
115124
Units: sectors of 1 \* 4096 = 4096 bytes
@@ -122,11 +131,12 @@ Device Start End Sectors Size Type
122131
/dev/mmcblk0p1 32768 65535 32768 128M Linux filesystem
123132
/dev/mmcblk0p2 65536 679935 614400 2.3G EFI System
124133
/dev/mmcblk0p3 679936 31234014 30554079 116.6G EFI System
134+
125135
```
126136

127137
## 启动系统
128138

129-
完成系统的安装后,将主板关机并断电,然后拔下 MicroSD 卡,重新插上电源适配器,系统会自动从 eMMC 模块启动
139+
完成系统的安装后,将主板关机并断电,然后拔下 MicroSD 卡,重新插上电源适配器,系统会自动从 eMMC 启动
130140

131141
## 系统信息
132142

@@ -137,3 +147,4 @@ Device Start End Sectors Size Type
137147
用户账号:radxa
138148

139149
用户密码:radxa
150+
```

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

Lines changed: 14 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -4,10 +4,10 @@ sidebar_position: 3
44

55
# Install the system to eMMC
66

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.
7+
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.
88

99
:::tip Important Notes
10-
Installing the system will format the eMMC module. Please back up any important data in advance!
10+
Installing the system will format the eMMC. 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.
1313
:::
@@ -20,7 +20,7 @@ You will need the following hardware:
2020
- Boot medium: MicroSD card
2121
- Power adapter: Standard DC 12V/2A power adapter (DC-5525 interface)
2222

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.
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 eMMC.
2424

2525
:::tip Recommended Accessories
2626
Radxa ROCK 5T only supports 12V power input, and a current of 2A or higher is recommended to ensure stable operation of all peripherals.
@@ -41,13 +41,14 @@ We provide the following methods to download the system image file to your board
4141

4242
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

44+
<NewCodeBlock tip="radxa@device$" type="device">
4445
```
4546
sudo apt install wget
4647
wget [url]
4748
# Example
4849
wget https://github.com/radxa-build/rock-5t/releases/download/rsdk-b2/rock-5t_bookworm_kde_b2.output.img.xz
4950
```
50-
51+
</NewCodeBlock>
5152
Parameter explanation: Replace `[url]` with the actual system image download link.
5253

5354
- PC Download
@@ -58,7 +59,7 @@ You can download the system image file from the [Resource Download Center](../..
5859

5960
## Install System
6061

61-
Use the `dd` command to install the system image to the eMMC module.
62+
Use the `dd` command to install the system image to eMMC.
6263

6364
:::tip Note
6465
The downloaded system image file is compressed and needs to be extracted before use.
@@ -80,7 +81,7 @@ Parameter explanation: Replace `[image_path]` with the actual path to the system
8081

8182
### Write System Image
8283

83-
Use the `dd` command to write the extracted system image to the eMMC module.
84+
Use the `dd` command to write the extracted system image to eMMC.
8485

8586
:::danger
8687
When using the `dd` command, make sure to select the correct device file to avoid formatting the wrong device and causing data loss!
@@ -89,13 +90,15 @@ When using the `dd` command, make sure to select the correct device file to avoi
8990
<NewCodeBlock tip="radxa@device$" type="device">
9091
```
9192
sudo dd if=[image_path] of=/dev/mmcblk0 bs=4M status=progress
93+
# Example
94+
sudo dd if=~/rock-5t_bookworm_kde_b2.output.img of=/dev/mmcblk0 bs=4M status=progress
9295
```
9396
</NewCodeBlock>
9497
Parameter explanation:
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)
97-
- `bs`: Block size, recommended 4M
98-
- `status=progress`: Show write progress
98+
- `if`: Specify the input file. Replace `[image_path]` with the path to the extracted system image file.
99+
- `of`: Specify the output device. Replace `/dev/mmcblk0` with the device file corresponding to your eMMC (please modify according to your actual device).
100+
- `bs`: Block size, recommended 4M.
101+
- `status=progress`: Show write progress.
99102

100103
### Verify System Image
101104

@@ -126,7 +129,7 @@ Device Start End Sectors Size Type
126129

127130
## Boot the System
128131

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.
132+
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.
130133

131134
## System Information
132135

0 commit comments

Comments
 (0)