# Radio settings

The radio settings section contains all radio-wide settings. For example the microphone level, boot text etc. For sake of readability, they are organized in groups. E.g., boot options, audio settings, ...

As an example, consider the following general settings

## General radio-wide settings.

    settings:
      defaultID: id1
      power: High
      boot:
        display: Logo
        introLine1: qDMR
        introLine2: DM3MAT
        enablePassword: false
        password: 00000815
        defaultChannel: true
        zoneA: zone1
        channelA: ch1
        zoneB: zone1
        channelB: ch2
        allowFactoryReset: true
      audio:
        squelch: 1
        dmrSquelch: none
        micGain: 6
        fmMicGain: none
        m17MicGain: none
        maxSpeakerVolume: 10
        maxHeadphoneVolume: 10
        vox: off
        voxDelay: 500ms
        speech: false
      gnss:
        fixedLocationEnabled: false
        fixedLocation: JO62jl45
        systems: [GPS, Beidou]
        units: Metric
      dmr:
        privateCallMatch: true
        groupCallMatch: true
        privateCallHangTime: 5s
        groupCallHangTime: 3s
        sendTalkerAlias: false
        talkerAliasEncoding: Iso8
        smsFormat: DMR
        preamble: 100ms

Here, the microphone amplification is set to 6, the speech synthesis is disabled, the two boot text lines are set to qDMR and DM3MAT respectively and the default DMR radio ID is set to id1. The latter is the id of a radio ID defined below.

Also, the radio-wide default squelch, VOX and power level is set. These values can be referenced later in channels. Also, some radios do not allow for these settings to be applied on a per-channel basis. For these radios, these values are used.

## Radio-wide Setting Fields

introLine1

introLine2

- Sets the two boot text lines (if supported by the radio). These text lines will show up on the boot of the radio. If the radio is set to show a picture during boot, these lines are not shown.

defaultID

- Specifies which radio ID will be used as the default DMR ID (see cpRadioIDs below). If none is specified, the first defined DMR radio ID will be used.

power

- Specifies the default transmit power. This value may be referenced in channels or represent the radio-wide power setting. Possible values are Min, Low, Mid, High and Max.

Some settings relevant for the boot process.

display

- Specifies what is shown during the boot process. This must be one of Logo, Image or text. Where Logo is usually the manufacturer logo and the default

passwordEnabled, password

- Enables and specifies the boot password. This is usually a 8-digit number that must be entered into the radio to boot it.

defaultChannel, zoneA, channelA, zoneB, channelB

- Enables and specifies the channels and zones that are selected after boot. If disabled, usually the last used channels/zones are selected. If specified, the channel must be member of the zone. To select a zone/channel assign the corresponding zone/channel id.

allowFactoryReset

- If true, allows to factory reset the device during reboot. This can be used to clear an incompatible codeplug after the firmware has been updated. Sometime, this must be enabled to enter the firmware programming mode.

This section groups all global audio settings. Some of these can be overridden by channel settings.

squelch

- Specifies the default squelch level. This value may be referenced in channels or represent the radio-wide squelch setting. Any value in [0-10] is valid, where 0 implies an open squelch (if supported by the radio).

dmrSquelch

- Specifies a separate squelch level for DMR channels. If set to none, the default squelch is used.

micGain

- Specifies the microphone amplification. Must be an integer between 1 and 10.

fmMicGain, m17MicGain

- Specifies a separate microphone gain for FM and DMR channels. If set to none, the default mic gain setting will be used.

maxSpeakerVolume, maxHeadphoneVolume

- Specifies the maximum speaker/headphone volume setting. This can be used to limit the maximum volume, when the radio is used indoors.

vox

- Specifies the default VOX sensitivity. This value may be referenced in channels or represent the radio-wide VOX sensitivity. Any value in [0-10] is valid here, where 0 disables the VOX.

voxDelay

- Specifies the delay between voice detection and start of transmission.

speech

- Enables/disables the speech synthesis. Some radios can announce the current channel etc. for the visually impaired. To enable that feature (if supported by the radio) set this field to true. Must be a boolean value.

This section collects some global GNSS settings that many radio support. Especially, it allows to specify a fixed location that can be used by the radio, if it does not support GPS.

## Radio-wide GNSS Setting Fields

fixedLocationEnabled, fixedLocation

- Specifies and enables a fixed location. This location can be used instead of a GNSS position. The location is specified in terms of a locator.

systems

- Specifies the GNSSs to use in terms of a list of GPS, Glonass, Galileo, Beidou.

units

- Specifies the units to use to show distances and speeds. Must be one of Metric or Archaic.

This section collects some global DMR settings that many radio support. Like sending a talker alias and specifying the SMS format.

## Radio-wide DMR Setting Fields

privateCallMatch, groupCallMatch

- Enable private and group call matches. Must either be true or false.

  If private-call match is enabled, the radio only receives private calls for the radio. all other private calls are ignored.

  If group-call match is enabled, the radio only receives group calls that are in the group list of the current channel. All other group calls are ignored.

privateCallHangTime, groupCallHangTime

- Specifies, how long a private and group call can be answered directly by pressing PTT. That is, how long the call hangs around, before the default transmit contact for the current channel gets active again.

  The duration must be specified with units. By default, the duration for private calls is 5s while the duration for group calls is 3s.

sendTalkerAlias, talkerAliasEncoding

- Enables sending the talker alias -- that is, the radio name along with the DMR ID. This enables receives to show your radio name, if the receiver does not contain your DMR ID in its call-sign DB.

  Current DMR networks inject the talker alias based on the global DMR ID database. Consequently, this feature is of little use. It might be relevant for commercial applications and simplex connections.

  If used, talkerAliasEncoding specifies the encoding of the alias. It must be one of Iso7, Iso8 or Unicode.

preamble

- Specifies the duration of the DMR transmit preamble. The duration must be specified with units. Usually this is set to 100ms.