Troubleshooting

Common issues and solutions.

Connection Issues

USV Cannot Connect

Symptoms: Unable to connect to USV device

Possible Causes:

1. Network connection problem
2. Firewall blocking
3. USV not powered on or low battery

Solutions:

# Check network connection
jhusv network check

# Test connection
ping <usv-ip-address>

# Check firewall
sudo ufw status

# Check device status
jhusv device status

Frequent Disconnections

Symptoms: USV frequently disconnects

Solutions:

• Check signal strength
• Replace communication module
• Check power supply

GPS Issues

Weak GPS Signal

Symptoms: GPS positioning inaccurate or unable to locate

Solutions:

# Check GPS status
jhusv sensors check gps

# Recalibrate
jhusv calibrate gps

# Wait for GPS lock (usually 1-2 minutes)

RTK Cannot Connect

Symptoms: RTK base station connection failed

Solutions:

1. Check network connection
2. Verify RTK base station configuration
3. Confirm account permissions

Sensor Issues

Abnormal Sensor Data

Symptoms: Sensors return abnormal data

Solutions:

# Calibrate sensors
jhusv calibrate sensors

# Check sensor connections
jhusv sensors check

# View sensor logs
jhusv logs sensors

Mission Execution Issues

Mission Cannot Start

Symptoms: Mission cannot start after creation

Possible Causes:

1. Mission configuration error
2. USV status does not meet requirements
3. Insufficient system resources

Solutions:

# Validate mission configuration
jhusv mission validate mission.yaml

# Check USV status
jhusv device status

# View system logs
jhusv logs system

Mission Interrupted

Symptoms: Mission unexpectedly interrupted during execution

Solutions:

1. Check battery level
2. View event logs
3. Check if safety limits were triggered

# View mission logs
jhusv mission log <mission_id>

# View events
jhusv events list --filter mission

Performance Issues

Slow System Response

Solutions:

# Check system resources
jhusv system status

# Clear cache
jhusv cache clear

# Optimize database
jhusv database optimize

Data Issues

Data Loss

Symptoms: Partial data missing

Solutions:

1. Check storage space
2. View backups
3. Check cloud sync status

# Check storage space
jhusv storage status

# Restore backup
jhusv backup restore <backup_file>

# Sync cloud data
jhusv cloud sync

Getting Help

If the issue is still not resolved:

1. 📖 View complete documentation
2. 💬 Visit official website
3. 📧 Contact technical support: support@jhusv.com
4. 🐛 Report Bug

Diagnostic Tools

System Diagnostics

# Run full diagnostics
jhusv doctor

# Generate diagnostic report
jhusv doctor --report diagnostic_report.txt

Log Collection

# Collect all logs
jhusv logs collect --output logs.tar.gz

# Send to technical support
jhusv support send-logs logs.tar.gz