xref: /openbmc/linux/include/net/bluetooth/bluetooth.h (revision c14968b0c1792901ac1cbbbf18f42e37b5a6f4df)
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 <asm/types.h>
291da177e4SLinus Torvalds #include <asm/byteorder.h>
301da177e4SLinus Torvalds #include <linux/list.h>
311da177e4SLinus Torvalds #include <linux/poll.h>
321da177e4SLinus Torvalds #include <net/sock.h>
331da177e4SLinus Torvalds 
341da177e4SLinus Torvalds #ifndef AF_BLUETOOTH
351da177e4SLinus Torvalds #define AF_BLUETOOTH	31
361da177e4SLinus Torvalds #define PF_BLUETOOTH	AF_BLUETOOTH
371da177e4SLinus Torvalds #endif
381da177e4SLinus Torvalds 
391da177e4SLinus Torvalds /* Reserv for core and drivers use */
401da177e4SLinus Torvalds #define BT_SKB_RESERVE	8
411da177e4SLinus Torvalds 
421da177e4SLinus Torvalds #define BTPROTO_L2CAP	0
431da177e4SLinus Torvalds #define BTPROTO_HCI	1
441da177e4SLinus Torvalds #define BTPROTO_SCO	2
451da177e4SLinus Torvalds #define BTPROTO_RFCOMM	3
461da177e4SLinus Torvalds #define BTPROTO_BNEP	4
471da177e4SLinus Torvalds #define BTPROTO_CMTP	5
481da177e4SLinus Torvalds #define BTPROTO_HIDP	6
491da177e4SLinus Torvalds #define BTPROTO_AVDTP	7
501da177e4SLinus Torvalds 
511da177e4SLinus Torvalds #define SOL_HCI		0
521da177e4SLinus Torvalds #define SOL_L2CAP	6
531da177e4SLinus Torvalds #define SOL_SCO		17
541da177e4SLinus Torvalds #define SOL_RFCOMM	18
551da177e4SLinus Torvalds 
568c1b2355SMarcel Holtmann #define BT_SECURITY	4
578c1b2355SMarcel Holtmann struct bt_security {
588c1b2355SMarcel Holtmann 	__u8 level;
598f360119SVinicius Costa Gomes 	__u8 key_size;
608c1b2355SMarcel Holtmann };
618c1b2355SMarcel Holtmann #define BT_SECURITY_SDP		0
628c1b2355SMarcel Holtmann #define BT_SECURITY_LOW		1
638c1b2355SMarcel Holtmann #define BT_SECURITY_MEDIUM	2
648c1b2355SMarcel Holtmann #define BT_SECURITY_HIGH	3
658c1b2355SMarcel Holtmann 
66c4f912e1SMarcel Holtmann #define BT_DEFER_SETUP	7
67c4f912e1SMarcel Holtmann 
68e702112fSAndrei Emeltchenko #define BT_FLUSHABLE	8
69e702112fSAndrei Emeltchenko 
70e702112fSAndrei Emeltchenko #define BT_FLUSHABLE_OFF	0
71e702112fSAndrei Emeltchenko #define BT_FLUSHABLE_ON		1
72e702112fSAndrei Emeltchenko 
7314b12d0bSJaikumar Ganesh #define BT_POWER	9
7414b12d0bSJaikumar Ganesh struct bt_power {
7514b12d0bSJaikumar Ganesh 	__u8 force_active;
7614b12d0bSJaikumar Ganesh };
7714b12d0bSJaikumar Ganesh #define BT_POWER_FORCE_ACTIVE_OFF 0
7814b12d0bSJaikumar Ganesh #define BT_POWER_FORCE_ACTIVE_ON  1
7914b12d0bSJaikumar Ganesh 
80*c14968b0SMat Martineau #define BT_CHANNEL_POLICY	10
81*c14968b0SMat Martineau 
82*c14968b0SMat Martineau /* BR/EDR only (default policy)
83*c14968b0SMat Martineau  *   AMP controllers cannot be used.
84*c14968b0SMat Martineau  *   Channel move requests from the remote device are denied.
85*c14968b0SMat Martineau  *   If the L2CAP channel is currently using AMP, move the channel to BR/EDR.
86*c14968b0SMat Martineau  */
87*c14968b0SMat Martineau #define BT_CHANNEL_POLICY_BREDR_ONLY		0
88*c14968b0SMat Martineau 
89*c14968b0SMat Martineau /* BR/EDR Preferred
90*c14968b0SMat Martineau  *   Allow use of AMP controllers.
91*c14968b0SMat Martineau  *   If the L2CAP channel is currently on AMP, move it to BR/EDR.
92*c14968b0SMat Martineau  *   Channel move requests from the remote device are allowed.
93*c14968b0SMat Martineau  */
94*c14968b0SMat Martineau #define BT_CHANNEL_POLICY_BREDR_PREFERRED	1
95*c14968b0SMat Martineau 
96*c14968b0SMat Martineau /* AMP Preferred
97*c14968b0SMat Martineau  *   Allow use of AMP controllers
98*c14968b0SMat Martineau  *   If the L2CAP channel is currently on BR/EDR and AMP controller
99*c14968b0SMat Martineau  *     resources are available, initiate a channel move to AMP.
100*c14968b0SMat Martineau  *   Channel move requests from the remote device are allowed.
101*c14968b0SMat Martineau  *   If the L2CAP socket has not been connected yet, try to create
102*c14968b0SMat Martineau  *     and configure the channel directly on an AMP controller rather
103*c14968b0SMat Martineau  *     than BR/EDR.
104*c14968b0SMat Martineau  */
105*c14968b0SMat Martineau #define BT_CHANNEL_POLICY_AMP_PREFERRED		2
106*c14968b0SMat Martineau 
107e1447d8dSJoe Perches __attribute__((format (printf, 2, 3)))
108e1447d8dSJoe Perches int bt_printk(const char *level, const char *fmt, ...);
109e1447d8dSJoe Perches 
110e1447d8dSJoe Perches #define BT_INFO(fmt, arg...)   bt_printk(KERN_INFO, pr_fmt(fmt), ##arg)
111e1447d8dSJoe Perches #define BT_ERR(fmt, arg...)    bt_printk(KERN_ERR, pr_fmt(fmt), ##arg)
112e1447d8dSJoe Perches #define BT_DBG(fmt, arg...)    pr_debug(fmt "\n", ##arg)
1131da177e4SLinus Torvalds 
1141da177e4SLinus Torvalds /* Connection and socket states */
1151da177e4SLinus Torvalds enum {
1161da177e4SLinus Torvalds 	BT_CONNECTED = 1, /* Equal to TCP_ESTABLISHED to make net code happy */
1171da177e4SLinus Torvalds 	BT_OPEN,
1181da177e4SLinus Torvalds 	BT_BOUND,
1191da177e4SLinus Torvalds 	BT_LISTEN,
1201da177e4SLinus Torvalds 	BT_CONNECT,
1211da177e4SLinus Torvalds 	BT_CONNECT2,
1221da177e4SLinus Torvalds 	BT_CONFIG,
1231da177e4SLinus Torvalds 	BT_DISCONN,
1241da177e4SLinus Torvalds 	BT_CLOSED
1251da177e4SLinus Torvalds };
1261da177e4SLinus Torvalds 
1271da177e4SLinus Torvalds /* BD Address */
1281da177e4SLinus Torvalds typedef struct {
1291da177e4SLinus Torvalds 	__u8 b[6];
13066c853ccSGustavo F. Padovan } __packed bdaddr_t;
1311da177e4SLinus Torvalds 
1321da177e4SLinus Torvalds #define BDADDR_ANY   (&(bdaddr_t) {{0, 0, 0, 0, 0, 0}})
1331da177e4SLinus Torvalds #define BDADDR_LOCAL (&(bdaddr_t) {{0, 0, 0, 0xff, 0xff, 0xff}})
1341da177e4SLinus Torvalds 
1351da177e4SLinus Torvalds /* Copy, swap, convert BD Address */
1361da177e4SLinus Torvalds static inline int bacmp(bdaddr_t *ba1, bdaddr_t *ba2)
1371da177e4SLinus Torvalds {
1381da177e4SLinus Torvalds 	return memcmp(ba1, ba2, sizeof(bdaddr_t));
1391da177e4SLinus Torvalds }
1401da177e4SLinus Torvalds static inline void bacpy(bdaddr_t *dst, bdaddr_t *src)
1411da177e4SLinus Torvalds {
1421da177e4SLinus Torvalds 	memcpy(dst, src, sizeof(bdaddr_t));
1431da177e4SLinus Torvalds }
1441da177e4SLinus Torvalds 
1451da177e4SLinus Torvalds void baswap(bdaddr_t *dst, bdaddr_t *src);
1461da177e4SLinus Torvalds char *batostr(bdaddr_t *ba);
1471da177e4SLinus Torvalds bdaddr_t *strtoba(char *str);
1481da177e4SLinus Torvalds 
1491da177e4SLinus Torvalds /* Common socket structures and functions */
1501da177e4SLinus Torvalds 
1511da177e4SLinus Torvalds #define bt_sk(__sk) ((struct bt_sock *) __sk)
1521da177e4SLinus Torvalds 
1531da177e4SLinus Torvalds struct bt_sock {
1541da177e4SLinus Torvalds 	struct sock sk;
1551da177e4SLinus Torvalds 	bdaddr_t    src;
1561da177e4SLinus Torvalds 	bdaddr_t    dst;
1571da177e4SLinus Torvalds 	struct list_head accept_q;
1581da177e4SLinus Torvalds 	struct sock *parent;
159c4f912e1SMarcel Holtmann 	u32 defer_setup;
1601da177e4SLinus Torvalds };
1611da177e4SLinus Torvalds 
1621da177e4SLinus Torvalds struct bt_sock_list {
1631da177e4SLinus Torvalds 	struct hlist_head head;
1641da177e4SLinus Torvalds 	rwlock_t          lock;
1651da177e4SLinus Torvalds };
1661da177e4SLinus Torvalds 
167ec1b4cf7SStephen Hemminger int  bt_sock_register(int proto, const struct net_proto_family *ops);
1681da177e4SLinus Torvalds int  bt_sock_unregister(int proto);
1691da177e4SLinus Torvalds void bt_sock_link(struct bt_sock_list *l, struct sock *s);
1701da177e4SLinus Torvalds void bt_sock_unlink(struct bt_sock_list *l, struct sock *s);
1715a9d0a3fSWaldemar Rymarkiewicz int  bt_sock_recvmsg(struct kiocb *iocb, struct socket *sock,
1725a9d0a3fSWaldemar Rymarkiewicz 				struct msghdr *msg, size_t len, int flags);
173796c86eeSMat Martineau int  bt_sock_stream_recvmsg(struct kiocb *iocb, struct socket *sock,
174796c86eeSMat Martineau 			struct msghdr *msg, size_t len, int flags);
1751da177e4SLinus Torvalds uint bt_sock_poll(struct file * file, struct socket *sock, poll_table *wait);
1763241ad82SMarcel Holtmann int  bt_sock_ioctl(struct socket *sock, unsigned int cmd, unsigned long arg);
1771da177e4SLinus Torvalds int  bt_sock_wait_state(struct sock *sk, int state, unsigned long timeo);
1781da177e4SLinus Torvalds 
1791da177e4SLinus Torvalds void bt_accept_enqueue(struct sock *parent, struct sock *sk);
1801da177e4SLinus Torvalds void bt_accept_unlink(struct sock *sk);
1811da177e4SLinus Torvalds struct sock *bt_accept_dequeue(struct sock *parent, struct socket *newsock);
1821da177e4SLinus Torvalds 
1831da177e4SLinus Torvalds /* Skb helpers */
1841da177e4SLinus Torvalds struct bt_skb_cb {
1850d48d939SMarcel Holtmann 	__u8 pkt_type;
1860d48d939SMarcel Holtmann 	__u8 incoming;
18733e882a5SSuraj Sumangala 	__u16 expect;
188836be934SAndrei Emeltchenko 	__u16 tx_seq;
189e90bac06SGustavo F. Padovan 	__u8 retries;
1908f17154fSGustavo F. Padovan 	__u8 sar;
191a40c406cSJohan Hedberg 	unsigned short channel;
19214b12d0bSJaikumar Ganesh 	__u8 force_active;
1931da177e4SLinus Torvalds };
1941c2acffbSGustavo F. Padovan #define bt_cb(skb) ((struct bt_skb_cb *)((skb)->cb))
1951da177e4SLinus Torvalds 
196dd0fc66fSAl Viro static inline struct sk_buff *bt_skb_alloc(unsigned int len, gfp_t how)
1971da177e4SLinus Torvalds {
1981da177e4SLinus Torvalds 	struct sk_buff *skb;
1991da177e4SLinus Torvalds 
2001da177e4SLinus Torvalds 	if ((skb = alloc_skb(len + BT_SKB_RESERVE, how))) {
2011da177e4SLinus Torvalds 		skb_reserve(skb, BT_SKB_RESERVE);
2021da177e4SLinus Torvalds 		bt_cb(skb)->incoming  = 0;
2031da177e4SLinus Torvalds 	}
2041da177e4SLinus Torvalds 	return skb;
2051da177e4SLinus Torvalds }
2061da177e4SLinus Torvalds 
2075a9d0a3fSWaldemar Rymarkiewicz static inline struct sk_buff *bt_skb_send_alloc(struct sock *sk,
2085a9d0a3fSWaldemar Rymarkiewicz 					unsigned long len, int nb, int *err)
2091da177e4SLinus Torvalds {
2101da177e4SLinus Torvalds 	struct sk_buff *skb;
2111da177e4SLinus Torvalds 
212e454c844SGustavo F. Padovan 	release_sock(sk);
2131da177e4SLinus Torvalds 	if ((skb = sock_alloc_send_skb(sk, len + BT_SKB_RESERVE, nb, err))) {
2141da177e4SLinus Torvalds 		skb_reserve(skb, BT_SKB_RESERVE);
2151da177e4SLinus Torvalds 		bt_cb(skb)->incoming  = 0;
2161da177e4SLinus Torvalds 	}
217e454c844SGustavo F. Padovan 	lock_sock(sk);
218e454c844SGustavo F. Padovan 
219e454c844SGustavo F. Padovan 	if (!skb && *err)
220e454c844SGustavo F. Padovan 		return NULL;
221e454c844SGustavo F. Padovan 
222e454c844SGustavo F. Padovan 	*err = sock_error(sk);
223e454c844SGustavo F. Padovan 	if (*err)
224e454c844SGustavo F. Padovan 		goto out;
225e454c844SGustavo F. Padovan 
226e454c844SGustavo F. Padovan 	if (sk->sk_shutdown) {
227e454c844SGustavo F. Padovan 		*err = -ECONNRESET;
228e454c844SGustavo F. Padovan 		goto out;
229e454c844SGustavo F. Padovan 	}
2301da177e4SLinus Torvalds 
2311da177e4SLinus Torvalds 	return skb;
232e454c844SGustavo F. Padovan 
233e454c844SGustavo F. Padovan out:
234e454c844SGustavo F. Padovan 	kfree_skb(skb);
235e454c844SGustavo F. Padovan 	return NULL;
2361da177e4SLinus Torvalds }
2371da177e4SLinus Torvalds 
238e175072fSJoe Perches int bt_to_errno(__u16 code);
2391da177e4SLinus Torvalds 
2406516455dSMarcel Holtmann extern int hci_sock_init(void);
24104005dd9STobias Klauser extern void hci_sock_cleanup(void);
2426516455dSMarcel Holtmann 
2436516455dSMarcel Holtmann extern int bt_sysfs_init(void);
2446516455dSMarcel Holtmann extern void bt_sysfs_cleanup(void);
2456516455dSMarcel Holtmann 
246aef7d97cSMarcel Holtmann extern struct dentry *bt_debugfs;
247be9d1227SMarcel Holtmann 
24864274518SGustavo F. Padovan #ifdef CONFIG_BT_L2CAP
24964274518SGustavo F. Padovan int l2cap_init(void);
25064274518SGustavo F. Padovan void l2cap_exit(void);
25164274518SGustavo F. Padovan #else
25264274518SGustavo F. Padovan static inline int l2cap_init(void)
25364274518SGustavo F. Padovan {
25464274518SGustavo F. Padovan 	return 0;
25564274518SGustavo F. Padovan }
25664274518SGustavo F. Padovan 
25764274518SGustavo F. Padovan static inline void l2cap_exit(void)
25864274518SGustavo F. Padovan {
25964274518SGustavo F. Padovan }
26064274518SGustavo F. Padovan #endif
26164274518SGustavo F. Padovan 
26264274518SGustavo F. Padovan #ifdef CONFIG_BT_SCO
26364274518SGustavo F. Padovan int sco_init(void);
26464274518SGustavo F. Padovan void sco_exit(void);
26564274518SGustavo F. Padovan #else
26664274518SGustavo F. Padovan static inline int sco_init(void)
26764274518SGustavo F. Padovan {
26864274518SGustavo F. Padovan 	return 0;
26964274518SGustavo F. Padovan }
27064274518SGustavo F. Padovan 
27164274518SGustavo F. Padovan static inline void sco_exit(void)
27264274518SGustavo F. Padovan {
27364274518SGustavo F. Padovan }
27464274518SGustavo F. Padovan #endif
27564274518SGustavo F. Padovan 
2761da177e4SLinus Torvalds #endif /* __BLUETOOTH_H */
277