tSMP_INT_DATA union

* Function smp_key_distribution * Description start key distribution if required.

* Function smp_send_rand * Description send pairing random to the peer

CLASSIC_BT_INCLUDED == TRUE * Function smp_key_distribution_by_transport * Description depending on the transport used at the moment calls either * smp_key_distribution(...) or smp_br_key_distribution(...).

* Function SMP_SEND_COMMITMENT * Description send commitment command to the peer

* Function smp_decide_association_model * Description This function is called to select assoc model to be used for * STK generation and to start STK generation process.

* Function smp_generate_srand_mrand_confirm * Description This function is called to start the second pairing phase by * start generating random number. * Returns void

* Function smp_generate_passkey * Description This function is called to generate passkey. * Returns void

* Function smp_send_app_cback * Description notifies application about the events the application is interested in

* Function smp_send_id_info * Description send ID information command.

* Function smp_send_pair_rsp * Description actions related to sending pairing response

* Function smp_br_select_next_key * Description selects the next key to derive/send when BR/EDR transport is * used.

* Function smp_generate_ltk_cont * Description This function is to calculate LTK = d1(ER, DIV, 0)= e(ER, DIV) * Returns void

* Function smp_generate_compare * Description This function is called to generate SConfirm for Slave device, * or MSlave for Master device. This function can be also used for * generating Compare number for confirm value check. * Returns void

* Function smp_generate_stk * Description This function is called to generate STK calculated by running * AES with the TK value as key and a concatenation of the random * values. * Returns void

* Function smp_generate_ltk * Description This function is called: * - in legacy pairing - to calculate LTK, starting with DIV * generation; * - in LE Secure Connections pairing over LE transport - to process LTK * already generated to encrypt LE link; * - in LE Secure Connections pairing over BR/EDR transport - to start * BR/EDR Link Key processing. * Returns void

* Function smp_generate_rand_cont * Description This function is called to generate another 64 bits random for * MRand or Srand. * Returns void

* Function smp_use_oob_private_key * Description This function is called * - to save the secret key used to calculate the public key used * in calculations of commitment sent OOB to a peer * - to use this secret key to recalculate the public key and * start the process of sending this public key to the peer * if secret/public keys have to be reused. * If the keys aren't supposed to be reused, continue from the * point from which request for OOB data was issued. * Returns void

* Function smp_send_pair_req * Description actions related to sending pairing request

* Function smp_send_pair_fail * Description pairing failure to peer device if needed.

* Function smp_send_pair_public_key * Description send pairing public key command to the peer

* Function smp_proc_pair_fail * Description process pairing failure from peer device

* Function smp_proc_enc_info * Description process identity information from peer device

* Function smp_proc_id_addr * Description process identity address from peer device

* Function smp_pair_terminate * Description This function is called to send the pairing complete callback * and remove the connection if needed.

* Function smp_idle_terminate * Description This function calledin idle state to determine to send authentication * complete or not.

* Function smp_proc_srk_info * Description process security information from peer device

* Function smp_key_pick_key * Description Pick a key distribution function based on the key mask.

* Function smp_wait_for_both_public_keys * Description generates SMP_BOTH_PUBL_KEYS_RCVD_EVT event when both local and master * public keys are available. * Note on the slave it is used to prevent race condition.

* Function smp_process_secure_connection_oob_data * Description Processes local/peer SC OOB data received from somewhere.

* Function smp_br_send_pair_response * Description actions related to sending pairing response over BR/EDR transport.

* Function smp_generate_confirm * Description This function is called when a 48 bits random number is generated * as SRand or MRand, continue to calculate Sconfirm or MConfirm. * Returns void

* Function smp_generate_y * Description This function is to proceed generate Y = E(DHK, Rand) * Returns void

* Function smp_generate_rand_vector * Description This function is called when LTK is generated, send state machine * event to SMP. * Returns void

* Function smp_create_private_key * Description This function is called to create private key used to * calculate public key and DHKey. * The function starts private key creation requesting controller * to generate [0-7] octets of private key. * Returns void

* Function smp_calculate_numeric_comparison_display_number * Description The function calculates and saves number to display in numeric * comparison association mode. * Returns void

* Function smp_calculate_local_dhkey_check * Description The function calculates and saves local device DHKey check * value in CB. * Before doing this it calls smp_calculate_f5_mackey_and_long_term_key(...). * to calculate MacKey and LTK. * MacKey is used in dhkey calculation. * Returns void

* Function smp_calculate_peer_dhkey_check * Description The function calculates peer device DHKey check value. * Returns void

* Function smp_send_confirm * Description send confirmation to the peer

* Function smp_send_dhkey_check * Description send DHKey Check command to the peer

* Function smp_send_keypress_notification * Description send Keypress Notification command to the peer

BLE_INCLUDED == TRUE * Function smp_proc_confirm * Description process pairing confirm from peer device

