/* * NimBLERemoteService.cpp * * Created: on Jan 27 2020 * Author H2zero * * Originally: * * BLERemoteService.cpp * * Created on: Jul 8, 2017 * Author: kolban */ #include "nimconfig.h" #if defined(CONFIG_BT_ENABLED) && defined(CONFIG_BT_NIMBLE_ROLE_CENTRAL) # include "NimBLERemoteService.h" # include "NimBLERemoteCharacteristic.h" # include "NimBLEClient.h" # include "NimBLEAttValue.h" # include "NimBLEUtils.h" # include "NimBLELog.h" # include static const char* LOG_TAG = "NimBLERemoteService"; /** * @brief Remote Service constructor. * @param [in] pClient A pointer to the client this belongs to. * @param [in] service A pointer to the structure with the service information. */ NimBLERemoteService::NimBLERemoteService(NimBLEClient* pClient, const ble_gatt_svc* service) : NimBLEAttribute{service->uuid, service->start_handle}, m_pClient{pClient}, m_endHandle{service->end_handle} {} /** * @brief When deleting the service make sure we delete all characteristics and descriptors. */ NimBLERemoteService::~NimBLERemoteService() { deleteCharacteristics(); } /** * @brief Get iterator to the beginning of the vector of remote characteristic pointers. * @return An iterator to the beginning of the vector of remote characteristic pointers. */ std::vector::iterator NimBLERemoteService::begin() const { return m_vChars.begin(); } /** * @brief Get iterator to the end of the vector of remote characteristic pointers. * @return An iterator to the end of the vector of remote characteristic pointers. */ std::vector::iterator NimBLERemoteService::end() const { return m_vChars.end(); } /** * @brief Get the remote characteristic object for the characteristic UUID. * @param [in] uuid Remote characteristic uuid. * @return A pointer to the remote characteristic object. */ NimBLERemoteCharacteristic* NimBLERemoteService::getCharacteristic(const char* uuid) const { return getCharacteristic(NimBLEUUID(uuid)); } // getCharacteristic /** * @brief Get the characteristic object for the UUID. * @param [in] uuid Characteristic uuid. * @return A pointer to the characteristic object, or nullptr if not found. */ NimBLERemoteCharacteristic* NimBLERemoteService::getCharacteristic(const NimBLEUUID& uuid) const { NIMBLE_LOGD(LOG_TAG, ">> getCharacteristic: uuid: %s", uuid.toString().c_str()); NimBLERemoteCharacteristic* pChar = nullptr; size_t prev_size = m_vChars.size(); for (const auto& it : m_vChars) { if (it->getUUID() == uuid) { pChar = it; goto Done; } } if (retrieveCharacteristics(&uuid)) { if (m_vChars.size() > prev_size) { pChar = m_vChars.back(); goto Done; } // If the request was successful but 16/32 bit uuid not found // try again with the 128 bit uuid. if (uuid.bitSize() == BLE_UUID_TYPE_16 || uuid.bitSize() == BLE_UUID_TYPE_32) { NimBLEUUID uuid128(uuid); uuid128.to128(); if (retrieveCharacteristics(&uuid128)) { if (m_vChars.size() > prev_size) { pChar = m_vChars.back(); } } } else { // If the request was successful but the 128 bit uuid not found // try again with the 16 bit uuid. NimBLEUUID uuid16(uuid); uuid16.to16(); // if the uuid was 128 bit but not of the BLE base type this check will fail if (uuid16.bitSize() == BLE_UUID_TYPE_16) { if (retrieveCharacteristics(&uuid16)) { if (m_vChars.size() > prev_size) { pChar = m_vChars.back(); } } } } } Done: NIMBLE_LOGD(LOG_TAG, "<< Characteristic %sfound", pChar ? "" : "not "); return pChar; } // getCharacteristic /** * @brief Get a pointer to the vector of found characteristics. * @param [in] refresh If true the current characteristics vector will cleared and * all characteristics for this service retrieved from the peripheral. * If false the vector will be returned with the currently stored characteristics of this service. * @return A read-only reference to the vector of characteristics retrieved for this service. */ const std::vector& NimBLERemoteService::getCharacteristics(bool refresh) const { if (refresh) { deleteCharacteristics(); retrieveCharacteristics(); } return m_vChars; } // getCharacteristics /** * @brief Callback for Characteristic discovery. * @return success == 0 or error code. */ int NimBLERemoteService::characteristicDiscCB(uint16_t conn_handle, const ble_gatt_error* error, const ble_gatt_chr* chr, void* arg) { NIMBLE_LOGD(LOG_TAG, "Characteristic Discovery >>"); auto pTaskData = (ble_task_data_t*)arg; const auto pSvc = (NimBLERemoteService*)pTaskData->pATT; // Make sure the discovery is for this device if (pSvc->getClient()->getConnId() != conn_handle) { return 0; } if (error->status == 0) { pSvc->m_vChars.push_back(new NimBLERemoteCharacteristic(pSvc, chr)); } else { pTaskData->rc = error->status == BLE_HS_EDONE ? 0 : error->status; NIMBLE_LOGD(LOG_TAG, "<< Characteristic Discovery"); xTaskNotifyGive(pTaskData->task); } return error->status; } /** * @brief Retrieve all the characteristics for this service. * This function will not return until we have all the characteristics. * @return True if successful. */ bool NimBLERemoteService::retrieveCharacteristics(const NimBLEUUID* uuidFilter) const { NIMBLE_LOGD(LOG_TAG, ">> retrieveCharacteristics()"); int rc = 0; TaskHandle_t cur_task = xTaskGetCurrentTaskHandle(); ble_task_data_t taskData = {const_cast(this), cur_task, 0, nullptr}; if (uuidFilter == nullptr) { rc = ble_gattc_disc_all_chrs(m_pClient->getConnId(), getHandle(), getEndHandle(), NimBLERemoteService::characteristicDiscCB, &taskData); } else { rc = ble_gattc_disc_chrs_by_uuid(m_pClient->getConnId(), getHandle(), getEndHandle(), uuidFilter->getBase(), NimBLERemoteService::characteristicDiscCB, &taskData); } if (rc == 0) { # ifdef ulTaskNotifyValueClear // Clear the task notification value to ensure we block ulTaskNotifyValueClear(cur_task, ULONG_MAX); # endif ulTaskNotifyTake(pdTRUE, portMAX_DELAY); } if (taskData.rc != 0) { NIMBLE_LOGE(LOG_TAG, "<< retrieveCharacteristics() rc=%d %s", rc, NimBLEUtils::returnCodeToString(rc)); } else { NIMBLE_LOGD(LOG_TAG, "<< retrieveCharacteristics()"); } return taskData.rc == 0; } // retrieveCharacteristics /** * @brief Get the client associated with this service. * @return A reference to the client associated with this service. */ NimBLEClient* NimBLERemoteService::getClient() const { return m_pClient; } // getClient /** * @brief Read the value of a characteristic associated with this service. * @param [in] uuid The characteristic to read. * @returns a string containing the value or an empty string if not found or error. */ NimBLEAttValue NimBLERemoteService::getValue(const NimBLEUUID& uuid) const { const auto pChar = getCharacteristic(uuid); if (pChar) { return pChar->readValue(); } return NimBLEAttValue{}; } // readValue /** * @brief Set the value of a characteristic. * @param [in] uuid The characteristic UUID to set. * @param [in] value The value to set. * @returns true on success, false if not found or error */ bool NimBLERemoteService::setValue(const NimBLEUUID& uuid, const NimBLEAttValue& value) const { const auto pChar = getCharacteristic(uuid); if (pChar) { return pChar->writeValue(value); } return false; } // setValue /** * @brief Delete the characteristics in the characteristics vector. * @details We maintain a vector called m_characteristicsVector that contains pointers to BLERemoteCharacteristic * object references. Since we allocated these in this class, we are also responsible for deleting * them. This method does just that. */ void NimBLERemoteService::deleteCharacteristics() const { for (const auto& it : m_vChars) { delete it; } std::vector{}.swap(m_vChars); } // deleteCharacteristics /** * @brief Delete characteristic by UUID * @param [in] uuid The UUID of the characteristic to be removed from the local database. * @return Number of characteristics left. */ size_t NimBLERemoteService::deleteCharacteristic(const NimBLEUUID& uuid) const { for (auto it = m_vChars.begin(); it != m_vChars.end(); ++it) { if ((*it)->getUUID() == uuid) { delete (*it); m_vChars.erase(it); break; } } return m_vChars.size(); } // deleteCharacteristic /** * @brief Create a string representation of this remote service. * @return A string representation of this remote service. */ std::string NimBLERemoteService::toString() const { std::string res = "Service: uuid: " + m_uuid.toString() + ", start_handle: 0x"; char val[5]; snprintf(val, sizeof(val), "%04x", getHandle()); res += val; res += ", end_handle: 0x"; snprintf(val, sizeof(val), "%04x", getEndHandle()); res += val; for (const auto& chr : m_vChars) { res += "\n" + chr->toString(); } return res; } // toString #endif /* CONFIG_BT_ENABLED && CONFIG_BT_NIMBLE_ROLE_CENTRAL */