| /****************************************************************************** |
| * |
| * Copyright (C) 1999-2012 Broadcom Corporation |
| * |
| * 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. |
| * |
| ******************************************************************************/ |
| |
| /****************************************************************************** |
| * |
| * This file contains internally used SMP definitions |
| * |
| ******************************************************************************/ |
| |
| #ifndef SMP_INT_H |
| #define SMP_INT_H |
| |
| #include "btu.h" |
| #include "smp_api.h" |
| |
| #define SMP_MODEL_ENC_ONLY 0 |
| #define SMP_MODEL_PASSKEY 1 |
| #define SMP_MODEL_OOB 2 |
| #define SMP_MODEL_KEY_NOTIF 3 |
| #define SMP_MODEL_MAX 4 |
| typedef UINT8 tSMP_ASSO_MODEL; |
| |
| |
| #ifndef SMP_MAX_CONN |
| #define SMP_MAX_CONN 2 |
| #endif |
| |
| #define SMP_WAIT_FOR_RSP_TOUT 30 |
| #define SMP_WAIT_FOR_REL_DELAY_TOUT 5 |
| /* SMP L2CAP command code */ |
| #define SMP_OPCODE_PAIRING_REQ 0x01 |
| #define SMP_OPCODE_PAIRING_RSP 0x02 |
| #define SMP_OPCODE_CONFIRM 0x03 |
| #define SMP_OPCODE_INIT 0x04 |
| #define SMP_OPCODE_PAIRING_FAILED 0x05 |
| #define SMP_OPCODE_ENCRYPT_INFO 0x06 |
| #define SMP_OPCODE_MASTER_ID 0x07 |
| #define SMP_OPCODE_IDENTITY_INFO 0x08 |
| #define SMP_OPCODE_ID_ADDR 0x09 |
| #define SMP_OPCODE_SIGN_INFO 0x0A |
| #define SMP_OPCODE_SEC_REQ 0x0B |
| #define SMP_OPCODE_MAX (SMP_OPCODE_SEC_REQ + 1) |
| |
| /* SMP events */ |
| #define SMP_PAIRING_REQ_EVT SMP_OPCODE_PAIRING_REQ |
| #define SMP_PAIRING_RSP_EVT SMP_OPCODE_PAIRING_RSP |
| #define SMP_CONFIRM_EVT SMP_OPCODE_CONFIRM |
| #define SMP_RAND_EVT SMP_OPCODE_INIT |
| #define SMP_PAIRING_FAILED_EVT SMP_OPCODE_PAIRING_FAILED |
| #define SMP_ENCRPTION_INFO_EVT SMP_OPCODE_ENCRYPT_INFO |
| #define SMP_MASTER_ID_EVT SMP_OPCODE_MASTER_ID |
| #define SMP_ID_INFO_EVT SMP_OPCODE_IDENTITY_INFO |
| #define SMP_ID_ADDR_EVT SMP_OPCODE_ID_ADDR |
| #define SMP_SIGN_INFO_EVT SMP_OPCODE_SIGN_INFO |
| #define SMP_SECURITY_REQ_EVT SMP_OPCODE_SEC_REQ |
| |
| #define SMP_SELF_DEF_EVT SMP_SECURITY_REQ_EVT |
| #define SMP_KEY_READY_EVT (SMP_SELF_DEF_EVT + 1) |
| #define SMP_ENCRYPTED_EVT (SMP_SELF_DEF_EVT + 2) |
| #define SMP_L2CAP_CONN_EVT (SMP_SELF_DEF_EVT + 3) |
| #define SMP_L2CAP_DISCONN_EVT (SMP_SELF_DEF_EVT + 4) |
| #define SMP_IO_RSP_EVT (SMP_SELF_DEF_EVT + 5) |
| #define SMP_API_SEC_GRANT_EVT (SMP_SELF_DEF_EVT + 6) |
| #define SMP_TK_REQ_EVT (SMP_SELF_DEF_EVT + 7) |
| #define SMP_AUTH_CMPL_EVT (SMP_SELF_DEF_EVT + 8) |
| #define SMP_ENC_REQ_EVT (SMP_SELF_DEF_EVT + 9) |
| #define SMP_BOND_REQ_EVT (SMP_SELF_DEF_EVT + 10) |
| #define SMP_DISCARD_SEC_REQ_EVT (SMP_SELF_DEF_EVT + 11) |
| #define SMP_RELEASE_DELAY_EVT (SMP_SELF_DEF_EVT + 12) |
| #define SMP_RELEASE_DELAY_TOUT_EVT (SMP_SELF_DEF_EVT + 13) |
| typedef UINT8 tSMP_EVENT; |
| #define SMP_MAX_EVT SMP_RELEASE_DELAY_TOUT_EVT + 1 |
| |
| /* auumption it's only using the low 8 bits, if bigger than that, need to expand it to be 16 bits */ |
| #define SMP_SEC_KEY_MASK 0x00ff |
| |
| /* SMP pairing state */ |
| enum |
| { |
| SMP_ST_IDLE, |
| SMP_ST_WAIT_APP_RSP, |
| SMP_ST_SEC_REQ_PENDING, |
| SMP_ST_PAIR_REQ_RSP, |
| SMP_ST_WAIT_CONFIRM, |
| SMP_ST_CONFIRM, |
| SMP_ST_RAND, |
| SMP_ST_ENC_PENDING, |
| SMP_ST_BOND_PENDING, |
| SMP_ST_RELEASE_DELAY, |
| SMP_ST_MAX |
| }; |
| typedef UINT8 tSMP_STATE; |
| |
| /* random and encrption activity state */ |
| enum |
| { |
| SMP_GEN_COMPARE = 1, |
| SMP_GEN_CONFIRM, |
| |
| SMP_GEN_DIV_LTK, |
| SMP_GEN_DIV_CSRK, |
| SMP_GEN_RAND_V, |
| SMP_GEN_TK, |
| SMP_GEN_SRAND_MRAND, |
| SMP_GEN_SRAND_MRAND_CONT |
| }; |
| |
| enum |
| { |
| SMP_KEY_TYPE_TK, |
| SMP_KEY_TYPE_CFM, |
| SMP_KEY_TYPE_CMP, |
| SMP_KEY_TYPE_STK, |
| SMP_KEY_TYPE_LTK |
| }; |
| typedef struct |
| { |
| UINT8 key_type; |
| UINT8* p_data; |
| }tSMP_KEY; |
| |
| typedef union |
| { |
| UINT8 *p_data; /* UINT8 type data pointer */ |
| tSMP_KEY key; |
| UINT16 reason; |
| }tSMP_INT_DATA; |
| |
| /* internal status mask */ |
| #define SMP_PAIR_FLAGS_WE_STARTED_DD (1) |
| #define SMP_PAIR_FLAGS_PEER_STARTED_DD (1 << 1) |
| #define SMP_PAIR_FLAGS_CMD_CONFIRM (1 << SMP_OPCODE_CONFIRM) /* 1 << 3 */ |
| #define SMP_PAIR_FLAG_ENC_AFTER_PAIR (1 << 4) |
| |
| /* check if authentication requirement need MITM protection */ |
| #define SMP_NO_MITM_REQUIRED(x) (((x) & SMP_AUTH_YN_BIT) == 0) |
| |
| #define SMP_ENCRYT_KEY_SIZE 16 |
| #define SMP_ENCRYT_DATA_SIZE 16 |
| #define SMP_ECNCRPYT_STATUS HCI_SUCCESS |
| |
| /* SMP control block */ |
| typedef struct |
| { |
| tSMP_CALLBACK *p_callback; |
| TIMER_LIST_ENT rsp_timer_ent; |
| UINT8 trace_level; |
| |
| BD_ADDR pairing_bda; |
| |
| tSMP_STATE state; |
| UINT8 failure; |
| UINT8 status; |
| UINT8 role; |
| UINT8 flags; |
| UINT8 cb_evt; |
| |
| tSMP_SEC_LEVEL sec_level; |
| BOOLEAN connect_initialized; |
| BT_OCTET16 confirm; |
| BT_OCTET16 rconfirm; |
| BT_OCTET16 rrand; |
| BT_OCTET16 rand; |
| tSMP_IO_CAP peer_io_caps; |
| tSMP_IO_CAP loc_io_caps; |
| tSMP_OOB_FLAG peer_oob_flag; |
| tSMP_OOB_FLAG loc_oob_flag; |
| tSMP_AUTH_REQ peer_auth_req; |
| tSMP_AUTH_REQ loc_auth_req; |
| UINT8 peer_enc_size; |
| UINT8 loc_enc_size; |
| UINT8 peer_i_key; |
| UINT8 peer_r_key; |
| UINT8 loc_i_key; |
| UINT8 loc_r_key; |
| |
| BT_OCTET16 tk; |
| BT_OCTET16 ltk; |
| UINT16 div; |
| BT_OCTET16 csrk; /* storage for local CSRK */ |
| UINT16 ediv; |
| BT_OCTET8 enc_rand; |
| |
| UINT8 rand_enc_proc; |
| BOOLEAN last_cmd; |
| UINT8 addr_type; |
| BD_ADDR local_bda; |
| BOOLEAN is_pair_cancel; |
| BOOLEAN discard_sec_req; |
| UINT8 rcvd_cmd_code; |
| UINT8 rcvd_cmd_len; |
| #if SMP_CONFORMANCE_TESTING == TRUE |
| BOOLEAN enable_test_confirm_val; |
| BT_OCTET16 test_confirm; |
| BOOLEAN enable_test_rand_val; |
| BT_OCTET16 test_rand; |
| BOOLEAN enable_test_pair_fail; |
| UINT8 pair_fail_status; |
| BOOLEAN remove_fixed_channel_disable; |
| BOOLEAN skip_test_compare_check; |
| #endif |
| |
| }tSMP_CB; |
| |
| /* Server Action functions are of this type */ |
| typedef void (*tSMP_ACT)(tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| |
| |
| #ifdef __cplusplus |
| extern "C" |
| { |
| #endif |
| |
| #if SMP_DYNAMIC_MEMORY == FALSE |
| SMP_API extern tSMP_CB smp_cb; |
| #else |
| SMP_API extern tSMP_CB *smp_cb_ptr; |
| #define smp_cb (*smp_cb_ptr) |
| #endif |
| |
| #ifdef __cplusplus |
| } |
| #endif |
| |
| /* Functions provided by att_main.c */ |
| SMP_API extern void smp_init (void); |
| |
| #if SMP_CONFORMANCE_TESTING == TRUE |
| /* Used only for conformance testing */ |
| SMP_API extern void smp_set_test_confirm_value (BOOLEAN enable, UINT8 *p_c_value); |
| SMP_API extern void smp_set_test_rand_value (BOOLEAN enable, UINT8 *p_c_value); |
| SMP_API extern void smp_set_test_pair_fail_status (BOOLEAN enable, UINT8 status); |
| SMP_API extern void smp_remove_fixed_channel_disable (BOOLEAN disable); |
| SMP_API extern void smp_skip_compare_check (BOOLEAN enable); |
| #endif |
| /* smp main */ |
| extern void smp_sm_event(tSMP_CB *p_cb, tSMP_EVENT event, void *p_data); |
| |
| extern void smp_proc_sec_request(tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| extern void smp_send_pair_req(tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| extern void smp_send_confirm(tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| extern void smp_send_pair_fail(tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| extern void smp_send_init(tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| extern void smp_proc_sec_request(tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| extern void smp_proc_pair_fail(tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| extern void smp_proc_confirm(tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| extern void smp_proc_init(tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| extern void smp_proc_enc_info(tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| extern void smp_proc_master_id(tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| extern void smp_proc_id_info(tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| extern void smp_proc_id_addr(tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| extern void smp_proc_sec_grant(tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| extern void smp_proc_sec_req(tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| extern void smp_proc_sl_key(tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| extern void smp_start_enc(tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| extern void smp_enc_cmpl(tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| extern void smp_proc_discard(tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| extern void smp_proc_release_delay(tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| extern void smp_proc_release_delay_tout(tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| extern void smp_pairing_cmpl(tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| extern void smp_decide_asso_model(tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| extern void smp_send_app_cback(tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| extern void smp_proc_compare(tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| extern void smp_check_auth_req(tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| extern void smp_proc_io_rsp(tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| extern void smp_send_id_info(tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| extern void smp_send_enc_info(tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| extern void smp_send_csrk_info(tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| extern void smp_send_ltk_reply(tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| extern void smp_proc_pair_cmd(tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| extern void smp_pair_terminate(tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| extern void smp_idle_terminate(tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| extern void smp_send_pair_rsp(tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| extern void smp_key_distribution(tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| extern void smp_proc_srk_info(tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| extern void smp_generate_csrk(tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| extern void smp_delay_terminate(tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| extern void smp_fast_conn_param(tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| |
| /* smp_l2c */ |
| extern void smp_l2cap_if_init (void); |
| |
| /* smp utility */ |
| extern BOOLEAN smp_send_cmd(UINT8 cmd_code, tSMP_CB *p_cb); |
| extern void smp_cb_cleanup(tSMP_CB *p_cb); |
| extern void smp_reset_control_value(tSMP_CB *p_cb); |
| extern void smp_proc_pairing_cmpl(tSMP_CB *p_cb); |
| extern void smp_convert_string_to_tk(BT_OCTET16 tk, UINT32 passkey); |
| extern void smp_mask_enc_key(UINT8 loc_enc_size, UINT8 * p_data); |
| extern void smp_rsp_timeout(TIMER_LIST_ENT *p_tle); |
| extern void smp_xor_128(BT_OCTET16 a, BT_OCTET16 b); |
| extern BOOLEAN smp_encrypt_data (UINT8 *key, UINT8 key_len, |
| UINT8 *plain_text, UINT8 pt_len, |
| tSMP_ENC *p_out); |
| /* smp key */ |
| extern void smp_generate_confirm (tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| extern void smp_generate_compare (tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| extern void smp_generate_stk (tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| extern void smp_generate_ltk(tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| extern void smp_generate_passkey (tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| extern void smp_genenrate_rand_cont(tSMP_CB *p_cb, tSMP_INT_DATA *p_data); |
| |
| /* smp main util */ |
| extern void smp_set_state(tSMP_STATE state); |
| extern tSMP_STATE smp_get_state(void); |
| extern void smp_reject_unexp_pair_req(BD_ADDR bd_addr); |
| |
| #endif /* SMP_INT_H */ |
| |
