libdrmconf 0.12.1
A library to program DMR radios.
Loading...
Searching...
No Matches
DMR6X2UVCodeplug Class Reference

Represents the device specific binary codeplug for BTECH DMR-6X2UV radios. More...

#include <dmr6x2uv_codeplug.hh>

Inheritance diagram for DMR6X2UVCodeplug:
Collaboration diagram for DMR6X2UVCodeplug:

Classes

class  APRSSettingsElement
 Represents the APRS settings within the binary DMR-6X2UV codeplug. More...
struct  BackgroundColor
 Background colors supported by the DMR-6X2UV. More...
class  ChannelElement
 Implements the channel element for the BTECH DMR-6X2UV. More...
struct  Color
 Colors supported by the DMR-6X2UV. More...
class  ExtendedSettingsElement
 Implements some settings extension for the BTECH DMR-6X2UV. More...
struct  FontColor
 Font colors supported by the DMR-6X2UV. More...
class  GeneralSettingsElement
 General settings element for the DMR-6X2UV. More...
struct  Limit
 Some limits for the codeplug. More...
struct  Offset
 Some internal used offsets within the codeplug. More...
struct  Size
 Some internal used sizes. More...

Public Types

typedef D878UVCodeplug::RoamingChannelBitmapElement RoamingChannelBitmapElement
 Reuse roaming channel bitmap from D878UV.
typedef D878UVCodeplug::RoamingChannelElement RoamingChannelElement
 Reuse roaming channel from D878UV.
typedef D878UVCodeplug::RoamingZoneBitmapElement RoamingZoneBitmapElement
 Reuse roaming zone bitmap from D878UV.
typedef D878UVCodeplug::RoamingZoneElement RoamingZoneElement
 Reuse roaming zone from D878UV.

Public Member Functions

 DMR6X2UVCodeplug (const QString &label, QObject *parent=nullptr)
 Hidden constructor.
 DMR6X2UVCodeplug (QObject *parent=nullptr)
 Empty constructor.
Public Member Functions inherited from D868UVCodeplug
 D868UVCodeplug (QObject *parent=nullptr)
 Empty constructor.
Public Member Functions inherited from AnytoneCodeplug
virtual ~AnytoneCodeplug ()
 Destructor.
virtual void clear ()
 Clears and resets the complete codeplug to some default values.
Configpreprocess (Config *config, const ErrorStack &err) const
 Retruns a prepared configuration for this particular radio.
bool encode (Config *config, const Flags &flags, const ErrorStack &err)
 Encodes a given abstract configuration (config) to the device specific binary code-plug.
bool decode (Config *config, const ErrorStack &err)
 Decodes a binary codeplug to the given abstract configuration config.
bool postprocess (Config *config, const ErrorStack &err) const
 Retruns a post-processed configuration of the decoded config.
Public Member Functions inherited from Codeplug
virtual ~Codeplug ()
 Destructor.
Public Member Functions inherited from DFUFile
 DFUFile (QObject *parent=nullptr)
 Constructs an empty DFU file object.
uint32_t size () const
 Returns the total size of the DFU file.
uint32_t memSize () const
 Returns the total memory size stored in the DFU file.
int numImages () const
 Returns the number of images within the DFU file.
const Imageimage (int i) const
 Returns a reference to the i-th image of the file.
Imageimage (int i)
 Returns a reference to the i-th image of the file.
void addImage (const QString &name, uint8_t altSettings=1)
 Adds a new image to the file.
void addImage (const Image &img)
 Adds an image to the file.
void remImage (int i)
 Deletes the i-th image from the file.
bool isAligned (unsigned blocksize) const
 Checks if all image addresses and sizes is aligned with the given block size.
bool read (const QString &filename, const ErrorStack &err=ErrorStack())
 Reads the specified DFU file.
bool read (QFile &file, const ErrorStack &err=ErrorStack())
 Reads the specified DFU file.
bool write (const QString &filename, const ErrorStack &err=ErrorStack())
 Writes to the specified file.
bool write (QFile &file, const ErrorStack &err=ErrorStack())
 Writes to the specified file.
void dump (QTextStream &stream) const
 Dumps a text representation of the DFU file structure to the specified text stream.
