docs(orion): add Debian 13 CIX PPA guides for O6 and O6N by xzl01 · Pull Request #1668 · radxa-docs/docs

xzl01 · 2026-04-14T08:24:22Z

Summary

add Debian 13 CIX PPA guides for Orion O6 and O6N
add Chinese and English other-os entries for both boards
add download page entry and mention the required BIOS ACPI SCMI setting

Copilot

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.

Copilot · 2026-04-14T08:29:07Z

+```bash
+sudo apt update
+sudo apt upgrade


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.

Suggested change

```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

Copilot · 2026-04-14T08:29:08Z

+
+## 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)


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.

Suggested change

- [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)

Copilot · 2026-04-14T08:29:08Z

+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


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).

Suggested change

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

Copilot · 2026-04-14T08:29:09Z

+```bash
+curl -fsSL https://archive.cixtech.com/cix-repo-community.sh | sudo sh
+```


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).

Copilot · 2026-04-14T08:29:09Z

+```bash
+sudo apt update
+sudo apt upgrade
+sudo apt full-upgrade
+```


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.

Copilot · 2026-04-14T08:29:10Z

+```bash
+curl -fsSL https://archive.cixtech.com/cix-repo-community.sh | sudo sh
+```


直接使用 curl ... | sudo sh 会把远端返回内容以 root 权限执行，安全风险较高。建议文档中改为先下载到本地文件、检查后再执行（或至少提醒用户校验脚本/签名/校验和）。

Copilot · 2026-04-14T08:29:11Z

+开源驱动方案依赖 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


这里的 Debian backports 源使用了 HTTP（deb.debian.org），传输链路不加密，存在被中间人篡改的风险。建议改为 HTTPS，并尽量写入 /etc/apt/sources.list.d/ 下的独立 .list 文件，避免直接追加到 sources.list 造成重复或难以回滚。

Suggested change

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

Copilot · 2026-04-14T08:29:11Z

+```bash
+curl -fsSL https://archive.cixtech.com/cix-repo-community.sh | sudo sh
+```


直接使用 curl ... | sudo sh 会把远端返回内容以 root 权限执行，安全风险较高。建议文档中改为先下载到本地文件、检查后再执行（或至少提醒用户校验脚本/签名/校验和）。

Copilot · 2026-04-14T08:29:11Z

+```bash
+sudo apt update
+sudo apt upgrade


这里同时给出了 apt upgrade 和紧接着的 apt full-upgrade，按步骤执行会比较冗余，也容易让读者误解为两条都必须跑。建议明确推荐其中一个，或补充说明两者的差异与适用场景。

Suggested change

```bash

sudo apt update

sudo apt upgrade

建议直接使用以下命令完成系统更新：

```bash

sudo apt update

Copilot · 2026-04-14T08:29:12Z

+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


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).

Suggested change

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

docs(orion): add Debian 13 CIX PPA guides for O6 and O6N

6c20054

xzl01 requested a review from a team as a code owner April 14, 2026 08:24

Copilot AI review requested due to automatic review settings April 14, 2026 08:24

Copilot started reviewing on behalf of xzl01 April 14, 2026 08:24 View session

Copilot AI reviewed Apr 14, 2026

View reviewed changes

xzl01 added 7 commits April 14, 2026 16:32

docs(orion): add Debian 13 installation steps before CIX PPA setup

19c3973

docs(orion): point English CIX PPA references to English wiki

bdd5715

docs(orion): use https and dedicated backports source file

6d9310a

docs(orion): harden script and update instructions

7d77af2

docs(orion): remove less command from script steps

0e878bf

docs(orion): clarify CIX PPA menu options

f252cb5

docs(orion): remove regional mirror notes from English guide

0564deb

xzl01 merged commit 821a16c into radxa-docs:main Apr 14, 2026
3 of 6 checks passed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

docs(orion): add Debian 13 CIX PPA guides for O6 and O6N#1668

docs(orion): add Debian 13 CIX PPA guides for O6 and O6N#1668
xzl01 merged 8 commits into
radxa-docs:mainfrom
xzl01:auto/orion-debian13-cix-ppa-v2

xzl01 commented Apr 14, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI Apr 14, 2026

Uh oh!

Copilot AI Apr 14, 2026

Uh oh!

Copilot AI Apr 14, 2026

Uh oh!

Copilot AI Apr 14, 2026

Uh oh!

Copilot AI Apr 14, 2026

Uh oh!

Copilot AI Apr 14, 2026

Uh oh!

Copilot AI Apr 14, 2026

Uh oh!

Copilot AI Apr 14, 2026

Uh oh!

Copilot AI Apr 14, 2026

Uh oh!

Copilot AI Apr 14, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants


		## 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)

	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

Conversation

xzl01 commented Apr 14, 2026

Summary

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Copilot AI Apr 14, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 14, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 14, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 14, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 14, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 14, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 14, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 14, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 14, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 14, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants