lib/libbluetooth/bluetooth.h

   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/bitstring.h>
  39 #include <sys/endian.h>
  40 #include <sys/ioctl.h>
  41 #include <sys/socket.h>
  42 #include <sys/uio.h>
  43 #include <sys/un.h>
  44 #include <errno.h>
  45 #include <netdb.h>
  46 #include <netgraph/ng_message.h>
  47 #include <netgraph/bluetooth/include/ng_hci.h>
  48 #include <netgraph/bluetooth/include/ng_l2cap.h>
  49 #include <netgraph/bluetooth/include/ng_btsocket.h>
  50 #include <time.h>
  51
  52 __BEGIN_DECLS
  53
  54 /*
  55  * Linux BlueZ compatibility
  56  */
  57
  58 #define bacmp(ba1, ba2) memcmp((ba1), (ba2), sizeof(bdaddr_t))
  59 #define bacpy(dst, src) memcpy((dst), (src), sizeof(bdaddr_t))
  60 #define ba2str(ba, str) bt_ntoa((ba), (str))
  61 #define str2ba(str, ba) (bt_aton((str), (ba)) == 1? 0 : -1)
  62 #define htobs(d)        htole16(d)
  63 #define htobl(d)        htole32(d)
  64 #define btohs(d)        le16toh(d)
  65 #define btohl(d)        le32toh(d)
  66
  67 /*
  68  * Interface to the outside world
  69  */
  70
  71 struct hostent *  bt_gethostbyname    (char const *name);
  72 struct hostent *  bt_gethostbyaddr    (char const *addr, int len, int type);
  73 struct hostent *  bt_gethostent       (void);
  74 void              bt_sethostent       (int stayopen);
  75 void              bt_endhostent       (void);
  76
  77 struct protoent * bt_getprotobyname   (char const *name);
  78 struct protoent * bt_getprotobynumber (int proto);
  79 struct protoent * bt_getprotoent      (void);
  80 void              bt_setprotoent      (int stayopen);
  81 void              bt_endprotoent      (void);
  82
  83 char const *      bt_ntoa             (bdaddr_t const *ba, char *str);
  84 int               bt_aton             (char const *str, bdaddr_t *ba);
  85
  86 /* bt_devXXXX() functions (inspired by NetBSD) */
  87 int               bt_devaddr          (char const *devname, bdaddr_t *addr);
  88 int               bt_devname          (char *devname, bdaddr_t const *addr);
  89
  90 /*
  91  * Bluetooth HCI functions
  92  */
  93
  94 #define HCI_DEVMAX                      32              /* arbitrary */
  95 #define HCI_DEVNAME_SIZE                NG_NODESIZ
  96 #define HCI_DEVFEATURES_SIZE            NG_HCI_FEATURES_SIZE
  97
  98 struct bt_devinfo
  99 {
 100         char            devname[HCI_DEVNAME_SIZE];
 101
 102         uint32_t        state;          /* device/implementation specific */
 103
 104         bdaddr_t        bdaddr;
 105         uint16_t        _reserved0;
 106
 107         uint8_t         features[HCI_DEVFEATURES_SIZE];
 108
 109         /* buffer info */
 110         uint16_t        _reserved1;
 111         uint16_t        cmd_free;
 112         uint16_t        sco_size;
 113         uint16_t        sco_pkts;
 114         uint16_t        sco_free;
 115         uint16_t        acl_size;
 116         uint16_t        acl_pkts;
 117         uint16_t        acl_free;
 118
 119         /* stats */
 120         uint32_t        cmd_sent;
 121         uint32_t        evnt_recv;
 122         uint32_t        acl_recv;
 123         uint32_t        acl_sent;
 124         uint32_t        sco_recv;
 125         uint32_t        sco_sent;
 126         uint32_t        bytes_recv;
 127         uint32_t        bytes_sent;
 128
 129         /* misc/specific */
 130         uint16_t        link_policy_info;
 131         uint16_t        packet_type_info;
 132         uint16_t        role_switch_info;
 133         uint16_t        debug;
 134
 135         uint8_t         _padding[20];   /* leave space for future additions */
 136 };
 137
 138 struct bt_devreq
 139 {
 140         uint16_t        opcode;
 141         uint8_t         event;
 142         void            *cparam;
 143         size_t          clen;
 144         void            *rparam;
 145         size_t          rlen;
 146 };
 147
 148 struct bt_devfilter {
 149         bitstr_t        bit_decl(packet_mask, 8);
 150         bitstr_t        bit_decl(event_mask, 256);
 151 };
 152
 153 struct bt_devinquiry {
 154         bdaddr_t        bdaddr;
 155         uint8_t         pscan_rep_mode;
 156         uint8_t         pscan_period_mode;
 157         uint8_t         dev_class[3];
 158         uint16_t        clock_offset;
 159         int8_t          rssi;
 160         uint8_t         data[240];
 161 };
 162
 163 typedef int     (bt_devenum_cb_t)(int, struct bt_devinfo const *, void *);
 164
 165 int             bt_devopen (char const *devname);
 166 int             bt_devclose(int s);
 167 int             bt_devsend (int s, uint16_t opcode, void *param, size_t plen);
 168 ssize_t         bt_devrecv (int s, void *buf, size_t size, time_t to);
 169 int             bt_devreq  (int s, struct bt_devreq *r, time_t to);
 170 int             bt_devfilter(int s, struct bt_devfilter const *newp,
 171                              struct bt_devfilter *oldp);
 172 void            bt_devfilter_pkt_set(struct bt_devfilter *filter, uint8_t type);
 173 void            bt_devfilter_pkt_clr(struct bt_devfilter *filter, uint8_t type);
 174 int             bt_devfilter_pkt_tst(struct bt_devfilter const *filter, uint8_t type);
 175 void            bt_devfilter_evt_set(struct bt_devfilter *filter, uint8_t event);
 176 void            bt_devfilter_evt_clr(struct bt_devfilter *filter, uint8_t event);
 177 int             bt_devfilter_evt_tst(struct bt_devfilter const *filter, uint8_t event);
 178 int             bt_devinquiry(char const *devname, time_t length, int num_rsp,
 179                               struct bt_devinquiry **ii);
 180 int             bt_devinfo (struct bt_devinfo *di);
 181 int             bt_devenum (bt_devenum_cb_t *cb, void *arg);
 182
 183 /*
 184  * bdaddr utility functions (from NetBSD)
 185  */
 186
 187 static __inline int
 188 bdaddr_same(const bdaddr_t *a, const bdaddr_t *b)
 189 {
 190         return (a->b[0] == b->b[0] && a->b[1] == b->b[1] &&
 191                 a->b[2] == b->b[2] && a->b[3] == b->b[3] &&
 192                 a->b[4] == b->b[4] && a->b[5] == b->b[5]);
 193 }
 194
 195 static __inline int
 196 bdaddr_any(const bdaddr_t *a)
 197 {
 198         return (a->b[0] == 0 && a->b[1] == 0 && a->b[2] == 0 &&
 199                 a->b[3] == 0 && a->b[4] == 0 && a->b[5] == 0);
 200 }
 201
 202 static __inline void
 203 bdaddr_copy(bdaddr_t *d, const bdaddr_t *s)
 204 {
 205         d->b[0] = s->b[0];
 206         d->b[1] = s->b[1];
 207         d->b[2] = s->b[2];
 208         d->b[3] = s->b[3];
 209         d->b[4] = s->b[4];
 210         d->b[5] = s->b[5];
 211 }
 212
 213 __END_DECLS
 214
 215 #endif /* ndef _BLUETOOTH_H_ */
 216