Base class for all Radio objects. More...

#include <radio.hh>

Inheritance diagram for Radio:

[legend]

Collaboration diagram for Radio:

[legend]

Public Types
enum	Status { StatusIdle , StatusDownload , StatusUpload , StatusUploadCallsigns , StatusUploadSatellites , StatusError }
	Possible states of the radio object. More...

Public Slots
virtual bool	startDownload (const TransferFlags &flags, const ErrorStack &err=ErrorStack())=0
	Starts the download of the codeplug.
virtual bool	startUpload (Config *config, 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, const CallsignDB::Flags &selection=CallsignDB::Flags(), const ErrorStack &err=ErrorStack())=0
	Assembles the callsign DB from the given one and uploads it to the device.
virtual bool	startUploadSatelliteConfig (SatelliteDatabase *db, const TransferFlags &flags, const ErrorStack &err=ErrorStack())=0
	Assembles the satellite config and writes it to the device.

Signals
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.

Public Member Functions
	Radio (QObject *parent=nullptr)
	Default constructor.
virtual const QString &	name () const =0
	Returns the name of the radio (e.g., device identifier).
virtual const RadioLimits &	limits () const =0
	Returns the limits for this radio.
virtual const Codeplug &	codeplug () const =0
	Returns the codeplug instance.
virtual Codeplug &	codeplug ()=0
	Returns the codeplug instance.
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`.

Static Public Member Functions
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`.

Protected Attributes
Status	_task
	The current state/task.
ErrorStack	_errorStack
	The error stack.

Detailed Description

Base class for all Radio objects.

The radio objects represents a connected radio. This class controlles the communication with the device as well as the conversion between device specific code-plugs and generic configurations.

Member Enumeration Documentation

◆ Status

enum Radio::Status

Possible states of the radio object.

Enumerator
StatusIdle	Idle, nothing to do.
StatusDownload	Downloading codeplug.
StatusUpload	Uploading codeplug.
StatusUploadCallsigns	Uploading codeplug.
StatusUploadSatellites	Uploading satellite config.
StatusError	An error occurred.

Member Function Documentation

◆ callsignDB() [1/2]

CallsignDB * Radio::callsignDB ( )

virtual

Returns the call-sign DB instance.

Reimplemented in DM1701, MD2017, MD390, OpenGD77, OpenUV380, and UV390.

◆ callsignDB() [2/2]

const CallsignDB * Radio::callsignDB ( ) const

virtual

Returns the call-sign DB instance.

Reimplemented in DM1701, MD2017, MD390, OpenGD77, OpenUV380, and UV390.

◆ codeplug() [1/2]

virtual const Codeplug & Radio::codeplug ( ) const

pure virtual

Returns the codeplug instance.

Implemented in AnytoneRadio, DM1701, DM32UV, DR1801UV, GD73, GD77, MD2017, MD390, OpenGD77, OpenRTX, OpenUV380, RD5R, and UV390.

◆ codeplug() [2/2]

virtual Codeplug & Radio::codeplug ( )

pure virtual

Returns the codeplug instance.

Implemented in AnytoneRadio, DM1701, DM32UV, DR1801UV, GD73, GD77, MD2017, MD390, OpenGD77, OpenRTX, OpenUV380, RD5R, and UV390.

◆ errorStack()

const ErrorStack & Radio::errorStack ( ) const

Returns the error stack, passed to startDownload, startUpload or startUploadCallsignDB.

It contains the error messages from the upload/download process.

◆ limits()

virtual const RadioLimits & Radio::limits ( ) const

pure virtual

Returns the limits for this radio.

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

Since: Version 0.10.2

Implemented in D578UV, D868UV, D878UV2, D878UV, DM1701, DM32UV, DMR6X2UV2, DMR6X2UV, DR1801UV, GD73, GD77, MD2017, MD390, OpenGD77Base, RD5R, and UV390.

◆ name()

virtual const QString & Radio::name ( ) const

pure virtual

Returns the name of the radio (e.g., device identifier).

Implemented in AnytoneRadio, DM1701, DM32UV, DR1801UV, GD73, GD77, MD2017, MD390, OpenGD77, OpenRTX, OpenUV380, RD5R, and UV390.

◆ startDownload

virtual bool Radio::startDownload	(	const TransferFlags &	flags,
		const ErrorStack &	err = ErrorStack() )

pure virtualslot

Starts the download of the codeplug.

Once the download finished, the codeplug can be accessed and decoded using the codeplug() method.

Implemented in DM32UV, and DR1801UV.

◆ startUpload

virtual bool Radio::startUpload	(	Config *	config,
		const Codeplug::Flags &	flags = Codeplug::Flags(),
		const ErrorStack &	err = ErrorStack() )

pure virtualslot

Derives the device-specific codeplug from the generic configuration and uploads that codeplug to the radio.

Implemented in DM32UV, and DR1801UV.

◆ startUploadCallsignDB

virtual bool Radio::startUploadCallsignDB	(	UserDatabase *	db,
		const CallsignDB::Flags &	selection = CallsignDB::Flags(),
		const ErrorStack &	err = ErrorStack() )

pure virtualslot

Assembles the callsign DB from the given one and uploads it to the device.

Implemented in DM32UV, and DR1801UV.

◆ startUploadSatelliteConfig

virtual bool Radio::startUploadSatelliteConfig	(	SatelliteDatabase *	db,
		const TransferFlags &	flags,
		const ErrorStack &	err = ErrorStack() )

pure virtualslot

Assembles the satellite config and writes it to the device.

Implemented in DM32UV, and DR1801UV.

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

/builddir/build/BUILD/qdmr-0.14.1-build/qdmr-0.14.1/lib/radio.hh
/builddir/build/BUILD/qdmr-0.14.1-build/qdmr-0.14.1/lib/radio.cc

Public Types

Public Slots

Signals

Public Member Functions

Static Public Member Functions

Protected Attributes

Detailed Description

Member Enumeration Documentation

◆ Status

Member Function Documentation

◆ callsignDB() [1/2]

◆ callsignDB() [2/2]

◆ codeplug() [1/2]

◆ codeplug() [2/2]

◆ errorStack()

◆ limits()

◆ name()

◆ startDownload

◆ startUpload

◆ startUploadCallsignDB

◆ startUploadSatelliteConfig