docs: mars add usb boot

Author: u0076

docs/mars/getting-started/boot.md

@@ -2,9 +2,9 @@
 sidebar_label: 'Boot the Mars'
 sidebar_position: 10
 ---
-# Boot Mars from microSD card
+## Boot Mars from microSD card
 
-## Prepare
+### Prepare
 
 - Necessary
   - Mars
@@ -14,12 +14,12 @@ sidebar_position: 10
   - USB to TTL serial cable
   - HDMI cable
 
-## Download images and tools
+### Download images and tools
 
 - Download the system image from [Official Image](https://milkv.io/docs/mars/getting-started/images#official-image).
 - Download the flash tool, [balenaEtcher](https://etcher.balena.io/) or [Rufus](https://rufus.ie/en/).
 
-## Burn image
+### Burn image
 
 Here are the steps for using balenaEtcher.
 
@@ -35,12 +35,42 @@ Here are the steps for using balenaEtcher.
 
 ![etcher-step3](/docs/duo/etcher-step3.png)
 
-## Power on
+### Power on
 
 Insert the microSD card with the burned firmware into the Mars microSD card slot. Use an adapter (5V) to connect Mars via a Type-C cable. Mars will automatically power on and the red power LED on the board will light up. After the system starts successfully, the green status LED on the board will flash.
 
 If an HDMI monitor is connected, the Debian desktop will be displayed after booting.
 
-## Troubleshooting
+### Troubleshooting
 
 If you have a problem, go to our [community](https://community.milkv.io/) and post to let us know.
+
+
+## Boot Mars from USB drive
+
+* Note: The USB drive booting process is a bit complicated, it is recommended to use the microSD card to boot Mars. The USB drive can only be plugged into the USB3.0 port.
+
+Use a serial cable to connect to the serial debugging port of Mars. When powering on Mars, press any key to interrupt the boot process and enter the U-Boot command line.
+
+In the U-Boot command line, enter the following commands:
+
+```bash
+setenv boot_devs 'mmc nvme usb'
+setenv distro_bootenv_usb 'setenv bootdev usb; setenv devnum 0; run usb_boot'
+saveenv
+```
+
+Download the image and burn it to the USB drive. Use the microSD card to boot Mars, insert the USB drive into Mars, and modify the `extlinux.conf` file on the USB drive.
+
+```bash
+sudo mount /dev/sad3 /mnt
+sudo nano /mnt/extlinux/extlinux.conf
+```
+
+In the `extlinux.conf`, modify the `APPEND` line, change `root=/dev/mmcblk1p4` to `root=/dev/sda4`, as shown below:
+
+```bash
+append root=/dev/sda4 rw console=tty0 console=ttyS0,115200 earlycon rootwait stmmaceth=chain_mode:1 selinux=0
+```
+
+Save and exit, unmount the USB drive. Power off, remove the microSD card, and power on again.

i18n/zh/docusaurus-plugin-content-docs/current/mars/getting-started/boot.md

@@ -2,9 +2,9 @@
 sidebar_label: '启动 Mars'
 sidebar_position: 10
 ---
-# 从 microSD 卡启动 Mars
+## 从 microSD 卡启动 Mars
 
-## 准备
+### 准备
 
 - 必要的
   - Mars
@@ -14,12 +14,12 @@ sidebar_position: 10
   - USB to TTL 串口模块
   - HDMI 线
 
-## 下载镜像和工具
+### 下载镜像和工具
 
 - 下载 [官方镜像](https://milkv.io/zh/docs/mars/getting-started/images#%E5%AE%98%E6%96%B9%E9%95%9C%E5%83%8F)。
 - 下载镜像烧录工具 [balenaEtcher](https://etcher.balena.io/) 或 [Rufus](https://rufus.ie/en/)。
 
-## 烧录镜像
+### 烧录镜像
 
 以下是使用 BalenaEtcher 的步骤。
 
@@ -35,12 +35,42 @@ sidebar_position: 10
 
 ![etcher-step3](/docs/duo/etcher-step3.png)
 
-## 开机
+### 开机
 
 将烧录好固件的 microSD 卡插入 Mars 的 microSD 卡槽中。使用适配器 (5V) 通过 Type-C 线连接 Mars，Mars 会自动上电开机，板上的红色电源灯会亮起。待系统启动成功后，板上的绿色状态灯会闪烁。
 
 如果有连接 HDMI 显示器，开机后会显示 Debian 桌面。
 
-## 故障排除
+### 故障排除
 
 如果您有问题，请到我们的[社区](https://community.milkv.io/)发帖，让我们知道。
+
+
+## 从 U 盘启动 Mars
+
+* 注意：U 盘启动步骤有点复杂，建议使用 microSD 卡启动 Mars。U 盘只能插在 USB3.0 口。
+
+使用串口线连接到 Mars 的串口调试口，在 Mars 上电的时候按任意按键打断启动，进入 U-Boot 命令行。
+
+在 U-Boot 命令行中输入以下命令：
+
+```bash
+setenv boot_devs 'mmc nvme usb'
+setenv distro_bootenv_usb 'setenv bootdev usb; setenv devnum 0; run usb_boot'
+saveenv
+```
+
+下载镜像烧录到 U 盘。使用 microSD 卡启动 Mars，把 U 盘插入 Mars 中，修改 U 盘里的 extlinux.conf 文件。
+
+```bash
+sudo mount /dev/sad3 /mnt
+sudo nano /mnt/extlinux/extlinux.conf
+```
+
+在 `extlinux.conf` 中修改 `APPEND` 行，把 `root=/dev/mmcblk1p4` 改成 `root=/dev/sda4`，如下所示：
+
+```bash
+append root=/dev/sda4 rw console=tty0 console=ttyS0,115200 earlycon rootwait stmmaceth=chain_mode:1 selinux=0
+```
+
+保存并退出，卸载 U 盘。关机，拔掉 microSD 卡，重新上电开机。