Dokit
Native Qt library for Pokit devices
Loading...
Searching...
No Matches
DeviceInfoService Class Reference

The DeviceInfoService class accesses the Device Info service of Pokit devices. More...

Inheritance diagram for DeviceInfoService:
[legend]
Collaboration diagram for DeviceInfoService:
[legend]

Classes

struct  CharacteristicUuids
 Characteristics available via the Device Info service. More...
 

Signals

void manufacturerRead (const QString &name)
 This signal is emitted when the Manufacturer Name characteristic has been read successfully.
 
void modelNumberRead (const QString &model)
 This signal is emitted when the Model Number characteristic has been read successfully.
 
void hardwareRevisionRead (const QString &revision)
 This signal is emitted when the Hardware Revision characteristic has been read successfully.
 
void firmwareRevisionRead (const QString &revision)
 This signal is emitted when the Firmware Revision characteristic has been read successfully.
 
void softwareRevisionRead (const QString &revision)
 This signal is emitted when the Software Revision characteristic has been read successfully.
 
- Signals inherited from AbstractPokitService
void serviceDetailsDiscovered ()
 This signal is emitted when the Pokit service details have been discovered.
 
void serviceErrorOccurred (QLowEnergyService::ServiceError newError)
 This signal is emitted whenever an error occurs on the underlying QLowEnergyService.
 

Public Member Functions

 DeviceInfoService (QLowEnergyController *const pokitDevice, QObject *parent=nullptr)
 Constructs a new Pokit service with parent.
 
 ~DeviceInfoService () override
 Destroys this DeviceInfoService object.
 
bool readCharacteristics () override
 Read all characteristics.
 
bool readFirmwareRevisionCharacteristic ()
 Read the Device Info service's Firmware Revision characteristic.
 
bool readHardwareRevisionCharacteristic ()
 Read the Device Info service's Hardware Revision characteristic.
 
bool readManufacturerCharacteristics ()
 Read the Device Info service's Manufacturer Name characteristic.
 
bool readModelNumberCharacteristic ()
 Read the Device Info service's Model Number characteristic.
 
bool readSoftwareRevisionCharacteristic ()
 Read the Device Info service's Software Revision characteristic.
 
QString manufacturer () const
 Returns the most recent value of the Device Info service's Manufacturer Name characteristic.
 
QString modelNumber () const
 Returns the most recent value of the Device Info service's Model Number characteristic.
 
QString hardwareRevision () const
 Returns the most recent value of the Device Info service's Hardware Revision characteristic.
 
QString firmwareRevision () const
 Returns the most recent value of the Device Info service's Firmware Revision characteristic.
 
QString softwareRevision () const
 Returns the most recent value of the Device Info service's Software Revision characteristic.
 
- Public Member Functions inherited from AbstractPokitService
virtual ~AbstractPokitService ()
 Destroys this AbstractPokitService object.
 
virtual bool readCharacteristics ()=0
 Read all characteristics.
 
bool autoDiscover () const
 Returns true if autodiscovery of services and service details is enabled, false otherwise.
 
void setAutoDiscover (const bool discover=true)
 If discover is true, autodiscovery will be attempted.
 
QLowEnergyServiceservice ()
 Returns a non-const pointer to the internal service object, if any.
 
const QLowEnergyServiceservice () const
 Returns a const pointer to the internal service object, if any.
 
- Public Member Functions inherited from QObject
virtual const QMetaObjectmetaObject () const const
 
 QObject (QObject *parent)
 
virtual bool event (QEvent *e)
 
virtual bool eventFilter (QObject *watched, QEvent *event)
 
QString objectName () const const
 
void setObjectName (const QString &name)
 
bool isWidgetType () const const
 
bool isWindowType () const const
 
bool signalsBlocked () const const
 
bool blockSignals (bool block)
 
QThreadthread () const const
 
void moveToThread (QThread *targetThread)
 
int startTimer (int interval, Qt::TimerType timerType)
 
int startTimer (std::chrono::milliseconds time, Qt::TimerType timerType)
 
void killTimer (int id)
 
findChild (const QString &name, Qt::FindChildOptions options) const const
 
QList< T > findChildren (const QString &name, Qt::FindChildOptions options) const const
 
QList< T > findChildren (const QRegExp &regExp, Qt::FindChildOptions options) const const
 
QList< T > findChildren (const QRegularExpression &re, Qt::FindChildOptions options) const const
 
const QObjectListchildren () const const
 
void setParent (QObject *parent)
 
void installEventFilter (QObject *filterObj)
 
void removeEventFilter (QObject *obj)
 
QMetaObject::Connection connect (const QObject *sender, const char *signal, const char *method, Qt::ConnectionType type) const const
 
bool disconnect (const char *signal, const QObject *receiver, const char *method) const const
 
bool disconnect (const QObject *receiver, const char *method) const const
 