virtual bool isAllocated (uint32_t offset, uint32_t img=0) const
 Returns true if the specified address (and image) is allocated.
virtual unsigned char * data (uint32_t offset, uint32_t img=0)
 Returns a pointer to the encoded raw data at the specified offset.
virtual const unsigned char * data (uint32_t offset, uint32_t img=0) const
 Returns a const pointer to the encoded raw data at the specified offset.

Protected Member Functions

bool allocateBitmaps ()
 Allocates the bitmaps.
void setBitmaps (Context &ctx)
 Sets all bitmaps for the given config.
void allocateForDecoding ()
 Allocate all code-plug elements that must be downloaded for decoding.
void allocateForEncoding ()
 Allocate all code-plug elements that are defined through the common Config.
bool decodeElements (Context &ctx, const ErrorStack &err=ErrorStack())
 Decodes the downloaded codeplug.
bool encodeElements (const Flags &flags, Context &ctx, const ErrorStack &err=ErrorStack())
 Encodes the given config (via context) to the binary codeplug.
void allocateGeneralSettings ()
 Allocates general settings memory section.
bool encodeGeneralSettings (const Flags &flags, Context &ctx, const ErrorStack &err=ErrorStack())
 Encodes the general settings section.
bool decodeGeneralSettings (Context &ctx, const ErrorStack &err=ErrorStack())
 Decodes the general settings section.
bool linkGeneralSettings (Context &ctx, const ErrorStack &err=ErrorStack())
 Link the general settings.
virtual bool encodeChannels (const Flags &flags, Context &ctx, const ErrorStack &err=ErrorStack())
 Encode channels into codeplug.
virtual bool createChannels (Context &ctx, const ErrorStack &err=ErrorStack())
 Create channels from codeplug.
virtual bool linkChannels (Context &ctx, const ErrorStack &err=ErrorStack())
 Link channels.
void allocateGPSSystems ()
 Allocates GPS settings memory section.
bool encodeGPSSystems (const Flags &flags, Context &ctx, const ErrorStack &err=ErrorStack())
 Encodes the GPS settings section.
bool createGPSSystems (Context &ctx, const ErrorStack &err=ErrorStack())
 Create GPS systems from codeplug.
bool linkGPSSystems (Context &ctx, const ErrorStack &err=ErrorStack())
 Link GPS systems.
virtual void allocateRoaming ()
 Allocates memory to store all roaming channels and zones.
virtual bool encodeRoaming (const Flags &flags, Context &ctx, const ErrorStack &err=ErrorStack())
 Encodes the roaming channels and zones.
virtual bool createRoaming (Context &ctx, const ErrorStack &err=ErrorStack())
 Creates roaming channels and zones from codeplug.
virtual bool linkRoaming (Context &ctx, const ErrorStack &err=ErrorStack())
 Links roaming channels and zones.
Protected Member Functions inherited from D868UVCodeplug
 D868UVCodeplug (const QString &label, QObject *parent=nullptr)
 Hidden constructor constructor.
virtual void allocateUpdated ()
 Allocate all code-plug elements that must be written back to the device to maintain a working codeplug.
virtual void allocateChannels ()
 Allocate channels from bitmap.
virtual void allocateVFOSettings ()
 Allocate VFO settings.
virtual void allocateContacts ()
 Allocate contacts from bitmaps.
virtual bool encodeContacts (const Flags &flags, Context &ctx, const ErrorStack &err=ErrorStack())
 Encode contacts into codeplug.
virtual bool createContacts (Context &ctx, const ErrorStack &err=ErrorStack())
 Create contacts from codeplug.
virtual void allocateAnalogContacts ()
 Allocate analog contacts from bitmaps.
virtual bool encodeAnalogContacts (const Flags &flags, Context &ctx, const ErrorStack &err=ErrorStack())
 Encode analog contacts into codeplug.
virtual bool createAnalogContacts (Context &ctx, const ErrorStack &err=ErrorStack())
 Create analog contacts from codeplug.
virtual void allocateRadioIDs ()
 Allocate radio IDs from bitmaps.
virtual bool encodeRadioID (const Flags &flags, Context &ctx, const ErrorStack &err=ErrorStack())
 Encode radio ID into codeplug.
