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
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
|
// Copyright (C) 2016 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only
#ifndef QLOWENERGYCONTROLLER_H
#define QLOWENERGYCONTROLLER_H
#include <QtCore/QObject>
#include <QtBluetooth/QBluetoothAddress>
#include <QtBluetooth/QBluetoothDeviceInfo>
#include <QtBluetooth/QBluetoothUuid>
#include <QtBluetooth/QLowEnergyAdvertisingData>
#include <QtBluetooth/QLowEnergyConnectionParameters>
#include <QtBluetooth/QLowEnergyService>
QT_BEGIN_NAMESPACE
class QLowEnergyAdvertisingParameters;
class QLowEnergyControllerPrivate;
class QLowEnergyServiceData;
class Q_BLUETOOTH_EXPORT QLowEnergyController : public QObject
{
Q_OBJECT
public:
enum Error {
NoError,
UnknownError,
UnknownRemoteDeviceError,
NetworkError,
InvalidBluetoothAdapterError,
ConnectionError,
AdvertisingError,
RemoteHostClosedError,
AuthorizationError,
MissingPermissionsError,
RssiReadError
};
Q_ENUM(Error)
enum ControllerState {
UnconnectedState = 0,
ConnectingState,
ConnectedState,
DiscoveringState,
DiscoveredState,
ClosingState,
AdvertisingState,
};
Q_ENUM(ControllerState)
enum RemoteAddressType {
PublicAddress = 0,
RandomAddress
};
Q_ENUM(RemoteAddressType)
enum Role { CentralRole, PeripheralRole };
Q_ENUM(Role)
static QLowEnergyController *createCentral(const QBluetoothDeviceInfo &remoteDevice,
QObject *parent = nullptr);
static QLowEnergyController *createCentral(const QBluetoothDeviceInfo &remoteDevice,
const QBluetoothAddress &localDevice,
QObject *parent = nullptr);
static QLowEnergyController *createPeripheral(const QBluetoothAddress &localDevice,
QObject *parent = nullptr);
static QLowEnergyController *createPeripheral(QObject *parent = nullptr);
// TODO: Allow to set connection timeout (disconnect when no data has been exchanged for n seconds).
~QLowEnergyController();
QBluetoothAddress localAddress() const;
QBluetoothAddress remoteAddress() const;
QBluetoothUuid remoteDeviceUuid() const;
QString remoteName() const;
ControllerState state() const;
// TODO Qt6 remove this property. It is not longer needed when using Bluez DBus backend
RemoteAddressType remoteAddressType() const;
void setRemoteAddressType(RemoteAddressType type);
void connectToDevice();
void disconnectFromDevice();
void discoverServices();
QList<QBluetoothUuid> services() const;
QLowEnergyService *createServiceObject(const QBluetoothUuid &service, QObject *parent = nullptr);
void startAdvertising(const QLowEnergyAdvertisingParameters ¶meters,
const QLowEnergyAdvertisingData &advertisingData,
const QLowEnergyAdvertisingData &scanResponseData = QLowEnergyAdvertisingData());
void stopAdvertising();
QLowEnergyService *addService(const QLowEnergyServiceData &service, QObject *parent = nullptr);
void requestConnectionUpdate(const QLowEnergyConnectionParameters ¶meters);
Error error() const;
QString errorString() const;
Role role() const;
int mtu() const;
void readRssi();
Q_SIGNALS:
void connected();
void disconnected();
void stateChanged(QLowEnergyController::ControllerState state);
void errorOccurred(QLowEnergyController::Error newError);
void mtuChanged(int mtu);
void rssiRead(qint16 rssi);
void serviceDiscovered(const QBluetoothUuid &newService);
void discoveryFinished();
void connectionUpdated(const QLowEnergyConnectionParameters ¶meters);
private:
// peripheral role ctor
explicit QLowEnergyController(const QBluetoothAddress &localDevice, QObject *parent = nullptr);
// central role ctors
explicit QLowEnergyController(const QBluetoothDeviceInfo &remoteDevice,
const QBluetoothAddress &localDevice,
QObject *parent = nullptr);
Q_DECLARE_PRIVATE(QLowEnergyController)
QLowEnergyControllerPrivate *d_ptr;
};
QT_END_NAMESPACE
QT_DECL_METATYPE_EXTERN_TAGGED(QLowEnergyController::Error, QLowEnergyController__Error,
Q_BLUETOOTH_EXPORT)
QT_DECL_METATYPE_EXTERN_TAGGED(QLowEnergyController::ControllerState,
QLowEnergyController__ControllerState,
Q_BLUETOOTH_EXPORT)
QT_DECL_METATYPE_EXTERN_TAGGED(QLowEnergyController::RemoteAddressType,
QLowEnergyController__RemoteAddressType,
Q_BLUETOOTH_EXPORT)
QT_DECL_METATYPE_EXTERN_TAGGED(QLowEnergyController::Role, QLowEnergyController__Role,
Q_BLUETOOTH_EXPORT)
#endif // QLOWENERGYCONTROLLER_H
|
