WiNRADiO G3xDDC Memory File Format

G3xDDC Memory File Format

The memory storage of G3xDDC receivers is divided into groups. Each group can contain memory items to store frequencies and other groups - sub-groups.

The memory file starts with a file header followed by the root group content. The memory file uses the little endian ordering system.

Memory file

	File offset (bytes)	Field name	Field size (bytes)	Description
File header	0	Signature	4	File format signature (0xE651B291).
	4	Version	4	File format version 1.2 (0x00010002).
	8	Next group identifier	4	Identifier which will be used for next group which will be stored to the memory file.
	12	Next memory item identifier	4	Identifier which will be used for next memory item which will be stored to the memory file.
	16	Reserved	4	Reserved, must be zero.
Root group	20	Group identifier	4	Root group identifier (0x00000000)
	24	Item count	4	Number of memory items stored directly in root group. This number does not include memory items stored in sub-groups.
	28	Sub-group count	4	Number of sub-groups stored directly in the root group.
Root group contents	32	Memory items	Variable	Sequence of memory items stored directly in root group. Number of the items in the sequence is given by the Item count field. If the root group does not contain any memory item, sub-groups start at this place.
	Variable	Sub-groups	Variable	Sequence of sub-groups (with their contents) of the root group. Number of the groups in the sequence is given by the Sub-group count field.

Memory item

Offset
(bytes)

Field name

Field size
(bytes)

Description

Identifier

Memory item identifier. It must be unique, no other memory item in memory file can have the same identifier.

Flags

Memory item flags (it is a set of bit flags).

Bit Description

0 If it is set, Mode field is valid, otherwise it is unused.

1 If it is set, Bandwidth field is valid, otherwise it is unused.

2 Reserved, must be zero.

3 If it is set, squelch fields are valid, otherwise they are unused.

4 If it is set, audio filter fields are valid, otherwise they are unused.

5 If it is set, DDC bandwidth field is valid, otherwise it is unused.

6 If it is set, Attenuator field is valid, otherwise it is unused.

7 If it is set, Preamp field is valid, otherwise it is unused.

8 If it is set, memory item is excluded from memory scanning.

9 If it is set, DDC2 bandwidth field is valid, otherwise it is unused.

10 - 31 Reserved, must be zero.

Priority

Priority which can be used for memory scanning.

Callsign

Null-terminated 16 bit Unicode string which contains memory item callsign. If the callsign consists of 32 characters, the string does not contain null-terminator

Description

128

Null-terminated 16 bit Unicode string which contains memory item description. If the description consists of 64 characters, the string does not contain null-terminator.

204

Frequency

Frequency in Hz.

212

Mode

Demodulator mode. It can be one of the following:

Value Description

0 CW (Continuous wave)

1 AM (Amplitude modulation)

2 FM (Frequency modulation)

3 FMW (Wide FM)

4 LSB (Lower sideband)

5 USB (Upper sideband)

8 AMS (Synchronous AM)

13 DSB (Double sideband)

14 ISB (Independent sideband)

18 DRM (Digital Radio Mondiale)

20 UDM (User defined mode)

216

Bandwidth

Demodulator filter bandwidth in Hz.

220

Reserved

Reserved, must be zero.

224

DDC bandwidth

Useful bandwidth of primary DDC in Hz.

228

Attenuator

Attenuator level in dB.

232

Preamp

Preamp state, non-zero if the preamp is enabled, zero if preamp is disabled.

236

DDC2 bandwidth

Useful bandwidth of secondary DDC in Hz.

240

Reserved

Reserved, must be zero.

244

Squelch/Flags

A set of bit flags.

Bit Description

0 If it is set, squelch is enabled.

1 If it is set, level squelch is enabled.

2 If it is set, noise squelch is enabled.

3 If it is set, voice squelch is enabled.

4 If it is set, DCS squelch is enabled.

5 If it is set, CTCSS squelch is enabled.

6 - 7 Reserved, must be zero.

245

Squelch/Level

Level squelch in dB (signed integer).

247

Squelch/Noise

Noise squelch in %.

249

Squelch/Voice

Voice squelch in %.

251

Squelch/DCS

DCS squelch code (signed integer). Reverse code if it is negative.

253

Squelch/CTCSS

CTCSS tone in Hz.

255

Audio filter/Enabled

Non-zero if audio filter is enabled, zero if it is disabled.

256

Audio filter/Cut-off low

Cut-off low frequency of the audio filter in Hz.

260

Audio filter/Cut-off high

Cut-off high frequency of the audio filter in Hz.

264

Audio filter/Deemphasis

Deemphasis * 10 (signed integer).

268

Hot key

Hot key used by the application to recall memory.

Memory group

Offset (bytes)	Field name	Field size (bytes)	Description
0	Name	64	Null-terminated 16 bit Unicode string which contains group name. If the name consists of 32 characters, the string does not contain a null-terminator.
64	Identifier	4	Group identifier. It must be unique; no other group in memory file can have the same identifier.
68	Item count	4	Number of memory items stored in the group.
72	Sub-group count	4	Number of sub-groups stored in the group.
76	Reserved	4	Reserved, must be zero.
80	Memory items	Variable	Sequence of memory items stored in the group. Number of the items is given by the Item count field. If the group does not contain any memory item, a sub-group starts at this place.
Variable	Sub-groups	Variable	Sequence of sub-groups stored in the group. Number of the sub-groups is given by the Sub-group count field.