void dumpObjectTree ()
 
void dumpObjectInfo ()
 
void dumpObjectTree () const const
 
void dumpObjectInfo () const const
 
bool setProperty (const char *name, const QVariant &value)
 
QVariant property (const char *name) const const
 
QList< QByteArraydynamicPropertyNames () const const
 
void destroyed (QObject *obj)
 
void objectNameChanged (const QString &objectName)
 
QObjectparent () const const
 
bool inherits (const char *className) const const
 
void deleteLater ()
 
 Q_DISABLE_COPY (Class)
 
 Q_DISABLE_MOVE (Class)
 
 Q_DISABLE_COPY_MOVE (Class)
 
qobject_cast (QObject *object)
 
qobject_cast (const QObject *object)
 
qFindChild (const QObject *obj, const QString &name)
 
QList< T > qFindChildren (const QObject *obj, const QString &name)
 
QList< T > qFindChildren (const QObject *obj, const QRegExp &regExp)
 
 Q_CLASSINFO (Name, Value)
 
 Q_INTERFACES (...)
 
 Q_PROPERTY (...)
 
 Q_ENUMS (...)
 
 Q_FLAGS (...)
 
 Q_ENUM (...)
 
 Q_FLAG (...)
 
 Q_ENUM_NS (...)
 
 Q_FLAG_NS (...)
 
 Q_OBJECT Q_OBJECT
 
 Q_GADGET Q_GADGET
 
 Q_NAMESPACE Q_NAMESPACE
 
 Q_NAMESPACE_EXPORT (EXPORT_MACRO)
 
 Q_SIGNALS Q_SIGNALS
 
 Q_SIGNAL Q_SIGNAL
 
 Q_SLOTS Q_SLOTS
 
 Q_SLOT Q_SLOT
 
 Q_EMIT Q_EMIT
 
 Q_INVOKABLE Q_INVOKABLE
 
 Q_REVISION Q_REVISION
 
 Q_SET_OBJECT_NAME (Object)
 
 QT_NO_NARROWING_CONVERSIONS_IN_CONNECT QT_NO_NARROWING_CONVERSIONS_IN_CONNECT
 

Static Public Attributes

static const QBluetoothUuid serviceUuid
 UUID of the "Device Info" service.
 

Friends

class TestDeviceInfoService
 

Additional Inherited Members

- Static Public Member Functions inherited from QObject
QString tr (const char *sourceText, const char *disambiguation, int n)
 
QString trUtf8 (const char *sourceText, const char *disambiguation, int n)
 
QMetaObject::Connection connect (const QObject *sender, const char *signal, const QObject *receiver, const char *method, Qt::ConnectionType type)
 
QMetaObject::Connection connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type)
 
QMetaObject::Connection connect (const QObject *sender, PointerToMemberFunction signal, const QObject *receiver, PointerToMemberFunction method, Qt::ConnectionType type)
 
QMetaObject::Connection connect (const QObject *sender, PointerToMemberFunction signal, Functor functor)
 
QMetaObject::Connection connect (const QObject *sender, PointerToMemberFunction signal, const QObject *context, Functor functor, Qt::ConnectionType type)
 
bool disconnect (const QObject *sender, const char *signal, const QObject *receiver, const char *method)
 
bool disconnect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method)
 
bool disconnect (const QMetaObject::Connection &connection)
 
bool disconnect (const QObject *sender, PointerToMemberFunction signal, const QObject *receiver, PointerToMemberFunction method)
 
- Public Attributes inherited from QObject
typedef QObjectList
 
- Protected Member Functions inherited from QObject
QObjectsender () const const
 
int senderSignalIndex () const const
 
int receivers (const char *signal) const const
 
bool isSignalConnected (const QMetaMethod &signal) const const
 
virtual void timerEvent (QTimerEvent *event)
 
virtual void childEvent (QChildEvent *event)
 
virtual void customEvent (QEvent *event)
 
virtual void connectNotify (const QMetaMethod &signal)
 
virtual void disconnectNotify (const QMetaMethod &signal)
 
- Properties inherited from QObject
 objectName
 

Detailed Description

The DeviceInfoService class accesses the Device Info service of Pokit devices.

Member Function Documentation

◆ firmwareRevision()

QString DeviceInfoService::firmwareRevision ( ) const

Returns the most recent value of the Device Info service's Firmware Revision characteristic.

The returned value, if any, is from the underlying Bluetooth stack's cache. If no such value is currently available (ie the serviceDetailsDiscovered signal has not been emitted yet), then a null QString is returned.

Here is the call graph for this function:

◆ firmwareRevisionRead

DeviceInfoService::firmwareRevisionRead ( const QString revision)
signal

This signal is emitted when the Firmware Revision characteristic has been read successfully.

See also
readFirmwareRevisionCharacteristic
firmwareRevision

◆ hardwareRevision()

