Personal Page of DM3MAT

Radioddity™ Codeplug Extensions

This section collects all device specific extensions to the codeplug for Radioddity™ and some Baofeng™ devices.

These extensions are applicable to RadioddityGD77, GD73 and Baofeng/Radioddity RD-5R radios.

Radio settings extension

This extension allows to set the device-specific general settings for Radioddity™ radios. It extends the settings section of the codeplug and is split into several sub-extensions.

General radio settings

This section describes the top-level generic radio settings for Radioddity devices.

Example 4.3. Radio settings extension example showing default values.

settings:
  [...]
  radioddity:
    monitorType: Open
    loneWorkerResponseTime: 1min
    loneWorkerReminderPeriod: 10s
    groupCallHangTime: 3000ms
    privateCallHangTime: 3000ms
    downChannelModeVFO: false
    upChannelModeVFO: false
    powerSaveMode: true
    preambleDuration: 360ms
    wakeupPreamble: true
    allLEDsDisabled: false
    quickKeyOverrideInhibited: false
    txOnActiveChannel: false
    animation: false
    scanMode: Time
    repeaterEndDelay: 0s
    repeaterSTE: 0s    

Radio settings fields

monitorType

Specifies the monitor type. Must be either Open or Silent. Default Open.

loneWorkerResponseTime

When lone worker is enabled, specifies the time in minutes before the radio will start to remind the user. Default 1min. See also Lone Worker.

loneWorkerReminderPeriod

Specifies the period in seconds for the lone worker reminder. Default 10s. See also Lone Worker.

groupCallHangTime

Specifies the group-call hang time in milliseconds. This is the time-period the user can answer a received group call by pressing PTT. After this time has passed, a press on the PTT button will call the default contact on the selected channel. Default 3000ms. See also Hang Time.

privateCallHangTime

Specifies the private-call hang time in milliseconds. This is the time-period the user can answer a received private call by pressing PTT. After this time has passed, a press on the PTT button will call the default contact on the selected channel. Default 3000ms. See also Hang Time.

downChannelModeVFO

If true, the channel-up button will tune the VFO. If false, it will step through the channels. Default false.

upChannelModeVFO

If true, the channel-donw button will tune the VFO. If false, it will step through the channels. Default false.

powerSaveMode

Puts the radio is a sleep mode when in idle state (no traffic on the channels). This allows for some power saving. However, the radio will need some time to wake up. Consequently, all other radios in the network need to transmit a wake-up preamble. Default true.

wakeupPreamble

Enables the transmission of a short wake-up preamble allowing receiving radios to wake-up in time for the actual transmission. Default true.

preambleDuration

This sets the preamble duration in milliseconds. Default 360ms.

powerSaveDelay

Specifies the delay, before an idle radio enters power save mode. (GD-73 only)

allLEDsDisabled

If true, all LEDs are disabled. Default false.

quickKeyOverrideInhibited

If true, allows the user to transmit on a busy channel irrespective of the channels admit criterion by double pressing the PTT. Default false.

txInterrupt

WTF?!?

txOnActiveChannel

If true, the radio will transmit on the currently active channel (if double-wait) is enabled. Default false.

scanMode

Specifies the scan mode. Must be one of Time, Carrier or Search. Default Time.

repeaterEndDelay

Specifies the delay after the end of a repeater transmission in seconds. Default 0s, off.

repeaterSTE

Specifies the repeater STE (what ever that means) in seconds. Default 0s, off.

language

Specifies the UI language. Must be one of Chinese or English.

Button settings

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

Example 4.4. 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 reenable 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?!?

Tone settings

This section collects some settings relates to tones and other audio stuff.

Example 4.5. Tone settings extension example showing default values.

settings:
  [...]
  radioddity:
    [...]
    tone:
      lowBatteryWarn: false
      lowBatteryWarnInterval: 30 s
      lowBatteryWarnVolume: true
      keyTone: false
      keyToneVolume: true
      callAlertDuration: 2 min
      resetTone: false
      unknownNumberTone: false
      artsToneMode: Once
      digitalTalkPermitTone: false
      analogTalkPermitTone: false
      selftestTone: true
      channelFreeIndicationTone: false
      allTonesDisabled: false
      txExitTone: false
      fmMicGain: 1

Tone settings fields

lowBatteryWarn

Enables the low battery-charge warning. This can either be a notification on the screen or a waring tone. The warning interval and tone-volume might be set by lowBatteryInterval and lowBatteryWarnVolume.

lowBatteryWarnInterval

Specifies the interval, at which low battery warning are issued.

lowBatteryWarnVolume

Specifies the volume of the low-battery warning tone in a range from 1 to 10.

keyTone, keyToneVolume

If true, the key-pad tones are enabled. Don't do it. The volume of these tones might be set using keyToneVolume in a range from 1 to 10.

Boot settings

This section collects some settings related to booting the radio.

Example 4.6. Boot settings extension example showing default values.

settings:
  [...]
  radioddity:
    [...]
    boot:
      displayMode: Text
      bootPassword: ""
      progPassword: ""

Boot settings fields

display

Specifies what to display during boot. Must be one of None, Text or Image.

bootPassword, progPassword

Specifies the boot and programming passwords. The former (usually only numbers) must be entered, when the radio boots. The latter must be entered in the CPS to program or read the codeplug.