Troubleshooting

Warning

The AI Accelerator requires ROS 2 Humble, so PolyScope X 10.12.1 is the latest compatible release. PolyScope X 10.13 and later use ROS 2 Jazzy and are not currently supported.

Pick the issue that matches what you see, then open that page. Paths below assume a 2.x compute module: host ~/aia_sdk/ros/, container /workspaces/isaac_ros-dev/.

Complete SDK setup first when the problem is related to first-time install.

What are you seeing?

If you see this…

Open this guide

Setup summary shows SAM: Failure / missing model.onnx

Model restore failed

Console UI window is black or has no camera image

Console UI blank window

No camera stream in AIA Core / PolyScope, or clocks look wrong

Utility scripts (debug_camera_connection.sh, time sync)

Box does not match a known-good SDK / Docker baseline

Utility scripts (aia_sanity_check.sh)

Example fails while another example or terminal session is already running

Existing container not stopped

Disk is full, or you need to delete recordings / retrain cleanly

Clean up data files

Check CPU/GPU load, temperature, or power mode on the compute box

Jetson compute utilities

Need to inspect the Gemini camera (RGB/depth) outside ROS

Orbbec Viewer

Troubleshooting guides