Dokit 0.5.3-pre
Internal development documentation
Loading...
Searching...
No Matches
DataLoggerService Class Reference

The DataLoggerService class accesses the Data Logger service of Pokit devices. More...

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

Classes

struct  CharacteristicUuids
 Characteristics available via the DataLogger service. More...
 
struct  Metadata
 Attributes included in the Metadata characterstic. More...
 
struct  Settings
 Attributes included in the Settings characterstic. More...
 

Public Types

enum class  Command : quint8 { Start = 0 , Stop = 1 , Refresh = 2 }
 Values supported by the Command attribute of the Settings characteristic. More...
 
enum class  Mode : quint8 {
  Idle = 0 , DcVoltage = 1 , AcVoltage = 2 , DcCurrent = 3 ,
  AcCurrent = 4 , Temperature = 5
}
 Values supported by the Mode attribute of the Settings and Metadata characteristics. More...
 
enum class  LoggerStatus : quint8 { Done = 0 , Sampling = 1 , BufferFull = 2 , Error = 255 }
 Values supported by the Status attribute of the Metadata characteristic. More...
 
typedef QVector< qint16 > Samples
 Raw samples from the Reading characteristic.
 

Signals

void settingsWritten ()
 This signal is emitted when the Settings characteristic has been written successfully.
 
void metadataRead (const DataLoggerService::Metadata &meta)
 This signal is emitted when the Metadata characteristic has been read successfully.
 
void samplesRead (const DataLoggerService::Samples &samples)
 This signal is emitted when the Reading characteristic has been notified.
 
- 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

QString toString (const quint8 range, const Mode mode) const
 Returns range as a user-friendly string, or a null QString if mode has no ranges.
 
QVariant maxValue (const quint8 range, const Mode mode) const
 Returns the maximum value for range, or the string "Auto".
 
 DataLoggerService (QLowEnergyController *const pokitDevice, QObject *parent=nullptr)
 Constructs a new Pokit service with parent.
 
 ~DataLoggerService () override
 Destroys this DataLoggerService object.
 
bool readCharacteristics () override
 Read all characteristics.
 
bool readMetadataCharacteristic ()
 Reads the DataLogger service's Metadata characteristic.
 
bool setSettings (const Settings &settings)
 Configures the Pokit device's data logger mode.
 
bool startLogger (const Settings &settings)
 Start the data logger with settings.
 
bool stopLogger ()
 Stop the data logger.
 
bool fetchSamples ()
 Start the data logger.
 
Metadata metadata () const
 Returns the most recent value of the DataLogger service's Metadata characteristic.
 
bool enableMetadataNotifications ()
 Enables client-side notifications of Data Logger metadata changes.
 
bool disableMetadataNotifications ()
 Disables client-side notifications of Data Logger metadata changes.
 
bool enableReadingNotifications ()
 Enables client-side notifications of Data Logger readings.
 
bool disableReadingNotifications ()
 Disables client-side notifications of Data Logger readings.
 
- Public Member Functions inherited from AbstractPokitService
virtual ~AbstractPokitService ()
 Destroys this AbstractPokitService object.
 
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.
 
std::optional< PokitProductpokitProduct () const
 Returns the Pokit product this service is attached to.
 
void setPokitProduct (const PokitProduct product)
 Sets the current Pokit product.
 
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 Member Functions

static QString toString (const Mode &mode)
 Returns mode as a user-friendly string.
 
static QString toString (const PokitProduct product, const quint8 range, const Mode mode)
 Returns range as a user-friendly string, or a null QString if mode has no ranges.
 
static QVariant maxValue (const PokitProduct product, const quint8 range, const Mode mode)
 Returns the maximum value for range, or the string "Auto".
 
- 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)
 

Static Public Attributes

static const QBluetoothUuid serviceUuid { QStringLiteral("a5ff3566-1fd8-4e10-8362-590a578a4121") }
 UUID of the "DataLogger" service.
 

