Implements a radio interface for radios using the HID USB schema (i.e. More...

#include <radioddity_interface.hh>

Inheritance diagram for RadioddityInterface:

[legend]

Collaboration diagram for RadioddityInterface:

[legend]

Public Types
enum	MemoryBank { MEMBANK_NONE = -1 , MEMBANK_CODEPLUG_LOWER = 0 , MEMBANK_CODEPLUG_UPPER = 1 , MEMBANK_CALLSIGN_LOWER = 3 , MEMBANK_CALLSIGN_UPPER = 4 }
	Possible memory banks to select. More...

Public Member Functions
	RadioddityInterface (const USBDeviceDescriptor &descr, const ErrorStack &err=ErrorStack(), QObject *parent=nullptr)
	Connects to the radio via the given descriptor.

virtual	~RadioddityInterface ()
	Destructor.

bool	isOpen () const
	Returns `true` if the connection was established.

void	close ()
	Closes the connection to the device.

RadioInfo	identifier (const ErrorStack &err=ErrorStack())
	Returns radio identifier string.

bool	read_start (uint32_t bank, uint32_t addr, const ErrorStack &err=ErrorStack())
	Starts the read process from the specified bank and at the given address.

bool	read (uint32_t bank, uint32_t addr, unsigned char *data, int nbytes, const ErrorStack &err=ErrorStack())
	Reads a block of data from the device at the given block number.

bool	read_finish (const ErrorStack &err=ErrorStack())
	This function ends a series of `read` operations.

bool	write_start (uint32_t bank, uint32_t addr, const ErrorStack &err=ErrorStack())
	Starts the write process into the specified bank and at the given address.

bool	write (uint32_t bank, uint32_t addr, unsigned char *data, int nbytes, const ErrorStack &err=ErrorStack())
	Writes a block of data to the device at the given block number.

bool	write_finish (const ErrorStack &err=ErrorStack())
	This function ends a series of `write` operations.

Public Member Functions inherited from HIDevice
	HIDevice (const USBDeviceDescriptor &descr, const ErrorStack &err=ErrorStack(), QObject *parent=nullptr)
	Connects to the device with given vendor and product ID.

virtual	~HIDevice ()
	Destructor.

bool	isOpen () const
	Returns `true` if the connection is established.

bool	hid_send_recv (const unsigned char data, unsigned nbytes, unsigned char rdata, unsigned rlength, const ErrorStack &err=ErrorStack())
	Send command/data to the device and store response in `rdata`.

void	close ()
	Close connection to device.

	HIDevice (const USBDeviceDescriptor &descr, const ErrorStack &err=ErrorStack(), QObject *parent=nullptr)
	Opens a connection to the device with given vendor and product ID.

virtual	~HIDevice ()
	Destructor.

bool	isOpen () const
	Returns `true` if the connection was established.

bool	hid_send_recv (const unsigned char data, unsigned nbytes, unsigned char rdata, unsigned rlength, const ErrorStack &err=ErrorStack())
	Send command/data to the device and store response in `rdata`.

void	close ()
	Close connection to device.

Public Member Functions inherited from RadioInterface
virtual	~RadioInterface ()
	Destructor.

virtual bool	write (uint32_t bank, uint32_t addr, uint8_t *data, int nbytes, const ErrorStack &err=ErrorStack())=0
	Writes a chunk of `data` at the address `addr`.

virtual bool	read (uint32_t bank, uint32_t addr, uint8_t *data, int nbytes, const ErrorStack &err=ErrorStack())=0
	Reads a chunk of data from the block-address `bno` (block number).

virtual bool	reboot (const ErrorStack &err=ErrorStack())
	Some radios need to be rebooted after being read or programmed.

Static Public Member Functions
static USBDeviceInfo	interfaceInfo ()
	Returns some information about the interface.

static QList< USBDeviceDescriptor >	detect (bool saveOnly=true)
	Tries to find all interfaces connected AnyTone radios.

Static Public Member Functions inherited from HIDevice
static QList< USBDeviceDescriptor >	detect (uint16_t vid, uint16_t pid)
	Finds all HID interfaces with the specified VID/PID combination.

static QList< USBDeviceDescriptor >	detect (uint16_t vid, uint16_t pid)
	Finds all HID interfaces with the specified VID/PID combination.

Protected Member Functions
bool	selectMemoryBank (MemoryBank bank, const ErrorStack &err=ErrorStack())
	Internal used function to select a memory bank.

Protected Member Functions inherited from HIDevice
int	write_read (const unsigned char data, unsigned length, unsigned char reply, unsigned rlength, const ErrorStack &err=ErrorStack())
	Internal used implementation of send_recv().

Protected Member Functions inherited from RadioInterface
	RadioInterface ()
	Hidden constructor.

Additional Inherited Members
Static Protected Member Functions inherited from HIDevice
static void	read_callback (struct libusb_transfer *t)
	Callback for response data.

static void	callback_input (void context, IOReturn result, void sender, IOHIDReportType type, uint32_t reportID, uint8_t *data, CFIndex nbytes)
	Internal callback for response data.

static void	callback_open (void context, IOReturn result, void sender, IOHIDDeviceRef deviceRef)
	Internal callback for device opend.

static void	callback_close (void ontext, IOReturn result, void sender, IOHIDDeviceRef deviceRef)
	Internal callback for device closed.

Protected Attributes inherited from HIDevice
libusb_context *	_ctx
	libusb context.

libusb_device_handle *	_dev
	libusb device.

struct libusb_transfer *	_transfer
	libusb async transfer descriptor.

unsigned char	_receive_buf [42]
	Receive buffer.

volatile int	_nbytes_received = 0
	Receive result.

ErrorStack	_cbError
	Internal used error stack for the static callback function.

IOHIDManagerRef	_HIDManager
	Device manager.

volatile IOHIDDeviceRef	_dev
	Device handle.

unsigned char	_transfer_buf [42]
	Device buffer.

Detailed Description

Implements a radio interface for radios using the HID USB schema (i.e.

Radioddity devices).

Member Enumeration Documentation

◆ MemoryBank

enum RadioddityInterface::MemoryBank

Possible memory banks to select.

Enumerator
MEMBANK_NONE	No bank selected.
MEMBANK_CODEPLUG_LOWER	Lower memory bank (EEPROM).
MEMBANK_CODEPLUG_UPPER	Upper memory bank (FLASH).
MEMBANK_CALLSIGN_LOWER	Callsign DB memory lower bank (also FLASH).
MEMBANK_CALLSIGN_UPPER	Callsign DB memory upper bank (also FLASH).

Member Function Documentation

◆ close()

void RadioddityInterface::close ( )

virtual

Closes the connection to the device.

Implements RadioInterface.

◆ identifier()

RadioInfo RadioddityInterface::identifier ( const ErrorStack & err = ErrorStack() )

virtual

Returns radio identifier string.

Implements RadioInterface.

◆ isOpen()

bool RadioddityInterface::isOpen ( ) const

virtual

Returns true if the connection was established.

Implements RadioInterface.

◆ read()

bool RadioddityInterface::read	(	uint32_t	bank,
		uint32_t	addr,
		unsigned char *	data,
		int	nbytes,
		const ErrorStack &	err = ErrorStack() )

Reads a block of data from the device at the given block number.

Parameters

bank	The memory bank to read from.
addr	The address to read from within the memory bank.
data	Pointer to memory where the read data is stored.
nbytes	The number of bytes to read.
err	The error stack, messages are put onto.

Returns: true on success.

◆ read_finish()

bool RadioddityInterface::read_finish ( const ErrorStack & err = ErrorStack() )

virtual

This function ends a series of read operations.

This function will be re-implemented by certain interfaces that need completion of read operations (e.g., HID).

Parameters

err	Passes an error stack to put error messages on.

Implements RadioInterface.

◆ read_start()

bool RadioddityInterface::read_start	(	uint32_t	bank,
		uint32_t	addr,
		const ErrorStack &	err = ErrorStack() )

virtual

Starts the read process from the specified bank and at the given address.

Parameters

bank	Specifies the memory bank to read from. Usually there is only one bank. Some radios, however, to have several memory banks to hold the codeplug. For example the Open GD77 has EEPROM and Flash memory banks with independent addresses.
addr	Specifies the address to read from.
err	Passes an error stack to put error messages on.

Implements RadioInterface.

◆ write()

bool RadioddityInterface::write	(	uint32_t	bank,
		uint32_t	addr,
		unsigned char *	data,
		int	nbytes,
		const ErrorStack &	err = ErrorStack() )

Writes a block of data to the device at the given block number.

Parameters

bank	The memory bank to read from.
addr	The address to read from within the memory bank.
data	Pointer to memory where the read data is stored.
nbytes	The number of bytes to read.
err	The error stack, messages are put onto.

Returns: true on success.

◆ write_finish()

bool RadioddityInterface::write_finish ( const ErrorStack & err = ErrorStack() )

virtual

This function ends a series of write operations.

This function will be implemented by certain interfaces that need completion of write operations (e.g., HID).

Parameters

err	Passes an error stack to put error messages on.

Implements RadioInterface.

◆ write_start()

bool RadioddityInterface::write_start	(	uint32_t	bank,
		uint32_t	addr,
		const ErrorStack &	err = ErrorStack() )

virtual

Starts the write process into the specified bank and at the given address.

Parameters

bank	Specifies the memory bank to write to. Usually there is only one bank. Some radios, however, to have several memory banks to hold the codeplug. For example the Open GD77 has EEPROM and Flash memory banks with independent addresses.
addr	Specifies the address to write to.
err	Passes an error stack to put error messages on.

Implements RadioInterface.

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

/builddir/build/BUILD/qdmr-0.12.3-build/qdmr-0.12.3/lib/radioddity_interface.hh
/builddir/build/BUILD/qdmr-0.12.3-build/qdmr-0.12.3/lib/radioddity_interface.cc

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

◆ MemoryBank

Member Function Documentation

◆ close()

◆ identifier()

◆ isOpen()

◆ read()

◆ read_finish()

◆ read_start()

◆ write()

◆ write_finish()

◆ write_start()