# 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:

##

    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.

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 cpChannels. 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.

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.

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.

  If omitted or set to !selected, the currently active channel will be used to send the position information. This, however, is not supported by all radios. Usually, an explicit APRS revert channel must be specified.

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.