docs(orion): add Debian 13 CIX PPA guides for O6 and O6N#1668
Conversation
There was a problem hiding this comment.
Pull request overview
Adds Debian 13 (trixie) documentation for Radxa Orion O6 / O6N, covering installation of the CIX community open-source driver stack, and surfaces these guides via “Other OS” indexes and the Orion download pages (CN/EN), including the required BIOS “Enable ACPI SCMI” note.
Changes:
- Add Debian 13 + CIX community repository installation guides for Orion O6 and O6N (CN + EN).
- Add “Other OS” landing pages for O6 and O6N (CN + EN) to expose the new guides via DocCardList.
- Update Orion download pages (CN + EN) to include a Debian 13 entry and guidance about the BIOS setting.
Reviewed changes
Copilot reviewed 10 out of 10 changed files in this pull request and generated 14 comments.
Show a summary per file
| File | Description |
|---|---|
| i18n/en/docusaurus-plugin-content-docs/current/orion/o6/other-os/debian13.md | New English Debian 13 + CIX driver-stack guide for O6. |
| i18n/en/docusaurus-plugin-content-docs/current/orion/o6/other-os/README.md | New English “Other OS” index page for O6. |
| i18n/en/docusaurus-plugin-content-docs/current/orion/o6n/other-os/debian13.md | New English Debian 13 + CIX driver-stack guide for O6N. |
| i18n/en/docusaurus-plugin-content-docs/current/orion/o6n/other-os/README.md | New English “Other OS” index page for O6N. |
| i18n/en/docusaurus-plugin-content-docs/current/orion/download.md | Add Debian 13 entry + BIOS ACPI SCMI note to English download resources. |
| docs/orion/o6/other-os/debian13.md | New Chinese Debian 13 + CIX driver-stack guide for O6. |
| docs/orion/o6/other-os/README.md | New Chinese “Other OS” index page for O6. |
| docs/orion/o6n/other-os/debian13.md | New Chinese Debian 13 + CIX driver-stack guide for O6N. |
| docs/orion/o6n/other-os/README.md | New Chinese “Other OS” index page for O6N. |
| docs/orion/download.md | Add Debian 13 entry + BIOS ACPI SCMI note to Chinese download resources. |
| ```bash | ||
| sudo apt update | ||
| sudo apt upgrade |
There was a problem hiding this comment.
This section suggests running both apt upgrade and apt full-upgrade back-to-back, which is redundant and can confuse readers. Please pick one recommended command (or explain when to use each) so the maintenance instructions are unambiguous.
| ```bash | |
| sudo apt update | |
| sudo apt upgrade | |
| Use `full-upgrade` for this stack so kernel and driver package dependency changes can be applied in one step: | |
| ```bash | |
| sudo apt update |
|
|
||
| ## References | ||
|
|
||
| - [CIX PPA User Manual (Open-Source Driver Edition)](https://github.com/cixtech/cix-developer-docs/wiki/CIX%20PPA%20%E7%94%A8%E6%88%B7%E6%89%8B%E5%86%8C%EF%BC%88%E5%BC%80%E6%BA%90%E9%A9%B1%E5%8A%A8%E7%89%88%EF%BC%89) |
There was a problem hiding this comment.
The linked “CIX PPA User Manual” URL appears to point to a Chinese-titled wiki page (percent-encoded CJK in the URL). In an English doc, consider adding a “(Chinese)” note or linking an English version if available to avoid surprising readers.
| - [CIX PPA User Manual (Open-Source Driver Edition)](https://github.com/cixtech/cix-developer-docs/wiki/CIX%20PPA%20%E7%94%A8%E6%88%B7%E6%89%8B%E5%86%8C%EF%BC%88%E5%BC%80%E6%BA%90%E9%A9%B1%E5%8A%A8%E7%89%88%EF%BC%89) | |
| - [CIX PPA User Manual (Open-Source Driver Edition) (Chinese)](https://github.com/cixtech/cix-developer-docs/wiki/CIX%20PPA%20%E7%94%A8%E6%88%B7%E6%89%8B%E5%86%8C%EF%BC%88%E5%BC%80%E6%BA%90%E9%A9%B1%E5%8A%A8%E7%89%88%EF%BC%89) |
| The open-source driver stack depends on newer firmware from Debian 13 backports: | ||
|
|
||
| ```bash | ||
| echo "deb http://deb.debian.org/debian trixie-backports main contrib non-free non-free-firmware" | sudo tee -a /etc/apt/sources.list |
There was a problem hiding this comment.
The APT entry uses plain HTTP for deb.debian.org, which weakens transport security (MITM risk). Please switch the repo URL to HTTPS (and consider putting the backports entry in a dedicated file under /etc/apt/sources.list.d/ instead of appending to sources.list).
| echo "deb http://deb.debian.org/debian trixie-backports main contrib non-free non-free-firmware" | sudo tee -a /etc/apt/sources.list | |
| echo "deb https://deb.debian.org/debian trixie-backports main contrib non-free non-free-firmware" | sudo tee -a /etc/apt/sources.list |
| ```bash | ||
| curl -fsSL https://archive.cixtech.com/cix-repo-community.sh | sudo sh | ||
| ``` |
There was a problem hiding this comment.
Piping a remote script directly into sudo sh is risky because it executes whatever is served at that URL as root. Prefer documenting a safer flow (download to a file, review, then execute; or at least mention verifying the script/signature/checksum).
| ```bash | ||
| sudo apt update | ||
| sudo apt upgrade | ||
| sudo apt full-upgrade | ||
| ``` |
There was a problem hiding this comment.
This section suggests running both apt upgrade and apt full-upgrade back-to-back, which is redundant and can confuse readers. Please pick one recommended command (or explain when to use each) so the maintenance instructions are unambiguous.
| ```bash | ||
| curl -fsSL https://archive.cixtech.com/cix-repo-community.sh | sudo sh | ||
| ``` |
There was a problem hiding this comment.
直接使用 curl ... | sudo sh 会把远端返回内容以 root 权限执行，安全风险较高。建议文档中改为先下载到本地文件、检查后再执行（或至少提醒用户校验脚本/签名/校验和）。
| 开源驱动方案依赖 Debian 13 backports 中的较新固件。先执行： | ||
|
|
||
| ```bash | ||
| echo "deb http://deb.debian.org/debian trixie-backports main contrib non-free non-free-firmware" | sudo tee -a /etc/apt/sources.list |
There was a problem hiding this comment.
这里的 Debian backports 源使用了 HTTP（deb.debian.org），传输链路不加密，存在被中间人篡改的风险。建议改为 HTTPS，并尽量写入 /etc/apt/sources.list.d/ 下的独立 .list 文件，避免直接追加到 sources.list 造成重复或难以回滚。
| echo "deb http://deb.debian.org/debian trixie-backports main contrib non-free non-free-firmware" | sudo tee -a /etc/apt/sources.list | |
| echo "deb https://deb.debian.org/debian trixie-backports main contrib non-free non-free-firmware" | sudo tee /etc/apt/sources.list.d/trixie-backports.list |
| ```bash | ||
| curl -fsSL https://archive.cixtech.com/cix-repo-community.sh | sudo sh | ||
| ``` |
There was a problem hiding this comment.
直接使用 curl ... | sudo sh 会把远端返回内容以 root 权限执行，安全风险较高。建议文档中改为先下载到本地文件、检查后再执行（或至少提醒用户校验脚本/签名/校验和）。
| ```bash | ||
| sudo apt update | ||
| sudo apt upgrade |
There was a problem hiding this comment.
这里同时给出了 apt upgrade 和紧接着的 apt full-upgrade，按步骤执行会比较冗余，也容易让读者误解为两条都必须跑。建议明确推荐其中一个，或补充说明两者的差异与适用场景。
| ```bash | |
| sudo apt update | |
| sudo apt upgrade | |
| 建议直接使用以下命令完成系统更新： | |
| ```bash | |
| sudo apt update |
| The open-source driver stack depends on newer firmware from Debian 13 backports: | ||
|
|
||
| ```bash | ||
| echo "deb http://deb.debian.org/debian trixie-backports main contrib non-free non-free-firmware" | sudo tee -a /etc/apt/sources.list |
There was a problem hiding this comment.
The APT entry uses plain HTTP for deb.debian.org, which weakens transport security (MITM risk). Please switch the repo URL to HTTPS (and consider putting the backports entry in a dedicated file under /etc/apt/sources.list.d/ instead of appending to sources.list).
| echo "deb http://deb.debian.org/debian trixie-backports main contrib non-free non-free-firmware" | sudo tee -a /etc/apt/sources.list | |
| echo "deb https://deb.debian.org/debian trixie-backports main contrib non-free non-free-firmware" | sudo tee /etc/apt/sources.list.d/trixie-backports.list |
Summary