BLEServiceMap Class Reference

A data structure that manages the BLE servers owned by a BLE server. More...

#include <BLEServer.hpp>

Public Member Functions
BLEService *	getByHandle (uint16_t handle)
	Return the service by handle. More...
BLEService *	getByUUID (const char *uuid)
	Return the service by UUID. More...
BLEService *	getByUUID (BLEUUID uuid, uint8_t inst_id=0)
	Return the service by UUID. More...
void	handleGATTServerEvent (void *)
void	setByHandle (uint16_t handle, BLEService *service)
	Set the service by handle. More...
void	setByUUID (const char *uuid, BLEService *service)
void	setByUUID (BLEUUID uuid, BLEService *service)
	Set the service by UUID. More...
std::string	toString ()
	Return a string representation of the service map. More...
BLEService *	getFirst ()
	Get the first service in the map. More...
BLEService *	getNext ()
	Get the next service in the map. More...
void	removeService (BLEService *service)
	Removes service from maps. More...
int	getRegisteredServiceCount ()
	Returns the amount of registered services. More...

Detailed Description

A data structure that manages the BLE servers owned by a BLE server.

Member Function Documentation

getByHandle()

BLEService * BLEServiceMap::getByHandle

(

uint16_t

handle

)

Return the service by handle.

Parameters

[in]

handle

The handle to look up the service.

Returns

The service.

                                                      {
    return m_handleMap.at(handle);
} // getByHandle

getByUUID() [1/2]

BLEService * BLEServiceMap::getByUUID	(	BLEUUID	uuid,
		uint8_t	inst_id = 0
	)

Return the service by UUID.

Parameters

[in]

UUID

The UUID to look up the service.

Returns

The characteristic.

                                                                  {
    for (auto &myPair : m_uuidMap) {
        if (myPair.first->getUUID().equals(uuid)) {
            return myPair.first;
        }
    }
    //return m_uuidMap.at(uuid.toString());
    return nullptr;
} // getByUUID

getByUUID() [2/2]

BLEService * BLEServiceMap::getByUUID

(

const char *

uuid

)

Return the service by UUID.

Parameters

[in]

UUID

The UUID to look up the service.

Returns

The characteristic.

                                                     {
    return getByUUID(BLEUUID(uuid));
}

getFirst()

BLEService * BLEServiceMap::getFirst

(

)

Get the first service in the map.

Returns

The first service in the map.

                                    {
    m_iterator = m_uuidMap.begin();
    if (m_iterator == m_uuidMap.end()) return nullptr;
    BLEService* pRet = m_iterator->first;
    m_iterator++;
    return pRet;
} // getFirst

getNext()

BLEService * BLEServiceMap::getNext

(

)

Get the next service in the map.

Returns

The next service in the map.

                                   {
    if (m_iterator == m_uuidMap.end()) return nullptr;
    BLEService* pRet = m_iterator->first;
    m_iterator++;
    return pRet;
} // getNext

getRegisteredServiceCount()

int BLEServiceMap::getRegisteredServiceCount

(

)

Returns the amount of registered services.

Returns

amount of registered services

                                            {
    return m_handleMap.size();
}

removeService()

void BLEServiceMap::removeService

(

BLEService *

service

)

Removes service from maps.

Returns

N/A.

                                                     {
    m_handleMap.erase(service->getHandle());
    m_uuidMap.erase(service);
} // removeService

setByHandle()

void BLEServiceMap::setByHandle	(	uint16_t	handle,
		BLEService *	service
	)

Set the service by handle.

Parameters

[in]	handle	The handle of the service.
[in]	service	The service to cache.

Returns

N/A.

                                                                    {
    m_handleMap.insert(std::pair<uint16_t, BLEService*>(handle, service));
} // setByHandle

setByUUID()

void BLEServiceMap::setByUUID	(	BLEUUID	uuid,
		BLEService *	service
	)

Set the service by UUID.

Parameters

[in]	uuid	The uuid of the service.
[in]	characteristic	The service to cache.

Returns

N/A.

                                                               {
    m_uuidMap.insert(std::pair<BLEService*, std::string>(service, uuid.toString()));
} // setByUUID

toString()

std::string BLEServiceMap::toString

(

)

Return a string representation of the service map.

Returns

A string representation of the service map.

                                  {
    std::stringstream stringStream;
    stringStream << std::hex << std::setfill('0');
    for (auto &myPair: m_handleMap) {
        stringStream << "handle: 0x" << std::setw(2) << myPair.first << ", uuid: " + myPair.second->getUUID().toString() << "\n";
    }
    return stringStream.str();
} // toString

---

The documentation for this class was generated from the following files:

• nola-sdk/include/BLEServer.hpp
• src/net/BluetoothLE/BLEServiceMap.cpp