libdrmconf  0.11.3
A library to program DMR radios.
Public Member Functions | Static Public Member Functions | List of all members

Implements an interface to Anytone AT-D878UV VHF/UHF 7W DMR (Tier I & II) radios. More...

#include <d878uv.hh>

Inheritance diagram for D878UV:
Inheritance graph
[legend]
Collaboration diagram for D878UV:
Collaboration graph
[legend]

Public Member Functions

 D878UV (AnytoneInterface *device=nullptr, QObject *parent=nullptr)
 Do not construct this class directly, rather use Radio::detect.
 
const RadioLimitslimits () const
 Returns the limits for this radio. More...
 
- Public Member Functions inherited from AnytoneRadio
virtual ~AnytoneRadio ()
 Destructor.
 
const QString & name () const
 Returns the name of the radio (e.g., device identifier).
 
const Codeplugcodeplug () const
 Returns the codeplug instance.
 
Codeplugcodeplug ()
 Returns the codeplug instance.
 
- Public Member Functions inherited from Radio
 Radio (QObject *parent=nullptr)
 Default constructor.
 
virtual const CallsignDBcallsignDB () const
 Returns the call-sign DB instance.
 
virtual CallsignDBcallsignDB ()
 Returns the call-sign DB instance.
 
Status status () const
 Returns the current status.
 
const ErrorStackerrorStack () const
 Returns the error stack, passed to startDownload, startUpload or startUploadCallsignDB. More...
 

Static Public Member Functions

static RadioInfo defaultRadioInfo ()
 Returns the default radio information. More...
 
- Static Public Member Functions inherited from Radio
static Radiodetect (const USBDeviceDescriptor &descr, const RadioInfo &force=RadioInfo(), const ErrorStack &err=ErrorStack())
 Tries to detect the radio connected to the specified interface or constructs the specified radio using the RadioInfo passed by force.
 

Additional Inherited Members

- Public Types inherited from Radio
enum  Status {
  StatusIdle , StatusDownload , StatusUpload , StatusUploadCallsigns ,
  StatusError
}
 Possible states of the radio object. More...
 
- Public Slots inherited from AnytoneRadio
bool startDownload (bool blocking=false, const ErrorStack &err=ErrorStack())
 Starts the download of the codeplug and derives the generic configuration from it.
 
bool startUpload (Config *config, bool blocking=false, const Codeplug::Flags &flags=Codeplug::Flags(), const ErrorStack &err=ErrorStack())
 Derives the device-specific codeplug from the generic configuration and uploads that codeplug to the radio.
 
bool startUploadCallsignDB (UserDatabase *db, bool blocking=false, const CallsignDB::Selection &selection=CallsignDB::Selection(), const ErrorStack &err=ErrorStack())
 Encodes the given user-database and uploades it to the device.
 
- Public Slots inherited from Radio
virtual bool startDownload (bool blocking=false, const ErrorStack &err=ErrorStack())=0
 Starts the download of the codeplug. More...
 
virtual bool startUpload (Config *config, bool blocking=false, const Codeplug::Flags &flags=Codeplug::Flags(), const ErrorStack &err=ErrorStack())=0
 Derives the device-specific codeplug from the generic configuration and uploads that codeplug to the radio.
 
virtual bool startUploadCallsignDB (UserDatabase *db, bool blocking=false, const CallsignDB::Selection &selection=CallsignDB::Selection(), const ErrorStack &err=ErrorStack())=0
 Assembles the callsign DB from the given one and uploads it to the device.
 
- Signals inherited from Radio
void downloadStarted ()
 Gets emitted once the codeplug download has been started.
 
void downloadProgress (int percent)
 Gets emitted on download progress (e.g., for progress bars).
 
void downloadFinished (Radio *radio, Codeplug *codeplug)
 Gets emitted once the codeplug download has been finished.
 
void downloadError (Radio *radio)
 Gets emitted if there was an error during the codeplug download.
 
void uploadStarted ()
 Gets emitted once the codeplug upload has been started.
 
void uploadProgress (int percent)
 Gets emitted on upload progress (e.g., for progress bars).
 
void uploadError (Radio *radio)
 Gets emitted if there was an error during the upload.
 
void uploadComplete (Radio *radio)
 Gets emitted once the codeplug upload has been completed successfully.
 
- Protected Member Functions inherited from AnytoneRadio
 AnytoneRadio (const QString &name, AnytoneInterface *device=nullptr, QObject *parent=nullptr)
 Do not construct this class directly.
 
void run ()
 Thread main routine, performs all blocking IO operations for codeplug up- and download.
 
- Protected Attributes inherited from AnytoneRadio
QString _name
 The device identifier.
 
AnytoneInterface_dev
 The interface to the radio.
 
Codeplug::Flags _codeplugFlags
 If true, the codeplug on the radio gets updated upon upload. More...
 
Config_config
 The generic configuration.
 
UserDatabase_userDB
 A weak reference to the user-database.
 
AnytoneCodeplug_codeplug
 The actual binary codeplug representation.
 
CallsignDB_callsigns
 The actual binary callsign database representation.
 
- Protected Attributes inherited from Radio
Status _task
 The current state/task.
 
ErrorStack _errorStack
 The error stack.
 

Detailed Description

Implements an interface to Anytone AT-D878UV VHF/UHF 7W DMR (Tier I & II) radios.

The reverse-engineering of the D878UVCodeplug was quiet hard as it is huge and the radio provides a lot of bells and whistles. Moreover, the binary code-plug file created by the windows CPS does not directly relate to the data being written to the device. These two issues (a lot of features and a huge code-plug) require that the transfer of the code-plug to the device is performed in 4 steps.

First only the bitmaps of all lists are downloaded from the device. Then all elements that are not touched or only updated by the common code-plug config are downloaded. Then, the common config gets applied to the binary code-plug. That is, all channels, contacts, zones, group-lists and scan-lists are generated and their bitmaps gets updated accordingly. Also the general config gets updated from the common code-plug settings. Finally, the resulting binary code-plug gets written back to the device.

This rather complex method of writing a code-plug to the device is needed to maintain all settings within the radio that are not defined within the common code-plug config while keeping the amount of data being read from and written to the device small.

Member Function Documentation

◆ defaultRadioInfo()

RadioInfo D878UV::defaultRadioInfo ( )
static

Returns the default radio information.

The actual instance may have different properties due to variants of the same radio.

◆ limits()

const RadioLimits & D878UV::limits ( ) const
virtual

Returns the limits for this radio.

Call RadioLimits::verifyConfig to verify a codeplug with respect to a radio.

Since
Version 0.10.2

Implements Radio.


The documentation for this class was generated from the following files: