esp_ble_gattc_search_service() function

Search services from the local GATTC cache

Syntax

Show:

Summary

Declaration

Definition

from esp_gattc_api.h:434

esp_err_t esp_ble_gattc_search_service(esp_gatt_if_t gattc_if, uint16_t conn_id, esp_bt_uuid_t *filter_uuid);

Implemented in esp_gattc_api.c:231

Arguments

Argument

Description

gattc_if

GATT Client access interface

conn_id

Connection ID

filter_uuid

A UUID of the intended service. If NULL is passed, this API will return all services.

Return value

- ESP_OK: Success - ESP_FAIL: Failure

Notes

1. This function triggers `ESP_GATTC_SEARCH_RES_EVT` each time a service is retrieved. 2. This function triggers `ESP_GATTC_SEARCH_CMPL_EVT` when the search is completed. 3. The 128-bit base UUID will be converted to a 16-bit UUID automatically in the search results. Other types of UUID remain unchanged.

Examples

esp_ble_gattc_search_service() is referenced by 8 libraries and example projects:

References

from examples

esp_ble_gattc_search_service() function

Syntax

Arguments

Return value

Notes

Examples

References

Call Tree

Data Use

Class Tree

Override Tree

Implementations

Instances

Lifecycle