Skip to content

docs(dragon/q6a): add FAQ entry — apt upgrade may cause boot failure #1774

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.

Sign up for GitHub

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

Open
tangzz-radxa wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs(dragon/q6a): add FAQ entry — apt upgrade may cause boot failure #1774

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
20 changes: 20 additions & 0 deletions docs/dragon/q6a/faq.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -137,6 +137,26 @@ vim /usr/share/glib-2.0/schemas/org.gnome.settings-daemon.plugins.power.gschema.
- 系统会以 `EL2` 而不是 `EL1` 启动，此时**可以**使用 KVM
- `/dev/mtd0` 会消失，因此不能直接在板子上更新 SPI 固件

## 为什么运行 `sudo apt upgrade` 后系统无法启动？

直接使用 `sudo apt upgrade` 命令升级系统可能会导致更新不完全或系统异常（如无法启动）。建议使用 Rsetup 工具进行系统更新：

<NewCodeBlock tip="radxa@dragon-q6a$" type="device">

```bash
sudo rsetup
```

</NewCodeBlock>

进入 Rsetup 后，选择 **System** -> **System Update** 完成更新。

详细信息请参考：[系统更新](../system-config/system-update)。

:::warning
如果在更新过程中断电或更新失败，系统可能无法正常启动。此时需要重新刷写系统镜像。
:::

## 7 寸屏显示花屏如何解决？

7 寸屏默认会使用 1080p 分辨率，如果屏幕不支持该分辨率会导致花屏，需要手动设置屏幕分辨率。
Expand Down
20 changes: 20 additions & 0 deletions i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/faq.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -135,6 +135,26 @@ After enabling the hardware encoder, the following changes apply:
- The system boots in `EL2` instead of `EL1`, and KVM **can** be used
- `/dev/mtd0` disappears, so you cannot update the SPI firmware directly on the board

## Why does the system fail to boot after running `sudo apt upgrade`?

Running `sudo apt upgrade` to upgrade the system may cause incomplete updates or system abnormalities (such as failure to boot). It is recommended to use the Rsetup tool for system updates:

<NewCodeBlock tip="radxa@dragon-q6a$" type="device">

```bash
sudo rsetup
```

</NewCodeBlock>

In Rsetup, select **System** -> **System Update** to complete the update.

For more details, please refer to: [System Update](../system-config/system-update).

:::warning
If the power is interrupted or the update fails during the process, the system may fail to boot normally. In this case, you need to re-flash the system image.
:::

## How to Fix 7-inch Display Garbled Screen Issue?

The 7-inch display defaults to 1080p resolution. If the display does not support this resolution, it will cause a garbled screen, and you need to manually set the correct screen resolution.
Expand Down
Loading