virtual bool setRadioID (Context &ctx, const ErrorStack &err=ErrorStack())
 Set radio ID from codeplug.
virtual void allocateRXGroupLists ()
 Allocates RX group lists from bitmaps.
virtual bool encodeRXGroupLists (const Flags &flags, Context &ctx, const ErrorStack &err=ErrorStack())
 Encode RX group lists into codeplug.
virtual bool createRXGroupLists (Context &ctx, const ErrorStack &err=ErrorStack())
 Create RX group lists from codeplug.
virtual bool linkRXGroupLists (Context &ctx, const ErrorStack &err=ErrorStack())
 Link RX group lists.
virtual void allocateZones ()
 Allocate zones from bitmaps.
virtual bool encodeZones (const Flags &flags, Context &ctx, const ErrorStack &err=ErrorStack())
 Encode zones into codeplug.
virtual bool encodeZone (int i, Zone *zone, const Flags &flags, Context &ctx, const ErrorStack &err=ErrorStack())
 Function to encode a single zone.
virtual bool createZones (Context &ctx, const ErrorStack &err=ErrorStack())
 Create zones from codeplug.
virtual bool decodeZone (int i, Zone *zone, Context &ctx, const ErrorStack &err=ErrorStack())
 Function to decode a single zone.
virtual bool linkZones (Context &ctx, const ErrorStack &err=ErrorStack())
 Link zones.
virtual bool linkZone (int i, Zone *zone, bool isB, Context &ctx, const ErrorStack &err=ErrorStack())
 Function to link a single zone.
virtual void allocateScanLists ()
 Allocate scanlists from bitmaps.
virtual bool encodeScanLists (const Flags &flags, Context &ctx, const ErrorStack &err=ErrorStack())
 Encode scan lists into codeplug.
virtual bool createScanLists (Context &ctx, const ErrorStack &err=ErrorStack())
 Create scan lists from codeplug.
virtual bool linkScanLists (Context &ctx, const ErrorStack &err=ErrorStack())
 Link scan lists.
virtual void allocateZoneChannelList ()
 Allocates zone channel list memory section.
virtual void allocateDTMFNumbers ()
 Allocates DTMF number list memory section.
virtual void allocateBootSettings ()
 Allocates boot settings memory section.
virtual bool encodeBootSettings (const Flags &flags, Context &ctx, const ErrorStack &err=ErrorStack())
 Encodes the boot settings section.
virtual bool decodeBootSettings (Context &ctx, const ErrorStack &err=ErrorStack())
 Decodes the boot settings section.
virtual void allocateSMSMessages ()
 Allocate prefab SMS messages.
virtual bool encodeSMSMessages (const Flags &flags, Context &ctx, const ErrorStack &err=ErrorStack())
 Encodes prefab SMS messages.
virtual bool createSMSMessages (Context &ctx, const ErrorStack &err=ErrorStack())
 Create SMS messages from codeplug.
virtual bool linkSMSMessages (Context &ctx, const ErrorStack &err=ErrorStack())
 Link SMS messages.
virtual void allocateHotKeySettings ()
 Allocates hot key settings memory section.
virtual void allocateRepeaterOffsetFrequencies ()
 Allocates repeater offset settings memory section.
virtual bool encodeRepeaterOffsetFrequencies (const Flags &flags, Context &ctx, const ErrorStack &err=ErrorStack())
 Encodes auto-repeater offset frequencies.
virtual bool decodeRepeaterOffsetFrequencies (Context &ctx, const ErrorStack &err=ErrorStack())
 Decodes auto-repeater offset frequencies.
virtual void allocateAlarmSettings ()
 Allocates alarm settings memory section.
virtual void allocateFMBroadcastSettings ()
 Allocates FM broadcast settings memory section.
virtual void allocate5ToneIDs ()
 Allocates all 5-Tone IDs used.
virtual void allocate5ToneFunctions ()
 Allocates 5-Tone functions.
virtual void allocate5ToneSettings ()
 Allocates 5-Tone settings.
virtual void allocate2ToneIDs ()
 Allocates all 2-Tone IDs used.
