smp.h 5.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212
  1. /*
  2. BlueZ - Bluetooth protocol stack for Linux
  3. Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies).
  4. This program is free software; you can redistribute it and/or modify
  5. it under the terms of the GNU General Public License version 2 as
  6. published by the Free Software Foundation;
  7. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
  8. OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  9. FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS.
  10. IN NO EVENT SHALL THE COPYRIGHT HOLDER(S) AND AUTHOR(S) BE LIABLE FOR ANY
  11. CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES
  12. WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  13. ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  14. OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  15. ALL LIABILITY, INCLUDING LIABILITY FOR INFRINGEMENT OF ANY PATENTS,
  16. COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS, RELATING TO USE OF THIS
  17. SOFTWARE IS DISCLAIMED.
  18. */
  19. #ifndef __SMP_H
  20. #define __SMP_H
  21. struct smp_command_hdr {
  22. __u8 code;
  23. } __packed;
  24. #define SMP_CMD_PAIRING_REQ 0x01
  25. #define SMP_CMD_PAIRING_RSP 0x02
  26. struct smp_cmd_pairing {
  27. __u8 io_capability;
  28. __u8 oob_flag;
  29. __u8 auth_req;
  30. __u8 max_key_size;
  31. __u8 init_key_dist;
  32. __u8 resp_key_dist;
  33. } __packed;
  34. #define SMP_IO_DISPLAY_ONLY 0x00
  35. #define SMP_IO_DISPLAY_YESNO 0x01
  36. #define SMP_IO_KEYBOARD_ONLY 0x02
  37. #define SMP_IO_NO_INPUT_OUTPUT 0x03
  38. #define SMP_IO_KEYBOARD_DISPLAY 0x04
  39. #define SMP_OOB_NOT_PRESENT 0x00
  40. #define SMP_OOB_PRESENT 0x01
  41. #define SMP_DIST_ENC_KEY 0x01
  42. #define SMP_DIST_ID_KEY 0x02
  43. #define SMP_DIST_SIGN 0x04
  44. #define SMP_DIST_LINK_KEY 0x08
  45. #define SMP_AUTH_NONE 0x00
  46. #define SMP_AUTH_BONDING 0x01
  47. #define SMP_AUTH_MITM 0x04
  48. #define SMP_AUTH_SC 0x08
  49. #define SMP_AUTH_KEYPRESS 0x10
  50. #define SMP_AUTH_CT2 0x20
  51. #define SMP_CMD_PAIRING_CONFIRM 0x03
  52. struct smp_cmd_pairing_confirm {
  53. __u8 confirm_val[16];
  54. } __packed;
  55. #define SMP_CMD_PAIRING_RANDOM 0x04
  56. struct smp_cmd_pairing_random {
  57. __u8 rand_val[16];
  58. } __packed;
  59. #define SMP_CMD_PAIRING_FAIL 0x05
  60. struct smp_cmd_pairing_fail {
  61. __u8 reason;
  62. } __packed;
  63. #define SMP_CMD_ENCRYPT_INFO 0x06
  64. struct smp_cmd_encrypt_info {
  65. __u8 ltk[16];
  66. } __packed;
  67. #define SMP_CMD_MASTER_IDENT 0x07
  68. struct smp_cmd_master_ident {
  69. __le16 ediv;
  70. __le64 rand;
  71. } __packed;
  72. #define SMP_CMD_IDENT_INFO 0x08
  73. struct smp_cmd_ident_info {
  74. __u8 irk[16];
  75. } __packed;
  76. #define SMP_CMD_IDENT_ADDR_INFO 0x09
  77. struct smp_cmd_ident_addr_info {
  78. __u8 addr_type;
  79. bdaddr_t bdaddr;
  80. } __packed;
  81. #define SMP_CMD_SIGN_INFO 0x0a
  82. struct smp_cmd_sign_info {
  83. __u8 csrk[16];
  84. } __packed;
  85. #define SMP_CMD_SECURITY_REQ 0x0b
  86. struct smp_cmd_security_req {
  87. __u8 auth_req;
  88. } __packed;
  89. #define SMP_CMD_PUBLIC_KEY 0x0c
  90. struct smp_cmd_public_key {
  91. __u8 x[32];
  92. __u8 y[32];
  93. } __packed;
  94. #define SMP_CMD_DHKEY_CHECK 0x0d
  95. struct smp_cmd_dhkey_check {
  96. __u8 e[16];
  97. } __packed;
  98. #define SMP_CMD_KEYPRESS_NOTIFY 0x0e
  99. struct smp_cmd_keypress_notify {
  100. __u8 value;
  101. } __packed;
  102. #define SMP_CMD_MAX 0x0e
  103. #define SMP_PASSKEY_ENTRY_FAILED 0x01
  104. #define SMP_OOB_NOT_AVAIL 0x02
  105. #define SMP_AUTH_REQUIREMENTS 0x03
  106. #define SMP_CONFIRM_FAILED 0x04
  107. #define SMP_PAIRING_NOTSUPP 0x05
  108. #define SMP_ENC_KEY_SIZE 0x06
  109. #define SMP_CMD_NOTSUPP 0x07
  110. #define SMP_UNSPECIFIED 0x08
  111. #define SMP_REPEATED_ATTEMPTS 0x09
  112. #define SMP_INVALID_PARAMS 0x0a
  113. #define SMP_DHKEY_CHECK_FAILED 0x0b
  114. #define SMP_NUMERIC_COMP_FAILED 0x0c
  115. #define SMP_BREDR_PAIRING_IN_PROGRESS 0x0d
  116. #define SMP_CROSS_TRANSP_NOT_ALLOWED 0x0e
  117. #define SMP_MIN_ENC_KEY_SIZE 7
  118. #define SMP_MAX_ENC_KEY_SIZE 16
  119. /* LTK types used in internal storage (struct smp_ltk) */
  120. enum {
  121. SMP_STK,
  122. SMP_LTK,
  123. SMP_LTK_SLAVE,
  124. SMP_LTK_P256,
  125. SMP_LTK_P256_DEBUG,
  126. };
  127. static inline bool smp_ltk_is_sc(struct smp_ltk *key)
  128. {
  129. switch (key->type) {
  130. case SMP_LTK_P256:
  131. case SMP_LTK_P256_DEBUG:
  132. return true;
  133. }
  134. return false;
  135. }
  136. static inline u8 smp_ltk_sec_level(struct smp_ltk *key)
  137. {
  138. if (key->authenticated) {
  139. if (smp_ltk_is_sc(key))
  140. return BT_SECURITY_FIPS;
  141. else
  142. return BT_SECURITY_HIGH;
  143. }
  144. return BT_SECURITY_MEDIUM;
  145. }
  146. /* Key preferences for smp_sufficient security */
  147. enum smp_key_pref {
  148. SMP_ALLOW_STK,
  149. SMP_USE_LTK,
  150. };
  151. /* SMP Commands */
  152. int smp_cancel_and_remove_pairing(struct hci_dev *hdev, bdaddr_t *bdaddr,
  153. u8 addr_type);
  154. bool smp_sufficient_security(struct hci_conn *hcon, u8 sec_level,
  155. enum smp_key_pref key_pref);
  156. int smp_conn_security(struct hci_conn *hcon, __u8 sec_level);
  157. int smp_user_confirm_reply(struct hci_conn *conn, u16 mgmt_op, __le32 passkey);
  158. bool smp_irk_matches(struct hci_dev *hdev, const u8 irk[16],
  159. const bdaddr_t *bdaddr);
  160. int smp_generate_rpa(struct hci_dev *hdev, const u8 irk[16], bdaddr_t *rpa);
  161. int smp_generate_oob(struct hci_dev *hdev, u8 hash[16], u8 rand[16]);
  162. int smp_register(struct hci_dev *hdev);
  163. void smp_unregister(struct hci_dev *hdev);
  164. #if IS_ENABLED(CONFIG_BT_SELFTEST_SMP)
  165. int bt_selftest_smp(void);
  166. #else
  167. static inline int bt_selftest_smp(void)
  168. {
  169. return 0;
  170. }
  171. #endif
  172. #endif /* __SMP_H */