Implements the OpenGD77 specific DMR contact. More...

#include <opengd77_codeplug.hh>

Inheritance diagram for OpenGD77Codeplug::ContactElement:

[legend]

Collaboration diagram for OpenGD77Codeplug::ContactElement:

[legend]

Classes
struct	Offset
	Holds some offsets within the element. More...

Public Types
typedef OpenGD77ContactExtension::TimeSlotOverride	TimeSlotOverride
	Reuse enum from extension.

Public Member Functions
	ContactElement (uint8_t *ptr)
	Constructor.

void	clear ()
	Resets the contact.

bool	isValid () const
	Returns `true` if the contact is valid. More...

void	markValid (bool valid=true)
	Marks the entry as valid/invalid.

virtual bool	overridesTimeSlot () const
	Returns `true` if this contact overrides the channel time slot.

virtual DMRChannel::TimeSlot	timeSlot () const
	Returns the time slot associated with the contact. More...

virtual void	setTimeSlot (DMRChannel::TimeSlot ts)
	Associates the given time slot with this contact. More...

virtual void	disableTimeSlotOverride ()
	Disables time slot override feature.

DMRContact *	toContactObj (Context &ctx) const
	Constructs a `DigitalContact` instance from this codeplug contact.

void	fromContactObj (const DMRContact *c, Context &ctx)
	Resets this codeplug contact from the given `DigitalContact`.

Public Member Functions inherited from GD77Codeplug::ContactElement
	ContactElement (uint8_t *ptr)
	Constructor.

Public Member Functions inherited from RadioddityCodeplug::ContactElement
	ContactElement (uint8_t *ptr)
	Constructor.

virtual	~ContactElement ()
	Destructor.

void	clear ()
	Resets the contact.

bool	isValid () const
	Returns `true` if the contact is valid.

virtual QString	name () const
	Returns the name of the contact.

virtual void	setName (const QString name)
	Sets the name of the contact.

virtual unsigned	number () const
	Returns the DMR number of the contact.

virtual void	setNumber (unsigned id)
	Sets the DMR number of the contact.

virtual DMRContact::Type	type () const
	Returns the call type.

virtual void	setType (DMRContact::Type type)
	Sets the call type.

virtual bool	ring () const
	Returns `true` if the ring tone is enabled for this contact.

virtual void	enableRing (bool enable)
	Enables/disables ring tone for this contact.

virtual unsigned	ringStyle () const
	Returns the ring tone style for this contact [0-10].

virtual void	setRingStyle (unsigned style)
	Sets the ring tone style for this contact [0-10].

Public Member Functions inherited from Codeplug::Element
	Element (const Element &other)
	Copy constructor.

virtual	~Element ()
	Destructor.

Element &	operator= (const Element &other)
	Copy assignment.

bool	fill (uint8_t value, unsigned offset=0, int size=-1)
	Fills the memsets the entire element to the given value.

bool	getBit (const Offset::BitOffset &offset) const
	Reads a specific bit at the given byte-offset.

bool	getBit (unsigned offset, unsigned bit) const
	Reads a specific bit at the given byte-offset.

void	setBit (const Offset::BitOffset &offset, bool value=true)
	Sets a specific bit at the given byte-offset.

void	setBit (unsigned offset, unsigned bit, bool value=true)
	Sets a specific bit at the given byte-offset.

void	clearBit (unsigned offset, unsigned bit)
	Clears a specific bit at the given byte-offset.

uint8_t	getUInt2 (unsigned offset, unsigned bit) const
	Reads a 2bit unsigned integer at the given byte- and bit-offset.

void	setUInt2 (unsigned offset, unsigned bit, uint8_t value)
	Stores a 2bit unsigned integer at the given byte- and bit-offset.

uint8_t	getUInt3 (unsigned offset, unsigned bit) const
	Reads a 3bit unsigned integer at the given byte- and bit-offset.

void	setUInt3 (unsigned offset, unsigned bit, uint8_t value)
	Stores a 3bit unsigned integer at the given byte- and bit-offset.