virtual void allocate2ToneFunctions ()
 Allocates 2-Tone functions.
virtual void allocate2ToneSettings ()
 Allocates 2-Tone settings.
virtual void allocateDTMFSettings ()
 Allocates DTMF settings.
Protected Member Functions inherited from AnytoneCodeplug
 AnytoneCodeplug (const QString &label, QObject *parent=nullptr)
 Hidden constructor.
virtual bool index (Config *config, Context &ctx, const ErrorStack &err=ErrorStack()) const
 Indexes all elements of the codeplug.
Protected Member Functions inherited from Codeplug
 Codeplug (QObject *parent=nullptr)
 Hidden default constructor.

Additional Inherited Members

Protected Attributes inherited from AnytoneCodeplug
QString _label
 Holds the image label.
Protected Attributes inherited from DFUFile
QVector< Image_images
 The list of images.

Detailed Description

Represents the device specific binary codeplug for BTECH DMR-6X2UV radios.

This codeplug implementation is compatible with firmware revision 2.04.

Codeplug structure within radio

Channels
StartSizeContent
024C1500000200Bitmap of 4000 channels, default 0x00, 0x00 padded.
00800000max. 002000Channel bank 0 of up to 128 channels, see AnytoneCodeplug::ChannelElement 64 b each.
00840000max. 002000Channel bank 1 of up to 128 channels.
00FC0000max. 000800Channel bank 32, up to 32 channels.
00FC0800000040VFO A settings, see AnytoneCodeplug::ChannelElement.
00FC0840000040VFO B settings, see AnytoneCodeplug::ChannelElement.
Zones
StartSizeContent
024C1300000020Bitmap of 250 zones.
01000000max. 01f400250 zones channel lists of 250 16bit indices each. 0-based, little endian, default/padded=0xffff. Offset between channel lists 0x200, size of each list 0x1f4.
02540000max. 001f40250 Zone names. Each zone name is up to 16 ASCII chars long and gets 0-padded to 32b.
02500100000400Zone A & B channel list.
Roaming
StartSizeContent
01042000000020Roaming channel bitmask, up to 250 bits, 0-padded, default 0.
01040000max. 0x1f40Optional up to 250 roaming channels, of 32b each. See D868UVCodeplug::RoamingChannelElement for details.
01042080000010Roaming zone bitmask, up to 64 bits, 0-padded, default 0.
01043000max. 0x2000Optional up to 64 roaming zones, of 128b each. See D868UVCodeplug::RoamingZoneElement for details.
Contacts
StartSizeContent
02600000max. 009C40Index list of valid contacts. 10000 32bit indices, little endian, default 0xffffffff
02640000000500Contact bitmap, 10000 bit, inverted, default 0xff, 0x00 padded.
02680000max. 0f424010000 contacts, see AnytoneCodeplug::ContactElement. As each contact is 100b, they do not align with the 16b blocks being transferred to the device. Hence contacts are organized internally in groups of 4 contacts forming a "bank".
04340000max. 013880DMR ID to contact index map, see AnytoneCodeplug::ContactMapElement. Sorted by ID, empty entries set to 0xffffffffffffffff.
Analog Contacts
StartSizeContent
02900000000080Index list of valid analog contacts.
02900100000080Bytemap for 128 analog contacts.
02940000max. 000180128 analog contacts. See AnytoneCodeplug::DTMFContactElement. As each analog contact is 24b, they do not align with the 16b transfer block-size. Hence analog contacts are internally organized in groups of 2.
RX Group Lists
StartSizeContent
025C0B10000020Bitmap of 250 RX group lists, default/padding 0x00.
02980000max. 000120Grouplist 0, see AnytoneCodeplug::GroupListElement.
02980200max. 000120Grouplist 1
.........
0299f200max. 000120Grouplist 250
Scan lists
StartSizeContent
024C1340000020Bitmap of 250 scan lists.
01080000000090Bank 0, Scanlist 1, see AnytoneCodeplug::ScanListElement.
01080200000090Bank 0, Scanlist 2
.........
01081E00000090Bank 0, Scanlist 16
010C0000000090Bank 1, Scanlist 17
.........
01440000000090Bank 15, Scanlist 241
.........
01441400000090Bank 15, Scanlist 250
Radio IDs
StartSizeContent
024C1320000020Bitmap of 250 radio IDs.
02580000max. 001f40250 Radio IDs. See AnytoneCodeplug::RadioIDElement.
GPS/APRS
StartSizeContent
025010000000A0APRS settings (DMR + FM), see DMR6X2UVCodeplug::APRSSettingsElement.
02501200000040APRS Text, up to 60 chars ASCII, 0-padded.
02501280000030GPS template message, ASCII, 0-padded.
02502000000080FM APRS frequency names, see FMAPRSFrequencyNamesElement. This element is not part of the manufacturer codeplug. QDMR uses this memory section to store additional information.
General Settings
StartSizeContent
025000000000e0General settings, see DMR6X2UVCodeplug::GeneralSettingsElement.
02500500000100DTMF list
02500600000030Power on settings, see AnytoneCodeplug::BootSettingsElement.
02501400000030Settings extension, see DMR6X2UVCodeplug::ExtendedSettingsElement.
024C20000003F0List of 250 auto-repeater offset frequencies. 32bit little endian frequency in 10Hz. I.e., 600kHz = 60000. Default 0x00000000, 0x00 padded.
Messages
StartSizeContent
01640000max. 000100Some kind of linked list of messages. See AnytoneCodeplug::MessageListElement. Each entry has a size of 0x10.
01640800000090Bytemap of up to 100 valid messages. 0x00=valid, 0xff=invalid, remaining 46b set to 0x00.
02140000max. 000800Bank 0, Messages 1-8. Each message consumes 0x100b. See AnytoneCodeplug::MessageElement.
02180000max. 000800Bank 1, Messages 9-16
.........
02440000max. 000800Bank 12, Messages 97-100
Hot Keys
StartSizeContent
025C00000001004 analog quick-call settings. See AnytoneCodeplug::AnalogQuickCallElement.
025C0B00000010Status message bitmap.
025C0100000400Up to 32 status messages. Length unknown, offset 0x20. ASCII 0x00 terminated and padded.
025C050000036018 hot-key settings, see AnytoneCodeplug::HotKeyElement
Encryption
StartSizeContent
024C170000004032 Encryption IDs, 0-based, 16bit big-endian.
024C180000050032 DMR-Encryption keys, see D868UVCodeplug::dmr_encryption_key_t, 40b each.
025C1000004000Up to 256 AES encryption keys. See D878UVCodeplug::AESEncryptionKeyElement.
Misc
StartSizeContent
024C1400000020Alarm setting, see AnytoneCodeplug::AlarmSettingElement.
024C1440000030Digital alarm settings extension, see AnytoneCodeplug::DigitalAlarmExtensionElement.
FM Broadcast
StartSizeContent
02480210000020Bitmap of 100 FM broadcast channels.
02480000max. 000200100 FM broadcast channels. Encoded as 8-digit BCD little-endian in 100Hz. Filled with 0x00.
02480200000010FM broadcast VFO frequency. Encoded as 8-digit BCD little-endian in 100Hz. Filled with 0x00.
DTMF, 2-tone & 5-tone signaling.
StartSizeContent
024C0C800000105-tone encoding bitmap.
024C00000000205-tone encoding.
024C0D000002005-tone ID list.
024C10000000805-tone settings.
024C1080000050DTMF settings.
024C12800000102-tone encoding bitmap.
024C11000000102-tone encoding.
024C12900000102-tone settings.
024C26000000102-tone decoding bitmap.
024C24000000302-tone decoding.
Unknown settings.
StartSizeContent
024C2610000020Unknown bitmap.
024C2630000020Unknown bitmap.
024C3000000020Unknown settings.
024C5000000020Unknown settings.