Protected Member Functions

 DataLoggerService (DataLoggerServicePrivate *const d, QObject *const parent)
 Constructs a new Pokit service with parent, and private implementation d.
 
- Protected Member Functions inherited from AbstractPokitService
 AbstractPokitService (AbstractPokitServicePrivate *const d, QObject *const parent)
 Constructs a new Pokit service with parent, and private implementation d.
 
- 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)
 

Friends

class TestDataLoggerService
 

Additional Inherited Members

- Public Attributes inherited from QObject
typedef QObjectList
 
- Protected Attributes inherited from AbstractPokitService
AbstractPokitServicePrivated_ptr
 Internal d-pointer.
 
- Properties inherited from QObject
 objectName
 

Detailed Description

The DataLoggerService class accesses the Data Logger service of Pokit devices.

Definition at line 22 of file dataloggerservice.h.

Member Typedef Documentation

◆ Samples

Raw samples from the Reading characteristic.

These raw samples are (supposedly) within the range -2048 to +2047, and need to be multiplied by the Metadata::scale value from the Metadata characteristc to get the true values.

Also supposedly, there should be no more than 10 samples at a time, according to Pokit's current API docs. There is not artificial limitation imposed by QtPokit, so devices may begin batching more samples in future. Specifically, the Pokit Pro seems to send 88 samples (in 176 bytes) at a time.

Definition at line 94 of file dataloggerservice.h.

Member Enumeration Documentation

◆ Command

enum class DataLoggerService::Command : quint8
strong

Values supported by the Command attribute of the Settings characteristic.

Enumerator
Start 

Start the Data Logger.

Stop 

Stop the Data Logger.

Refresh 

Refresh the Data Logger.

Definition at line 43 of file dataloggerservice.h.

43 : quint8 {
44 Start = 0, ///< Start the Data Logger.
45 Stop = 1, ///< Stop the Data Logger.
46 Refresh = 2, ///< Refresh the Data Logger.
47 };
@ Stop
Stop the Data Logger.
@ Refresh
Refresh the Data Logger.
@ Start
Start the Data Logger.

◆ LoggerStatus

enum class DataLoggerService::LoggerStatus : quint8
strong

Values supported by the Status attribute of the Metadata characteristic.

Enumerator
Done 

Sampling has completed.

Sampling 

Actively sampling.

BufferFull 

Buffer is full.

Error 

An error has occurred.

Definition at line 76 of file dataloggerservice.h.

76 : quint8 {
77 Done = 0, ///< Sampling has completed.
78 Sampling = 1, ///< Actively sampling.
79 BufferFull = 2, ///< Buffer is full.
80 Error = 255 ///< An error has occurred.
81 };
@ Sampling
Actively sampling.
@ Error
An error has occurred.
@ Done
Sampling has completed.

◆ Mode

enum class DataLoggerService::Mode : quint8
strong

Values supported by the Mode attribute of the Settings and Metadata characteristics.

Enumerator
Idle 

Make device idle.

DcVoltage 

Measure DC voltage.

AcVoltage 

Measure AC voltage.

DcCurrent 

Measure DC current.

AcCurrent 

Measure AC current.

Temperature 

Measure temperature.

Definition at line 50 of file dataloggerservice.h.

50 : quint8 {
51 Idle = 0, ///< Make device idle.
52 DcVoltage = 1, ///< Measure DC voltage.
53 AcVoltage = 2, ///< Measure AC voltage.
54 DcCurrent = 3, ///< Measure DC current.
55 AcCurrent = 4, ///< Measure AC current.
56 Temperature = 5, ///< Measure temperature.
57 };
@ DcVoltage
Measure DC voltage.
@ AcCurrent
Measure AC current.
@ AcVoltage
Measure AC voltage.
@ Idle
Make device idle.
@ Temperature
Measure temperature.
@ DcCurrent
Measure DC current.

Constructor & Destructor Documentation

