include/net/bluetooth/hci_core.h

   1 /*
   2    BlueZ - Bluetooth protocol stack for Linux
   3    Copyright (c) 2000-2001, 2010, Code Aurora Forum. All rights reserved.
   4
   5    Written 2000,2001 by Maxim Krasnyansky <maxk@qualcomm.com>
   6
   7    This program is free software; you can redistribute it and/or modify
   8    it under the terms of the GNU General Public License version 2 as
   9    published by the Free Software Foundation;
  10
  11    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
  12    OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  13    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS.
  14    IN NO EVENT SHALL THE COPYRIGHT HOLDER(S) AND AUTHOR(S) BE LIABLE FOR ANY
  15    CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES
  16    WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  17    ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  18    OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  19
  20    ALL LIABILITY, INCLUDING LIABILITY FOR INFRINGEMENT OF ANY PATENTS,
  21    COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS, RELATING TO USE OF THIS
  22    SOFTWARE IS DISCLAIMED.
  23 */
  24
  25 #ifndef __HCI_CORE_H
  26 #define __HCI_CORE_H
  27
  28 #include <net/bluetooth/hci.h>
  29
  30 /* HCI priority */
  31 #define HCI_PRIO_MAX    7
  32
  33 /* HCI Core structures */
  34 struct inquiry_data {
  35         bdaddr_t        bdaddr;
  36         __u8            pscan_rep_mode;
  37         __u8            pscan_period_mode;
  38         __u8            pscan_mode;
  39         __u8            dev_class[3];
  40         __le16          clock_offset;
  41         __s8            rssi;
  42         __u8            ssp_mode;
  43 };
  44
  45 struct inquiry_entry {
  46         struct list_head        all;            /* inq_cache.all */
  47         struct list_head        list;           /* unknown or resolve */
  48         enum {
  49                 NAME_NOT_KNOWN,
  50                 NAME_NEEDED,
  51                 NAME_PENDING,
  52                 NAME_KNOWN,
  53         } name_state;
  54         __u32                   timestamp;
  55         struct inquiry_data     data;
  56 };
  57
  58 struct discovery_state {
  59         int                     type;
  60         enum {
  61                 DISCOVERY_STOPPED,
  62                 DISCOVERY_STARTING,
  63                 DISCOVERY_FINDING,
  64                 DISCOVERY_RESOLVING,
  65                 DISCOVERY_STOPPING,
  66         } state;
  67         struct list_head        all;    /* All devices found during inquiry */
  68         struct list_head        unknown;        /* Name state not known */
  69         struct list_head        resolve;        /* Name needs to be resolved */
  70         __u32                   timestamp;
  71 };
  72
  73 struct hci_conn_hash {
  74         struct list_head list;
  75         unsigned int     acl_num;
  76         unsigned int     amp_num;
  77         unsigned int     sco_num;
  78         unsigned int     le_num;
  79 };
  80
  81 struct bdaddr_list {
  82         struct list_head list;
  83         bdaddr_t bdaddr;
  84 };
  85
  86 struct bt_uuid {
  87         struct list_head list;
  88         u8 uuid[16];
  89         u8 size;
  90         u8 svc_hint;
  91 };
  92
  93 struct smp_ltk {
  94         struct list_head list;
  95         bdaddr_t bdaddr;
  96         u8 bdaddr_type;
  97         u8 authenticated;
  98         u8 type;
  99         u8 enc_size;
 100         __le16 ediv;
 101         u8 rand[8];
 102         u8 val[16];
 103 } __packed;
 104
 105 struct link_key {
 106         struct list_head list;
 107         bdaddr_t bdaddr;
 108         u8 type;
 109         u8 val[HCI_LINK_KEY_SIZE];
 110         u8 pin_len;
 111 };
 112
 113 struct oob_data {
 114         struct list_head list;
 115         bdaddr_t bdaddr;
 116         u8 hash[16];
 117         u8 randomizer[16];
 118 };
 119
 120 struct le_scan_params {
 121         u8 type;
 122         u16 interval;
 123         u16 window;
 124         int timeout;
 125 };
 126
 127 #define HCI_MAX_SHORT_NAME_LENGTH       10
 128
 129 struct amp_assoc {
 130         __u16   len;
 131         __u16   offset;
 132         __u16   rem_len;
 133         __u16   len_so_far;
 134         __u8    data[HCI_MAX_AMP_ASSOC_SIZE];
 135 };
 136
 137 #define NUM_REASSEMBLY 4
 138 struct hci_dev {
 139         struct list_head list;
 140         struct mutex    lock;
 141
 142         char            name[8];
 143         unsigned long   flags;
 144         __u16           id;
 145         __u8            bus;
 146         __u8            dev_type;
 147         bdaddr_t        bdaddr;
 148         __u8            dev_name[HCI_MAX_NAME_LENGTH];
 149         __u8            short_name[HCI_MAX_SHORT_NAME_LENGTH];
 150         __u8            eir[HCI_MAX_EIR_LENGTH];
 151         __u8            dev_class[3];
 152         __u8            major_class;
 153         __u8            minor_class;
 154         __u8            features[8];
 155         __u8            host_features[8];
 156         __u8            le_features[8];
 157         __u8            le_white_list_size;
 158         __u8            le_states[8];
 159         __u8            commands[64];
 160         __u8            hci_ver;
 161         __u16           hci_rev;
 162         __u8            lmp_ver;
 163         __u16           manufacturer;
 164         __u16           lmp_subver;
 165         __u16           voice_setting;
 166         __u8            io_capability;
 167         __s8            inq_tx_power;
 168         __u16           devid_source;
 169         __u16           devid_vendor;
 170         __u16           devid_product;
 171         __u16           devid_version;
 172
 173         __u16           pkt_type;
 174         __u16           esco_type;
 175         __u16           link_policy;
 176         __u16           link_mode;
 177
 178         __u32           idle_timeout;
 179         __u16           sniff_min_interval;
 180         __u16           sniff_max_interval;
 181
 182         __u8            amp_status;
 183         __u32           amp_total_bw;
 184         __u32           amp_max_bw;
 185         __u32           amp_min_latency;
 186         __u32           amp_max_pdu;
 187         __u8            amp_type;
 188         __u16           amp_pal_cap;
 189         __u16           amp_assoc_size;
 190         __u32           amp_max_flush_to;
 191         __u32           amp_be_flush_to;
 192
 193         struct amp_assoc        loc_assoc;
 194
 195         __u8            flow_ctl_mode;
 196
 197         unsigned int    auto_accept_delay;
 198
 199         unsigned long   quirks;
 200
 201         atomic_t        cmd_cnt;
 202         unsigned int    acl_cnt;
 203         unsigned int    sco_cnt;
 204         unsigned int    le_cnt;
 205
 206         unsigned int    acl_mtu;
 207         unsigned int    sco_mtu;
 208         unsigned int    le_mtu;
 209         unsigned int    acl_pkts;
 210         unsigned int    sco_pkts;
 211         unsigned int    le_pkts;
 212
 213         __u16           block_len;
 214         __u16           block_mtu;
 215         __u16           num_blocks;
 216         __u16           block_cnt;
 217
 218         unsigned long   acl_last_tx;
 219         unsigned long   sco_last_tx;
 220         unsigned long   le_last_tx;
 221
 222         struct workqueue_struct *workqueue;
 223         struct workqueue_struct *req_workqueue;
 224
 225         struct work_struct      power_on;
 226         struct delayed_work     power_off;
 227
 228         __u16                   discov_timeout;
 229         struct delayed_work     discov_off;
 230
 231         struct delayed_work     service_cache;
 232
 233         struct timer_list       cmd_timer;
 234
 235         struct work_struct      rx_work;
 236         struct work_struct      cmd_work;
 237         struct work_struct      tx_work;
 238
 239         struct sk_buff_head     rx_q;
 240         struct sk_buff_head     raw_q;
 241         struct sk_buff_head     cmd_q;
 242
 243         struct sk_buff          *sent_cmd;
 244         struct sk_buff          *reassembly[NUM_REASSEMBLY];
 245
 246         struct mutex            req_lock;
 247         wait_queue_head_t       req_wait_q;
 248         __u32                   req_status;
 249         __u32                   req_result;
 250
 251         struct list_head        mgmt_pending;
 252
 253         struct discovery_state  discovery;
 254         struct hci_conn_hash    conn_hash;
 255         struct list_head        blacklist;
 256
 257         struct list_head        uuids;
 258
 259         struct list_head        link_keys;
 260
 261         struct list_head        long_term_keys;
 262
 263         struct list_head        remote_oob_data;
 264
 265         struct hci_dev_stats    stat;
 266
 267         struct sk_buff_head     driver_init;
 268
 269         atomic_t                promisc;
 270
 271         struct dentry           *debugfs;
 272
 273         struct device           dev;
 274
 275         struct rfkill           *rfkill;
 276
 277         unsigned long           dev_flags;
 278
 279         struct delayed_work     le_scan_disable;
 280
 281         struct work_struct      le_scan;
 282         struct le_scan_params   le_scan_params;
 283
 284         __s8                    adv_tx_power;
 285         __u8                    adv_data[HCI_MAX_AD_LENGTH];
 286         __u8                    adv_data_len;
 287
 288         int (*open)(struct hci_dev *hdev);
 289         int (*close)(struct hci_dev *hdev);
 290         int (*flush)(struct hci_dev *hdev);
 291         int (*send)(struct sk_buff *skb);
 292         void (*notify)(struct hci_dev *hdev, unsigned int evt);
 293         int (*ioctl)(struct hci_dev *hdev, unsigned int cmd, unsigned long arg);
 294 };
 295
 296 #define HCI_PHY_HANDLE(handle)  (handle & 0xff)
 297
 298 struct hci_conn {
 299         struct list_head list;
 300
 301         atomic_t        refcnt;
 302
 303         bdaddr_t        dst;
 304         __u8            dst_type;
 305         __u16           handle;
 306         __u16           state;
 307         __u8            mode;
 308         __u8            type;
 309         bool            out;
 310         __u8            attempt;
 311         __u8            dev_class[3];
 312         __u8            features[8];
 313         __u16           interval;
 314         __u16           pkt_type;
 315         __u16           link_policy;
 316         __u32           link_mode;
 317         __u8            key_type;
 318         __u8            auth_type;
 319         __u8            sec_level;
 320         __u8            pending_sec_level;
 321         __u8            pin_length;
 322         __u8            enc_key_size;
 323         __u8            io_capability;
 324         __u32           passkey_notify;
 325         __u8            passkey_entered;
 326         __u16           disc_timeout;
 327         unsigned long   flags;
 328
 329         __u8            remote_cap;
 330         __u8            remote_auth;
 331         __u8            remote_id;
 332         bool            flush_key;
 333
 334         unsigned int    sent;
 335
 336         struct sk_buff_head data_q;
 337         struct list_head chan_list;
 338
 339         struct delayed_work disc_work;
 340         struct timer_list idle_timer;
 341         struct timer_list auto_accept_timer;
 342
 343         struct device   dev;
 344         atomic_t        devref;
 345
 346         struct hci_dev  *hdev;
 347         void            *l2cap_data;
 348         void            *sco_data;
 349         void            *smp_conn;
 350         struct amp_mgr  *amp_mgr;
 351
 352         struct hci_conn *link;
 353
 354         void (*connect_cfm_cb)  (struct hci_conn *conn, u8 status);
 355         void (*security_cfm_cb) (struct hci_conn *conn, u8 status);
 356         void (*disconn_cfm_cb)  (struct hci_conn *conn, u8 reason);
 357 };
 358
 359 struct hci_chan {
 360         struct list_head list;
 361         __u16 handle;
 362         struct hci_conn *conn;
 363         struct sk_buff_head data_q;
 364         unsigned int    sent;
 365         __u8            state;
 366 };
 367
 368 extern struct list_head hci_dev_list;
 369 extern struct list_head hci_cb_list;
 370 extern rwlock_t hci_dev_list_lock;
 371 extern rwlock_t hci_cb_list_lock;
 372
 373 /* ----- HCI interface to upper protocols ----- */
 374 extern int l2cap_connect_ind(struct hci_dev *hdev, bdaddr_t *bdaddr);
 375 extern void l2cap_connect_cfm(struct hci_conn *hcon, u8 status);
 376 extern int l2cap_disconn_ind(struct hci_conn *hcon);
 377 extern void l2cap_disconn_cfm(struct hci_conn *hcon, u8 reason);
 378 extern int l2cap_security_cfm(struct hci_conn *hcon, u8 status, u8 encrypt);
 379 extern int l2cap_recv_acldata(struct hci_conn *hcon, struct sk_buff *skb,
 380                               u16 flags);
 381
 382 extern int sco_connect_ind(struct hci_dev *hdev, bdaddr_t *bdaddr, __u8 *flags);
 383 extern void sco_connect_cfm(struct hci_conn *hcon, __u8 status);
 384 extern void sco_disconn_cfm(struct hci_conn *hcon, __u8 reason);
 385 extern int sco_recv_scodata(struct hci_conn *hcon, struct sk_buff *skb);
 386
 387 /* ----- Inquiry cache ----- */
 388 #define INQUIRY_CACHE_AGE_MAX   (HZ*30)   /* 30 seconds */
 389 #define INQUIRY_ENTRY_AGE_MAX   (HZ*60)   /* 60 seconds */
 390
 391 static inline void discovery_init(struct hci_dev *hdev)
 392 {
 393         hdev->discovery.state = DISCOVERY_STOPPED;
 394         INIT_LIST_HEAD(&hdev->discovery.all);
 395         INIT_LIST_HEAD(&hdev->discovery.unknown);
 396         INIT_LIST_HEAD(&hdev->discovery.resolve);
 397 }
 398
 399 bool hci_discovery_active(struct hci_dev *hdev);
 400
 401 void hci_discovery_set_state(struct hci_dev *hdev, int state);
 402
 403 static inline int inquiry_cache_empty(struct hci_dev *hdev)
 404 {
 405         return list_empty(&hdev->discovery.all);
 406 }
 407
 408 static inline long inquiry_cache_age(struct hci_dev *hdev)
 409 {
 410         struct discovery_state *c = &hdev->discovery;
 411         return jiffies - c->timestamp;
 412 }
 413
 414 static inline long inquiry_entry_age(struct inquiry_entry *e)
 415 {
 416         return jiffies - e->timestamp;
 417 }
 418
 419 struct inquiry_entry *hci_inquiry_cache_lookup(struct hci_dev *hdev,
 420                                                bdaddr_t *bdaddr);
 421 struct inquiry_entry *hci_inquiry_cache_lookup_unknown(struct hci_dev *hdev,
 422                                                        bdaddr_t *bdaddr);
 423 struct inquiry_entry *hci_inquiry_cache_lookup_resolve(struct hci_dev *hdev,
 424                                                        bdaddr_t *bdaddr,
 425                                                        int state);
 426 void hci_inquiry_cache_update_resolve(struct hci_dev *hdev,
 427                                       struct inquiry_entry *ie);
 428 bool hci_inquiry_cache_update(struct hci_dev *hdev, struct inquiry_data *data,
 429                               bool name_known, bool *ssp);
 430
 431 /* ----- HCI Connections ----- */
 432 enum {
 433         HCI_CONN_AUTH_PEND,
 434         HCI_CONN_REAUTH_PEND,
 435         HCI_CONN_ENCRYPT_PEND,
 436         HCI_CONN_RSWITCH_PEND,
 437         HCI_CONN_MODE_CHANGE_PEND,
 438         HCI_CONN_SCO_SETUP_PEND,
 439         HCI_CONN_LE_SMP_PEND,
 440         HCI_CONN_MGMT_CONNECTED,
 441         HCI_CONN_SSP_ENABLED,
 442         HCI_CONN_POWER_SAVE,
 443         HCI_CONN_REMOTE_OOB,
 444 };
 445
 446 static inline bool hci_conn_ssp_enabled(struct hci_conn *conn)
 447 {
 448         struct hci_dev *hdev = conn->hdev;
 449         return test_bit(HCI_SSP_ENABLED, &hdev->dev_flags) &&
 450                test_bit(HCI_CONN_SSP_ENABLED, &conn->flags);
 451 }
 452
 453 static inline void hci_conn_hash_add(struct hci_dev *hdev, struct hci_conn *c)
 454 {
 455         struct hci_conn_hash *h = &hdev->conn_hash;
 456         list_add_rcu(&c->list, &h->list);
 457         switch (c->type) {
 458         case ACL_LINK:
 459                 h->acl_num++;
 460                 break;
 461         case AMP_LINK:
 462                 h->amp_num++;
 463                 break;
 464         case LE_LINK:
 465                 h->le_num++;
 466                 break;
 467         case SCO_LINK:
 468         case ESCO_LINK:
 469                 h->sco_num++;
 470                 break;
 471         }
 472 }
 473
 474 static inline void hci_conn_hash_del(struct hci_dev *hdev, struct hci_conn *c)
 475 {
 476         struct hci_conn_hash *h = &hdev->conn_hash;
 477
 478         list_del_rcu(&c->list);
 479         synchronize_rcu();
 480
 481         switch (c->type) {
 482         case ACL_LINK:
 483                 h->acl_num--;
 484                 break;
 485         case AMP_LINK:
 486                 h->amp_num--;
 487                 break;
 488         case LE_LINK:
 489                 h->le_num--;
 490                 break;
 491         case SCO_LINK:
 492         case ESCO_LINK:
 493                 h->sco_num--;
 494                 break;
 495         }
 496 }
 497
 498 static inline unsigned int hci_conn_num(struct hci_dev *hdev, __u8 type)
 499 {
 500         struct hci_conn_hash *h = &hdev->conn_hash;
 501         switch (type) {
 502         case ACL_LINK:
 503                 return h->acl_num;
 504         case AMP_LINK:
 505                 return h->amp_num;
 506         case LE_LINK:
 507                 return h->le_num;
 508         case SCO_LINK:
 509         case ESCO_LINK:
 510                 return h->sco_num;
 511         default:
 512                 return 0;
 513         }
 514 }
 515
 516 static inline struct hci_conn *hci_conn_hash_lookup_handle(struct hci_dev *hdev,
 517                                                                 __u16 handle)
 518 {
 519         struct hci_conn_hash *h = &hdev->conn_hash;
 520         struct hci_conn  *c;
 521
 522         rcu_read_lock();
 523
 524         list_for_each_entry_rcu(c, &h->list, list) {
 525                 if (c->handle == handle) {
 526                         rcu_read_unlock();
 527                         return c;
 528                 }
 529         }
 530         rcu_read_unlock();
 531
 532         return NULL;
 533 }
 534
 535 static inline struct hci_conn *hci_conn_hash_lookup_ba(struct hci_dev *hdev,
 536                                                         __u8 type, bdaddr_t *ba)
 537 {
 538         struct hci_conn_hash *h = &hdev->conn_hash;
 539         struct hci_conn  *c;
 540
 541         rcu_read_lock();
 542
 543         list_for_each_entry_rcu(c, &h->list, list) {
 544                 if (c->type == type && !bacmp(&c->dst, ba)) {
 545                         rcu_read_unlock();
 546                         return c;
 547                 }
 548         }
 549
 550         rcu_read_unlock();
 551
 552         return NULL;
 553 }
 554
 555 static inline struct hci_conn *hci_conn_hash_lookup_state(struct hci_dev *hdev,
 556                                                         __u8 type, __u16 state)
 557 {
 558         struct hci_conn_hash *h = &hdev->conn_hash;
 559         struct hci_conn  *c;
 560
 561         rcu_read_lock();
 562
 563         list_for_each_entry_rcu(c, &h->list, list) {
 564                 if (c->type == type && c->state == state) {
 565                         rcu_read_unlock();
 566                         return c;
 567                 }
 568         }
 569
 570         rcu_read_unlock();
 571
 572         return NULL;
 573 }
 574
 575 void hci_disconnect(struct hci_conn *conn, __u8 reason);
 576 void hci_setup_sync(struct hci_conn *conn, __u16 handle);
 577 void hci_sco_setup(struct hci_conn *conn, __u8 status);
 578
 579 struct hci_conn *hci_conn_add(struct hci_dev *hdev, int type, bdaddr_t *dst);
 580 int hci_conn_del(struct hci_conn *conn);
 581 void hci_conn_hash_flush(struct hci_dev *hdev);
 582 void hci_conn_check_pending(struct hci_dev *hdev);
 583 void hci_conn_accept(struct hci_conn *conn, int mask);
 584
 585 struct hci_chan *hci_chan_create(struct hci_conn *conn);
 586 void hci_chan_del(struct hci_chan *chan);
 587 void hci_chan_list_flush(struct hci_conn *conn);
 588 struct hci_chan *hci_chan_lookup_handle(struct hci_dev *hdev, __u16 handle);
 589
 590 struct hci_conn *hci_connect(struct hci_dev *hdev, int type, bdaddr_t *dst,
 591                              __u8 dst_type, __u8 sec_level, __u8 auth_type);
 592 int hci_conn_check_link_mode(struct hci_conn *conn);
 593 int hci_conn_check_secure(struct hci_conn *conn, __u8 sec_level);
 594 int hci_conn_security(struct hci_conn *conn, __u8 sec_level, __u8 auth_type);
 595 int hci_conn_change_link_key(struct hci_conn *conn);
 596 int hci_conn_switch_role(struct hci_conn *conn, __u8 role);
 597
 598 void hci_conn_enter_active_mode(struct hci_conn *conn, __u8 force_active);
 599
 600 void hci_conn_hold_device(struct hci_conn *conn);
 601 void hci_conn_put_device(struct hci_conn *conn);
 602
 603 static inline void hci_conn_hold(struct hci_conn *conn)
 604 {
 605         BT_DBG("hcon %p orig refcnt %d", conn, atomic_read(&conn->refcnt));
 606
 607         atomic_inc(&conn->refcnt);
 608         cancel_delayed_work(&conn->disc_work);
 609 }
 610
 611 static inline void hci_conn_put(struct hci_conn *conn)
 612 {
 613         BT_DBG("hcon %p orig refcnt %d", conn, atomic_read(&conn->refcnt));
 614
 615         if (atomic_dec_and_test(&conn->refcnt)) {
 616                 unsigned long timeo;
 617
 618                 switch (conn->type) {
 619                 case ACL_LINK:
 620                 case LE_LINK:
 621                         del_timer(&conn->idle_timer);
 622                         if (conn->state == BT_CONNECTED) {
 623                                 timeo = conn->disc_timeout;
 624                                 if (!conn->out)
 625                                         timeo *= 2;
 626                         } else {
 627                                 timeo = msecs_to_jiffies(10);
 628                         }
 629                         break;
 630
 631                 case AMP_LINK:
 632                         timeo = conn->disc_timeout;
 633                         break;
 634
 635                 default:
 636                         timeo = msecs_to_jiffies(10);
 637                         break;
 638                 }
 639
 640                 cancel_delayed_work(&conn->disc_work);
 641                 queue_delayed_work(conn->hdev->workqueue,
 642                                    &conn->disc_work, timeo);
 643         }
 644 }
 645
 646 /* ----- HCI Devices ----- */
 647 static inline void hci_dev_put(struct hci_dev *d)
 648 {
 649         BT_DBG("%s orig refcnt %d", d->name,
 650                atomic_read(&d->dev.kobj.kref.refcount));
 651
 652         put_device(&d->dev);
 653 }
 654
 655 static inline struct hci_dev *hci_dev_hold(struct hci_dev *d)
 656 {
 657         BT_DBG("%s orig refcnt %d", d->name,
 658                atomic_read(&d->dev.kobj.kref.refcount));
 659
 660         get_device(&d->dev);
 661         return d;
 662 }
 663
 664 #define hci_dev_lock(d)         mutex_lock(&d->lock)
 665 #define hci_dev_unlock(d)       mutex_unlock(&d->lock)
 666
 667 #define to_hci_dev(d) container_of(d, struct hci_dev, dev)
 668 #define to_hci_conn(c) container_of(c, struct hci_conn, dev)
 669
 670 static inline void *hci_get_drvdata(struct hci_dev *hdev)
 671 {
 672         return dev_get_drvdata(&hdev->dev);
 673 }
 674
 675 static inline void hci_set_drvdata(struct hci_dev *hdev, void *data)
 676 {
 677         dev_set_drvdata(&hdev->dev, data);
 678 }
 679
 680 /* hci_dev_list shall be locked */
 681 static inline uint8_t __hci_num_ctrl(void)
 682 {
 683         uint8_t count = 0;
 684         struct list_head *p;
 685
 686         list_for_each(p, &hci_dev_list) {
 687                 count++;
 688         }
 689
 690         return count;
 691 }
 692
 693 struct hci_dev *hci_dev_get(int index);
 694 struct hci_dev *hci_get_route(bdaddr_t *dst, bdaddr_t *src);
 695
 696 struct hci_dev *hci_alloc_dev(void);
 697 void hci_free_dev(struct hci_dev *hdev);
 698 int hci_register_dev(struct hci_dev *hdev);
 699 void hci_unregister_dev(struct hci_dev *hdev);
 700 int hci_suspend_dev(struct hci_dev *hdev);
 701 int hci_resume_dev(struct hci_dev *hdev);
 702 int hci_dev_open(__u16 dev);
 703 int hci_dev_close(__u16 dev);
 704 int hci_dev_reset(__u16 dev);
 705 int hci_dev_reset_stat(__u16 dev);
 706 int hci_dev_cmd(unsigned int cmd, void __user *arg);
 707 int hci_get_dev_list(void __user *arg);
 708 int hci_get_dev_info(void __user *arg);
 709 int hci_get_conn_list(void __user *arg);
 710 int hci_get_conn_info(struct hci_dev *hdev, void __user *arg);
 711 int hci_get_auth_info(struct hci_dev *hdev, void __user *arg);
 712 int hci_inquiry(void __user *arg);
 713
 714 struct bdaddr_list *hci_blacklist_lookup(struct hci_dev *hdev,
 715                                          bdaddr_t *bdaddr);
 716 int hci_blacklist_clear(struct hci_dev *hdev);
 717 int hci_blacklist_add(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 type);
 718 int hci_blacklist_del(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 type);
 719
 720 int hci_uuids_clear(struct hci_dev *hdev);
 721
 722 int hci_link_keys_clear(struct hci_dev *hdev);
 723 struct link_key *hci_find_link_key(struct hci_dev *hdev, bdaddr_t *bdaddr);
 724 int hci_add_link_key(struct hci_dev *hdev, struct hci_conn *conn, int new_key,
 725                      bdaddr_t *bdaddr, u8 *val, u8 type, u8 pin_len);
 726 struct smp_ltk *hci_find_ltk(struct hci_dev *hdev, __le16 ediv, u8 rand[8]);
 727 int hci_add_ltk(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 addr_type, u8 type,
 728                 int new_key, u8 authenticated, u8 tk[16], u8 enc_size,
 729                 __le16 ediv, u8 rand[8]);
 730 struct smp_ltk *hci_find_ltk_by_addr(struct hci_dev *hdev, bdaddr_t *bdaddr,
 731                                      u8 addr_type);
 732 int hci_remove_ltk(struct hci_dev *hdev, bdaddr_t *bdaddr);
 733 int hci_smp_ltks_clear(struct hci_dev *hdev);
 734 int hci_remove_link_key(struct hci_dev *hdev, bdaddr_t *bdaddr);
 735
 736 int hci_remote_oob_data_clear(struct hci_dev *hdev);
 737 struct oob_data *hci_find_remote_oob_data(struct hci_dev *hdev,
 738                                                         bdaddr_t *bdaddr);
 739 int hci_add_remote_oob_data(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 *hash,
 740                                                                 u8 *randomizer);
 741 int hci_remove_remote_oob_data(struct hci_dev *hdev, bdaddr_t *bdaddr);
 742
 743 void hci_event_packet(struct hci_dev *hdev, struct sk_buff *skb);
 744
 745 int hci_recv_frame(struct sk_buff *skb);
 746 int hci_recv_fragment(struct hci_dev *hdev, int type, void *data, int count);
 747 int hci_recv_stream_fragment(struct hci_dev *hdev, void *data, int count);
 748
 749 void hci_init_sysfs(struct hci_dev *hdev);
 750 int hci_add_sysfs(struct hci_dev *hdev);
 751 void hci_del_sysfs(struct hci_dev *hdev);
 752 void hci_conn_init_sysfs(struct hci_conn *conn);
 753 void hci_conn_add_sysfs(struct hci_conn *conn);
 754 void hci_conn_del_sysfs(struct hci_conn *conn);
 755
 756 #define SET_HCIDEV_DEV(hdev, pdev) ((hdev)->dev.parent = (pdev))
 757
 758 /* ----- LMP capabilities ----- */
 759 #define lmp_encrypt_capable(dev)   ((dev)->features[0] & LMP_ENCRYPT)
 760 #define lmp_rswitch_capable(dev)   ((dev)->features[0] & LMP_RSWITCH)
 761 #define lmp_hold_capable(dev)      ((dev)->features[0] & LMP_HOLD)
 762 #define lmp_sniff_capable(dev)     ((dev)->features[0] & LMP_SNIFF)
 763 #define lmp_park_capable(dev)      ((dev)->features[1] & LMP_PARK)
 764 #define lmp_inq_rssi_capable(dev)  ((dev)->features[3] & LMP_RSSI_INQ)
 765 #define lmp_esco_capable(dev)      ((dev)->features[3] & LMP_ESCO)
 766 #define lmp_bredr_capable(dev)     (!((dev)->features[4] & LMP_NO_BREDR))
 767 #define lmp_le_capable(dev)        ((dev)->features[4] & LMP_LE)
 768 #define lmp_sniffsubr_capable(dev) ((dev)->features[5] & LMP_SNIFF_SUBR)
 769 #define lmp_pause_enc_capable(dev) ((dev)->features[5] & LMP_PAUSE_ENC)
 770 #define lmp_ext_inq_capable(dev)   ((dev)->features[6] & LMP_EXT_INQ)
 771 #define lmp_le_br_capable(dev)     !!((dev)->features[6] & LMP_SIMUL_LE_BR)
 772 #define lmp_ssp_capable(dev)       ((dev)->features[6] & LMP_SIMPLE_PAIR)
 773 #define lmp_no_flush_capable(dev)  ((dev)->features[6] & LMP_NO_FLUSH)
 774 #define lmp_lsto_capable(dev)      ((dev)->features[7] & LMP_LSTO)
 775 #define lmp_inq_tx_pwr_capable(dev) ((dev)->features[7] & LMP_INQ_TX_PWR)
 776 #define lmp_ext_feat_capable(dev)  ((dev)->features[7] & LMP_EXTFEATURES)
 777
 778 /* ----- Extended LMP capabilities ----- */
 779 #define lmp_host_ssp_capable(dev)  ((dev)->host_features[0] & LMP_HOST_SSP)
 780 #define lmp_host_le_capable(dev)   !!((dev)->host_features[0] & LMP_HOST_LE)
 781 #define lmp_host_le_br_capable(dev) !!((dev)->host_features[0] & LMP_HOST_LE_BREDR)
 782
 783 /* returns true if at least one AMP active */
 784 static inline bool hci_amp_capable(void)
 785 {
 786         struct hci_dev *hdev;
 787         bool ret = false;
 788
 789         read_lock(&hci_dev_list_lock);
 790         list_for_each_entry(hdev, &hci_dev_list, list)
 791                 if (hdev->amp_type == HCI_AMP &&
 792                     test_bit(HCI_UP, &hdev->flags))
 793                         ret = true;
 794         read_unlock(&hci_dev_list_lock);
 795
 796         return ret;
 797 }
 798
 799 /* ----- HCI protocols ----- */
 800 #define HCI_PROTO_DEFER             0x01
 801
 802 static inline int hci_proto_connect_ind(struct hci_dev *hdev, bdaddr_t *bdaddr,
 803                                         __u8 type, __u8 *flags)
 804 {
 805         switch (type) {
 806         case ACL_LINK:
 807                 return l2cap_connect_ind(hdev, bdaddr);
 808
 809         case SCO_LINK:
 810         case ESCO_LINK:
 811                 return sco_connect_ind(hdev, bdaddr, flags);
 812
 813         default:
 814                 BT_ERR("unknown link type %d", type);
 815                 return -EINVAL;
 816         }
 817 }
 818
 819 static inline void hci_proto_connect_cfm(struct hci_conn *conn, __u8 status)
 820 {
 821         switch (conn->type) {
 822         case ACL_LINK:
 823         case LE_LINK:
 824                 l2cap_connect_cfm(conn, status);
 825                 break;
 826
 827         case SCO_LINK:
 828         case ESCO_LINK:
 829                 sco_connect_cfm(conn, status);
 830                 break;
 831
 832         default:
 833                 BT_ERR("unknown link type %d", conn->type);
 834                 break;
 835         }
 836
 837         if (conn->connect_cfm_cb)
 838                 conn->connect_cfm_cb(conn, status);
 839 }
 840
 841 static inline int hci_proto_disconn_ind(struct hci_conn *conn)
 842 {
 843         if (conn->type != ACL_LINK && conn->type != LE_LINK)
 844                 return HCI_ERROR_REMOTE_USER_TERM;
 845
 846         return l2cap_disconn_ind(conn);
 847 }
 848
 849 static inline void hci_proto_disconn_cfm(struct hci_conn *conn, __u8 reason)
 850 {
 851         switch (conn->type) {
 852         case ACL_LINK:
 853         case LE_LINK:
 854                 l2cap_disconn_cfm(conn, reason);
 855                 break;
 856
 857         case SCO_LINK:
 858         case ESCO_LINK:
 859                 sco_disconn_cfm(conn, reason);
 860                 break;
 861
 862         /* L2CAP would be handled for BREDR chan */
 863         case AMP_LINK:
 864                 break;
 865
 866         default:
 867                 BT_ERR("unknown link type %d", conn->type);
 868                 break;
 869         }
 870
 871         if (conn->disconn_cfm_cb)
 872                 conn->disconn_cfm_cb(conn, reason);
 873 }
 874
 875 static inline void hci_proto_auth_cfm(struct hci_conn *conn, __u8 status)
 876 {
 877         __u8 encrypt;
 878
 879         if (conn->type != ACL_LINK && conn->type != LE_LINK)
 880                 return;
 881
 882         if (test_bit(HCI_CONN_ENCRYPT_PEND, &conn->flags))
 883                 return;
 884
 885         encrypt = (conn->link_mode & HCI_LM_ENCRYPT) ? 0x01 : 0x00;
 886         l2cap_security_cfm(conn, status, encrypt);
 887
 888         if (conn->security_cfm_cb)
 889                 conn->security_cfm_cb(conn, status);
 890 }
 891
 892 static inline void hci_proto_encrypt_cfm(struct hci_conn *conn, __u8 status,
 893                                                                 __u8 encrypt)
 894 {
 895         if (conn->type != ACL_LINK && conn->type != LE_LINK)
 896                 return;
 897
 898         l2cap_security_cfm(conn, status, encrypt);
 899
 900         if (conn->security_cfm_cb)
 901                 conn->security_cfm_cb(conn, status);
 902 }
 903
 904 /* ----- HCI callbacks ----- */
 905 struct hci_cb {
 906         struct list_head list;
 907
 908         char *name;
 909
 910         void (*security_cfm)    (struct hci_conn *conn, __u8 status,
 911                                                                 __u8 encrypt);
 912         void (*key_change_cfm)  (struct hci_conn *conn, __u8 status);
 913         void (*role_switch_cfm) (struct hci_conn *conn, __u8 status, __u8 role);
 914 };
 915
 916 static inline void hci_auth_cfm(struct hci_conn *conn, __u8 status)
 917 {
 918         struct hci_cb *cb;
 919         __u8 encrypt;
 920
 921         hci_proto_auth_cfm(conn, status);
 922
 923         if (test_bit(HCI_CONN_ENCRYPT_PEND, &conn->flags))
 924                 return;
 925
 926         encrypt = (conn->link_mode & HCI_LM_ENCRYPT) ? 0x01 : 0x00;
 927
 928         read_lock(&hci_cb_list_lock);
 929         list_for_each_entry(cb, &hci_cb_list, list) {
 930                 if (cb->security_cfm)
 931                         cb->security_cfm(conn, status, encrypt);
 932         }
 933         read_unlock(&hci_cb_list_lock);
 934 }
 935
 936 static inline void hci_encrypt_cfm(struct hci_conn *conn, __u8 status,
 937                                                                 __u8 encrypt)
 938 {
 939         struct hci_cb *cb;
 940
 941         if (conn->sec_level == BT_SECURITY_SDP)
 942                 conn->sec_level = BT_SECURITY_LOW;
 943
 944         if (conn->pending_sec_level > conn->sec_level)
 945                 conn->sec_level = conn->pending_sec_level;
 946
 947         hci_proto_encrypt_cfm(conn, status, encrypt);
 948
 949         read_lock(&hci_cb_list_lock);
 950         list_for_each_entry(cb, &hci_cb_list, list) {
 951                 if (cb->security_cfm)
 952                         cb->security_cfm(conn, status, encrypt);
 953         }
 954         read_unlock(&hci_cb_list_lock);
 955 }
 956
 957 static inline void hci_key_change_cfm(struct hci_conn *conn, __u8 status)
 958 {
 959         struct hci_cb *cb;
 960
 961         read_lock(&hci_cb_list_lock);
 962         list_for_each_entry(cb, &hci_cb_list, list) {
 963                 if (cb->key_change_cfm)
 964                         cb->key_change_cfm(conn, status);
 965         }
 966         read_unlock(&hci_cb_list_lock);
 967 }
 968
 969 static inline void hci_role_switch_cfm(struct hci_conn *conn, __u8 status,
 970                                                                 __u8 role)
 971 {
 972         struct hci_cb *cb;
 973
 974         read_lock(&hci_cb_list_lock);
 975         list_for_each_entry(cb, &hci_cb_list, list) {
 976                 if (cb->role_switch_cfm)
 977                         cb->role_switch_cfm(conn, status, role);
 978         }
 979         read_unlock(&hci_cb_list_lock);
 980 }
 981
 982 static inline bool eir_has_data_type(u8 *data, size_t data_len, u8 type)
 983 {
 984         size_t parsed = 0;
 985
 986         if (data_len < 2)
 987                 return false;
 988
 989         while (parsed < data_len - 1) {
 990                 u8 field_len = data[0];
 991
 992                 if (field_len == 0)
 993                         break;
 994
 995                 parsed += field_len + 1;
 996
 997                 if (parsed > data_len)
 998                         break;
 999
1000                 if (data[1] == type)
1001                         return true;
1002
1003                 data += field_len + 1;
1004         }
1005
1006         return false;
1007 }
1008
1009 static inline size_t eir_get_length(u8 *eir, size_t eir_len)
1010 {
1011         size_t parsed = 0;
1012
1013         while (parsed < eir_len) {
1014                 u8 field_len = eir[0];
1015
1016                 if (field_len == 0)
1017                         return parsed;
1018
1019                 parsed += field_len + 1;
1020                 eir += field_len + 1;
1021         }
1022
1023         return eir_len;
1024 }
1025
1026 static inline u16 eir_append_data(u8 *eir, u16 eir_len, u8 type, u8 *data,
1027                                   u8 data_len)
1028 {
1029         eir[eir_len++] = sizeof(type) + data_len;
1030         eir[eir_len++] = type;
1031         memcpy(&eir[eir_len], data, data_len);
1032         eir_len += data_len;
1033
1034         return eir_len;
1035 }
1036
1037 int hci_register_cb(struct hci_cb *hcb);
1038 int hci_unregister_cb(struct hci_cb *hcb);
1039
1040 struct hci_request {
1041         struct hci_dev          *hdev;
1042         struct sk_buff_head     cmd_q;
1043
1044         /* If something goes wrong when building the HCI request, the error
1045          * value is stored in this field.
1046          */
1047         int                     err;
1048 };
1049
1050 void hci_req_init(struct hci_request *req, struct hci_dev *hdev);
1051 int hci_req_run(struct hci_request *req, hci_req_complete_t complete);
1052 void hci_req_add(struct hci_request *req, u16 opcode, u32 plen, void *param);
1053 void hci_req_cmd_complete(struct hci_dev *hdev, u16 opcode, u8 status);
1054 void hci_req_cmd_status(struct hci_dev *hdev, u16 opcode, u8 status);
1055
1056 int hci_send_cmd(struct hci_dev *hdev, __u16 opcode, __u32 plen, void *param);
1057 void hci_send_acl(struct hci_chan *chan, struct sk_buff *skb, __u16 flags);
1058 void hci_send_sco(struct hci_conn *conn, struct sk_buff *skb);
1059
1060 void *hci_sent_cmd_data(struct hci_dev *hdev, __u16 opcode);
1061
1062 /* ----- HCI Sockets ----- */
1063 void hci_send_to_sock(struct hci_dev *hdev, struct sk_buff *skb);
1064 void hci_send_to_control(struct sk_buff *skb, struct sock *skip_sk);
1065 void hci_send_to_monitor(struct hci_dev *hdev, struct sk_buff *skb);
1066
1067 void hci_sock_dev_event(struct hci_dev *hdev, int event);
1068
1069 /* Management interface */
1070 #define DISCOV_TYPE_BREDR               (BIT(BDADDR_BREDR))
1071 #define DISCOV_TYPE_LE                  (BIT(BDADDR_LE_PUBLIC) | \
1072                                          BIT(BDADDR_LE_RANDOM))
1073 #define DISCOV_TYPE_INTERLEAVED         (BIT(BDADDR_BREDR) | \
1074                                          BIT(BDADDR_LE_PUBLIC) | \
1075                                          BIT(BDADDR_LE_RANDOM))
1076
1077 int mgmt_control(struct sock *sk, struct msghdr *msg, size_t len);
1078 int mgmt_index_added(struct hci_dev *hdev);
1079 int mgmt_index_removed(struct hci_dev *hdev);
1080 int mgmt_powered(struct hci_dev *hdev, u8 powered);
1081 int mgmt_discoverable(struct hci_dev *hdev, u8 discoverable);
1082 int mgmt_connectable(struct hci_dev *hdev, u8 connectable);
1083 int mgmt_write_scan_failed(struct hci_dev *hdev, u8 scan, u8 status);
1084 int mgmt_new_link_key(struct hci_dev *hdev, struct link_key *key,
1085                       bool persistent);
1086 int mgmt_device_connected(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 link_type,
1087                           u8 addr_type, u32 flags, u8 *name, u8 name_len,
1088                           u8 *dev_class);
1089 int mgmt_device_disconnected(struct hci_dev *hdev, bdaddr_t *bdaddr,
1090                              u8 link_type, u8 addr_type, u8 reason);
1091 int mgmt_disconnect_failed(struct hci_dev *hdev, bdaddr_t *bdaddr,
1092                            u8 link_type, u8 addr_type, u8 status);
1093 int mgmt_connect_failed(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 link_type,
1094                         u8 addr_type, u8 status);
1095 int mgmt_pin_code_request(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 secure);
1096 int mgmt_pin_code_reply_complete(struct hci_dev *hdev, bdaddr_t *bdaddr,
1097                                  u8 status);
1098 int mgmt_pin_code_neg_reply_complete(struct hci_dev *hdev, bdaddr_t *bdaddr,
1099                                      u8 status);
1100 int mgmt_user_confirm_request(struct hci_dev *hdev, bdaddr_t *bdaddr,
1101                               u8 link_type, u8 addr_type, __le32 value,
1102                               u8 confirm_hint);
1103 int mgmt_user_confirm_reply_complete(struct hci_dev *hdev, bdaddr_t *bdaddr,
1104                                      u8 link_type, u8 addr_type, u8 status);
1105 int mgmt_user_confirm_neg_reply_complete(struct hci_dev *hdev, bdaddr_t *bdaddr,
1106                                          u8 link_type, u8 addr_type, u8 status);
1107 int mgmt_user_passkey_request(struct hci_dev *hdev, bdaddr_t *bdaddr,
1108                               u8 link_type, u8 addr_type);
1109 int mgmt_user_passkey_reply_complete(struct hci_dev *hdev, bdaddr_t *bdaddr,
1110                                      u8 link_type, u8 addr_type, u8 status);
1111 int mgmt_user_passkey_neg_reply_complete(struct hci_dev *hdev, bdaddr_t *bdaddr,
1112                                          u8 link_type, u8 addr_type, u8 status);
1113 int mgmt_user_passkey_notify(struct hci_dev *hdev, bdaddr_t *bdaddr,
1114                              u8 link_type, u8 addr_type, u32 passkey,
1115                              u8 entered);
1116 int mgmt_auth_failed(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 link_type,
1117                      u8 addr_type, u8 status);
1118 int mgmt_auth_enable_complete(struct hci_dev *hdev, u8 status);
1119 int mgmt_ssp_enable_complete(struct hci_dev *hdev, u8 enable, u8 status);
1120 int mgmt_set_class_of_dev_complete(struct hci_dev *hdev, u8 *dev_class,
1121                                    u8 status);
1122 int mgmt_set_local_name_complete(struct hci_dev *hdev, u8 *name, u8 status);
1123 int mgmt_read_local_oob_data_reply_complete(struct hci_dev *hdev, u8 *hash,
1124                                             u8 *randomizer, u8 status);
1125 int mgmt_le_enable_complete(struct hci_dev *hdev, u8 enable, u8 status);
1126 int mgmt_device_found(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 link_type,
1127                       u8 addr_type, u8 *dev_class, s8 rssi, u8 cfm_name,
1128                       u8 ssp, u8 *eir, u16 eir_len);
1129 int mgmt_remote_name(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 link_type,
1130                      u8 addr_type, s8 rssi, u8 *name, u8 name_len);
1131 int mgmt_start_discovery_failed(struct hci_dev *hdev, u8 status);
1132 int mgmt_stop_discovery_failed(struct hci_dev *hdev, u8 status);
1133 int mgmt_discovering(struct hci_dev *hdev, u8 discovering);
1134 int mgmt_interleaved_discovery(struct hci_dev *hdev);
1135 int mgmt_device_blocked(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 type);
1136 int mgmt_device_unblocked(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 type);
1137 bool mgmt_valid_hdev(struct hci_dev *hdev);
1138 int mgmt_new_ltk(struct hci_dev *hdev, struct smp_ltk *key, u8 persistent);
1139
1140 /* HCI info for socket */
1141 #define hci_pi(sk) ((struct hci_pinfo *) sk)
1142
1143 struct hci_pinfo {
1144         struct bt_sock    bt;
1145         struct hci_dev    *hdev;
1146         struct hci_filter filter;
1147         __u32             cmsg_mask;
1148         unsigned short   channel;
1149 };
1150
1151 /* HCI security filter */
1152 #define HCI_SFLT_MAX_OGF  5
1153
1154 struct hci_sec_filter {
1155         __u32 type_mask;
1156         __u32 event_mask[2];
1157         __u32 ocf_mask[HCI_SFLT_MAX_OGF + 1][4];
1158 };
1159
1160 /* ----- HCI requests ----- */
1161 #define HCI_REQ_DONE      0
1162 #define HCI_REQ_PEND      1
1163 #define HCI_REQ_CANCELED  2
1164
1165 #define hci_req_lock(d)         mutex_lock(&d->req_lock)
1166 #define hci_req_unlock(d)       mutex_unlock(&d->req_lock)
1167
1168 void hci_update_ad(struct hci_request *req);
1169
1170 void hci_le_conn_update(struct hci_conn *conn, u16 min, u16 max,
1171                                         u16 latency, u16 to_multiplier);
1172 void hci_le_start_enc(struct hci_conn *conn, __le16 ediv, __u8 rand[8],
1173                                                         __u8 ltk[16]);
1174 int hci_do_inquiry(struct hci_dev *hdev, u8 length);
1175 int hci_cancel_inquiry(struct hci_dev *hdev);
1176 int hci_le_scan(struct hci_dev *hdev, u8 type, u16 interval, u16 window,
1177                 int timeout);
1178 int hci_cancel_le_scan(struct hci_dev *hdev);
1179
1180 u8 bdaddr_to_le(u8 bdaddr_type);
1181
1182 #endif /* __HCI_CORE_H */