Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

refactor:add faq of rock5b #9

Merged
merged 1 commit into from
Mar 29, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 14 additions & 0 deletions docs/rock5/rock5b/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 公钥不可用
Expand Down
7 changes: 0 additions & 7 deletions docs/rock5/rock5b/getting-started/_maskrom.mdx

This file was deleted.

2 changes: 1 addition & 1 deletion docs/rock5/rock5b/low-level-dev/bootloader_spi_flash.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
37 changes: 37 additions & 0 deletions docs/rock5/rock5b/low-level-dev/erase-spi-from-usb-otg.md
Original file line number Diff line number Diff line change
@@ -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)
25 changes: 25 additions & 0 deletions docs/rock5/rock5b/low-level-dev/maskrom.md
Original file line number Diff line number Diff line change
@@ -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 状态
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down

This file was deleted.

Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
Loading