◆ DataLoggerService() [1/2]

DataLoggerService::DataLoggerService ( QLowEnergyController *const pokitDevice,
QObject * parent = nullptr )

Constructs a new Pokit service with parent.

Definition at line 113 of file dataloggerservice.cpp.

115{
116
117}
The AbstractPokitService class provides a common base for Pokit services classes.
The DataLoggerServicePrivate class provides private implementation for DataLoggerService.
QObject * parent() const const

◆ ~DataLoggerService()

DataLoggerService::~DataLoggerService ( )
override

Destroys this DataLoggerService object.

Definition at line 134 of file dataloggerservice.cpp.

135{
136
137}

◆ DataLoggerService() [2/2]

DataLoggerService::DataLoggerService ( DataLoggerServicePrivate *const d,
QObject *const parent )
protected

Constructs a new Pokit service with parent, and private implementation d.

Definition at line 123 of file dataloggerservice.cpp.

126{
127
128}

Member Function Documentation

◆ disableMetadataNotifications()

bool DataLoggerService::disableMetadataNotifications ( )

Disables client-side notifications of Data Logger metadata changes.

Instantaneous reads can still be fetched by readMetadataCharacteristic().

Returns true is the request was successfully submited to the device queue, false otherwise.

Definition at line 280 of file dataloggerservice.cpp.

281{
283 return d->disableCharacteristicNotificatons(CharacteristicUuids::metadata);
284}
The DataLoggerService class accesses the Data Logger service of Pokit devices.
static const QBluetoothUuid metadata
UUID of the DataLogger service's Metadata characterstic.

References DataLoggerService::CharacteristicUuids::metadata.

◆ disableReadingNotifications()

bool DataLoggerService::disableReadingNotifications ( )

Disables client-side notifications of Data Logger readings.

Returns true is the request was successfully submited to the device queue, false otherwise.

Definition at line 304 of file dataloggerservice.cpp.

305{
307 return d->disableCharacteristicNotificatons(CharacteristicUuids::reading);
308}
static const QBluetoothUuid reading
UUID of the DataLogger service's Reading characterstic.

References DataLoggerService::CharacteristicUuids::reading.

◆ enableMetadataNotifications()

bool DataLoggerService::enableMetadataNotifications ( )

Enables client-side notifications of Data Logger metadata changes.

This is an alternative to manually requesting individual reads via readMetadataCharacteristic().

Returns true is the request was successfully submited to the device queue, false otherwise.

Successfully read values (if any) will be emitted via the metadataRead() signal.

Definition at line 267 of file dataloggerservice.cpp.

268{
270 return d->enableCharacteristicNotificatons(CharacteristicUuids::metadata);
271}

References DataLoggerService::CharacteristicUuids::metadata.

Referenced by LoggerFetchCommand::serviceDetailsDiscovered().

Here is the caller graph for this function:

◆ enableReadingNotifications()

bool DataLoggerService::enableReadingNotifications ( )

Enables client-side notifications of Data Logger readings.

Returns true is the request was successfully submited to the device queue, false otherwise.

Successfully read samples (if any) will be emitted via the samplesRead() signal.

Definition at line 293 of file dataloggerservice.cpp.

294{
296 return d->enableCharacteristicNotificatons(CharacteristicUuids::reading);
297}

References DataLoggerService::CharacteristicUuids::reading.

Referenced by LoggerFetchCommand::serviceDetailsDiscovered().

Here is the caller graph for this function:

◆ fetchSamples()

bool DataLoggerService::fetchSamples ( )

Start the data logger.

This is just a convenience function equivalent to calling setSettings() with the command set to DataLoggerService::Command::Refresh.

Once the Pokit device has processed this request succesffully, the device will begin notifying the Metadata and Reading characteristic, resulting in emits of metadataRead and samplesRead respectively.

Definition at line 227 of file dataloggerservice.cpp.

