The sole reason for introducing a new YAML based codeplug format was the ability to extend the file format with device specific settings without breaking the format. This was simply impossible with the old table based text files.
The present YAML based codeplug file format is extensible at almost any level. That is, device specific elements can be added to single codeplug elements like channels, zones or contacts but also to the codeplug itself. The latter allows to extend the codeplug with new elements.
This chapter documents the extensions and settings specific to radios running the OpenGD77 firmware.
This extension allows to specify some channel settings specific for devices running the OpenGD77 firmware. This extension can be added to any channel, analog and digital. For now, this extension only allows to specify the power for the channel in more detail.
Example 4.1.
channels:
- digital:
id: ch1
name: Example channel
# all the other channel settings
openGD77:
scanZoneSkip: false
scanAllSkip: false
beep: true
powerSave: true
location: JO62jl
talkerAliasTS1: APRS
talkerAliasTS2: Both
The OpenGD77 channel extension is a mapping named openGD77. It contains the device specific settings for that channel.
For now, there are only few attributes specifying scan behavior for the channel.
Channel extension fields
- scanZoneSkip scanAllSkip
-
In contrast to the original GD-77 firmware, OpenGD77 does not implement scanning by scan lists. Instead, either all channels defined in the radio or all channels within the current zone can be scanned. To exclude some channels from these scans, the scanZoneSkip and scanAllSkip flags can be used. When enabled, the channel will be excluded from the respective scan.
- beep
-
If enabled (default), the channel beeps are played.
- powerSave
-
Enables the power save feature for this channel (default).
- location
-
Allows to specify a fixed location to be used for this channel and the associated APRS system.
- talkerAliasTS1 talkerAliasTS2
-
Specifies what to be send as the talker alias, depending on the current timeslot. This must be one of None, APRS, Text or Both.
This extensions allows to specify some DMR contact attributes for devices running the OpenGD77 firmware. This extension is only applicable to DMR (digital) contacts.
The OpenGD77 contact extension is a mapping named openGD77. It contains the device specific settings for that DMR contact.
For now, there is only one attribute allowing to override the time slot of a channel whenever this contact is selected as the destination contact for that channel.
Channel extension fields
- timeSlotOverride
-
OpenGD77 allows to override the time slot settings for each channel on the bases of the selected transmit contact. If the contact has a time slot override set, this time slot is used instead of the channel time slot. This attribute is either None, TS1 or TS2. If None is set, the channel time slot will not be overridden.