> ## Documentation Index
> Fetch the complete documentation index at: https://docs.neuronav.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Solve common issues with camera detection, frame rates, tracking, and performance

## Common Issues

### Camera Not Detected

```bash theme={null}
# Check USB devices
lsusb

# Check permissions
sudo usermod -a -G dialout $USER

# Restart udev
sudo udevadm control --reload-rules
```

### Low Frame Rate

* Reduce resolution
* Check USB 3.0 connection
* Disable unnecessary processing

### SLAM Lost Tracking

* Improve lighting
* Reduce motion speed
* Enable IMU fusion
* Check for feature-rich environment

### High CPU Usage

```python theme={null}
config = SensorConfig(
    rgb_width=640,
    rgb_height=480,
    fps=15
)
```

## Debug Tools

### Check Topics

```bash theme={null}
python debug_topics.py
```

### Monitor Performance

```bash theme={null}
# CPU usage
htop

# GPU usage
nvidia-smi

# Memory
free -h
```

## Getting Help

* GitHub Issues: [Report bugs](https://github.com/neuronav-io/neuronav-slam-sdk/issues)
* Documentation: Check specific sensor/algorithm pages
* Email: [eldaniz@neuronav.io](mailto:eldaniz@neuronav.io)