Symbols

Files

loading (3/5)...

Summary Syntax Arguments Examples References Call Tree Data Use

SourceVuESP-IDF Framework and ExamplesESP-IDFesp_ble_gatts_app_register()

esp_ble_gatts_app_register() function

Syntax

Show:

Summary

Declaration

Definition

from esp_gatts_api.h:316

esp_err_t esp_ble_gatts_app_register(uint16_t app_id);

Implemented in esp_gatts_api.c:37

Arguments

Argument

Description

app_id

The UUID for different application

Return value

- ESP_OK: Success - ESP_ERR_INVALID_ARG: The input `app_id` exceeds `ESP_APP_ID_MAX` (0x7fff) defined in esp_bt_defs.h. - ESP_FAIL: Failure due to other reasons

Notes

1. This function triggers `ESP_GATTS_REG_EVT`. 2. The maximum number of applications is limited to 6.

Examples

esp_ble_gatts_app_register() is referenced by 12 libraries and example projects:

Bluedroid_Connection sample

Bluedroid_GATT_Server sample

ble_compatibility_test sample

ble_hid_device_demo sample

ble_spp_server sample

gatt_security_server sample

gatt_server sample

gatt_server_service_table sample

ble50_security_server sample

a2dp_gatts_coex sample

gattc_gatts_coex sample

throughput_server sample

References

from 0/12 examples

Code

Location

Referrer

esp_err_t esp_ble_gatts_app_register(uint16_t app_id)

esp_gatts_api.c:37

esp_err_t esp_ble_gatts_app_register(uint16_t app_id);

esp_gatts_api.h:316

if ((ret = esp_ble_gatts_app_register(ESP_GATT_UUID_BATTERY_SERVICE_SVC)) != ESP_OK) {

ble_hidd.c:614

ble_hid_start_gatts()

if ((ret = esp_ble_gatts_app_register(ESP_GATT_UUID_DEVICE_INFO_SVC)) != ESP_OK) {

ble_hidd.c:618

ble_hid_start_gatts()

if ((ret = esp_ble_gatts_app_register(ESP_GATT_UUID_HID_SVC + i)) != ESP_OK) {

ble_hidd.c:623

ble_hid_start_gatts()

ret = esp_ble_gatts_app_register(app_id);

simple_ble.c:284

simple_ble_start()

Call Tree

from 0/12 examples

esp_ble_gatts_app_register() is called by 2 functions and calls 2 functions:

ble_hid_start_gatts()

simple_ble_start()

esp_ble_gatts_app_register()

esp_bluedroid_get_status()

btc_transfer_context()

Data Use

from 0/12 examples

esp_ble_gatts_app_register() reads 6 variables and writes 4 variables:

esp_bluedroid_status_t::ESP_BLUEDROID_STATUS_ENABLED

bt_status_t::BT_STATUS_SUCCESS

btc_sig_t::BTC_SIG_API_CALL

btc_pid_t::BTC_PID_GATTS

btc_gatts_act_t::BTC_GATTS_ACT_APP_REGISTER

btc_ble_gatts_args_t::app_reg

esp_ble_gatts_app_register()

Class Tree

from 0/12 examples

All items filtered out

Override Tree

from 0/12 examples

All items filtered out

Implementations

from 0/12 examples

All items filtered out

Instances

from 0/12 examples

Lifecycle

from 0/12 examples

All items filtered out