genericaccessservice.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: 2022-2023 Paul Colby <git@colby.id.au>
// SPDX-License-Identifier: LGPL-3.0-or-later
 
/*!
 * \file
 * Declares the GenericAccessService class.
 */
 
#ifndef QTPOKIT_GENERICACCESSSERVICE_H
#define QTPOKIT_GENERICACCESSSERVICE_H
 
#include "abstractpokitservice.h"
 
#include <QBluetoothAddress>
#include <QBluetoothUuid>
#include <QVersionNumber>
 
QTPOKIT_BEGIN_NAMESPACE
 
class GenericAccessServicePrivate;
 
class QTPOKIT_EXPORT GenericAccessService : public AbstractPokitService
{
    Q_OBJECT
 
public:
    /// UUID of the `Generic Access` service.
    static inline const QBluetoothUuid serviceUuid { QBluetoothUuid::ServiceClassUuid::GenericAccess };
 
    /// Characteristics available via the `Generic Access` service.
    struct QTPOKIT_EXPORT CharacteristicUuids {
        /// UUID of the `Generic Access` service's `Device Name` characterstic.
        static inline const QBluetoothUuid deviceName { QBluetoothUuid::CharacteristicType::DeviceName };
 
        /// UUID of the `Generic Access` service's `Appearance` characterstic.
        static inline const QBluetoothUuid appearance { QBluetoothUuid::CharacteristicType::Appearance };
    };
 
    GenericAccessService(QLowEnergyController * const pokitDevice, QObject * parent = nullptr);
    ~GenericAccessService() override;
 
    bool readCharacteristics() override;
    bool readAppearanceCharacteristic();
    bool readDeviceNameCharacteristic();
 
    // Appearance characteristic (BLE read only).
    quint16 appearance() const;
 
    // Device Name characteristic (BLE read/write).
    QString deviceName() const;
    bool setDeviceName(const QString &name);
 
signals:
    void appearanceRead(const quint16 appearance);
    void deviceNameRead(const QString &deviceName);
    void deviceNameWritten();
 
protected:
    /// \cond internal
    GenericAccessService(GenericAccessServicePrivate * const d, QObject * const parent);
    /// \endcond
 
private:
    Q_DECLARE_PRIVATE(GenericAccessService)
    Q_DISABLE_COPY(GenericAccessService)
    friend class TestGenericAccessService;
};
 
QTPOKIT_END_NAMESPACE
 
#endif // QTPOKIT_GENERICACCESSSERVICE_H