1 /* 2 BlueZ - Bluetooth protocol stack for Linux 3 Copyright (c) 2000-2001, 2010, Code Aurora Forum. All rights reserved. 4 Copyright 2023-2024 NXP 5 6 Written 2000,2001 by Maxim Krasnyansky <maxk@qualcomm.com> 7 8 This program is free software; you can redistribute it and/or modify 9 it under the terms of the GNU General Public License version 2 as 10 published by the Free Software Foundation; 11 12 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS 13 OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 14 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. 15 IN NO EVENT SHALL THE COPYRIGHT HOLDER(S) AND AUTHOR(S) BE LIABLE FOR ANY 16 CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES 17 WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 18 ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 19 OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 20 21 ALL LIABILITY, INCLUDING LIABILITY FOR INFRINGEMENT OF ANY PATENTS, 22 COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS, RELATING TO USE OF THIS 23 SOFTWARE IS DISCLAIMED. 24 */ 25 26 #ifndef __HCI_CORE_H 27 #define __HCI_CORE_H 28 29 #include <linux/idr.h> 30 #include <linux/leds.h> 31 #include <linux/rculist.h> 32 33 #include <net/bluetooth/hci.h> 34 #include <net/bluetooth/hci_sync.h> 35 #include <net/bluetooth/hci_sock.h> 36 #include <net/bluetooth/coredump.h> 37 38 /* HCI priority */ 39 #define HCI_PRIO_MAX 7 40 41 /* HCI maximum id value */ 42 #define HCI_MAX_ID 10000 43 44 /* HCI Core structures */ 45 struct inquiry_data { 46 bdaddr_t bdaddr; 47 __u8 pscan_rep_mode; 48 __u8 pscan_period_mode; 49 __u8 pscan_mode; 50 __u8 dev_class[3]; 51 __le16 clock_offset; 52 __s8 rssi; 53 __u8 ssp_mode; 54 }; 55 56 struct inquiry_entry { 57 struct list_head all; /* inq_cache.all */ 58 struct list_head list; /* unknown or resolve */ 59 enum { 60 NAME_NOT_KNOWN, 61 NAME_NEEDED, 62 NAME_PENDING, 63 NAME_KNOWN, 64 } name_state; 65 __u32 timestamp; 66 struct inquiry_data data; 67 }; 68 69 struct discovery_state { 70 int type; 71 enum { 72 DISCOVERY_STOPPED, 73 DISCOVERY_STARTING, 74 DISCOVERY_FINDING, 75 DISCOVERY_RESOLVING, 76 DISCOVERY_STOPPING, 77 } state; 78 struct list_head all; /* All devices found during inquiry */ 79 struct list_head unknown; /* Name state not known */ 80 struct list_head resolve; /* Name needs to be resolved */ 81 __u32 timestamp; 82 bdaddr_t last_adv_addr; 83 u8 last_adv_addr_type; 84 s8 last_adv_rssi; 85 u32 last_adv_flags; 86 u8 last_adv_data[HCI_MAX_EXT_AD_LENGTH]; 87 u8 last_adv_data_len; 88 bool report_invalid_rssi; 89 bool result_filtering; 90 bool limited; 91 s8 rssi; 92 u16 uuid_count; 93 u8 (*uuids)[16]; 94 unsigned long scan_start; 95 unsigned long scan_duration; 96 unsigned long name_resolve_timeout; 97 }; 98 99 #define SUSPEND_NOTIFIER_TIMEOUT msecs_to_jiffies(2000) /* 2 seconds */ 100 101 enum suspend_tasks { 102 SUSPEND_PAUSE_DISCOVERY, 103 SUSPEND_UNPAUSE_DISCOVERY, 104 105 SUSPEND_PAUSE_ADVERTISING, 106 SUSPEND_UNPAUSE_ADVERTISING, 107 108 SUSPEND_SCAN_DISABLE, 109 SUSPEND_SCAN_ENABLE, 110 SUSPEND_DISCONNECTING, 111 112 SUSPEND_POWERING_DOWN, 113 114 SUSPEND_PREPARE_NOTIFIER, 115 116 SUSPEND_SET_ADV_FILTER, 117 __SUSPEND_NUM_TASKS 118 }; 119 120 enum suspended_state { 121 BT_RUNNING = 0, 122 BT_SUSPEND_DISCONNECT, 123 BT_SUSPEND_CONFIGURE_WAKE, 124 }; 125 126 struct hci_conn_hash { 127 struct list_head list; 128 unsigned int acl_num; 129 unsigned int amp_num; 130 unsigned int sco_num; 131 unsigned int iso_num; 132 unsigned int le_num; 133 unsigned int le_num_peripheral; 134 }; 135 136 struct bdaddr_list { 137 struct list_head list; 138 bdaddr_t bdaddr; 139 u8 bdaddr_type; 140 }; 141 142 struct codec_list { 143 struct list_head list; 144 u8 id; 145 __u16 cid; 146 __u16 vid; 147 u8 transport; 148 u8 num_caps; 149 u32 len; 150 struct hci_codec_caps caps[]; 151 }; 152 153 struct bdaddr_list_with_irk { 154 struct list_head list; 155 bdaddr_t bdaddr; 156 u8 bdaddr_type; 157 u8 peer_irk[16]; 158 u8 local_irk[16]; 159 }; 160 161 /* Bitmask of connection flags */ 162 enum hci_conn_flags { 163 HCI_CONN_FLAG_REMOTE_WAKEUP = 1, 164 HCI_CONN_FLAG_DEVICE_PRIVACY = 2, 165 }; 166 typedef u8 hci_conn_flags_t; 167 168 struct bdaddr_list_with_flags { 169 struct list_head list; 170 bdaddr_t bdaddr; 171 u8 bdaddr_type; 172 hci_conn_flags_t flags; 173 }; 174 175 struct bt_uuid { 176 struct list_head list; 177 u8 uuid[16]; 178 u8 size; 179 u8 svc_hint; 180 }; 181 182 struct blocked_key { 183 struct list_head list; 184 struct rcu_head rcu; 185 u8 type; 186 u8 val[16]; 187 }; 188 189 struct smp_csrk { 190 bdaddr_t bdaddr; 191 u8 bdaddr_type; 192 u8 link_type; 193 u8 type; 194 u8 val[16]; 195 }; 196 197 struct smp_ltk { 198 struct list_head list; 199 struct rcu_head rcu; 200 bdaddr_t bdaddr; 201 u8 bdaddr_type; 202 u8 link_type; 203 u8 authenticated; 204 u8 type; 205 u8 enc_size; 206 __le16 ediv; 207 __le64 rand; 208 u8 val[16]; 209 }; 210 211 struct smp_irk { 212 struct list_head list; 213 struct rcu_head rcu; 214 bdaddr_t rpa; 215 bdaddr_t bdaddr; 216 u8 addr_type; 217 u8 link_type; 218 u8 val[16]; 219 }; 220 221 struct link_key { 222 struct list_head list; 223 struct rcu_head rcu; 224 bdaddr_t bdaddr; 225 u8 bdaddr_type; 226 u8 link_type; 227 u8 type; 228 u8 val[HCI_LINK_KEY_SIZE]; 229 u8 pin_len; 230 }; 231 232 struct oob_data { 233 struct list_head list; 234 bdaddr_t bdaddr; 235 u8 bdaddr_type; 236 u8 present; 237 u8 hash192[16]; 238 u8 rand192[16]; 239 u8 hash256[16]; 240 u8 rand256[16]; 241 }; 242 243 struct adv_info { 244 struct list_head list; 245 bool enabled; 246 bool pending; 247 bool periodic; 248 __u8 mesh; 249 __u8 instance; 250 __u32 flags; 251 __u16 timeout; 252 __u16 remaining_time; 253 __u16 duration; 254 __u16 adv_data_len; 255 __u8 adv_data[HCI_MAX_EXT_AD_LENGTH]; 256 bool adv_data_changed; 257 __u16 scan_rsp_len; 258 __u8 scan_rsp_data[HCI_MAX_EXT_AD_LENGTH]; 259 bool scan_rsp_changed; 260 __u16 per_adv_data_len; 261 __u8 per_adv_data[HCI_MAX_PER_AD_LENGTH]; 262 __s8 tx_power; 263 __u32 min_interval; 264 __u32 max_interval; 265 bdaddr_t random_addr; 266 bool rpa_expired; 267 struct delayed_work rpa_expired_cb; 268 }; 269 270 #define HCI_MAX_ADV_INSTANCES 5 271 #define HCI_DEFAULT_ADV_DURATION 2 272 273 #define HCI_ADV_TX_POWER_NO_PREFERENCE 0x7F 274 275 #define DATA_CMP(_d1, _l1, _d2, _l2) \ 276 (_l1 == _l2 ? memcmp(_d1, _d2, _l1) : _l1 - _l2) 277 278 #define ADV_DATA_CMP(_adv, _data, _len) \ 279 DATA_CMP((_adv)->adv_data, (_adv)->adv_data_len, _data, _len) 280 281 #define SCAN_RSP_CMP(_adv, _data, _len) \ 282 DATA_CMP((_adv)->scan_rsp_data, (_adv)->scan_rsp_len, _data, _len) 283 284 struct monitored_device { 285 struct list_head list; 286 287 bdaddr_t bdaddr; 288 __u8 addr_type; 289 __u16 handle; 290 bool notified; 291 }; 292 293 struct adv_pattern { 294 struct list_head list; 295 __u8 ad_type; 296 __u8 offset; 297 __u8 length; 298 __u8 value[HCI_MAX_EXT_AD_LENGTH]; 299 }; 300 301 struct adv_rssi_thresholds { 302 __s8 low_threshold; 303 __s8 high_threshold; 304 __u16 low_threshold_timeout; 305 __u16 high_threshold_timeout; 306 __u8 sampling_period; 307 }; 308 309 struct adv_monitor { 310 struct list_head patterns; 311 struct adv_rssi_thresholds rssi; 312 __u16 handle; 313 314 enum { 315 ADV_MONITOR_STATE_NOT_REGISTERED, 316 ADV_MONITOR_STATE_REGISTERED, 317 ADV_MONITOR_STATE_OFFLOADED 318 } state; 319 }; 320 321 #define HCI_MIN_ADV_MONITOR_HANDLE 1 322 #define HCI_MAX_ADV_MONITOR_NUM_HANDLES 32 323 #define HCI_MAX_ADV_MONITOR_NUM_PATTERNS 16 324 #define HCI_ADV_MONITOR_EXT_NONE 1 325 #define HCI_ADV_MONITOR_EXT_MSFT 2 326 327 #define HCI_MAX_SHORT_NAME_LENGTH 10 328 329 #define HCI_CONN_HANDLE_MAX 0x0eff 330 #define HCI_CONN_HANDLE_UNSET(_handle) (_handle > HCI_CONN_HANDLE_MAX) 331 332 /* Min encryption key size to match with SMP */ 333 #define HCI_MIN_ENC_KEY_SIZE 7 334 335 /* Default LE RPA expiry time, 15 minutes */ 336 #define HCI_DEFAULT_RPA_TIMEOUT (15 * 60) 337 338 /* Default min/max age of connection information (1s/3s) */ 339 #define DEFAULT_CONN_INFO_MIN_AGE 1000 340 #define DEFAULT_CONN_INFO_MAX_AGE 3000 341 /* Default authenticated payload timeout 30s */ 342 #define DEFAULT_AUTH_PAYLOAD_TIMEOUT 0x0bb8 343 344 struct amp_assoc { 345 __u16 len; 346 __u16 offset; 347 __u16 rem_len; 348 __u16 len_so_far; 349 __u8 data[HCI_MAX_AMP_ASSOC_SIZE]; 350 }; 351 352 #define HCI_MAX_PAGES 3 353 354 struct hci_dev { 355 struct list_head list; 356 struct mutex lock; 357 358 struct ida unset_handle_ida; 359 360 const char *name; 361 unsigned long flags; 362 __u16 id; 363 __u8 bus; 364 __u8 dev_type; 365 bdaddr_t bdaddr; 366 bdaddr_t setup_addr; 367 bdaddr_t public_addr; 368 bdaddr_t random_addr; 369 bdaddr_t static_addr; 370 __u8 adv_addr_type; 371 __u8 dev_name[HCI_MAX_NAME_LENGTH]; 372 __u8 short_name[HCI_MAX_SHORT_NAME_LENGTH]; 373 __u8 eir[HCI_MAX_EIR_LENGTH]; 374 __u16 appearance; 375 __u8 dev_class[3]; 376 __u8 major_class; 377 __u8 minor_class; 378 __u8 max_page; 379 __u8 features[HCI_MAX_PAGES][8]; 380 __u8 le_features[8]; 381 __u8 le_accept_list_size; 382 __u8 le_resolv_list_size; 383 __u8 le_num_of_adv_sets; 384 __u8 le_states[8]; 385 __u8 mesh_ad_types[16]; 386 __u8 mesh_send_ref; 387 __u8 commands[64]; 388 __u8 hci_ver; 389 __u16 hci_rev; 390 __u8 lmp_ver; 391 __u16 manufacturer; 392 __u16 lmp_subver; 393 __u16 voice_setting; 394 __u8 num_iac; 395 __u16 stored_max_keys; 396 __u16 stored_num_keys; 397 __u8 io_capability; 398 __s8 inq_tx_power; 399 __u8 err_data_reporting; 400 __u16 page_scan_interval; 401 __u16 page_scan_window; 402 __u8 page_scan_type; 403 __u8 le_adv_channel_map; 404 __u16 le_adv_min_interval; 405 __u16 le_adv_max_interval; 406 __u8 le_scan_type; 407 __u16 le_scan_interval; 408 __u16 le_scan_window; 409 __u16 le_scan_int_suspend; 410 __u16 le_scan_window_suspend; 411 __u16 le_scan_int_discovery; 412 __u16 le_scan_window_discovery; 413 __u16 le_scan_int_adv_monitor; 414 __u16 le_scan_window_adv_monitor; 415 __u16 le_scan_int_connect; 416 __u16 le_scan_window_connect; 417 __u16 le_conn_min_interval; 418 __u16 le_conn_max_interval; 419 __u16 le_conn_latency; 420 __u16 le_supv_timeout; 421 __u16 le_def_tx_len; 422 __u16 le_def_tx_time; 423 __u16 le_max_tx_len; 424 __u16 le_max_tx_time; 425 __u16 le_max_rx_len; 426 __u16 le_max_rx_time; 427 __u8 le_max_key_size; 428 __u8 le_min_key_size; 429 __u16 discov_interleaved_timeout; 430 __u16 conn_info_min_age; 431 __u16 conn_info_max_age; 432 __u16 auth_payload_timeout; 433 __u8 min_enc_key_size; 434 __u8 max_enc_key_size; 435 __u8 pairing_opts; 436 __u8 ssp_debug_mode; 437 __u8 hw_error_code; 438 __u32 clock; 439 __u16 advmon_allowlist_duration; 440 __u16 advmon_no_filter_duration; 441 __u8 enable_advmon_interleave_scan; 442 443 __u16 devid_source; 444 __u16 devid_vendor; 445 __u16 devid_product; 446 __u16 devid_version; 447 448 __u8 def_page_scan_type; 449 __u16 def_page_scan_int; 450 __u16 def_page_scan_window; 451 __u8 def_inq_scan_type; 452 __u16 def_inq_scan_int; 453 __u16 def_inq_scan_window; 454 __u16 def_br_lsto; 455 __u16 def_page_timeout; 456 __u16 def_multi_adv_rotation_duration; 457 __u16 def_le_autoconnect_timeout; 458 __s8 min_le_tx_power; 459 __s8 max_le_tx_power; 460 461 __u16 pkt_type; 462 __u16 esco_type; 463 __u16 link_policy; 464 __u16 link_mode; 465 466 __u32 idle_timeout; 467 __u16 sniff_min_interval; 468 __u16 sniff_max_interval; 469 470 __u8 amp_status; 471 __u32 amp_total_bw; 472 __u32 amp_max_bw; 473 __u32 amp_min_latency; 474 __u32 amp_max_pdu; 475 __u8 amp_type; 476 __u16 amp_pal_cap; 477 __u16 amp_assoc_size; 478 __u32 amp_max_flush_to; 479 __u32 amp_be_flush_to; 480 481 struct amp_assoc loc_assoc; 482 483 __u8 flow_ctl_mode; 484 485 unsigned int auto_accept_delay; 486 487 unsigned long quirks; 488 489 atomic_t cmd_cnt; 490 unsigned int acl_cnt; 491 unsigned int sco_cnt; 492 unsigned int le_cnt; 493 unsigned int iso_cnt; 494 495 unsigned int acl_mtu; 496 unsigned int sco_mtu; 497 unsigned int le_mtu; 498 unsigned int iso_mtu; 499 unsigned int acl_pkts; 500 unsigned int sco_pkts; 501 unsigned int le_pkts; 502 unsigned int iso_pkts; 503 504 __u16 block_len; 505 __u16 block_mtu; 506 __u16 num_blocks; 507 __u16 block_cnt; 508 509 unsigned long acl_last_tx; 510 unsigned long sco_last_tx; 511 unsigned long le_last_tx; 512 513 __u8 le_tx_def_phys; 514 __u8 le_rx_def_phys; 515 516 struct workqueue_struct *workqueue; 517 struct workqueue_struct *req_workqueue; 518 519 struct work_struct power_on; 520 struct delayed_work power_off; 521 struct work_struct error_reset; 522 struct work_struct cmd_sync_work; 523 struct list_head cmd_sync_work_list; 524 struct mutex cmd_sync_work_lock; 525 struct mutex unregister_lock; 526 struct work_struct cmd_sync_cancel_work; 527 struct work_struct reenable_adv_work; 528 529 __u16 discov_timeout; 530 struct delayed_work discov_off; 531 532 struct delayed_work service_cache; 533 534 struct delayed_work cmd_timer; 535 struct delayed_work ncmd_timer; 536 537 struct work_struct rx_work; 538 struct work_struct cmd_work; 539 struct work_struct tx_work; 540 541 struct delayed_work le_scan_disable; 542 543 struct sk_buff_head rx_q; 544 struct sk_buff_head raw_q; 545 struct sk_buff_head cmd_q; 546 547 struct sk_buff *sent_cmd; 548 struct sk_buff *recv_event; 549 550 struct mutex req_lock; 551 wait_queue_head_t req_wait_q; 552 __u32 req_status; 553 __u32 req_result; 554 struct sk_buff *req_skb; 555 struct sk_buff *req_rsp; 556 557 void *smp_data; 558 void *smp_bredr_data; 559 560 struct discovery_state discovery; 561 562 int discovery_old_state; 563 bool discovery_paused; 564 int advertising_old_state; 565 bool advertising_paused; 566 567 struct notifier_block suspend_notifier; 568 enum suspended_state suspend_state_next; 569 enum suspended_state suspend_state; 570 bool scanning_paused; 571 bool suspended; 572 u8 wake_reason; 573 bdaddr_t wake_addr; 574 u8 wake_addr_type; 575 576 struct hci_conn_hash conn_hash; 577 578 struct list_head mesh_pending; 579 struct list_head mgmt_pending; 580 struct list_head reject_list; 581 struct list_head accept_list; 582 struct list_head uuids; 583 struct list_head link_keys; 584 struct list_head long_term_keys; 585 struct list_head identity_resolving_keys; 586 struct list_head remote_oob_data; 587 struct list_head le_accept_list; 588 struct list_head le_resolv_list; 589 struct list_head le_conn_params; 590 struct list_head pend_le_conns; 591 struct list_head pend_le_reports; 592 struct list_head blocked_keys; 593 struct list_head local_codecs; 594 595 struct hci_dev_stats stat; 596 597 atomic_t promisc; 598 599 const char *hw_info; 600 const char *fw_info; 601 struct dentry *debugfs; 602 603 struct hci_devcoredump dump; 604 605 struct device dev; 606 607 struct rfkill *rfkill; 608 609 DECLARE_BITMAP(dev_flags, __HCI_NUM_FLAGS); 610 hci_conn_flags_t conn_flags; 611 612 __s8 adv_tx_power; 613 __u8 adv_data[HCI_MAX_EXT_AD_LENGTH]; 614 __u8 adv_data_len; 615 __u8 scan_rsp_data[HCI_MAX_EXT_AD_LENGTH]; 616 __u8 scan_rsp_data_len; 617 __u8 per_adv_data[HCI_MAX_PER_AD_LENGTH]; 618 __u8 per_adv_data_len; 619 620 struct list_head adv_instances; 621 unsigned int adv_instance_cnt; 622 __u8 cur_adv_instance; 623 __u16 adv_instance_timeout; 624 struct delayed_work adv_instance_expire; 625 626 struct idr adv_monitors_idr; 627 unsigned int adv_monitors_cnt; 628 629 __u8 irk[16]; 630 __u32 rpa_timeout; 631 struct delayed_work rpa_expired; 632 bdaddr_t rpa; 633 634 struct delayed_work mesh_send_done; 635 636 enum { 637 INTERLEAVE_SCAN_NONE, 638 INTERLEAVE_SCAN_NO_FILTER, 639 INTERLEAVE_SCAN_ALLOWLIST 640 } interleave_scan_state; 641 642 struct delayed_work interleave_scan; 643 644 struct list_head monitored_devices; 645 bool advmon_pend_notify; 646 647 #if IS_ENABLED(CONFIG_BT_LEDS) 648 struct led_trigger *power_led; 649 #endif 650 651 #if IS_ENABLED(CONFIG_BT_MSFTEXT) 652 __u16 msft_opcode; 653 void *msft_data; 654 bool msft_curve_validity; 655 #endif 656 657 #if IS_ENABLED(CONFIG_BT_AOSPEXT) 658 bool aosp_capable; 659 bool aosp_quality_report; 660 #endif 661 662 int (*open)(struct hci_dev *hdev); 663 int (*close)(struct hci_dev *hdev); 664 int (*flush)(struct hci_dev *hdev); 665 int (*setup)(struct hci_dev *hdev); 666 int (*shutdown)(struct hci_dev *hdev); 667 int (*send)(struct hci_dev *hdev, struct sk_buff *skb); 668 void (*notify)(struct hci_dev *hdev, unsigned int evt); 669 void (*hw_error)(struct hci_dev *hdev, u8 code); 670 int (*post_init)(struct hci_dev *hdev); 671 int (*set_diag)(struct hci_dev *hdev, bool enable); 672 int (*set_bdaddr)(struct hci_dev *hdev, const bdaddr_t *bdaddr); 673 void (*cmd_timeout)(struct hci_dev *hdev); 674 void (*reset)(struct hci_dev *hdev); 675 bool (*wakeup)(struct hci_dev *hdev); 676 int (*set_quality_report)(struct hci_dev *hdev, bool enable); 677 int (*get_data_path_id)(struct hci_dev *hdev, __u8 *data_path); 678 int (*get_codec_config_data)(struct hci_dev *hdev, __u8 type, 679 struct bt_codec *codec, __u8 *vnd_len, 680 __u8 **vnd_data); 681 }; 682 683 #define HCI_PHY_HANDLE(handle) (handle & 0xff) 684 685 enum conn_reasons { 686 CONN_REASON_PAIR_DEVICE, 687 CONN_REASON_L2CAP_CHAN, 688 CONN_REASON_SCO_CONNECT, 689 CONN_REASON_ISO_CONNECT, 690 }; 691 692 struct hci_conn { 693 struct list_head list; 694 695 atomic_t refcnt; 696 697 bdaddr_t dst; 698 __u8 dst_type; 699 bdaddr_t src; 700 __u8 src_type; 701 bdaddr_t init_addr; 702 __u8 init_addr_type; 703 bdaddr_t resp_addr; 704 __u8 resp_addr_type; 705 __u8 adv_instance; 706 __u16 handle; 707 __u16 sync_handle; 708 __u16 state; 709 __u8 mode; 710 __u8 type; 711 __u8 role; 712 bool out; 713 __u8 attempt; 714 __u8 dev_class[3]; 715 __u8 features[HCI_MAX_PAGES][8]; 716 __u16 pkt_type; 717 __u16 link_policy; 718 __u8 key_type; 719 __u8 auth_type; 720 __u8 sec_level; 721 __u8 pending_sec_level; 722 __u8 pin_length; 723 __u8 enc_key_size; 724 __u8 io_capability; 725 __u32 passkey_notify; 726 __u8 passkey_entered; 727 __u16 disc_timeout; 728 __u16 conn_timeout; 729 __u16 setting; 730 __u16 auth_payload_timeout; 731 __u16 le_conn_min_interval; 732 __u16 le_conn_max_interval; 733 __u16 le_conn_interval; 734 __u16 le_conn_latency; 735 __u16 le_supv_timeout; 736 __u8 le_adv_data[HCI_MAX_EXT_AD_LENGTH]; 737 __u8 le_adv_data_len; 738 __u8 le_per_adv_data[HCI_MAX_PER_AD_TOT_LEN]; 739 __u16 le_per_adv_data_len; 740 __u16 le_per_adv_data_offset; 741 __u8 le_adv_phy; 742 __u8 le_adv_sec_phy; 743 __u8 le_tx_phy; 744 __u8 le_rx_phy; 745 __s8 rssi; 746 __s8 tx_power; 747 __s8 max_tx_power; 748 struct bt_iso_qos iso_qos; 749 unsigned long flags; 750 751 enum conn_reasons conn_reason; 752 __u8 abort_reason; 753 754 __u32 clock; 755 __u16 clock_accuracy; 756 757 unsigned long conn_info_timestamp; 758 759 __u8 remote_cap; 760 __u8 remote_auth; 761 __u8 remote_id; 762 763 unsigned int sent; 764 765 struct sk_buff_head data_q; 766 struct list_head chan_list; 767 768 struct delayed_work disc_work; 769 struct delayed_work auto_accept_work; 770 struct delayed_work idle_work; 771 struct delayed_work le_conn_timeout; 772 773 struct device dev; 774 struct dentry *debugfs; 775 776 struct hci_dev *hdev; 777 void *l2cap_data; 778 void *sco_data; 779 void *iso_data; 780 struct amp_mgr *amp_mgr; 781 782 struct list_head link_list; 783 struct hci_conn *parent; 784 struct hci_link *link; 785 786 struct bt_codec codec; 787 788 void (*connect_cfm_cb) (struct hci_conn *conn, u8 status); 789 void (*security_cfm_cb) (struct hci_conn *conn, u8 status); 790 void (*disconn_cfm_cb) (struct hci_conn *conn, u8 reason); 791 792 void (*cleanup)(struct hci_conn *conn); 793 }; 794 795 struct hci_link { 796 struct list_head list; 797 struct hci_conn *conn; 798 }; 799 800 struct hci_chan { 801 struct list_head list; 802 __u16 handle; 803 struct hci_conn *conn; 804 struct sk_buff_head data_q; 805 unsigned int sent; 806 __u8 state; 807 bool amp; 808 }; 809 810 struct hci_conn_params { 811 struct list_head list; 812 struct list_head action; 813 814 bdaddr_t addr; 815 u8 addr_type; 816 817 u16 conn_min_interval; 818 u16 conn_max_interval; 819 u16 conn_latency; 820 u16 supervision_timeout; 821 822 enum { 823 HCI_AUTO_CONN_DISABLED, 824 HCI_AUTO_CONN_REPORT, 825 HCI_AUTO_CONN_DIRECT, 826 HCI_AUTO_CONN_ALWAYS, 827 HCI_AUTO_CONN_LINK_LOSS, 828 HCI_AUTO_CONN_EXPLICIT, 829 } auto_connect; 830 831 struct hci_conn *conn; 832 bool explicit_connect; 833 /* Accessed without hdev->lock: */ 834 hci_conn_flags_t flags; 835 u8 privacy_mode; 836 }; 837 838 extern struct list_head hci_dev_list; 839 extern struct list_head hci_cb_list; 840 extern rwlock_t hci_dev_list_lock; 841 extern struct mutex hci_cb_list_lock; 842 843 #define hci_dev_set_flag(hdev, nr) set_bit((nr), (hdev)->dev_flags) 844 #define hci_dev_clear_flag(hdev, nr) clear_bit((nr), (hdev)->dev_flags) 845 #define hci_dev_change_flag(hdev, nr) change_bit((nr), (hdev)->dev_flags) 846 #define hci_dev_test_flag(hdev, nr) test_bit((nr), (hdev)->dev_flags) 847 #define hci_dev_test_and_set_flag(hdev, nr) test_and_set_bit((nr), (hdev)->dev_flags) 848 #define hci_dev_test_and_clear_flag(hdev, nr) test_and_clear_bit((nr), (hdev)->dev_flags) 849 #define hci_dev_test_and_change_flag(hdev, nr) test_and_change_bit((nr), (hdev)->dev_flags) 850 851 #define hci_dev_clear_volatile_flags(hdev) \ 852 do { \ 853 hci_dev_clear_flag(hdev, HCI_LE_SCAN); \ 854 hci_dev_clear_flag(hdev, HCI_LE_ADV); \ 855 hci_dev_clear_flag(hdev, HCI_LL_RPA_RESOLUTION);\ 856 hci_dev_clear_flag(hdev, HCI_PERIODIC_INQ); \ 857 hci_dev_clear_flag(hdev, HCI_QUALITY_REPORT); \ 858 } while (0) 859 860 #define hci_dev_le_state_simultaneous(hdev) \ 861 (test_bit(HCI_QUIRK_VALID_LE_STATES, &hdev->quirks) && \ 862 (hdev->le_states[4] & 0x08) && /* Central */ \ 863 (hdev->le_states[4] & 0x40) && /* Peripheral */ \ 864 (hdev->le_states[3] & 0x10)) /* Simultaneous */ 865 866 /* ----- HCI interface to upper protocols ----- */ 867 int l2cap_connect_ind(struct hci_dev *hdev, bdaddr_t *bdaddr); 868 int l2cap_disconn_ind(struct hci_conn *hcon); 869 void l2cap_recv_acldata(struct hci_conn *hcon, struct sk_buff *skb, u16 flags); 870 871 #if IS_ENABLED(CONFIG_BT_BREDR) 872 int sco_connect_ind(struct hci_dev *hdev, bdaddr_t *bdaddr, __u8 *flags); 873 void sco_recv_scodata(struct hci_conn *hcon, struct sk_buff *skb); 874 #else 875 static inline int sco_connect_ind(struct hci_dev *hdev, bdaddr_t *bdaddr, 876 __u8 *flags) 877 { 878 return 0; 879 } 880 881 static inline void sco_recv_scodata(struct hci_conn *hcon, struct sk_buff *skb) 882 { 883 } 884 #endif 885 886 #if IS_ENABLED(CONFIG_BT_LE) 887 int iso_connect_ind(struct hci_dev *hdev, bdaddr_t *bdaddr, __u8 *flags); 888 void iso_recv(struct hci_conn *hcon, struct sk_buff *skb, u16 flags); 889 #else 890 static inline int iso_connect_ind(struct hci_dev *hdev, bdaddr_t *bdaddr, 891 __u8 *flags) 892 { 893 return 0; 894 } 895 static inline void iso_recv(struct hci_conn *hcon, struct sk_buff *skb, 896 u16 flags) 897 { 898 } 899 #endif 900 901 /* ----- Inquiry cache ----- */ 902 #define INQUIRY_CACHE_AGE_MAX (HZ*30) /* 30 seconds */ 903 #define INQUIRY_ENTRY_AGE_MAX (HZ*60) /* 60 seconds */ 904 905 static inline void discovery_init(struct hci_dev *hdev) 906 { 907 hdev->discovery.state = DISCOVERY_STOPPED; 908 INIT_LIST_HEAD(&hdev->discovery.all); 909 INIT_LIST_HEAD(&hdev->discovery.unknown); 910 INIT_LIST_HEAD(&hdev->discovery.resolve); 911 hdev->discovery.report_invalid_rssi = true; 912 hdev->discovery.rssi = HCI_RSSI_INVALID; 913 } 914 915 static inline void hci_discovery_filter_clear(struct hci_dev *hdev) 916 { 917 hdev->discovery.result_filtering = false; 918 hdev->discovery.report_invalid_rssi = true; 919 hdev->discovery.rssi = HCI_RSSI_INVALID; 920 hdev->discovery.uuid_count = 0; 921 kfree(hdev->discovery.uuids); 922 hdev->discovery.uuids = NULL; 923 hdev->discovery.scan_start = 0; 924 hdev->discovery.scan_duration = 0; 925 } 926 927 bool hci_discovery_active(struct hci_dev *hdev); 928 929 void hci_discovery_set_state(struct hci_dev *hdev, int state); 930 931 static inline int inquiry_cache_empty(struct hci_dev *hdev) 932 { 933 return list_empty(&hdev->discovery.all); 934 } 935 936 static inline long inquiry_cache_age(struct hci_dev *hdev) 937 { 938 struct discovery_state *c = &hdev->discovery; 939 return jiffies - c->timestamp; 940 } 941 942 static inline long inquiry_entry_age(struct inquiry_entry *e) 943 { 944 return jiffies - e->timestamp; 945 } 946 947 struct inquiry_entry *hci_inquiry_cache_lookup(struct hci_dev *hdev, 948 bdaddr_t *bdaddr); 949 struct inquiry_entry *hci_inquiry_cache_lookup_unknown(struct hci_dev *hdev, 950 bdaddr_t *bdaddr); 951 struct inquiry_entry *hci_inquiry_cache_lookup_resolve(struct hci_dev *hdev, 952 bdaddr_t *bdaddr, 953 int state); 954 void hci_inquiry_cache_update_resolve(struct hci_dev *hdev, 955 struct inquiry_entry *ie); 956 u32 hci_inquiry_cache_update(struct hci_dev *hdev, struct inquiry_data *data, 957 bool name_known); 958 void hci_inquiry_cache_flush(struct hci_dev *hdev); 959 960 /* ----- HCI Connections ----- */ 961 enum { 962 HCI_CONN_AUTH_PEND, 963 HCI_CONN_ENCRYPT_PEND, 964 HCI_CONN_RSWITCH_PEND, 965 HCI_CONN_MODE_CHANGE_PEND, 966 HCI_CONN_SCO_SETUP_PEND, 967 HCI_CONN_MGMT_CONNECTED, 968 HCI_CONN_SSP_ENABLED, 969 HCI_CONN_SC_ENABLED, 970 HCI_CONN_AES_CCM, 971 HCI_CONN_POWER_SAVE, 972 HCI_CONN_FLUSH_KEY, 973 HCI_CONN_ENCRYPT, 974 HCI_CONN_AUTH, 975 HCI_CONN_SECURE, 976 HCI_CONN_FIPS, 977 HCI_CONN_STK_ENCRYPT, 978 HCI_CONN_AUTH_INITIATOR, 979 HCI_CONN_DROP, 980 HCI_CONN_CANCEL, 981 HCI_CONN_PARAM_REMOVAL_PEND, 982 HCI_CONN_NEW_LINK_KEY, 983 HCI_CONN_SCANNING, 984 HCI_CONN_AUTH_FAILURE, 985 HCI_CONN_PER_ADV, 986 HCI_CONN_BIG_CREATED, 987 HCI_CONN_CREATE_CIS, 988 HCI_CONN_BIG_SYNC, 989 HCI_CONN_BIG_SYNC_FAILED, 990 HCI_CONN_PA_SYNC, 991 HCI_CONN_PA_SYNC_FAILED, 992 }; 993 994 static inline bool hci_conn_ssp_enabled(struct hci_conn *conn) 995 { 996 struct hci_dev *hdev = conn->hdev; 997 return hci_dev_test_flag(hdev, HCI_SSP_ENABLED) && 998 test_bit(HCI_CONN_SSP_ENABLED, &conn->flags); 999 } 1000 1001 static inline bool hci_conn_sc_enabled(struct hci_conn *conn) 1002 { 1003 struct hci_dev *hdev = conn->hdev; 1004 return hci_dev_test_flag(hdev, HCI_SC_ENABLED) && 1005 test_bit(HCI_CONN_SC_ENABLED, &conn->flags); 1006 } 1007 1008 static inline void hci_conn_hash_add(struct hci_dev *hdev, struct hci_conn *c) 1009 { 1010 struct hci_conn_hash *h = &hdev->conn_hash; 1011 list_add_tail_rcu(&c->list, &h->list); 1012 switch (c->type) { 1013 case ACL_LINK: 1014 h->acl_num++; 1015 break; 1016 case AMP_LINK: 1017 h->amp_num++; 1018 break; 1019 case LE_LINK: 1020 h->le_num++; 1021 if (c->role == HCI_ROLE_SLAVE) 1022 h->le_num_peripheral++; 1023 break; 1024 case SCO_LINK: 1025 case ESCO_LINK: 1026 h->sco_num++; 1027 break; 1028 case ISO_LINK: 1029 h->iso_num++; 1030 break; 1031 } 1032 } 1033 1034 static inline void hci_conn_hash_del(struct hci_dev *hdev, struct hci_conn *c) 1035 { 1036 struct hci_conn_hash *h = &hdev->conn_hash; 1037 1038 list_del_rcu(&c->list); 1039 synchronize_rcu(); 1040 1041 switch (c->type) { 1042 case ACL_LINK: 1043 h->acl_num--; 1044 break; 1045 case AMP_LINK: 1046 h->amp_num--; 1047 break; 1048 case LE_LINK: 1049 h->le_num--; 1050 if (c->role == HCI_ROLE_SLAVE) 1051 h->le_num_peripheral--; 1052 break; 1053 case SCO_LINK: 1054 case ESCO_LINK: 1055 h->sco_num--; 1056 break; 1057 case ISO_LINK: 1058 h->iso_num--; 1059 break; 1060 } 1061 } 1062 1063 static inline unsigned int hci_conn_num(struct hci_dev *hdev, __u8 type) 1064 { 1065 struct hci_conn_hash *h = &hdev->conn_hash; 1066 switch (type) { 1067 case ACL_LINK: 1068 return h->acl_num; 1069 case AMP_LINK: 1070 return h->amp_num; 1071 case LE_LINK: 1072 return h->le_num; 1073 case SCO_LINK: 1074 case ESCO_LINK: 1075 return h->sco_num; 1076 case ISO_LINK: 1077 return h->iso_num; 1078 default: 1079 return 0; 1080 } 1081 } 1082 1083 static inline unsigned int hci_conn_count(struct hci_dev *hdev) 1084 { 1085 struct hci_conn_hash *c = &hdev->conn_hash; 1086 1087 return c->acl_num + c->amp_num + c->sco_num + c->le_num + c->iso_num; 1088 } 1089 1090 static inline bool hci_conn_valid(struct hci_dev *hdev, struct hci_conn *conn) 1091 { 1092 struct hci_conn_hash *h = &hdev->conn_hash; 1093 struct hci_conn *c; 1094 1095 rcu_read_lock(); 1096 1097 list_for_each_entry_rcu(c, &h->list, list) { 1098 if (c == conn) { 1099 rcu_read_unlock(); 1100 return true; 1101 } 1102 } 1103 rcu_read_unlock(); 1104 1105 return false; 1106 } 1107 1108 static inline __u8 hci_conn_lookup_type(struct hci_dev *hdev, __u16 handle) 1109 { 1110 struct hci_conn_hash *h = &hdev->conn_hash; 1111 struct hci_conn *c; 1112 __u8 type = INVALID_LINK; 1113 1114 rcu_read_lock(); 1115 1116 list_for_each_entry_rcu(c, &h->list, list) { 1117 if (c->handle == handle) { 1118 type = c->type; 1119 break; 1120 } 1121 } 1122 1123 rcu_read_unlock(); 1124 1125 return type; 1126 } 1127 1128 static inline struct hci_conn *hci_conn_hash_lookup_bis(struct hci_dev *hdev, 1129 bdaddr_t *ba, __u8 bis) 1130 { 1131 struct hci_conn_hash *h = &hdev->conn_hash; 1132 struct hci_conn *c; 1133 1134 rcu_read_lock(); 1135 1136 list_for_each_entry_rcu(c, &h->list, list) { 1137 if (bacmp(&c->dst, ba) || c->type != ISO_LINK) 1138 continue; 1139 1140 if (c->iso_qos.bcast.bis == bis) { 1141 rcu_read_unlock(); 1142 return c; 1143 } 1144 } 1145 rcu_read_unlock(); 1146 1147 return NULL; 1148 } 1149 1150 static inline struct hci_conn * 1151 hci_conn_hash_lookup_per_adv_bis(struct hci_dev *hdev, 1152 bdaddr_t *ba, 1153 __u8 big, __u8 bis) 1154 { 1155 struct hci_conn_hash *h = &hdev->conn_hash; 1156 struct hci_conn *c; 1157 1158 rcu_read_lock(); 1159 1160 list_for_each_entry_rcu(c, &h->list, list) { 1161 if (bacmp(&c->dst, ba) || c->type != ISO_LINK || 1162 !test_bit(HCI_CONN_PER_ADV, &c->flags)) 1163 continue; 1164 1165 if (c->iso_qos.bcast.big == big && 1166 c->iso_qos.bcast.bis == bis) { 1167 rcu_read_unlock(); 1168 return c; 1169 } 1170 } 1171 rcu_read_unlock(); 1172 1173 return NULL; 1174 } 1175 1176 static inline struct hci_conn *hci_conn_hash_lookup_handle(struct hci_dev *hdev, 1177 __u16 handle) 1178 { 1179 struct hci_conn_hash *h = &hdev->conn_hash; 1180 struct hci_conn *c; 1181 1182 rcu_read_lock(); 1183 1184 list_for_each_entry_rcu(c, &h->list, list) { 1185 if (c->handle == handle) { 1186 rcu_read_unlock(); 1187 return c; 1188 } 1189 } 1190 rcu_read_unlock(); 1191 1192 return NULL; 1193 } 1194 1195 static inline struct hci_conn *hci_conn_hash_lookup_ba(struct hci_dev *hdev, 1196 __u8 type, bdaddr_t *ba) 1197 { 1198 struct hci_conn_hash *h = &hdev->conn_hash; 1199 struct hci_conn *c; 1200 1201 rcu_read_lock(); 1202 1203 list_for_each_entry_rcu(c, &h->list, list) { 1204 if (c->type == type && !bacmp(&c->dst, ba)) { 1205 rcu_read_unlock(); 1206 return c; 1207 } 1208 } 1209 1210 rcu_read_unlock(); 1211 1212 return NULL; 1213 } 1214 1215 static inline struct hci_conn *hci_conn_hash_lookup_le(struct hci_dev *hdev, 1216 bdaddr_t *ba, 1217 __u8 ba_type) 1218 { 1219 struct hci_conn_hash *h = &hdev->conn_hash; 1220 struct hci_conn *c; 1221 1222 rcu_read_lock(); 1223 1224 list_for_each_entry_rcu(c, &h->list, list) { 1225 if (c->type != LE_LINK) 1226 continue; 1227 1228 if (ba_type == c->dst_type && !bacmp(&c->dst, ba)) { 1229 rcu_read_unlock(); 1230 return c; 1231 } 1232 } 1233 1234 rcu_read_unlock(); 1235 1236 return NULL; 1237 } 1238 1239 static inline struct hci_conn *hci_conn_hash_lookup_cis(struct hci_dev *hdev, 1240 bdaddr_t *ba, 1241 __u8 ba_type, 1242 __u8 cig, 1243 __u8 id) 1244 { 1245 struct hci_conn_hash *h = &hdev->conn_hash; 1246 struct hci_conn *c; 1247 1248 rcu_read_lock(); 1249 1250 list_for_each_entry_rcu(c, &h->list, list) { 1251 if (c->type != ISO_LINK || !bacmp(&c->dst, BDADDR_ANY)) 1252 continue; 1253 1254 /* Match CIG ID if set */ 1255 if (cig != c->iso_qos.ucast.cig) 1256 continue; 1257 1258 /* Match CIS ID if set */ 1259 if (id != c->iso_qos.ucast.cis) 1260 continue; 1261 1262 /* Match destination address if set */ 1263 if (!ba || (ba_type == c->dst_type && !bacmp(&c->dst, ba))) { 1264 rcu_read_unlock(); 1265 return c; 1266 } 1267 } 1268 1269 rcu_read_unlock(); 1270 1271 return NULL; 1272 } 1273 1274 static inline struct hci_conn *hci_conn_hash_lookup_cig(struct hci_dev *hdev, 1275 __u8 handle) 1276 { 1277 struct hci_conn_hash *h = &hdev->conn_hash; 1278 struct hci_conn *c; 1279 1280 rcu_read_lock(); 1281 1282 list_for_each_entry_rcu(c, &h->list, list) { 1283 if (c->type != ISO_LINK || !bacmp(&c->dst, BDADDR_ANY)) 1284 continue; 1285 1286 if (handle == c->iso_qos.ucast.cig) { 1287 rcu_read_unlock(); 1288 return c; 1289 } 1290 } 1291 1292 rcu_read_unlock(); 1293 1294 return NULL; 1295 } 1296 1297 static inline struct hci_conn *hci_conn_hash_lookup_big(struct hci_dev *hdev, 1298 __u8 handle) 1299 { 1300 struct hci_conn_hash *h = &hdev->conn_hash; 1301 struct hci_conn *c; 1302 1303 rcu_read_lock(); 1304 1305 list_for_each_entry_rcu(c, &h->list, list) { 1306 if (bacmp(&c->dst, BDADDR_ANY) || c->type != ISO_LINK) 1307 continue; 1308 1309 if (handle == c->iso_qos.bcast.big) { 1310 rcu_read_unlock(); 1311 return c; 1312 } 1313 } 1314 1315 rcu_read_unlock(); 1316 1317 return NULL; 1318 } 1319 1320 static inline struct hci_conn * 1321 hci_conn_hash_lookup_big_state(struct hci_dev *hdev, __u8 handle, __u16 state) 1322 { 1323 struct hci_conn_hash *h = &hdev->conn_hash; 1324 struct hci_conn *c; 1325 1326 rcu_read_lock(); 1327 1328 list_for_each_entry_rcu(c, &h->list, list) { 1329 if (bacmp(&c->dst, BDADDR_ANY) || c->type != ISO_LINK || 1330 c->state != state) 1331 continue; 1332 1333 if (handle == c->iso_qos.bcast.big) { 1334 rcu_read_unlock(); 1335 return c; 1336 } 1337 } 1338 1339 rcu_read_unlock(); 1340 1341 return NULL; 1342 } 1343 1344 static inline struct hci_conn * 1345 hci_conn_hash_lookup_pa_sync_big_handle(struct hci_dev *hdev, __u8 big) 1346 { 1347 struct hci_conn_hash *h = &hdev->conn_hash; 1348 struct hci_conn *c; 1349 1350 rcu_read_lock(); 1351 1352 list_for_each_entry_rcu(c, &h->list, list) { 1353 if (c->type != ISO_LINK || 1354 !test_bit(HCI_CONN_PA_SYNC, &c->flags)) 1355 continue; 1356 1357 if (c->iso_qos.bcast.big == big) { 1358 rcu_read_unlock(); 1359 return c; 1360 } 1361 } 1362 rcu_read_unlock(); 1363 1364 return NULL; 1365 } 1366 1367 static inline struct hci_conn * 1368 hci_conn_hash_lookup_pa_sync_handle(struct hci_dev *hdev, __u16 sync_handle) 1369 { 1370 struct hci_conn_hash *h = &hdev->conn_hash; 1371 struct hci_conn *c; 1372 1373 rcu_read_lock(); 1374 1375 list_for_each_entry_rcu(c, &h->list, list) { 1376 if (c->type != ISO_LINK || 1377 !test_bit(HCI_CONN_PA_SYNC, &c->flags)) 1378 continue; 1379 1380 if (c->sync_handle == sync_handle) { 1381 rcu_read_unlock(); 1382 return c; 1383 } 1384 } 1385 rcu_read_unlock(); 1386 1387 return NULL; 1388 } 1389 1390 static inline struct hci_conn *hci_conn_hash_lookup_state(struct hci_dev *hdev, 1391 __u8 type, __u16 state) 1392 { 1393 struct hci_conn_hash *h = &hdev->conn_hash; 1394 struct hci_conn *c; 1395 1396 rcu_read_lock(); 1397 1398 list_for_each_entry_rcu(c, &h->list, list) { 1399 if (c->type == type && c->state == state) { 1400 rcu_read_unlock(); 1401 return c; 1402 } 1403 } 1404 1405 rcu_read_unlock(); 1406 1407 return NULL; 1408 } 1409 1410 typedef void (*hci_conn_func_t)(struct hci_conn *conn, void *data); 1411 static inline void hci_conn_hash_list_state(struct hci_dev *hdev, 1412 hci_conn_func_t func, __u8 type, 1413 __u16 state, void *data) 1414 { 1415 struct hci_conn_hash *h = &hdev->conn_hash; 1416 struct hci_conn *c; 1417 1418 if (!func) 1419 return; 1420 1421 rcu_read_lock(); 1422 1423 list_for_each_entry_rcu(c, &h->list, list) { 1424 if (c->type == type && c->state == state) 1425 func(c, data); 1426 } 1427 1428 rcu_read_unlock(); 1429 } 1430 1431 static inline void hci_conn_hash_list_flag(struct hci_dev *hdev, 1432 hci_conn_func_t func, __u8 type, 1433 __u8 flag, void *data) 1434 { 1435 struct hci_conn_hash *h = &hdev->conn_hash; 1436 struct hci_conn *c; 1437 1438 if (!func) 1439 return; 1440 1441 rcu_read_lock(); 1442 1443 list_for_each_entry_rcu(c, &h->list, list) { 1444 if (c->type == type && test_bit(flag, &c->flags)) 1445 func(c, data); 1446 } 1447 1448 rcu_read_unlock(); 1449 } 1450 1451 static inline struct hci_conn *hci_lookup_le_connect(struct hci_dev *hdev) 1452 { 1453 struct hci_conn_hash *h = &hdev->conn_hash; 1454 struct hci_conn *c; 1455 1456 rcu_read_lock(); 1457 1458 list_for_each_entry_rcu(c, &h->list, list) { 1459 if (c->type == LE_LINK && c->state == BT_CONNECT && 1460 !test_bit(HCI_CONN_SCANNING, &c->flags)) { 1461 rcu_read_unlock(); 1462 return c; 1463 } 1464 } 1465 1466 rcu_read_unlock(); 1467 1468 return NULL; 1469 } 1470 1471 /* Returns true if an le connection is in the scanning state */ 1472 static inline bool hci_is_le_conn_scanning(struct hci_dev *hdev) 1473 { 1474 struct hci_conn_hash *h = &hdev->conn_hash; 1475 struct hci_conn *c; 1476 1477 rcu_read_lock(); 1478 1479 list_for_each_entry_rcu(c, &h->list, list) { 1480 if (c->type == LE_LINK && c->state == BT_CONNECT && 1481 test_bit(HCI_CONN_SCANNING, &c->flags)) { 1482 rcu_read_unlock(); 1483 return true; 1484 } 1485 } 1486 1487 rcu_read_unlock(); 1488 1489 return false; 1490 } 1491 1492 int hci_disconnect(struct hci_conn *conn, __u8 reason); 1493 bool hci_setup_sync(struct hci_conn *conn, __u16 handle); 1494 void hci_sco_setup(struct hci_conn *conn, __u8 status); 1495 bool hci_iso_setup_path(struct hci_conn *conn); 1496 int hci_le_create_cis_pending(struct hci_dev *hdev); 1497 int hci_conn_check_create_cis(struct hci_conn *conn); 1498 1499 struct hci_conn *hci_conn_add(struct hci_dev *hdev, int type, bdaddr_t *dst, 1500 u8 role, u16 handle); 1501 struct hci_conn *hci_conn_add_unset(struct hci_dev *hdev, int type, 1502 bdaddr_t *dst, u8 role); 1503 void hci_conn_del(struct hci_conn *conn); 1504 void hci_conn_hash_flush(struct hci_dev *hdev); 1505 1506 struct hci_chan *hci_chan_create(struct hci_conn *conn); 1507 void hci_chan_del(struct hci_chan *chan); 1508 void hci_chan_list_flush(struct hci_conn *conn); 1509 struct hci_chan *hci_chan_lookup_handle(struct hci_dev *hdev, __u16 handle); 1510 1511 struct hci_conn *hci_connect_le_scan(struct hci_dev *hdev, bdaddr_t *dst, 1512 u8 dst_type, u8 sec_level, 1513 u16 conn_timeout, 1514 enum conn_reasons conn_reason); 1515 struct hci_conn *hci_connect_le(struct hci_dev *hdev, bdaddr_t *dst, 1516 u8 dst_type, bool dst_resolved, u8 sec_level, 1517 u16 conn_timeout, u8 role, u8 phy, u8 sec_phy); 1518 void hci_connect_le_scan_cleanup(struct hci_conn *conn, u8 status); 1519 struct hci_conn *hci_connect_acl(struct hci_dev *hdev, bdaddr_t *dst, 1520 u8 sec_level, u8 auth_type, 1521 enum conn_reasons conn_reason, u16 timeout); 1522 struct hci_conn *hci_connect_sco(struct hci_dev *hdev, int type, bdaddr_t *dst, 1523 __u16 setting, struct bt_codec *codec, 1524 u16 timeout); 1525 struct hci_conn *hci_bind_cis(struct hci_dev *hdev, bdaddr_t *dst, 1526 __u8 dst_type, struct bt_iso_qos *qos); 1527 struct hci_conn *hci_bind_bis(struct hci_dev *hdev, bdaddr_t *dst, 1528 struct bt_iso_qos *qos, 1529 __u8 base_len, __u8 *base); 1530 struct hci_conn *hci_connect_cis(struct hci_dev *hdev, bdaddr_t *dst, 1531 __u8 dst_type, struct bt_iso_qos *qos); 1532 struct hci_conn *hci_connect_bis(struct hci_dev *hdev, bdaddr_t *dst, 1533 __u8 dst_type, struct bt_iso_qos *qos, 1534 __u8 data_len, __u8 *data); 1535 struct hci_conn *hci_pa_create_sync(struct hci_dev *hdev, bdaddr_t *dst, 1536 __u8 dst_type, __u8 sid, struct bt_iso_qos *qos); 1537 int hci_le_big_create_sync(struct hci_dev *hdev, struct hci_conn *hcon, 1538 struct bt_iso_qos *qos, 1539 __u16 sync_handle, __u8 num_bis, __u8 bis[]); 1540 int hci_conn_check_link_mode(struct hci_conn *conn); 1541 int hci_conn_check_secure(struct hci_conn *conn, __u8 sec_level); 1542 int hci_conn_security(struct hci_conn *conn, __u8 sec_level, __u8 auth_type, 1543 bool initiator); 1544 int hci_conn_switch_role(struct hci_conn *conn, __u8 role); 1545 1546 void hci_conn_enter_active_mode(struct hci_conn *conn, __u8 force_active); 1547 1548 void hci_conn_failed(struct hci_conn *conn, u8 status); 1549 u8 hci_conn_set_handle(struct hci_conn *conn, u16 handle); 1550 1551 /* 1552 * hci_conn_get() and hci_conn_put() are used to control the life-time of an 1553 * "hci_conn" object. They do not guarantee that the hci_conn object is running, 1554 * working or anything else. They just guarantee that the object is available 1555 * and can be dereferenced. So you can use its locks, local variables and any 1556 * other constant data. 1557 * Before accessing runtime data, you _must_ lock the object and then check that 1558 * it is still running. As soon as you release the locks, the connection might 1559 * get dropped, though. 1560 * 1561 * On the other hand, hci_conn_hold() and hci_conn_drop() are used to control 1562 * how long the underlying connection is held. So every channel that runs on the 1563 * hci_conn object calls this to prevent the connection from disappearing. As 1564 * long as you hold a device, you must also guarantee that you have a valid 1565 * reference to the device via hci_conn_get() (or the initial reference from 1566 * hci_conn_add()). 1567 * The hold()/drop() ref-count is known to drop below 0 sometimes, which doesn't 1568 * break because nobody cares for that. But this means, we cannot use 1569 * _get()/_drop() in it, but require the caller to have a valid ref (FIXME). 1570 */ 1571 1572 static inline struct hci_conn *hci_conn_get(struct hci_conn *conn) 1573 { 1574 get_device(&conn->dev); 1575 return conn; 1576 } 1577 1578 static inline void hci_conn_put(struct hci_conn *conn) 1579 { 1580 put_device(&conn->dev); 1581 } 1582 1583 static inline struct hci_conn *hci_conn_hold(struct hci_conn *conn) 1584 { 1585 BT_DBG("hcon %p orig refcnt %d", conn, atomic_read(&conn->refcnt)); 1586 1587 atomic_inc(&conn->refcnt); 1588 cancel_delayed_work(&conn->disc_work); 1589 1590 return conn; 1591 } 1592 1593 static inline void hci_conn_drop(struct hci_conn *conn) 1594 { 1595 BT_DBG("hcon %p orig refcnt %d", conn, atomic_read(&conn->refcnt)); 1596 1597 if (atomic_dec_and_test(&conn->refcnt)) { 1598 unsigned long timeo; 1599 1600 switch (conn->type) { 1601 case ACL_LINK: 1602 case LE_LINK: 1603 cancel_delayed_work(&conn->idle_work); 1604 if (conn->state == BT_CONNECTED) { 1605 timeo = conn->disc_timeout; 1606 if (!conn->out) 1607 timeo *= 2; 1608 } else { 1609 timeo = 0; 1610 } 1611 break; 1612 1613 case AMP_LINK: 1614 timeo = conn->disc_timeout; 1615 break; 1616 1617 default: 1618 timeo = 0; 1619 break; 1620 } 1621 1622 cancel_delayed_work(&conn->disc_work); 1623 queue_delayed_work(conn->hdev->workqueue, 1624 &conn->disc_work, timeo); 1625 } 1626 } 1627 1628 /* ----- HCI Devices ----- */ 1629 static inline void hci_dev_put(struct hci_dev *d) 1630 { 1631 BT_DBG("%s orig refcnt %d", d->name, 1632 kref_read(&d->dev.kobj.kref)); 1633 1634 put_device(&d->dev); 1635 } 1636 1637 static inline struct hci_dev *hci_dev_hold(struct hci_dev *d) 1638 { 1639 BT_DBG("%s orig refcnt %d", d->name, 1640 kref_read(&d->dev.kobj.kref)); 1641 1642 get_device(&d->dev); 1643 return d; 1644 } 1645 1646 #define hci_dev_lock(d) mutex_lock(&d->lock) 1647 #define hci_dev_unlock(d) mutex_unlock(&d->lock) 1648 1649 #define to_hci_dev(d) container_of(d, struct hci_dev, dev) 1650 #define to_hci_conn(c) container_of(c, struct hci_conn, dev) 1651 1652 static inline void *hci_get_drvdata(struct hci_dev *hdev) 1653 { 1654 return dev_get_drvdata(&hdev->dev); 1655 } 1656 1657 static inline void hci_set_drvdata(struct hci_dev *hdev, void *data) 1658 { 1659 dev_set_drvdata(&hdev->dev, data); 1660 } 1661 1662 static inline void *hci_get_priv(struct hci_dev *hdev) 1663 { 1664 return (char *)hdev + sizeof(*hdev); 1665 } 1666 1667 struct hci_dev *hci_dev_get(int index); 1668 struct hci_dev *hci_get_route(bdaddr_t *dst, bdaddr_t *src, u8 src_type); 1669 1670 struct hci_dev *hci_alloc_dev_priv(int sizeof_priv); 1671 1672 static inline struct hci_dev *hci_alloc_dev(void) 1673 { 1674 return hci_alloc_dev_priv(0); 1675 } 1676 1677 void hci_free_dev(struct hci_dev *hdev); 1678 int hci_register_dev(struct hci_dev *hdev); 1679 void hci_unregister_dev(struct hci_dev *hdev); 1680 void hci_release_dev(struct hci_dev *hdev); 1681 int hci_register_suspend_notifier(struct hci_dev *hdev); 1682 int hci_unregister_suspend_notifier(struct hci_dev *hdev); 1683 int hci_suspend_dev(struct hci_dev *hdev); 1684 int hci_resume_dev(struct hci_dev *hdev); 1685 int hci_reset_dev(struct hci_dev *hdev); 1686 int hci_recv_frame(struct hci_dev *hdev, struct sk_buff *skb); 1687 int hci_recv_diag(struct hci_dev *hdev, struct sk_buff *skb); 1688 __printf(2, 3) void hci_set_hw_info(struct hci_dev *hdev, const char *fmt, ...); 1689 __printf(2, 3) void hci_set_fw_info(struct hci_dev *hdev, const char *fmt, ...); 1690 1691 static inline void hci_set_msft_opcode(struct hci_dev *hdev, __u16 opcode) 1692 { 1693 #if IS_ENABLED(CONFIG_BT_MSFTEXT) 1694 hdev->msft_opcode = opcode; 1695 #endif 1696 } 1697 1698 static inline void hci_set_aosp_capable(struct hci_dev *hdev) 1699 { 1700 #if IS_ENABLED(CONFIG_BT_AOSPEXT) 1701 hdev->aosp_capable = true; 1702 #endif 1703 } 1704 1705 static inline void hci_devcd_setup(struct hci_dev *hdev) 1706 { 1707 #ifdef CONFIG_DEV_COREDUMP 1708 INIT_WORK(&hdev->dump.dump_rx, hci_devcd_rx); 1709 INIT_DELAYED_WORK(&hdev->dump.dump_timeout, hci_devcd_timeout); 1710 skb_queue_head_init(&hdev->dump.dump_q); 1711 #endif 1712 } 1713 1714 int hci_dev_open(__u16 dev); 1715 int hci_dev_close(__u16 dev); 1716 int hci_dev_do_close(struct hci_dev *hdev); 1717 int hci_dev_reset(__u16 dev); 1718 int hci_dev_reset_stat(__u16 dev); 1719 int hci_dev_cmd(unsigned int cmd, void __user *arg); 1720 int hci_get_dev_list(void __user *arg); 1721 int hci_get_dev_info(void __user *arg); 1722 int hci_get_conn_list(void __user *arg); 1723 int hci_get_conn_info(struct hci_dev *hdev, void __user *arg); 1724 int hci_get_auth_info(struct hci_dev *hdev, void __user *arg); 1725 int hci_inquiry(void __user *arg); 1726 1727 struct bdaddr_list *hci_bdaddr_list_lookup(struct list_head *list, 1728 bdaddr_t *bdaddr, u8 type); 1729 struct bdaddr_list_with_irk *hci_bdaddr_list_lookup_with_irk( 1730 struct list_head *list, bdaddr_t *bdaddr, 1731 u8 type); 1732 struct bdaddr_list_with_flags * 1733 hci_bdaddr_list_lookup_with_flags(struct list_head *list, bdaddr_t *bdaddr, 1734 u8 type); 1735 int hci_bdaddr_list_add(struct list_head *list, bdaddr_t *bdaddr, u8 type); 1736 int hci_bdaddr_list_add_with_irk(struct list_head *list, bdaddr_t *bdaddr, 1737 u8 type, u8 *peer_irk, u8 *local_irk); 1738 int hci_bdaddr_list_add_with_flags(struct list_head *list, bdaddr_t *bdaddr, 1739 u8 type, u32 flags); 1740 int hci_bdaddr_list_del(struct list_head *list, bdaddr_t *bdaddr, u8 type); 1741 int hci_bdaddr_list_del_with_irk(struct list_head *list, bdaddr_t *bdaddr, 1742 u8 type); 1743 int hci_bdaddr_list_del_with_flags(struct list_head *list, bdaddr_t *bdaddr, 1744 u8 type); 1745 void hci_bdaddr_list_clear(struct list_head *list); 1746 1747 struct hci_conn_params *hci_conn_params_lookup(struct hci_dev *hdev, 1748 bdaddr_t *addr, u8 addr_type); 1749 struct hci_conn_params *hci_conn_params_add(struct hci_dev *hdev, 1750 bdaddr_t *addr, u8 addr_type); 1751 void hci_conn_params_del(struct hci_dev *hdev, bdaddr_t *addr, u8 addr_type); 1752 void hci_conn_params_clear_disabled(struct hci_dev *hdev); 1753 void hci_conn_params_free(struct hci_conn_params *param); 1754 1755 void hci_pend_le_list_del_init(struct hci_conn_params *param); 1756 void hci_pend_le_list_add(struct hci_conn_params *param, 1757 struct list_head *list); 1758 struct hci_conn_params *hci_pend_le_action_lookup(struct list_head *list, 1759 bdaddr_t *addr, 1760 u8 addr_type); 1761 1762 void hci_uuids_clear(struct hci_dev *hdev); 1763 1764 void hci_link_keys_clear(struct hci_dev *hdev); 1765 struct link_key *hci_find_link_key(struct hci_dev *hdev, bdaddr_t *bdaddr); 1766 struct link_key *hci_add_link_key(struct hci_dev *hdev, struct hci_conn *conn, 1767 bdaddr_t *bdaddr, u8 *val, u8 type, 1768 u8 pin_len, bool *persistent); 1769 struct smp_ltk *hci_add_ltk(struct hci_dev *hdev, bdaddr_t *bdaddr, 1770 u8 addr_type, u8 type, u8 authenticated, 1771 u8 tk[16], u8 enc_size, __le16 ediv, __le64 rand); 1772 struct smp_ltk *hci_find_ltk(struct hci_dev *hdev, bdaddr_t *bdaddr, 1773 u8 addr_type, u8 role); 1774 int hci_remove_ltk(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 bdaddr_type); 1775 void hci_smp_ltks_clear(struct hci_dev *hdev); 1776 int hci_remove_link_key(struct hci_dev *hdev, bdaddr_t *bdaddr); 1777 1778 struct smp_irk *hci_find_irk_by_rpa(struct hci_dev *hdev, bdaddr_t *rpa); 1779 struct smp_irk *hci_find_irk_by_addr(struct hci_dev *hdev, bdaddr_t *bdaddr, 1780 u8 addr_type); 1781 struct smp_irk *hci_add_irk(struct hci_dev *hdev, bdaddr_t *bdaddr, 1782 u8 addr_type, u8 val[16], bdaddr_t *rpa); 1783 void hci_remove_irk(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 addr_type); 1784 bool hci_is_blocked_key(struct hci_dev *hdev, u8 type, u8 val[16]); 1785 void hci_blocked_keys_clear(struct hci_dev *hdev); 1786 void hci_smp_irks_clear(struct hci_dev *hdev); 1787 1788 bool hci_bdaddr_is_paired(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 type); 1789 1790 void hci_remote_oob_data_clear(struct hci_dev *hdev); 1791 struct oob_data *hci_find_remote_oob_data(struct hci_dev *hdev, 1792 bdaddr_t *bdaddr, u8 bdaddr_type); 1793 int hci_add_remote_oob_data(struct hci_dev *hdev, bdaddr_t *bdaddr, 1794 u8 bdaddr_type, u8 *hash192, u8 *rand192, 1795 u8 *hash256, u8 *rand256); 1796 int hci_remove_remote_oob_data(struct hci_dev *hdev, bdaddr_t *bdaddr, 1797 u8 bdaddr_type); 1798 1799 void hci_adv_instances_clear(struct hci_dev *hdev); 1800 struct adv_info *hci_find_adv_instance(struct hci_dev *hdev, u8 instance); 1801 struct adv_info *hci_get_next_instance(struct hci_dev *hdev, u8 instance); 1802 struct adv_info *hci_add_adv_instance(struct hci_dev *hdev, u8 instance, 1803 u32 flags, u16 adv_data_len, u8 *adv_data, 1804 u16 scan_rsp_len, u8 *scan_rsp_data, 1805 u16 timeout, u16 duration, s8 tx_power, 1806 u32 min_interval, u32 max_interval, 1807 u8 mesh_handle); 1808 struct adv_info *hci_add_per_instance(struct hci_dev *hdev, u8 instance, 1809 u32 flags, u8 data_len, u8 *data, 1810 u32 min_interval, u32 max_interval); 1811 int hci_set_adv_instance_data(struct hci_dev *hdev, u8 instance, 1812 u16 adv_data_len, u8 *adv_data, 1813 u16 scan_rsp_len, u8 *scan_rsp_data); 1814 int hci_remove_adv_instance(struct hci_dev *hdev, u8 instance); 1815 void hci_adv_instances_set_rpa_expired(struct hci_dev *hdev, bool rpa_expired); 1816 u32 hci_adv_instance_flags(struct hci_dev *hdev, u8 instance); 1817 bool hci_adv_instance_is_scannable(struct hci_dev *hdev, u8 instance); 1818 1819 void hci_adv_monitors_clear(struct hci_dev *hdev); 1820 void hci_free_adv_monitor(struct hci_dev *hdev, struct adv_monitor *monitor); 1821 int hci_add_adv_monitor(struct hci_dev *hdev, struct adv_monitor *monitor); 1822 int hci_remove_single_adv_monitor(struct hci_dev *hdev, u16 handle); 1823 int hci_remove_all_adv_monitor(struct hci_dev *hdev); 1824 bool hci_is_adv_monitoring(struct hci_dev *hdev); 1825 int hci_get_adv_monitor_offload_ext(struct hci_dev *hdev); 1826 1827 void hci_event_packet(struct hci_dev *hdev, struct sk_buff *skb); 1828 1829 void hci_init_sysfs(struct hci_dev *hdev); 1830 void hci_conn_init_sysfs(struct hci_conn *conn); 1831 void hci_conn_add_sysfs(struct hci_conn *conn); 1832 void hci_conn_del_sysfs(struct hci_conn *conn); 1833 1834 #define SET_HCIDEV_DEV(hdev, pdev) ((hdev)->dev.parent = (pdev)) 1835 #define GET_HCIDEV_DEV(hdev) ((hdev)->dev.parent) 1836 1837 /* ----- LMP capabilities ----- */ 1838 #define lmp_encrypt_capable(dev) ((dev)->features[0][0] & LMP_ENCRYPT) 1839 #define lmp_rswitch_capable(dev) ((dev)->features[0][0] & LMP_RSWITCH) 1840 #define lmp_hold_capable(dev) ((dev)->features[0][0] & LMP_HOLD) 1841 #define lmp_sniff_capable(dev) ((dev)->features[0][0] & LMP_SNIFF) 1842 #define lmp_park_capable(dev) ((dev)->features[0][1] & LMP_PARK) 1843 #define lmp_inq_rssi_capable(dev) ((dev)->features[0][3] & LMP_RSSI_INQ) 1844 #define lmp_esco_capable(dev) ((dev)->features[0][3] & LMP_ESCO) 1845 #define lmp_bredr_capable(dev) (!((dev)->features[0][4] & LMP_NO_BREDR)) 1846 #define lmp_le_capable(dev) ((dev)->features[0][4] & LMP_LE) 1847 #define lmp_sniffsubr_capable(dev) ((dev)->features[0][5] & LMP_SNIFF_SUBR) 1848 #define lmp_pause_enc_capable(dev) ((dev)->features[0][5] & LMP_PAUSE_ENC) 1849 #define lmp_esco_2m_capable(dev) ((dev)->features[0][5] & LMP_EDR_ESCO_2M) 1850 #define lmp_ext_inq_capable(dev) ((dev)->features[0][6] & LMP_EXT_INQ) 1851 #define lmp_le_br_capable(dev) (!!((dev)->features[0][6] & LMP_SIMUL_LE_BR)) 1852 #define lmp_ssp_capable(dev) ((dev)->features[0][6] & LMP_SIMPLE_PAIR) 1853 #define lmp_no_flush_capable(dev) ((dev)->features[0][6] & LMP_NO_FLUSH) 1854 #define lmp_lsto_capable(dev) ((dev)->features[0][7] & LMP_LSTO) 1855 #define lmp_inq_tx_pwr_capable(dev) ((dev)->features[0][7] & LMP_INQ_TX_PWR) 1856 #define lmp_ext_feat_capable(dev) ((dev)->features[0][7] & LMP_EXTFEATURES) 1857 #define lmp_transp_capable(dev) ((dev)->features[0][2] & LMP_TRANSPARENT) 1858 #define lmp_edr_2m_capable(dev) ((dev)->features[0][3] & LMP_EDR_2M) 1859 #define lmp_edr_3m_capable(dev) ((dev)->features[0][3] & LMP_EDR_3M) 1860 #define lmp_edr_3slot_capable(dev) ((dev)->features[0][4] & LMP_EDR_3SLOT) 1861 #define lmp_edr_5slot_capable(dev) ((dev)->features[0][5] & LMP_EDR_5SLOT) 1862 1863 /* ----- Extended LMP capabilities ----- */ 1864 #define lmp_cpb_central_capable(dev) ((dev)->features[2][0] & LMP_CPB_CENTRAL) 1865 #define lmp_cpb_peripheral_capable(dev) ((dev)->features[2][0] & LMP_CPB_PERIPHERAL) 1866 #define lmp_sync_train_capable(dev) ((dev)->features[2][0] & LMP_SYNC_TRAIN) 1867 #define lmp_sync_scan_capable(dev) ((dev)->features[2][0] & LMP_SYNC_SCAN) 1868 #define lmp_sc_capable(dev) ((dev)->features[2][1] & LMP_SC) 1869 #define lmp_ping_capable(dev) ((dev)->features[2][1] & LMP_PING) 1870 1871 /* ----- Host capabilities ----- */ 1872 #define lmp_host_ssp_capable(dev) ((dev)->features[1][0] & LMP_HOST_SSP) 1873 #define lmp_host_sc_capable(dev) ((dev)->features[1][0] & LMP_HOST_SC) 1874 #define lmp_host_le_capable(dev) (!!((dev)->features[1][0] & LMP_HOST_LE)) 1875 #define lmp_host_le_br_capable(dev) (!!((dev)->features[1][0] & LMP_HOST_LE_BREDR)) 1876 1877 #define hdev_is_powered(dev) (test_bit(HCI_UP, &(dev)->flags) && \ 1878 !hci_dev_test_flag(dev, HCI_AUTO_OFF)) 1879 #define bredr_sc_enabled(dev) (lmp_sc_capable(dev) && \ 1880 hci_dev_test_flag(dev, HCI_SC_ENABLED)) 1881 #define rpa_valid(dev) (bacmp(&dev->rpa, BDADDR_ANY) && \ 1882 !hci_dev_test_flag(dev, HCI_RPA_EXPIRED)) 1883 #define adv_rpa_valid(adv) (bacmp(&adv->random_addr, BDADDR_ANY) && \ 1884 !adv->rpa_expired) 1885 1886 #define scan_1m(dev) (((dev)->le_tx_def_phys & HCI_LE_SET_PHY_1M) || \ 1887 ((dev)->le_rx_def_phys & HCI_LE_SET_PHY_1M)) 1888 1889 #define le_2m_capable(dev) (((dev)->le_features[1] & HCI_LE_PHY_2M)) 1890 1891 #define scan_2m(dev) (((dev)->le_tx_def_phys & HCI_LE_SET_PHY_2M) || \ 1892 ((dev)->le_rx_def_phys & HCI_LE_SET_PHY_2M)) 1893 1894 #define le_coded_capable(dev) (((dev)->le_features[1] & HCI_LE_PHY_CODED) && \ 1895 !test_bit(HCI_QUIRK_BROKEN_LE_CODED, \ 1896 &(dev)->quirks)) 1897 1898 #define scan_coded(dev) (((dev)->le_tx_def_phys & HCI_LE_SET_PHY_CODED) || \ 1899 ((dev)->le_rx_def_phys & HCI_LE_SET_PHY_CODED)) 1900 1901 #define ll_privacy_capable(dev) ((dev)->le_features[0] & HCI_LE_LL_PRIVACY) 1902 1903 /* Use LL Privacy based address resolution if supported */ 1904 #define use_ll_privacy(dev) (ll_privacy_capable(dev) && \ 1905 hci_dev_test_flag(dev, HCI_ENABLE_LL_PRIVACY)) 1906 1907 #define privacy_mode_capable(dev) (use_ll_privacy(dev) && \ 1908 (hdev->commands[39] & 0x04)) 1909 1910 #define read_key_size_capable(dev) \ 1911 ((dev)->commands[20] & 0x10 && \ 1912 !test_bit(HCI_QUIRK_BROKEN_READ_ENC_KEY_SIZE, &hdev->quirks)) 1913 1914 /* Use enhanced synchronous connection if command is supported and its quirk 1915 * has not been set. 1916 */ 1917 #define enhanced_sync_conn_capable(dev) \ 1918 (((dev)->commands[29] & 0x08) && \ 1919 !test_bit(HCI_QUIRK_BROKEN_ENHANCED_SETUP_SYNC_CONN, &(dev)->quirks)) 1920 1921 /* Use ext scanning if set ext scan param and ext scan enable is supported */ 1922 #define use_ext_scan(dev) (((dev)->commands[37] & 0x20) && \ 1923 ((dev)->commands[37] & 0x40) && \ 1924 !test_bit(HCI_QUIRK_BROKEN_EXT_SCAN, &(dev)->quirks)) 1925 1926 /* Use ext create connection if command is supported */ 1927 #define use_ext_conn(dev) ((dev)->commands[37] & 0x80) 1928 1929 /* Extended advertising support */ 1930 #define ext_adv_capable(dev) (((dev)->le_features[1] & HCI_LE_EXT_ADV)) 1931 1932 /* Maximum advertising length */ 1933 #define max_adv_len(dev) \ 1934 (ext_adv_capable(dev) ? HCI_MAX_EXT_AD_LENGTH : HCI_MAX_AD_LENGTH) 1935 1936 /* BLUETOOTH CORE SPECIFICATION Version 5.3 | Vol 4, Part E page 1789: 1937 * 1938 * C24: Mandatory if the LE Controller supports Connection State and either 1939 * LE Feature (LL Privacy) or LE Feature (Extended Advertising) is supported 1940 */ 1941 #define use_enhanced_conn_complete(dev) (ll_privacy_capable(dev) || \ 1942 ext_adv_capable(dev)) 1943 1944 /* Periodic advertising support */ 1945 #define per_adv_capable(dev) (((dev)->le_features[1] & HCI_LE_PERIODIC_ADV)) 1946 1947 /* CIS Master/Slave and BIS support */ 1948 #define iso_capable(dev) (cis_capable(dev) || bis_capable(dev)) 1949 #define cis_capable(dev) \ 1950 (cis_central_capable(dev) || cis_peripheral_capable(dev)) 1951 #define cis_central_capable(dev) \ 1952 ((dev)->le_features[3] & HCI_LE_CIS_CENTRAL) 1953 #define cis_peripheral_capable(dev) \ 1954 ((dev)->le_features[3] & HCI_LE_CIS_PERIPHERAL) 1955 #define bis_capable(dev) ((dev)->le_features[3] & HCI_LE_ISO_BROADCASTER) 1956 #define sync_recv_capable(dev) ((dev)->le_features[3] & HCI_LE_ISO_SYNC_RECEIVER) 1957 1958 #define mws_transport_config_capable(dev) (((dev)->commands[30] & 0x08) && \ 1959 (!test_bit(HCI_QUIRK_BROKEN_MWS_TRANSPORT_CONFIG, &(dev)->quirks))) 1960 1961 /* ----- HCI protocols ----- */ 1962 #define HCI_PROTO_DEFER 0x01 1963 1964 static inline int hci_proto_connect_ind(struct hci_dev *hdev, bdaddr_t *bdaddr, 1965 __u8 type, __u8 *flags) 1966 { 1967 switch (type) { 1968 case ACL_LINK: 1969 return l2cap_connect_ind(hdev, bdaddr); 1970 1971 case SCO_LINK: 1972 case ESCO_LINK: 1973 return sco_connect_ind(hdev, bdaddr, flags); 1974 1975 case ISO_LINK: 1976 return iso_connect_ind(hdev, bdaddr, flags); 1977 1978 default: 1979 BT_ERR("unknown link type %d", type); 1980 return -EINVAL; 1981 } 1982 } 1983 1984 static inline int hci_proto_disconn_ind(struct hci_conn *conn) 1985 { 1986 if (conn->type != ACL_LINK && conn->type != LE_LINK) 1987 return HCI_ERROR_REMOTE_USER_TERM; 1988 1989 return l2cap_disconn_ind(conn); 1990 } 1991 1992 /* ----- HCI callbacks ----- */ 1993 struct hci_cb { 1994 struct list_head list; 1995 1996 char *name; 1997 1998 void (*connect_cfm) (struct hci_conn *conn, __u8 status); 1999 void (*disconn_cfm) (struct hci_conn *conn, __u8 status); 2000 void (*security_cfm) (struct hci_conn *conn, __u8 status, 2001 __u8 encrypt); 2002 void (*key_change_cfm) (struct hci_conn *conn, __u8 status); 2003 void (*role_switch_cfm) (struct hci_conn *conn, __u8 status, __u8 role); 2004 }; 2005 2006 static inline void hci_connect_cfm(struct hci_conn *conn, __u8 status) 2007 { 2008 struct hci_cb *cb; 2009 2010 mutex_lock(&hci_cb_list_lock); 2011 list_for_each_entry(cb, &hci_cb_list, list) { 2012 if (cb->connect_cfm) 2013 cb->connect_cfm(conn, status); 2014 } 2015 mutex_unlock(&hci_cb_list_lock); 2016 2017 if (conn->connect_cfm_cb) 2018 conn->connect_cfm_cb(conn, status); 2019 } 2020 2021 static inline void hci_disconn_cfm(struct hci_conn *conn, __u8 reason) 2022 { 2023 struct hci_cb *cb; 2024 2025 mutex_lock(&hci_cb_list_lock); 2026 list_for_each_entry(cb, &hci_cb_list, list) { 2027 if (cb->disconn_cfm) 2028 cb->disconn_cfm(conn, reason); 2029 } 2030 mutex_unlock(&hci_cb_list_lock); 2031 2032 if (conn->disconn_cfm_cb) 2033 conn->disconn_cfm_cb(conn, reason); 2034 } 2035 2036 static inline void hci_auth_cfm(struct hci_conn *conn, __u8 status) 2037 { 2038 struct hci_cb *cb; 2039 __u8 encrypt; 2040 2041 if (test_bit(HCI_CONN_ENCRYPT_PEND, &conn->flags)) 2042 return; 2043 2044 encrypt = test_bit(HCI_CONN_ENCRYPT, &conn->flags) ? 0x01 : 0x00; 2045 2046 mutex_lock(&hci_cb_list_lock); 2047 list_for_each_entry(cb, &hci_cb_list, list) { 2048 if (cb->security_cfm) 2049 cb->security_cfm(conn, status, encrypt); 2050 } 2051 mutex_unlock(&hci_cb_list_lock); 2052 2053 if (conn->security_cfm_cb) 2054 conn->security_cfm_cb(conn, status); 2055 } 2056 2057 static inline void hci_encrypt_cfm(struct hci_conn *conn, __u8 status) 2058 { 2059 struct hci_cb *cb; 2060 __u8 encrypt; 2061 2062 if (conn->state == BT_CONFIG) { 2063 if (!status) 2064 conn->state = BT_CONNECTED; 2065 2066 hci_connect_cfm(conn, status); 2067 hci_conn_drop(conn); 2068 return; 2069 } 2070 2071 if (!test_bit(HCI_CONN_ENCRYPT, &conn->flags)) 2072 encrypt = 0x00; 2073 else if (test_bit(HCI_CONN_AES_CCM, &conn->flags)) 2074 encrypt = 0x02; 2075 else 2076 encrypt = 0x01; 2077 2078 if (!status) { 2079 if (conn->sec_level == BT_SECURITY_SDP) 2080 conn->sec_level = BT_SECURITY_LOW; 2081 2082 if (conn->pending_sec_level > conn->sec_level) 2083 conn->sec_level = conn->pending_sec_level; 2084 } 2085 2086 mutex_lock(&hci_cb_list_lock); 2087 list_for_each_entry(cb, &hci_cb_list, list) { 2088 if (cb->security_cfm) 2089 cb->security_cfm(conn, status, encrypt); 2090 } 2091 mutex_unlock(&hci_cb_list_lock); 2092 2093 if (conn->security_cfm_cb) 2094 conn->security_cfm_cb(conn, status); 2095 } 2096 2097 static inline void hci_key_change_cfm(struct hci_conn *conn, __u8 status) 2098 { 2099 struct hci_cb *cb; 2100 2101 mutex_lock(&hci_cb_list_lock); 2102 list_for_each_entry(cb, &hci_cb_list, list) { 2103 if (cb->key_change_cfm) 2104 cb->key_change_cfm(conn, status); 2105 } 2106 mutex_unlock(&hci_cb_list_lock); 2107 } 2108 2109 static inline void hci_role_switch_cfm(struct hci_conn *conn, __u8 status, 2110 __u8 role) 2111 { 2112 struct hci_cb *cb; 2113 2114 mutex_lock(&hci_cb_list_lock); 2115 list_for_each_entry(cb, &hci_cb_list, list) { 2116 if (cb->role_switch_cfm) 2117 cb->role_switch_cfm(conn, status, role); 2118 } 2119 mutex_unlock(&hci_cb_list_lock); 2120 } 2121 2122 static inline bool hci_bdaddr_is_rpa(bdaddr_t *bdaddr, u8 addr_type) 2123 { 2124 if (addr_type != ADDR_LE_DEV_RANDOM) 2125 return false; 2126 2127 if ((bdaddr->b[5] & 0xc0) == 0x40) 2128 return true; 2129 2130 return false; 2131 } 2132 2133 static inline bool hci_is_identity_address(bdaddr_t *addr, u8 addr_type) 2134 { 2135 if (addr_type == ADDR_LE_DEV_PUBLIC) 2136 return true; 2137 2138 /* Check for Random Static address type */ 2139 if ((addr->b[5] & 0xc0) == 0xc0) 2140 return true; 2141 2142 return false; 2143 } 2144 2145 static inline struct smp_irk *hci_get_irk(struct hci_dev *hdev, 2146 bdaddr_t *bdaddr, u8 addr_type) 2147 { 2148 if (!hci_bdaddr_is_rpa(bdaddr, addr_type)) 2149 return NULL; 2150 2151 return hci_find_irk_by_rpa(hdev, bdaddr); 2152 } 2153 2154 static inline int hci_check_conn_params(u16 min, u16 max, u16 latency, 2155 u16 to_multiplier) 2156 { 2157 u16 max_latency; 2158 2159 if (min > max || min < 6 || max > 3200) 2160 return -EINVAL; 2161 2162 if (to_multiplier < 10 || to_multiplier > 3200) 2163 return -EINVAL; 2164 2165 if (max >= to_multiplier * 8) 2166 return -EINVAL; 2167 2168 max_latency = (to_multiplier * 4 / max) - 1; 2169 if (latency > 499 || latency > max_latency) 2170 return -EINVAL; 2171 2172 return 0; 2173 } 2174 2175 int hci_register_cb(struct hci_cb *hcb); 2176 int hci_unregister_cb(struct hci_cb *hcb); 2177 2178 int __hci_cmd_send(struct hci_dev *hdev, u16 opcode, u32 plen, 2179 const void *param); 2180 2181 int hci_send_cmd(struct hci_dev *hdev, __u16 opcode, __u32 plen, 2182 const void *param); 2183 void hci_send_acl(struct hci_chan *chan, struct sk_buff *skb, __u16 flags); 2184 void hci_send_sco(struct hci_conn *conn, struct sk_buff *skb); 2185 void hci_send_iso(struct hci_conn *conn, struct sk_buff *skb); 2186 2187 void *hci_sent_cmd_data(struct hci_dev *hdev, __u16 opcode); 2188 void *hci_recv_event_data(struct hci_dev *hdev, __u8 event); 2189 2190 u32 hci_conn_get_phy(struct hci_conn *conn); 2191 2192 /* ----- HCI Sockets ----- */ 2193 void hci_send_to_sock(struct hci_dev *hdev, struct sk_buff *skb); 2194 void hci_send_to_channel(unsigned short channel, struct sk_buff *skb, 2195 int flag, struct sock *skip_sk); 2196 void hci_send_to_monitor(struct hci_dev *hdev, struct sk_buff *skb); 2197 void hci_send_monitor_ctrl_event(struct hci_dev *hdev, u16 event, 2198 void *data, u16 data_len, ktime_t tstamp, 2199 int flag, struct sock *skip_sk); 2200 2201 void hci_sock_dev_event(struct hci_dev *hdev, int event); 2202 2203 #define HCI_MGMT_VAR_LEN BIT(0) 2204 #define HCI_MGMT_NO_HDEV BIT(1) 2205 #define HCI_MGMT_UNTRUSTED BIT(2) 2206 #define HCI_MGMT_UNCONFIGURED BIT(3) 2207 #define HCI_MGMT_HDEV_OPTIONAL BIT(4) 2208 2209 struct hci_mgmt_handler { 2210 int (*func) (struct sock *sk, struct hci_dev *hdev, void *data, 2211 u16 data_len); 2212 size_t data_len; 2213 unsigned long flags; 2214 }; 2215 2216 struct hci_mgmt_chan { 2217 struct list_head list; 2218 unsigned short channel; 2219 size_t handler_count; 2220 const struct hci_mgmt_handler *handlers; 2221 void (*hdev_init) (struct sock *sk, struct hci_dev *hdev); 2222 }; 2223 2224 int hci_mgmt_chan_register(struct hci_mgmt_chan *c); 2225 void hci_mgmt_chan_unregister(struct hci_mgmt_chan *c); 2226 2227 /* Management interface */ 2228 #define DISCOV_TYPE_BREDR (BIT(BDADDR_BREDR)) 2229 #define DISCOV_TYPE_LE (BIT(BDADDR_LE_PUBLIC) | \ 2230 BIT(BDADDR_LE_RANDOM)) 2231 #define DISCOV_TYPE_INTERLEAVED (BIT(BDADDR_BREDR) | \ 2232 BIT(BDADDR_LE_PUBLIC) | \ 2233 BIT(BDADDR_LE_RANDOM)) 2234 2235 /* These LE scan and inquiry parameters were chosen according to LE General 2236 * Discovery Procedure specification. 2237 */ 2238 #define DISCOV_LE_SCAN_WIN 0x12 2239 #define DISCOV_LE_SCAN_INT 0x12 2240 #define DISCOV_LE_TIMEOUT 10240 /* msec */ 2241 #define DISCOV_INTERLEAVED_TIMEOUT 5120 /* msec */ 2242 #define DISCOV_INTERLEAVED_INQUIRY_LEN 0x04 2243 #define DISCOV_BREDR_INQUIRY_LEN 0x08 2244 #define DISCOV_LE_RESTART_DELAY msecs_to_jiffies(200) /* msec */ 2245 #define DISCOV_LE_FAST_ADV_INT_MIN 0x00A0 /* 100 msec */ 2246 #define DISCOV_LE_FAST_ADV_INT_MAX 0x00F0 /* 150 msec */ 2247 #define DISCOV_LE_PER_ADV_INT_MIN 0x00A0 /* 200 msec */ 2248 #define DISCOV_LE_PER_ADV_INT_MAX 0x00A0 /* 200 msec */ 2249 #define DISCOV_LE_ADV_MESH_MIN 0x00A0 /* 100 msec */ 2250 #define DISCOV_LE_ADV_MESH_MAX 0x00A0 /* 100 msec */ 2251 #define INTERVAL_TO_MS(x) (((x) * 10) / 0x10) 2252 2253 #define NAME_RESOLVE_DURATION msecs_to_jiffies(10240) /* 10.24 sec */ 2254 2255 void mgmt_fill_version_info(void *ver); 2256 int mgmt_new_settings(struct hci_dev *hdev); 2257 void mgmt_index_added(struct hci_dev *hdev); 2258 void mgmt_index_removed(struct hci_dev *hdev); 2259 void mgmt_set_powered_failed(struct hci_dev *hdev, int err); 2260 void mgmt_power_on(struct hci_dev *hdev, int err); 2261 void __mgmt_power_off(struct hci_dev *hdev); 2262 void mgmt_new_link_key(struct hci_dev *hdev, struct link_key *key, 2263 bool persistent); 2264 void mgmt_device_connected(struct hci_dev *hdev, struct hci_conn *conn, 2265 u8 *name, u8 name_len); 2266 void mgmt_device_disconnected(struct hci_dev *hdev, bdaddr_t *bdaddr, 2267 u8 link_type, u8 addr_type, u8 reason, 2268 bool mgmt_connected); 2269 void mgmt_disconnect_failed(struct hci_dev *hdev, bdaddr_t *bdaddr, 2270 u8 link_type, u8 addr_type, u8 status); 2271 void mgmt_connect_failed(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 link_type, 2272 u8 addr_type, u8 status); 2273 void mgmt_pin_code_request(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 secure); 2274 void mgmt_pin_code_reply_complete(struct hci_dev *hdev, bdaddr_t *bdaddr, 2275 u8 status); 2276 void mgmt_pin_code_neg_reply_complete(struct hci_dev *hdev, bdaddr_t *bdaddr, 2277 u8 status); 2278 int mgmt_user_confirm_request(struct hci_dev *hdev, bdaddr_t *bdaddr, 2279 u8 link_type, u8 addr_type, u32 value, 2280 u8 confirm_hint); 2281 int mgmt_user_confirm_reply_complete(struct hci_dev *hdev, bdaddr_t *bdaddr, 2282 u8 link_type, u8 addr_type, u8 status); 2283 int mgmt_user_confirm_neg_reply_complete(struct hci_dev *hdev, bdaddr_t *bdaddr, 2284 u8 link_type, u8 addr_type, u8 status); 2285 int mgmt_user_passkey_request(struct hci_dev *hdev, bdaddr_t *bdaddr, 2286 u8 link_type, u8 addr_type); 2287 int mgmt_user_passkey_reply_complete(struct hci_dev *hdev, bdaddr_t *bdaddr, 2288 u8 link_type, u8 addr_type, u8 status); 2289 int mgmt_user_passkey_neg_reply_complete(struct hci_dev *hdev, bdaddr_t *bdaddr, 2290 u8 link_type, u8 addr_type, u8 status); 2291 int mgmt_user_passkey_notify(struct hci_dev *hdev, bdaddr_t *bdaddr, 2292 u8 link_type, u8 addr_type, u32 passkey, 2293 u8 entered); 2294 void mgmt_auth_failed(struct hci_conn *conn, u8 status); 2295 void mgmt_auth_enable_complete(struct hci_dev *hdev, u8 status); 2296 void mgmt_set_class_of_dev_complete(struct hci_dev *hdev, u8 *dev_class, 2297 u8 status); 2298 void mgmt_set_local_name_complete(struct hci_dev *hdev, u8 *name, u8 status); 2299 void mgmt_start_discovery_complete(struct hci_dev *hdev, u8 status); 2300 void mgmt_stop_discovery_complete(struct hci_dev *hdev, u8 status); 2301 void mgmt_device_found(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 link_type, 2302 u8 addr_type, u8 *dev_class, s8 rssi, u32 flags, 2303 u8 *eir, u16 eir_len, u8 *scan_rsp, u8 scan_rsp_len, 2304 u64 instant); 2305 void mgmt_remote_name(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 link_type, 2306 u8 addr_type, s8 rssi, u8 *name, u8 name_len); 2307 void mgmt_discovering(struct hci_dev *hdev, u8 discovering); 2308 void mgmt_suspending(struct hci_dev *hdev, u8 state); 2309 void mgmt_resuming(struct hci_dev *hdev, u8 reason, bdaddr_t *bdaddr, 2310 u8 addr_type); 2311 bool mgmt_powering_down(struct hci_dev *hdev); 2312 void mgmt_new_ltk(struct hci_dev *hdev, struct smp_ltk *key, bool persistent); 2313 void mgmt_new_irk(struct hci_dev *hdev, struct smp_irk *irk, bool persistent); 2314 void mgmt_new_csrk(struct hci_dev *hdev, struct smp_csrk *csrk, 2315 bool persistent); 2316 void mgmt_new_conn_param(struct hci_dev *hdev, bdaddr_t *bdaddr, 2317 u8 bdaddr_type, u8 store_hint, u16 min_interval, 2318 u16 max_interval, u16 latency, u16 timeout); 2319 void mgmt_smp_complete(struct hci_conn *conn, bool complete); 2320 bool mgmt_get_connectable(struct hci_dev *hdev); 2321 u8 mgmt_get_adv_discov_flags(struct hci_dev *hdev); 2322 void mgmt_advertising_added(struct sock *sk, struct hci_dev *hdev, 2323 u8 instance); 2324 void mgmt_advertising_removed(struct sock *sk, struct hci_dev *hdev, 2325 u8 instance); 2326 void mgmt_adv_monitor_removed(struct hci_dev *hdev, u16 handle); 2327 int mgmt_phy_configuration_changed(struct hci_dev *hdev, struct sock *skip); 2328 void mgmt_adv_monitor_device_lost(struct hci_dev *hdev, u16 handle, 2329 bdaddr_t *bdaddr, u8 addr_type); 2330 2331 int hci_abort_conn(struct hci_conn *conn, u8 reason); 2332 u8 hci_le_conn_update(struct hci_conn *conn, u16 min, u16 max, u16 latency, 2333 u16 to_multiplier); 2334 void hci_le_start_enc(struct hci_conn *conn, __le16 ediv, __le64 rand, 2335 __u8 ltk[16], __u8 key_size); 2336 2337 void hci_copy_identity_address(struct hci_dev *hdev, bdaddr_t *bdaddr, 2338 u8 *bdaddr_type); 2339 2340 #define SCO_AIRMODE_MASK 0x0003 2341 #define SCO_AIRMODE_CVSD 0x0000 2342 #define SCO_AIRMODE_TRANSP 0x0003 2343 2344 #define LOCAL_CODEC_ACL_MASK BIT(0) 2345 #define LOCAL_CODEC_SCO_MASK BIT(1) 2346 2347 #define TRANSPORT_TYPE_MAX 0x04 2348 2349 #endif /* __HCI_CORE_H */ 2350