smp_int.h 25 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545
  1. /******************************************************************************
  2. *
  3. * Copyright (C) 1999-2012 Broadcom Corporation
  4. *
  5. * Licensed under the Apache License, Version 2.0 (the "License");
  6. * you may not use this file except in compliance with the License.
  7. * You may obtain a copy of the License at:
  8. *
  9. * http://www.apache.org/licenses/LICENSE-2.0
  10. *
  11. * Unless required by applicable law or agreed to in writing, software
  12. * distributed under the License is distributed on an "AS IS" BASIS,
  13. * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  14. * See the License for the specific language governing permissions and
  15. * limitations under the License.
  16. *
  17. ******************************************************************************/
  18. /******************************************************************************
  19. *
  20. * This file contains internally used SMP definitions
  21. *
  22. ******************************************************************************/
  23. #ifndef SMP_INT_H
  24. #define SMP_INT_H
  25. // #if (SMP_INCLUDED == TRUE)
  26. #include "stack/btu.h"
  27. #include "stack/btm_ble_api.h"
  28. #include "stack/btm_api.h"
  29. #include "stack/smp_api.h"
  30. #define SMP_MODEL_ENCRYPTION_ONLY 0 /* Legacy mode, Just Works model */
  31. #define SMP_MODEL_PASSKEY 1 /* Legacy mode, Passkey Entry model, this side inputs the key */
  32. #define SMP_MODEL_OOB 2 /* Legacy mode, OOB model */
  33. #define SMP_MODEL_KEY_NOTIF 3 /* Legacy mode, Passkey Entry model, this side displays the key */
  34. #define SMP_MODEL_SEC_CONN_JUSTWORKS 4 /* Secure Connections mode, Just Works model */
  35. #define SMP_MODEL_SEC_CONN_NUM_COMP 5 /* Secure Connections mode, Numeric Comparison model */
  36. #define SMP_MODEL_SEC_CONN_PASSKEY_ENT 6 /* Secure Connections mode, Passkey Entry model, */
  37. /* this side inputs the key */
  38. #define SMP_MODEL_SEC_CONN_PASSKEY_DISP 7 /* Secure Connections mode, Passkey Entry model, */
  39. /* this side displays the key */
  40. #define SMP_MODEL_SEC_CONN_OOB 8 /* Secure Connections mode, OOB model */
  41. #define SMP_MODEL_OUT_OF_RANGE 9
  42. typedef UINT8 tSMP_ASSO_MODEL;
  43. #ifndef SMP_MAX_CONN
  44. #define SMP_MAX_CONN 2
  45. #endif
  46. #define SMP_WAIT_FOR_RSP_TOUT 30
  47. #define SMP_OPCODE_INIT 0x04
  48. /* SMP events */
  49. #define SMP_PAIRING_REQ_EVT SMP_OPCODE_PAIRING_REQ
  50. #define SMP_PAIRING_RSP_EVT SMP_OPCODE_PAIRING_RSP
  51. #define SMP_CONFIRM_EVT SMP_OPCODE_CONFIRM
  52. #define SMP_RAND_EVT SMP_OPCODE_RAND
  53. #define SMP_PAIRING_FAILED_EVT SMP_OPCODE_PAIRING_FAILED
  54. #define SMP_ENCRPTION_INFO_EVT SMP_OPCODE_ENCRYPT_INFO
  55. #define SMP_MASTER_ID_EVT SMP_OPCODE_MASTER_ID
  56. #define SMP_ID_INFO_EVT SMP_OPCODE_IDENTITY_INFO
  57. #define SMP_ID_ADDR_EVT SMP_OPCODE_ID_ADDR
  58. #define SMP_SIGN_INFO_EVT SMP_OPCODE_SIGN_INFO
  59. #define SMP_SECURITY_REQ_EVT SMP_OPCODE_SEC_REQ
  60. #define SMP_PAIR_PUBLIC_KEY_EVT SMP_OPCODE_PAIR_PUBLIC_KEY
  61. #define SMP_PAIR_KEYPRESS_NOTIFICATION_EVT SMP_OPCODE_PAIR_KEYPR_NOTIF
  62. #define SMP_PAIR_COMMITM_EVT SMP_OPCODE_PAIR_COMMITM
  63. #define SMP_SELF_DEF_EVT (SMP_PAIR_COMMITM_EVT + 1)
  64. #define SMP_KEY_READY_EVT (SMP_SELF_DEF_EVT)
  65. #define SMP_ENCRYPTED_EVT (SMP_SELF_DEF_EVT + 1)
  66. #define SMP_L2CAP_CONN_EVT (SMP_SELF_DEF_EVT + 2)
  67. #define SMP_L2CAP_DISCONN_EVT (SMP_SELF_DEF_EVT + 3)
  68. #define SMP_IO_RSP_EVT (SMP_SELF_DEF_EVT + 4)
  69. #define SMP_API_SEC_GRANT_EVT (SMP_SELF_DEF_EVT + 5)
  70. #define SMP_TK_REQ_EVT (SMP_SELF_DEF_EVT + 6)
  71. #define SMP_AUTH_CMPL_EVT (SMP_SELF_DEF_EVT + 7)
  72. #define SMP_ENC_REQ_EVT (SMP_SELF_DEF_EVT + 8)
  73. #define SMP_BOND_REQ_EVT (SMP_SELF_DEF_EVT + 9)
  74. #define SMP_DISCARD_SEC_REQ_EVT (SMP_SELF_DEF_EVT + 10)
  75. #define SMP_PAIR_DHKEY_CHCK_EVT SMP_OPCODE_PAIR_DHKEY_CHECK
  76. #define SMP_PUBL_KEY_EXCH_REQ_EVT (SMP_SELF_DEF_EVT + 11) /* request to start public */
  77. /* key exchange */
  78. #define SMP_LOC_PUBL_KEY_CRTD_EVT (SMP_SELF_DEF_EVT + 12) /* local public key created */
  79. #define SMP_BOTH_PUBL_KEYS_RCVD_EVT (SMP_SELF_DEF_EVT + 13) /* both local and peer public */
  80. /* keys are saved in cb */
  81. #define SMP_SC_DHKEY_CMPLT_EVT (SMP_SELF_DEF_EVT + 14) /* DHKey computation is completed,*/
  82. /* time to start SC phase1 */
  83. #define SMP_HAVE_LOC_NONCE_EVT (SMP_SELF_DEF_EVT + 15) /* new local nonce is generated */
  84. /*and saved in p_cb->rand */
  85. #define SMP_SC_PHASE1_CMPLT_EVT (SMP_SELF_DEF_EVT + 16) /* time to start SC phase2 */
  86. #define SMP_SC_CALC_NC_EVT (SMP_SELF_DEF_EVT + 17) /* request to calculate number */
  87. /* for user check. Used only in the */
  88. /* numeric compare protocol */
  89. /* Request to display the number for user check to the user.*/
  90. /* Used only in the numeric compare protocol */
  91. #define SMP_SC_DSPL_NC_EVT (SMP_SELF_DEF_EVT + 18)
  92. #define SMP_SC_NC_OK_EVT (SMP_SELF_DEF_EVT + 19) /* user confirms 'OK' numeric */
  93. /*comparison request */
  94. /* both local and peer DHKey Checks are already present - it is used on slave to prevent race condition */
  95. #define SMP_SC_2_DHCK_CHKS_PRES_EVT (SMP_SELF_DEF_EVT + 20)
  96. /* same meaning as SMP_KEY_READY_EVT to separate between SC and legacy actions */
  97. #define SMP_SC_KEY_READY_EVT (SMP_SELF_DEF_EVT + 21)
  98. #define SMP_KEYPRESS_NOTIFICATION_EVENT (SMP_SELF_DEF_EVT + 22)
  99. #define SMP_SC_OOB_DATA_EVT (SMP_SELF_DEF_EVT + 23) /* SC OOB data from some */
  100. /* repository is provided */
  101. #define SMP_CR_LOC_SC_OOB_DATA_EVT (SMP_SELF_DEF_EVT + 24)
  102. #define SMP_MAX_EVT SMP_CR_LOC_SC_OOB_DATA_EVT
  103. typedef UINT8 tSMP_EVENT;
  104. /* Assumption it's only using the low 8 bits, if bigger than that, need to expand it to 16 bits */
  105. #define SMP_SEC_KEY_MASK 0x00ff
  106. #define SMP_PASSKEY_MASK 0xfff00000
  107. /* SMP pairing state */
  108. enum {
  109. SMP_STATE_IDLE,
  110. SMP_STATE_WAIT_APP_RSP,
  111. SMP_STATE_SEC_REQ_PENDING,
  112. SMP_STATE_PAIR_REQ_RSP,
  113. SMP_STATE_WAIT_CONFIRM,
  114. SMP_STATE_CONFIRM,
  115. SMP_STATE_RAND,
  116. SMP_STATE_PUBLIC_KEY_EXCH,
  117. SMP_STATE_SEC_CONN_PHS1_START,
  118. SMP_STATE_WAIT_COMMITMENT,
  119. SMP_STATE_WAIT_NONCE,
  120. SMP_STATE_SEC_CONN_PHS2_START,
  121. SMP_STATE_WAIT_DHK_CHECK,
  122. SMP_STATE_DHK_CHECK,
  123. SMP_STATE_ENCRYPTION_PENDING,
  124. SMP_STATE_BOND_PENDING,
  125. SMP_STATE_CREATE_LOCAL_SEC_CONN_OOB_DATA,
  126. SMP_STATE_MAX
  127. };
  128. typedef UINT8 tSMP_STATE;
  129. /* SMP over BR/EDR events */
  130. #define SMP_BR_PAIRING_REQ_EVT SMP_OPCODE_PAIRING_REQ
  131. #define SMP_BR_PAIRING_RSP_EVT SMP_OPCODE_PAIRING_RSP
  132. #define SMP_BR_CONFIRM_EVT SMP_OPCODE_CONFIRM /* not expected over BR/EDR */
  133. #define SMP_BR_RAND_EVT SMP_OPCODE_RAND /* not expected over BR/EDR */
  134. #define SMP_BR_PAIRING_FAILED_EVT SMP_OPCODE_PAIRING_FAILED
  135. #define SMP_BR_ENCRPTION_INFO_EVT SMP_OPCODE_ENCRYPT_INFO /* not expected over BR/EDR */
  136. #define SMP_BR_MASTER_ID_EVT SMP_OPCODE_MASTER_ID /* not expected over BR/EDR */
  137. #define SMP_BR_ID_INFO_EVT SMP_OPCODE_IDENTITY_INFO
  138. #define SMP_BR_ID_ADDR_EVT SMP_OPCODE_ID_ADDR
  139. #define SMP_BR_SIGN_INFO_EVT SMP_OPCODE_SIGN_INFO
  140. #define SMP_BR_SECURITY_REQ_EVT SMP_OPCODE_SEC_REQ /* not expected over BR/EDR */
  141. #define SMP_BR_PAIR_PUBLIC_KEY_EVT SMP_OPCODE_PAIR_PUBLIC_KEY /* not expected over BR/EDR */
  142. #define SMP_BR_PAIR_DHKEY_CHCK_EVT SMP_OPCODE_PAIR_DHKEY_CHECK /* not expected over BR/EDR */
  143. #define SMP_BR_PAIR_KEYPR_NOTIF_EVT SMP_OPCODE_PAIR_KEYPR_NOTIF /* not expected over BR/EDR */
  144. #define SMP_BR_SELF_DEF_EVT SMP_BR_PAIR_KEYPR_NOTIF_EVT
  145. #define SMP_BR_KEY_READY_EVT (SMP_BR_SELF_DEF_EVT + 1)
  146. #define SMP_BR_ENCRYPTED_EVT (SMP_BR_SELF_DEF_EVT + 2)
  147. #define SMP_BR_L2CAP_CONN_EVT (SMP_BR_SELF_DEF_EVT + 3)
  148. #define SMP_BR_L2CAP_DISCONN_EVT (SMP_BR_SELF_DEF_EVT + 4)
  149. #define SMP_BR_KEYS_RSP_EVT (SMP_BR_SELF_DEF_EVT + 5)
  150. #define SMP_BR_API_SEC_GRANT_EVT (SMP_BR_SELF_DEF_EVT + 6)
  151. #define SMP_BR_TK_REQ_EVT (SMP_BR_SELF_DEF_EVT + 7)
  152. #define SMP_BR_AUTH_CMPL_EVT (SMP_BR_SELF_DEF_EVT + 8)
  153. #define SMP_BR_ENC_REQ_EVT (SMP_BR_SELF_DEF_EVT + 9)
  154. #define SMP_BR_BOND_REQ_EVT (SMP_BR_SELF_DEF_EVT + 10)
  155. #define SMP_BR_DISCARD_SEC_REQ_EVT (SMP_BR_SELF_DEF_EVT + 11)
  156. #define SMP_BR_MAX_EVT (SMP_BR_SELF_DEF_EVT + 12)
  157. typedef UINT8 tSMP_BR_EVENT;
  158. /* SMP over BR/EDR pairing states */
  159. enum {
  160. SMP_BR_STATE_IDLE = SMP_STATE_IDLE,
  161. SMP_BR_STATE_WAIT_APP_RSP,
  162. SMP_BR_STATE_PAIR_REQ_RSP,
  163. SMP_BR_STATE_BOND_PENDING,
  164. SMP_BR_STATE_MAX
  165. };
  166. typedef UINT8 tSMP_BR_STATE;
  167. /* random and encrption activity state */
  168. enum {
  169. SMP_GEN_COMPARE = 1,
  170. SMP_GEN_CONFIRM,
  171. SMP_GEN_DIV_LTK,
  172. SMP_GEN_DIV_CSRK,
  173. SMP_GEN_RAND_V,
  174. SMP_GEN_TK,
  175. SMP_GEN_SRAND_MRAND,
  176. SMP_GEN_SRAND_MRAND_CONT,
  177. SMP_GENERATE_PRIVATE_KEY_0_7,
  178. SMP_GENERATE_PRIVATE_KEY_8_15,
  179. SMP_GENERATE_PRIVATE_KEY_16_23,
  180. SMP_GENERATE_PRIVATE_KEY_24_31,
  181. SMP_GEN_NONCE_0_7,
  182. SMP_GEN_NONCE_8_15
  183. };
  184. enum {
  185. SMP_KEY_TYPE_TK,
  186. SMP_KEY_TYPE_CFM,
  187. SMP_KEY_TYPE_CMP,
  188. SMP_KEY_TYPE_PEER_DHK_CHCK,
  189. SMP_KEY_TYPE_STK,
  190. SMP_KEY_TYPE_LTK
  191. };
  192. typedef struct {
  193. UINT8 key_type;
  194. UINT8 *p_data;
  195. } tSMP_KEY;
  196. typedef union {
  197. UINT8 *p_data; /* UINT8 type data pointer */
  198. tSMP_KEY key;
  199. UINT16 reason;
  200. UINT32 passkey;
  201. tSMP_OOB_DATA_TYPE req_oob_type;
  202. } tSMP_INT_DATA;
  203. /* internal status mask */
  204. #define SMP_PAIR_FLAGS_WE_STARTED_DD (1)
  205. #define SMP_PAIR_FLAGS_PEER_STARTED_DD (1 << 1)
  206. #define SMP_PAIR_FLAGS_CMD_CONFIRM (1 << SMP_OPCODE_CONFIRM) /* 1 << 3 */
  207. #define SMP_PAIR_FLAG_ENC_AFTER_PAIR (1 << 4)
  208. #define SMP_PAIR_FLAG_HAVE_PEER_DHK_CHK (1 << 5) /* used on slave to resolve race condition */
  209. #define SMP_PAIR_FLAG_HAVE_PEER_PUBL_KEY (1 << 6) /* used on slave to resolve race condition */
  210. #define SMP_PAIR_FLAG_HAVE_PEER_COMM (1 << 7) /* used to resolve race condition */
  211. #define SMP_PAIR_FLAG_HAVE_LOCAL_PUBL_KEY (1 << 8) /* used on slave to resolve race condition */
  212. /* check if authentication requirement need MITM protection */
  213. #define SMP_NO_MITM_REQUIRED(x) (((x) & SMP_AUTH_YN_BIT) == 0)
  214. #define SMP_ENCRYT_KEY_SIZE 16
  215. #define SMP_ENCRYT_DATA_SIZE 16
  216. #define SMP_ECNCRPYT_STATUS HCI_SUCCESS
  217. typedef struct {
  218. BD_ADDR bd_addr;
  219. BT_HDR *p_copy;
  220. } tSMP_REQ_Q_ENTRY;
  221. /* SMP control block */
  222. typedef struct {
  223. tSMP_CALLBACK *p_callback;
  224. TIMER_LIST_ENT rsp_timer_ent;
  225. UINT8 trace_level;
  226. BD_ADDR pairing_bda;
  227. tSMP_STATE state;
  228. BOOLEAN derive_lk;
  229. BOOLEAN id_addr_rcvd;
  230. tBLE_ADDR_TYPE id_addr_type;
  231. BD_ADDR id_addr;
  232. BOOLEAN smp_over_br;
  233. tSMP_BR_STATE br_state; /* if SMP over BR/ERD has priority over SMP */
  234. UINT8 failure;
  235. UINT8 status;
  236. UINT8 role;
  237. UINT16 flags;
  238. UINT8 cb_evt;
  239. tSMP_SEC_LEVEL sec_level;
  240. BOOLEAN connect_initialized;
  241. BT_OCTET16 confirm;
  242. BT_OCTET16 rconfirm;
  243. BT_OCTET16 rrand; /* for SC this is peer nonce */
  244. BT_OCTET16 rand; /* for SC this is local nonce */
  245. BT_OCTET32 private_key;
  246. BT_OCTET32 dhkey;
  247. BT_OCTET16 commitment;
  248. BT_OCTET16 remote_commitment;
  249. BT_OCTET16 local_random; /* local randomizer - passkey or OOB randomizer */
  250. BT_OCTET16 peer_random; /* peer randomizer - passkey or OOB randomizer */
  251. BT_OCTET16 dhkey_check;
  252. BT_OCTET16 remote_dhkey_check;
  253. tSMP_PUBLIC_KEY loc_publ_key;
  254. tSMP_PUBLIC_KEY peer_publ_key;
  255. tSMP_OOB_DATA_TYPE req_oob_type;
  256. tSMP_SC_OOB_DATA sc_oob_data;
  257. tSMP_IO_CAP peer_io_caps;
  258. tSMP_IO_CAP local_io_capability;
  259. tSMP_OOB_FLAG peer_oob_flag;
  260. tSMP_OOB_FLAG loc_oob_flag;
  261. tSMP_AUTH_REQ peer_auth_req;
  262. tSMP_AUTH_REQ loc_auth_req;
  263. tSMP_AUTH_REQ auth_mode;
  264. BOOLEAN secure_connections_only_mode_required;/* TRUE if locally SM is required to operate */
  265. /* either in Secure Connections mode or not at all */
  266. tSMP_ASSO_MODEL selected_association_model;
  267. BOOLEAN le_secure_connections_mode_is_used;
  268. BOOLEAN le_sc_kp_notif_is_used;
  269. tSMP_SC_KEY_TYPE local_keypress_notification;
  270. tSMP_SC_KEY_TYPE peer_keypress_notification;
  271. UINT8 round; /* authentication stage 1 round for passkey association model */
  272. UINT32 number_to_display;
  273. BT_OCTET16 mac_key;
  274. UINT8 peer_enc_size;
  275. UINT8 loc_enc_size;
  276. UINT8 peer_i_key;
  277. UINT8 peer_r_key;
  278. UINT8 local_i_key;
  279. UINT8 local_r_key;
  280. BT_OCTET16 tk;
  281. BT_OCTET16 ltk;
  282. UINT16 div;
  283. BT_OCTET16 csrk; /* storage for local CSRK */
  284. UINT16 ediv;
  285. BT_OCTET8 enc_rand;
  286. UINT8 rand_enc_proc_state;
  287. UINT8 addr_type;
  288. BD_ADDR local_bda;
  289. BOOLEAN is_pair_cancel;
  290. BOOLEAN discard_sec_req;
  291. UINT8 rcvd_cmd_code;
  292. UINT8 rcvd_cmd_len;
  293. UINT16 total_tx_unacked;
  294. BOOLEAN wait_for_authorization_complete;
  295. BOOLEAN use_static_passkey;
  296. UINT32 static_passkey;
  297. BOOLEAN accept_specified_sec_auth;
  298. tSMP_AUTH_REQ origin_loc_auth_req;
  299. } tSMP_CB;
  300. /* Server Action functions are of this type */
  301. typedef void (*tSMP_ACT)(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  302. #ifdef __cplusplus
  303. extern "C"
  304. {
  305. #endif
  306. #if SMP_DYNAMIC_MEMORY == FALSE
  307. extern tSMP_CB smp_cb;
  308. #else
  309. extern tSMP_CB *smp_cb_ptr;
  310. #define smp_cb (*smp_cb_ptr)
  311. #endif
  312. #ifdef __cplusplus
  313. }
  314. #endif
  315. /* Functions provided by att_main.c */
  316. extern void smp_init (void);
  317. /* smp main */
  318. extern void smp_sm_event(tSMP_CB *p_cb, tSMP_EVENT event, void *p_data);
  319. extern void smp_proc_sec_request(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  320. extern void smp_set_fail_nc (BOOLEAN enable);
  321. extern void smp_set_fail_conf (BOOLEAN enable);
  322. extern void smp_set_passk_entry_fail(BOOLEAN enable);
  323. extern void smp_set_oob_fail(BOOLEAN enable);
  324. extern void smp_set_peer_sc_notif(BOOLEAN enable);
  325. extern void smp_aes_cmac_rfc4493_chk (UINT8 *key, UINT8 *msg, UINT8 msg_len,
  326. UINT8 mac_len, UINT8 *mac);
  327. extern void smp_f4_calc_chk (UINT8 *U, UINT8 *V, UINT8 *X, UINT8 *Z, UINT8 *mac);
  328. extern void smp_g2_calc_chk (UINT8 *U, UINT8 *V, UINT8 *X, UINT8 *Y);
  329. extern void smp_h6_calc_chk (UINT8 *key, UINT8 *key_id, UINT8 *mac);
  330. extern void smp_f5_key_calc_chk (UINT8 *w, UINT8 *mac);
  331. extern void smp_f5_mackey_or_ltk_calc_chk(UINT8 *t, UINT8 *counter,
  332. UINT8 *key_id, UINT8 *n1,
  333. UINT8 *n2, UINT8 *a1, UINT8 *a2,
  334. UINT8 *length, UINT8 *mac);
  335. extern void smp_f5_calc_chk (UINT8 *w, UINT8 *n1, UINT8 *n2, UINT8 *a1, UINT8 *a2,
  336. UINT8 *mac_key, UINT8 *ltk);
  337. extern void smp_f6_calc_chk (UINT8 *w, UINT8 *n1, UINT8 *n2, UINT8 *r,
  338. UINT8 *iocap, UINT8 *a1, UINT8 *a2, UINT8 *mac);
  339. /* smp_main */
  340. extern void smp_sm_event(tSMP_CB *p_cb, tSMP_EVENT event, void *p_data);
  341. extern tSMP_STATE smp_get_state(void);
  342. extern void smp_set_state(tSMP_STATE state);
  343. /* smp_br_main */
  344. extern void smp_br_state_machine_event(tSMP_CB *p_cb, tSMP_BR_EVENT event, void *p_data);
  345. extern tSMP_BR_STATE smp_get_br_state(void);
  346. extern void smp_set_br_state(tSMP_BR_STATE state);
  347. /* smp_act.c */
  348. extern void smp_send_pair_req(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  349. extern void smp_send_confirm(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  350. extern void smp_send_pair_fail(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  351. extern void smp_send_rand(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  352. extern void smp_send_pair_public_key(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  353. extern void smp_send_commitment(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  354. extern void smp_send_dhkey_check(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  355. extern void smp_send_keypress_notification(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  356. extern void smp_proc_pair_fail(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  357. extern void smp_proc_confirm(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  358. extern void smp_proc_rand(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  359. extern void smp_process_pairing_public_key(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  360. extern void smp_proc_enc_info(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  361. extern void smp_proc_master_id(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  362. extern void smp_proc_id_info(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  363. extern void smp_proc_id_addr(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  364. extern void smp_proc_sec_grant(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  365. extern void smp_proc_sec_req(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  366. extern void smp_proc_sl_key(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  367. extern void smp_start_enc(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  368. extern void smp_enc_cmpl(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  369. extern void smp_proc_discard(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  370. extern void smp_pairing_cmpl(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  371. extern void smp_decide_association_model(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  372. extern void smp_send_app_cback(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  373. extern void smp_proc_compare(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  374. extern void smp_check_auth_req(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  375. extern void smp_process_io_response(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  376. extern void smp_send_id_info(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  377. extern void smp_send_enc_info(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  378. extern void smp_send_csrk_info(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  379. extern void smp_send_ltk_reply(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  380. extern void smp_proc_pair_cmd(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  381. extern void smp_pair_terminate(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  382. extern void smp_idle_terminate(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  383. extern void smp_send_pair_rsp(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  384. extern void smp_key_distribution(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  385. extern void smp_proc_srk_info(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  386. extern void smp_generate_csrk(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  387. extern void smp_fast_conn_param(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  388. extern void smp_key_pick_key(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  389. extern void smp_both_have_public_keys(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  390. extern void smp_start_secure_connection_phase1(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  391. extern void smp_process_local_nonce(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  392. extern void smp_process_pairing_commitment(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  393. extern void smp_process_peer_nonce(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  394. extern void smp_process_dhkey_check(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  395. extern void smp_match_dhkey_checks(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  396. extern void smp_process_keypress_notification(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  397. extern void smp_move_to_secure_connections_phase2(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  398. extern void smp_phase_2_dhkey_checks_are_present(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  399. extern void smp_wait_for_both_public_keys(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  400. extern void smp_start_passkey_verification(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  401. extern void smp_process_secure_connection_oob_data(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  402. extern void smp_process_secure_connection_long_term_key(void);
  403. extern void smp_set_local_oob_keys(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  404. extern void smp_set_local_oob_random_commitment(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  405. extern void smp_set_derive_link_key(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  406. extern void smp_derive_link_key_from_long_term_key(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  407. extern void smp_br_process_pairing_command(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  408. extern void smp_br_process_security_grant(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  409. extern void smp_br_process_slave_keys_response(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  410. extern void smp_br_send_pair_response(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  411. extern void smp_br_check_authorization_request(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  412. extern void smp_br_select_next_key(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  413. extern void smp_br_process_link_key(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  414. extern void smp_key_distribution_by_transport(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  415. extern void smp_br_pairing_complete(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  416. /* smp_l2c */
  417. extern void smp_l2cap_if_init (void);
  418. extern void smp_data_ind (BD_ADDR bd_addr, BT_HDR *p_buf);
  419. /* smp_util.c */
  420. extern BOOLEAN smp_send_cmd(UINT8 cmd_code, tSMP_CB *p_cb);
  421. extern void smp_cb_cleanup(tSMP_CB *p_cb);
  422. extern void smp_reset_control_value(tSMP_CB *p_cb);
  423. extern void smp_proc_pairing_cmpl(tSMP_CB *p_cb);
  424. extern void smp_convert_string_to_tk(BT_OCTET16 tk, UINT32 passkey);
  425. extern void smp_mask_enc_key(UINT8 loc_enc_size, UINT8 *p_data);
  426. extern void smp_rsp_timeout(TIMER_LIST_ENT *p_tle);
  427. extern void smp_xor_128(BT_OCTET16 a, const BT_OCTET16 b);
  428. extern BOOLEAN smp_encrypt_data (UINT8 *key, UINT8 key_len,
  429. UINT8 *plain_text, UINT8 pt_len,
  430. tSMP_ENC *p_out);
  431. extern BOOLEAN smp_command_has_invalid_parameters(tSMP_CB *p_cb);
  432. extern void smp_reject_unexpected_pairing_command(BD_ADDR bd_addr);
  433. extern tSMP_ASSO_MODEL smp_select_association_model(tSMP_CB *p_cb);
  434. extern void smp_reverse_array(UINT8 *arr, UINT8 len);
  435. extern UINT8 smp_calculate_random_input(UINT8 *random, UINT8 round);
  436. extern void smp_collect_local_io_capabilities(UINT8 *iocap, tSMP_CB *p_cb);
  437. extern void smp_collect_peer_io_capabilities(UINT8 *iocap, tSMP_CB *p_cb);
  438. extern void smp_collect_local_ble_address(UINT8 *le_addr, tSMP_CB *p_cb);
  439. extern void smp_collect_peer_ble_address(UINT8 *le_addr, tSMP_CB *p_cb);
  440. extern BOOLEAN smp_check_commitment(tSMP_CB *p_cb);
  441. extern void smp_save_secure_connections_long_term_key(tSMP_CB *p_cb);
  442. extern BOOLEAN smp_calculate_f5_mackey_and_long_term_key(tSMP_CB *p_cb);
  443. extern void smp_remove_fixed_channel(tSMP_CB *p_cb);
  444. extern BOOLEAN smp_request_oob_data(tSMP_CB *p_cb);
  445. /* smp_keys.c */
  446. extern void smp_generate_srand_mrand_confirm (tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  447. extern void smp_generate_compare (tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  448. extern void smp_generate_stk (tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  449. extern void smp_generate_ltk(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  450. extern void smp_generate_passkey (tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  451. extern void smp_generate_rand_cont(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  452. extern void smp_create_private_key(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  453. extern void smp_use_oob_private_key(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  454. extern void smp_compute_dhkey(tSMP_CB *p_cb);
  455. extern void smp_calculate_local_commitment(tSMP_CB *p_cb);
  456. extern void smp_calculate_peer_commitment(tSMP_CB *p_cb, BT_OCTET16 output_buf);
  457. extern void smp_calculate_numeric_comparison_display_number(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  458. extern void smp_calculate_local_dhkey_check(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  459. extern void smp_calculate_peer_dhkey_check(tSMP_CB *p_cb, tSMP_INT_DATA *p_data);
  460. extern void smp_start_nonce_generation(tSMP_CB *p_cb);
  461. extern BOOLEAN smp_calculate_link_key_from_long_term_key(tSMP_CB *p_cb);
  462. extern BOOLEAN smp_calculate_long_term_key_from_link_key(tSMP_CB *p_cb);
  463. extern void smp_calculate_f4(UINT8 *u, UINT8 *v, UINT8 *x, UINT8 z, UINT8 *c);
  464. extern UINT32 smp_calculate_g2(UINT8 *u, UINT8 *v, UINT8 *x, UINT8 *y);
  465. extern BOOLEAN smp_calculate_f5(UINT8 *w, UINT8 *n1, UINT8 *n2, UINT8 *a1, UINT8 *a2,
  466. UINT8 *mac_key, UINT8 *ltk);
  467. extern BOOLEAN smp_calculate_f5_mackey_or_long_term_key(UINT8 *t, UINT8 *counter,
  468. UINT8 *key_id, UINT8 *n1, UINT8 *n2, UINT8 *a1,
  469. UINT8 *a2, UINT8 *length, UINT8 *mac);
  470. extern BOOLEAN smp_calculate_f5_key(UINT8 *w, UINT8 *t);
  471. extern BOOLEAN smp_calculate_f6(UINT8 *w, UINT8 *n1, UINT8 *n2, UINT8 *r, UINT8 *iocap,
  472. UINT8 *a1, UINT8 *a2, UINT8 *f3);
  473. extern BOOLEAN smp_calculate_h6(UINT8 *w, UINT8 *keyid, UINT8 *h2);
  474. extern void smp_save_local_oob_data(tSMP_CB *p_cb);
  475. extern void smp_clear_local_oob_data(void);
  476. extern tSMP_LOC_OOB_DATA *smp_get_local_oob_data(void);
  477. #if SMP_DEBUG == TRUE
  478. extern void smp_debug_print_nbyte_little_endian (UINT8 *p, const UINT8 *key_name,
  479. UINT8 len);
  480. #endif
  481. /* smp_cmac.c */
  482. extern BOOLEAN aes_cipher_msg_auth_code(BT_OCTET16 key, UINT8 *input, UINT16 length,
  483. UINT16 tlen, UINT8 *p_signature);
  484. extern void print128(BT_OCTET16 x, const UINT8 *key_name);
  485. // #endif ///BLE_INCLUDED == TRUE && SMP_INCLUDED == TRUE
  486. #endif /* SMP_INT_H */