feat: zero3: add burning sdcard with sddisktool

Signed-off-by: Mitchell Ma <[email protected]>
radxa-docs · Nov 13, 2024 · f59673a · f59673a
1 parent 4c4d0b3
commit f59673a
Show file tree

Hide file tree

Showing 4 changed files with 54 additions and 34 deletions.
diff --git a/docs/common/general/_sddisktool.mdx b/docs/common/general/_sddisktool.mdx
@@ -1,29 +1,33 @@
 SDDiskTool 是瑞芯微官方的 SD 卡烧录工具。
 
-## 1.下载 SDDiskTool
+- 下载 SDDiskTool
 
-SDDiskTool 目前只有 Windows 版本，所以请在 Windows 电脑下操作。
+  - SDDiskTool 目前只有 Windows 版本，所以请在 Windows 电脑下操作。
 
-下载链接：[SDDiskTool_cn_v1.74.zip](https://dl.radxa.com/tools/windows/SDDiskTool_cn_v1.74.zip)
+  - 下载链接：[SDDiskTool_cn_v1.74.zip](https://dl.radxa.com/tools/windows/SDDiskTool_cn_v1.74.zip)
 
-## 2.烧录 SD 卡
+- 烧录 SD 卡
 
-我们需要烧录相对应的 RK 格式的完整镜像。
+  - 我们需要烧录相对应的 RK 格式的完整镜像。
 
-RK 格式的完整镜像指**使用 Rockchip 基于 Buildroot 发布的一系列 Linux SDK 所编译出的 `update.img` 镜像**
+  - RK 格式的完整镜像指**使用 Rockchip 基于 Buildroot 发布的一系列 Linux SDK 所编译出的 `update.img` 镜像**
 
-打开 SDDiskTool 的可执行文件 SD_Firmware_Tool.exe，插入 SD 卡。
+  - 打开 SDDiskTool 的可执行文件 SD_Firmware_Tool.exe，插入 SD 卡。
 
-:::warning
-插入多个存储设备时，请确认好要烧录的 SD 卡，否则将导致其他存储设备被覆盖。
-:::
+    :::warning
+    插入多个存储设备时，请确认好要烧录的 SD 卡，否则将导致其他存储设备被覆盖。
+    :::
+
+  - 可移动磁盘设备选择要烧录的 SD 卡，功能模式选择 **SD 启动**，升级固件要是 RK 格式的完整镜像，最后点击**开始创建**烧录镜像。
 
-可移动磁盘设备选择要烧录的 SD 卡，功能模式选择 **SD 启动**，升级固件要是 RK 格式的完整镜像，最后点击**开始创建**烧录镜像。
+    <img
+      src="/img/common/sddisktool-cn.webp"
+      alt="ssdisk tool"
+      style={{ width: "80" }}
+    />
 
-<img
-  src="/img/common/sddisktool-cn.webp"
-  alt="ssdisk tool"
-  style={{ width: "80" }}
-/>
+  - 烧录过程请耐心等待，镜像分区很多，如果镜像很大，烧录时间会较长。
 
-烧录过程请耐心等待，镜像分区很多，如果镜像很大，烧录时间会较长。
+:::tip
+在烧录时，如果遇到清空 MBR 的问题，需要把 SD 卡磁盘标签类型从 dos 改为 gpt。
+:::
diff --git a/docs/zero/zero3/other-os/buildroot.md b/docs/zero/zero3/other-os/buildroot.md
@@ -3,6 +3,8 @@ sidebar_position: 10
 description: "Buildroot"
 ---
 
+import SSDISKTOOL from "../../../common/general/\_sddisktool.mdx"
+
 # Buildroot
 
 ## 环境准备
@@ -66,3 +68,7 @@ git checkout -b linux-5.10-gen-rkr8-buildroot remotes/radxa/linux-5.10-gen-rkr8-
 然后选中配置文件 `rockchip_rk3566_radxa_zero_3e_defconfig`。
 
 构建完成后，将会在 `rockdev/` 目录下生成镜像。
+
+## 使用 SDDiskTool 将生成的镜像到 SDCard 中
+
+<SSDISKTOOL />
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/common/general/_sddisktool.mdx b/i18n/en/docusaurus-plugin-content-docs/current/common/general/_sddisktool.mdx
@@ -1,29 +1,33 @@
 SDDiskTool is Rockchip's official SD card flashing tool.
 
-## 1.Download SDDiskTool
+- Download SDDiskTool
 
-SDDiskTool currently only has a Windows version, so please use it on a Windows computer.
+  - SDDiskTool currently only has a Windows version, so please use it on a Windows computer.
 
-Download link:[SDDiskTool_en_v1.74.zip](https://dl.radxa.com/tools/windows/SDDiskTool_en_v1.74.zip)
+  - Download link:[SDDiskTool_en_v1.74.zip](https://dl.radxa.com/tools/windows/SDDiskTool_en_v1.74.zip)
 
-## 2.Flash SD card
+- Flash SD card
 
-We need to flash the corresponding complete image in RK format.
+  - We need to flash the corresponding complete image in RK format.
 
-Complete image in RK format refers to **The `update.img` image compiled using a series of Linux SDKs released by Rockchip based on Buildroot**
+  - Complete image in RK format refers to **The `update.img` image compiled using a series of Linux SDKs released by Rockchip based on Buildroot**
 
-Open the executable file `SD_Firmware_Tool.exe` of SDDiskTool and insert the SD card.
+  - Open the executable file `SD_Firmware_Tool.exe` of SDDiskTool and insert the SD card.
 
-:::warning
-When multiple storage devices are connected, please ensure you select the correct SD card to flash, otherwise other storage devices may be overwritten.
-:::
+    :::warning
+    When multiple storage devices are connected, please ensure you select the correct SD card to flash, otherwise other storage devices may be overwritten.
+    :::
+
+  - Select the SD card to flash from the removable disk devices, choose **SD Boot** as the function mode, ensure that the firmware upgrade is a complete image in RK format, and finally click **Create** to flash the image.
 
-Select the SD card to flash from the removable disk devices, choose **SD Boot** as the function mode, ensure that the firmware upgrade is a complete image in RK format, and finally click **Create** to flash the image.
+    <img
+      src="/img/common/sddisktool-en.webp"
+      alt="ssdisk tool"
+      style={{ width: "80" }}
+    />
 
-<img
-  src="/img/common/sddisktool-en.webp"
-  alt="ssdisk tool"
-  style={{ width: "80" }}
-/>
+  - Please be patient during the flashing process. The image contains many partitions, and if the image is large, the flashing time will be longer.
 
-Please be patient during the flashing process. The image contains many partitions, and if the image is large, the flashing time will be longer.
+:::tip
+If you encounter problems clearing the MBR while burning, you need to change the SD card disk label type from dos to gpt.
+:::
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/zero/zero3/other-os/buildroot.md b/i18n/en/docusaurus-plugin-content-docs/current/zero/zero3/other-os/buildroot.md
@@ -3,6 +3,8 @@ sidebar_position: 10
 description: "Buildroot"
 ---
 
+import SSDISKTOOL from "../../../common/general/\_sddisktool.mdx"
+
 # Buildroot
 
 ## Preparation
@@ -65,3 +67,7 @@ Navigate to the top-level directory of the SDK, run command.
 
 And select defconfig `rockchip_rk3566_radxa_zero_3e_defconfig`.
 The target images will be stored on rockdev directory.
+
+## Use SDDiskTool to image the generated image into SDCard
+
+<SSDISKTOOL />