xref: /openbmc/linux/include/net/bluetooth/bluetooth.h (revision 256a06c8a85df676e80263af349daad1283e529e)
11da177e4SLinus Torvalds /*
21da177e4SLinus Torvalds    BlueZ - Bluetooth protocol stack for Linux
31da177e4SLinus Torvalds    Copyright (C) 2000-2001 Qualcomm Incorporated
41da177e4SLinus Torvalds 
51da177e4SLinus Torvalds    Written 2000,2001 by Maxim Krasnyansky <maxk@qualcomm.com>
61da177e4SLinus Torvalds 
71da177e4SLinus Torvalds    This program is free software; you can redistribute it and/or modify
81da177e4SLinus Torvalds    it under the terms of the GNU General Public License version 2 as
91da177e4SLinus Torvalds    published by the Free Software Foundation;
101da177e4SLinus Torvalds 
111da177e4SLinus Torvalds    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
121da177e4SLinus Torvalds    OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
131da177e4SLinus Torvalds    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS.
141da177e4SLinus Torvalds    IN NO EVENT SHALL THE COPYRIGHT HOLDER(S) AND AUTHOR(S) BE LIABLE FOR ANY
151da177e4SLinus Torvalds    CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES
161da177e4SLinus Torvalds    WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
171da177e4SLinus Torvalds    ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
181da177e4SLinus Torvalds    OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
191da177e4SLinus Torvalds 
201da177e4SLinus Torvalds    ALL LIABILITY, INCLUDING LIABILITY FOR INFRINGEMENT OF ANY PATENTS,
211da177e4SLinus Torvalds    COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS, RELATING TO USE OF THIS
221da177e4SLinus Torvalds    SOFTWARE IS DISCLAIMED.
231da177e4SLinus Torvalds */
241da177e4SLinus Torvalds 
251da177e4SLinus Torvalds #ifndef __BLUETOOTH_H
261da177e4SLinus Torvalds #define __BLUETOOTH_H
271da177e4SLinus Torvalds 
281da177e4SLinus Torvalds #include <linux/poll.h>
291da177e4SLinus Torvalds #include <net/sock.h>
30*256a06c8SMasatake YAMATO #include <linux/seq_file.h>
311da177e4SLinus Torvalds 
321da177e4SLinus Torvalds #ifndef AF_BLUETOOTH
331da177e4SLinus Torvalds #define AF_BLUETOOTH	31
341da177e4SLinus Torvalds #define PF_BLUETOOTH	AF_BLUETOOTH
351da177e4SLinus Torvalds #endif
361da177e4SLinus Torvalds 
37d095c1ebSAndrei Emeltchenko /* Bluetooth versions */
38d095c1ebSAndrei Emeltchenko #define BLUETOOTH_VER_1_1	1
39d095c1ebSAndrei Emeltchenko #define BLUETOOTH_VER_1_2	2
40d095c1ebSAndrei Emeltchenko #define BLUETOOTH_VER_2_0	3
41d095c1ebSAndrei Emeltchenko 
421da177e4SLinus Torvalds /* Reserv for core and drivers use */
431da177e4SLinus Torvalds #define BT_SKB_RESERVE	8
441da177e4SLinus Torvalds 
451da177e4SLinus Torvalds #define BTPROTO_L2CAP	0
461da177e4SLinus Torvalds #define BTPROTO_HCI	1
471da177e4SLinus Torvalds #define BTPROTO_SCO	2
481da177e4SLinus Torvalds #define BTPROTO_RFCOMM	3
491da177e4SLinus Torvalds #define BTPROTO_BNEP	4
501da177e4SLinus Torvalds #define BTPROTO_CMTP	5
511da177e4SLinus Torvalds #define BTPROTO_HIDP	6
521da177e4SLinus Torvalds #define BTPROTO_AVDTP	7
531da177e4SLinus Torvalds 
541da177e4SLinus Torvalds #define SOL_HCI		0
551da177e4SLinus Torvalds #define SOL_L2CAP	6
561da177e4SLinus Torvalds #define SOL_SCO		17
571da177e4SLinus Torvalds #define SOL_RFCOMM	18
581da177e4SLinus Torvalds 
598c1b2355SMarcel Holtmann #define BT_SECURITY	4
608c1b2355SMarcel Holtmann struct bt_security {
618c1b2355SMarcel Holtmann 	__u8 level;
628f360119SVinicius Costa Gomes 	__u8 key_size;
638c1b2355SMarcel Holtmann };
648c1b2355SMarcel Holtmann #define BT_SECURITY_SDP		0
658c1b2355SMarcel Holtmann #define BT_SECURITY_LOW		1
668c1b2355SMarcel Holtmann #define BT_SECURITY_MEDIUM	2
678c1b2355SMarcel Holtmann #define BT_SECURITY_HIGH	3
688c1b2355SMarcel Holtmann 
69c4f912e1SMarcel Holtmann #define BT_DEFER_SETUP	7
70c4f912e1SMarcel Holtmann 
71e702112fSAndrei Emeltchenko #define BT_FLUSHABLE	8
72e702112fSAndrei Emeltchenko 
73e702112fSAndrei Emeltchenko #define BT_FLUSHABLE_OFF	0
74e702112fSAndrei Emeltchenko #define BT_FLUSHABLE_ON		1
75e702112fSAndrei Emeltchenko 
7614b12d0bSJaikumar Ganesh #define BT_POWER	9
7714b12d0bSJaikumar Ganesh struct bt_power {
7814b12d0bSJaikumar Ganesh 	__u8 force_active;
7914b12d0bSJaikumar Ganesh };
8014b12d0bSJaikumar Ganesh #define BT_POWER_FORCE_ACTIVE_OFF 0
8114b12d0bSJaikumar Ganesh #define BT_POWER_FORCE_ACTIVE_ON  1
8214b12d0bSJaikumar Ganesh 
83c14968b0SMat Martineau #define BT_CHANNEL_POLICY	10
84c14968b0SMat Martineau 
85c14968b0SMat Martineau /* BR/EDR only (default policy)
86c14968b0SMat Martineau  *   AMP controllers cannot be used.
87c14968b0SMat Martineau  *   Channel move requests from the remote device are denied.
88c14968b0SMat Martineau  *   If the L2CAP channel is currently using AMP, move the channel to BR/EDR.
89c14968b0SMat Martineau  */
90c14968b0SMat Martineau #define BT_CHANNEL_POLICY_BREDR_ONLY		0
91c14968b0SMat Martineau 
92c14968b0SMat Martineau /* BR/EDR Preferred
93c14968b0SMat Martineau  *   Allow use of AMP controllers.
94c14968b0SMat Martineau  *   If the L2CAP channel is currently on AMP, move it to BR/EDR.
95c14968b0SMat Martineau  *   Channel move requests from the remote device are allowed.
96c14968b0SMat Martineau  */
97c14968b0SMat Martineau #define BT_CHANNEL_POLICY_BREDR_PREFERRED	1
98c14968b0SMat Martineau 
99c14968b0SMat Martineau /* AMP Preferred
100c14968b0SMat Martineau  *   Allow use of AMP controllers
101c14968b0SMat Martineau  *   If the L2CAP channel is currently on BR/EDR and AMP controller
102c14968b0SMat Martineau  *     resources are available, initiate a channel move to AMP.
103c14968b0SMat Martineau  *   Channel move requests from the remote device are allowed.
104c14968b0SMat Martineau  *   If the L2CAP socket has not been connected yet, try to create
105c14968b0SMat Martineau  *     and configure the channel directly on an AMP controller rather
106c14968b0SMat Martineau  *     than BR/EDR.
107c14968b0SMat Martineau  */
108c14968b0SMat Martineau #define BT_CHANNEL_POLICY_AMP_PREFERRED		2
109c14968b0SMat Martineau 
1103ed7003eSJoe Perches __printf(1, 2)
1113ed7003eSJoe Perches int bt_info(const char *fmt, ...);
1123ed7003eSJoe Perches __printf(1, 2)
1133ed7003eSJoe Perches int bt_err(const char *fmt, ...);
114e1447d8dSJoe Perches 
1153ed7003eSJoe Perches #define BT_INFO(fmt, ...)	bt_info(fmt "\n", ##__VA_ARGS__)
1163ed7003eSJoe Perches #define BT_ERR(fmt, ...)	bt_err(fmt "\n", ##__VA_ARGS__)
1173ed7003eSJoe Perches #define BT_DBG(fmt, ...)	pr_debug(fmt "\n", ##__VA_ARGS__)
1181da177e4SLinus Torvalds 
1191da177e4SLinus Torvalds /* Connection and socket states */
1201da177e4SLinus Torvalds enum {
1211da177e4SLinus Torvalds 	BT_CONNECTED = 1, /* Equal to TCP_ESTABLISHED to make net code happy */
1221da177e4SLinus Torvalds 	BT_OPEN,
1231da177e4SLinus Torvalds 	BT_BOUND,
1241da177e4SLinus Torvalds 	BT_LISTEN,
1251da177e4SLinus Torvalds 	BT_CONNECT,
1261da177e4SLinus Torvalds 	BT_CONNECT2,
1271da177e4SLinus Torvalds 	BT_CONFIG,
1281da177e4SLinus Torvalds 	BT_DISCONN,
1291da177e4SLinus Torvalds 	BT_CLOSED
1301da177e4SLinus Torvalds };
1311da177e4SLinus Torvalds 
13220d1803aSAndrei Emeltchenko /* If unused will be removed by compiler */
13320d1803aSAndrei Emeltchenko static inline const char *state_to_string(int state)
13420d1803aSAndrei Emeltchenko {
13520d1803aSAndrei Emeltchenko 	switch (state) {
13620d1803aSAndrei Emeltchenko 	case BT_CONNECTED:
13720d1803aSAndrei Emeltchenko 		return "BT_CONNECTED";
13820d1803aSAndrei Emeltchenko 	case BT_OPEN:
13920d1803aSAndrei Emeltchenko 		return "BT_OPEN";
14020d1803aSAndrei Emeltchenko 	case BT_BOUND:
14120d1803aSAndrei Emeltchenko 		return "BT_BOUND";
14220d1803aSAndrei Emeltchenko 	case BT_LISTEN:
14320d1803aSAndrei Emeltchenko 		return "BT_LISTEN";
14420d1803aSAndrei Emeltchenko 	case BT_CONNECT:
14520d1803aSAndrei Emeltchenko 		return "BT_CONNECT";
14620d1803aSAndrei Emeltchenko 	case BT_CONNECT2:
14720d1803aSAndrei Emeltchenko 		return "BT_CONNECT2";
14820d1803aSAndrei Emeltchenko 	case BT_CONFIG:
14920d1803aSAndrei Emeltchenko 		return "BT_CONFIG";
15020d1803aSAndrei Emeltchenko 	case BT_DISCONN:
15120d1803aSAndrei Emeltchenko 		return "BT_DISCONN";
15220d1803aSAndrei Emeltchenko 	case BT_CLOSED:
15320d1803aSAndrei Emeltchenko 		return "BT_CLOSED";
15420d1803aSAndrei Emeltchenko 	}
15520d1803aSAndrei Emeltchenko 
15620d1803aSAndrei Emeltchenko 	return "invalid state";
15720d1803aSAndrei Emeltchenko }
15820d1803aSAndrei Emeltchenko 
1591da177e4SLinus Torvalds /* BD Address */
1601da177e4SLinus Torvalds typedef struct {
1611da177e4SLinus Torvalds 	__u8 b[6];
16266c853ccSGustavo F. Padovan } __packed bdaddr_t;
1631da177e4SLinus Torvalds 
164591f47f3SAndre Guedes /* BD Address type */
165591f47f3SAndre Guedes #define BDADDR_BREDR		0x00
166591f47f3SAndre Guedes #define BDADDR_LE_PUBLIC	0x01
167591f47f3SAndre Guedes #define BDADDR_LE_RANDOM	0x02
168591f47f3SAndre Guedes 
1691da177e4SLinus Torvalds #define BDADDR_ANY   (&(bdaddr_t) {{0, 0, 0, 0, 0, 0} })
1701da177e4SLinus Torvalds #define BDADDR_LOCAL (&(bdaddr_t) {{0, 0, 0, 0xff, 0xff, 0xff} })
1711da177e4SLinus Torvalds 
1721da177e4SLinus Torvalds /* Copy, swap, convert BD Address */
1731da177e4SLinus Torvalds static inline int bacmp(bdaddr_t *ba1, bdaddr_t *ba2)
1741da177e4SLinus Torvalds {
1751da177e4SLinus Torvalds 	return memcmp(ba1, ba2, sizeof(bdaddr_t));
1761da177e4SLinus Torvalds }
1771da177e4SLinus Torvalds static inline void bacpy(bdaddr_t *dst, bdaddr_t *src)
1781da177e4SLinus Torvalds {
1791da177e4SLinus Torvalds 	memcpy(dst, src, sizeof(bdaddr_t));
1801da177e4SLinus Torvalds }
1811da177e4SLinus Torvalds 
1821da177e4SLinus Torvalds void baswap(bdaddr_t *dst, bdaddr_t *src);
1831da177e4SLinus Torvalds char *batostr(bdaddr_t *ba);
1841da177e4SLinus Torvalds 
1851da177e4SLinus Torvalds /* Common socket structures and functions */
1861da177e4SLinus Torvalds 
1871da177e4SLinus Torvalds #define bt_sk(__sk) ((struct bt_sock *) __sk)
1881da177e4SLinus Torvalds 
1891da177e4SLinus Torvalds struct bt_sock {
1901da177e4SLinus Torvalds 	struct sock sk;
1911da177e4SLinus Torvalds 	bdaddr_t    src;
1921da177e4SLinus Torvalds 	bdaddr_t    dst;
1931da177e4SLinus Torvalds 	struct list_head accept_q;
1941da177e4SLinus Torvalds 	struct sock *parent;
195c5daa683SGustavo Padovan 	unsigned long flags;
196c5daa683SGustavo Padovan };
197c5daa683SGustavo Padovan 
198c5daa683SGustavo Padovan enum {
199c5daa683SGustavo Padovan 	BT_SK_DEFER_SETUP,
200c5daa683SGustavo Padovan 	BT_SK_SUSPEND,
2011da177e4SLinus Torvalds };
2021da177e4SLinus Torvalds 
2031da177e4SLinus Torvalds struct bt_sock_list {
2041da177e4SLinus Torvalds 	struct hlist_head head;
2051da177e4SLinus Torvalds 	rwlock_t          lock;
206*256a06c8SMasatake YAMATO #ifdef CONFIG_PROC_FS
207*256a06c8SMasatake YAMATO         struct file_operations   fops;
208*256a06c8SMasatake YAMATO         int (* custom_seq_show)(struct seq_file *, void *);
209*256a06c8SMasatake YAMATO #endif
2101da177e4SLinus Torvalds };
2111da177e4SLinus Torvalds 
212ec1b4cf7SStephen Hemminger int  bt_sock_register(int proto, const struct net_proto_family *ops);
2131da177e4SLinus Torvalds int  bt_sock_unregister(int proto);
2141da177e4SLinus Torvalds void bt_sock_link(struct bt_sock_list *l, struct sock *s);
2151da177e4SLinus Torvalds void bt_sock_unlink(struct bt_sock_list *l, struct sock *s);
2165a9d0a3fSWaldemar Rymarkiewicz int  bt_sock_recvmsg(struct kiocb *iocb, struct socket *sock,
2175a9d0a3fSWaldemar Rymarkiewicz 				struct msghdr *msg, size_t len, int flags);
218796c86eeSMat Martineau int  bt_sock_stream_recvmsg(struct kiocb *iocb, struct socket *sock,
219796c86eeSMat Martineau 			struct msghdr *msg, size_t len, int flags);
2201da177e4SLinus Torvalds uint bt_sock_poll(struct file *file, struct socket *sock, poll_table *wait);
2213241ad82SMarcel Holtmann int  bt_sock_ioctl(struct socket *sock, unsigned int cmd, unsigned long arg);
2221da177e4SLinus Torvalds int  bt_sock_wait_state(struct sock *sk, int state, unsigned long timeo);
2231da177e4SLinus Torvalds 
2241da177e4SLinus Torvalds void bt_accept_enqueue(struct sock *parent, struct sock *sk);
2251da177e4SLinus Torvalds void bt_accept_unlink(struct sock *sk);
2261da177e4SLinus Torvalds struct sock *bt_accept_dequeue(struct sock *parent, struct socket *newsock);
2271da177e4SLinus Torvalds 
2281da177e4SLinus Torvalds /* Skb helpers */
22900e3112cSMat Martineau struct l2cap_ctrl {
23000e3112cSMat Martineau 	unsigned int	sframe:1,
23100e3112cSMat Martineau 			poll:1,
23200e3112cSMat Martineau 			final:1,
23300e3112cSMat Martineau 			fcs:1,
23400e3112cSMat Martineau 			sar:2,
23500e3112cSMat Martineau 			super:2;
23600e3112cSMat Martineau 	__u16		reqseq;
23700e3112cSMat Martineau 	__u16		txseq;
23800e3112cSMat Martineau 	__u8		retries;
23900e3112cSMat Martineau };
24000e3112cSMat Martineau 
2411da177e4SLinus Torvalds struct bt_skb_cb {
2420d48d939SMarcel Holtmann 	__u8 pkt_type;
2430d48d939SMarcel Holtmann 	__u8 incoming;
24433e882a5SSuraj Sumangala 	__u16 expect;
24514b12d0bSJaikumar Ganesh 	__u8 force_active;
24600e3112cSMat Martineau 	struct l2cap_ctrl control;
2471da177e4SLinus Torvalds };
2481c2acffbSGustavo F. Padovan #define bt_cb(skb) ((struct bt_skb_cb *)((skb)->cb))
2491da177e4SLinus Torvalds 
250dd0fc66fSAl Viro static inline struct sk_buff *bt_skb_alloc(unsigned int len, gfp_t how)
2511da177e4SLinus Torvalds {
2521da177e4SLinus Torvalds 	struct sk_buff *skb;
2531da177e4SLinus Torvalds 
254c3c7ea65SGustavo Padovan 	skb = alloc_skb(len + BT_SKB_RESERVE, how);
255c3c7ea65SGustavo Padovan 	if (skb) {
2561da177e4SLinus Torvalds 		skb_reserve(skb, BT_SKB_RESERVE);
2571da177e4SLinus Torvalds 		bt_cb(skb)->incoming  = 0;
2581da177e4SLinus Torvalds 	}
2591da177e4SLinus Torvalds 	return skb;
2601da177e4SLinus Torvalds }
2611da177e4SLinus Torvalds 
2625a9d0a3fSWaldemar Rymarkiewicz static inline struct sk_buff *bt_skb_send_alloc(struct sock *sk,
2635a9d0a3fSWaldemar Rymarkiewicz 					unsigned long len, int nb, int *err)
2641da177e4SLinus Torvalds {
2651da177e4SLinus Torvalds 	struct sk_buff *skb;
2661da177e4SLinus Torvalds 
267c3c7ea65SGustavo Padovan 	skb = sock_alloc_send_skb(sk, len + BT_SKB_RESERVE, nb, err);
268c3c7ea65SGustavo Padovan 	if (skb) {
2691da177e4SLinus Torvalds 		skb_reserve(skb, BT_SKB_RESERVE);
2701da177e4SLinus Torvalds 		bt_cb(skb)->incoming  = 0;
2711da177e4SLinus Torvalds 	}
272e454c844SGustavo F. Padovan 
273e454c844SGustavo F. Padovan 	if (!skb && *err)
274e454c844SGustavo F. Padovan 		return NULL;
275e454c844SGustavo F. Padovan 
276e454c844SGustavo F. Padovan 	*err = sock_error(sk);
277e454c844SGustavo F. Padovan 	if (*err)
278e454c844SGustavo F. Padovan 		goto out;
279e454c844SGustavo F. Padovan 
280e454c844SGustavo F. Padovan 	if (sk->sk_shutdown) {
281e454c844SGustavo F. Padovan 		*err = -ECONNRESET;
282e454c844SGustavo F. Padovan 		goto out;
283e454c844SGustavo F. Padovan 	}
2841da177e4SLinus Torvalds 
2851da177e4SLinus Torvalds 	return skb;
286e454c844SGustavo F. Padovan 
287e454c844SGustavo F. Padovan out:
288e454c844SGustavo F. Padovan 	kfree_skb(skb);
289e454c844SGustavo F. Padovan 	return NULL;
2901da177e4SLinus Torvalds }
2911da177e4SLinus Torvalds 
292e175072fSJoe Perches int bt_to_errno(__u16 code);
2931da177e4SLinus Torvalds 
2946516455dSMarcel Holtmann extern int hci_sock_init(void);
29504005dd9STobias Klauser extern void hci_sock_cleanup(void);
2966516455dSMarcel Holtmann 
2976516455dSMarcel Holtmann extern int bt_sysfs_init(void);
2986516455dSMarcel Holtmann extern void bt_sysfs_cleanup(void);
2996516455dSMarcel Holtmann 
300*256a06c8SMasatake YAMATO extern int  bt_procfs_init(struct module* module, struct net *net, const char *name,
301*256a06c8SMasatake YAMATO 			   struct bt_sock_list* sk_list,
302*256a06c8SMasatake YAMATO 			   int (* seq_show)(struct seq_file *, void *));
303*256a06c8SMasatake YAMATO extern void bt_procfs_cleanup(struct net *net, const char *name);
304*256a06c8SMasatake YAMATO 
305aef7d97cSMarcel Holtmann extern struct dentry *bt_debugfs;
306be9d1227SMarcel Holtmann 
30764274518SGustavo F. Padovan int l2cap_init(void);
30864274518SGustavo F. Padovan void l2cap_exit(void);
30964274518SGustavo F. Padovan 
31064274518SGustavo F. Padovan int sco_init(void);
31164274518SGustavo F. Padovan void sco_exit(void);
31264274518SGustavo F. Padovan 
313d22015aaSOctavian Purdila void bt_sock_reclassify_lock(struct sock *sk, int proto);
314d22015aaSOctavian Purdila 
3151da177e4SLinus Torvalds #endif /* __BLUETOOTH_H */
316