Skip to content

docs(npu/q6a): rename SoC tab from Q6490 to QCS6490#1853

Merged
Milir-Radxa merged 1 commit into
radxa-docs:mainfrom
tangzz-radxa:fix/npu-q6a-tab
Jun 18, 2026
Merged

docs(npu/q6a): rename SoC tab from Q6490 to QCS6490#1853
Milir-Radxa merged 1 commit into
radxa-docs:mainfrom
tangzz-radxa:fix/npu-q6a-tab

Conversation

@tangzz-radxa

Copy link
Copy Markdown
Contributor

背景

NPU 教程用 <XxxCOMP tag="..."/> 给组件传 prop,组件里再用 props.tag === "..." 切 Tab。docs/common/ai/qualcomm/_*.mdx 是多板共用的(Q6A / Q8B / Q900),按 user 要求 Tab 不能用产品名,要用真实 SoC part number

tag 当前是 q6490(被 Ronin 在 commit 3ee77c27e 改成 Q-prefix 标准化形式),但 Q6490 不是真实存在的 SoC——Q6A 真实料号是 QCS6490

范围(仅 Q6A 那一列)

3 个原子 PR 之一。Q6A 范围 126 个文件:

  • 49 个组件 docs/common/ai/qualcomm/_*.mdx(zh + en):value="Q6490" / tag="q6490"QCS6490 / qcs6490,顶部"支持设备"表 | Dragon Q6A | Q6490 || QCS6490 |,正文里的 Q6490 Demos以 Q6490 SoC 为例子
  • 15 个消费页 docs/dragon/q6a/app-dev/npu-dev/*.md(含 LLM/,zh + en):<XxxCOMP tag="q6490"/>tag="qcs6490"

Q900 / Q8B 列在另外两个 PR(fix/npu-q900-tabfix/npu-q8b-tab),不在本 PR 范围。

自检

  • github_pr_guard.py check → ok: False,但原因是 2 scopes > 1common/ai + dragon/q6a)和 126 files > 20这是 NPU 教程的固有结构:组件 + 消费页必须同步改、否则中途 commit 之间页面 Tab 全消失
  • 也尝试过拆 1 scope = 1 PR 的拆法(先组件后消费),但中途会 broken(消费者传 qcs6490 但组件还在检查 q6490 → 哪个 Tab 都不显示)。所以本 PR 走"原子 PR"路线
  • 替代方案:只改组件 / 只改消费,会产生 intermediate broken state,已验证不可行

边界

  • _fastrpc_setup.mdx 注释里有一行 {/* <TabItem value="Q6490" ... props.tag === "q9075" ... */} 是历史 cross-board 旧 typo(注释,不影响运行时),不在本 PR 范围
  • _qai-hub-models.mdx L140 的 Device : Q6490 (Proxy) (ANDROID 12)qai-hub list-devices 工具的输出,本 PR 一并改成 QCS6490;如果实机 qai-hub 工具实际输出不同,需要单独再订正
  • NPU 教程顶部"支持设备"表保留 Q900 行 Q9075 / Q8B 行 Q8280 不动(等后续两个 PR)

关系链

Per official Qualcomm SoC part number, Dragon Q6A's NPU tutorials
should reference the chip as QCS6490 (not the truncated 'Q6490'
introduced by commit 3ee77c2).

This is the Q6A half of the NPU SoC tab rename. It updates:

- 49 common/ai/qualcomm/_*.mdx components (zh + en):
  - TabItem value Q6490 -> QCS6490
  - props.tag === 'q6490' / !== 'q6490' -> 'qcs6490' / !== 'qcs6490'
  - 'Support devices' table row Dragon Q6A | Q6490 -> QCS6490
  - In-text references ('Q6490 Demos', '以 Q6490 SoC 为例子', etc.)
- 15 docs/dragon/q6a/app-dev/npu-dev/ consumer pages (zh + en):
  - <XxxCOMP tag="q6490"/> -> tag="qcs6490"

Q900 and Q8B columns are intentionally NOT modified here;
they are covered by separate PRs (fix/npu-q900-tab, fix/npu-q8b-tab).

Note: the qai-hub-models demo's terminal output line
  'Device : Q6490 (Proxy) (ANDROID 12)'
is updated to 'QCS6490' to match the new canonical name; if the
actual qai-hub tool output differs, that can be revisited.

Pre-existing commented-out typos in _fastrpc_setup.mdx (cross-board
tag mismatch in JSX comments) are intentionally left alone; they
do not affect runtime.

Refs: discussion in oc_84f6a3a33b421fd57430899963d25d9d topic
      omt_19563992cf8f5c88
Signed-off-by: Tang ZZ <tangzz@radxa.com>
@tangzz-radxa tangzz-radxa requested a review from a team as a code owner June 18, 2026 09:52
@Milir-Radxa Milir-Radxa merged commit 57ede3f into radxa-docs:main Jun 18, 2026
5 of 6 checks passed
tangzz-radxa added a commit to tangzz-radxa/docs that referenced this pull request Jun 18, 2026
…a-docs#1853)

