ScStw/esp-nimble-cpp
2
0
Fork 0
mirror of https://github.com/h2zero/esp-nimble-cpp.git synced 2025-02-23 06:28:54 +01:00
Code Issues Projects Releases Packages Wiki Activity

feat(AdvDevice): Add convenience operator to NimBLEAddress

Browse source
This commit is contained in:
thekurtovic 2025-01-26 11:21:36 -05:00 • committed by Ryan Powell
parent 784e6f30fa
commit 052c0a0455
4 changed files with 11 additions and 20 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

10
src/NimBLEAdvertisedDevice.cpp
View file

@ -780,6 +780,16 @@ bool NimBLEAdvertisedDevice::isLegacyAdvertisement() const {
# endif # endif
} // isLegacyAdvertisement } // isLegacyAdvertisement
/**
* @brief Convenience operator to convert this NimBLEAdvertisedDevice to NimBLEAddress representation.
* @details This allows passing NimBLEAdvertisedDevice to functions
* that accept NimBLEAddress and/or or it's methods as a parameter.
*/
NimBLEAdvertisedDevice::operator NimBLEAddress() const {
NimBLEAddress address(getAddress());
return address;
} // operator NimBLEAddress
/** /**
* @brief Get the payload advertised by the device. * @brief Get the payload advertised by the device.
* @return The advertisement payload. * @return The advertisement payload.

1
src/NimBLEAdvertisedDevice.h
View file

@ -93,6 +93,7 @@ class NimBLEAdvertisedDevice {
uint8_t getSecondaryPhy() const; uint8_t getSecondaryPhy() const;
uint16_t getPeriodicInterval() const; uint16_t getPeriodicInterval() const;
# endif # endif
operator NimBLEAddress() const;
const std::vector<uint8_t>& getPayload() const; const std::vector<uint8_t>& getPayload() const;
const std::vector<uint8_t>::const_iterator begin() const; const std::vector<uint8_t>::const_iterator begin() const;

16
src/NimBLEClient.cpp
View file

@ -141,22 +141,6 @@ bool NimBLEClient::connect(bool deleteAttributes, bool asyncConnect, bool exchan
return connect(m_peerAddress, deleteAttributes, asyncConnect, exchangeMTU); return connect(m_peerAddress, deleteAttributes, asyncConnect, exchangeMTU);
} // connect } // connect
/**
* @brief Connect to an advertising device.
* @param [in] device The device to connect to.
* @param [in] deleteAttributes If true this will delete any attribute objects this client may already\n
* have created when last connected.
* @param [in] asyncConnect If true, the connection will be made asynchronously and this function will return immediately.\n
* If false, this function will block until the connection is established or the connection attempt times out.
* @param [in] exchangeMTU If true, the client will attempt to exchange MTU with the server after connection.\n
* If false, the client will use the default MTU size and the application will need to call exchangeMTU() later.
* @return true on success.
*/
bool NimBLEClient::connect(const NimBLEAdvertisedDevice* device, bool deleteAttributes, bool asyncConnect, bool exchangeMTU) {
NimBLEAddress address(device->getAddress());
return connect(address, deleteAttributes, asyncConnect, exchangeMTU);
} // connect
/** /**
* @brief Connect to a BLE Server by address. * @brief Connect to a BLE Server by address.
* @param [in] address The address of the server. * @param [in] address The address of the server.

4
src/NimBLEClient.h
View file

@ -48,10 +48,6 @@ struct NimBLETaskData;
*/ */
class NimBLEClient { class NimBLEClient {
public: public:
bool connect(const NimBLEAdvertisedDevice* device,
bool deleteAttributes = true,
bool asyncConnect = false,
bool exchangeMTU = true);
bool connect(const NimBLEAddress& address, bool deleteAttributes = true, bool asyncConnect = false, bool exchangeMTU = true); bool connect(const NimBLEAddress& address, bool deleteAttributes = true, bool asyncConnect = false, bool exchangeMTU = true);
bool connect(bool deleteAttributes = true, bool asyncConnect = false, bool exchangeMTU = true); bool connect(bool deleteAttributes = true, bool asyncConnect = false, bool exchangeMTU = true);
bool disconnect(uint8_t reason = BLE_ERR_REM_USER_CONN_TERM); bool disconnect(uint8_t reason = BLE_ERR_REM_USER_CONN_TERM);