# Button settings

This section describes how the buttons are configured for Radioddity devices.

## Button settings extension example showing default values.

    settings:
      [...]
      radioddity:
        [...]
        buttons:
          longPressDuration: 1 s
          funcKey1Short: ZoneSelect
          funcKey1Long: ToggleFMRadio
          funcKey2Short: ToggleMonitor
          funcKey2Long: ToggleFlashLight
          funcKey3Short: BatteryIndicator
          funcKey3Long: ToggleVox

## Button settings fields

longPressDuration

- Sets the duration, a button must be pressed, to be considered as a long press. This interval is usually expressed in ms. E.g., 1000ms.

funcKey1Short, funcKey1Long

- Short and long-press functions for the programmable function key 1. This is the side key 1 on the GD77 and RD-5R and the P1 button on the GD73.

funcKey2Short, funcKey2Long

- Short and long-press functions for the programmable function key 2. This is the side key 2 on the GD77 and RD5R and the P2 button on the GD73.

funcKey3Short, funcKey3Long

- Short and long-press functions for the programmable function key 3. This is the top key on the GD77 and RD5R This button is not present on the GD73.

## Button functions

None

- Disables the button. No function is associated with it.

ToggleAllAlertTones

- Enables or disables all alert tones. Only present in GD77 and RD5R radios.

EmergencyOn, EmergencyOff

- Why not toggle? Either enables or disables an emergency.

ToggleMonitor

- Enables/toggles the monitor. This is device specific, on some radios the monitor function latches, on most not. Then, the monitor is enabled, as long as the button is pressed.

OneTouch1, OneTouch2, OneTouch3, OneTouch4, OneTouch5, OneTouch6

- Triggers one specific one-touch action. Not all radios have 6 of these. The GD-77 and RD-5R have 6 one-touch actions, while the GD-73 has only 5.

ToggleTalkaround

- Enables/disables the talkaround feature for repeater channels. The radio then also transmits on the RX frequency. Consequently bypassing the repeater.

ToggleScan

- Enables/disables the scan.

ToggleEncryption

- Enables/disables the encryption for the channel, if configured.

ToggleVox

- Enables/disables the VOX for the channel, if configured.

ZoneSelect

- Brings up the zone selection dialog.

BatteryIndicator

- Shows the battery charge indicator.

ToggleLoneWorker

- Enables/disables lone-worker feature, if configured.

PhoneExit

- WTF?!?

ToggleFlashLight

- Enables/Disables the flash light. Not all devices have one.

ToggleFMRadio

- Enables/disables the FM broadcast radio.

RadioCheck,RadioDisable, RadioEnable

- If configured, the radio will transmit tones, that cause other radios --- if configured to do so --- to either response, disable or re-enable themselves. This allows to control other radios remotely.

TBST

- Sends the TBST tone (usually 1750Hz). Some radios have a fixed button combo for that.

CallSwell

- WTF?!?