Skip to content

docs(qualcomm): add fastrpc /dev/ device check and troubleshooting section#1783

Open
tangzz-radxa wants to merge 1 commit into
radxa-docs:mainfrom
tangzz-radxa:support/fastrpc-troubleshoot-v2
Open

docs(qualcomm): add fastrpc /dev/ device check and troubleshooting section#1783
tangzz-radxa wants to merge 1 commit into
radxa-docs:mainfrom
tangzz-radxa:support/fastrpc-troubleshoot-v2

Conversation

@tangzz-radxa
Copy link
Copy Markdown
Contributor

Summary

Add a device-node pre-check and troubleshooting section to the FastRPC/NPU setup docs for Qualcomm-based boards (Dragon Q6A / Airbox Q900).

Problem

GitHub issue #1782: User on Dragon Q6A + Ubuntu 24.04 installed packages, but device nodes never appeared. Running failed with . Root cause: the kernel FastRPC driver was not loaded.

The existing docs jumped straight from to without any verification step.

Changes

  • New section "检查 /dev/fastrpc* 设备节点" (CN) / "Check /dev/fastrpc* device nodes" (EN):
    • to verify device nodes exist before running the test
    • If missing: to check driver load status
    • If not loaded: to load driver manually
    • Tip: RadxaOS official image includes the driver by default; third-party Ubuntu/self-built kernels may be missing it

Testing

  • Docs lint: passed (structure unchanged, only content additions)
  • Bilingual: CN () + EN () updated simultaneously

Files

  • (+25 lines)
  • (new, +193 lines)

Fixes #1782

…ction

Fixes radxa-docs#1782

- Add pre-flight check: ls /dev/fastrpc* before running test
- Add troubleshooting steps when device nodes are missing:
  - lsmod check for fastrpc kernel driver
  - modprobe qcom_fastrpc to load driver manually
  - Remind users to use official RadxaOS image (driver pre-installed)

Triggered by GitHub issue radxa-docs#1782: Dragon Q6A + Ubuntu 24.04 user
installed fastrpc packages but /dev/fastrpc* did not exist because
the kernel driver was not loaded. The docs previously jumped straight
to fastrpc_test without verifying device node presence.
@tangzz-radxa tangzz-radxa requested a review from a team as a code owner May 28, 2026 11:43
@Milir-Radxa Milir-Radxa requested a review from zifeng-radxa June 2, 2026 02:06
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.

FastRPC/NPU not working on Dragon Q6A - /dev/fastrpc* missing

1 participant