# Contacts

The contacts element specifies a list of all contacts. Each contact is a map that contains a single entry to specify the contact type. The key specifies the type name and the value specifies the actual contact definition. Currently there are three possible contact types.

As an example consider this contact list, containing 4 contact definitions. One for each type.

## Contact definitions

    contacts:
      - dmr: {id: ww, name: WW, type: GroupCall, number: 91}
      - dmr: {id: cont24, name: DM3MAT Hannes, type: PrivateCall, ring: true, number: 2621370}
      - dmr: {id: cont12, name: All Call, type: AllCall, number: 16777215}
      - dtmf: {id: dtmf1, name: DTMF example, number: "#123*"}

A DMR contact is a simple object and is usually defined in one line. Each contact contains an optional id that will be used to reference this contact throughout the codeplug (e.g., in channels, group lists, etc.).

## DMR Contact Fields

id

- Specifies the identifier of the contact. This identifier can later be used to reference the contact. Any unique string is valid.

name

- Specifies the name of the contact. Any string is valid.

type

- Specifies the type of the contact. Must be one of PrivateCall, GroupCall or AllCall.

number

- Specifies the DMR ID for this contact. That is, any integer between 0 and 16777215. This element is mandatory for all types except for the all-call. For the all-call, the default number 16777215 will be used.

ring

- If true, the radio will ring whenever a call from this contact is received (if supported by the radio). Optional, if omitted set to false.

An M17 contact is a simple object and is usually defined in one line. Each contact contains an optional id that will be used to reference this contact throughout the codeplug (e.g., in M17 channels). For now, M17 is only supported by radios running the OpenRTX firmware.

## M17 Contact Fields

id

- Specifies the identifier of the contact. This identifier can later be used to reference the contact. Any unique string is valid.

call

- Specifies the call (M17 ID) of the contact. This must be a string of not more than 9 chars, containing only A-Z, 0-9, ., / & -. See M17 specification

  for details.

broadcast

- Specifies whether the contact is the M17 broadcast destination. Default is false. If true, the call is ignored.

An analog DTMF contact can be used to store commonly used DTMF sequences. For example, it may be used to control the EchoLink feature of a repeater.

id

- Specifies the identifier of the contact. This identifier can later be used to reference the contact. Any unique string is valid.

name

- Specifies the name of the contact. Any string is valid.

number

- Specifies the DTMF ID for this contact. That is any combination of numbers 0-9 and symbols A-D, *, #. used.

ring

- If true, the radio will ring whenever a call from this contact is received (if supported by the radio). Optional, if omitted set to false.