228{
229 // Note, only the Settings::command member need be set, since the others are all ignored by the
230 // Pokit device when the command is Refresh. However, we still explicitly initialise all other
231 // members just to ensure we're never exposing uninitialised RAM to an external device.
233}
bool setSettings(const Settings &settings)
Configures the Pokit device's data logger mode.

References Idle, Refresh, and setSettings().

Referenced by LoggerFetchCommand::serviceDetailsDiscovered().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ maxValue() [1/2]

QVariant DataLoggerService::maxValue ( const PokitProduct product,
const quint8 range,
const Mode mode )
static

Returns the maximum value for range, or the string "Auto".

If range is not a known valid enumeration value for product's mode, then a null QVariant is returned.

Definition at line 69 of file dataloggerservice.cpp.

70{
71 switch (mode) {
72 case Mode::Idle:
73 break;
74 case Mode::DcVoltage:
75 case Mode::AcVoltage:
76 return VoltageRange::maxValue(product, range);
77 case Mode::DcCurrent:
78 case Mode::AcCurrent:
79 return CurrentRange::maxValue(product, range);
81 break;
82 }
83 return QVariant();
84}
QVariant maxValue(const PokitProduct product, const quint8 range)
Returns the maximum value for product's range in (integer) microamps, or the string "Auto".
QVariant maxValue(const PokitProduct product, const quint8 range)
Returns the maximum value for product's range in (integer) millivolts, or the string "Auto".

References AcCurrent, AcVoltage, DcCurrent, DcVoltage, Idle, CurrentRange::maxValue(), VoltageRange::maxValue(), and Temperature.

Referenced by maxValue().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ maxValue() [2/2]

QVariant DataLoggerService::maxValue ( const quint8 range,
const Mode mode ) const

Returns the maximum value for range, or the string "Auto".

If range is not a known valid enumeration value for the current product's mode, then a null QVariant is returned.

Definition at line 92 of file dataloggerservice.cpp.

93{
94 return maxValue(*pokitProduct(), range, mode);
95}
std::optional< PokitProduct > pokitProduct() const
Returns the Pokit product this service is attached to.
static QVariant maxValue(const PokitProduct product, const quint8 range, const Mode mode)
Returns the maximum value for range, or the string "Auto".

References maxValue(), and AbstractPokitService::pokitProduct().

Here is the call graph for this function:

◆ metadata()

DataLoggerService::Metadata DataLoggerService::metadata ( ) const

Returns the most recent value of the DataLogger service's Metadata 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 the returned DataLoggerService::Metadata::scale member will be a quiet NaN, which can be checked like:

const DataLoggerService::Metadata metadata = multimeterService->metadata();
if (qIsNaN(metadata.scale)) {
// Handle failure.
}
Metadata metadata() const
Returns the most recent value of the DataLogger service's Metadata characteristic.
Attributes included in the Metadata characterstic.
float scale
Scale to apply to read samples.

Definition at line 249 of file dataloggerservice.cpp.

250{
251 Q_D(const DataLoggerService);
252 const QLowEnergyCharacteristic characteristic =
253 d->getCharacteristic(CharacteristicUuids::metadata);
254 return (characteristic.isValid()) ? DataLoggerServicePrivate::parseMetadata(characteristic.value())
255 : Metadata{ LoggerStatus::Error, std::numeric_limits<float>::quiet_NaN(), Mode::Idle, 0, 0, 0, 0 };
256}
static DataLoggerService::Metadata parseMetadata(const QByteArray &value)
Parses the Metadata value into a DataLoggerService::Metatdata struct.
LoggerStatus
Values supported by the Status attribute of the Metadata characteristic.
Mode
Values supported by the Mode attribute of the Settings and Metadata characteristics.
bool isValid() const const
QByteArray value() const const

References Error, Idle, QLowEnergyCharacteristic::isValid(), DataLoggerService::CharacteristicUuids::metadata, DataLoggerServicePrivate::parseMetadata(), and QLowEnergyCharacteristic::value().

