1. add feature of remove bonded devices. 2. fix SMP key size bug 3. fix privacy bug 4. fix gatt set value bug 5. add gatt security client demo 6. change gatt server/gatt client demo
678 lines
30 KiB
C
678 lines
30 KiB
C
// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
|
|
#ifndef __ESP_GATTC_API_H__
|
|
#define __ESP_GATTC_API_H__
|
|
|
|
#include "esp_bt_defs.h"
|
|
#include "esp_gatt_defs.h"
|
|
#include "esp_err.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/// GATT Client callback function events
|
|
typedef enum {
|
|
ESP_GATTC_REG_EVT = 0, /*!< When GATT client is registered, the event comes */
|
|
ESP_GATTC_UNREG_EVT = 1, /*!< When GATT client is unregistered, the event comes */
|
|
ESP_GATTC_OPEN_EVT = 2, /*!< When GATT virtual connection is set up, the event comes */
|
|
ESP_GATTC_READ_CHAR_EVT = 3, /*!< When GATT characteristic is read, the event comes */
|
|
ESP_GATTC_WRITE_CHAR_EVT = 4, /*!< When GATT characteristic write operation completes, the event comes */
|
|
ESP_GATTC_CLOSE_EVT = 5, /*!< When GATT virtual connection is closed, the event comes */
|
|
ESP_GATTC_SEARCH_CMPL_EVT = 6, /*!< When GATT service discovery is completed, the event comes */
|
|
ESP_GATTC_SEARCH_RES_EVT = 7, /*!< When GATT service discovery result is got, the event comes */
|
|
ESP_GATTC_READ_DESCR_EVT = 8, /*!< When GATT characteristic descriptor read completes, the event comes */
|
|
ESP_GATTC_WRITE_DESCR_EVT = 9, /*!< When GATT characteristic descriptor write completes, the event comes */
|
|
ESP_GATTC_NOTIFY_EVT = 10, /*!< When GATT notification or indication arrives, the event comes */
|
|
ESP_GATTC_PREP_WRITE_EVT = 11, /*!< When GATT prepare-write operation completes, the event comes */
|
|
ESP_GATTC_EXEC_EVT = 12, /*!< When write execution completes, the event comes */
|
|
ESP_GATTC_ACL_EVT = 13, /*!< When ACL connection is up, the event comes */
|
|
ESP_GATTC_CANCEL_OPEN_EVT = 14, /*!< When GATT client ongoing connection is cancelled, the event comes */
|
|
ESP_GATTC_SRVC_CHG_EVT = 15, /*!< When "service changed" occurs, the event comes */
|
|
ESP_GATTC_ENC_CMPL_CB_EVT = 17, /*!< When encryption procedure completes, the event comes */
|
|
ESP_GATTC_CFG_MTU_EVT = 18, /*!< When configuration of MTU completes, the event comes */
|
|
ESP_GATTC_ADV_DATA_EVT = 19, /*!< When advertising of data, the event comes */
|
|
ESP_GATTC_MULT_ADV_ENB_EVT = 20, /*!< When multi-advertising is enabled, the event comes */
|
|
ESP_GATTC_MULT_ADV_UPD_EVT = 21, /*!< When multi-advertising parameters are updated, the event comes */
|
|
ESP_GATTC_MULT_ADV_DATA_EVT = 22, /*!< When multi-advertising data arrives, the event comes */
|
|
ESP_GATTC_MULT_ADV_DIS_EVT = 23, /*!< When multi-advertising is disabled, the event comes */
|
|
ESP_GATTC_CONGEST_EVT = 24, /*!< When GATT connection congestion comes, the event comes */
|
|
ESP_GATTC_BTH_SCAN_ENB_EVT = 25, /*!< When batch scan is enabled, the event comes */
|
|
ESP_GATTC_BTH_SCAN_CFG_EVT = 26, /*!< When batch scan storage is configured, the event comes */
|
|
ESP_GATTC_BTH_SCAN_RD_EVT = 27, /*!< When Batch scan read event is reported, the event comes */
|
|
ESP_GATTC_BTH_SCAN_THR_EVT = 28, /*!< When Batch scan threshold is set, the event comes */
|
|
ESP_GATTC_BTH_SCAN_PARAM_EVT = 29, /*!< When Batch scan parameters are set, the event comes */
|
|
ESP_GATTC_BTH_SCAN_DIS_EVT = 30, /*!< When Batch scan is disabled, the event comes */
|
|
ESP_GATTC_SCAN_FLT_CFG_EVT = 31, /*!< When Scan filter configuration completes, the event comes */
|
|
ESP_GATTC_SCAN_FLT_PARAM_EVT = 32, /*!< When Scan filter parameters are set, the event comes */
|
|
ESP_GATTC_SCAN_FLT_STATUS_EVT = 33, /*!< When Scan filter status is reported, the event comes */
|
|
ESP_GATTC_ADV_VSC_EVT = 34, /*!< When advertising vendor spec content event is reported, the event comes */
|
|
ESP_GATTC_GET_CHAR_EVT = 35, /*!< When characteristic is got from GATT server, the event comes */
|
|
ESP_GATTC_GET_DESCR_EVT = 36, /*!< When characteristic descriptor is got from GATT server, the event comes */
|
|
ESP_GATTC_GET_INCL_SRVC_EVT = 37, /*!< When included service is got from GATT server, the event comes */
|
|
ESP_GATTC_REG_FOR_NOTIFY_EVT = 38, /*!< When register for notification of a service completes, the event comes */
|
|
ESP_GATTC_UNREG_FOR_NOTIFY_EVT = 39, /*!< When unregister for notification of a service completes, the event comes */
|
|
ESP_GATTC_CONNECT_EVT = 40, /*!< When the ble physical connection is set up, the event comes */
|
|
ESP_GATTC_DISCONNECT_EVT = 41, /*!< When the ble physical connection disconnected, the event comes */
|
|
} esp_gattc_cb_event_t;
|
|
|
|
/// Maximum Transmission Unit used in GATT
|
|
#define ESP_GATT_DEF_BLE_MTU_SIZE 23
|
|
|
|
/// Maximum Transmission Unit allowed in GATT
|
|
#define ESP_GATT_MAX_MTU_SIZE 517
|
|
|
|
/**
|
|
* @brief Gatt client callback parameters union
|
|
*/
|
|
typedef union {
|
|
/**
|
|
* @brief ESP_GATTC_REG_EVT
|
|
*/
|
|
struct gattc_reg_evt_param {
|
|
esp_gatt_status_t status; /*!< Operation status */
|
|
uint16_t app_id; /*!< Application id which input in register API */
|
|
} reg; /*!< Gatt client callback param of ESP_GATTC_REG_EVT */
|
|
|
|
/**
|
|
* @brief ESP_GATTC_OPEN_EVT
|
|
*/
|
|
struct gattc_open_evt_param {
|
|
esp_gatt_status_t status; /*!< Operation status */
|
|
uint16_t conn_id; /*!< Connection id */
|
|
esp_bd_addr_t remote_bda; /*!< Remote bluetooth device address */
|
|
uint16_t mtu; /*!< MTU size */
|
|
} open; /*!< Gatt client callback param of ESP_GATTC_OPEN_EVT */
|
|
|
|
/**
|
|
* @brief ESP_GATTC_CLOSE_EVT
|
|
*/
|
|
struct gattc_close_evt_param {
|
|
esp_gatt_status_t status; /*!< Operation status */
|
|
uint16_t conn_id; /*!< Connection id */
|
|
esp_bd_addr_t remote_bda; /*!< Remote bluetooth device address */
|
|
esp_gatt_conn_reason_t reason; /*!< The reason of gatt connection close */
|
|
} close; /*!< Gatt client callback param of ESP_GATTC_CLOSE_EVT */
|
|
|
|
/**
|
|
* @brief ESP_GATTC_CFG_MTU_EVT
|
|
*/
|
|
struct gattc_cfg_mtu_evt_param {
|
|
esp_gatt_status_t status; /*!< Operation status */
|
|
uint16_t conn_id; /*!< Connection id */
|
|
uint16_t mtu; /*!< MTU size */
|
|
} cfg_mtu; /*!< Gatt client callback param of ESP_GATTC_CFG_MTU_EVT */
|
|
|
|
/**
|
|
* @brief ESP_GATTC_SEARCH_CMPL_EVT
|
|
*/
|
|
struct gattc_search_cmpl_evt_param {
|
|
esp_gatt_status_t status; /*!< Operation status */
|
|
uint16_t conn_id; /*!< Connection id */
|
|
} search_cmpl; /*!< Gatt client callback param of ESP_GATTC_SEARCH_CMPL_EVT */
|
|
|
|
/**
|
|
* @brief ESP_GATTC_SEARCH_RES_EVT
|
|
*/
|
|
struct gattc_search_res_evt_param {
|
|
uint16_t conn_id; /*!< Connection id */
|
|
esp_gatt_srvc_id_t srvc_id; /*!< Service id, include service uuid and other information */
|
|
} search_res; /*!< Gatt client callback param of ESP_GATTC_SEARCH_RES_EVT */
|
|
|
|
/**
|
|
* @brief ESP_GATTC_READ_CHAR_EVT, ESP_GATTC_READ_DESCR_EVT
|
|
*/
|
|
struct gattc_read_char_evt_param {
|
|
|
|
esp_gatt_status_t status; /*!< Operation status */
|
|
uint16_t conn_id; /*!< Connection id */
|
|
esp_gatt_srvc_id_t srvc_id; /*!< Service id, include service uuid and other information */
|
|
esp_gatt_id_t char_id; /*!< Characteristic id, include characteristic uuid and other information */
|
|
esp_gatt_id_t descr_id; /*!< Descriptor id, include descriptor uuid and other information */
|
|
uint8_t *value; /*!< Characteristic value */
|
|
uint16_t value_type; /*!< Characteristic value type, there is two value for this type:
|
|
ESP_GATTC_READ_VALUE_TYPE_VALUE(0x0000) and
|
|
ESP_GATTC_READ_VALUE_TYPE_AGG_FORMAT(0x2905).
|
|
If the value is ESP_GATTC_READ_VALUE_TYPE_VALUE means it is a generally
|
|
value type, and if is the type of ESP_GATTC_READ_VALUE_TYPE_AGG_FORMAT,
|
|
the unit of the value will indicate in the Characteristic
|
|
aggregate format descriptor */
|
|
uint16_t value_len; /*!< Characteristic value length */
|
|
} read; /*!< Gatt client callback param of ESP_GATTC_READ_CHAR_EVT */
|
|
|
|
/**
|
|
* @brief ESP_GATTC_WRITE_CHAR_EVT, ESP_GATTC_PREP_WRITE_EVT, ESP_GATTC_WRITE_DESCR_EVT
|
|
*/
|
|
struct gattc_write_evt_param {
|
|
esp_gatt_status_t status; /*!< Operation status */
|
|
uint16_t conn_id; /*!< Connection id */
|
|
esp_gatt_srvc_id_t srvc_id; /*!< Service id, include service uuid and other information */
|
|
esp_gatt_id_t char_id; /*!< Characteristic id, include characteristic uuid and other information */
|
|
esp_gatt_id_t descr_id; /*!< Descriptor id, include descriptor uuid and other information */
|
|
} write; /*!< Gatt client callback param of ESP_GATTC_WRITE_DESCR_EVT */
|
|
|
|
/**
|
|
* @brief ESP_GATTC_EXEC_EVT
|
|
*/
|
|
struct gattc_exec_cmpl_evt_param {
|
|
esp_gatt_status_t status; /*!< Operation status */
|
|
uint16_t conn_id; /*!< Connection id */
|
|
} exec_cmpl; /*!< Gatt client callback param of ESP_GATTC_EXEC_EVT */
|
|
|
|
/**
|
|
* @brief ESP_GATTC_NOTIFY_EVT
|
|
*/
|
|
struct gattc_notify_evt_param {
|
|
uint16_t conn_id; /*!< Connection id */
|
|
esp_bd_addr_t remote_bda; /*!< Remote bluetooth device address */
|
|
esp_gatt_srvc_id_t srvc_id; /*!< Service id, include service uuid and other information */
|
|
esp_gatt_id_t char_id; /*!< Characteristic id, include characteristic uuid and other information */
|
|
esp_gatt_id_t descr_id; /*!< Descriptor id, include descriptor uuid and other information */
|
|
uint16_t value_len; /*!< Notify attribute value */
|
|
uint8_t *value; /*!< Notify attribute value */
|
|
bool is_notify; /*!< True means notify, false means indicate */
|
|
} notify; /*!< Gatt client callback param of ESP_GATTC_NOTIFY_EVT */
|
|
|
|
/**
|
|
* @brief ESP_GATTC_SRVC_CHG_EVT
|
|
*/
|
|
struct gattc_srvc_chg_evt_param {
|
|
esp_bd_addr_t remote_bda; /*!< Remote bluetooth device address */
|
|
} srvc_chg; /*!< Gatt client callback param of ESP_GATTC_SRVC_CHG_EVT */
|
|
|
|
/**
|
|
* @brief ESP_GATTC_CONGEST_EVT
|
|
*/
|
|
struct gattc_congest_evt_param {
|
|
uint16_t conn_id; /*!< Connection id */
|
|
bool congested; /*!< Congested or not */
|
|
} congest; /*!< Gatt client callback param of ESP_GATTC_CONGEST_EVT */
|
|
|
|
/**
|
|
* @brief ESP_GATTC_GET_CHAR_EVT
|
|
*/
|
|
struct gattc_get_char_evt_param {
|
|
esp_gatt_status_t status; /*!< Operation status */
|
|
uint16_t conn_id; /*!< Connection id */
|
|
esp_gatt_srvc_id_t srvc_id; /*!< Service id, include service uuid and other information */
|
|
esp_gatt_id_t char_id; /*!< Characteristic id, include characteristic uuid and other information */
|
|
esp_gatt_char_prop_t char_prop; /*!< Characteristic property */
|
|
} get_char; /*!< Gatt client callback param of ESP_GATTC_GET_CHAR_EVT */
|
|
|
|
/**
|
|
* @brief ESP_GATTC_GET_DESCR_EVT
|
|
*/
|
|
struct gattc_get_descr_evt_param {
|
|
esp_gatt_status_t status; /*!< Operation status */
|
|
uint16_t conn_id; /*!< Connection id */
|
|
esp_gatt_srvc_id_t srvc_id; /*!< Service id, include service uuid and other information */
|
|
esp_gatt_id_t char_id; /*!< Characteristic id, include characteristic uuid and other information */
|
|
esp_gatt_id_t descr_id; /*!< Descriptor id, include descriptor uuid and other information */
|
|
} get_descr; /*!< Gatt client callback param of ESP_GATTC_GET_DESCR_EVT */
|
|
|
|
/**
|
|
* @brief ESP_GATTC_GET_INCL_SRVC_EVT
|
|
*/
|
|
struct gattc_get_incl_srvc_evt_param {
|
|
esp_gatt_status_t status; /*!< Operation status */
|
|
uint16_t conn_id; /*!< Connection id */
|
|
esp_gatt_srvc_id_t srvc_id; /*!< Service id, include service uuid and other information */
|
|
esp_gatt_srvc_id_t incl_srvc_id;/*!< Included service id, include service uuid and other information */
|
|
} get_incl_srvc; /*!< Gatt client callback param of ESP_GATTC_GET_INCL_SRVC_EVT */
|
|
|
|
/**
|
|
* @brief ESP_GATTC_REG_FOR_NOTIFY_EVT
|
|
*/
|
|
struct gattc_reg_for_notify_evt_param {
|
|
esp_gatt_status_t status; /*!< Operation status */
|
|
esp_gatt_srvc_id_t srvc_id; /*!< Service id, include service uuid and other information */
|
|
esp_gatt_id_t char_id; /*!< Characteristic id, include characteristic uuid and other information */
|
|
} reg_for_notify; /*!< Gatt client callback param of ESP_GATTC_REG_FOR_NOTIFY_EVT */
|
|
|
|
/**
|
|
* @brief ESP_GATTC_UNREG_FOR_NOTIFY_EVT
|
|
*/
|
|
struct gattc_unreg_for_notify_evt_param {
|
|
esp_gatt_status_t status; /*!< Operation status */
|
|
esp_gatt_srvc_id_t srvc_id; /*!< Service id, include service uuid and other information */
|
|
esp_gatt_id_t char_id; /*!< Characteristic id, include characteristic uuid and other information */
|
|
} unreg_for_notify; /*!< Gatt client callback param of ESP_GATTC_UNREG_FOR_NOTIFY_EVT */
|
|
|
|
/**
|
|
* @brief ESP_GATTC_CONNECT_EVT
|
|
*/
|
|
struct gattc_connect_evt_param {
|
|
esp_gatt_status_t status; /*!< Operation status */
|
|
uint16_t conn_id; /*!< Connection id */
|
|
esp_bd_addr_t remote_bda; /*!< Remote bluetooth device address */
|
|
} connect; /*!< Gatt client callback param of ESP_GATTC_CONNECT_EVT */
|
|
|
|
/**
|
|
* @brief ESP_GATTC_DISCONNECT_EVT
|
|
*/
|
|
struct gattc_disconnect_evt_param {
|
|
esp_gatt_status_t status; /*!< Operation status */
|
|
uint16_t conn_id; /*!< Connection id */
|
|
esp_bd_addr_t remote_bda; /*!< Remote bluetooth device address */
|
|
} disconnect; /*!< Gatt client callback param of ESP_GATTC_DISCONNECT_EVT */
|
|
|
|
} esp_ble_gattc_cb_param_t; /*!< GATT client callback parameter union type */
|
|
|
|
/**
|
|
* @brief GATT Client callback function type
|
|
* @param event : Event type
|
|
* @param gatts_if : GATT client access interface, normally
|
|
* different gattc_if correspond to different profile
|
|
* @param param : Point to callback parameter, currently is union type
|
|
*/
|
|
typedef void (* esp_gattc_cb_t)(esp_gattc_cb_event_t event, esp_gatt_if_t gattc_if, esp_ble_gattc_cb_param_t *param);
|
|
|
|
/**
|
|
* @brief This function is called to register application callbacks
|
|
* with GATTC module.
|
|
*
|
|
* @param[in] callback : pointer to the application callback function.
|
|
*
|
|
* @return
|
|
* - ESP_OK: success
|
|
* - other: failed
|
|
*
|
|
*/
|
|
esp_err_t esp_ble_gattc_register_callback(esp_gattc_cb_t callback);
|
|
|
|
|
|
/**
|
|
* @brief This function is called to register application callbacks
|
|
* with GATTC module.
|
|
*
|
|
* @param[in] app_id : Application Identify (UUID), for different application
|
|
*
|
|
* @return
|
|
* - ESP_OK: success
|
|
* - other: failed
|
|
*
|
|
*/
|
|
esp_err_t esp_ble_gattc_app_register(uint16_t app_id);
|
|
|
|
|
|
/**
|
|
* @brief This function is called to unregister an application
|
|
* from GATTC module.
|
|
*
|
|
* @param[in] gattc_if: Gatt client access interface.
|
|
*
|
|
* @return
|
|
* - ESP_OK: success
|
|
* - other: failed
|
|
*
|
|
*/
|
|
esp_err_t esp_ble_gattc_app_unregister(esp_gatt_if_t gattc_if);
|
|
|
|
|
|
/**
|
|
* @brief Open a direct connection or add a background auto connection
|
|
*
|
|
* @param[in] gattc_if: Gatt client access interface.
|
|
* @param[in] remote_bda: remote device bluetooth device address.
|
|
* @param[in] is_direct: direct connection or background auto connection
|
|
*
|
|
* @return
|
|
* - ESP_OK: success
|
|
* - other: failed
|
|
*
|
|
*/
|
|
esp_err_t esp_ble_gattc_open(esp_gatt_if_t gattc_if, esp_bd_addr_t remote_bda, bool is_direct);
|
|
|
|
|
|
/**
|
|
* @brief Close a virtual connection to a GATT server. gattc maybe have multiple virtual GATT server connections when multiple app_id registed,
|
|
* this API only close one virtual GATT server connection. if there exist other virtual GATT server connections,
|
|
* it does not disconnect the physical connection.
|
|
* if you want to disconnect the physical connection directly, you can use esp_ble_gap_disconnect(esp_bd_addr_t remote_device).
|
|
*
|
|
* @param[in] gattc_if: Gatt client access interface.
|
|
* @param[in] conn_id: connection ID to be closed.
|
|
*
|
|
* @return
|
|
* - ESP_OK: success
|
|
* - other: failed
|
|
*
|
|
*/
|
|
esp_err_t esp_ble_gattc_close (esp_gatt_if_t gattc_if, uint16_t conn_id);
|
|
|
|
|
|
/**
|
|
* @brief Configure the MTU size in the GATT channel. This can be done
|
|
* only once per connection.
|
|
*
|
|
* @param[in] gattc_if: Gatt client access interface.
|
|
* @param[in] conn_id: connection ID.
|
|
* @param[in] mtu: desired MTU size to use.
|
|
*
|
|
* @return
|
|
* - ESP_OK: success
|
|
* - other: failed
|
|
*
|
|
*/
|
|
esp_err_t esp_ble_gattc_config_mtu (esp_gatt_if_t gattc_if, uint16_t conn_id, uint16_t mtu);
|
|
|
|
|
|
/**
|
|
* @brief This function is called to request a GATT service discovery
|
|
* on a GATT server. This function report service search result
|
|
* by a callback event, and followed by a service search complete
|
|
* event.
|
|
*
|
|
* @param[in] gattc_if: Gatt client access interface.
|
|
* @param[in] conn_id: connection ID.
|
|
* @param[in] filter_uuid: a UUID of the service application is interested in.
|
|
* If Null, discover for all services.
|
|
*
|
|
* @return
|
|
* - ESP_OK: success
|
|
* - other: failed
|
|
*
|
|
*/
|
|
esp_err_t esp_ble_gattc_search_service(esp_gatt_if_t gattc_if, uint16_t conn_id, esp_bt_uuid_t *filter_uuid);
|
|
|
|
|
|
/**
|
|
* @brief This function is called to find the first characteristic of the
|
|
* service on the given server.
|
|
*
|
|
* @param[in] gattc_if: Gatt client access interface.
|
|
* @param[in] conn_id: connection ID which identify the server.
|
|
* @param[in] srvc_id: service ID
|
|
* @param[in] start_char_id: the start characteristic ID
|
|
* @return
|
|
* - ESP_OK: success
|
|
* - other: failed
|
|
*
|
|
*/
|
|
esp_err_t esp_ble_gattc_get_characteristic(esp_gatt_if_t gattc_if,
|
|
uint16_t conn_id,
|
|
esp_gatt_srvc_id_t *srvc_id,
|
|
esp_gatt_id_t *start_char_id);
|
|
|
|
/**
|
|
* @brief This function is called to find the descriptor of the
|
|
* service on the given server.
|
|
*
|
|
* @param[in] gattc_if: Gatt client access interface.
|
|
* @param[in] conn_id: connection ID which identify the server.
|
|
* @param[in] srvc_id: the service ID of which the characteristic is belonged to.
|
|
* @param[in] char_id: Characteristic ID, if NULL find the first available
|
|
* characteristic.
|
|
* @param[in] start_descr_id: the start descriptor id
|
|
*
|
|
* @return
|
|
* - ESP_OK: success
|
|
* - other: failed
|
|
*
|
|
*/
|
|
esp_err_t esp_ble_gattc_get_descriptor(esp_gatt_if_t gattc_if,
|
|
uint16_t conn_id,
|
|
esp_gatt_srvc_id_t *srvc_id,
|
|
esp_gatt_id_t *char_id,
|
|
esp_gatt_id_t *start_descr_id);
|
|
|
|
|
|
/**
|
|
* @brief This function is called to find the first characteristic of the
|
|
* service on the given server.
|
|
*
|
|
* @param[in] gattc_if: Gatt client access interface.
|
|
* @param[in] conn_id: connection ID which identify the server.
|
|
* @param[in] srvc_id: the service ID of which the characteristic is belonged to.
|
|
* @param[in] start_incl_srvc_id: the start include service id
|
|
*
|
|
* @return
|
|
* - ESP_OK: success
|
|
* - other: failed
|
|
*
|
|
*/
|
|
esp_err_t esp_ble_gattc_get_included_service(esp_gatt_if_t gattc_if,
|
|
uint16_t conn_id,
|
|
esp_gatt_srvc_id_t *srvc_id,
|
|
esp_gatt_srvc_id_t *start_incl_srvc_id);
|
|
|
|
|
|
/**
|
|
* @brief This function is called to read a service's characteristics of
|
|
* the given characteristic ID
|
|
*
|
|
* @param[in] gattc_if: Gatt client access interface.
|
|
* @param[in] conn_id : connection ID.
|
|
* @param[in] srvc_id : service ID.
|
|
* @param[in] char_id : characteristic ID to read.
|
|
* @param[in] auth_req : authenticate request type
|
|
*
|
|
* @return
|
|
* - ESP_OK: success
|
|
* - other: failed
|
|
*
|
|
*/
|
|
esp_err_t esp_ble_gattc_read_char (esp_gatt_if_t gattc_if,
|
|
uint16_t conn_id,
|
|
esp_gatt_srvc_id_t *srvc_id,
|
|
esp_gatt_id_t *char_id,
|
|
esp_gatt_auth_req_t auth_req);
|
|
|
|
|
|
/**
|
|
* @brief This function is called to read a characteristics descriptor.
|
|
*
|
|
* @param[in] gattc_if: Gatt client access interface.
|
|
* @param[in] conn_id : connection ID.
|
|
* @param[in] srvc_id : service ID.
|
|
* @param[in] char_id : characteristic ID to read.
|
|
* @param[in] descr_id : characteristic descriptor ID to read.
|
|
* @param[in] auth_req : authenticate request type
|
|
*
|
|
* @return
|
|
* - ESP_OK: success
|
|
* - other: failed
|
|
*
|
|
*/
|
|
esp_err_t esp_ble_gattc_read_char_descr (esp_gatt_if_t gattc_if,
|
|
uint16_t conn_id,
|
|
esp_gatt_srvc_id_t *srvc_id,
|
|
esp_gatt_id_t *char_id,
|
|
esp_gatt_id_t *descr_id,
|
|
esp_gatt_auth_req_t auth_req);
|
|
|
|
|
|
/**
|
|
* @brief This function is called to write characteristic value.
|
|
*
|
|
* @param[in] gattc_if: Gatt client access interface.
|
|
* @param[in] conn_id : connection ID.
|
|
* @param[in] srvc_id : service ID.
|
|
* @param[in] char_id : characteristic ID to write.
|
|
* @param[in] value_len: length of the value to be written.
|
|
* @param[in] value : the value to be written.
|
|
* @param[in] write_type : the type of attribute write operation.
|
|
* @param[in] auth_req : authentication request.
|
|
*
|
|
* @return
|
|
* - ESP_OK: success
|
|
* - other: failed
|
|
*
|
|
*/
|
|
esp_err_t esp_ble_gattc_write_char( esp_gatt_if_t gattc_if,
|
|
uint16_t conn_id,
|
|
esp_gatt_srvc_id_t *srvc_id,
|
|
esp_gatt_id_t *char_id,
|
|
uint16_t value_len,
|
|
uint8_t *value,
|
|
esp_gatt_write_type_t write_type,
|
|
esp_gatt_auth_req_t auth_req);
|
|
|
|
|
|
/**
|
|
* @brief This function is called to write characteristic descriptor value.
|
|
*
|
|
* @param[in] gattc_if: Gatt client access interface.
|
|
* @param[in] conn_id : connection ID
|
|
* @param[in] srvc_id : service ID.
|
|
* @param[in] char_id : characteristic ID.
|
|
* @param[in] descr_id : characteristic descriptor ID to write.
|
|
* @param[in] value_len: length of the value to be written.
|
|
* @param[in] value : the value to be written.
|
|
* @param[in] write_type : the type of attribute write operation.
|
|
* @param[in] auth_req : authentication request.
|
|
*
|
|
* @return
|
|
* - ESP_OK: success
|
|
* - other: failed
|
|
*
|
|
*/
|
|
esp_err_t esp_ble_gattc_write_char_descr (esp_gatt_if_t gattc_if,
|
|
uint16_t conn_id,
|
|
esp_gatt_srvc_id_t *srvc_id,
|
|
esp_gatt_id_t *char_id,
|
|
esp_gatt_id_t *descr_id,
|
|
uint16_t value_len,
|
|
uint8_t *value,
|
|
esp_gatt_write_type_t write_type,
|
|
esp_gatt_auth_req_t auth_req);
|
|
|
|
|
|
/**
|
|
* @brief This function is called to prepare write a characteristic value.
|
|
*
|
|
* @param[in] gattc_if: Gatt client access interface.
|
|
* @param[in] conn_id : connection ID.
|
|
* @param[in] srvc_id : service ID.
|
|
* @param[in] char_id : GATT characteristic ID of the service.
|
|
* @param[in] offset : offset of the write value.
|
|
* @param[in] value_len: length of the value to be written.
|
|
* @param[in] value : the value to be written.
|
|
* @param[in] auth_req : authentication request.
|
|
*
|
|
* @return
|
|
* - ESP_OK: success
|
|
* - other: failed
|
|
*
|
|
*/
|
|
esp_err_t esp_ble_gattc_prepare_write(esp_gatt_if_t gattc_if,
|
|
uint16_t conn_id,
|
|
esp_gatt_srvc_id_t *srvc_id,
|
|
esp_gatt_id_t *char_id,
|
|
uint16_t offset,
|
|
uint16_t value_len,
|
|
uint8_t *value,
|
|
esp_gatt_auth_req_t auth_req);
|
|
|
|
|
|
/**
|
|
* @brief This function is called to prepare write a characteristic descriptor value.
|
|
*
|
|
* @param[in] gattc_if: Gatt client access interface.
|
|
* @param[in] conn_id : connection ID.
|
|
* @param[in] srvc_id : service ID.
|
|
* @param[in] char_id : GATT characteristic ID of the service.
|
|
* @param[in] descr_id : characteristic descriptor ID to write.
|
|
* @param[in] offset : offset of the write value.
|
|
* @param[in] value_len: length of the value to be written.
|
|
* @param[in] value : the value to be written.
|
|
* @param[in] auth_req : authentication request.
|
|
*
|
|
* @return
|
|
* - ESP_OK: success
|
|
* - other: failed
|
|
*
|
|
*/
|
|
esp_err_t esp_ble_gattc_prepare_write_char_descr(esp_gatt_if_t gattc_if,
|
|
uint16_t conn_id,
|
|
esp_gatt_srvc_id_t *srvc_id,
|
|
esp_gatt_id_t *char_id,
|
|
esp_gatt_id_t *descr_id,
|
|
uint16_t offset,
|
|
uint16_t value_len,
|
|
uint8_t *value,
|
|
esp_gatt_auth_req_t auth_req);
|
|
|
|
|
|
/**
|
|
* @brief This function is called to execute write a prepare write sequence.
|
|
*
|
|
* @param[in] gattc_if: Gatt client access interface.
|
|
* @param[in] conn_id : connection ID.
|
|
* @param[in] is_execute : execute or cancel.
|
|
*
|
|
* @return
|
|
* - ESP_OK: success
|
|
* - other: failed
|
|
*
|
|
*/
|
|
esp_err_t esp_ble_gattc_execute_write (esp_gatt_if_t gattc_if, uint16_t conn_id, bool is_execute);
|
|
|
|
|
|
/**
|
|
* @brief This function is called to register for notification of a service.
|
|
*
|
|
* @param[in] gattc_if: Gatt client access interface.
|
|
* @param[in] server_bda : target GATT server.
|
|
* @param[in] srvc_id : pointer to GATT service ID.
|
|
* @param[in] char_id : pointer to GATT characteristic ID.
|
|
*
|
|
* @return
|
|
* - ESP_OK: registration succeeds
|
|
* - other: failed
|
|
*
|
|
*/
|
|
esp_err_t esp_ble_gattc_register_for_notify (esp_gatt_if_t gattc_if,
|
|
esp_bd_addr_t server_bda,
|
|
esp_gatt_srvc_id_t *srvc_id,
|
|
esp_gatt_id_t *char_id);
|
|
|
|
|
|
/**
|
|
* @brief This function is called to de-register for notification of a service.
|
|
*
|
|
* @param[in] gattc_if: Gatt client access interface.
|
|
* @param[in] server_bda : target GATT server.
|
|
* @param[in] srvc_id : pointer to GATT service ID.
|
|
* @param[in] char_id : pointer to GATT characteristic ID.
|
|
*
|
|
* @return
|
|
* - ESP_OK: unregister succeeds
|
|
* - other: failed
|
|
*
|
|
*/
|
|
esp_err_t esp_ble_gattc_unregister_for_notify (esp_gatt_if_t gattc_if,
|
|
esp_bd_addr_t server_bda,
|
|
esp_gatt_srvc_id_t *srvc_id,
|
|
esp_gatt_id_t *char_id);
|
|
|
|
|
|
/**
|
|
* @brief Refresh the server cache store in the gattc stack of the remote device
|
|
*
|
|
* @param[in] remote_bda: remote device BD address.
|
|
*
|
|
* @return
|
|
* - ESP_OK: success
|
|
* - other: failed
|
|
*
|
|
*/
|
|
esp_err_t esp_ble_gattc_cache_refresh(esp_bd_addr_t remote_bda);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* __ESP_GATTC_API_H__ */
|