Skip to content

docs: add troubleshooting section for NPU enablement issues#1593

Open
tangzz-radxa wants to merge 1 commit intoradxa-docs:mainfrom
tangzz-radxa:support/issue-1383-zero3-npu-troubleshooting
Open

docs: add troubleshooting section for NPU enablement issues#1593
tangzz-radxa wants to merge 1 commit intoradxa-docs:mainfrom
tangzz-radxa:support/issue-1383-zero3-npu-troubleshooting

Conversation

@tangzz-radxa
Copy link
Copy Markdown
Contributor

Summary

Adds a troubleshooting section to the RKNN installation guide for when the "Enable NPU" option does not appear in rsetup even after system update.

Why

Based on issue #1383, users have reported that the "Enable NPU" option sometimes remains missing after following the documented steps (system update + reboot). This troubleshooting section provides additional steps to diagnose and resolve the issue, including:

  • Confirming system update success
  • Checking NPU driver status
  • Verifying image version
  • Manual NPU driver installation
  • Hardware compatibility check
  • Guidance for submitting bug reports

Verification

  1. The changes are docs-only and affect only the RKNN installation guide
  2. Both Chinese and English versions are updated
  3. The troubleshooting steps are based on common support scenarios
  4. The PR follows the bilingual check (both docs/ and i18n/en updated)

Fixes #1383

Adds detailed troubleshooting steps for when the 'Enable NPU' option does not appear in rsetup even after system update, based on issue radxa-docs#1383.

The new section includes:
- Confirming system update success
- Checking NPU driver status with lsmod and dmesg
- Verifying image version
- Manual NPU driver installation
- Hardware compatibility check
- Guidance for submitting bug reports

Fixes radxa-docs#1383
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.

Issue from zero/zero3/app-development/rknn-install

1 participant