Implements an interface to Anytone radios. More...
#include <anytone_radio.hh>
Inheritance diagram for AnytoneRadio:
Collaboration diagram for AnytoneRadio:
Public Slots | |
| 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. | |
Public Member Functions | |
| virtual | ~AnytoneRadio () |
| Destructor. | |
| const QString & | name () const |
| Returns the name of the radio (e.g., device identifier). | |
| const Codeplug & | codeplug () const |
| Returns the codeplug instance. | |
| Codeplug & | codeplug () |
| Returns the codeplug instance. | |
| Public Member Functions inherited from Radio | |
| Radio (QObject *parent=nullptr) | |
| Default constructor. | |
| virtual const RadioLimits & | limits () const =0 |
| Returns the limits for this radio. More... | |
| virtual const CallsignDB * | callsignDB () const |
| Returns the call-sign DB instance. | |
| virtual CallsignDB * | callsignDB () |
| Returns the call-sign DB instance. | |
| Status | status () const |
| Returns the current status. | |
| const ErrorStack & | errorStack () const |
Returns the error stack, passed to startDownload, startUpload or startUploadCallsignDB. More... | |
Protected Member Functions | |
| 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 | |
| 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 |
| Owns 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. | |
Additional Inherited Members | |
| Public Types inherited from Radio | |
| enum | Status { StatusIdle , StatusDownload , StatusUpload , StatusUploadCallsigns , StatusError } |
| Possible states of the radio object. More... | |
| 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. | |
| Static Public Member Functions inherited from Radio | |
| static Radio * | detect (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. | |
Detailed Description
Implements an interface to Anytone radios.
The transfer of the codeplug 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 codeplug config are downloaded. Then, the common config gets applied to the binary codeplug. 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 codeplug settings. Finally, the resulting binary codeplug gets written back to the device.
This rather complex method of writing a codeplug to the device is needed to maintain all settings within the radio that are not defined within the common codeplug config while keeping the amount of data being read from and written to the device small.
Member Data Documentation
◆ _codeplugFlags
|
protected |
If true, the codeplug on the radio gets updated upon upload.
If false, it gets overridden.
The documentation for this class was generated from the following files:
- /home/hannes/Software/qdmr/lib/anytone_radio.hh
- /home/hannes/Software/qdmr/lib/anytone_radio.cc
