mirror of
https://github.com/h2zero/esp-nimble-cpp.git
synced 2024-10-22 16:09:44 +02:00
10e50a8791
Add iterators for NimBLEScan: NimBLEadvertisedDevice, NimBLEClient: NimBLERemoteService, NimBLERemoteService: NimBLERemoteCharacteristic and NimBLERemoteCharacteristic: NimBLERemoteDescriptor
This is handy e.g. for showing every address of the advertised devices from a scan. To do so, first get a new scan and next:
```
for(auto pAdvertisedDevice: pBLEScan->getResults()) {
Serial.printf("Address is %s\n", std::string(pAdvertisedDevice->getAddress()).c_str());
}
```
Of course any other property of the advertised device can be shown (or looked up, if that is your use case)
Also this is handy e.g. for showing every UUID in a peripheral. To do so, first connect to a peripheral and next:
```
for(auto pService: *pClient) {
Serial.printf("Service UUID is %s\n", std::string(pService->getUUID()).c_str());
for(auto pCharacteristic: *pService) {
Serial.printf("Characteristic UUID is %s\n", std::string(pCharacteristic->getUUID()).c_str());
for(auto pDescriptor: *pCharacteristic) {
Serial.printf("Descriptor UUID is %s\n", std::string(pDescriptor->getUUID()).c_str());
}
}
}
```
Again of course any other property can be shown, or looked up.
94 lines
3.2 KiB
C++
94 lines
3.2 KiB
C++
/*
|
|
* NimBLEScan.h
|
|
*
|
|
* Created: on Jan 24 2020
|
|
* Author H2zero
|
|
*
|
|
* Originally:
|
|
*
|
|
* BLEScan.h
|
|
*
|
|
* Created on: Jul 1, 2017
|
|
* Author: kolban
|
|
*/
|
|
#ifndef COMPONENTS_NIMBLE_SCAN_H_
|
|
#define COMPONENTS_NIMBLE_SCAN_H_
|
|
#include "sdkconfig.h"
|
|
#if defined(CONFIG_BT_ENABLED)
|
|
|
|
#include "nimconfig.h"
|
|
#if defined(CONFIG_BT_NIMBLE_ROLE_OBSERVER)
|
|
|
|
#include "NimBLEAdvertisedDevice.h"
|
|
#include "FreeRTOS.h"
|
|
|
|
#include "host/ble_gap.h"
|
|
|
|
#include <vector>
|
|
|
|
class NimBLEDevice;
|
|
class NimBLEScan;
|
|
class NimBLEAdvertisedDevice;
|
|
class NimBLEAdvertisedDeviceCallbacks;
|
|
class NimBLEAddress;
|
|
|
|
/**
|
|
* @brief The result of having performed a scan.
|
|
* When a scan completes, we have a set of found devices. Each device is described
|
|
* by a BLEAdvertisedDevice object. The number of items in the set is given by
|
|
* getCount(). We can retrieve a device by calling getDevice() passing in the
|
|
* index (starting at 0) of the desired device.
|
|
*/
|
|
class NimBLEScanResults {
|
|
public:
|
|
void dump();
|
|
int getCount();
|
|
NimBLEAdvertisedDevice getDevice(uint32_t i);
|
|
std::vector<NimBLEAdvertisedDevice*>::iterator begin();
|
|
std::vector<NimBLEAdvertisedDevice*>::iterator end();
|
|
NimBLEAdvertisedDevice *getDevice(const NimBLEAddress &address);
|
|
|
|
private:
|
|
friend NimBLEScan;
|
|
std::vector<NimBLEAdvertisedDevice*> m_advertisedDevicesVector;
|
|
};
|
|
|
|
/**
|
|
* @brief Perform and manage %BLE scans.
|
|
*
|
|
* Scanning is associated with a %BLE client that is attempting to locate BLE servers.
|
|
*/
|
|
class NimBLEScan {
|
|
public:
|
|
bool start(uint32_t duration, void (*scanCompleteCB)(NimBLEScanResults), bool is_continue = false);
|
|
NimBLEScanResults start(uint32_t duration, bool is_continue = false);
|
|
void setAdvertisedDeviceCallbacks(NimBLEAdvertisedDeviceCallbacks* pAdvertisedDeviceCallbacks/*, bool wantDuplicates = false*/);
|
|
void setActiveScan(bool active);
|
|
void setInterval(uint16_t intervalMSecs);
|
|
void setWindow(uint16_t windowMSecs);
|
|
void stop();
|
|
void clearResults();
|
|
NimBLEScanResults getResults();
|
|
void erase(const NimBLEAddress &address);
|
|
|
|
|
|
private:
|
|
NimBLEScan();
|
|
friend class NimBLEDevice;
|
|
static int handleGapEvent(ble_gap_event* event, void* arg);
|
|
void onHostReset();
|
|
|
|
NimBLEAdvertisedDeviceCallbacks* m_pAdvertisedDeviceCallbacks = nullptr;
|
|
void (*m_scanCompleteCB)(NimBLEScanResults scanResults);
|
|
ble_gap_disc_params m_scan_params;
|
|
uint8_t m_own_addr_type;
|
|
bool m_stopped;
|
|
bool m_wantDuplicates;
|
|
NimBLEScanResults m_scanResults;
|
|
FreeRTOS::Semaphore m_semaphoreScanEnd = FreeRTOS::Semaphore("ScanEnd");
|
|
uint32_t m_duration;
|
|
};
|
|
|
|
#endif // #if defined(CONFIG_BT_NIMBLE_ROLE_OBSERVER)
|
|
#endif /* CONFIG_BT_ENABLED */
|
|
#endif /* COMPONENTS_NIMBLE_SCAN_H_ */
|