btm_sec_dd_create_conn() function

* Function btm_sec_dev_rec_cback_event * Description This function calls the callback function with the given * result and clear the callback function. * Parameters: void

* S T A T I C F U N C T I O N S * Function btm_sec_execute_procedure * Description This function is called to start required security * procedure. There is a case when multiplexing protocol * calls this function on the originating side, connection to * the peer will not be established. This function in this * case performs only authorization. * Returns BTM_SUCCESS - permission is granted * BTM_CMD_STARTED - in process * BTM_NO_RESOURCES - permission declined

* Function btm_dev_encrypted * Description check device is encrypted * Returns BOOLEAN TRUE or FALSE

* Function btm_dev_authorized * Description check device is authorized * Returns BOOLEAN TRUE or FALSE

SMP_INCLUDED == TRUE * Function btm_serv_trusted * Description check service is trusted * Returns BOOLEAN TRUE or FALSE

disconnect the ACL link, if it's not done yet.

SMP_INCLUDED == TRUE * Function btm_ble_init_pseudo_addr * Description This function is used to initialize pseudo address. * If pseudo address is not available, use dummy address * Returns TRUE is updated; FALSE otherwise.

* Function btm_dev_authenticated * Description check device is authenticated * Returns BOOLEAN TRUE or FALSE

SMP_INCLUDED == TRUE * Function btm_sec_clear_ble_keys * Description This function is called to clear out the BLE keys. * Typically when devices are removed in BTM_SecDeleteDevice, * or when a new BT Link key is generated. * Returns void

* Function btm_sec_start_authentication * Description This function is called to start authentication * Returns TRUE if started

* Function btm_send_link_key_notif * Description This function is called when controller requests link key * Returns Pointer to the record or NULL

* Function btm_ble_addr_resolvable * Description This function checks if a RPA is resolvable by the device key. * Returns TRUE is resolvable; FALSE otherwise.

* Function btm_ble_resolving_list_load_dev * Description This function add a device which is using RPA into white list * Parameters pointer to device security record * Returns TRUE if device added, otherwise falase.

* Function btm_sec_set_peer_sec_caps * Description This function is called to set sm4 and rmt_sec_caps fields * based on the available peer device features. * Returns void

CLASSIC_BT_INCLUDED == TRUE * I N T E R N A L F U N C T I O N S * Function btm_sec_is_upgrade_possible * Description This function returns TRUE if the existing link key * can be upgraded or if the link key does not exist. * Returns BOOLEAN

* Function btm_sec_check_pending_enc_req * Description This function is called to send pending encryption callback if * waiting * Returns void

BLE_INCLUDED == TRUE * Function btm_sec_use_smp_br_chnl * Description The function checks if SMP BR connection can be used with * the peer. * Is called when authentication for dedicated bonding is * successfully completed. * Returns TRUE - if SMP BR connection can be used (the link key is * generated from P-256 and the peer supports Security * Manager over BR).

* Function btm_sec_is_master * Description The function checks if the device is BR/EDR master after * pairing is completed. * Returns TRUE - if the device is master.

* Function btm_sec_start_get_name * Description This function is called to start get name procedure * Returns TRUE if started

* Function btm_cont_rswitch * Description This function is called to continue processing an active * role switch. It first disables encryption if enabled and * EPR is not supported * Returns void

* Function btm_ble_read_resolving_list_entry * Description This function read an IRK entry by index * Parameters entry index. * Returns status

* Function btm_ble_resolving_list_remove_dev * Description This function removes the device from resolving list * Parameters * Returns status

* Function btm_sec_free_dev * Description Mark device record as not used

* Function btm_consolidate_dev * Description combine security records if identified as same peer * Returns none

SMP_INCLUDED == TRUE * Function btm_sec_check_upgrade * Description This function is called to check if the existing link key * needs to be upgraded. * Returns void

* Function btm_dev_16_digit_authenticated * Description check device is authenticated by using 16 digit pin or MITM * Returns BOOLEAN TRUE or FALSE

* Function btm_sec_start_encryption * Description This function is called to start encryption * Returns TRUE if started

* Function btm_sec_start_authorization * Description This function is called to start authorization * Returns TRUE if started

* Function btm_sec_find_bonded_dev * Description Find a bonded device starting from the specified index * Returns TRUE - found a bonded device

* Function btm_sec_legacy_authentication_mutual * Description This function is called when legacy authentication is used * and only remote device has completed the authentication * Returns TRUE if authentication command sent successfully

* Function btm_ble_get_acl_remote_addr * Description This function reads the active remote address used for the * connection. * Returns success return TRUE, otherwise FALSE.

* Function btm_ble_io_capabilities_req * Description This function is called to handle SMP get IO capability request. * Returns void

SMP_INCLUDED == TRUE * Function btm_ble_br_keys_req * Description This function is called to handle SMP request for keys sent * over BR/EDR. * Returns void

* Function btm_ble_match_random_bda * Description This function match the random address to the appointed device * record, starting from calculating IRK. If record index exceed * the maximum record number, matching failed and send callback. * Returns None.

* Function btm_ble_remove_resolving_list_entry * Description This function to remove an IRK entry from the list * Parameters ble_addr_type: address type * ble_addr: LE address * Returns status

SMP_INCLUDED == TRUE