esp_ble_gattc_open() function

Create an ACL connection when `BT_BLE_42_FEATURES_SUPPORTED` is enabled in the menuconfig

Syntax

Show:

Summary

Declaration

Definition

from esp_gattc_api.h:358

esp_err_t esp_ble_gattc_open(esp_gatt_if_t gattc_if, esp_bd_addr_t remote_bda, esp_ble_addr_type_t remote_addr_type, bool is_direct);

Implemented in esp_gattc_api.c:174

Arguments

Argument

Description

gattc_if

GATT Client access interface

remote_bda

Remote device address

remote_addr_type

Remote device address type

is_direct

`True` indicates a direct connection, while `False` indicates a background auto connection. By now, background auto connection is not supported, please always pass True to this parameter.

Return value

- ESP_OK: Success - ESP_FAIL: Failure

Notes

1. The function always triggers `ESP_GATTC_CONNECT_EVT` and `ESP_GATTC_OPEN_EVT`. 2. When the device acts as GATT server, besides the above two events, this function triggers `ESP_GATTS_CONNECT_EVT` as well. 3. This function will establish an ACL connection as a Central and a virtual connection as a GATT Client. If the ACL connection already exists, it will create a virtual connection only.

Examples

References

from examples

esp_ble_gattc_open() function

Syntax

Arguments

Return value

Notes

Examples

References

Call Tree

Data Use

Class Tree

Override Tree

Implementations

Instances

Lifecycle