Implements the interfact to a radio running the Open GD77 firmware. More...

#include <opengd77_interface.hh>

Inheritance diagram for OpenGD77Interface:

Classes
struct	CommandRequest
	Represents a command message. More...

struct	ReadRequest
	Represents a read message. More...

struct	ReadResponse
	Represents a read response message. More...

struct	WriteRequest
	Represents a write message. More...

struct	WriteResponse
	Represents a write-response message. More...

Public Member Functions
	OpenGD77Interface (QObject *parent=nullptr)
	Constructs a new interface to a OpenGD77 device. More...

virtual	~OpenGD77Interface ()
	Destructor.

void	close ()
	Closes the interface to the device.

QString	identifier ()
	Returns an identifier of the radio.

bool	read_start (uint32_t bank, uint32_t addr)
	Starts the read process from the specified bank and at the given address. More...

bool	read (uint32_t bank, uint32_t addr, uint8_t *data, int nbytes)
	Reads a chunk of data from the block-address `bno` (block number). More...

bool	read_finish ()
	This function ends a series of `read` operations. More...

bool	write_start (uint32_t bank, uint32_t addr)
	Starts the write process into the specified bank and at the given address. More...

bool	write (uint32_t bank, uint32_t addr, uint8_t *data, int nbytes)
	Writes a chunk of `data` at the address `addr`. More...

bool	write_finish ()
	This function ends a series of `write` operations. More...

bool	reboot ()
	Some radios need to be rebooted after being read or programmed. More...

Public Member Functions inherited from USBSerial
virtual	~USBSerial ()
	Destrutor.

bool	isOpen () const
	If `true`, the device has been found and is open.

void	close ()
	Closes the interface to the device.

const QString &	errorMessage () const
	Returns the last error message.

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

Static Public Attributes
static const uint32_t	EEPROM = 0
	The EEPROM memory bank.

static const uint32_t	FLASH = 1
	The Flash memory bank.

Protected Member Functions
bool	readEEPROM (uint32_t addr, uint8_t *data, uint16_t len)
	Write some data to EEPROM at the given address.

bool	writeEEPROM (uint32_t addr, const uint8_t *data, uint16_t len)
	Read some data from EEPROM at the given address.

bool	readFlash (uint32_t addr, uint8_t *data, uint16_t len)
	Read some data from Flash at the given address.

bool	setFlashSector (uint32_t addr)
	Select the correct Flash sector for the given address. More...

bool	writeFlash (uint32_t addr, const uint8_t *data, uint16_t len)
	Write some data to the given Flash memory.

bool	finishWriteFlash ()
	Finalize writing to the Flash memory. More...

bool	sendShowCPSScreen ()
	Send a "show CPS screen" message.

bool	sendClearScreen ()
	Send a "clear screen" message.

bool	sendDisplay (uint8_t x, uint8_t y, const char *message, uint8_t iSize, uint8_t alignment, uint8_t inverted)
	Send a "display some text" message.

bool	sendRenderCPS ()
	Send a "render CPS screen" message.

bool	sendCloseScreen ()
	Send a "close screen" message.

bool	sendCommand (CommandRequest::Option option)
	Sends some command message with the given options.

Protected Member Functions inherited from USBSerial
	USBSerial (unsigned vid, unsigned pid, QObject *parent=nullptr)
	Constructs an opens new serial interface to the devices identified by the given vendor and product IDs. More...

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

Protected Attributes
int32_t	_sector
	The current Flash sector, set to -1 if none is currently selected.

Protected Attributes inherited from USBSerial
QString	_errorMessage
	Holds the last error message.

Additional Inherited Members
Protected Slots inherited from USBSerial
void	onError (QSerialPort::SerialPortError error_t)
	Callback for serial interface errors.

void	onClose ()
	Callback when closing interface.

Detailed Description

Implements the interfact to a radio running the Open GD77 firmware.

This interface uses a USB serial-port to comunicate with the device. To find the corresponding port, the device-specific VID 0x1fc9 and PID 0x0094 are used. Hence no udev rules are needed to access these devices. The user, however, should be a member of the dialout group to get access to the serial interfaces.

Constructor & Destructor Documentation

◆ OpenGD77Interface()

OpenGD77Interface::OpenGD77Interface ( QObject * parent = nullptr )

explicit

Constructs a new interface to a OpenGD77 device.

If a matching device was found, isOpen returns true.

Member Function Documentation

◆ finishWriteFlash()

bool OpenGD77Interface::finishWriteFlash ( )

protected

Finalize writing to the Flash memory.

If not send after writing to a sector, the changes are lost.

◆ read()

bool OpenGD77Interface::read	(	uint32_t	bank,
		uint32_t	addr,
		uint8_t *	data,
		int	nbytes
	)

virtual

Reads a chunk of data from the block-address bno (block number).

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.
data	Pointer where to store the read data.
nbytes	Specifies the number of bytes to read.

Returns: true on success.

Implements RadioInterface.

◆ read_finish()

bool OpenGD77Interface::read_finish ( )

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

Implements RadioInterface.

◆ read_start()

bool OpenGD77Interface::read_start	(	uint32_t	bank,
		uint32_t	addr
	)

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.

Implements RadioInterface.

◆ reboot()

bool OpenGD77Interface::reboot ( )

virtual

Some radios need to be rebooted after being read or programmed.

This function will be re-implemented by some interfaces (e.g., DFUDevice) to reboot the radio. By default this function does nothing.

Reimplemented from RadioInterface.

◆ setFlashSector()

bool OpenGD77Interface::setFlashSector ( uint32_t addr )

protected

Select the correct Flash sector for the given address.

This command must be send before writing to the flash memory.

◆ write()

bool OpenGD77Interface::write	(	uint32_t	bank,
		uint32_t	addr,
		uint8_t *	data,
		int	nbytes
	)

virtual

Writes a chunk of data at the address addr.

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.
data	Pointer to the actual data to be written.
nbytes	Specifies the number of bytes to write.

Returns: true on success.

Implements RadioInterface.

◆ write_finish()

bool OpenGD77Interface::write_finish ( )

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

Implements RadioInterface.

◆ write_start()

bool OpenGD77Interface::write_start	(	uint32_t	bank,
		uint32_t	addr
	)

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.

Implements RadioInterface.

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

/home/hannes/Software/qdmr/lib/opengd77_interface.hh
/home/hannes/Software/qdmr/lib/opengd77_interface.cc

Classes

Public Member Functions

Static Public Attributes

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ OpenGD77Interface()

Member Function Documentation

◆ finishWriteFlash()

◆ read()

◆ read_finish()

◆ read_start()

◆ reboot()

◆ setFlashSector()

◆ write()

◆ write_finish()

◆ write_start()