xref: /openbmc/linux/net/bluetooth/smp.h (revision b34e08d5)
1 /*
2    BlueZ - Bluetooth protocol stack for Linux
3    Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies).
4 
5    This program is free software; you can redistribute it and/or modify
6    it under the terms of the GNU General Public License version 2 as
7    published by the Free Software Foundation;
8 
9    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
10    OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
11    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS.
12    IN NO EVENT SHALL THE COPYRIGHT HOLDER(S) AND AUTHOR(S) BE LIABLE FOR ANY
13    CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES
14    WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
15    ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
16    OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
17 
18    ALL LIABILITY, INCLUDING LIABILITY FOR INFRINGEMENT OF ANY PATENTS,
19    COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS, RELATING TO USE OF THIS
20    SOFTWARE IS DISCLAIMED.
21 */
22 
23 #ifndef __SMP_H
24 #define __SMP_H
25 
26 struct smp_command_hdr {
27 	__u8	code;
28 } __packed;
29 
30 #define SMP_CMD_PAIRING_REQ	0x01
31 #define SMP_CMD_PAIRING_RSP	0x02
32 struct smp_cmd_pairing {
33 	__u8	io_capability;
34 	__u8	oob_flag;
35 	__u8	auth_req;
36 	__u8	max_key_size;
37 	__u8	init_key_dist;
38 	__u8	resp_key_dist;
39 } __packed;
40 
41 #define SMP_IO_DISPLAY_ONLY	0x00
42 #define SMP_IO_DISPLAY_YESNO	0x01
43 #define SMP_IO_KEYBOARD_ONLY	0x02
44 #define SMP_IO_NO_INPUT_OUTPUT	0x03
45 #define SMP_IO_KEYBOARD_DISPLAY	0x04
46 
47 #define SMP_OOB_NOT_PRESENT	0x00
48 #define SMP_OOB_PRESENT		0x01
49 
50 #define SMP_DIST_ENC_KEY	0x01
51 #define SMP_DIST_ID_KEY		0x02
52 #define SMP_DIST_SIGN		0x04
53 
54 #define SMP_AUTH_NONE		0x00
55 #define SMP_AUTH_BONDING	0x01
56 #define SMP_AUTH_MITM		0x04
57 
58 #define SMP_CMD_PAIRING_CONFIRM	0x03
59 struct smp_cmd_pairing_confirm {
60 	__u8	confirm_val[16];
61 } __packed;
62 
63 #define SMP_CMD_PAIRING_RANDOM	0x04
64 struct smp_cmd_pairing_random {
65 	__u8	rand_val[16];
66 } __packed;
67 
68 #define SMP_CMD_PAIRING_FAIL	0x05
69 struct smp_cmd_pairing_fail {
70 	__u8	reason;
71 } __packed;
72 
73 #define SMP_CMD_ENCRYPT_INFO	0x06
74 struct smp_cmd_encrypt_info {
75 	__u8	ltk[16];
76 } __packed;
77 
78 #define SMP_CMD_MASTER_IDENT	0x07
79 struct smp_cmd_master_ident {
80 	__le16	ediv;
81 	__le64	rand;
82 } __packed;
83 
84 #define SMP_CMD_IDENT_INFO	0x08
85 struct smp_cmd_ident_info {
86 	__u8	irk[16];
87 } __packed;
88 
89 #define SMP_CMD_IDENT_ADDR_INFO	0x09
90 struct smp_cmd_ident_addr_info {
91 	__u8	addr_type;
92 	bdaddr_t bdaddr;
93 } __packed;
94 
95 #define SMP_CMD_SIGN_INFO	0x0a
96 struct smp_cmd_sign_info {
97 	__u8	csrk[16];
98 } __packed;
99 
100 #define SMP_CMD_SECURITY_REQ	0x0b
101 struct smp_cmd_security_req {
102 	__u8	auth_req;
103 } __packed;
104 
105 #define SMP_PASSKEY_ENTRY_FAILED	0x01
106 #define SMP_OOB_NOT_AVAIL		0x02
107 #define SMP_AUTH_REQUIREMENTS		0x03
108 #define SMP_CONFIRM_FAILED		0x04
109 #define SMP_PAIRING_NOTSUPP		0x05
110 #define SMP_ENC_KEY_SIZE		0x06
111 #define SMP_CMD_NOTSUPP			0x07
112 #define SMP_UNSPECIFIED			0x08
113 #define SMP_REPEATED_ATTEMPTS		0x09
114 
115 #define SMP_MIN_ENC_KEY_SIZE		7
116 #define SMP_MAX_ENC_KEY_SIZE		16
117 
118 #define SMP_FLAG_TK_VALID	1
119 #define SMP_FLAG_CFM_PENDING	2
120 #define SMP_FLAG_MITM_AUTH	3
121 #define SMP_FLAG_COMPLETE	4
122 #define SMP_FLAG_INITIATOR	5
123 
124 struct smp_chan {
125 	struct l2cap_conn *conn;
126 	u8		preq[7]; /* SMP Pairing Request */
127 	u8		prsp[7]; /* SMP Pairing Response */
128 	u8		prnd[16]; /* SMP Pairing Random (local) */
129 	u8		rrnd[16]; /* SMP Pairing Random (remote) */
130 	u8		pcnf[16]; /* SMP Pairing Confirm */
131 	u8		tk[16]; /* SMP Temporary Key */
132 	u8		enc_key_size;
133 	u8		remote_key_dist;
134 	bdaddr_t	id_addr;
135 	u8		id_addr_type;
136 	u8		irk[16];
137 	struct smp_csrk	*csrk;
138 	struct smp_csrk	*slave_csrk;
139 	struct smp_ltk	*ltk;
140 	struct smp_ltk	*slave_ltk;
141 	struct smp_irk	*remote_irk;
142 	unsigned long	smp_flags;
143 	struct work_struct confirm;
144 	struct work_struct random;
145 };
146 
147 /* SMP Commands */
148 bool smp_sufficient_security(struct hci_conn *hcon, u8 sec_level);
149 int smp_conn_security(struct hci_conn *hcon, __u8 sec_level);
150 int smp_sig_channel(struct l2cap_conn *conn, struct sk_buff *skb);
151 int smp_distribute_keys(struct l2cap_conn *conn);
152 int smp_user_confirm_reply(struct hci_conn *conn, u16 mgmt_op, __le32 passkey);
153 
154 void smp_chan_destroy(struct l2cap_conn *conn);
155 
156 bool smp_irk_matches(struct crypto_blkcipher *tfm, u8 irk[16],
157 		     bdaddr_t *bdaddr);
158 int smp_generate_rpa(struct crypto_blkcipher *tfm, u8 irk[16], bdaddr_t *rpa);
159 
160 #endif /* __SMP_H */
161