esp-nimble-cpp 2.3.3
Loading...
Searching...
No Matches
NimBLEServer.h
1/*
2 * Copyright 2020-2025 Ryan Powell <ryan@nable-embedded.io> and
3 * esp-nimble-cpp, NimBLE-Arduino contributors.
4 *
5 * Licensed under the Apache License, Version 2.0 (the "License");
6 * you may not use this file except in compliance with the License.
7 * You may obtain a copy of the License at
8 *
9 * http://www.apache.org/licenses/LICENSE-2.0
10 *
11 * Unless required by applicable law or agreed to in writing, software
12 * distributed under the License is distributed on an "AS IS" BASIS,
13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 * See the License for the specific language governing permissions and
15 * limitations under the License.
16 */
17
18#ifndef NIMBLE_CPP_SERVER_H_
19#define NIMBLE_CPP_SERVER_H_
20
21#include "syscfg/syscfg.h"
22#if CONFIG_BT_NIMBLE_ENABLED && MYNEWT_VAL(BLE_ROLE_PERIPHERAL)
23
24# if defined(CONFIG_NIMBLE_CPP_IDF)
25# include "host/ble_gap.h"
26# else
27# include "nimble/nimble/host/include/host/ble_gap.h"
28# endif
29
30/**** FIX COMPILATION ****/
31# undef min
32# undef max
33/**************************/
34
35# include <vector>
36# include <array>
37
38# define NIMBLE_ATT_REMOVE_HIDE 1
39# define NIMBLE_ATT_REMOVE_DELETE 2
40
41class NimBLEService;
42class NimBLEServerCallbacks;
43class NimBLEUUID;
44class NimBLEConnInfo;
45class NimBLEAddress;
46class NimBLEService;
47class NimBLECharacteristic;
48# if MYNEWT_VAL(BLE_ROLE_BROADCASTER)
49# if MYNEWT_VAL(BLE_EXT_ADV)
50class NimBLEExtAdvertising;
51# else
53# endif
54# endif
55# if MYNEWT_VAL(BLE_ROLE_CENTRAL)
56class NimBLEClient;
57# endif
58
62class NimBLEServer {
63 public:
64 void start();
65 uint8_t getConnectedCount() const;
66 bool disconnect(uint16_t connHandle, uint8_t reason = BLE_ERR_REM_USER_CONN_TERM) const;
67 bool disconnect(const NimBLEConnInfo& connInfo, uint8_t reason = BLE_ERR_REM_USER_CONN_TERM) const;
68 void setCallbacks(NimBLEServerCallbacks* pCallbacks, bool deleteCallbacks = true);
69 void updateConnParams(uint16_t connHandle, uint16_t minInterval, uint16_t maxInterval, uint16_t latency, uint16_t timeout) const;
70 NimBLEService* createService(const char* uuid);
71 NimBLEService* createService(const NimBLEUUID& uuid);
72 NimBLEService* getServiceByUUID(const char* uuid, uint16_t instanceId = 0) const;
73 NimBLEService* getServiceByUUID(const NimBLEUUID& uuid, uint16_t instanceId = 0) const;
74 NimBLEService* getServiceByHandle(uint16_t handle) const;
75 void removeService(NimBLEService* service, bool deleteSvc = false);
76 void addService(NimBLEService* service);
77 uint16_t getPeerMTU(uint16_t connHandle) const;
78 std::vector<uint16_t> getPeerDevices() const;
79 NimBLEConnInfo getPeerInfo(uint8_t index) const;
80 NimBLEConnInfo getPeerInfo(const NimBLEAddress& address) const;
81 NimBLEConnInfo getPeerInfoByHandle(uint16_t connHandle) const;
82 void advertiseOnDisconnect(bool enable);
83 void setDataLen(uint16_t connHandle, uint16_t tx_octets) const;
84 bool updatePhy(uint16_t connHandle, uint8_t txPhysMask, uint8_t rxPhysMask, uint16_t phyOptions);
85 bool getPhy(uint16_t connHandle, uint8_t* txPhy, uint8_t* rxPhy);
86
87# if MYNEWT_VAL(BLE_ROLE_CENTRAL)
88 NimBLEClient* getClient(uint16_t connHandle);
89 NimBLEClient* getClient(const NimBLEConnInfo& connInfo);
90 void deleteClient();
91# endif
92
93# if MYNEWT_VAL(BLE_ROLE_BROADCASTER)
94# if MYNEWT_VAL(BLE_EXT_ADV)
95 NimBLEExtAdvertising* getAdvertising() const;
96 bool startAdvertising(uint8_t instanceId, int duration = 0, int maxEvents = 0) const;
97 bool stopAdvertising(uint8_t instanceId) const;
98# endif
99
100# if !MYNEWT_VAL(BLE_EXT_ADV) || defined(_DOXYGEN_)
101 NimBLEAdvertising* getAdvertising() const;
102 bool startAdvertising(uint32_t duration = 0) const;
103 bool stopAdvertising() const;
104# endif
105# endif
106
107 private:
108 friend class NimBLEDevice;
109 friend class NimBLEService;
110 friend class NimBLECharacteristic;
111# if MYNEWT_VAL(BLE_ROLE_BROADCASTER)
112# if MYNEWT_VAL(BLE_EXT_ADV)
113 friend class NimBLEExtAdvertising;
114# else
115 friend class NimBLEAdvertising;
116# endif
117# endif
118
119 NimBLEServer();
120 ~NimBLEServer();
121
122 bool m_gattsStarted : 1;
123 bool m_svcChanged : 1;
124 bool m_deleteCallbacks : 1;
125# if !MYNEWT_VAL(BLE_EXT_ADV)
126 bool m_advertiseOnDisconnect : 1;
127# endif
128 NimBLEServerCallbacks* m_pServerCallbacks;
129 std::vector<NimBLEService*> m_svcVec;
130 std::array<uint16_t, MYNEWT_VAL(BLE_MAX_CONNECTIONS)> m_connectedPeers;
131
132# if MYNEWT_VAL(BLE_ROLE_CENTRAL)
133 NimBLEClient* m_pClient{nullptr};
134# endif
135
136 static int handleGapEvent(struct ble_gap_event* event, void* arg);
137 static int handleGattEvent(uint16_t connHandle, uint16_t attrHandle, ble_gatt_access_ctxt* ctxt, void* arg);
138 void serviceChanged();
139 void resetGATT();
140
141}; // NimBLEServer
142
146class NimBLEServerCallbacks {
147 public:
148 virtual ~NimBLEServerCallbacks() {};
149
157 virtual void onConnect(NimBLEServer* pServer, NimBLEConnInfo& connInfo);
158
167 virtual void onDisconnect(NimBLEServer* pServer, NimBLEConnInfo& connInfo, int reason);
168
175 virtual void onMTUChange(uint16_t MTU, NimBLEConnInfo& connInfo);
176
181 virtual uint32_t onPassKeyDisplay();
182
189 virtual void onConfirmPassKey(NimBLEConnInfo& connInfo, uint32_t pin);
190
196 virtual void onAuthenticationComplete(NimBLEConnInfo& connInfo);
197
202 virtual void onIdentity(NimBLEConnInfo& connInfo);
203
210 virtual void onConnParamsUpdate(NimBLEConnInfo& connInfo);
211
223 virtual void onPhyUpdate(NimBLEConnInfo& connInfo, uint8_t txPhy, uint8_t rxPhy);
224}; // NimBLEServerCallbacks
225
226#endif // CONFIG_BT_NIMBLE_ENABLED && MYNEWT_VAL(BLE_ROLE_PERIPHERAL)
227#endif // NIMBLE_CPP_SERVER_H_
A BLE device address.
Definition NimBLEAddress.h:42
Perform and manage BLE advertising.
Definition NimBLEAdvertising.h:51
Connection information.
Definition NimBLEConnInfo.h:32
A model of a BLE Device from which all the BLE roles are created.
Definition NimBLEDevice.h:116
A model of a BLE UUID.
Definition NimBLEUUID.h:41