MAVLINKHUD

Overview

The AIS parameter group configures the Marine AIS subsystem. This is the nautical equivalent of ADS-B. It allows ArduRover (Boat) to detect nearby commercial vessels equipped with AIS transmitters.

Key Concepts

1. Collision Avoidance

AIS data is fed into the AVOID library. If a vessel is detected on a collision course, the autopilot can warn the operator or autonomously steer away (if avoidance is configured).

2. Hardware

Typically requires a serial AIS receiver connected to a UART port.

Parameter Breakdown

  • AIS_TYPE: 0=Disabled, 1=NMEA (Standard Serial AIS).
  • AIS_TIME_OUT: Time (seconds) without a signal before a vessel is considered lost/gone.
  • AIS_LIST_MAX: Maximum number of vessels to track in memory.

Integration Guide

  1. Hardware: Connect NMEA 0183 AIS Receiver to a Serial Port.
  2. Serial Config: Set SERIALx_PROTOCOL = 40 (AIS). Baud rate usually 38400.
  3. Enable: Set AIS_TYPE = 1.

Developer Notes

  • Library: libraries/AP_AIS
  • Vehicle: ArduRover (Boats).

AIS_LIST_MAX

Default 25
Range 1 100

AIS vessel list size (AIS_LIST_MAX)

Description

Maximum number of vessels to track in the AIS list.

Tuning & Behavior

  • Default Value: 25
  • Range: 1 to 100

AIS_LOGGING

Default 6

AIS logging options (AIS_LOGGING)

Description

Controls which AIS messages are recorded in the data logs.

Tuning & Behavior

  • Default Value: 6 (AIS_OPTIONS_LOG_UNSUPPORTED_RAW | AIS_OPTIONS_LOG_DECODED)
  • Bitmask:
    • 0: Log all AIVDM messages
    • 1: Log only unsupported AIVDM messages
    • 2: Log decoded messages

AIS_TIME_OUT

s
Default 600
Range 1 2000

AIS vessel time out (AIS_TIME_OUT)

Description

Duration after which a vessel is removed from the tracking list if no updates are received.

Tuning & Behavior

  • Default Value: 600 s (10 minutes)
  • Range: 1 to 2000 s

AIS_TYPE

Default 0

AIS receiver type (AIS_TYPE)

Description

Enables and selects the type of Automatic Identification System (AIS) receiver.

Tuning & Behavior

  • Default Value: 0 (None)
  • Values: 0:None, 1:NMEA AIVDM message