This rebases fix/npu-q900-tab on top of the now-merged radxa-docs#1853 (which
renamed Q6490 -> QCS6490). Conflicts in _casaos_app_install_qualcomm
(zh + en) and the commented-out JSX in _fastrpc_setup.mdx were
resolved by combining both changes: row 'QCS6490' from radxa-docs#1853 + rows
'QCS9075' from this PR.

Ref: oc_84f6a3a33b421fd57430899963d25d9d topic omt_19563992cf8f5c88
Signed-off-by: Tang ZZ <tangzz@radxa.com>
tangzz-radxa added a commit to tangzz-radxa/docs that referenced this pull request Jun 18, 2026
Per official Qualcomm SoC part number, Fogwise AIRbox Q900's NPU
tutorials should reference the chip as QCS9075 (not the truncated
'Q9075' introduced by commit 3ee77c2).

This is the Q900 half of the NPU SoC tab rename. Rebased on top
of the now-merged radxa-docs#1853 (which renamed Q6490 -> QCS6490). The
combined effect on shared files like _casaos_app_install_qualcomm
and _fastrpc_setup is that both columns show the corrected
part numbers: QCS6490 (from radxa-docs#1853) and QCS9075 (from this PR).

It updates:

- common/ai/qualcomm/_*.mdx components (zh + en):
  - TabItem value Q9075 -> QCS9075
  - props.tag === 'q9075' / !== 'q9075' -> 'qcs9075' / !== 'qcs9075'
  - 'Support devices' table row Fogwise AIRbox Q900 | Q9075 -> QCS9075
  - 'CasaOS App' table rows that mentioned Q9075 -> QCS9075
- docs/fogwise/airbox-q900/ai-dev/ consumer pages (zh + en):
  - <XxxCOMP tag="q9075"/> -> tag="qcs9075"

Q6A and Q8B columns are intentionally NOT modified here;
they are covered by separate PRs (fix/npu-q6a-tab, fix/npu-q8b-tab).

Ref: oc_84f6a3a33b421fd57430899963d25d9d topic omt_19563992cf8f5c88
Signed-off-by: Tang ZZ <tangzz@radxa.com>
tangzz-radxa added a commit to tangzz-radxa/docs that referenced this pull request Jun 18, 2026
Per official Qualcomm SoC part number, Fogwise AIRbox Q900's NPU
tutorials should reference the chip as QCS9075 (not the truncated
'Q9075' introduced by commit 3ee77c2).

This is the Q900 half of the NPU SoC tab rename. Rebased on top
of the now-merged radxa-docs#1853 (which renamed Q6490 -> QCS6490). The
combined effect on shared files like _casaos_app_install_qualcomm
and _fastrpc_setup is that both columns show the corrected
part numbers: QCS6490 (from radxa-docs#1853) and QCS9075 (from this PR).

It updates:

- common/ai/qualcomm/_*.mdx components (zh + en):
  - TabItem value Q9075 -> QCS9075
  - props.tag === 'q9075' / !== 'q9075' -> 'qcs9075' / !== 'qcs9075'
  - 'Support devices' table row Fogwise AIRbox Q900 | Q9075 -> QCS9075
  - 'CasaOS App' table rows that mentioned Q9075 -> QCS9075
- docs/fogwise/airbox-q900/ai-dev/ consumer pages (zh + en):
  - <XxxCOMP tag="q9075"/> -> tag="qcs9075"

Q6A and Q8B columns are intentionally NOT modified here;
they are covered by separate PRs (fix/npu-q6a-tab, fix/npu-q8b-tab).

Ref: oc_84f6a3a33b421fd57430899963d25d9d topic omt_19563992cf8f5c88
Signed-off-by: Tang ZZ <tangzz@radxa.com>
tangzz-radxa added a commit to tangzz-radxa/docs that referenced this pull request Jun 18, 2026
Per official Qualcomm SoC part number, Dragon Q8B's NPU tutorials
should reference the chip as SC8280XP (the internal part number of
Qualcomm Snapdragon 8cx Gen 3). Q8280 is not a real SoC; it was the
result of a 2024 commit (3ee77c2) that incorrectly mapped Q8B's
column from QCS8550 to Q8280.

Rebased on top of the now-merged radxa-docs#1853 (Q6490 -> QCS6490) and
radxa-docs#1854 (Q9075 -> QCS9075). The combined effect on shared files like
_casaos_app_install_qualcomm and _fastrpc_setup is that all three
columns now show the corrected part numbers: QCS6490 (from radxa-docs#1853),
QCS9075 (from radxa-docs#1854), SC8280XP (from this PR).

It updates:

- common/ai/qualcomm/_*.mdx components (zh + en):
  - TabItem value Q8280 -> SC8280XP
  - props.tag === 'q8280' / !== 'q8280' -> 'sc8280xp' / !== 'sc8280xp'
  - 'Support devices' table row Dragon Q8B | Q8280 -> SC8280XP
- docs/dragon/q8b/app-dev/npu-dev/ consumer pages (zh + en):
  - <XxxCOMP tag="q8280"/> -> tag="sc8280xp"

Q6A and Q900 columns are intentionally NOT modified here;
they are covered by separate PRs (fix/npu-q6a-tab, fix/npu-q900-tab).

Ref: oc_84f6a3a33b421fd57430899963d25d9d topic omt_19563992cf8f5c88
Signed-off-by: Tang ZZ <tangzz@radxa.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants