2016-12-01 07:20:22 -05:00
GAP API
2017-01-17 14:03:26 -05:00
=======
2016-12-01 07:20:22 -05:00
Overview
--------
`Instructions`_
2017-01-17 14:03:26 -05:00
.. _Instructions: ../template.html
2016-12-01 07:20:22 -05:00
Application Example
-------------------
2017-01-17 14:03:26 -05:00
Check `/examples/bluetooth <https://github.com/espressif/esp-idf/tree/master/examples/bluetooth> `_ folder of `espressif/esp-idf <https://github.com/espressif/esp-idf> `_ repository, that contains the following examples:
2016-12-01 07:20:22 -05:00
2017-01-17 14:03:26 -05:00
`gatt_server <https://github.com/espressif/esp-idf/blob/master/examples/bluetooth/gatt_server> `_ , `gatt_client <https://github.com/espressif/esp-idf/blob/master/examples/bluetooth/gatt_client> `_
2016-12-01 07:20:22 -05:00
2017-01-17 14:03:26 -05:00
The two demos use different gap api, such like advertising, scan, set device name and others.
2016-12-01 07:20:22 -05:00
API Reference
-------------
Header Files
^^^^^^^^^^^^
2017-01-17 12:53:29 -05:00
* `bt/bluedroid/api/include/esp_gap_ble_api.h <https://github.com/espressif/esp-idf/blob/master/components/bt/bluedroid/api/include/esp_gap_ble_api.h> `_
2016-12-01 07:20:22 -05:00
Macros
^^^^^^
2017-01-05 02:24:09 -05:00
.. doxygendefine :: ESP_BLE_ADV_FLAG_LIMIT_DISC
.. doxygendefine :: ESP_BLE_ADV_FLAG_GEN_DISC
.. doxygendefine :: ESP_BLE_ADV_FLAG_BREDR_NOT_SPT
.. doxygendefine :: ESP_BLE_ADV_FLAG_DMT_CONTROLLER_SPT
.. doxygendefine :: ESP_BLE_ADV_FLAG_DMT_HOST_SPT
.. doxygendefine :: ESP_BLE_ADV_FLAG_NON_LIMIT_DISC
2016-12-01 07:20:22 -05:00
.. doxygendefine :: ESP_BLE_ADV_DATA_LEN_MAX
Type Definitions
^^^^^^^^^^^^^^^^
2017-01-05 01:56:16 -05:00
.. doxygentypedef :: esp_gap_ble_cb_t
2016-12-01 07:20:22 -05:00
Enumerations
^^^^^^^^^^^^
.. doxygenenum :: esp_gap_ble_cb_event_t
.. doxygenenum :: esp_ble_adv_data_type
.. doxygenenum :: esp_ble_adv_type_t
.. doxygenenum :: esp_ble_adv_channel_t
.. doxygenenum :: esp_ble_adv_filter_t
.. doxygenenum :: esp_ble_own_addr_src_t
.. doxygenenum :: esp_ble_scan_type_t
.. doxygenenum :: esp_ble_scan_filter_t
.. doxygenenum :: esp_gap_search_evt_t
.. doxygenenum :: esp_ble_evt_type_t
Structures
^^^^^^^^^^
.. doxygenstruct :: esp_ble_adv_params_t
:members:
.. doxygenstruct :: esp_ble_adv_data_t
:members:
.. doxygenstruct :: esp_ble_scan_params_t
:members:
.. doxygenstruct :: esp_ble_conn_update_params_t
:members:
.. doxygenstruct :: esp_ble_gap_cb_param_t
:members:
.. doxygenstruct :: esp_ble_gap_cb_param_t::ble_adv_data_cmpl_evt_param
:members:
.. doxygenstruct :: esp_ble_gap_cb_param_t::ble_scan_rsp_data_cmpl_evt_param
:members:
.. doxygenstruct :: esp_ble_gap_cb_param_t::ble_scan_param_cmpl_evt_param
:members:
.. doxygenstruct :: esp_ble_gap_cb_param_t::ble_scan_result_evt_param
:members:
Functions
^^^^^^^^^
.. doxygenfunction :: esp_ble_gap_register_callback
.. doxygenfunction :: esp_ble_gap_config_adv_data
.. doxygenfunction :: esp_ble_gap_set_scan_params
.. doxygenfunction :: esp_ble_gap_start_scanning
.. doxygenfunction :: esp_ble_gap_stop_scanning
.. doxygenfunction :: esp_ble_gap_start_advertising
.. doxygenfunction :: esp_ble_gap_stop_advertising
.. doxygenfunction :: esp_ble_gap_update_conn_params
.. doxygenfunction :: esp_ble_gap_set_pkt_data_len
.. doxygenfunction :: esp_ble_gap_set_rand_addr
.. doxygenfunction :: esp_ble_gap_config_local_privacy
.. doxygenfunction :: esp_ble_gap_set_device_name
.. doxygenfunction :: esp_ble_resolve_adv_data