Basic Setup

After installation, let’s configure your first USV system.

Connecting to USV

1. Start Control Platform

jhusv start

The control platform will start at http://localhost:8080.

2. Add USV Device

In the Web interface:

1. Click “Add Device”
2. Enter USV serial number
3. Select connection method (WiFi/4G/5G)
4. Click “Connect”

Or use command line:

jhusv device add --serial USV-2024-001 --connection 4g

3. Verify Connection

jhusv device status

Example output:

Device: USV-2024-001
Status: CONNECTED
Battery: 85%
GPS: FIXED
Connection: 4G (Signal: Excellent)

Basic Configuration

Navigation Parameters

navigation:
  mode: "auto"              # Navigation mode: auto, manual, waypoint
  max_speed: 10             # Maximum speed (knots)
  obstacle_distance: 20     # Obstacle avoidance distance (meters)
  gps_accuracy: 2.5         # GPS accuracy requirement (meters)

Safety Parameters

safety:
  geofence:
    enabled: true
    latitude: [31.2, 31.3]  # Latitude range
    longitude: [121.4, 121.5] # Longitude range

  emergency:
    low_battery: 20         # Low battery threshold (%)
    return_home: true       # Auto return home
    max_distance: 5000      # Maximum distance (meters)

Sensor Configuration

sensors:
  gps:
    enabled: true
    update_rate: 10         # Hz

  imu:
    enabled: true
    calibration: auto

  camera:
    enabled: true
    resolution: "1920x1080"
    fps: 30

Calibrate Sensors

GPS Calibration

jhusv calibrate gps

Wait for GPS signal to stabilize (usually 1-2 minutes).

IMU Calibration

jhusv calibrate imu

Follow the prompts to place the USV in different orientations for calibration.

Compass Calibration

jhusv calibrate compass

Rotate the USV 360° on a horizontal surface.

Test System

Run System Tests

jhusv test all

This will test all subsystems and generate a report.

Manual Testing

1. Motor Test

   jhusv test motor

2. Servo Test

   jhusv test servo

3. Sensor Test

   jhusv test sensors

Save Configuration

All configurations are automatically saved to:

~/.jhusv/config.yaml

You can also export the configuration for backup:

jhusv config export > my-config.yaml

Restore configuration:

jhusv config import my-config.yaml

Next Steps

After configuration, you can:

• 🚀 Create your first mission
• 📖 Learn about hardware overview
• 🎯 Study mission planning

Tips and Recommendations

:::tip Best Practices

• Regularly backup configuration files
• Test in a safe area before actual deployment
• Keep firmware updated to the latest version :::

:::warning Note

• All sensor calibrations must be completed before first use
• Ensure geofence settings are correct
• Avoid use in severe weather conditions :::