# General configuration

The figure below shows the General Configuration tab of qdmr. This tab is divided into Five subtabs: Boot Settings, Audio Settings, Tone Settings, Channel Default Values and Extensions.

Screen shot of the general configuration tab showing the boot settings.

## General settings tab.

Within the Boot Settings, the Intro Line 1 & 2 specify the text that some radios show on startup. You may enter any text here. Some radios show an image during boot. For those radios, these settings have no effect.

Screen shot of the audio settings.

## Audio settings tab.

Within the Audio Settings, the Default Microphone Amplification specifies (by default) the common mic gain for all modes. This must be a value between 1 and 10, where 1 is the smallest amplification and 10 the loudest. A separate FM Microphone Amplification can be specified below. If Default is selected, the default microphone gain is used instead.

The Default Squelch specifies the common squelch level for all modes. This must either be Open or a value between 1 and 10. The larger the value, the stronger the station must be to open the squelch. A squelch level is usually only relevant for FM channels. Some radios allow to set a separate DMR squelch level. This can be done with the DMR Squelch field. If Default is checked, the default (FM) squelch is used.

The VOX Sensitivity field specifies the sensitivity of the VOX (voice-operated-switch). If set to Off, the VOX is disabled. Otherwise, a value between 1 and 10 must be selected. The larger the value, the louder you have to talk into the radio, to trigger the VOX. There is also VOX Delay field, specifying a delay before the VOX is triggered. This can be used to avoid unintentional transmission of short loud bursts, for example in some working environments.

The Maximum Speaker and Maximum Headphone Volumes allow for limiting the loudness the speaker or headphone. This can be used to adapt the range of volume knob on the radio to the current working environment.

The Speech Synthesis option allows for enabling speech synthesis by the radio. Some radios support speech synthesis to help visually impaired operators to handle the radio and navigate its menus. If this option is checked, the speech-synthesis will be enabled if the radio supports this feature.

Screen shot of the tone settings.

## Tone settings tab.

The tone settings control some of the sounds generated by the radio. Especially, some radios allow to disable all sounds globally. Or to enable/disable or set the volume of the key tones.

The SMS tone, Ringtone and Talk permit fields allow to enable/disable tones sounding, when an SMS, a private all is received or if it is allowed to transmit on the currently active channel according to the admit criterion set for that channel. The SMS and private call tones can only be enabled or disabled globally, while the talk-permit tone can be enabled on a by-channel-type basis. To enable/disable the tone for channel types, click on the pen icon.

The remaining tone-settings concern the boot, call-start, call-end, channel-idle and call-reset melodies. These can either be enabled/disabled globally (e.g., boot and call-reset melodies) or enabled for channel types individually. Again, click on the pen button to select the channel types. Some radios allow for programming custom melodies for these tones. These melodies can be specified in LilyPond format and speed in BPM (beats per minute). The play-button on the right plays the specified melody.

qdmr uses a simplified LilyPond format. It consists of a simple, white-space separated list of notes and pauses. The general format is

Name[Length][Ocave][.]

Name must be a note name (i.e., c, cis, d, dis, e, f, fis, g, gis, a, ais or b) or r for a pause (rest).

The length specifies the length of the note or pause. It must be one of 1, 2, 4, 8, 16 or 32, specifying a whole, half, quarter, ... note. Adding a dot (.) to the end of the note extends it by half of its length. I.e. a4. will be 3/8th long. The length can also be omitted. In this case, the length of the previous not is re-used. Consequently, the first note need an explicit length.

Finally, by adding one or more ' the octave can be increased, while adding one or more , the octave of a note can be decreased. It is not possible to specify the octave of the entire melody.

Screen shot of the channel default settings.

## Channel default settings tab.

The Channel Default Values block allows to specify some default values that can be referenced by channels (see guiChannels below). This serves two use cases. First, it allows to set some channel properties for all channels that reference these values at once. More importantly, however, some radios do not allow to set these options on a per-channel basis. For those radios, these values are used for all channels.

Screen shot of the settings extensions.

## Settings extensions tab.

Finally, the tab labeled Extensions contains extensions. This view allows to add, remove and edit device specific radio settings. All device specific settings are handled and displayed in the same way. See guiExtensions for some description of this process.