uint8_t	getUInt4 (unsigned offset, unsigned bit) const
	Reads a 4bit unsigned integer at the given byte- and bit-offset.

void	setUInt4 (unsigned offset, unsigned bit, uint8_t value)
	Stores a 4bit unsigned integer at the given byte- and bit-offset.

uint8_t	getUInt5 (unsigned offset, unsigned bit) const
	Reads a 5bit unsigned integer at the given byte- and bit-offset.

void	setUInt5 (unsigned offset, unsigned bit, uint8_t value)
	Stores a 5bit iunsinged nteger at the given byte- and bit-offset.

uint8_t	getUInt6 (unsigned offset, unsigned bit) const
	Reads a 6bit unsigned integer at the given byte- and bit-offset.

void	setUInt6 (unsigned offset, unsigned bit, uint8_t value)
	Stores a 6bit unsigned integer at the given byte- and bit-offset.

uint8_t	getUInt8 (unsigned offset) const
	Reads a 8bit unsigned integer at the given byte- and bit-offset.

void	setUInt8 (unsigned offset, uint8_t value)
	Reads a 8bit unsigned integer at the given byte- and bit-offset.

int8_t	getInt8 (unsigned offset) const
	Reads a 8bit signed integer at the given byte- and bit-offset.

void	setInt8 (unsigned offset, int8_t value)
	Reads a 8bit signed integer at the given byte- and bit-offset.

uint16_t	getUInt16_be (unsigned offset) const
	Reads a 16bit big-endian unsigned integer at the given byte-offset.

uint16_t	getUInt16_le (unsigned offset) const
	Reads a 16bit little-endian unsigned integer at the given byte-offset.

void	setUInt16_be (unsigned offset, uint16_t value)
	Stores a 16bit big-endian unsigned integer at the given byte-offset.

void	setUInt16_le (unsigned offset, uint16_t value)
	Stores a 16bit little-endian unsigned integer at the given byte-offset.

uint32_t	getUInt24_be (unsigned offset) const
	Reads a 24bit big-endian unsigned integer at the given byte-offset.

uint32_t	getUInt24_le (unsigned offset) const
	Reads a 24bit little-endian unsigned integer at the given byte-offset.

void	setUInt24_be (unsigned offset, uint32_t value)
	Stores a 24bit big-endian unsigned integer at the given byte-offset.

void	setUInt24_le (unsigned offset, uint32_t value)
	Stores a 24bit little-endian unsigned integer at the given byte-offset.

uint32_t	getUInt32_be (unsigned offset) const
	Reads a 32bit big-endian unsigned integer at the given byte-offset.

uint32_t	getUInt32_le (unsigned offset) const
	Reads a 32bit little-endian unsigned integer at the given byte-offset.

void	setUInt32_be (unsigned offset, uint32_t value)
	Stores a 32bit big-endian unsigned integer at the given byte-offset.

void	setUInt32_le (unsigned offset, uint32_t value)
	Stores a 32bit little-endian unsigned integer at the given byte-offset.

uint64_t	getUInt64_be (unsigned offset) const
	Reads a 64bit big-endian unsigned integer at the given byte-offset.

uint64_t	getUInt64_le (unsigned offset) const
	Reads a 64bit little-endian unsigned integer at the given byte-offset.

void	setUInt64_be (unsigned offset, uint64_t value)
	Stores a 64bit big-endian unsigned integer at the given byte-offset.

void	setUInt64_le (unsigned offset, uint64_t value)
	Stores a 64bit little-endian unsigned integer at the given byte-offset.

uint8_t	getBCD2 (unsigned offset) const
	Reads a 2-digit (1-byte/8bit) BDC value in big-endian at the given byte-offset.

void	setBCD2 (unsigned offset, uint8_t value)
	Stores a 2-digit (1-byte/8bit) BDC value in big-endian at the given byte-offset.

uint16_t	getBCD4_be (unsigned offset) const
	Reads a 4-digit (2-byte/16bit) BDC value in big-endian at the given byte-offset.