Member Function Documentation

◆ allocateBitmaps()

bool DMR6X2UVCodeplug::allocateBitmaps ( )
protectedvirtual

Allocates the bitmaps.

This is also performed during a clear.

Reimplemented from D868UVCodeplug.

◆ allocateForDecoding()

void DMR6X2UVCodeplug::allocateForDecoding ( )
protectedvirtual

Allocate all code-plug elements that must be downloaded for decoding.

All code-plug elements within the radio that are not represented within the common Config are omitted.

Reimplemented from D868UVCodeplug.

◆ allocateForEncoding()

void DMR6X2UVCodeplug::allocateForEncoding ( )
protectedvirtual

Allocate all code-plug elements that are defined through the common Config.

Reimplemented from D868UVCodeplug.

◆ allocateGeneralSettings()

void DMR6X2UVCodeplug::allocateGeneralSettings ( )
protectedvirtual

Allocates general settings memory section.

Reimplemented from D868UVCodeplug.

◆ allocateGPSSystems()

void DMR6X2UVCodeplug::allocateGPSSystems ( )
protectedvirtual

Allocates GPS settings memory section.

Reimplemented from D868UVCodeplug.

◆ createChannels()

bool DMR6X2UVCodeplug::createChannels ( Context & ctx,
const ErrorStack & err = ErrorStack() )
protectedvirtual

