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
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
|
// Copyright 2016 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef DEVICE_BLUETOOTH_BLUETOOTH_REMOTE_GATT_SERVICE_H_
#define DEVICE_BLUETOOTH_BLUETOOTH_REMOTE_GATT_SERVICE_H_
#include <memory>
#include <string>
#include <vector>
#include "base/containers/flat_map.h"
#include "device/bluetooth/bluetooth_export.h"
#include "device/bluetooth/bluetooth_gatt_service.h"
namespace device {
class BluetoothDevice;
class BluetoothRemoteGattCharacteristic;
class BluetoothUUID;
// BluetoothRemoteGattService represents a remote GATT service.
//
// Instances of the BluetoothRemoteGATTService class are used to represent GATT
// attribute hierarchies that have been received from a
// remote Bluetooth GATT peripheral. Such BluetoothRemoteGattService instances
// are constructed and owned by a BluetoothDevice.
//
// Note: We use virtual inheritance on the GATT service since it will be
// inherited by platform specific versions of the GATT service classes also. The
// platform specific remote GATT service classes will inherit both this class
// and their GATT service class, hence causing an inheritance diamond.
class DEVICE_BLUETOOTH_EXPORT BluetoothRemoteGattService
: public virtual BluetoothGattService {
public:
BluetoothRemoteGattService(const BluetoothRemoteGattService&) = delete;
BluetoothRemoteGattService& operator=(const BluetoothRemoteGattService&) =
delete;
~BluetoothRemoteGattService() override;
// Returns the BluetoothDevice that this GATT service was received from, which
// also owns this service.
virtual BluetoothDevice* GetDevice() const = 0;
// List of characteristics that belong to this service.
virtual std::vector<BluetoothRemoteGattCharacteristic*> GetCharacteristics()
const;
// List of GATT services that are included by this service.
virtual std::vector<BluetoothRemoteGattService*> GetIncludedServices()
const = 0;
// Returns the GATT characteristic with identifier |identifier| if it belongs
// to this GATT service.
virtual BluetoothRemoteGattCharacteristic* GetCharacteristic(
const std::string& identifier) const;
// List of characteristics that belong to this service and have a UUID equal
// to |characteristic_uuid|.
virtual std::vector<BluetoothRemoteGattCharacteristic*>
GetCharacteristicsByUUID(const BluetoothUUID& characteristic_uuid) const;
// Returns true if all the characteristics have been discovered.
virtual bool IsDiscoveryComplete() const;
// Sets characteristic discovery as complete or incomplete.
virtual void SetDiscoveryComplete(bool complete);
protected:
using CharacteristicMap =
base::flat_map<std::string,
std::unique_ptr<BluetoothRemoteGattCharacteristic>>;
BluetoothRemoteGattService();
bool AddCharacteristic(
std::unique_ptr<BluetoothRemoteGattCharacteristic> characteristic);
CharacteristicMap characteristics_;
private:
// Is true if all the characteristics have been discovered.
bool discovery_complete_ = false;
};
} // namespace device
#endif // DEVICE_BLUETOOTH_BLUETOOTH_REMOTE_GATT_SERVICE_H_
|