void	setBCD4_be (unsigned offset, uint16_t value)
	Stores a 4-digit (2-byte/16bit) BDC value in big-endian at the given byte-offset.

uint16_t	getBCD4_le (unsigned offset) const
	Reads a 4-digit (2-byte/16bit) BDC value in little-endian at the given byte-offset.

void	setBCD4_le (unsigned offset, uint16_t value)
	Stores a 4-digit (1-byte/16bit) BDC value in little-endian at the given byte-offset.

uint32_t	getBCD8_be (unsigned offset) const
	Reads a 8-digit (4-byte/32bit) BDC value in big-endian at the given byte-offset.

void	setBCD8_be (unsigned offset, uint32_t value)
	Stores a 8-digit (4-byte/32bit) BDC value in big-endian at the given byte-offset.

uint32_t	getBCD8_le (unsigned offset) const
	Reads a 8-digit (4-byte/32bit) BDC value in little-endian at the given byte-offset.

void	setBCD8_le (unsigned offset, uint32_t value)
	Stores a 8-digit (4-byte/32bit) BDC value in little-endian at the given byte-offset.

QString	readASCII (unsigned offset, unsigned maxlen, uint8_t eos=0x00) const
	Reads up to `maxlen` ASCII chars at the given byte-offset using `eos` as the string termination char.

void	writeASCII (unsigned offset, const QString &txt, unsigned maxlen, uint8_t eos=0x00)
	Stores up to `maxlen` ASCII chars at the given byte-offset using `eos` as the string termination char. More...

QString	readUnicode (unsigned offset, unsigned maxlen, uint16_t eos=0x0000) const
	Reads up to `maxlen` unicode chars at the given byte-offset using `eos` as the string termination char.

void	writeUnicode (unsigned offset, const QString &txt, unsigned maxlen, uint16_t eos=0x0000)
	Stores up to `maxlen` unicode chars at the given byte-offset using `eos` as the string termination char. More...

Additional Inherited Members
Protected Member Functions inherited from GD77Codeplug::ContactElement
	ContactElement (uint8_t *ptr, unsigned size)
	Hidden constructor.

Protected Member Functions inherited from RadioddityCodeplug::ContactElement
	ContactElement (uint8_t *ptr, unsigned size)
	Hidden constructor.

Protected Member Functions inherited from Codeplug::Element
	Element (uint8_t *ptr, size_t size)
	Hidden constructor. More...

Protected Attributes inherited from Codeplug::Element
uint8_t *	_data
	Holds the pointer to the element.

size_t	_size
	Holds the size of the element.

Detailed Description

Implements the OpenGD77 specific DMR contact.

Encoding of the contact:

       0                               8                               16                              24
     +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
0000 | Name, 16 ASCII encoded bytes, 0xff terminated                                                                              ...
     +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
000c  ...                                                                                                                            |
     +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
0010 | Contact DMR ID 8 BCD digits.                                                                                                  |
     +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
0014 | Type 0=Grp, 1=Priv, 2 = All   | RX tone 0=off, 1=on           | Ring style [0..10]            | Timeslot override             |
     +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+

Member Function Documentation

◆ isValid()

bool OpenGD77Codeplug::ContactElement::isValid ( ) const

virtual

Returns true if the contact is valid.

I.e., has a name.

Reimplemented from GD77Codeplug::ContactElement.

◆ setTimeSlot()

void OpenGD77Codeplug::ContactElement::setTimeSlot ( DMRChannel::TimeSlot ts )

virtual

Associates the given time slot with this contact.

This will cause the use this time slot whenever this contact is chosen as the TX contact. Irrespective of the selected time slot of the channel.

◆ timeSlot()

DMRChannel::TimeSlot OpenGD77Codeplug::ContactElement::timeSlot ( ) const

virtual

Returns the time slot associated with the contact.

Only valid if overridesTimeSlot returns true.

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

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

Classes

Public Types

Public Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ isValid()

◆ setTimeSlot()

◆ timeSlot()