* Function smp_proc_rand * Description process pairing random (nonce) from peer device

* Function smp_process_pairing_public_key * Description process pairing public key command from the peer device * - saves the peer public key; * - sets the flag indicating that the peer public key is received; * - calls smp_wait_for_both_public_keys(...).

CLASSIC_BT_INCLUDED == TRUE * Function smp_proc_enc_info * Description process encryption information from peer device

BLE_INCLUDED == TRUE * Function smp_proc_master_id * Description process master ID from slave device

BLE_INCLUDED == TRUE * Function smp_proc_sec_grant * Description process security grant.

* Function smp_proc_sec_req * Description process security request.

* Function smp_proc_sl_key * Description process key ready events.

* Function smp_start_enc * Description start encryption

* Function smp_enc_cmpl * Description encryption success

BLE_INCLUDED == TRUE * Function smp_proc_discard * Description processing for discard security request

* Function smp_pairing_cmpl * Description This function is called to send the pairing complete callback * and remove the connection if needed.

* Function smp_proc_compare * Description process compare value

* Function smp_check_auth_req * Description check authentication request

* Function smp_process_io_response * Description process IO response for a slave device.

* Function smp_send_enc_info * Description send encryption information command.

* Function smp_send_csrk_info * Description send CSRK command.

* Function smp_send_ltk_reply * Description send LTK reply

* Function smp_proc_pair_cmd * Description Process the SMP pairing request/response from peer device

* Function smp_generate_csrk * Description This function is called to calculate CSRK, starting with DIV * generation. * Returns void

* Function smp_fast_conn_param * Description apply default connection parameter for pairing process

* Function smp_both_have_public_keys * Description The function is called when both local and peer public keys are * saved. * Actions: * - invokes DHKey computation; * - on slave side invokes sending local public key to the peer. * - invokes SC phase 1 process.

* Function smp_start_secure_connection_phase1 * Description The function starts Secure Connection phase1 i.e. invokes initialization of Secure Connection * phase 1 parameters and starts building/sending to the peer * messages appropriate for the role and association model.

* Function smp_process_local_nonce * Description The function processes new local nonce. * Note It is supposed to be called in SC phase1.

* Function smp_process_pairing_commitment * Description process pairing commitment from peer device

* Function smp_process_peer_nonce * Description The function processes newly received and saved in CB peer nonce. * The actions depend on the selected association model and the role. * Note It is supposed to be called in SC phase1.

* Function smp_process_dhkey_check * Description process DHKey Check from peer device

BLE_INCLUDED == TRUE * Function smp_match_dhkey_checks * Description checks if the calculated peer DHKey Check value is the same as * received from the peer DHKey check value.

* Function smp_process_keypress_notification * Description process pairing keypress notification from peer device

* Function smp_move_to_secure_connections_phase2 * Description Signal State Machine to start SC phase 2 initialization (to * compute local DHKey Check value). * Note SM is supposed to be in the state SMP_STATE_SEC_CONN_PHS2_START.

* Function smp_phase_2_dhkey_checks_are_present * Description generates event if dhkey check from the peer is already received. * Note It is supposed to be used on slave to prevent race condition. * It is supposed to be called after slave dhkey check is calculated.

* Function smp_start_passkey_verification * Description Starts SC passkey entry verification.

* Function smp_set_local_oob_keys * Description Saves calculated private/public keys in sc_oob_data.loc_oob_data, * starts nonce generation * (to be saved in sc_oob_data.loc_oob_data.randomizer).

* Function smp_set_local_oob_random_commitment * Description Saves calculated randomizer and commitment in sc_oob_data.loc_oob_data, * passes sc_oob_data.loc_oob_data up for safekeeping.

* Function smp_set_derive_link_key * Description This function is called to set flag that indicates that * BR/EDR LK has to be derived from LTK after all keys are * distributed. * Returns void

* Function smp_derive_link_key_from_long_term_key * Description This function is called to derive BR/EDR LK from LTK. * Returns void

* Function smp_br_process_pairing_command * Description Process the SMP pairing request/response from peer device via * BR/EDR transport.

* Function smp_br_process_security_grant * Description process security grant in case of pairing over BR/EDR transport.

BLE_INCLUDED == TRUE * Function smp_br_process_slave_keys_response * Description process application keys response for a slave device * (BR/EDR transport).

* Function smp_br_check_authorization_request * Description sets the SMP kes to be derived/distribute over BR/EDR transport * before starting the distribution/derivation

BLE_INCLUDED == TRUE * Function smp_br_process_link_key * Description This function is called to process BR/EDR LK: * - to derive SMP LTK from BR/EDR LK; 8 - to save SMP LTK. * Returns void

* Function smp_br_pairing_complete * Description This function is called to send the pairing complete callback * and remove the connection if needed.

* Function smp_compute_csrk * Description This function is called to calculate CSRK * Returns void