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 two possible contact types.
As an example consider this contact list, containing 4 contact definitions. One for each type.
Example 3.3. 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 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.