multimeterservice.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: 2022-2025 Paul Colby <git@colby.id.au>
// SPDX-License-Identifier: LGPL-3.0-or-later
 
/*!
 * \file
 * Declares the MultimeterService class.
 */
 
#ifndef QTPOKIT_MULTIMETERSERVICE_H
#define QTPOKIT_MULTIMETERSERVICE_H
 
#include "abstractpokitservice.h"
 
#include <QBluetoothAddress>
#include <QBluetoothUuid>
#include <QVersionNumber>
 
QTPOKIT_BEGIN_NAMESPACE
 
class MultimeterServicePrivate;
 
class QTPOKIT_EXPORT MultimeterService : public AbstractPokitService
{
    Q_OBJECT
 
public:
    /// UUID of the `Multimeter` service.
    static inline const QBluetoothUuid serviceUuid { QStringLiteral("e7481d2f-5781-442e-bb9a-fd4e3441dadc") };
 
    /// Characteristics available via the `Multimeter` service.
    struct QTPOKIT_EXPORT CharacteristicUuids {
        /// UUID of the `Multimeter` service's `Settings` characterstic.
        static inline const QBluetoothUuid settings { QStringLiteral("53dc9a7a-bc19-4280-b76b-002d0e23b078") };
 
        /// UUID of the `Multimeter` service's `Reading` characterstic.
        static inline const QBluetoothUuid reading  { QStringLiteral("047d3559-8bee-423a-b229-4417fa603b90") };
    };
 
    /// Values supported by the `Mode` attribute of the `Settings` and `Reading` characteristics.
    enum class Mode : quint8 {
        Idle        = 0, ///< Make device idle.
        DcVoltage   = 1, ///< Measure DC voltage.
        AcVoltage   = 2, ///< Measure AC voltage.
        DcCurrent   = 3, ///< Measure DC current.
        AcCurrent   = 4, ///< Measure AC current.
        Resistance  = 5, ///< Measure resistance.
        Diode       = 6, ///< Measure diode.
        Continuity  = 7, ///< Measure continuity.
        Temperature = 8, ///< Measure temperature.
        Capacitance = 9, ///< Measure capacitance.
        ExternalTemperature = 10, ///< Measure temperature via an external temperature probe.
    };
    static QString toString(const Mode &mode);
 
    static QString toString(const PokitProduct product, const quint8 range, const Mode mode);
    QString toString(const quint8 range, const Mode mode) const;
    static quint32 maxValue(const PokitProduct product, const quint8 range, const Mode mode);
    quint32 maxValue(const quint8 range, const Mode mode) const;
 
    /// Attributes included in the `Settings` characterstic.
    struct Settings {
        Mode mode;              ///< Desired operation mode.
        quint8 range;           ///< Desired range.
        quint32 updateInterval; ///< Desired update interval in milliseconds.
    };
 
    /// Values supported by the `Status` attribute of the `Settings` characteristic.
    enum class MeterStatus : quint8 {
        AutoRangeOff = 0,  ///< Auto-range is disabled (voltage, current and resistance modes only).
        AutoRangeOn  = 1,  ///< Auto-range is enabled (voltage, current and resistance modes only).
        NoContinuity = 0,  ///< No continuity (continuity mode only).
        Continuity   = 1,  ///< Continuity (continuity mode only).
        Ok           = 0,  ///< Ok (temperature and diode modes only).
        Error        = 255 ///< Error (all modes).
    };
 
    /// Attributes included in the `Reading` characterstic.
    struct Reading {
        MeterStatus status; ///< Current multimeter status.
        float value;        ///< Last acquired value.
        Mode mode;          ///< Current operation mode.
        quint8 range;       ///< Current range.
    };
 
    MultimeterService(QLowEnergyController * const pokitDevice, QObject * parent = nullptr);
    ~MultimeterService() = default;
 
    bool readCharacteristics() override;
    bool readReadingCharacteristic();
 
    // Settings characteristic (BLE write only).
    bool setSettings(const Settings &settings);
 
    // Reading characteristic (BLE read/notify).
    Reading reading() const;
    bool enableReadingNotifications();
    bool disableReadingNotifications();
 
Q_SIGNALS:
    void settingsWritten();
    void readingRead(const MultimeterService::Reading &reading);
 
protected:
    /// \cond internal
    MultimeterService(MultimeterServicePrivate * const d, QObject * const parent);
    /// \endcond
 
private:
    Q_DECLARE_PRIVATE(MultimeterService)
    Q_DISABLE_COPY(MultimeterService)
    QTPOKIT_BEFRIEND_TEST(MultimeterService)
};
 
QTPOKIT_END_NAMESPACE
 
#endif // QTPOKIT_MULTIMETERSERVICE_H