Home Assistant

APRS

The aprs (Automatic Packet Reporting System) device tracker integration connects to the APRS-IS network for tracking amateur radio devices.

Configuration

To enable APRS tracking in Home Assistant, add the following section to configuration.yaml:

# Example configuration.yaml entry
device_tracker:
  - platform: aprs
    username: FO0BAR  # or FO0BAR-1 to FO0BAR-15
    callsigns:
      - 'XX0FOO*'
      - 'YY0BAR-1'

Configuration Variables

Looking for your configuration file?
username string Required

Your callsign (or callsign-SSID combination). This is used to connect to the host. Note: Do not use the same callsign or callsign-SSID combination as a device you intend to track: the APRS-IS network will not route the packets to Home Assistant. This is a known limitation of APRS packet routing.

password string (Optional, default: -1)

Your APRS password. This will verify the connection.

callsigns list Required

A list of callsigns you wish to track. Wildcard * is allowed. Any callsigns that match will be added as devices.

host string (Optional, default: rotate.aprs2.net)

The APRS server to connect to.

timeout float (Optional, default: 30.0)

The number of seconds to wait to connect to the APRS-IS network before giving up.

Verified connections are only required to send data to the APRS-IS network, which the aprs platform does not yet do. However, you are free to verify your connection if you know your APRS password.