Here is the call graph for this function:

◆ metadataRead

void DataLoggerService::metadataRead ( const DataLoggerService::Metadata & meta)
signal

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

See also
readMetadataCharacteristic

Referenced by LoggerFetchCommand::getService().

Here is the caller graph for this function:

◆ readCharacteristics()

bool DataLoggerService::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.

Definition at line 139 of file dataloggerservice.cpp.

140{
142}
bool readMetadataCharacteristic()
Reads the DataLogger service's Metadata characteristic.

References readMetadataCharacteristic().

Here is the call graph for this function:

◆ readMetadataCharacteristic()

bool DataLoggerService::readMetadataCharacteristic ( )

Reads the DataLogger service's Metadata 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 metadataRead() if/when the characteristic has been read successfully.

Definition at line 153 of file dataloggerservice.cpp.

154{
156 return d->readCharacteristic(CharacteristicUuids::metadata);
157}

References DataLoggerService::CharacteristicUuids::metadata.

Referenced by readCharacteristics().

Here is the caller graph for this function:

◆ samplesRead

void DataLoggerService::samplesRead ( const DataLoggerService::Samples & samples)
signal

This signal is emitted when the Reading characteristic has been notified.

See also
beginSampling
stopSampling

Referenced by LoggerFetchCommand::getService().

Here is the caller graph for this function:

◆ setSettings()

bool DataLoggerService::setSettings ( const Settings & settings)

Configures the Pokit device's data logger mode.

Returns true if the write request was successfully queued, false otherwise.

Emits settingsWritten() if/when the settings have been writtem successfully.

Definition at line 166 of file dataloggerservice.cpp.

167{
168 Q_D(const DataLoggerService);
169 const QLowEnergyCharacteristic characteristic =
170 d->getCharacteristic(CharacteristicUuids::settings);
171 if (!characteristic.isValid()) {
172 return false;
173 }
174
175 const bool updateIntervalIs32bit =
176 (d->getCharacteristic(CharacteristicUuids::metadata).value().size() >= 23);
177 const QByteArray value = DataLoggerServicePrivate::encodeSettings(settings, updateIntervalIs32bit);
178 if (value.isNull()) {
179 return false;
180 }
181
182 d->service->writeCharacteristic(characteristic, value);
183 return (d->service->error() != QLowEnergyService::ServiceError::CharacteristicWriteError);
184}
static QByteArray encodeSettings(const DataLoggerService::Settings &settings, const bool updateIntervalIs32bit)
Returns settings in the format Pokit devices expect.
bool isNull() const const
static const QBluetoothUuid settings
UUID of the DataLogger service's Settings characterstic.

References DataLoggerServicePrivate::encodeSettings(), QByteArray::isNull(), QLowEnergyCharacteristic::isValid(), DataLoggerService::CharacteristicUuids::metadata, and DataLoggerService::CharacteristicUuids::settings.

Referenced by fetchSamples(), LoggerStartCommand::serviceDetailsDiscovered(), startLogger(), and stopLogger().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ settingsWritten

void DataLoggerService::settingsWritten ( )
signal

This signal is emitted when the Settings characteristic has been written successfully.

See also
setSettings

Referenced by LoggerStartCommand::getService(), and LoggerStopCommand::getService().

Here is the caller graph for this function:

◆ startLogger()

bool DataLoggerService::startLogger ( const Settings & settings)

Start the data logger with settings.

This is just a synonym for setSettings() except makes the caller's intention more explicit, and sanity-checks that the settings's command is DataLoggerService::Command::Start.

Definition at line 192 of file dataloggerservice.cpp.

193{
194 Q_D(const DataLoggerService);
195 Q_ASSERT(settings.command == DataLoggerService::Command::Start);
196 if (settings.command != DataLoggerService::Command::Start) {
197 qCWarning(d->lc).noquote() << tr("Settings command must be 'Start'.");
198 return false;
199 }
200 return setSettings(settings);
201}
QString tr(const char *sourceText, const char *disambiguation, int n)

