qlowenergycharacteristic.cpp

Go to the documentation of this file.

// Copyright (C) 2016 BlackBerry Limited. All rights reserved.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only
 
#include "qlowenergycharacteristic.h"
#include "qlowenergyserviceprivate_p.h"
#include <QHash>
 
QT_BEGIN_NAMESPACE
 
QT_IMPL_METATYPE_EXTERN(QLowEnergyCharacteristic)
 
 
struct QLowEnergyCharacteristicPrivate
{
    QLowEnergyHandle handle;
};
 
QLowEnergyCharacteristic::QLowEnergyCharacteristic():
    d_ptr(nullptr)
{
 
}
 
QLowEnergyCharacteristic::QLowEnergyCharacteristic(const QLowEnergyCharacteristic &other):
    d_ptr(other.d_ptr)
{
    if (other.data) {
        data = new QLowEnergyCharacteristicPrivate();
        data->handle = other.data->handle;
    }
}
 
QLowEnergyCharacteristic::QLowEnergyCharacteristic(
        QSharedPointer<QLowEnergyServicePrivate> p, QLowEnergyHandle handle):
    d_ptr(p)
{
    data = new QLowEnergyCharacteristicPrivate();
    data->handle = handle;
}
 
QLowEnergyCharacteristic::~QLowEnergyCharacteristic()
{
    delete data;
}
 
QString QLowEnergyCharacteristic::name() const
{
    return QBluetoothUuid::characteristicToString(
                static_cast<QBluetoothUuid::CharacteristicType>(uuid().toUInt16()));
}
 
QBluetoothUuid QLowEnergyCharacteristic::uuid() const
{
    if (d_ptr.isNull() || !data
        || !d_ptr->characteristicList.contains(data->handle))
        return QBluetoothUuid();
 
    return d_ptr->characteristicList[data->handle].uuid;
}
 
QLowEnergyCharacteristic::PropertyTypes QLowEnergyCharacteristic::properties() const
{
    if (d_ptr.isNull() || !data
        || !d_ptr->characteristicList.contains(data->handle))
        return QLowEnergyCharacteristic::Unknown;
 
    return d_ptr->characteristicList[data->handle].properties;
}
 
QByteArray QLowEnergyCharacteristic::value() const
{
    if (d_ptr.isNull() || !data
        || !d_ptr->characteristicList.contains(data->handle))
        return QByteArray();
 
    return d_ptr->characteristicList[data->handle].value;
}
 
QLowEnergyHandle QLowEnergyCharacteristic::handle() const
{
    if (d_ptr.isNull() || !data
        || !d_ptr->characteristicList.contains(data->handle))
        return 0;
 
    return d_ptr->characteristicList[data->handle].valueHandle;
}
 
QLowEnergyCharacteristic &QLowEnergyCharacteristic::operator=(const QLowEnergyCharacteristic &other)
{
    d_ptr = other.d_ptr;
 
    if (!other.data) {
        if (data) {
            delete data;
            data = nullptr;
        }
    } else {
        if (!data)
            data = new QLowEnergyCharacteristicPrivate();
 
        data->handle = other.data->handle;
    }
    return *this;
}
 
bool QLowEnergyCharacteristic::equals(const QLowEnergyCharacteristic &a,
                                      const QLowEnergyCharacteristic &b)
{
    if (a.d_ptr != b.d_ptr)
        return false;
 
    if ((a.data && !b.data) || (!a.data && b.data))
        return false;
 
    if (!a.data)
        return true;
 
    if (a.data->handle != b.data->handle)
        return false;
 
    return true;
}
 
bool QLowEnergyCharacteristic::isValid() const
{
    if (d_ptr.isNull() || !data)
        return false;
 
    if (d_ptr->state == QLowEnergyService::InvalidService)
        return false;
 
    return true;
}
 
QLowEnergyHandle QLowEnergyCharacteristic::attributeHandle() const
{
    if (d_ptr.isNull() || !data)
        return 0;
 
    return data->handle;
}
 
QLowEnergyDescriptor QLowEnergyCharacteristic::descriptor(const QBluetoothUuid &uuid) const
{
    if (d_ptr.isNull() || !data)
        return QLowEnergyDescriptor();
 
    CharacteristicDataMap::const_iterator charIt = d_ptr->characteristicList.constFind(data->handle);
    if (charIt != d_ptr->characteristicList.constEnd()) {
        const QLowEnergyServicePrivate::CharData &charDetails = charIt.value();
 
        DescriptorDataMap::const_iterator descIt = charDetails.descriptorList.constBegin();
        for ( ; descIt != charDetails.descriptorList.constEnd(); ++descIt) {
            const QLowEnergyHandle descHandle = descIt.key();
            const QLowEnergyServicePrivate::DescData &descDetails = descIt.value();
 
            if (descDetails.uuid == uuid)
                return QLowEnergyDescriptor(d_ptr, data->handle, descHandle);
        }
    }
 
    return QLowEnergyDescriptor();
}
 
QLowEnergyDescriptor QLowEnergyCharacteristic::clientCharacteristicConfiguration() const
{
    return descriptor(QBluetoothUuid::DescriptorType::ClientCharacteristicConfiguration);
}
 
QList<QLowEnergyDescriptor> QLowEnergyCharacteristic::descriptors() const
{
    QList<QLowEnergyDescriptor> result;
 
    if (d_ptr.isNull() || !data
                       || !d_ptr->characteristicList.contains(data->handle))
        return result;
 
    QList<QLowEnergyHandle> descriptorKeys = d_ptr->characteristicList[data->handle].
                                                    descriptorList.keys();
 
    std::sort(descriptorKeys.begin(), descriptorKeys.end());
 
    for (const QLowEnergyHandle descHandle : std::as_const(descriptorKeys)) {
        QLowEnergyDescriptor descriptor(d_ptr, data->handle, descHandle);
        result.append(descriptor);
    }
 
    return result;
}
 
const QByteArray QLowEnergyCharacteristic::CCCDDisable = QByteArray::fromHex("0000");
const QByteArray QLowEnergyCharacteristic::CCCDEnableNotification = QByteArray::fromHex("0100");
const QByteArray QLowEnergyCharacteristic::CCCDEnableIndication = QByteArray::fromHex("0200");
 
QT_END_NAMESPACE