Create channels from codeplug.

Reimplemented from D868UVCodeplug.

◆ createGPSSystems()

bool DMR6X2UVCodeplug::createGPSSystems ( Context & ctx,
const ErrorStack & err = ErrorStack() )
protectedvirtual

Create GPS systems from codeplug.

Reimplemented from D868UVCodeplug.

◆ decodeElements()

bool DMR6X2UVCodeplug::decodeElements ( Context & ctx,
const ErrorStack & err = ErrorStack() )
protectedvirtual

Decodes the downloaded codeplug.

Reimplemented from D868UVCodeplug.

◆ decodeGeneralSettings()

bool DMR6X2UVCodeplug::decodeGeneralSettings ( Context & ctx,
const ErrorStack & err = ErrorStack() )
protectedvirtual

Decodes the general settings section.

Reimplemented from D868UVCodeplug.

◆ encodeChannels()

bool DMR6X2UVCodeplug::encodeChannels ( const Flags & flags,
Context & ctx,
const ErrorStack & err = ErrorStack() )
protectedvirtual

Encode channels into codeplug.

Reimplemented from D868UVCodeplug.

◆ encodeElements()

bool DMR6X2UVCodeplug::encodeElements ( const Flags & flags,
Context & ctx,
const ErrorStack & err = ErrorStack() )
protectedvirtual

Encodes the given config (via context) to the binary codeplug.

Reimplemented from D868UVCodeplug.

◆ encodeGeneralSettings()

bool DMR6X2UVCodeplug::encodeGeneralSettings ( const Flags & flags,
Context & ctx,
const ErrorStack & err = ErrorStack() )
protectedvirtual

Encodes the general settings section.

Reimplemented from D868UVCodeplug.

◆ encodeGPSSystems()

bool DMR6X2UVCodeplug::encodeGPSSystems ( const Flags & flags,
Context & ctx,
const ErrorStack & err = ErrorStack() )
protectedvirtual

Encodes the GPS settings section.

Reimplemented from D868UVCodeplug.

◆ linkChannels()

bool DMR6X2UVCodeplug::linkChannels ( Context & ctx,
const ErrorStack & err = ErrorStack() )
protectedvirtual

Link channels.

Reimplemented from D868UVCodeplug.

◆ linkGeneralSettings()

bool DMR6X2UVCodeplug::linkGeneralSettings ( Context & ctx,
const ErrorStack & err = ErrorStack() )
protectedvirtual

Link the general settings.

Reimplemented from D868UVCodeplug.

◆ linkGPSSystems()

bool DMR6X2UVCodeplug::linkGPSSystems ( Context & ctx,
const ErrorStack & err = ErrorStack() )
protectedvirtual

Link GPS systems.

Reimplemented from D868UVCodeplug.

◆ setBitmaps()

void DMR6X2UVCodeplug::setBitmaps ( Context & ctx)
protectedvirtual

Sets all bitmaps for the given config.

Reimplemented from D868UVCodeplug.


The documentation for this class was generated from the following files:
  • /builddir/build/BUILD/qdmr-0.12.1-build/qdmr-0.12.1/lib/dmr6x2uv_codeplug.hh
  • /builddir/build/BUILD/qdmr-0.12.1-build/qdmr-0.12.1/lib/dmr6x2uv_codeplug.cc