ble_esp_gap.h

/*
 * SPDX-FileCopyrightText: 2021-2023 Espressif Systems (Shanghai) CO LTD
 *
 * SPDX-License-Identifier: Unlicense OR CC0-1.0
 */
 
#ifndef H_BLE_ESP_GAP_
#define H_BLE_ESP_GAP_
 
#ifdef __cplusplus
extern "C" {
#endif
 
enum gap_status {
    BLE_GAP_STATUS_ADV = 0,
    BLE_GAP_STATUS_EXT_ADV,
    BLE_GAP_STATUS_SCAN,
    BLE_GAP_STATUS_CONN,
    BLE_GAP_STATUS_PAIRED,
    BLE_GAP_STATUS_GATTS,
    BLE_GAP_STATUS_HOST_PRIVACY,
    BLE_GAP_STATUS_PERIODIC,
};
 
typedef enum gap_status gap_status_t;
 
#define BLE_DUPLICATE_SCAN_EXCEPTIONAL_INFO_ADV_ADDR             0
#define BLE_DUPLICATE_SCAN_EXCEPTIONAL_INFO_MESH_LINK_ID         1
#define BLE_DUPLICATE_SCAN_EXCEPTIONAL_INFO_MESH_BEACON_TYPE     2
#define BLE_DUPLICATE_SCAN_EXCEPTIONAL_INFO_MESH_PROV_SRV_ADV    3
#define BLE_DUPLICATE_SCAN_EXCEPTIONAL_INFO_MESH_PROXY_SRV_ADV   4
 
int ble_hs_hci_util_set_data_len(uint16_t conn_handle, uint16_t tx_octets,
                                 uint16_t tx_time);
 
int ble_hs_hci_util_read_sugg_def_data_len(uint16_t *out_sugg_max_tx_octets,
                                           uint16_t *out_sugg_max_tx_time);
int ble_hs_hci_util_write_sugg_def_data_len(uint16_t sugg_max_tx_octets, uint16_t sugg_max_tx_time);
 
int ble_gap_wl_tx_rmv(const ble_addr_t *addrs);
 
int ble_gap_wl_tx_clear(void);
 
int ble_gap_wl_read_size(uint8_t *size);
 
int ble_gap_host_check_status(void);
 
int ble_gap_get_local_used_addr(ble_addr_t *addr);
 
uint8_t* ble_resolve_adv_data(const uint8_t *adv_data, uint8_t adv_type, uint8_t adv_data_len , uint8_t * length);
 
#if MYNEWT_VAL(BLE_HCI_VS)
#if MYNEWT_VAL(BLE_POWER_CONTROL)
 
#define ESP_1M_LOW    (-70)
#define ESP_1M_HIGH   (-60)
#define ESP_2M_LOW    (-68)
#define ESP_2M_HIGH   (-58)
#define ESP_S2_LOW    (-75)
#define ESP_S2_HIGH   (-65)
#define ESP_S8_LOW    (-80)
#define ESP_S8_HIGH   (-70)
#define ESP_MIN_TIME  (15)
 
/* Represents the set of lower / upper values of rssi of given chip
 *
 * Lower Limit Values Range: -54 to -80
 * Upper Limit Values Range: -40 to -70
 *
 * */
struct ble_gap_set_auto_pcl_params {
 
    /* Connection Handle of the ACL Link */
    int16_t conn_handle;
 
    /* The Lower RSSI limit when 1M phy is used */
    int8_t m1_lower_limit;
 
    /* The Upper RSSI limit when 1M phy is used */
    int8_t m1_upper_limit;
 
#if MYNEWT_VAL(BLE_LL_CFG_FEAT_LE_2M_PHY)
    /* The Lower RSSI limit when 2M phy is used */
    int8_t m2_lower_limit;
 
    /* The Upper RSSI limit when 2M phy is used */
    int8_t m2_upper_limit;
#endif
 
#if MYNEWT_VAL(BLE_LL_CFG_FEAT_LE_CODED_PHY)
     /* The Lower RSSI limit when S2 Coded phy is used */
    int8_t s2_lower_limit;
 
    /* The Upper RSSI limit when S2 Coded phy is used */
    int8_t s2_upper_limit;
 
    /* The Lower RSSI limit when S8 Coded phy is used */
    int8_t s8_lower_limit;
 
    /* The Upper RSSI limit when S8 Coded phy is used */
    int8_t s8_upper_limit;
#endif
 
    /* Number of tx/rx packets to wait before initiating the LE power control Request.
     * The default value is (min time spent variable =  (tx/rxpackets 15)).*/
    uint8_t min_time_spent;
};
 
int ble_gap_set_auto_pcl_param(struct ble_gap_set_auto_pcl_params *params);
#endif
 
int ble_gap_duplicate_exception_list(uint8_t subcode, uint8_t type, uint8_t *value, void *cb);
 
int ble_gap_clear_legacy_adv(void);
 
int ble_gap_set_chan_select(uint8_t select);
 
#endif
 
int
ble_gap_dev_authorization(uint16_t conn_handle, bool authorized);
 
void ble_gap_rx_test_evt(const void *buf, uint8_t len);
void ble_gap_tx_test_evt(const void *buf, uint8_t len);
void ble_gap_end_test_evt(const void *buf, uint8_t len);
 
#ifdef __cplusplus
}
#endif
 
#endif