References DataLoggerService::Settings::command, setSettings(), Start, and QObject::tr().

Here is the call graph for this function:

◆ stopLogger()

bool DataLoggerService::stopLogger ( )

Stop the data logger.

This is just a convenience function equivalent to calling setSettings() with the command set to DataLoggerService::Command::Stop.

Definition at line 209 of file dataloggerservice.cpp.

210{
211 // Note, only the Settings::command member need be set, since the others are all ignored by the
212 // Pokit device when the command is Stop. However, we still explicitly initialise all other
213 // members just to ensure we're never exposing uninitialised RAM to an external device.
215}

References Idle, setSettings(), and Stop.

Referenced by LoggerStopCommand::serviceDetailsDiscovered().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ toString() [1/3]

QString DataLoggerService::toString ( const Mode & mode)
static

Returns mode as a user-friendly string.

Definition at line 27 of file dataloggerservice.cpp.

28{
29 switch (mode) {
30 case Mode::Idle: return tr("Idle");
31 case Mode::DcVoltage: return tr("DC voltage");
32 case Mode::AcVoltage: return tr("AC voltage");
33 case Mode::DcCurrent: return tr("DC current");
34 case Mode::AcCurrent: return tr("AC current");
35 case Mode::Temperature: return tr("Temperature");
36 default: return QString();
37 }
38}

References AcCurrent, AcVoltage, DcCurrent, DcVoltage, Idle, Temperature, and QObject::tr().

Referenced by LoggerFetchCommand::metadataRead(), LoggerFetchCommand::outputSamples(), and LoggerStartCommand::serviceDetailsDiscovered().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ toString() [2/3]

QString DataLoggerService::toString ( const PokitProduct product,
const quint8 range,
const Mode mode )
static

Returns range as a user-friendly string, or a null QString if mode has no ranges.

Definition at line 41 of file dataloggerservice.cpp.

42{
43 switch (mode) {
44 case Mode::Idle:
45 break;
46 case Mode::DcVoltage:
47 case Mode::AcVoltage:
48 return VoltageRange::toString(product, range);
49 case Mode::DcCurrent:
50 case Mode::AcCurrent:
51 return CurrentRange::toString(product, range);
53 break;
54 }
55 return QString();
56}
QString toString(const PokitProduct product, const quint8 range)
Returns product's current range as a human-friendly string.
QString toString(const PokitProduct product, const quint8 range)
Returns product's current range as a human-friendly string.

References AcCurrent, AcVoltage, DcCurrent, DcVoltage, Idle, Temperature, CurrentRange::toString(), and VoltageRange::toString().

Here is the call graph for this function:

◆ toString() [3/3]

QString DataLoggerService::toString ( const quint8 range,
const Mode mode ) const

Returns range as a user-friendly string, or a null QString if mode has no ranges.

Definition at line 59 of file dataloggerservice.cpp.

60{
61 return toString(*pokitProduct(), range, mode);
62}
static QString toString(const Mode &mode)
Returns mode as a user-friendly string.

References AbstractPokitService::pokitProduct(), and toString().

Referenced by toString().

Here is the call graph for this function:
Here is the caller graph for this function:

Friends And Related Symbol Documentation

◆ TestDataLoggerService

friend class TestDataLoggerService
friend

Definition at line 130 of file dataloggerservice.h.

Member Data Documentation

◆ serviceUuid

const QBluetoothUuid DataLoggerService::serviceUuid { QStringLiteral("a5ff3566-1fd8-4e10-8362-590a578a4121") }
inlinestatic

UUID of the "DataLogger" service.

Definition at line 28 of file dataloggerservice.h.

28{ QStringLiteral("a5ff3566-1fd8-4e10-8362-590a578a4121") };

Referenced by PokitDevice::serviceToString().


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