2 BlueZ - Bluetooth protocol stack for Linux
3 Copyright (c) 2000-2001, 2010, Code Aurora Forum. All rights reserved.
5 Written 2000,2001 by Maxim Krasnyansky <maxk@qualcomm.com>
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;
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.
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.
28 #include <linux/idr.h>
29 #include <linux/leds.h>
30 #include <linux/rculist.h>
32 #include <net/bluetooth/hci.h>
33 #include <net/bluetooth/hci_sock.h>
36 #define HCI_PRIO_MAX 7
38 /* HCI Core structures */
42 __u8 pscan_period_mode;
50 struct inquiry_entry {
51 struct list_head all; /* inq_cache.all */
52 struct list_head list; /* unknown or resolve */
60 struct inquiry_data data;
63 struct discovery_state {
72 struct list_head all; /* All devices found during inquiry */
73 struct list_head unknown; /* Name state not known */
74 struct list_head resolve; /* Name needs to be resolved */
76 bdaddr_t last_adv_addr;
77 u8 last_adv_addr_type;
80 u8 last_adv_data[HCI_MAX_AD_LENGTH];
82 bool report_invalid_rssi;
83 bool result_filtering;
88 unsigned long scan_start;
89 unsigned long scan_duration;
92 #define SUSPEND_NOTIFIER_TIMEOUT msecs_to_jiffies(2000) /* 2 seconds */
95 SUSPEND_PAUSE_DISCOVERY,
96 SUSPEND_UNPAUSE_DISCOVERY,
98 SUSPEND_PAUSE_ADVERTISING,
99 SUSPEND_UNPAUSE_ADVERTISING,
101 SUSPEND_SCAN_DISABLE,
103 SUSPEND_DISCONNECTING,
105 SUSPEND_POWERING_DOWN,
107 SUSPEND_PREPARE_NOTIFIER,
109 SUSPEND_SET_ADV_FILTER,
113 enum suspended_state {
115 BT_SUSPEND_DISCONNECT,
116 BT_SUSPEND_CONFIGURE_WAKE,
119 struct hci_conn_hash {
120 struct list_head list;
121 unsigned int acl_num;
122 unsigned int amp_num;
123 unsigned int sco_num;
125 unsigned int le_num_slave;
129 struct list_head list;
134 struct bdaddr_list_with_irk {
135 struct list_head list;
142 struct bdaddr_list_with_flags {
143 struct list_head list;
149 enum hci_conn_flags {
150 HCI_CONN_FLAG_REMOTE_WAKEUP,
154 #define hci_conn_test_flag(nr, flags) ((flags) & (1U << nr))
156 /* Make sure number of flags doesn't exceed sizeof(current_flags) */
157 static_assert(HCI_CONN_FLAG_MAX < 32);
160 struct list_head list;
167 struct list_head list;
181 struct list_head list;
194 struct list_head list;
203 struct list_head list;
207 u8 val[HCI_LINK_KEY_SIZE];
212 struct list_head list;
223 struct list_head list;
228 __u16 remaining_time;
231 __u8 adv_data[HCI_MAX_EXT_AD_LENGTH];
233 __u8 scan_rsp_data[HCI_MAX_EXT_AD_LENGTH];
237 bdaddr_t random_addr;
239 struct delayed_work rpa_expired_cb;
242 #define HCI_MAX_ADV_INSTANCES 5
243 #define HCI_DEFAULT_ADV_DURATION 2
245 #define HCI_ADV_TX_POWER_NO_PREFERENCE 0x7F
248 struct list_head list;
252 __u8 value[HCI_MAX_AD_LENGTH];
255 struct adv_rssi_thresholds {
258 __u16 low_threshold_timeout;
259 __u16 high_threshold_timeout;
260 __u8 sampling_period;
264 struct list_head patterns;
265 struct adv_rssi_thresholds rssi;
269 ADV_MONITOR_STATE_NOT_REGISTERED,
270 ADV_MONITOR_STATE_REGISTERED,
271 ADV_MONITOR_STATE_OFFLOADED
275 #define HCI_MIN_ADV_MONITOR_HANDLE 1
276 #define HCI_MAX_ADV_MONITOR_NUM_HANDLES 32
277 #define HCI_MAX_ADV_MONITOR_NUM_PATTERNS 16
278 #define HCI_ADV_MONITOR_EXT_NONE 1
279 #define HCI_ADV_MONITOR_EXT_MSFT 2
281 #define HCI_MAX_SHORT_NAME_LENGTH 10
283 /* Min encryption key size to match with SMP */
284 #define HCI_MIN_ENC_KEY_SIZE 7
286 /* Default LE RPA expiry time, 15 minutes */
287 #define HCI_DEFAULT_RPA_TIMEOUT (15 * 60)
289 /* Default min/max age of connection information (1s/3s) */
290 #define DEFAULT_CONN_INFO_MIN_AGE 1000
291 #define DEFAULT_CONN_INFO_MAX_AGE 3000
292 /* Default authenticated payload timeout 30s */
293 #define DEFAULT_AUTH_PAYLOAD_TIMEOUT 0x0bb8
300 __u8 data[HCI_MAX_AMP_ASSOC_SIZE];
303 #define HCI_MAX_PAGES 3
306 struct list_head list;
316 bdaddr_t public_addr;
317 bdaddr_t random_addr;
318 bdaddr_t static_addr;
320 __u8 dev_name[HCI_MAX_NAME_LENGTH];
321 __u8 short_name[HCI_MAX_SHORT_NAME_LENGTH];
322 __u8 eir[HCI_MAX_EIR_LENGTH];
328 __u8 features[HCI_MAX_PAGES][8];
330 __u8 le_white_list_size;
331 __u8 le_resolv_list_size;
332 __u8 le_num_of_adv_sets;
342 __u8 stored_max_keys;
343 __u8 stored_num_keys;
346 __u8 err_data_reporting;
347 __u16 page_scan_interval;
348 __u16 page_scan_window;
350 __u8 le_adv_channel_map;
351 __u16 le_adv_min_interval;
352 __u16 le_adv_max_interval;
354 __u16 le_scan_interval;
355 __u16 le_scan_window;
356 __u16 le_scan_int_suspend;
357 __u16 le_scan_window_suspend;
358 __u16 le_scan_int_discovery;
359 __u16 le_scan_window_discovery;
360 __u16 le_scan_int_adv_monitor;
361 __u16 le_scan_window_adv_monitor;
362 __u16 le_scan_int_connect;
363 __u16 le_scan_window_connect;
364 __u16 le_conn_min_interval;
365 __u16 le_conn_max_interval;
366 __u16 le_conn_latency;
367 __u16 le_supv_timeout;
369 __u16 le_def_tx_time;
371 __u16 le_max_tx_time;
373 __u16 le_max_rx_time;
374 __u8 le_max_key_size;
375 __u8 le_min_key_size;
376 __u16 discov_interleaved_timeout;
377 __u16 conn_info_min_age;
378 __u16 conn_info_max_age;
379 __u16 auth_payload_timeout;
380 __u8 min_enc_key_size;
381 __u8 max_enc_key_size;
386 __u16 advmon_allowlist_duration;
387 __u16 advmon_no_filter_duration;
388 __u8 enable_advmon_interleave_scan;
395 __u8 def_page_scan_type;
396 __u16 def_page_scan_int;
397 __u16 def_page_scan_window;
398 __u8 def_inq_scan_type;
399 __u16 def_inq_scan_int;
400 __u16 def_inq_scan_window;
402 __u16 def_page_timeout;
403 __u16 def_multi_adv_rotation_duration;
404 __u16 def_le_autoconnect_timeout;
405 __s8 min_le_tx_power;
406 __s8 max_le_tx_power;
414 __u16 sniff_min_interval;
415 __u16 sniff_max_interval;
420 __u32 amp_min_latency;
424 __u16 amp_assoc_size;
425 __u32 amp_max_flush_to;
426 __u32 amp_be_flush_to;
428 struct amp_assoc loc_assoc;
432 unsigned int auto_accept_delay;
434 unsigned long quirks;
437 unsigned int acl_cnt;
438 unsigned int sco_cnt;
441 unsigned int acl_mtu;
442 unsigned int sco_mtu;
444 unsigned int acl_pkts;
445 unsigned int sco_pkts;
446 unsigned int le_pkts;
453 unsigned long acl_last_tx;
454 unsigned long sco_last_tx;
455 unsigned long le_last_tx;
460 struct workqueue_struct *workqueue;
461 struct workqueue_struct *req_workqueue;
463 struct work_struct power_on;
464 struct delayed_work power_off;
465 struct work_struct error_reset;
467 __u16 discov_timeout;
468 struct delayed_work discov_off;
470 struct delayed_work service_cache;
472 struct delayed_work cmd_timer;
474 struct work_struct rx_work;
475 struct work_struct cmd_work;
476 struct work_struct tx_work;
478 struct work_struct discov_update;
479 struct work_struct bg_scan_update;
480 struct work_struct scan_update;
481 struct work_struct connectable_update;
482 struct work_struct discoverable_update;
483 struct delayed_work le_scan_disable;
484 struct delayed_work le_scan_restart;
486 struct sk_buff_head rx_q;
487 struct sk_buff_head raw_q;
488 struct sk_buff_head cmd_q;
490 struct sk_buff *sent_cmd;
492 struct mutex req_lock;
493 wait_queue_head_t req_wait_q;
496 struct sk_buff *req_skb;
499 void *smp_bredr_data;
501 struct discovery_state discovery;
503 int discovery_old_state;
504 bool discovery_paused;
505 int advertising_old_state;
506 bool advertising_paused;
508 struct notifier_block suspend_notifier;
509 struct work_struct suspend_prepare;
510 enum suspended_state suspend_state_next;
511 enum suspended_state suspend_state;
512 bool scanning_paused;
518 wait_queue_head_t suspend_wait_q;
519 DECLARE_BITMAP(suspend_tasks, __SUSPEND_NUM_TASKS);
521 struct hci_conn_hash conn_hash;
523 struct list_head mgmt_pending;
524 struct list_head blacklist;
525 struct list_head whitelist;
526 struct list_head uuids;
527 struct list_head link_keys;
528 struct list_head long_term_keys;
529 struct list_head identity_resolving_keys;
530 struct list_head remote_oob_data;
531 struct list_head le_white_list;
532 struct list_head le_resolv_list;
533 struct list_head le_conn_params;
534 struct list_head pend_le_conns;
535 struct list_head pend_le_reports;
536 struct list_head blocked_keys;
538 struct hci_dev_stats stat;
544 struct dentry *debugfs;
548 struct rfkill *rfkill;
550 DECLARE_BITMAP(dev_flags, __HCI_NUM_FLAGS);
553 __u8 adv_data[HCI_MAX_EXT_AD_LENGTH];
555 __u8 scan_rsp_data[HCI_MAX_EXT_AD_LENGTH];
556 __u8 scan_rsp_data_len;
558 struct list_head adv_instances;
559 unsigned int adv_instance_cnt;
560 __u8 cur_adv_instance;
561 __u16 adv_instance_timeout;
562 struct delayed_work adv_instance_expire;
564 struct idr adv_monitors_idr;
565 unsigned int adv_monitors_cnt;
569 struct delayed_work rpa_expired;
573 INTERLEAVE_SCAN_NONE,
574 INTERLEAVE_SCAN_NO_FILTER,
575 INTERLEAVE_SCAN_ALLOWLIST
576 } interleave_scan_state;
578 struct delayed_work interleave_scan;
580 #if IS_ENABLED(CONFIG_BT_LEDS)
581 struct led_trigger *power_led;
584 #if IS_ENABLED(CONFIG_BT_MSFTEXT)
587 bool msft_curve_validity;
590 #if IS_ENABLED(CONFIG_BT_AOSPEXT)
594 int (*open)(struct hci_dev *hdev);
595 int (*close)(struct hci_dev *hdev);
596 int (*flush)(struct hci_dev *hdev);
597 int (*setup)(struct hci_dev *hdev);
598 int (*shutdown)(struct hci_dev *hdev);
599 int (*send)(struct hci_dev *hdev, struct sk_buff *skb);
600 void (*notify)(struct hci_dev *hdev, unsigned int evt);
601 void (*hw_error)(struct hci_dev *hdev, u8 code);
602 int (*post_init)(struct hci_dev *hdev);
603 int (*set_diag)(struct hci_dev *hdev, bool enable);
604 int (*set_bdaddr)(struct hci_dev *hdev, const bdaddr_t *bdaddr);
605 void (*cmd_timeout)(struct hci_dev *hdev);
606 bool (*prevent_wake)(struct hci_dev *hdev);
609 #define HCI_PHY_HANDLE(handle) (handle & 0xff)
612 CONN_REASON_PAIR_DEVICE,
613 CONN_REASON_L2CAP_CHAN,
614 CONN_REASON_SCO_CONNECT,
618 struct list_head list;
638 __u8 features[HCI_MAX_PAGES][8];
644 __u8 pending_sec_level;
648 __u32 passkey_notify;
649 __u8 passkey_entered;
653 __u16 auth_payload_timeout;
654 __u16 le_conn_min_interval;
655 __u16 le_conn_max_interval;
656 __u16 le_conn_interval;
657 __u16 le_conn_latency;
658 __u16 le_supv_timeout;
659 __u8 le_adv_data[HCI_MAX_AD_LENGTH];
660 __u8 le_adv_data_len;
668 enum conn_reasons conn_reason;
671 __u16 clock_accuracy;
673 unsigned long conn_info_timestamp;
681 struct sk_buff_head data_q;
682 struct list_head chan_list;
684 struct delayed_work disc_work;
685 struct delayed_work auto_accept_work;
686 struct delayed_work idle_work;
687 struct delayed_work le_conn_timeout;
688 struct work_struct le_scan_cleanup;
691 struct dentry *debugfs;
693 struct hci_dev *hdev;
696 struct amp_mgr *amp_mgr;
698 struct hci_conn *link;
700 void (*connect_cfm_cb) (struct hci_conn *conn, u8 status);
701 void (*security_cfm_cb) (struct hci_conn *conn, u8 status);
702 void (*disconn_cfm_cb) (struct hci_conn *conn, u8 reason);
706 struct list_head list;
708 struct hci_conn *conn;
709 struct sk_buff_head data_q;
715 struct hci_conn_params {
716 struct list_head list;
717 struct list_head action;
722 u16 conn_min_interval;
723 u16 conn_max_interval;
725 u16 supervision_timeout;
728 HCI_AUTO_CONN_DISABLED,
729 HCI_AUTO_CONN_REPORT,
730 HCI_AUTO_CONN_DIRECT,
731 HCI_AUTO_CONN_ALWAYS,
732 HCI_AUTO_CONN_LINK_LOSS,
733 HCI_AUTO_CONN_EXPLICIT,
736 struct hci_conn *conn;
737 bool explicit_connect;
741 extern struct list_head hci_dev_list;
742 extern struct list_head hci_cb_list;
743 extern rwlock_t hci_dev_list_lock;
744 extern struct mutex hci_cb_list_lock;
746 #define hci_dev_set_flag(hdev, nr) set_bit((nr), (hdev)->dev_flags)
747 #define hci_dev_clear_flag(hdev, nr) clear_bit((nr), (hdev)->dev_flags)
748 #define hci_dev_change_flag(hdev, nr) change_bit((nr), (hdev)->dev_flags)
749 #define hci_dev_test_flag(hdev, nr) test_bit((nr), (hdev)->dev_flags)
750 #define hci_dev_test_and_set_flag(hdev, nr) test_and_set_bit((nr), (hdev)->dev_flags)
751 #define hci_dev_test_and_clear_flag(hdev, nr) test_and_clear_bit((nr), (hdev)->dev_flags)
752 #define hci_dev_test_and_change_flag(hdev, nr) test_and_change_bit((nr), (hdev)->dev_flags)
754 #define hci_dev_clear_volatile_flags(hdev) \
756 hci_dev_clear_flag(hdev, HCI_LE_SCAN); \
757 hci_dev_clear_flag(hdev, HCI_LE_ADV); \
758 hci_dev_clear_flag(hdev, HCI_LL_RPA_RESOLUTION);\
759 hci_dev_clear_flag(hdev, HCI_PERIODIC_INQ); \
762 /* ----- HCI interface to upper protocols ----- */
763 int l2cap_connect_ind(struct hci_dev *hdev, bdaddr_t *bdaddr);
764 int l2cap_disconn_ind(struct hci_conn *hcon);
765 void l2cap_recv_acldata(struct hci_conn *hcon, struct sk_buff *skb, u16 flags);
767 #if IS_ENABLED(CONFIG_BT_BREDR)
768 int sco_connect_ind(struct hci_dev *hdev, bdaddr_t *bdaddr, __u8 *flags);
769 void sco_recv_scodata(struct hci_conn *hcon, struct sk_buff *skb);
771 static inline int sco_connect_ind(struct hci_dev *hdev, bdaddr_t *bdaddr,
777 static inline void sco_recv_scodata(struct hci_conn *hcon, struct sk_buff *skb)
782 /* ----- Inquiry cache ----- */
783 #define INQUIRY_CACHE_AGE_MAX (HZ*30) /* 30 seconds */
784 #define INQUIRY_ENTRY_AGE_MAX (HZ*60) /* 60 seconds */
786 static inline void discovery_init(struct hci_dev *hdev)
788 hdev->discovery.state = DISCOVERY_STOPPED;
789 INIT_LIST_HEAD(&hdev->discovery.all);
790 INIT_LIST_HEAD(&hdev->discovery.unknown);
791 INIT_LIST_HEAD(&hdev->discovery.resolve);
792 hdev->discovery.report_invalid_rssi = true;
793 hdev->discovery.rssi = HCI_RSSI_INVALID;
796 static inline void hci_discovery_filter_clear(struct hci_dev *hdev)
798 hdev->discovery.result_filtering = false;
799 hdev->discovery.report_invalid_rssi = true;
800 hdev->discovery.rssi = HCI_RSSI_INVALID;
801 hdev->discovery.uuid_count = 0;
802 kfree(hdev->discovery.uuids);
803 hdev->discovery.uuids = NULL;
804 hdev->discovery.scan_start = 0;
805 hdev->discovery.scan_duration = 0;
808 bool hci_discovery_active(struct hci_dev *hdev);
810 void hci_discovery_set_state(struct hci_dev *hdev, int state);
812 static inline int inquiry_cache_empty(struct hci_dev *hdev)
814 return list_empty(&hdev->discovery.all);
817 static inline long inquiry_cache_age(struct hci_dev *hdev)
819 struct discovery_state *c = &hdev->discovery;
820 return jiffies - c->timestamp;
823 static inline long inquiry_entry_age(struct inquiry_entry *e)
825 return jiffies - e->timestamp;
828 struct inquiry_entry *hci_inquiry_cache_lookup(struct hci_dev *hdev,
830 struct inquiry_entry *hci_inquiry_cache_lookup_unknown(struct hci_dev *hdev,
832 struct inquiry_entry *hci_inquiry_cache_lookup_resolve(struct hci_dev *hdev,
835 void hci_inquiry_cache_update_resolve(struct hci_dev *hdev,
836 struct inquiry_entry *ie);
837 u32 hci_inquiry_cache_update(struct hci_dev *hdev, struct inquiry_data *data,
839 void hci_inquiry_cache_flush(struct hci_dev *hdev);
841 /* ----- HCI Connections ----- */
844 HCI_CONN_REAUTH_PEND,
845 HCI_CONN_ENCRYPT_PEND,
846 HCI_CONN_RSWITCH_PEND,
847 HCI_CONN_MODE_CHANGE_PEND,
848 HCI_CONN_SCO_SETUP_PEND,
849 HCI_CONN_MGMT_CONNECTED,
850 HCI_CONN_SSP_ENABLED,
859 HCI_CONN_STK_ENCRYPT,
860 HCI_CONN_AUTH_INITIATOR,
862 HCI_CONN_PARAM_REMOVAL_PEND,
863 HCI_CONN_NEW_LINK_KEY,
865 HCI_CONN_AUTH_FAILURE,
868 static inline bool hci_conn_ssp_enabled(struct hci_conn *conn)
870 struct hci_dev *hdev = conn->hdev;
871 return hci_dev_test_flag(hdev, HCI_SSP_ENABLED) &&
872 test_bit(HCI_CONN_SSP_ENABLED, &conn->flags);
875 static inline bool hci_conn_sc_enabled(struct hci_conn *conn)
877 struct hci_dev *hdev = conn->hdev;
878 return hci_dev_test_flag(hdev, HCI_SC_ENABLED) &&
879 test_bit(HCI_CONN_SC_ENABLED, &conn->flags);
882 static inline void hci_conn_hash_add(struct hci_dev *hdev, struct hci_conn *c)
884 struct hci_conn_hash *h = &hdev->conn_hash;
885 list_add_rcu(&c->list, &h->list);
895 if (c->role == HCI_ROLE_SLAVE)
905 static inline void hci_conn_hash_del(struct hci_dev *hdev, struct hci_conn *c)
907 struct hci_conn_hash *h = &hdev->conn_hash;
909 list_del_rcu(&c->list);
921 if (c->role == HCI_ROLE_SLAVE)
931 static inline unsigned int hci_conn_num(struct hci_dev *hdev, __u8 type)
933 struct hci_conn_hash *h = &hdev->conn_hash;
949 static inline unsigned int hci_conn_count(struct hci_dev *hdev)
951 struct hci_conn_hash *c = &hdev->conn_hash;
953 return c->acl_num + c->amp_num + c->sco_num + c->le_num;
956 static inline __u8 hci_conn_lookup_type(struct hci_dev *hdev, __u16 handle)
958 struct hci_conn_hash *h = &hdev->conn_hash;
960 __u8 type = INVALID_LINK;
964 list_for_each_entry_rcu(c, &h->list, list) {
965 if (c->handle == handle) {
976 static inline struct hci_conn *hci_conn_hash_lookup_handle(struct hci_dev *hdev,
979 struct hci_conn_hash *h = &hdev->conn_hash;
984 list_for_each_entry_rcu(c, &h->list, list) {
985 if (c->handle == handle) {
995 static inline struct hci_conn *hci_conn_hash_lookup_ba(struct hci_dev *hdev,
996 __u8 type, bdaddr_t *ba)
998 struct hci_conn_hash *h = &hdev->conn_hash;
1003 list_for_each_entry_rcu(c, &h->list, list) {
1004 if (c->type == type && !bacmp(&c->dst, ba)) {
1015 static inline struct hci_conn *hci_conn_hash_lookup_le(struct hci_dev *hdev,
1019 struct hci_conn_hash *h = &hdev->conn_hash;
1024 list_for_each_entry_rcu(c, &h->list, list) {
1025 if (c->type != LE_LINK)
1028 if (ba_type == c->dst_type && !bacmp(&c->dst, ba)) {
1039 static inline struct hci_conn *hci_conn_hash_lookup_state(struct hci_dev *hdev,
1040 __u8 type, __u16 state)
1042 struct hci_conn_hash *h = &hdev->conn_hash;
1047 list_for_each_entry_rcu(c, &h->list, list) {
1048 if (c->type == type && c->state == state) {
1059 static inline struct hci_conn *hci_lookup_le_connect(struct hci_dev *hdev)
1061 struct hci_conn_hash *h = &hdev->conn_hash;
1066 list_for_each_entry_rcu(c, &h->list, list) {
1067 if (c->type == LE_LINK && c->state == BT_CONNECT &&
1068 !test_bit(HCI_CONN_SCANNING, &c->flags)) {
1079 int hci_disconnect(struct hci_conn *conn, __u8 reason);
1080 bool hci_setup_sync(struct hci_conn *conn, __u16 handle);
1081 void hci_sco_setup(struct hci_conn *conn, __u8 status);
1083 struct hci_conn *hci_conn_add(struct hci_dev *hdev, int type, bdaddr_t *dst,
1085 int hci_conn_del(struct hci_conn *conn);
1086 void hci_conn_hash_flush(struct hci_dev *hdev);
1087 void hci_conn_check_pending(struct hci_dev *hdev);
1089 struct hci_chan *hci_chan_create(struct hci_conn *conn);
1090 void hci_chan_del(struct hci_chan *chan);
1091 void hci_chan_list_flush(struct hci_conn *conn);
1092 struct hci_chan *hci_chan_lookup_handle(struct hci_dev *hdev, __u16 handle);
1094 struct hci_conn *hci_connect_le_scan(struct hci_dev *hdev, bdaddr_t *dst,
1095 u8 dst_type, u8 sec_level,
1097 enum conn_reasons conn_reason);
1098 struct hci_conn *hci_connect_le(struct hci_dev *hdev, bdaddr_t *dst,
1099 u8 dst_type, u8 sec_level, u16 conn_timeout,
1100 u8 role, bdaddr_t *direct_rpa);
1101 struct hci_conn *hci_connect_acl(struct hci_dev *hdev, bdaddr_t *dst,
1102 u8 sec_level, u8 auth_type,
1103 enum conn_reasons conn_reason);
1104 struct hci_conn *hci_connect_sco(struct hci_dev *hdev, int type, bdaddr_t *dst,
1106 int hci_conn_check_link_mode(struct hci_conn *conn);
1107 int hci_conn_check_secure(struct hci_conn *conn, __u8 sec_level);
1108 int hci_conn_security(struct hci_conn *conn, __u8 sec_level, __u8 auth_type,
1110 int hci_conn_switch_role(struct hci_conn *conn, __u8 role);
1112 void hci_conn_enter_active_mode(struct hci_conn *conn, __u8 force_active);
1114 void hci_le_conn_failed(struct hci_conn *conn, u8 status);
1117 * hci_conn_get() and hci_conn_put() are used to control the life-time of an
1118 * "hci_conn" object. They do not guarantee that the hci_conn object is running,
1119 * working or anything else. They just guarantee that the object is available
1120 * and can be dereferenced. So you can use its locks, local variables and any
1121 * other constant data.
1122 * Before accessing runtime data, you _must_ lock the object and then check that
1123 * it is still running. As soon as you release the locks, the connection might
1124 * get dropped, though.
1126 * On the other hand, hci_conn_hold() and hci_conn_drop() are used to control
1127 * how long the underlying connection is held. So every channel that runs on the
1128 * hci_conn object calls this to prevent the connection from disappearing. As
1129 * long as you hold a device, you must also guarantee that you have a valid
1130 * reference to the device via hci_conn_get() (or the initial reference from
1132 * The hold()/drop() ref-count is known to drop below 0 sometimes, which doesn't
1133 * break because nobody cares for that. But this means, we cannot use
1134 * _get()/_drop() in it, but require the caller to have a valid ref (FIXME).
1137 static inline struct hci_conn *hci_conn_get(struct hci_conn *conn)
1139 get_device(&conn->dev);
1143 static inline void hci_conn_put(struct hci_conn *conn)
1145 put_device(&conn->dev);
1148 static inline void hci_conn_hold(struct hci_conn *conn)
1150 BT_DBG("hcon %p orig refcnt %d", conn, atomic_read(&conn->refcnt));
1152 atomic_inc(&conn->refcnt);
1153 cancel_delayed_work(&conn->disc_work);
1156 static inline void hci_conn_drop(struct hci_conn *conn)
1158 BT_DBG("hcon %p orig refcnt %d", conn, atomic_read(&conn->refcnt));
1160 if (atomic_dec_and_test(&conn->refcnt)) {
1161 unsigned long timeo;
1163 switch (conn->type) {
1166 cancel_delayed_work(&conn->idle_work);
1167 if (conn->state == BT_CONNECTED) {
1168 timeo = conn->disc_timeout;
1177 timeo = conn->disc_timeout;
1185 cancel_delayed_work(&conn->disc_work);
1186 queue_delayed_work(conn->hdev->workqueue,
1187 &conn->disc_work, timeo);
1191 /* ----- HCI Devices ----- */
1192 static inline void hci_dev_put(struct hci_dev *d)
1194 BT_DBG("%s orig refcnt %d", d->name,
1195 kref_read(&d->dev.kobj.kref));
1197 put_device(&d->dev);
1200 static inline struct hci_dev *hci_dev_hold(struct hci_dev *d)
1202 BT_DBG("%s orig refcnt %d", d->name,
1203 kref_read(&d->dev.kobj.kref));
1205 get_device(&d->dev);
1209 #define hci_dev_lock(d) mutex_lock(&d->lock)
1210 #define hci_dev_unlock(d) mutex_unlock(&d->lock)
1212 #define to_hci_dev(d) container_of(d, struct hci_dev, dev)
1213 #define to_hci_conn(c) container_of(c, struct hci_conn, dev)
1215 static inline void *hci_get_drvdata(struct hci_dev *hdev)
1217 return dev_get_drvdata(&hdev->dev);
1220 static inline void hci_set_drvdata(struct hci_dev *hdev, void *data)
1222 dev_set_drvdata(&hdev->dev, data);
1225 struct hci_dev *hci_dev_get(int index);
1226 struct hci_dev *hci_get_route(bdaddr_t *dst, bdaddr_t *src, u8 src_type);
1228 struct hci_dev *hci_alloc_dev(void);
1229 void hci_free_dev(struct hci_dev *hdev);
1230 int hci_register_dev(struct hci_dev *hdev);
1231 void hci_unregister_dev(struct hci_dev *hdev);
1232 void hci_cleanup_dev(struct hci_dev *hdev);
1233 int hci_suspend_dev(struct hci_dev *hdev);
1234 int hci_resume_dev(struct hci_dev *hdev);
1235 int hci_reset_dev(struct hci_dev *hdev);
1236 int hci_recv_frame(struct hci_dev *hdev, struct sk_buff *skb);
1237 int hci_recv_diag(struct hci_dev *hdev, struct sk_buff *skb);
1238 __printf(2, 3) void hci_set_hw_info(struct hci_dev *hdev, const char *fmt, ...);
1239 __printf(2, 3) void hci_set_fw_info(struct hci_dev *hdev, const char *fmt, ...);
1241 static inline void hci_set_msft_opcode(struct hci_dev *hdev, __u16 opcode)
1243 #if IS_ENABLED(CONFIG_BT_MSFTEXT)
1244 hdev->msft_opcode = opcode;
1248 static inline void hci_set_aosp_capable(struct hci_dev *hdev)
1250 #if IS_ENABLED(CONFIG_BT_AOSPEXT)
1251 hdev->aosp_capable = true;
1255 int hci_dev_open(__u16 dev);
1256 int hci_dev_close(__u16 dev);
1257 int hci_dev_do_close(struct hci_dev *hdev);
1258 int hci_dev_reset(__u16 dev);
1259 int hci_dev_reset_stat(__u16 dev);
1260 int hci_dev_cmd(unsigned int cmd, void __user *arg);
1261 int hci_get_dev_list(void __user *arg);
1262 int hci_get_dev_info(void __user *arg);
1263 int hci_get_conn_list(void __user *arg);
1264 int hci_get_conn_info(struct hci_dev *hdev, void __user *arg);
1265 int hci_get_auth_info(struct hci_dev *hdev, void __user *arg);
1266 int hci_inquiry(void __user *arg);
1268 struct bdaddr_list *hci_bdaddr_list_lookup(struct list_head *list,
1269 bdaddr_t *bdaddr, u8 type);
1270 struct bdaddr_list_with_irk *hci_bdaddr_list_lookup_with_irk(
1271 struct list_head *list, bdaddr_t *bdaddr,
1273 struct bdaddr_list_with_flags *
1274 hci_bdaddr_list_lookup_with_flags(struct list_head *list, bdaddr_t *bdaddr,
1276 int hci_bdaddr_list_add(struct list_head *list, bdaddr_t *bdaddr, u8 type);
1277 int hci_bdaddr_list_add_with_irk(struct list_head *list, bdaddr_t *bdaddr,
1278 u8 type, u8 *peer_irk, u8 *local_irk);
1279 int hci_bdaddr_list_add_with_flags(struct list_head *list, bdaddr_t *bdaddr,
1280 u8 type, u32 flags);
1281 int hci_bdaddr_list_del(struct list_head *list, bdaddr_t *bdaddr, u8 type);
1282 int hci_bdaddr_list_del_with_irk(struct list_head *list, bdaddr_t *bdaddr,
1284 int hci_bdaddr_list_del_with_flags(struct list_head *list, bdaddr_t *bdaddr,
1286 void hci_bdaddr_list_clear(struct list_head *list);
1288 struct hci_conn_params *hci_conn_params_lookup(struct hci_dev *hdev,
1289 bdaddr_t *addr, u8 addr_type);
1290 struct hci_conn_params *hci_conn_params_add(struct hci_dev *hdev,
1291 bdaddr_t *addr, u8 addr_type);
1292 void hci_conn_params_del(struct hci_dev *hdev, bdaddr_t *addr, u8 addr_type);
1293 void hci_conn_params_clear_disabled(struct hci_dev *hdev);
1295 struct hci_conn_params *hci_pend_le_action_lookup(struct list_head *list,
1299 void hci_uuids_clear(struct hci_dev *hdev);
1301 void hci_link_keys_clear(struct hci_dev *hdev);
1302 struct link_key *hci_find_link_key(struct hci_dev *hdev, bdaddr_t *bdaddr);
1303 struct link_key *hci_add_link_key(struct hci_dev *hdev, struct hci_conn *conn,
1304 bdaddr_t *bdaddr, u8 *val, u8 type,
1305 u8 pin_len, bool *persistent);
1306 struct smp_ltk *hci_add_ltk(struct hci_dev *hdev, bdaddr_t *bdaddr,
1307 u8 addr_type, u8 type, u8 authenticated,
1308 u8 tk[16], u8 enc_size, __le16 ediv, __le64 rand);
1309 struct smp_ltk *hci_find_ltk(struct hci_dev *hdev, bdaddr_t *bdaddr,
1310 u8 addr_type, u8 role);
1311 int hci_remove_ltk(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 bdaddr_type);
1312 void hci_smp_ltks_clear(struct hci_dev *hdev);
1313 int hci_remove_link_key(struct hci_dev *hdev, bdaddr_t *bdaddr);
1315 struct smp_irk *hci_find_irk_by_rpa(struct hci_dev *hdev, bdaddr_t *rpa);
1316 struct smp_irk *hci_find_irk_by_addr(struct hci_dev *hdev, bdaddr_t *bdaddr,
1318 struct smp_irk *hci_add_irk(struct hci_dev *hdev, bdaddr_t *bdaddr,
1319 u8 addr_type, u8 val[16], bdaddr_t *rpa);
1320 void hci_remove_irk(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 addr_type);
1321 bool hci_is_blocked_key(struct hci_dev *hdev, u8 type, u8 val[16]);
1322 void hci_blocked_keys_clear(struct hci_dev *hdev);
1323 void hci_smp_irks_clear(struct hci_dev *hdev);
1325 bool hci_bdaddr_is_paired(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 type);
1327 void hci_remote_oob_data_clear(struct hci_dev *hdev);
1328 struct oob_data *hci_find_remote_oob_data(struct hci_dev *hdev,
1329 bdaddr_t *bdaddr, u8 bdaddr_type);
1330 int hci_add_remote_oob_data(struct hci_dev *hdev, bdaddr_t *bdaddr,
1331 u8 bdaddr_type, u8 *hash192, u8 *rand192,
1332 u8 *hash256, u8 *rand256);
1333 int hci_remove_remote_oob_data(struct hci_dev *hdev, bdaddr_t *bdaddr,
1336 void hci_adv_instances_clear(struct hci_dev *hdev);
1337 struct adv_info *hci_find_adv_instance(struct hci_dev *hdev, u8 instance);
1338 struct adv_info *hci_get_next_instance(struct hci_dev *hdev, u8 instance);
1339 int hci_add_adv_instance(struct hci_dev *hdev, u8 instance, u32 flags,
1340 u16 adv_data_len, u8 *adv_data,
1341 u16 scan_rsp_len, u8 *scan_rsp_data,
1342 u16 timeout, u16 duration, s8 tx_power,
1343 u32 min_interval, u32 max_interval);
1344 int hci_set_adv_instance_data(struct hci_dev *hdev, u8 instance,
1345 u16 adv_data_len, u8 *adv_data,
1346 u16 scan_rsp_len, u8 *scan_rsp_data);
1347 int hci_remove_adv_instance(struct hci_dev *hdev, u8 instance);
1348 void hci_adv_instances_set_rpa_expired(struct hci_dev *hdev, bool rpa_expired);
1350 void hci_adv_monitors_clear(struct hci_dev *hdev);
1351 void hci_free_adv_monitor(struct hci_dev *hdev, struct adv_monitor *monitor);
1352 int hci_add_adv_patterns_monitor_complete(struct hci_dev *hdev, u8 status);
1353 int hci_remove_adv_monitor_complete(struct hci_dev *hdev, u8 status);
1354 bool hci_add_adv_monitor(struct hci_dev *hdev, struct adv_monitor *monitor,
1356 bool hci_remove_single_adv_monitor(struct hci_dev *hdev, u16 handle, int *err);
1357 bool hci_remove_all_adv_monitor(struct hci_dev *hdev, int *err);
1358 bool hci_is_adv_monitoring(struct hci_dev *hdev);
1359 int hci_get_adv_monitor_offload_ext(struct hci_dev *hdev);
1361 void hci_event_packet(struct hci_dev *hdev, struct sk_buff *skb);
1363 void hci_init_sysfs(struct hci_dev *hdev);
1364 void hci_conn_init_sysfs(struct hci_conn *conn);
1365 void hci_conn_add_sysfs(struct hci_conn *conn);
1366 void hci_conn_del_sysfs(struct hci_conn *conn);
1368 #define SET_HCIDEV_DEV(hdev, pdev) ((hdev)->dev.parent = (pdev))
1370 /* ----- LMP capabilities ----- */
1371 #define lmp_encrypt_capable(dev) ((dev)->features[0][0] & LMP_ENCRYPT)
1372 #define lmp_rswitch_capable(dev) ((dev)->features[0][0] & LMP_RSWITCH)
1373 #define lmp_hold_capable(dev) ((dev)->features[0][0] & LMP_HOLD)
1374 #define lmp_sniff_capable(dev) ((dev)->features[0][0] & LMP_SNIFF)
1375 #define lmp_park_capable(dev) ((dev)->features[0][1] & LMP_PARK)
1376 #define lmp_inq_rssi_capable(dev) ((dev)->features[0][3] & LMP_RSSI_INQ)
1377 #define lmp_esco_capable(dev) ((dev)->features[0][3] & LMP_ESCO)
1378 #define lmp_bredr_capable(dev) (!((dev)->features[0][4] & LMP_NO_BREDR))
1379 #define lmp_le_capable(dev) ((dev)->features[0][4] & LMP_LE)
1380 #define lmp_sniffsubr_capable(dev) ((dev)->features[0][5] & LMP_SNIFF_SUBR)
1381 #define lmp_pause_enc_capable(dev) ((dev)->features[0][5] & LMP_PAUSE_ENC)
1382 #define lmp_esco_2m_capable(dev) ((dev)->features[0][5] & LMP_EDR_ESCO_2M)
1383 #define lmp_ext_inq_capable(dev) ((dev)->features[0][6] & LMP_EXT_INQ)
1384 #define lmp_le_br_capable(dev) (!!((dev)->features[0][6] & LMP_SIMUL_LE_BR))
1385 #define lmp_ssp_capable(dev) ((dev)->features[0][6] & LMP_SIMPLE_PAIR)
1386 #define lmp_no_flush_capable(dev) ((dev)->features[0][6] & LMP_NO_FLUSH)
1387 #define lmp_lsto_capable(dev) ((dev)->features[0][7] & LMP_LSTO)
1388 #define lmp_inq_tx_pwr_capable(dev) ((dev)->features[0][7] & LMP_INQ_TX_PWR)
1389 #define lmp_ext_feat_capable(dev) ((dev)->features[0][7] & LMP_EXTFEATURES)
1390 #define lmp_transp_capable(dev) ((dev)->features[0][2] & LMP_TRANSPARENT)
1391 #define lmp_edr_2m_capable(dev) ((dev)->features[0][3] & LMP_EDR_2M)
1392 #define lmp_edr_3m_capable(dev) ((dev)->features[0][3] & LMP_EDR_3M)
1393 #define lmp_edr_3slot_capable(dev) ((dev)->features[0][4] & LMP_EDR_3SLOT)
1394 #define lmp_edr_5slot_capable(dev) ((dev)->features[0][5] & LMP_EDR_5SLOT)
1396 /* ----- Extended LMP capabilities ----- */
1397 #define lmp_csb_master_capable(dev) ((dev)->features[2][0] & LMP_CSB_MASTER)
1398 #define lmp_csb_slave_capable(dev) ((dev)->features[2][0] & LMP_CSB_SLAVE)
1399 #define lmp_sync_train_capable(dev) ((dev)->features[2][0] & LMP_SYNC_TRAIN)
1400 #define lmp_sync_scan_capable(dev) ((dev)->features[2][0] & LMP_SYNC_SCAN)
1401 #define lmp_sc_capable(dev) ((dev)->features[2][1] & LMP_SC)
1402 #define lmp_ping_capable(dev) ((dev)->features[2][1] & LMP_PING)
1404 /* ----- Host capabilities ----- */
1405 #define lmp_host_ssp_capable(dev) ((dev)->features[1][0] & LMP_HOST_SSP)
1406 #define lmp_host_sc_capable(dev) ((dev)->features[1][0] & LMP_HOST_SC)
1407 #define lmp_host_le_capable(dev) (!!((dev)->features[1][0] & LMP_HOST_LE))
1408 #define lmp_host_le_br_capable(dev) (!!((dev)->features[1][0] & LMP_HOST_LE_BREDR))
1410 #define hdev_is_powered(dev) (test_bit(HCI_UP, &(dev)->flags) && \
1411 !hci_dev_test_flag(dev, HCI_AUTO_OFF))
1412 #define bredr_sc_enabled(dev) (lmp_sc_capable(dev) && \
1413 hci_dev_test_flag(dev, HCI_SC_ENABLED))
1415 #define scan_1m(dev) (((dev)->le_tx_def_phys & HCI_LE_SET_PHY_1M) || \
1416 ((dev)->le_rx_def_phys & HCI_LE_SET_PHY_1M))
1418 #define scan_2m(dev) (((dev)->le_tx_def_phys & HCI_LE_SET_PHY_2M) || \
1419 ((dev)->le_rx_def_phys & HCI_LE_SET_PHY_2M))
1421 #define scan_coded(dev) (((dev)->le_tx_def_phys & HCI_LE_SET_PHY_CODED) || \
1422 ((dev)->le_rx_def_phys & HCI_LE_SET_PHY_CODED))
1424 /* Use LL Privacy based address resolution if supported */
1425 #define use_ll_privacy(dev) ((dev)->le_features[0] & HCI_LE_LL_PRIVACY)
1427 /* Use ext scanning if set ext scan param and ext scan enable is supported */
1428 #define use_ext_scan(dev) (((dev)->commands[37] & 0x20) && \
1429 ((dev)->commands[37] & 0x40))
1430 /* Use ext create connection if command is supported */
1431 #define use_ext_conn(dev) ((dev)->commands[37] & 0x80)
1433 /* Extended advertising support */
1434 #define ext_adv_capable(dev) (((dev)->le_features[1] & HCI_LE_EXT_ADV))
1436 /* ----- HCI protocols ----- */
1437 #define HCI_PROTO_DEFER 0x01
1439 static inline int hci_proto_connect_ind(struct hci_dev *hdev, bdaddr_t *bdaddr,
1440 __u8 type, __u8 *flags)
1444 return l2cap_connect_ind(hdev, bdaddr);
1448 return sco_connect_ind(hdev, bdaddr, flags);
1451 BT_ERR("unknown link type %d", type);
1456 static inline int hci_proto_disconn_ind(struct hci_conn *conn)
1458 if (conn->type != ACL_LINK && conn->type != LE_LINK)
1459 return HCI_ERROR_REMOTE_USER_TERM;
1461 return l2cap_disconn_ind(conn);
1464 /* ----- HCI callbacks ----- */
1466 struct list_head list;
1470 void (*connect_cfm) (struct hci_conn *conn, __u8 status);
1471 void (*disconn_cfm) (struct hci_conn *conn, __u8 status);
1472 void (*security_cfm) (struct hci_conn *conn, __u8 status,
1474 void (*key_change_cfm) (struct hci_conn *conn, __u8 status);
1475 void (*role_switch_cfm) (struct hci_conn *conn, __u8 status, __u8 role);
1478 static inline void hci_connect_cfm(struct hci_conn *conn, __u8 status)
1482 mutex_lock(&hci_cb_list_lock);
1483 list_for_each_entry(cb, &hci_cb_list, list) {
1484 if (cb->connect_cfm)
1485 cb->connect_cfm(conn, status);
1487 mutex_unlock(&hci_cb_list_lock);
1489 if (conn->connect_cfm_cb)
1490 conn->connect_cfm_cb(conn, status);
1493 static inline void hci_disconn_cfm(struct hci_conn *conn, __u8 reason)
1497 mutex_lock(&hci_cb_list_lock);
1498 list_for_each_entry(cb, &hci_cb_list, list) {
1499 if (cb->disconn_cfm)
1500 cb->disconn_cfm(conn, reason);
1502 mutex_unlock(&hci_cb_list_lock);
1504 if (conn->disconn_cfm_cb)
1505 conn->disconn_cfm_cb(conn, reason);
1508 static inline void hci_auth_cfm(struct hci_conn *conn, __u8 status)
1513 if (test_bit(HCI_CONN_ENCRYPT_PEND, &conn->flags))
1516 encrypt = test_bit(HCI_CONN_ENCRYPT, &conn->flags) ? 0x01 : 0x00;
1518 mutex_lock(&hci_cb_list_lock);
1519 list_for_each_entry(cb, &hci_cb_list, list) {
1520 if (cb->security_cfm)
1521 cb->security_cfm(conn, status, encrypt);
1523 mutex_unlock(&hci_cb_list_lock);
1525 if (conn->security_cfm_cb)
1526 conn->security_cfm_cb(conn, status);
1529 static inline void hci_encrypt_cfm(struct hci_conn *conn, __u8 status)
1534 if (conn->state == BT_CONFIG) {
1536 conn->state = BT_CONNECTED;
1538 hci_connect_cfm(conn, status);
1539 hci_conn_drop(conn);
1543 if (!test_bit(HCI_CONN_ENCRYPT, &conn->flags))
1545 else if (test_bit(HCI_CONN_AES_CCM, &conn->flags))
1551 if (conn->sec_level == BT_SECURITY_SDP)
1552 conn->sec_level = BT_SECURITY_LOW;
1554 if (conn->pending_sec_level > conn->sec_level)
1555 conn->sec_level = conn->pending_sec_level;
1558 mutex_lock(&hci_cb_list_lock);
1559 list_for_each_entry(cb, &hci_cb_list, list) {
1560 if (cb->security_cfm)
1561 cb->security_cfm(conn, status, encrypt);
1563 mutex_unlock(&hci_cb_list_lock);
1565 if (conn->security_cfm_cb)
1566 conn->security_cfm_cb(conn, status);
1569 static inline void hci_key_change_cfm(struct hci_conn *conn, __u8 status)
1573 mutex_lock(&hci_cb_list_lock);
1574 list_for_each_entry(cb, &hci_cb_list, list) {
1575 if (cb->key_change_cfm)
1576 cb->key_change_cfm(conn, status);
1578 mutex_unlock(&hci_cb_list_lock);
1581 static inline void hci_role_switch_cfm(struct hci_conn *conn, __u8 status,
1586 mutex_lock(&hci_cb_list_lock);
1587 list_for_each_entry(cb, &hci_cb_list, list) {
1588 if (cb->role_switch_cfm)
1589 cb->role_switch_cfm(conn, status, role);
1591 mutex_unlock(&hci_cb_list_lock);
1594 static inline void *eir_get_data(u8 *eir, size_t eir_len, u8 type,
1602 while (parsed < eir_len - 1) {
1603 u8 field_len = eir[0];
1608 parsed += field_len + 1;
1610 if (parsed > eir_len)
1613 if (eir[1] != type) {
1614 eir += field_len + 1;
1618 /* Zero length data */
1623 *data_len = field_len - 1;
1631 static inline bool hci_bdaddr_is_rpa(bdaddr_t *bdaddr, u8 addr_type)
1633 if (addr_type != ADDR_LE_DEV_RANDOM)
1636 if ((bdaddr->b[5] & 0xc0) == 0x40)
1642 static inline bool hci_is_identity_address(bdaddr_t *addr, u8 addr_type)
1644 if (addr_type == ADDR_LE_DEV_PUBLIC)
1647 /* Check for Random Static address type */
1648 if ((addr->b[5] & 0xc0) == 0xc0)
1654 static inline struct smp_irk *hci_get_irk(struct hci_dev *hdev,
1655 bdaddr_t *bdaddr, u8 addr_type)
1657 if (!hci_bdaddr_is_rpa(bdaddr, addr_type))
1660 return hci_find_irk_by_rpa(hdev, bdaddr);
1663 static inline int hci_check_conn_params(u16 min, u16 max, u16 latency,
1668 if (min > max || min < 6 || max > 3200)
1671 if (to_multiplier < 10 || to_multiplier > 3200)
1674 if (max >= to_multiplier * 8)
1677 max_latency = (to_multiplier * 4 / max) - 1;
1678 if (latency > 499 || latency > max_latency)
1684 int hci_register_cb(struct hci_cb *hcb);
1685 int hci_unregister_cb(struct hci_cb *hcb);
1687 struct sk_buff *__hci_cmd_sync(struct hci_dev *hdev, u16 opcode, u32 plen,
1688 const void *param, u32 timeout);
1689 struct sk_buff *__hci_cmd_sync_ev(struct hci_dev *hdev, u16 opcode, u32 plen,
1690 const void *param, u8 event, u32 timeout);
1691 int __hci_cmd_send(struct hci_dev *hdev, u16 opcode, u32 plen,
1694 int hci_send_cmd(struct hci_dev *hdev, __u16 opcode, __u32 plen,
1696 void hci_send_acl(struct hci_chan *chan, struct sk_buff *skb, __u16 flags);
1697 void hci_send_sco(struct hci_conn *conn, struct sk_buff *skb);
1699 void *hci_sent_cmd_data(struct hci_dev *hdev, __u16 opcode);
1701 struct sk_buff *hci_cmd_sync(struct hci_dev *hdev, u16 opcode, u32 plen,
1702 const void *param, u32 timeout);
1704 u32 hci_conn_get_phy(struct hci_conn *conn);
1706 /* ----- HCI Sockets ----- */
1707 void hci_send_to_sock(struct hci_dev *hdev, struct sk_buff *skb);
1708 void hci_send_to_channel(unsigned short channel, struct sk_buff *skb,
1709 int flag, struct sock *skip_sk);
1710 void hci_send_to_monitor(struct hci_dev *hdev, struct sk_buff *skb);
1711 void hci_send_monitor_ctrl_event(struct hci_dev *hdev, u16 event,
1712 void *data, u16 data_len, ktime_t tstamp,
1713 int flag, struct sock *skip_sk);
1715 void hci_sock_dev_event(struct hci_dev *hdev, int event);
1717 #define HCI_MGMT_VAR_LEN BIT(0)
1718 #define HCI_MGMT_NO_HDEV BIT(1)
1719 #define HCI_MGMT_UNTRUSTED BIT(2)
1720 #define HCI_MGMT_UNCONFIGURED BIT(3)
1721 #define HCI_MGMT_HDEV_OPTIONAL BIT(4)
1723 struct hci_mgmt_handler {
1724 int (*func) (struct sock *sk, struct hci_dev *hdev, void *data,
1727 unsigned long flags;
1730 struct hci_mgmt_chan {
1731 struct list_head list;
1732 unsigned short channel;
1733 size_t handler_count;
1734 const struct hci_mgmt_handler *handlers;
1735 void (*hdev_init) (struct sock *sk, struct hci_dev *hdev);
1738 int hci_mgmt_chan_register(struct hci_mgmt_chan *c);
1739 void hci_mgmt_chan_unregister(struct hci_mgmt_chan *c);
1741 /* Management interface */
1742 #define DISCOV_TYPE_BREDR (BIT(BDADDR_BREDR))
1743 #define DISCOV_TYPE_LE (BIT(BDADDR_LE_PUBLIC) | \
1744 BIT(BDADDR_LE_RANDOM))
1745 #define DISCOV_TYPE_INTERLEAVED (BIT(BDADDR_BREDR) | \
1746 BIT(BDADDR_LE_PUBLIC) | \
1747 BIT(BDADDR_LE_RANDOM))
1749 /* These LE scan and inquiry parameters were chosen according to LE General
1750 * Discovery Procedure specification.
1752 #define DISCOV_LE_SCAN_WIN 0x12
1753 #define DISCOV_LE_SCAN_INT 0x12
1754 #define DISCOV_LE_TIMEOUT 10240 /* msec */
1755 #define DISCOV_INTERLEAVED_TIMEOUT 5120 /* msec */
1756 #define DISCOV_INTERLEAVED_INQUIRY_LEN 0x04
1757 #define DISCOV_BREDR_INQUIRY_LEN 0x08
1758 #define DISCOV_LE_RESTART_DELAY msecs_to_jiffies(200) /* msec */
1759 #define DISCOV_LE_FAST_ADV_INT_MIN 0x00A0 /* 100 msec */
1760 #define DISCOV_LE_FAST_ADV_INT_MAX 0x00F0 /* 150 msec */
1762 void mgmt_fill_version_info(void *ver);
1763 int mgmt_new_settings(struct hci_dev *hdev);
1764 void mgmt_index_added(struct hci_dev *hdev);
1765 void mgmt_index_removed(struct hci_dev *hdev);
1766 void mgmt_set_powered_failed(struct hci_dev *hdev, int err);
1767 void mgmt_power_on(struct hci_dev *hdev, int err);
1768 void __mgmt_power_off(struct hci_dev *hdev);
1769 void mgmt_new_link_key(struct hci_dev *hdev, struct link_key *key,
1771 void mgmt_device_connected(struct hci_dev *hdev, struct hci_conn *conn,
1772 u32 flags, u8 *name, u8 name_len);
1773 void mgmt_device_disconnected(struct hci_dev *hdev, bdaddr_t *bdaddr,
1774 u8 link_type, u8 addr_type, u8 reason,
1775 bool mgmt_connected);
1776 void mgmt_disconnect_failed(struct hci_dev *hdev, bdaddr_t *bdaddr,
1777 u8 link_type, u8 addr_type, u8 status);
1778 void mgmt_connect_failed(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 link_type,
1779 u8 addr_type, u8 status);
1780 void mgmt_pin_code_request(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 secure);
1781 void mgmt_pin_code_reply_complete(struct hci_dev *hdev, bdaddr_t *bdaddr,
1783 void mgmt_pin_code_neg_reply_complete(struct hci_dev *hdev, bdaddr_t *bdaddr,
1785 int mgmt_user_confirm_request(struct hci_dev *hdev, bdaddr_t *bdaddr,
1786 u8 link_type, u8 addr_type, u32 value,
1788 int mgmt_user_confirm_reply_complete(struct hci_dev *hdev, bdaddr_t *bdaddr,
1789 u8 link_type, u8 addr_type, u8 status);
1790 int mgmt_user_confirm_neg_reply_complete(struct hci_dev *hdev, bdaddr_t *bdaddr,
1791 u8 link_type, u8 addr_type, u8 status);
1792 int mgmt_user_passkey_request(struct hci_dev *hdev, bdaddr_t *bdaddr,
1793 u8 link_type, u8 addr_type);
1794 int mgmt_user_passkey_reply_complete(struct hci_dev *hdev, bdaddr_t *bdaddr,
1795 u8 link_type, u8 addr_type, u8 status);
1796 int mgmt_user_passkey_neg_reply_complete(struct hci_dev *hdev, bdaddr_t *bdaddr,
1797 u8 link_type, u8 addr_type, u8 status);
1798 int mgmt_user_passkey_notify(struct hci_dev *hdev, bdaddr_t *bdaddr,
1799 u8 link_type, u8 addr_type, u32 passkey,
1801 void mgmt_auth_failed(struct hci_conn *conn, u8 status);
1802 void mgmt_auth_enable_complete(struct hci_dev *hdev, u8 status);
1803 void mgmt_ssp_enable_complete(struct hci_dev *hdev, u8 enable, u8 status);
1804 void mgmt_set_class_of_dev_complete(struct hci_dev *hdev, u8 *dev_class,
1806 void mgmt_set_local_name_complete(struct hci_dev *hdev, u8 *name, u8 status);
1807 void mgmt_start_discovery_complete(struct hci_dev *hdev, u8 status);
1808 void mgmt_stop_discovery_complete(struct hci_dev *hdev, u8 status);
1809 void mgmt_device_found(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 link_type,
1810 u8 addr_type, u8 *dev_class, s8 rssi, u32 flags,
1811 u8 *eir, u16 eir_len, u8 *scan_rsp, u8 scan_rsp_len);
1812 void mgmt_remote_name(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 link_type,
1813 u8 addr_type, s8 rssi, u8 *name, u8 name_len);
1814 void mgmt_discovering(struct hci_dev *hdev, u8 discovering);
1815 void mgmt_suspending(struct hci_dev *hdev, u8 state);
1816 void mgmt_resuming(struct hci_dev *hdev, u8 reason, bdaddr_t *bdaddr,
1818 bool mgmt_powering_down(struct hci_dev *hdev);
1819 void mgmt_new_ltk(struct hci_dev *hdev, struct smp_ltk *key, bool persistent);
1820 void mgmt_new_irk(struct hci_dev *hdev, struct smp_irk *irk, bool persistent);
1821 void mgmt_new_csrk(struct hci_dev *hdev, struct smp_csrk *csrk,
1823 void mgmt_new_conn_param(struct hci_dev *hdev, bdaddr_t *bdaddr,
1824 u8 bdaddr_type, u8 store_hint, u16 min_interval,
1825 u16 max_interval, u16 latency, u16 timeout);
1826 void mgmt_smp_complete(struct hci_conn *conn, bool complete);
1827 bool mgmt_get_connectable(struct hci_dev *hdev);
1828 void mgmt_set_connectable_complete(struct hci_dev *hdev, u8 status);
1829 void mgmt_set_discoverable_complete(struct hci_dev *hdev, u8 status);
1830 u8 mgmt_get_adv_discov_flags(struct hci_dev *hdev);
1831 void mgmt_advertising_added(struct sock *sk, struct hci_dev *hdev,
1833 void mgmt_advertising_removed(struct sock *sk, struct hci_dev *hdev,
1835 void mgmt_adv_monitor_removed(struct hci_dev *hdev, u16 handle);
1836 int mgmt_phy_configuration_changed(struct hci_dev *hdev, struct sock *skip);
1837 int mgmt_add_adv_patterns_monitor_complete(struct hci_dev *hdev, u8 status);
1838 int mgmt_remove_adv_monitor_complete(struct hci_dev *hdev, u8 status);
1840 u8 hci_le_conn_update(struct hci_conn *conn, u16 min, u16 max, u16 latency,
1842 void hci_le_start_enc(struct hci_conn *conn, __le16 ediv, __le64 rand,
1843 __u8 ltk[16], __u8 key_size);
1845 void hci_copy_identity_address(struct hci_dev *hdev, bdaddr_t *bdaddr,
1848 #define SCO_AIRMODE_MASK 0x0003
1849 #define SCO_AIRMODE_CVSD 0x0000
1850 #define SCO_AIRMODE_TRANSP 0x0003
1852 #endif /* __HCI_CORE_H */