/**
*****************************************************************************************
* Copyright(c) 2016, Realtek Semiconductor Corporation. All rights reserved.
*****************************************************************************************
* @file gap_bond_le.h
* @brief This file contains all the functions prototypes for the GAP bond and pairing
* related functions.
* @details
* @author ranhui
* @date 2016-02-18
* @version v1.0
* *************************************************************************************
*/
/*============================================================================*
* Define to prevent recursive inclusion
*============================================================================*/
#ifndef GAP_BOND_LE_H
#define GAP_BOND_LE_H
#ifdef __cplusplus
extern "C"
{
#endif
/*============================================================================*
* Header Files
*============================================================================*/
#include "upperstack_config.h"
#include "gap_le.h"
/** @defgroup GAP_LE_Bond_Manager GAP LE Bond Manager
* @brief GAP LE Bond Manager
* @{
*/
/*============================================================================*
* Types
*============================================================================*/
/** @defgroup GAP_LE_BOND_MANAGER_Exported_Types GAP LE Bond Manager Exported Types
* @{
*/
/** @brief LE bond parameter types */
typedef enum
{
#if F_BT_LE_SMP_OOB_SUPPORT
GAP_PARAM_BOND_OOB_DATA = 0x210,//!< OOB Data. Read/Write. size uint8_t[16]. Default is all 0's.
#endif
GAP_PARAM_BOND_FIXED_PASSKEY = 0x211,//!< The fix passcode for MITM protection. Read/Write. size is uint32_t. Range is 0 - 999,999. Default is 0.
GAP_PARAM_BOND_FIXED_PASSKEY_ENABLE = 0x212,//!< The fix passcode available for pairing. Read/Write. size is uint8_t. Default is 0(disabled).
GAP_PARAM_BOND_SEC_REQ_ENABLE = 0x213,//!< Send smp security request when connected. Read/Write. size is uint8_t. Default is 0(disabled).
GAP_PARAM_BOND_SEC_REQ_REQUIREMENT = 0x214,//!< Security request requirements. Read/Write. size is uint8_t. Default is GAP_AUTHEN_BIT_BONDING_FLAG (@ref BOND_MITM_DEFINES)
GAP_PARAM_BOND_MIN_KEY_SIZE = 0x215,//!< Minium LTK size required. Read/Write. size is uint8_t.
#if F_BT_LE_LOCAL_IRK_SETTING_SUPPORT
GAP_PARAM_BOND_GEN_LOCAL_IRK_AUTO = 0x216,//!< Auto generate local IRK. Write only. size is uint8_t. Default is 0(disabled).
GAP_PARAM_BOND_SET_LOCAL_IRK = 0x217,//!< Set local IRK. Write only. size is uint8_t. Default is all zero.
#endif
GAP_PARAM_BOND_KEY_MANAGER = 0x218,//!< Key manager. Write only. size is uint8_t. Default is 0(disabled).
GAP_PARAM_BOND_SIGN_KEY_FLAG = 0x219,//!< Sign key flag configure. Write only. size is uint8_t. Default is 0(disabled).
GAP_PARAM_BOND_CCCD_STORAGE = 0x21A,//!< Whether to store cccd information. Write only. size is uint8_t. Default is true.
} T_LE_BOND_PARAM_TYPE;
#if F_BT_LE_4_2_SC_OOB_SUPPORT
/** @brief LE local Out of Band data */
typedef struct
{
uint8_t present;
uint8_t rand[16];
uint8_t confirm[16];
uint8_t bd_addr_to[6];
uint8_t local_sk[32];
uint8_t local_pk[64];
} T_GAP_LE_LOCAL_OOB_DATA;
/** @brief LE peer Out of Band data */
typedef struct
{
uint8_t present;
uint8_t rand[16];
uint8_t confirm[16];
uint8_t bd_addr_from[6];
} T_GAP_LE_PEER_OOB_DATA;
#endif
/** End of GAP_LE_BOND_MANAGER_Exported_Types
* @}
*/
/*============================================================================*
* Functions
*============================================================================*/
/** @defgroup GAP_LE_BONDMGR_Exported_Functions GAP LE Bond Manager Exported Functions
* @brief
* @{
*/
/**
* @brief Set a GAP Bond Manager Parameter.
*
* NOTE: You can call this function with a bond parameter type and it will set the
* bond parameter. Bond parameters are defined in @ref T_LE_BOND_PARAM_TYPE.
* if the "len" field sets to the size of a "uint16_t" ,the
* "p_value" field must point to a data with type of "uint16_t".
*
* @param[in] param Bond parameter type: @ref T_LE_BOND_PARAM_TYPE
* @param[in] len Length of data to write
* @param[in] p_value Pointer to data to write. This is dependent on
* the parameter type and will be cast to the appropriate
* data type (For example: if data type param is uint16, p_value will be cast to
* pointer of uint16_t).
*
* @return Set result
* @retval GAP_CAUSE_SUCCESS Operation success.
* @retval Others Operation failure. No connection.
*
* Example usage
* \code{.c}
void app_le_gap_init(void)
{
...
uint8_t auth_use_fix_passkey = false;
uint32_t auth_fix_passkey = 0;
uint8_t auth_sec_req_enable = false;
uint16_t auth_sec_req_flags = GAP_AUTHEN_BIT_NONE;
le_bond_set_param(GAP_PARAM_BOND_FIXED_PASSKEY, sizeof(auth_fix_passkey), &auth_fix_passkey);
le_bond_set_param(GAP_PARAM_BOND_FIXED_PASSKEY_ENABLE, sizeof(auth_use_fix_passkey),
&auth_use_fix_passkey);
le_bond_set_param(GAP_PARAM_BOND_SEC_REQ_ENABLE, sizeof(auth_sec_req_enable), &auth_sec_req_enable);
le_bond_set_param(GAP_PARAM_BOND_SEC_REQ_REQUIREMENT, sizeof(auth_sec_req_flags),
&auth_sec_req_flags);
....
}
* \endcode
*/
T_GAP_CAUSE le_bond_set_param(T_LE_BOND_PARAM_TYPE param, uint8_t len, void *p_value);
/**
* @brief Get a GAP Bond Manager Parameter.
*
* NOTE: You can call this function with a bond parameter type and it will get a
* bond parameter. Bond parameters are defined in @ref T_LE_BOND_PARAM_TYPE. Also, the
* "p_value" field must point to a "uint16".
*
* @param[in] param Profile parameter ID: @ref T_LE_BOND_PARAM_TYPE
* @param[in,out] p_value pointer to location to get the value. This is dependent on
* the parameter type and will be cast to the appropriate
* data type (For example: if data type param is uint16, p_value will be cast to
* pointer of uint16_t).
*
* @return Get result
* @retval GAP_CAUSE_SUCCESS Get parameter success.
* @retval other Get parameter failed.
*
* Example usage
* \code{.c}
void test(void)
{
uint8_t seq_req;
le_bond_get_param(GAP_PARAM_BOND_SEC_REQ_ENABLE, &seq_req);
}
* \endcode
*/
T_GAP_CAUSE le_bond_get_param(T_LE_BOND_PARAM_TYPE param, void *p_value);
/**
* @brief Start authentication the link.
*
* NOTE: If the link has not been bonded, it will trigger pairing procedure, otherwise
* it will trigger the link encryption procedure.
* @param[in] conn_id Connection ID.
* @return Operation result.
* @retval GAP_CAUSE_SUCCESS Operation success.
* @retval GAP_CAUSE_NON_CONN Operation failure. No connection.
*
* Example usage
* \code{.c}
void test(void)
{
uint8_t conn_id = 0;
le_bond_pair(conn_id);
}
void app_handle_authen_state_evt(uint8_t conn_id, uint8_t new_state, uint16_t cause)
{
APP_PRINT_INFO2("app_handle_authen_state_evt:conn_id %d, cause 0x%x", conn_id, cause);
switch (new_state)
{
case GAP_AUTHEN_STATE_STARTED:
{
APP_PRINT_INFO0("app_handle_authen_state_evt: GAP_AUTHEN_STATE_STARTED");
}
break;
case GAP_AUTHEN_STATE_COMPLETE:
{
if (cause == GAP_SUCCESS)
{
APP_PRINT_INFO0("app_handle_authen_state_evt: GAP_AUTHEN_STATE_COMPLETE pair success");
}
else
{
APP_PRINT_INFO0("app_handle_authen_state_evt: GAP_AUTHEN_STATE_COMPLETE pair failed");
}
}
break;
default:
{
APP_PRINT_ERROR1("app_handle_authen_state_evt: unknown newstate %d", new_state);
}
break;
}
}
* \endcode
*/
T_GAP_CAUSE le_bond_pair(uint8_t conn_id);
/**
* @brief Get the display key information
*
* @param[in] conn_id Connection ID.
* @param[in,out] p_key Passkey valueto be displayed as a 6 digit decimal number.
* @return Operation result.
* @retval GAP_CAUSE_SUCCESS Operation success.
* @retval GAP_CAUSE_NON_CONN Operation failure. No connection.
*
* Example usage
* \code{.c}
void app_handle_gap_msg(T_IO_MSG *p_io_msg)
{
T_LE_GAP_MSG bt_msg;
uint8_t conn_id;
memcpy(&bt_msg, &p_io_msg->u.param, sizeof(p_io_msg->u.param));
switch (p_io_msg->subtype)
{
...
case GAP_MSG_LE_BOND_PASSKEY_DISPLAY:
{
uint32_t display_value = 0;
conn_id = gap_msg.msg_data.gap_bond_passkey_display.conn_id;
le_bond_get_display_key(conn_id, &display_value);
APP_PRINT_INFO1("GAP_MSG_LE_BOND_PASSKEY_DISPLAY:passkey %d", display_value);
le_bond_passkey_display_confirm(conn_id, GAP_CFM_CAUSE_ACCEPT);
}
break;
...
}
...
}
* \endcode
*/
T_GAP_CAUSE le_bond_get_display_key(uint8_t conn_id, uint32_t *p_key);
/**
* @brief Send passkey to gap bond manager when pairing with passkey entry,
* and local should input passkey.
*
* @param[in] conn_id Connection ID.
* @param[in] passcode Result of Keyboard input.
* @param[in] cause User confirm result.
* @return Operation result.
* @retval GAP_CAUSE_SUCCESS Operation success.
* @retval GAP_CAUSE_NON_CONN Operation failure. No connection.
*
* Example usage
* \code{.c}
void app_handle_gap_msg(T_IO_MSG *p_io_msg)
{
T_LE_GAP_MSG bt_msg;
uint8_t conn_id;
memcpy(&bt_msg, &p_io_msg->u.param, sizeof(p_io_msg->u.param));
switch (p_io_msg->subtype)
{
...
case GAP_MSG_LE_BOND_PASSKEY_INPUT:
{
conn_id = bt_msg.msg_data.gap_bond_passkey_input.conn_id;
APP_PRINT_INFO0("GAP_MSG_LE_BOND_PASSKEY_INPUT");
uint32_t passKey = 888888;
le_bond_passkey_input_confirm(conn_id, passKey, GAP_CFM_CAUSE_ACCEPT);
}
break;
...
}
...
}
* \endcode
*/
T_GAP_CAUSE le_bond_passkey_input_confirm(uint8_t conn_id, uint32_t passcode,
T_GAP_CFM_CAUSE cause);
#if F_BT_LE_SMP_OOB_SUPPORT
/**
* @brief Send oob data to gap bond manager when pairing with out of bond,
* and local should input oob data.
* @param[in] conn_id connection ID.
* @param[in] cause User confirm result.
* @return Operation result.
* @retval GAP_CAUSE_SUCCESS Operation success.
* @retval GAP_CAUSE_NON_CONN Operation failure. No connection.
*
* Example usage
* \code{.c}
void app_handle_gap_msg(T_IO_MSG *p_io_msg)
{
T_LE_GAP_MSG bt_msg;
uint8_t conn_id;
memcpy(&bt_msg, &p_io_msg->u.param, sizeof(p_io_msg->u.param));
switch (p_io_msg->subtype)
{
...
case GAP_MSG_LE_BOND_OOB_INPUT:
{
conn_id = bt_msg.msg_data.gap_bond_oob_input.conn_id;
APP_PRINT_INFO0("GAP_MSG_LE_BOND_OOB_INPUT");
uint8_t ooBData[GAP_OOB_LEN] = {0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0};
le_bond_set_param(GAP_PARAM_BOND_OOB_DATA, GAP_OOB_LEN, ooBData);
le_bond_oob_input_confirm(conn_id, GAP_CFM_CAUSE_ACCEPT);
}
break;
...
}
...
}
* \endcode
*/
T_GAP_CAUSE le_bond_oob_input_confirm(uint8_t conn_id, T_GAP_CFM_CAUSE cause);
#endif
/**
* @brief Send user confirmation request to confirm result to upper stack when
pairing with jsut work.
* @param[in] conn_id Connection ID.
* @param[in] cause User confirm result.
* @return Operation result.
* @retval GAP_CAUSE_SUCCESS Operation success.
* @retval GAP_CAUSE_NON_CONN Operation failure. No connection.
*
* Example usage
* \code{.c}
void app_handle_gap_msg(T_IO_MSG *p_io_msg)
{
T_LE_GAP_MSG bt_msg;
uint8_t conn_id;
memcpy(&bt_msg, &p_io_msg->u.param, sizeof(p_io_msg->u.param));
switch (p_io_msg->subtype)
{
...
case GAP_MSG_LE_BOND_JUST_WORK:
{
conn_id = gap_msg.msg_data.gap_bond_just_work_conf.conn_id;
le_bond_just_work_confirm(conn_id, GAP_CFM_CAUSE_ACCEPT);
APP_PRINT_INFO0("GAP_MSG_LE_BOND_JUST_WORK");
}
break;
...
}
...
}
* \endcode
*/
T_GAP_CAUSE le_bond_just_work_confirm(uint8_t conn_id, T_GAP_CFM_CAUSE cause);
/**
* @brief Send user confirmation request to confirm result to upper stack when
pairing with passkey entry, and local shall display a passkey.
* @param[in] conn_id Connection ID.
* @param[in] cause User confirm result.
* @return Operation result.
* @retval GAP_CAUSE_SUCCESS Operation success.
* @retval GAP_CAUSE_NON_CONN Operation failure. No connection.
*
* Example usage
* \code{.c}
void app_handle_gap_msg(T_IO_MSG *p_io_msg)
{
T_LE_GAP_MSG bt_msg;
uint8_t conn_id;
memcpy(&bt_msg, &p_io_msg->u.param, sizeof(p_io_msg->u.param));
switch (p_io_msg->subtype)
{
...
case GAP_MSG_LE_BOND_PASSKEY_DISPLAY:
{
uint32_t display_value = 0;
conn_id = gap_msg.msg_data.gap_bond_passkey_display.conn_id;
le_bond_get_display_key(conn_id, &display_value);
APP_PRINT_INFO1("GAP_MSG_LE_BOND_PASSKEY_DISPLAY:passkey %d", display_value);
le_bond_passkey_display_confirm(conn_id, GAP_CFM_CAUSE_ACCEPT);
}
break;
...
}
...
}
* \endcode
*/
T_GAP_CAUSE le_bond_passkey_display_confirm(uint8_t conn_id, T_GAP_CFM_CAUSE cause);
#if F_BT_LE_4_2_SC_SUPPORT
/**
* @brief Send user confirmation request to confirm result to upper stack
* @param[in] conn_id Connection ID.
* @param[in] cause User confirm result.
* @return Operation result.
* @retval GAP_CAUSE_SUCCESS Operation success.
* @retval GAP_CAUSE_NON_CONN Operation failure. No connection.
*
* Example usage
* \code{.c}
void app_handle_gap_msg(T_IO_MSG *p_io_msg)
{
T_LE_GAP_MSG bt_msg;
uint8_t conn_id;
memcpy(&bt_msg, &p_io_msg->u.param, sizeof(p_io_msg->u.param));
switch (p_io_msg->subtype)
{
...
case GAP_MSG_LE_BOND_USER_CONFIRMATION:
{
uint32_t display_value = 0;
conn_id = gap_msg.msg_data.gap_bond_user_conf.conn_id;
le_bond_get_display_key(conn_id, &display_value);
APP_PRINT_INFO1("GAP_MSG_LE_BOND_USER_CONFIRMATION: passkey %d", display_value);
le_bond_user_confirm(conn_id, GAP_CFM_CAUSE_ACCEPT);
}
break;
...
}
...
}
* \endcode
*/
T_GAP_CAUSE le_bond_user_confirm(uint8_t conn_id, T_GAP_CFM_CAUSE cause);
#endif
#if F_BT_LE_4_2_KEY_PRESS_SUPPORT
/**
* @brief Send keypress notification to upper stack
* @param[in] conn_id Connection ID.
* @param[in] type Keypress notify type @ref T_GAP_KEYPRESS_NOTIF_TYPE.
* @return Operation result.
* @retval GAP_CAUSE_SUCCESS Operation success.
* @retval GAP_CAUSE_NON_CONN Operation failure. No connection.
*
* Example usage
* \code{.c}
T_APP_RESULT app_gap_callback(uint8_t cb_type, void *p_cb_data)
{
T_APP_RESULT result = APP_RESULT_SUCCESS;
T_LE_CB_DATA cb_data;
memcpy(&cb_data, p_cb_data, sizeof(T_LE_CB_DATA));
APP_PRINT_TRACE1("app_gap_callback: cb_type = %d", cb_type);
switch (cb_type)
{
...
case GAP_MSG_LE_KEYPRESS_NOTIFY:
APP_PRINT_INFO2("GAP_MSG_LE_KEYPRESS_NOTIFY:conn %d, cause 0x%x",
cb_data.p_le_keypress_notify_rsp->conn_id, cb_data.p_le_keypress_notify_rsp->cause);
break;
case GAP_MSG_LE_KEYPRESS_NOTIFY_INFO:
APP_PRINT_INFO2("GAP_MSG_LE_KEYPRESS_NOTIFY_INFO:conn %d, type 0x%x",
cb_data.p_le_keypress_notify_info->conn_id, cb_data.p_le_keypress_notify_info->event_type);
break;
...
}
}
* \endcode
*/
T_GAP_CAUSE le_bond_keypress_notify(uint8_t conn_id, T_GAP_KEYPRESS_NOTIF_TYPE type);
#endif
/**
* @brief Set local key distribution field
* @param[in] init_dist Initiator key distribution.
* @param[in] rsp_dist Responder key distribution.
* @return Operation result.
* @retval GAP_CAUSE_SUCCESS Operation success.
* @retval Others Operation failure. No connection.
*
* Example usage
* \code{.c}
static T_USER_CMD_PARSE_RESULT cmd_setkeydis(T_USER_CMD_PARSED_VALUE *p_parse_value)
{
uint8_t init_dist = p_parse_value->dw_param[0];
uint8_t rsp_dist = p_parse_value->dw_param[1];
le_bond_cfg_local_key_distribute(init_dist, rsp_dist);
return (RESULT_SUCESS);
}
* \endcode
*/
T_GAP_CAUSE le_bond_cfg_local_key_distribute(uint8_t init_dist, uint8_t rsp_dist);
#if F_BT_LE_4_2_SC_OOB_SUPPORT
/**
* @brief Initialize local Out of Band data.
*
* @note APP should call this API if OOB for LE Secure Connections pairing will be used.
*
* @param[in] p_ecc_rand_in Pointer to ecc rand.
* @param[in] local_rand Pointer to local rand.
* @param[in,out] p_local_oob_data Pointer to local oob data.
* @return Operation result.
* @retval GAP_CAUSE_SUCCESS Operation success.
* @retval Others Operation failure.
*
* Example usage
* \code{.c}
void test(void)
{
T_GAP_CAUSE ret;
uint64_t ecc_rand_in[4];
uint8_t local_rand[16];
// APP set parameters value according to requirements
if (idx == 1)
{
ret = le_bond_sc_local_oob_init(NULL, local_rand, &local_oob_data);
}
else
{
ret = le_bond_sc_local_oob_init(ecc_rand_in, local_rand, &local_oob_data);
}
}
* \endcode
*/
T_GAP_CAUSE le_bond_sc_local_oob_init(uint64_t *p_ecc_rand_in, uint8_t *local_rand,
T_GAP_LE_LOCAL_OOB_DATA *p_local_oob_data);
/**
* @brief Initialize peer Out of Band data.
* @param[in] p_peer_oob_data Pointer to peer Out of Band data.
* @return Operation result.
* @retval GAP_CAUSE_SUCCESS Operation success.
* @retval Others Operation failure.
*
* Example usage
* \code{.c}
void test(void)
{
T_GAP_CAUSE ret;
T_GAP_LE_PEER_OOB_DATA peer_oob_data;
uint8_t bd_addr[6];
uint8_t confirmation[16];
uint8_t random_number[16];
// APP set parameters value according to requirements
peer_oob_data.present = peer_oob_data_present_flag;
memcpy(peer_oob_data.rand, random_number, 16);
memcpy(peer_oob_data.confirm, confirmation, 16);
memcpy(peer_oob_data.bd_addr_from, bd_addr, 6);
ret = le_bond_sc_peer_oob_init(&peer_oob_data);
// APP call gap_set_param(GAP_PARAM_BOND_OOB_ENABLED,), and value is same as value of peer_oob_data.present
// APP call gap_set_pairable_mode()
}
* \endcode
*/
T_GAP_CAUSE le_bond_sc_peer_oob_init(T_GAP_LE_PEER_OOB_DATA *p_peer_oob_data);
#endif
/**
* @brief Erase all link keys of bonded devices
* @return void
*
* Example usage
* \code{.c}
T_APP_RESULT app_gap_callback(uint8_t cb_type, void *p_cb_data)
{
T_APP_RESULT result = APP_RESULT_SUCCESS;
T_LE_CB_DATA *p_data = (T_LE_CB_DATA *)p_cb_data;
switch (cb_type)
{
...
#if APP_PRIVACY_EN
case GAP_MSG_LE_BOND_MODIFY_INFO:
APP_PRINT_INFO1("GAP_MSG_LE_BOND_MODIFY_INFO: type 0x%x",
p_data->p_le_bond_modify_info->type);
privacy_handle_bond_modify_msg(p_data->p_le_bond_modify_info->type,
p_data->p_le_bond_modify_info->p_entry, true);
break;
#endif
...
}
}
void privacy_handle_bond_modify_msg(T_LE_BOND_MODIFY_TYPE type, T_LE_KEY_ENTRY *p_entry,
bool handle_add)
{
APP_PRINT_INFO1("[PRIVACY] privacy_handle_bond_modify_msg: type 0x%x", type);
if (type == LE_BOND_CLEAR)
{
privacy_modify_resolving_list(GAP_RESOLV_LIST_OP_CLEAR, GAP_IDENT_ADDR_PUBLIC, NULL, false);
}
else if (type == LE_BOND_DELETE)
{
if (p_entry->flags & LE_KEY_STORE_REMOTE_IRK_BIT)
{
privacy_modify_resolving_list(GAP_RESOLV_LIST_OP_REMOVE,
(T_GAP_IDENT_ADDR_TYPE)p_entry->resolved_remote_bd.remote_bd_type,
p_entry->resolved_remote_bd.addr, false);
}
else
{
privacy_modify_resolving_list(GAP_RESOLV_LIST_OP_REMOVE,
(T_GAP_IDENT_ADDR_TYPE)p_entry->remote_bd.remote_bd_type,
p_entry->remote_bd.addr, false);
}
}
else if (type == LE_BOND_ADD)
{
if (handle_add)
{
privacy_add_device(p_entry);
}
}
privacy_handle_resolv_list();
}
* \endcode
*/
void le_bond_clear_all_keys(void);
/**
* @brief Delete bond information by index
* @param[in] idx Index of key entry.
* @return Operation result.
* @retval GAP_CAUSE_SUCCESS: Operation success.
* @retval GAP_CAUSE_NOT_FIND: Operation failure. Not found.
*
* Example usage
* \code{.c}
T_APP_RESULT app_gap_callback(uint8_t cb_type, void *p_cb_data)
{
T_APP_RESULT result = APP_RESULT_SUCCESS;
T_LE_CB_DATA *p_data = (T_LE_CB_DATA *)p_cb_data;
switch (cb_type)
{
...
#if APP_PRIVACY_EN
case GAP_MSG_LE_BOND_MODIFY_INFO:
APP_PRINT_INFO1("GAP_MSG_LE_BOND_MODIFY_INFO: type 0x%x",
p_data->p_le_bond_modify_info->type);
privacy_handle_bond_modify_msg(p_data->p_le_bond_modify_info->type,
p_data->p_le_bond_modify_info->p_entry, true);
break;
#endif
...
}
}
void privacy_handle_bond_modify_msg(T_LE_BOND_MODIFY_TYPE type, T_LE_KEY_ENTRY *p_entry,
bool handle_add)
{
APP_PRINT_INFO1("[PRIVACY] privacy_handle_bond_modify_msg: type 0x%x", type);
if (type == LE_BOND_CLEAR)
{
privacy_modify_resolving_list(GAP_RESOLV_LIST_OP_CLEAR, GAP_IDENT_ADDR_PUBLIC, NULL, false);
}
else if (type == LE_BOND_DELETE)
{
if (p_entry->flags & LE_KEY_STORE_REMOTE_IRK_BIT)
{
privacy_modify_resolving_list(GAP_RESOLV_LIST_OP_REMOVE,
(T_GAP_IDENT_ADDR_TYPE)p_entry->resolved_remote_bd.remote_bd_type,
p_entry->resolved_remote_bd.addr, false);
}
else
{
privacy_modify_resolving_list(GAP_RESOLV_LIST_OP_REMOVE,
(T_GAP_IDENT_ADDR_TYPE)p_entry->remote_bd.remote_bd_type,
p_entry->remote_bd.addr, false);
}
}
else if (type == LE_BOND_ADD)
{
if (handle_add)
{
privacy_add_device(p_entry);
}
}
privacy_handle_resolv_list();
}
* \endcode
*/
T_GAP_CAUSE le_bond_delete_by_idx(uint8_t idx);
/**
* @brief Delete bond information by bluetooth device address and address type
* @param[in] bd_addr Bonded bluetooth device address.
* @param[in] bd_type Bonded bluetooth device address type.
* @return Operation result.
* @retval GAP_CAUSE_SUCCESS: Operation success.
* @retval GAP_CAUSE_NOT_FIND: Operation failure. Not found.
*
* Example usage
* \code{.c}
T_APP_RESULT app_gap_callback(uint8_t cb_type, void *p_cb_data)
{
T_APP_RESULT result = APP_RESULT_SUCCESS;
T_LE_CB_DATA *p_data = (T_LE_CB_DATA *)p_cb_data;
switch (cb_type)
{
...
#if APP_PRIVACY_EN
case GAP_MSG_LE_BOND_MODIFY_INFO:
APP_PRINT_INFO1("GAP_MSG_LE_BOND_MODIFY_INFO: type 0x%x",
p_data->p_le_bond_modify_info->type);
privacy_handle_bond_modify_msg(p_data->p_le_bond_modify_info->type,
p_data->p_le_bond_modify_info->p_entry, true);
break;
#endif
...
}
}
void privacy_handle_bond_modify_msg(T_LE_BOND_MODIFY_TYPE type, T_LE_KEY_ENTRY *p_entry,
bool handle_add)
{
APP_PRINT_INFO1("[PRIVACY] privacy_handle_bond_modify_msg: type 0x%x", type);
if (type == LE_BOND_CLEAR)
{
privacy_modify_resolving_list(GAP_RESOLV_LIST_OP_CLEAR, GAP_IDENT_ADDR_PUBLIC, NULL, false);
}
else if (type == LE_BOND_DELETE)
{
if (p_entry->flags & LE_KEY_STORE_REMOTE_IRK_BIT)
{
privacy_modify_resolving_list(GAP_RESOLV_LIST_OP_REMOVE,
(T_GAP_IDENT_ADDR_TYPE)p_entry->resolved_remote_bd.remote_bd_type,
p_entry->resolved_remote_bd.addr, false);
}
else
{
privacy_modify_resolving_list(GAP_RESOLV_LIST_OP_REMOVE,
(T_GAP_IDENT_ADDR_TYPE)p_entry->remote_bd.remote_bd_type,
p_entry->remote_bd.addr, false);
}
}
else if (type == LE_BOND_ADD)
{
if (handle_add)
{
privacy_add_device(p_entry);
}
}
privacy_handle_resolv_list();
}
* \endcode
*/
T_GAP_CAUSE le_bond_delete_by_bd(uint8_t *bd_addr, T_GAP_REMOTE_ADDR_TYPE bd_type);
/**
* @brief Get the security level.
* @param[in] conn_id Connection ID.
* @param[out] p_type Pointer to location to get the security level.
* @return Operation result.
* @retval GAP_CAUSE_SUCCESS Operation success.
* @retval GAP_CAUSE_INVALID_PARAM Operation failure. No connection.
*
* Example usage
* \code{.c}
static T_USER_CMD_PARSE_RESULT cmd_seclevel(T_USER_CMD_PARSED_VALUE *p_parse_value)
{
T_GAP_CAUSE cause;
T_GAP_SEC_LEVEL sec_level;
uint8_t conn_id = p_parse_value->dw_param[0];
cause = le_bond_get_sec_level(conn_id, &sec_level);
if(sec_level == GAP_SEC_LEVEL_NO)
{
data_uart_print("GAP_SEC_LEVEL_NO\r\n");
}
else if(sec_level == GAP_SEC_LEVEL_UNAUTHEN)
{
data_uart_print("GAP_SEC_LEVEL_UNAUTHEN\r\n");
}
else if(sec_level == GAP_SEC_LEVEL_AUTHEN)
{
data_uart_print("GAP_SEC_LEVEL_AUTHEN\r\n");
}
else if(sec_level == GAP_SEC_LEVEL_SC_UNAUTHEN)
{
data_uart_print("GAP_SEC_LEVEL_SC_UNAUTHEN\r\n");
}
else if(sec_level == GAP_SEC_LEVEL_SC_AUTHEN)
{
data_uart_print("GAP_SEC_LEVEL_SC_AUTHEN\r\n");
}
return (T_USER_CMD_PARSE_RESULT)cause;
}
* \endcode
*/
T_GAP_CAUSE le_bond_get_sec_level(uint8_t conn_id, T_GAP_SEC_LEVEL *p_type);
#if F_BT_LE_APP_KEY_MANAGER
T_GAP_CAUSE le_bond_authen_result_confirm(uint8_t *bd_addr, T_GAP_REMOTE_ADDR_TYPE remote_addr_type,
T_GAP_KEY_TYPE key_type, T_GAP_CFM_CAUSE cause);
T_GAP_CAUSE le_bond_authen_key_req_confirm(uint8_t *bd_addr,
T_GAP_REMOTE_ADDR_TYPE remote_addr_type,
uint8_t key_len, uint8_t *p_key, T_GAP_KEY_TYPE key_type,
T_GAP_CFM_CAUSE cause);
T_GAP_CAUSE le_bond_gatt_server_store_confirm(T_GATT_STORE_OPCODE op, uint8_t *bd_addr,
T_GAP_REMOTE_ADDR_TYPE remote_addr_type,
uint8_t data_len, uint8_t *data, T_GAP_CFM_CAUSE cause);
#endif
#if F_BT_LE_GATT_CCCD_DATA_PENDING
bool le_bond_set_cccd_data_pending(T_LE_KEY_ENTRY *p_entry, uint16_t handle, bool data_pending);
#endif
/** End of GAP_LE_BONDMGR_Exported_Functions
* @}
*/
/** End of GAP_LE_Bond_Manager
* @}
*/
#ifdef __cplusplus
}
#endif
#endif /* GAP_BOND_LE_H */