Personal Page of DM3MAT

Positioning Systems

Some radios allow to send the current position using DMR or analog APRS. Consequently, there are two types of positioning systems dmr and aprs.

As an example, consider these two position reporting systems:

Example 3.8. 

positioning:
  - dmr:
      id: aprs1
      name: BM ARPS
      period: 300
      contact: cont21
  - aprs:
      id: aprs2
      name: APRS APAT81
      period: 300
      revert: ch104
      icon: Jogger
      message: Y07, QRG 144.675
      destination: APAT81-0
      source: DM3MAT-7
      path: [WIDE1-1, WIDE2-1] 

The first specifies a digital (DMR) positioning system while the latter defines a APRS system.

Common attributes

The following attributes apply to both, analog APRS and digital DMR position reporting systems.

Common fields

id

Specifies the ID of the system. This can be used reference this system in the section called “Channels”. Any unique string is valid here.

name

Specifies the name of the position reporting system. Any string is valid here.

period

Specifies the update period in seconds. If omitted or set to 0, the system will not send any updates periodically.

DMR position reporting system attributes

The following attributes apply only to digital (DMR) position reporting systems.

DMR position reporting system fields

contact

Specifies the digital contact, the GPS information is sent to. This must be a reference to a digital contact.

revert

Specifies the revert channel. That is, the channel the data is sent on. If set, it must be a reference to a digital channel. If omitted or set to !selected, the currently active channel will be used to send the GPS information.

APRS attributes

The following attributes apply only for APRS position reporting systems.

Analog position reporting system (APRS) fields

revert

Specifies the revert channel. That is, the channel the APRS information is sent on. This must be a reference to an analog channel. Usually a dedicated analog APRS channel is defined and referenced here.

destination

Specifies the destination call and SSID, the information is sent to. This must be a string in the form CALL-SSID. Please note that the call must match the format defined by the AX.25 protocol. That is, it may only contain letters and numbers and cannot exceed the length of 6.

source

Specifies the source call and SSID. See destination for details.

path

Specifies the optional packet path. If set, this must be a list of CALL-SSID strings.

icon

Specifies the icon name to use. The icon name will be fuzzy matched. See for a complete list of icon names.

message

Specifies an optional message sent along with the position information.