docs(q8b/model-zoo): re-point SC8280XP AI HUB proxy from QCS8550 to QCS6490 (REQUESTED, needs owner sign-off)#1859
Merged
Milir-Radxa merged 3 commits intoJun 18, 2026
Conversation
…CS6490 Change the Qualcomm AI HUB tip line for SC8280XP from "Qualcomm QCS8550(Proxy)" to "QCS6490", with the wording "SC8280XP 模型和 QCS6490 模型是通用的,请选择 QCS6490" (and the English equivalent). This is the common file shared by Q6A / Q8B / Q900, so the change shows up on all three boards; the AI Developer Home section for SC8280XP (still pointing at Snapdragon X Elite (8380)) is left untouched. NOTE: This change is being made at the explicit request of the support team in chat; it conflicts with the SC8280XP / QCS8550 pairing that was explicitly added in commit e67adac (2026-06-15, author Ronin) and requires explicit sign-off from a product / docs owner before merge. See PR description for the full risk write-up.
Reformat the SC8280XP line in the AI HUB tip to match the other rows in the same tip block (QCS6490, QCS9075), which all use the pattern "<Model> 模型请选择 \`Qualcomm <Proxy>(Proxy)\`". Before: SC8280XP 模型和 QCS6490 模型是通用的,请选择 QCS6490 After: SC8280XP 模型请选择 `Qualcomm QCS6490(Proxy)` The English counterpart is normalised the same way: Before: For SC8280XP models, they are compatible with QCS6490 models, so select `QCS6490` After: For SC8280XP models, select `Qualcomm QCS6490(Proxy)` No other lines in the common file are touched. Risk notes from the previous commit still apply (this is still a common file used by Q6A / Q8B / Q900, and still conflicts with commit e67adac on the SC8280XP / QCS8550 pairing).
…HUB tip Per a follow-up note in the support topic, restore the "和 QCS6490 模型是通用的" explanation in front of the proxy name, while keeping the SC8280XP line in the same `Qualcomm <Proxy>(Proxy)` format as the QCS6490 / QCS9075 rows in the same tip. Before: SC8280XP 模型请选择 `Qualcomm QCS6490(Proxy)` After: SC8280XP 模型和 QCS6490 模型是通用的,请选择 `Qualcomm QCS6490(Proxy)` English counterpart normalised the same way: Before: For SC8280XP models, select `Qualcomm QCS6490(Proxy)` After: For SC8280XP models, they are compatible with QCS6490 models, so select `Qualcomm QCS6490(Proxy)` The AI Developer Home section for SC8280XP (still pointing at `Snapdragon X Elite (8380)`) is intentionally left untouched, since the note refers to the AI HUB tip block. Risk notes from the earlier commits in this branch still apply: this is the Q6A / Q8B / Q900 shared common file, and the change still conflicts with commit e67adac on the SC8280XP / QCS8550 pairing.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
In the Q8B model-zoo tutorial, re-point the Qualcomm AI HUB proxy selection for SC8280XP from
Qualcomm QCS8550(Proxy)toQualcomm QCS6490(Proxy), and add a short和 QCS6490 模型是通用的 / compatible with QCS6490explanation in front of the proxy name. The row keeps the sameQualcomm <Proxy>(Proxy)selection format as the QCS6490 / QCS9075 rows in the same:::tipblock.Touched files (both Chinese source and English translation, in the shared common):
docs/common/ai/qualcomm/_qairt-model-zoo.mdxi18n/en/docusaurus-plugin-content-docs/current/common/ai/qualcomm/_qairt-model-zoo.mdxFinal diff (Chinese, in the AI HUB
:::tipblock):English:
The AI Developer Home section for SC8280XP (still pointing at
Snapdragon X Elite (8380)) is intentionally left untouched, since the explanation refers to the AI HUB tip block specifically.Why three commits instead of one
The branch is intentionally not force-squashed; the three commits mirror the iteration that happened in the support topic:
c5b2ee1c6— initial wording directly from the original chat request (含"和 QCS6490 模型是通用的")02e0a5eb0— review note "参考其他型号表达的格式和风格": dropped the explanation and aligned the row to theQualcomm <Proxy>(Proxy)pattern of its siblings232dc422f— follow-up "后面的提示也修改下": restored the explanation in front of the proxy name while keeping the format-aligned selectionKeeping the iteration visible makes the review history traceable back to the conversation; reviewers can squash on merge if they prefer a single commit.
The two files above live under
common/ai/qualcomm/and are imported by Q6A, Q8B, and Q900 (and their English counterparts) via:dragon/q6a/app-dev/npu-dev/model-zoo.mddragon/q8b/app-dev/npu-dev/model-zoo.mdfogwise/airbox-q900/ai-dev/model-zoo.mdSo this single change updates the model-zoo page on all three boards at once, not just Q8B. The new SC8280XP line appears in the Q6A and Q900 model-zoo pages too, even though they have nothing to do with SC8280XP — that is harmless from a docs-rendering point of view (the other two pages just show the new SC8280XP line inside the same shared tip), but it does mean any rollback has to be coordinated across all three boards.
If the intent is to only affect the Q8B page, the cleaner follow-up is to stop sharing the AI HUB tip across boards: split the SC8280XP line out of the common file into a Q8B-only wrapper, and keep the QCS6490 / QCS9075 lines in the shared common. Happy to follow up with that PR if reviewers want it.
This change directly contradicts the line that was explicitly added on 2026-06-15 in:
e67adac5a—docs(dragon/q8b): revise NPU dev docs with QCS8550 support and fix props.tag across common MDX(author: Ronin dengluoning@radxa.com)That commit added the exact line
QCS8550 模型请选择 Qualcomm QCS8550(Proxy)for SC8280XP, and the same author subsequently renamed it fromQCS8550toSC8280XPon 2026-06-18. Both commits are already merged intomain(latest merge: PR #1855, "fix/npu-q8b-tab"). So this PR is reverting a deliberate, recent docs decision by the Q8B NPU docs owner.Background on why the original
QCS8550choice was made:Qualcomm QCS8550(Proxy)is the AI HUB target that maps to SC8280XP silicon.Why this PR exists anyway
This PR is being opened at the explicit request of a support-team member in the internal 售后技术支持 group, who iterated on the wording three times. The Support Agent (me) is not in a position to unilaterally override a team member's instruction, but it is also flagging the conflict here so that a product / docs owner (likely Ronin) gives explicit sign-off before merge.
If the team confirms the change is correct, please merge as-is. If the change is incorrect, please close this PR and revert in the next docs pass. If the wording needs further adjustment, please leave a review comment and I will follow up.
Checklist
docs/) and English (i18n/en/) updated togetherupstream-docs/mainandgithub_pr_guardpasses (ok: true, bilingual clean, 3 commits / 2 files)