Skip to content

docs: compile TROUBLESHOOTING.md with CUDA and drone errors (closes #63)#129

Closed
DsThakurRawat wants to merge 1 commit into
FastCrest:mainfrom
DsThakurRawat:docs/troubleshooting
Closed

docs: compile TROUBLESHOOTING.md with CUDA and drone errors (closes #63)#129
DsThakurRawat wants to merge 1 commit into
FastCrest:mainfrom
DsThakurRawat:docs/troubleshooting

Conversation

@DsThakurRawat
Copy link
Copy Markdown
Collaborator

@DsThakurRawat DsThakurRawat commented May 14, 2026

Description

Introduces docs/TROUBLESHOOTING.md to help users quickly resolve common deployment and configuration errors at the edge, in the cloud, and on robots/drones.

Key Additions:

  • CUDA & GPU Errors: Fixes for libcudnn version mismatches, insufficient NVIDIA drivers, and GPU OOM during graph capture.
  • Jetson-Specific Issues: Solutions for JetPack versioning and thermal throttling during continuous inference.
  • ROS2 Bridge Issues: Debugging steps for missing state data and missing ROS2 (rclpy) installations.
  • Drone & MAVROS Issues: Specific fixes for MAVROS FCU connections, missing IMU data, and action output routing.
  • Export & Validation: Handling opset incompatibilities and 'Not yet verified' statuses.
  • Quick Diagnostics: A handy cheat sheet of commands (nvidia-smi, reflex doctor, etc.).

Type of Change

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • Documentation update
  • Infrastructure / CI update

How Has This Been Tested?

  • pytest tests/ passes locally
  • reflex doctor sanity check
  • Other (please specify): Verified formatting and cross-referenced with codebase/schema.

Checklist

  • My code follows the style guidelines of this project
  • I have performed a self-review of my own code
  • I have commented my code, particularly in hard-to-understand areas
  • I have made corresponding changes to the documentation
  • My changes generate no new warnings
  • I have added tests that prove my fix is effective or that my feature works
  • New and existing unit tests pass locally with my changes
  • I have kept the PR scoped to a single concern (one concern per PR)

@rylinjames
Copy link
Copy Markdown
Collaborator

Thanks @DsThakurRawat — the error-signature coverage in this PR (libcudnn mismatch, CUDA OOM, JetPack version, MAVROS FCU connection, opset rollback, the whole catalog) is real and useful. Credit preserved via Co-Authored-By on the commit in the replacement PR.

Same lighter-touch approach I took with #130: this is content that needed grounding more than rewriting. The replacement only refreshes:

All your other error patterns and fix commands kept verbatim — they're correct and battle-tested. Closing in favor of the replacement PR. Please keep contributing!

@rylinjames rylinjames closed this May 16, 2026
rylinjames added a commit that referenced this pull request May 16, 2026
 #63) (#137)

Adds docs/troubleshooting.md with the most common error signatures and
fixes Reflex users hit on edge devices, cloud GPUs, ROS2 robots, and
drones. Structure: CUDA/GPU → Jetson → ROS2 bridge → Drone/MAVROS →
Export/validation → Registry → Quick diagnostics.

Adapted from #129 — kept all the original error signatures and fix
patterns (they're real and useful). Only refreshed:
- onnxruntime-gpu pin: 1.18.0 → >=1.25.1 (matches v0.9.2 floor)
- cuDNN floor: 9.0+ → 9.5+ (matches v0.9.2 floor)
- Driver floor: R525+ → R555+ for cuDNN 9.5+ (per v0.9.4 doctor guard)
- Added Blackwell sm_120 section (RTX 5090 / B200) per v0.9.3 guard
- Added the four v0.9.4 reflex doctor guards as the prescribed first
  step on any failure (multi-GPU arch, Jetson R35, cuDNN/driver skew,
  TRT EP empirical session test)
- Replaced #129's reference to PR #121 with the actual shipped
  --state-msg-type flag from #133 (joint_state/imu/odom dispatch)
- Updated cross-ref from understanding_verification.md → verification.md
  (renamed in #136)
- Updated cross-ref to adding_a_robot.md (shipped in #135)
- File renamed TROUBLESHOOTING.md → troubleshooting.md for consistency
  with sibling docs (lowercase, no ALL_CAPS)

Supersedes #129.

Co-authored-by: Divyansh Rawat <186957976+DsThakurRawat@users.noreply.github.com>
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.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