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

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