QString DeviceInfoService::hardwareRevision ( ) const

Returns the most recent value of the Device Info service's Hardware Revision characteristic.

The returned value, if any, is from the underlying Bluetooth stack's cache. If no such value is currently available (ie the serviceDetailsDiscovered signal has not been emitted yet), then a null QString is returned.

Here is the call graph for this function:

◆ hardwareRevisionRead

DeviceInfoService::hardwareRevisionRead ( const QString revision)
signal

This signal is emitted when the Hardware Revision characteristic has been read successfully.

See also
readHardwareRevisionCharacteristic
hardwareRevision

◆ manufacturer()

QString DeviceInfoService::manufacturer ( ) const

Returns the most recent value of the Device Info service's Manufacturer Name characteristic.

The returned value, if any, is from the underlying Bluetooth stack's cache. If no such value is currently available (ie the serviceDetailsDiscovered signal has not been emitted yet), then a null QString is returned.

Here is the call graph for this function:

◆ manufacturerRead

DeviceInfoService::manufacturerRead ( const QString name)
signal

This signal is emitted when the Manufacturer Name characteristic has been read successfully.

See also
readManufacturerCharacteristic
manufacturer

◆ modelNumber()

QString DeviceInfoService::modelNumber ( ) const

Returns the most recent value of the Device Info service's Model Number characteristic.

The returned value, if any, is from the underlying Bluetooth stack's cache. If no such value is currently available (ie the serviceDetailsDiscovered signal has not been emitted yet), then a null QString is returned.

Here is the call graph for this function:

◆ modelNumberRead

DeviceInfoService::modelNumberRead ( const QString model)
signal

This signal is emitted when the Model Number characteristic has been read successfully.

See also
readModelNumberCharacteristic
modelNumber

◆ readCharacteristics()

bool DeviceInfoService::readCharacteristics ( )
overridevirtual

Read all characteristics.

This convenience function will queue refresh requests of all characteristics supported by this service.

Relevant *Service::*Read signals will be emitted by derived class objects as each characteristic is successfully read.

Implements AbstractPokitService.

Here is the call graph for this function:

◆ readFirmwareRevisionCharacteristic()

bool DeviceInfoService::readFirmwareRevisionCharacteristic ( )

Read the Device Info service's Firmware Revision characteristic.

Returns true is the read request is succesfully queued, false otherwise (ie if the underlying controller it not yet connected to the Pokit device, or the device's services have not yet been discovered).

Emits firmwareRevisionRead() if/when the characteristic has been read successfully.

Here is the caller graph for this function:

◆ readHardwareRevisionCharacteristic()

bool DeviceInfoService::readHardwareRevisionCharacteristic ( )

Read the Device Info service's Hardware Revision characteristic.

Returns true is the read request is succesfully queued, false otherwise (ie if the underlying controller it not yet connected to the Pokit device, or the device's services have not yet been discovered).

Emits hardwareRevisionRead() if/when the characteristic has been read successfully.

Here is the caller graph for this function:

◆ readManufacturerCharacteristics()

bool DeviceInfoService::readManufacturerCharacteristics ( )

Read the Device Info service's Manufacturer Name characteristic.

Returns true is the read request is succesfully queued, false otherwise (ie if the underlying controller it not yet connected to the Pokit device, or the device's services have not yet been discovered).

Emits manufacturerNameRead() if/when the characteristic has been read successfully.

Here is the caller graph for this function:

◆ readModelNumberCharacteristic()

bool DeviceInfoService::readModelNumberCharacteristic ( )

Read the Device Info service's Model Number characteristic.

Returns true is the read request is succesfully queued, false otherwise (ie if the underlying controller it not yet connected to the Pokit device, or the device's services have not yet been discovered).

Emits modelNumberRead() if/when the characteristic has been read successfully.

Here is the caller graph for this function:

◆ readSoftwareRevisionCharacteristic()

bool DeviceInfoService::readSoftwareRevisionCharacteristic ( )

Read the Device Info service's Software Revision characteristic.

Returns true is the read request is succesfully queued, false otherwise (ie if the underlying controller it not yet connected to the Pokit device, or the device's services have not yet been discovered).

Emits softwareRevisionRead() if/when the characteristic has been read successfully.

Here is the caller graph for this function:

◆ softwareRevision()

QString DeviceInfoService::softwareRevision ( ) const

Returns the most recent value of the Device Info service's Software Revision characteristic.

The returned value, if any, is from the underlying Bluetooth stack's cache. If no such value is currently available (ie the serviceDetailsDiscovered signal has not been emitted yet), then a null QString is returned.

Here is the call graph for this function:

◆ softwareRevisionRead

DeviceInfoService::softwareRevisionRead ( const QString revision)
signal

This signal is emitted when the Software Revision characteristic has been read successfully.

See also
readSoftwareRevisionCharacteristic
softwareRevision

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