simplersble 1.1.1-dev24

The all-in-one Bluetooth library that makes it easy to add wireless connectivity to your projects.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72

#pragma once

#include <functional>
#include <map>
#include <memory>
#include <mutex>
#include <optional>
#include <set>
#include <vector>

#include <kvn_safe_callback.hpp>

#include "../common/LocalCharacteristicBase.h"
#include "types/android/bluetooth/BluetoothDevice.h"
#include "types/android/bluetooth/BluetoothGattCharacteristic.h"
#include "types/android/bluetooth/BluetoothGattDescriptor.h"

namespace SimpleBLE::Local {

class PeripheralAndroid;

class CharacteristicAndroid : public CharacteristicBase, public std::enable_shared_from_this<CharacteristicAndroid> {
  public:
    struct Subscriber {
        Android::BluetoothDevice device;
        bool confirm;
    };

    CharacteristicAndroid(std::weak_ptr<PeripheralAndroid> peripheral, BluetoothUUID uuid,
                          std::set<CharacteristicCapability> capabilities);
    ~CharacteristicAndroid() override;

    BluetoothUUID uuid() override;
    std::set<CharacteristicCapability> capabilities() override;
    ByteArray value() override;
    void set_value(ByteArray value) override;
    void set_callback_on_read(std::function<ByteArray()> on_read) override;
    void set_callback_on_write(std::function<void(ByteArray value)> on_write) override;
    void set_callback_on_subscribed(std::function<void()> on_subscribed) override;
    void set_callback_on_unsubscribed(std::function<void()> on_unsubscribed) override;

    Android::BluetoothGattCharacteristic native_characteristic() const;
    std::optional<Android::BluetoothGattDescriptor> native_cccd() const;

    bool can_read() const;
    bool can_write_request() const;
    bool can_write_command() const;
    ByteArray handle_read();
    void handle_write(ByteArray value);
    bool set_subscription(const Android::BluetoothDevice& device, const ByteArray& value);
    ByteArray subscription_value(const BluetoothAddress& address) const;
    std::vector<Subscriber> subscribers() const;
    void remove_subscriber(const BluetoothAddress& address);
    void clear_subscribers();

  private:
    std::weak_ptr<PeripheralAndroid> _peripheral;
    Android::BluetoothGattCharacteristic _characteristic;
    std::optional<Android::BluetoothGattDescriptor> _cccd;
    BluetoothUUID _uuid;
    std::set<CharacteristicCapability> _capabilities;
    ByteArray _value;
    std::map<BluetoothAddress, Subscriber> _subscribers;
    mutable std::mutex _mutex;

    kvn::safe_callback<ByteArray()> _callback_on_read;
    kvn::safe_callback<void(ByteArray)> _callback_on_write;
    kvn::safe_callback<void()> _callback_on_subscribed;
    kvn::safe_callback<void()> _callback_on_unsubscribed;
};

}  // namespace SimpleBLE::Local