Skip to content

docs(penta-sata-hat): add Debian trixie fresh install note for top board package #1796

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

Merged
Milir-Radxa merged 1 commit into from
Jun 4, 2026
Merged

docs(penta-sata-hat): add Debian trixie fresh install note for top board package #1796

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
4 changes: 2 additions & 2 deletions docs/accessories/storage/penta-sata-hat/sata-hat-top-board.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -39,12 +39,12 @@ sudo apt install -y ./rockpi-penta-0.2.2.deb
:::note
**最新 Raspberry Pi OS (Debian trixie) 用户注意**

如果您在最新的 Raspberry Pi OS (Debian trixie) 上遇到以下问题：
`rockpi-penta` 软件包在全新安装的 Raspberry Pi OS (Debian trixie / Debian 13) 上可能无法正常安装；从 Debian 12 升级到 trixie 的系统通常可以正常安装，但 trixie 全新安装可能会失败。在 trixie 上安装或运行后，您还可能遇到以下问题：
- OLED 显示屏只显示静态消息 "RADXA SATA HAT Loading..."
- 风扇固定在 100% 功率
- 服务启动报错 `FileNotFoundError: No such file or directory`

可能需要应用额外的修复。请参考 [GitHub issue #1540](https://github.com/radxa-docs/docs/issues/1540) 中用户报告的解决方案：https://github.com/HabiRabbu/rockpi-penta-pi5-fix
可能需要应用额外的修复。请参考 [GitHub issue #1792](https://github.com/radxa-docs/docs/issues/1792) 和 [#1540](https://github.com/radxa-docs/docs/issues/1540) 中用户报告的解决方案：https://github.com/HabiRabbu/rockpi-penta-pi5-fix
:::

安装软件包后，如果需要修改配置，可以编辑配置文件 `/etc/rockpi-penta.conf`，下面是配置文件的默认值。
Expand Down
6 changes: 3 additions & 3 deletions ...n-content-docs/current/accessories/storage/penta-sata-hat/sata-hat-top-board.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -37,14 +37,14 @@ sudo apt install -y ./rockpi-penta-0.2.2.deb
### Software configuration

:::note
**Note for latest Raspberry Pi OS (Debian trixie) users**
**Notes for latest Raspberry Pi OS (Debian trixie) users**

If you encounter the following issues on the latest Raspberry Pi OS (Debian trixie):
The `rockpi-penta` package may not install cleanly on a fresh Raspberry Pi OS (Debian trixie / Debian 13) system. Systems that upgrade from Debian 12 to trixie usually install the package without issues, but a fresh trixie install may fail. After installing or running on trixie, you may also encounter the following issues:
- OLED display only shows static message "RADXA SATA HAT Loading..."
- Fan stuck at 100% power
- Service startup error `FileNotFoundError: No such file or directory`

Additional fixes may be required. Please refer to the solution reported by users in [GitHub issue #1540](https://github.com/radxa-docs/docs/issues/1540): https://github.com/HabiRabbu/rockpi-penta-pi5-fix
Additional fixes may be required. Please refer to the solutions reported by users in [GitHub issue #1792](https://github.com/radxa-docs/docs/issues/1792) and [#1540](https://github.com/radxa-docs/docs/issues/1540): https://github.com/HabiRabbu/rockpi-penta-pi5-fix
:::

After installing the package, if you need to modify the configuration, you can edit the configuration file `/etc/rockpi-penta.conf`, the following is the default value of the configuration file.
Expand Down
Loading