xref: /freebsd/lib/libbluetooth/bluetooth.h (revision ea825d02749f382c3f7e17f28247f20a48733eab)
1 /*
2  * bluetooth.h
3  */
4 
5 /*-
6  * Copyright (c) 2001-2009 Maksim Yevmenkin <m_evmenkin@yahoo.com>
7  * All rights reserved.
8  *
9  * Redistribution and use in source and binary forms, with or without
10  * modification, are permitted provided that the following conditions
11  * are met:
12  * 1. Redistributions of source code must retain the above copyright
13  *    notice, this list of conditions and the following disclaimer.
14  * 2. Redistributions in binary form must reproduce the above copyright
15  *    notice, this list of conditions and the following disclaimer in the
16  *    documentation and/or other materials provided with the distribution.
17  *
18  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
19  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21  * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
22  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
24  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
26  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
27  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28  * SUCH DAMAGE.
29  *
30  * $Id: bluetooth.h,v 1.5 2003/09/14 23:28:42 max Exp $
31  * $FreeBSD$
32  */
33 
34 #ifndef _BLUETOOTH_H_
35 #define _BLUETOOTH_H_
36 
37 #include <sys/types.h>
38 #include <sys/endian.h>
39 #include <sys/ioctl.h>
40 #include <sys/socket.h>
41 #include <sys/uio.h>
42 #include <sys/un.h>
43 
44 #include <errno.h>
45 #include <netdb.h>
46 #include <bitstring.h>
47 
48 #include <netgraph/ng_message.h>
49 #include <netgraph/bluetooth/include/ng_bluetooth.h>
50 #include <netgraph/bluetooth/include/ng_hci.h>
51 #include <netgraph/bluetooth/include/ng_l2cap.h>
52 #include <netgraph/bluetooth/include/ng_btsocket.h>
53 #include <time.h>
54 
55 __BEGIN_DECLS
56 
57 /*
58  * Linux BlueZ compatibility
59  */
60 
61 #define	bacmp(ba1, ba2)	memcmp((ba1), (ba2), sizeof(bdaddr_t))
62 #define	bacpy(dst, src)	memcpy((dst), (src), sizeof(bdaddr_t))
63 #define ba2str(ba, str)	bt_ntoa((ba), (str))
64 #define str2ba(str, ba)	(bt_aton((str), (ba)) == 1? 0 : -1)
65 #define htobs(d)	htole16(d)
66 #define htobl(d)	htole32(d)
67 #define btohs(d)	le16toh(d)
68 #define btohl(d)	le32toh(d)
69 
70 /*
71  * Interface to the outside world
72  */
73 
74 struct hostent *  bt_gethostbyname    (char const *name);
75 struct hostent *  bt_gethostbyaddr    (char const *addr, int len, int type);
76 struct hostent *  bt_gethostent       (void);
77 void              bt_sethostent       (int stayopen);
78 void              bt_endhostent       (void);
79 
80 struct protoent * bt_getprotobyname   (char const *name);
81 struct protoent * bt_getprotobynumber (int proto);
82 struct protoent * bt_getprotoent      (void);
83 void              bt_setprotoent      (int stayopen);
84 void              bt_endprotoent      (void);
85 
86 char const *      bt_ntoa             (bdaddr_t const *ba, char *str);
87 int               bt_aton             (char const *str, bdaddr_t *ba);
88 
89 /* bt_devXXXX() functions (inspired by NetBSD) */
90 int               bt_devaddr          (char const *devname, bdaddr_t *addr);
91 int               bt_devname          (char *devname, bdaddr_t const *addr);
92 
93 /*
94  * Bluetooth HCI functions
95  */
96 
97 #define	HCI_DEVMAX			32		/* arbitrary */
98 #define	HCI_DEVNAME_SIZE		NG_NODESIZ
99 #define	HCI_DEVFEATURES_SIZE		NG_HCI_FEATURES_SIZE
100 
101 struct bt_devinfo
102 {
103 	char		devname[HCI_DEVNAME_SIZE];
104 
105 	uint32_t	state;		/* device/implementation specific */
106 
107 	bdaddr_t	bdaddr;
108 	uint16_t	_reserved0;
109 
110 	uint8_t		features[HCI_DEVFEATURES_SIZE];
111 
112 	/* buffer info */
113 	uint16_t	_reserved1;
114 	uint16_t	cmd_free;
115 	uint16_t	sco_size;
116 	uint16_t	sco_pkts;
117 	uint16_t	sco_free;
118 	uint16_t	acl_size;
119 	uint16_t	acl_pkts;
120 	uint16_t	acl_free;
121 
122 	/* stats */
123 	uint32_t	cmd_sent;
124 	uint32_t	evnt_recv;
125 	uint32_t	acl_recv;
126 	uint32_t	acl_sent;
127 	uint32_t	sco_recv;
128 	uint32_t	sco_sent;
129 	uint32_t	bytes_recv;
130 	uint32_t	bytes_sent;
131 
132 	/* misc/specific */
133 	uint16_t	link_policy_info;
134 	uint16_t	packet_type_info;
135 	uint16_t	role_switch_info;
136 	uint16_t	debug;
137 
138 	uint8_t		_padding[20];	/* leave space for future additions */
139 };
140 
141 struct bt_devreq
142 {
143 	uint16_t	opcode;
144 	uint8_t		event;
145 	void		*cparam;
146 	size_t		clen;
147 	void		*rparam;
148 	size_t		rlen;
149 };
150 
151 struct bt_devfilter {
152 	bitstr_t	bit_decl(packet_mask, 8);
153 	bitstr_t	bit_decl(event_mask, 256);
154 };
155 
156 struct bt_devinquiry {
157 	bdaddr_t        bdaddr;
158 	uint8_t         pscan_rep_mode;
159 	uint8_t         pscan_period_mode;
160 	uint8_t         dev_class[3];
161 	uint16_t        clock_offset;
162 	int8_t          rssi;
163 	uint8_t         data[240];
164 };
165 
166 typedef int	(bt_devenum_cb_t)(int, struct bt_devinfo const *, void *);
167 
168 int		bt_devopen (char const *devname);
169 int		bt_devclose(int s);
170 int		bt_devsend (int s, uint16_t opcode, void *param, size_t plen);
171 ssize_t		bt_devrecv (int s, void *buf, size_t size, time_t to);
172 int		bt_devreq  (int s, struct bt_devreq *r, time_t to);
173 int		bt_devfilter(int s, struct bt_devfilter const *newp,
174 			     struct bt_devfilter *oldp);
175 void		bt_devfilter_pkt_set(struct bt_devfilter *filter, uint8_t type);
176 void		bt_devfilter_pkt_clr(struct bt_devfilter *filter, uint8_t type);
177 int		bt_devfilter_pkt_tst(struct bt_devfilter const *filter, uint8_t type);
178 void		bt_devfilter_evt_set(struct bt_devfilter *filter, uint8_t event);
179 void		bt_devfilter_evt_clr(struct bt_devfilter *filter, uint8_t event);
180 int		bt_devfilter_evt_tst(struct bt_devfilter const *filter, uint8_t event);
181 int		bt_devinquiry(char const *devname, time_t length, int num_rsp,
182 			      struct bt_devinquiry **ii);
183 int		bt_devinfo (struct bt_devinfo *di);
184 int		bt_devenum (bt_devenum_cb_t cb, void *arg);
185 
186 /*
187  * bdaddr utility functions (from NetBSD)
188  */
189 
190 static __inline int
191 bdaddr_same(const bdaddr_t *a, const bdaddr_t *b)
192 {
193 	return (a->b[0] == b->b[0] && a->b[1] == b->b[1] &&
194 		a->b[2] == b->b[2] && a->b[3] == b->b[3] &&
195 		a->b[4] == b->b[4] && a->b[5] == b->b[5]);
196 }
197 
198 static __inline int
199 bdaddr_any(const bdaddr_t *a)
200 {
201 	return (a->b[0] == 0 && a->b[1] == 0 && a->b[2] == 0 &&
202 		a->b[3] == 0 && a->b[4] == 0 && a->b[5] == 0);
203 }
204 
205 static __inline void
206 bdaddr_copy(bdaddr_t *d, const bdaddr_t *s)
207 {
208 	d->b[0] = s->b[0];
209 	d->b[1] = s->b[1];
210 	d->b[2] = s->b[2];
211 	d->b[3] = s->b[3];
212 	d->b[4] = s->b[4];
213 	d->b[5] = s->b[5];
214 }
215 
216 __END_DECLS
217 
218 #endif /* ndef _BLUETOOTH_H_ */
219 
220