src/BLEClient.h


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

/*
 * BLEDevice.h
 *
 *  Created on: Mar 22, 2017
 *      Author: kolban
 */
 
#ifndef MAIN_BLEDEVICE_H_
#define MAIN_BLEDEVICE_H_
 
#include "sdkconfig.h"
#if defined(CONFIG_BT_ENABLED)
 
#include <esp_gattc_api.h>
#include <string.h>
#include <map>
#include <string>
#include "BLEExceptions.h"
#include "BLERemoteService.h"
#include "BLEService.h"
#include "BLEAddress.h"
 
class BLERemoteService;
class BLEClientCallbacks;
 
/**
 * @brief A model of a %BLE client.
 */
class BLEClient {
public:
	BLEClient();
	~BLEClient();
 
	bool                                       connect(BLEAddress address);   // Connect to the remote BLE Server 
	void                                       disconnect();                  // Disconnect from the remote BLE Server 
	BLEAddress                                 getPeerAddress();              // Get the address of the remote BLE Server 
	int                                        getRssi();                     // Get the RSSI of the remote BLE Server 
	std::map<std::string, BLERemoteService*>*  getServices();                 // Get a map of the services offered by the remote BLE Server 
	BLERemoteService*                          getService(const char* uuid);  // Get a reference to a specified service offered by the remote BLE server. 
	BLERemoteService*                          getService(BLEUUID uuid);      // Get a reference to a specified service offered by the remote BLE server. 
	std::string                                getValue(BLEUUID serviceUUID, BLEUUID characteristicUUID);   // Get the value of a given characteristic at a given service. 
 
 
	void                                       handleGAPEvent(
		                                            esp_gap_ble_cb_event_t  event,
                                                esp_ble_gap_cb_param_t* param);
 
	bool                                       isConnected();                 // Return true if we are connected. 
 
	void                                       setClientCallbacks(BLEClientCallbacks *pClientCallbacks);
	void                                       setValue(BLEUUID serviceUUID, BLEUUID characteristicUUID, std::string value);   // Set the value of a given characteristic at a given service. 
 
	std::string                                toString();                    // Return a string representation of this client. 
 
 
private:
	friend class BLEDevice;
	friend class BLERemoteService;
	friend class BLERemoteCharacteristic;
	friend class BLERemoteDescriptor;
 
	void                                       gattClientEventHandler(
		esp_gattc_cb_event_t event,
		esp_gatt_if_t gattc_if,
		esp_ble_gattc_cb_param_t* param);
 
	uint16_t                                   getConnId();
	esp_gatt_if_t                              getGattcIf();
	BLEAddress    m_peerAddress = BLEAddress((uint8_t*)"\0\0\0\0\0\0");   // The BD address of the remote server. 
	uint16_t      m_conn_id;
//	int           m_deviceType; 
	esp_gatt_if_t m_gattc_if;
	bool          m_haveServices;    // Have we previously obtain the set of services from the remote server. 
	bool          m_isConnected;     // Are we currently connected. 
 
	BLEClientCallbacks* m_pClientCallbacks;
	FreeRTOS::Semaphore m_semaphoreRegEvt        = FreeRTOS::Semaphore("RegEvt");
	FreeRTOS::Semaphore m_semaphoreOpenEvt       = FreeRTOS::Semaphore("OpenEvt");
	FreeRTOS::Semaphore m_semaphoreSearchCmplEvt = FreeRTOS::Semaphore("SearchCmplEvt");
	FreeRTOS::Semaphore m_semaphoreRssiCmplEvt   = FreeRTOS::Semaphore("RssiCmplEvt");
	std::map<std::string, BLERemoteService*> m_servicesMap;
	void clearServices();   // Clear any existing services. 
 
}; // class BLEDevice 
 
 
/**
 * @brief Callbacks associated with a %BLE client.
 */
class BLEClientCallbacks {
public:
	virtual ~BLEClientCallbacks() {};
	virtual void onConnect(BLEClient *pClient) = 0;
	virtual void onDisconnect(BLEClient *pClient) = 0;
};
 
#endif // CONFIG_BT_ENABLED 
#endif /* MAIN_BLEDEVICE_H_ */