Merge pull request #9 from peterwang2050/rock5b-new

refactor:add faq of rock5b

docs/rock5/rock5b/faq.md

@@ -54,6 +54,20 @@ ROCK 5B 支持将 USB PD 电源协商至更高的电压，如 9V、12V、15V、2
 - 您可以在 /boot/extlinux/extlinux.conf 中手动添加 HDMI 分辨率和帧速率
 - 只需在附加行中添加 video=1920x1080@60（只需将分辨率和帧频改为显示器支持的分辨率即可）
 
+### 问题三： 我通过RKDevTool工具烧录 Emmc 成功了，但是上电之后，Led不闪，屏幕无输出
+
+原因确认:
+
+去掉 EMMC Module, MicroSD 及 NVME 设备，然后通过 USB 线连接板子和PC，此时看设备是否进入 [Maskrom 状态](./low-level-dev/maskrom.md)，
+如果不是MaskRom状态，则大概率是下面的原因:
+
+**在 [通过USB烧录系统到EMMC](./low-level-dev/install-os-on-emmc-from-usb-otg.md) 的时候没有按照说明 按 Maskrom 按键，导致烧录系统到了
+[SPI Flash](./README.md)中, 而系统启动的时候，先读取SPI的信息，此时出现错误，无法正常启动。**
+
+解决办法：
+
+[清空 SPI Flash](./low-level-dev/erase-spi-from-usb-otg.md), 然后重新按步骤 [通过USB烧录系统到EMMC](./low-level-dev/install-os-on-emmc-from-usb-otg.md)
+
 ## 系统
 
 ### 问题一： Radxa APT 公钥不可用

docs/rock5/rock5b/low-level-dev/bootloader_spi_flash.md

@@ -45,7 +45,7 @@ ROCK 5B 上有一个 SPI Flash（SPI 闪存），它包含用于备份引导的b
    ```
 
    - 下载最新版本 spi bootloader
-     推荐除 Armbian 用户之外的用户使用通用版本，注意这个 img 已经关闭 u-boot 串行控制台
+     (推荐除 Armbian 用户之外的用户使用下面这个通用版本，注意这个 img 已经关闭 u-boot 串行控制台)
 
    ```bash
    wget https://dl.radxa.com/rock5/sw/images/loader/rock-5b/release/rock-5b-spi-image-g49da44e116d.img

docs/rock5/rock5b/low-level-dev/erase-spi-from-usb-otg.md

@@ -0,0 +1,37 @@
+---
+sidebar_position: 21
+---
+
+# 清空 SPI Flash
+
+## 方法一： 在板子上执行清空指令
+
+从 SD 卡或者 eMMC 启动 Linux 系统，登录系统后，确认 SPI flash 是否能读到
+
+```bash
+ls /dev/mtdblock*
+```
+
+正常情况下会返回 /dev/mtdblock0,然后执行清空命令
+
+```bash
+sudo dd if=/dev/zero of=/dev/mtdblock0
+sync
+```
+
+## 方法二: 在 Linux PC / Mac 下
+
+首先让设备[进入 MaskRom 模式](./maskrom.md), 然后通过USB线连接 PC 和 设备，
+然后下载 [zero.img](https://dl.radxa.com/rock5/sw/images/others/zero.img.gz) 并解压，然后执行下面的命令
+
+```bash
+rkdeveloptool db rk3588_spl_loader_v1.08.111.bin (其他设备需选择对应的loader文件)
+rkdeveloptool wl 0 zero.img
+rkdeveloptool rd
+```
+
+## 方法三 ： window 下使用 RKDevTool
+
+首先让设备[进入 MaskRom 模式](./maskrom.md)，然后打开 RkDevTool 工具，选择 “Advanced Function”，按照下图上的顺序执行.
+
+![Erase Data](/img/common/rkdevtool/700px-Eraseall_new.webp)

docs/rock5/rock5b/low-level-dev/maskrom.md

@@ -0,0 +1,25 @@
+---
+sidebar_position: 1
+---
+
+### 什么是 Maskrom 模式
+
+Maskrom模式，也称为Loader模式，是一种特殊的启动模式，一般用于恢复或维修有问题的设备。这种模式允许用户直接与设备的硬件进行交互，而不需要经过操作系统。在Maskrom模式下，用户可以通过电脑或其他设备与设备进行通信，并执行一系列命令来解决设备的问题。 可以通过下面的命令看设备是否处于 Maskrom 模式（下面的返回值是 Maskrom 状态下的返回值).
+
+```bash
+# MacOS 端:
+	执行 lsusb 后的结果
+Output:Bus 000 Device 004: ID 2207:350b Fuzhou Rockchip Electronics Co., Ltd. Composite Device
+
+# Linux 端:
+	执行 lsusb 后的结果
+Output:Bus 001 Device 030: ID 2207:350b Fuzhou Rockchip Electronics Company
+
+# Windows 端:
+打开 RKDevTool，就会看到设备处于 Found One MASKROM Device（找到一个 MASKROM 设备）状态。
+```
+
+### 如何进入Maskrom 状态
+
+- 按住 [**Maskrom button**](../README.md).
+- 将 USB A-C 电缆插入 ROCK 5B 的 Type-C 端口，另一端插入电脑。此时正常情况下会进入 Maskrom 状态

i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5b/faq.md

@@ -54,6 +54,18 @@ To troubleshoot if ROCK 5B is defective in the following steps:
 - you can manually add the HDMI resolution and framerate in the /boot/extlinux/extlinux.conf
 - just add video=1920x1080@60 to the append line (just change the resolution and framerate to a resolution your monitor supports)
 
+### Question 3: I flashed image on Emmc with RKDevTool successfully, but after powering on, the Led doesn't flash and there is no output on the screen.
+
+Confirm the cause:
+
+Remove the EMMC Module, MicroSD and NVME devices, and then connect the board and PC via USB cable, then see if the device enters the [Maskrom Mode](./low-level-dev/maskrom.md), if it is not in the Maskrom mode, the probability is due to the following reason:
+
+**you did not press the MaskRom button when you [install system to EMMC via USB ota](./low-level-dev/install-os-on-emmc-from-usb-otg.md), resulting in the system being flashed to the [SPI Flash](README.md), and when the system boots up, it reads the SPI information first, and then an error occurs and the system cannot boot up normally. **
+
+Solution:
+
+[Empty SPI Flash](./low-level-dev/erase-spi-from-usb-otg.md), then follow the steps again [Install system to EMMC via USB OTG](./low-level-dev/install-os-on-emmc-from-usb-otg.md)
+
 ## OS
 
 ### Question 1: Radxa APT public key is not available

i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5b/low-level-dev/bootloader_spi_flash.md

@@ -45,7 +45,7 @@ There are two ways to burn SPI
    ```
 
    - Download the latest version of the spi bootloader
-     The generic version is recommended for all but Armbian users, note that this img disables the u-boot serial console.
+     (The latest version below is recommended for all but Armbian users, note that this img disables the u-boot serial console)
 
    ```bash
    wget https://dl.radxa.com/rock5/sw/images/loader/rock-5b/release/rock-5b-spi-image-g49da44e116d.img