Linux Audio

Check our new training course

Loading...
v4.6
   1/*
   2   BlueZ - Bluetooth protocol stack for Linux
   3   Copyright (c) 2000-2001, 2010, Code Aurora Forum. All rights reserved.
   4
   5   Written 2000,2001 by Maxim Krasnyansky <maxk@qualcomm.com>
   6
   7   This program is free software; you can redistribute it and/or modify
   8   it under the terms of the GNU General Public License version 2 as
   9   published by the Free Software Foundation;
  10
  11   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
  12   OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  13   FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS.
  14   IN NO EVENT SHALL THE COPYRIGHT HOLDER(S) AND AUTHOR(S) BE LIABLE FOR ANY
  15   CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES
  16   WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  17   ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  18   OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  19
  20   ALL LIABILITY, INCLUDING LIABILITY FOR INFRINGEMENT OF ANY PATENTS,
  21   COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS, RELATING TO USE OF THIS
  22   SOFTWARE IS DISCLAIMED.
  23*/
  24
  25#ifndef __HCI_CORE_H
  26#define __HCI_CORE_H
  27
  28#include <linux/leds.h>
  29#include <net/bluetooth/hci.h>
  30#include <net/bluetooth/hci_sock.h>
  31
  32/* HCI priority */
  33#define HCI_PRIO_MAX	7
  34
  35/* HCI Core structures */
  36struct inquiry_data {
  37	bdaddr_t	bdaddr;
  38	__u8		pscan_rep_mode;
  39	__u8		pscan_period_mode;
  40	__u8		pscan_mode;
  41	__u8		dev_class[3];
  42	__le16		clock_offset;
  43	__s8		rssi;
  44	__u8		ssp_mode;
  45};
  46
  47struct inquiry_entry {
  48	struct list_head	all;		/* inq_cache.all */
  49	struct list_head	list;		/* unknown or resolve */
  50	enum {
  51		NAME_NOT_KNOWN,
  52		NAME_NEEDED,
  53		NAME_PENDING,
  54		NAME_KNOWN,
  55	} name_state;
  56	__u32			timestamp;
  57	struct inquiry_data	data;
  58};
  59
  60struct discovery_state {
  61	int			type;
  62	enum {
  63		DISCOVERY_STOPPED,
  64		DISCOVERY_STARTING,
  65		DISCOVERY_FINDING,
  66		DISCOVERY_RESOLVING,
  67		DISCOVERY_STOPPING,
  68	} state;
  69	struct list_head	all;	/* All devices found during inquiry */
  70	struct list_head	unknown;	/* Name state not known */
  71	struct list_head	resolve;	/* Name needs to be resolved */
  72	__u32			timestamp;
  73	bdaddr_t		last_adv_addr;
  74	u8			last_adv_addr_type;
  75	s8			last_adv_rssi;
  76	u32			last_adv_flags;
  77	u8			last_adv_data[HCI_MAX_AD_LENGTH];
  78	u8			last_adv_data_len;
  79	bool			report_invalid_rssi;
  80	bool			result_filtering;
  81	bool			limited;
  82	s8			rssi;
  83	u16			uuid_count;
  84	u8			(*uuids)[16];
  85	unsigned long		scan_start;
  86	unsigned long		scan_duration;
  87};
  88
  89struct hci_conn_hash {
  90	struct list_head list;
  91	unsigned int     acl_num;
  92	unsigned int     amp_num;
  93	unsigned int     sco_num;
  94	unsigned int     le_num;
  95	unsigned int     le_num_slave;
  96};
  97
  98struct bdaddr_list {
  99	struct list_head list;
 100	bdaddr_t bdaddr;
 101	u8 bdaddr_type;
 102};
 103
 104struct bt_uuid {
 105	struct list_head list;
 106	u8 uuid[16];
 107	u8 size;
 108	u8 svc_hint;
 109};
 110
 111struct smp_csrk {
 112	bdaddr_t bdaddr;
 113	u8 bdaddr_type;
 114	u8 type;
 115	u8 val[16];
 116};
 117
 118struct smp_ltk {
 119	struct list_head list;
 120	struct rcu_head rcu;
 121	bdaddr_t bdaddr;
 122	u8 bdaddr_type;
 123	u8 authenticated;
 124	u8 type;
 125	u8 enc_size;
 126	__le16 ediv;
 127	__le64 rand;
 128	u8 val[16];
 129};
 130
 131struct smp_irk {
 132	struct list_head list;
 133	struct rcu_head rcu;
 134	bdaddr_t rpa;
 135	bdaddr_t bdaddr;
 136	u8 addr_type;
 137	u8 val[16];
 138};
 139
 140struct link_key {
 141	struct list_head list;
 142	struct rcu_head rcu;
 143	bdaddr_t bdaddr;
 144	u8 type;
 145	u8 val[HCI_LINK_KEY_SIZE];
 146	u8 pin_len;
 147};
 148
 149struct oob_data {
 150	struct list_head list;
 151	bdaddr_t bdaddr;
 152	u8 bdaddr_type;
 153	u8 present;
 154	u8 hash192[16];
 155	u8 rand192[16];
 156	u8 hash256[16];
 157	u8 rand256[16];
 158};
 159
 160struct adv_info {
 161	struct list_head list;
 162	bool pending;
 163	__u8	instance;
 164	__u32	flags;
 165	__u16	timeout;
 166	__u16	remaining_time;
 167	__u16	duration;
 168	__u16	adv_data_len;
 169	__u8	adv_data[HCI_MAX_AD_LENGTH];
 170	__u16	scan_rsp_len;
 171	__u8	scan_rsp_data[HCI_MAX_AD_LENGTH];
 172};
 173
 174#define HCI_MAX_ADV_INSTANCES		5
 175#define HCI_DEFAULT_ADV_DURATION	2
 176
 177#define HCI_MAX_SHORT_NAME_LENGTH	10
 178
 179/* Default LE RPA expiry time, 15 minutes */
 180#define HCI_DEFAULT_RPA_TIMEOUT		(15 * 60)
 181
 182/* Default min/max age of connection information (1s/3s) */
 183#define DEFAULT_CONN_INFO_MIN_AGE	1000
 184#define DEFAULT_CONN_INFO_MAX_AGE	3000
 185
 186struct amp_assoc {
 187	__u16	len;
 188	__u16	offset;
 189	__u16	rem_len;
 190	__u16	len_so_far;
 191	__u8	data[HCI_MAX_AMP_ASSOC_SIZE];
 192};
 193
 194#define HCI_MAX_PAGES	3
 195
 
 196struct hci_dev {
 197	struct list_head list;
 198	struct mutex	lock;
 199
 200	char		name[8];
 201	unsigned long	flags;
 202	__u16		id;
 203	__u8		bus;
 204	__u8		dev_type;
 205	bdaddr_t	bdaddr;
 206	bdaddr_t	setup_addr;
 207	bdaddr_t	public_addr;
 208	bdaddr_t	random_addr;
 209	bdaddr_t	static_addr;
 210	__u8		adv_addr_type;
 211	__u8		dev_name[HCI_MAX_NAME_LENGTH];
 212	__u8		short_name[HCI_MAX_SHORT_NAME_LENGTH];
 213	__u8		eir[HCI_MAX_EIR_LENGTH];
 214	__u8		dev_class[3];
 215	__u8		major_class;
 216	__u8		minor_class;
 217	__u8		max_page;
 218	__u8		features[HCI_MAX_PAGES][8];
 219	__u8		le_features[8];
 220	__u8		le_white_list_size;
 221	__u8		le_states[8];
 222	__u8		commands[64];
 223	__u8		hci_ver;
 224	__u16		hci_rev;
 225	__u8		lmp_ver;
 226	__u16		manufacturer;
 227	__u16		lmp_subver;
 228	__u16		voice_setting;
 229	__u8		num_iac;
 230	__u8		stored_max_keys;
 231	__u8		stored_num_keys;
 232	__u8		io_capability;
 233	__s8		inq_tx_power;
 234	__u16		page_scan_interval;
 235	__u16		page_scan_window;
 236	__u8		page_scan_type;
 237	__u8		le_adv_channel_map;
 238	__u16		le_adv_min_interval;
 239	__u16		le_adv_max_interval;
 240	__u8		le_scan_type;
 241	__u16		le_scan_interval;
 242	__u16		le_scan_window;
 243	__u16		le_conn_min_interval;
 244	__u16		le_conn_max_interval;
 245	__u16		le_conn_latency;
 246	__u16		le_supv_timeout;
 247	__u16		le_def_tx_len;
 248	__u16		le_def_tx_time;
 249	__u16		le_max_tx_len;
 250	__u16		le_max_tx_time;
 251	__u16		le_max_rx_len;
 252	__u16		le_max_rx_time;
 253	__u16		discov_interleaved_timeout;
 254	__u16		conn_info_min_age;
 255	__u16		conn_info_max_age;
 256	__u8		ssp_debug_mode;
 257	__u8		hw_error_code;
 258	__u32		clock;
 259
 260	__u16		devid_source;
 261	__u16		devid_vendor;
 262	__u16		devid_product;
 263	__u16		devid_version;
 264
 265	__u16		pkt_type;
 266	__u16		esco_type;
 267	__u16		link_policy;
 268	__u16		link_mode;
 269
 270	__u32		idle_timeout;
 271	__u16		sniff_min_interval;
 272	__u16		sniff_max_interval;
 273
 274	__u8		amp_status;
 275	__u32		amp_total_bw;
 276	__u32		amp_max_bw;
 277	__u32		amp_min_latency;
 278	__u32		amp_max_pdu;
 279	__u8		amp_type;
 280	__u16		amp_pal_cap;
 281	__u16		amp_assoc_size;
 282	__u32		amp_max_flush_to;
 283	__u32		amp_be_flush_to;
 284
 285	struct amp_assoc	loc_assoc;
 286
 287	__u8		flow_ctl_mode;
 288
 289	unsigned int	auto_accept_delay;
 290
 291	unsigned long	quirks;
 292
 293	atomic_t	cmd_cnt;
 294	unsigned int	acl_cnt;
 295	unsigned int	sco_cnt;
 296	unsigned int	le_cnt;
 297
 298	unsigned int	acl_mtu;
 299	unsigned int	sco_mtu;
 300	unsigned int	le_mtu;
 301	unsigned int	acl_pkts;
 302	unsigned int	sco_pkts;
 303	unsigned int	le_pkts;
 304
 305	__u16		block_len;
 306	__u16		block_mtu;
 307	__u16		num_blocks;
 308	__u16		block_cnt;
 309
 310	unsigned long	acl_last_tx;
 311	unsigned long	sco_last_tx;
 312	unsigned long	le_last_tx;
 313
 314	struct workqueue_struct	*workqueue;
 315	struct workqueue_struct	*req_workqueue;
 316
 317	struct work_struct	power_on;
 318	struct delayed_work	power_off;
 319	struct work_struct	error_reset;
 320
 321	__u16			discov_timeout;
 322	struct delayed_work	discov_off;
 323
 324	struct delayed_work	service_cache;
 325
 326	struct delayed_work	cmd_timer;
 327
 328	struct work_struct	rx_work;
 329	struct work_struct	cmd_work;
 330	struct work_struct	tx_work;
 331
 332	struct work_struct	discov_update;
 333	struct work_struct	bg_scan_update;
 334	struct work_struct	scan_update;
 335	struct work_struct	connectable_update;
 336	struct work_struct	discoverable_update;
 337	struct delayed_work	le_scan_disable;
 338	struct delayed_work	le_scan_restart;
 339
 340	struct sk_buff_head	rx_q;
 341	struct sk_buff_head	raw_q;
 342	struct sk_buff_head	cmd_q;
 343
 
 344	struct sk_buff		*sent_cmd;
 
 345
 346	struct mutex		req_lock;
 347	wait_queue_head_t	req_wait_q;
 348	__u32			req_status;
 349	__u32			req_result;
 350	struct sk_buff		*req_skb;
 351
 352	void			*smp_data;
 353	void			*smp_bredr_data;
 354
 355	struct discovery_state	discovery;
 356	struct hci_conn_hash	conn_hash;
 357
 358	struct list_head	mgmt_pending;
 359	struct list_head	blacklist;
 360	struct list_head	whitelist;
 361	struct list_head	uuids;
 362	struct list_head	link_keys;
 363	struct list_head	long_term_keys;
 364	struct list_head	identity_resolving_keys;
 365	struct list_head	remote_oob_data;
 366	struct list_head	le_white_list;
 367	struct list_head	le_conn_params;
 368	struct list_head	pend_le_conns;
 369	struct list_head	pend_le_reports;
 370
 371	struct hci_dev_stats	stat;
 372
 373	atomic_t		promisc;
 374
 375	struct dentry		*debugfs;
 376
 377	struct device		dev;
 378
 379	struct rfkill		*rfkill;
 380
 381	DECLARE_BITMAP(dev_flags, __HCI_NUM_FLAGS);
 
 
 382
 383	__s8			adv_tx_power;
 384	__u8			adv_data[HCI_MAX_AD_LENGTH];
 385	__u8			adv_data_len;
 386	__u8			scan_rsp_data[HCI_MAX_AD_LENGTH];
 387	__u8			scan_rsp_data_len;
 388
 389	struct list_head	adv_instances;
 390	unsigned int		adv_instance_cnt;
 391	__u8			cur_adv_instance;
 392	__u16			adv_instance_timeout;
 393	struct delayed_work	adv_instance_expire;
 394
 395	__u8			irk[16];
 396	__u32			rpa_timeout;
 397	struct delayed_work	rpa_expired;
 398	bdaddr_t		rpa;
 399
 400	struct led_trigger	*power_led;
 401
 402	int (*open)(struct hci_dev *hdev);
 403	int (*close)(struct hci_dev *hdev);
 404	int (*flush)(struct hci_dev *hdev);
 405	int (*setup)(struct hci_dev *hdev);
 406	int (*shutdown)(struct hci_dev *hdev);
 407	int (*send)(struct hci_dev *hdev, struct sk_buff *skb);
 408	void (*notify)(struct hci_dev *hdev, unsigned int evt);
 409	void (*hw_error)(struct hci_dev *hdev, u8 code);
 410	int (*post_init)(struct hci_dev *hdev);
 411	int (*set_diag)(struct hci_dev *hdev, bool enable);
 412	int (*set_bdaddr)(struct hci_dev *hdev, const bdaddr_t *bdaddr);
 413};
 414
 415#define HCI_PHY_HANDLE(handle)	(handle & 0xff)
 416
 417struct hci_conn {
 418	struct list_head list;
 419
 420	atomic_t	refcnt;
 421
 422	bdaddr_t	dst;
 423	__u8		dst_type;
 424	bdaddr_t	src;
 425	__u8		src_type;
 426	bdaddr_t	init_addr;
 427	__u8		init_addr_type;
 428	bdaddr_t	resp_addr;
 429	__u8		resp_addr_type;
 430	__u16		handle;
 431	__u16		state;
 432	__u8		mode;
 433	__u8		type;
 434	__u8		role;
 435	bool		out;
 436	__u8		attempt;
 437	__u8		dev_class[3];
 438	__u8		features[HCI_MAX_PAGES][8];
 439	__u16		pkt_type;
 440	__u16		link_policy;
 
 441	__u8		key_type;
 442	__u8		auth_type;
 443	__u8		sec_level;
 444	__u8		pending_sec_level;
 445	__u8		pin_length;
 446	__u8		enc_key_size;
 447	__u8		io_capability;
 448	__u32		passkey_notify;
 449	__u8		passkey_entered;
 450	__u16		disc_timeout;
 451	__u16		conn_timeout;
 452	__u16		setting;
 453	__u16		le_conn_min_interval;
 454	__u16		le_conn_max_interval;
 455	__u16		le_conn_interval;
 456	__u16		le_conn_latency;
 457	__u16		le_supv_timeout;
 458	__u8		le_adv_data[HCI_MAX_AD_LENGTH];
 459	__u8		le_adv_data_len;
 460	__s8		rssi;
 461	__s8		tx_power;
 462	__s8		max_tx_power;
 463	unsigned long	flags;
 464
 465	__u32		clock;
 466	__u16		clock_accuracy;
 467
 468	unsigned long	conn_info_timestamp;
 469
 470	__u8		remote_cap;
 471	__u8		remote_auth;
 472	__u8		remote_id;
 
 473
 474	unsigned int	sent;
 475
 476	struct sk_buff_head data_q;
 477	struct list_head chan_list;
 478
 479	struct delayed_work disc_work;
 480	struct delayed_work auto_accept_work;
 481	struct delayed_work idle_work;
 482	struct delayed_work le_conn_timeout;
 483	struct work_struct  le_scan_cleanup;
 484
 485	struct device	dev;
 486	struct dentry	*debugfs;
 487
 488	struct hci_dev	*hdev;
 489	void		*l2cap_data;
 490	void		*sco_data;
 
 491	struct amp_mgr	*amp_mgr;
 492
 493	struct hci_conn	*link;
 494
 495	void (*connect_cfm_cb)	(struct hci_conn *conn, u8 status);
 496	void (*security_cfm_cb)	(struct hci_conn *conn, u8 status);
 497	void (*disconn_cfm_cb)	(struct hci_conn *conn, u8 reason);
 498};
 499
 500struct hci_chan {
 501	struct list_head list;
 502	__u16 handle;
 503	struct hci_conn *conn;
 504	struct sk_buff_head data_q;
 505	unsigned int	sent;
 506	__u8		state;
 507};
 508
 509struct hci_conn_params {
 510	struct list_head list;
 511	struct list_head action;
 512
 513	bdaddr_t addr;
 514	u8 addr_type;
 515
 516	u16 conn_min_interval;
 517	u16 conn_max_interval;
 518	u16 conn_latency;
 519	u16 supervision_timeout;
 520
 521	enum {
 522		HCI_AUTO_CONN_DISABLED,
 523		HCI_AUTO_CONN_REPORT,
 524		HCI_AUTO_CONN_DIRECT,
 525		HCI_AUTO_CONN_ALWAYS,
 526		HCI_AUTO_CONN_LINK_LOSS,
 527		HCI_AUTO_CONN_EXPLICIT,
 528	} auto_connect;
 529
 530	struct hci_conn *conn;
 531	bool explicit_connect;
 532};
 533
 534extern struct list_head hci_dev_list;
 535extern struct list_head hci_cb_list;
 536extern rwlock_t hci_dev_list_lock;
 537extern struct mutex hci_cb_list_lock;
 538
 539#define hci_dev_set_flag(hdev, nr)             set_bit((nr), (hdev)->dev_flags)
 540#define hci_dev_clear_flag(hdev, nr)           clear_bit((nr), (hdev)->dev_flags)
 541#define hci_dev_change_flag(hdev, nr)          change_bit((nr), (hdev)->dev_flags)
 542#define hci_dev_test_flag(hdev, nr)            test_bit((nr), (hdev)->dev_flags)
 543#define hci_dev_test_and_set_flag(hdev, nr)    test_and_set_bit((nr), (hdev)->dev_flags)
 544#define hci_dev_test_and_clear_flag(hdev, nr)  test_and_clear_bit((nr), (hdev)->dev_flags)
 545#define hci_dev_test_and_change_flag(hdev, nr) test_and_change_bit((nr), (hdev)->dev_flags)
 546
 547#define hci_dev_clear_volatile_flags(hdev)			\
 548	do {							\
 549		hci_dev_clear_flag(hdev, HCI_LE_SCAN);		\
 550		hci_dev_clear_flag(hdev, HCI_LE_ADV);		\
 551		hci_dev_clear_flag(hdev, HCI_PERIODIC_INQ);	\
 552	} while (0)
 553
 554/* ----- HCI interface to upper protocols ----- */
 555int l2cap_connect_ind(struct hci_dev *hdev, bdaddr_t *bdaddr);
 
 556int l2cap_disconn_ind(struct hci_conn *hcon);
 557void l2cap_recv_acldata(struct hci_conn *hcon, struct sk_buff *skb, u16 flags);
 
 
 558
 559#if IS_ENABLED(CONFIG_BT_BREDR)
 560int sco_connect_ind(struct hci_dev *hdev, bdaddr_t *bdaddr, __u8 *flags);
 561void sco_recv_scodata(struct hci_conn *hcon, struct sk_buff *skb);
 562#else
 563static inline int sco_connect_ind(struct hci_dev *hdev, bdaddr_t *bdaddr,
 564				  __u8 *flags)
 565{
 566	return 0;
 567}
 568
 569static inline void sco_recv_scodata(struct hci_conn *hcon, struct sk_buff *skb)
 570{
 571}
 572#endif
 573
 574/* ----- Inquiry cache ----- */
 575#define INQUIRY_CACHE_AGE_MAX   (HZ*30)   /* 30 seconds */
 576#define INQUIRY_ENTRY_AGE_MAX   (HZ*60)   /* 60 seconds */
 577
 578static inline void discovery_init(struct hci_dev *hdev)
 579{
 580	hdev->discovery.state = DISCOVERY_STOPPED;
 581	INIT_LIST_HEAD(&hdev->discovery.all);
 582	INIT_LIST_HEAD(&hdev->discovery.unknown);
 583	INIT_LIST_HEAD(&hdev->discovery.resolve);
 584	hdev->discovery.report_invalid_rssi = true;
 585	hdev->discovery.rssi = HCI_RSSI_INVALID;
 586}
 587
 588static inline void hci_discovery_filter_clear(struct hci_dev *hdev)
 589{
 590	hdev->discovery.result_filtering = false;
 591	hdev->discovery.report_invalid_rssi = true;
 592	hdev->discovery.rssi = HCI_RSSI_INVALID;
 593	hdev->discovery.uuid_count = 0;
 594	kfree(hdev->discovery.uuids);
 595	hdev->discovery.uuids = NULL;
 596	hdev->discovery.scan_start = 0;
 597	hdev->discovery.scan_duration = 0;
 598}
 599
 600bool hci_discovery_active(struct hci_dev *hdev);
 601
 602void hci_discovery_set_state(struct hci_dev *hdev, int state);
 603
 604static inline int inquiry_cache_empty(struct hci_dev *hdev)
 605{
 606	return list_empty(&hdev->discovery.all);
 607}
 608
 609static inline long inquiry_cache_age(struct hci_dev *hdev)
 610{
 611	struct discovery_state *c = &hdev->discovery;
 612	return jiffies - c->timestamp;
 613}
 614
 615static inline long inquiry_entry_age(struct inquiry_entry *e)
 616{
 617	return jiffies - e->timestamp;
 618}
 619
 620struct inquiry_entry *hci_inquiry_cache_lookup(struct hci_dev *hdev,
 621					       bdaddr_t *bdaddr);
 622struct inquiry_entry *hci_inquiry_cache_lookup_unknown(struct hci_dev *hdev,
 623						       bdaddr_t *bdaddr);
 624struct inquiry_entry *hci_inquiry_cache_lookup_resolve(struct hci_dev *hdev,
 625						       bdaddr_t *bdaddr,
 626						       int state);
 627void hci_inquiry_cache_update_resolve(struct hci_dev *hdev,
 628				      struct inquiry_entry *ie);
 629u32 hci_inquiry_cache_update(struct hci_dev *hdev, struct inquiry_data *data,
 630			     bool name_known);
 631void hci_inquiry_cache_flush(struct hci_dev *hdev);
 632
 633/* ----- HCI Connections ----- */
 634enum {
 635	HCI_CONN_AUTH_PEND,
 636	HCI_CONN_REAUTH_PEND,
 637	HCI_CONN_ENCRYPT_PEND,
 638	HCI_CONN_RSWITCH_PEND,
 639	HCI_CONN_MODE_CHANGE_PEND,
 640	HCI_CONN_SCO_SETUP_PEND,
 
 641	HCI_CONN_MGMT_CONNECTED,
 642	HCI_CONN_SSP_ENABLED,
 643	HCI_CONN_SC_ENABLED,
 644	HCI_CONN_AES_CCM,
 645	HCI_CONN_POWER_SAVE,
 646	HCI_CONN_FLUSH_KEY,
 647	HCI_CONN_ENCRYPT,
 648	HCI_CONN_AUTH,
 649	HCI_CONN_SECURE,
 650	HCI_CONN_FIPS,
 651	HCI_CONN_STK_ENCRYPT,
 652	HCI_CONN_AUTH_INITIATOR,
 653	HCI_CONN_DROP,
 654	HCI_CONN_PARAM_REMOVAL_PEND,
 655	HCI_CONN_NEW_LINK_KEY,
 656	HCI_CONN_SCANNING,
 657};
 658
 659static inline bool hci_conn_ssp_enabled(struct hci_conn *conn)
 660{
 661	struct hci_dev *hdev = conn->hdev;
 662	return hci_dev_test_flag(hdev, HCI_SSP_ENABLED) &&
 663	       test_bit(HCI_CONN_SSP_ENABLED, &conn->flags);
 664}
 665
 666static inline bool hci_conn_sc_enabled(struct hci_conn *conn)
 667{
 668	struct hci_dev *hdev = conn->hdev;
 669	return hci_dev_test_flag(hdev, HCI_SC_ENABLED) &&
 670	       test_bit(HCI_CONN_SC_ENABLED, &conn->flags);
 671}
 672
 673static inline void hci_conn_hash_add(struct hci_dev *hdev, struct hci_conn *c)
 674{
 675	struct hci_conn_hash *h = &hdev->conn_hash;
 676	list_add_rcu(&c->list, &h->list);
 677	switch (c->type) {
 678	case ACL_LINK:
 679		h->acl_num++;
 680		break;
 681	case AMP_LINK:
 682		h->amp_num++;
 683		break;
 684	case LE_LINK:
 685		h->le_num++;
 686		if (c->role == HCI_ROLE_SLAVE)
 687			h->le_num_slave++;
 688		break;
 689	case SCO_LINK:
 690	case ESCO_LINK:
 691		h->sco_num++;
 692		break;
 693	}
 694}
 695
 696static inline void hci_conn_hash_del(struct hci_dev *hdev, struct hci_conn *c)
 697{
 698	struct hci_conn_hash *h = &hdev->conn_hash;
 699
 700	list_del_rcu(&c->list);
 701	synchronize_rcu();
 702
 703	switch (c->type) {
 704	case ACL_LINK:
 705		h->acl_num--;
 706		break;
 707	case AMP_LINK:
 708		h->amp_num--;
 709		break;
 710	case LE_LINK:
 711		h->le_num--;
 712		if (c->role == HCI_ROLE_SLAVE)
 713			h->le_num_slave--;
 714		break;
 715	case SCO_LINK:
 716	case ESCO_LINK:
 717		h->sco_num--;
 718		break;
 719	}
 720}
 721
 722static inline unsigned int hci_conn_num(struct hci_dev *hdev, __u8 type)
 723{
 724	struct hci_conn_hash *h = &hdev->conn_hash;
 725	switch (type) {
 726	case ACL_LINK:
 727		return h->acl_num;
 728	case AMP_LINK:
 729		return h->amp_num;
 730	case LE_LINK:
 731		return h->le_num;
 732	case SCO_LINK:
 733	case ESCO_LINK:
 734		return h->sco_num;
 735	default:
 736		return 0;
 737	}
 738}
 739
 740static inline unsigned int hci_conn_count(struct hci_dev *hdev)
 741{
 742	struct hci_conn_hash *c = &hdev->conn_hash;
 743
 744	return c->acl_num + c->amp_num + c->sco_num + c->le_num;
 745}
 746
 747static inline __u8 hci_conn_lookup_type(struct hci_dev *hdev, __u16 handle)
 748{
 749	struct hci_conn_hash *h = &hdev->conn_hash;
 750	struct hci_conn *c;
 751	__u8 type = INVALID_LINK;
 752
 753	rcu_read_lock();
 754
 755	list_for_each_entry_rcu(c, &h->list, list) {
 756		if (c->handle == handle) {
 757			type = c->type;
 758			break;
 759		}
 760	}
 761
 762	rcu_read_unlock();
 763
 764	return type;
 765}
 766
 767static inline struct hci_conn *hci_conn_hash_lookup_handle(struct hci_dev *hdev,
 768								__u16 handle)
 769{
 770	struct hci_conn_hash *h = &hdev->conn_hash;
 771	struct hci_conn  *c;
 772
 773	rcu_read_lock();
 774
 775	list_for_each_entry_rcu(c, &h->list, list) {
 776		if (c->handle == handle) {
 777			rcu_read_unlock();
 778			return c;
 779		}
 780	}
 781	rcu_read_unlock();
 782
 783	return NULL;
 784}
 785
 786static inline struct hci_conn *hci_conn_hash_lookup_ba(struct hci_dev *hdev,
 787							__u8 type, bdaddr_t *ba)
 788{
 789	struct hci_conn_hash *h = &hdev->conn_hash;
 790	struct hci_conn  *c;
 791
 792	rcu_read_lock();
 793
 794	list_for_each_entry_rcu(c, &h->list, list) {
 795		if (c->type == type && !bacmp(&c->dst, ba)) {
 796			rcu_read_unlock();
 797			return c;
 798		}
 799	}
 800
 801	rcu_read_unlock();
 802
 803	return NULL;
 804}
 805
 806static inline struct hci_conn *hci_conn_hash_lookup_le(struct hci_dev *hdev,
 807						       bdaddr_t *ba,
 808						       __u8 ba_type)
 809{
 810	struct hci_conn_hash *h = &hdev->conn_hash;
 811	struct hci_conn  *c;
 812
 813	rcu_read_lock();
 814
 815	list_for_each_entry_rcu(c, &h->list, list) {
 816		if (c->type != LE_LINK)
 817		       continue;
 818
 819		if (ba_type == c->dst_type && !bacmp(&c->dst, ba)) {
 820			rcu_read_unlock();
 821			return c;
 822		}
 823	}
 824
 825	rcu_read_unlock();
 826
 827	return NULL;
 828}
 829
 830static inline struct hci_conn *hci_conn_hash_lookup_state(struct hci_dev *hdev,
 831							__u8 type, __u16 state)
 832{
 833	struct hci_conn_hash *h = &hdev->conn_hash;
 834	struct hci_conn  *c;
 835
 836	rcu_read_lock();
 837
 838	list_for_each_entry_rcu(c, &h->list, list) {
 839		if (c->type == type && c->state == state) {
 840			rcu_read_unlock();
 841			return c;
 842		}
 843	}
 844
 845	rcu_read_unlock();
 846
 847	return NULL;
 848}
 849
 850static inline struct hci_conn *hci_lookup_le_connect(struct hci_dev *hdev)
 851{
 852	struct hci_conn_hash *h = &hdev->conn_hash;
 853	struct hci_conn  *c;
 854
 855	rcu_read_lock();
 856
 857	list_for_each_entry_rcu(c, &h->list, list) {
 858		if (c->type == LE_LINK && c->state == BT_CONNECT &&
 859		    !test_bit(HCI_CONN_SCANNING, &c->flags)) {
 860			rcu_read_unlock();
 861			return c;
 862		}
 863	}
 864
 865	rcu_read_unlock();
 866
 867	return NULL;
 868}
 869
 870int hci_disconnect(struct hci_conn *conn, __u8 reason);
 871bool hci_setup_sync(struct hci_conn *conn, __u16 handle);
 872void hci_sco_setup(struct hci_conn *conn, __u8 status);
 873
 874struct hci_conn *hci_conn_add(struct hci_dev *hdev, int type, bdaddr_t *dst,
 875			      u8 role);
 876int hci_conn_del(struct hci_conn *conn);
 877void hci_conn_hash_flush(struct hci_dev *hdev);
 878void hci_conn_check_pending(struct hci_dev *hdev);
 879
 880struct hci_chan *hci_chan_create(struct hci_conn *conn);
 881void hci_chan_del(struct hci_chan *chan);
 882void hci_chan_list_flush(struct hci_conn *conn);
 883struct hci_chan *hci_chan_lookup_handle(struct hci_dev *hdev, __u16 handle);
 884
 885struct hci_conn *hci_connect_le_scan(struct hci_dev *hdev, bdaddr_t *dst,
 886				     u8 dst_type, u8 sec_level,
 887				     u16 conn_timeout);
 888struct hci_conn *hci_connect_le(struct hci_dev *hdev, bdaddr_t *dst,
 889				u8 dst_type, u8 sec_level, u16 conn_timeout,
 890				u8 role);
 891struct hci_conn *hci_connect_acl(struct hci_dev *hdev, bdaddr_t *dst,
 892				 u8 sec_level, u8 auth_type);
 893struct hci_conn *hci_connect_sco(struct hci_dev *hdev, int type, bdaddr_t *dst,
 894				 __u16 setting);
 895int hci_conn_check_link_mode(struct hci_conn *conn);
 896int hci_conn_check_secure(struct hci_conn *conn, __u8 sec_level);
 897int hci_conn_security(struct hci_conn *conn, __u8 sec_level, __u8 auth_type,
 898		      bool initiator);
 899int hci_conn_switch_role(struct hci_conn *conn, __u8 role);
 900
 901void hci_conn_enter_active_mode(struct hci_conn *conn, __u8 force_active);
 902
 903void hci_le_conn_failed(struct hci_conn *conn, u8 status);
 904
 905/*
 906 * hci_conn_get() and hci_conn_put() are used to control the life-time of an
 907 * "hci_conn" object. They do not guarantee that the hci_conn object is running,
 908 * working or anything else. They just guarantee that the object is available
 909 * and can be dereferenced. So you can use its locks, local variables and any
 910 * other constant data.
 911 * Before accessing runtime data, you _must_ lock the object and then check that
 912 * it is still running. As soon as you release the locks, the connection might
 913 * get dropped, though.
 914 *
 915 * On the other hand, hci_conn_hold() and hci_conn_drop() are used to control
 916 * how long the underlying connection is held. So every channel that runs on the
 917 * hci_conn object calls this to prevent the connection from disappearing. As
 918 * long as you hold a device, you must also guarantee that you have a valid
 919 * reference to the device via hci_conn_get() (or the initial reference from
 920 * hci_conn_add()).
 921 * The hold()/drop() ref-count is known to drop below 0 sometimes, which doesn't
 922 * break because nobody cares for that. But this means, we cannot use
 923 * _get()/_drop() in it, but require the caller to have a valid ref (FIXME).
 924 */
 925
 926static inline struct hci_conn *hci_conn_get(struct hci_conn *conn)
 927{
 928	get_device(&conn->dev);
 929	return conn;
 930}
 931
 932static inline void hci_conn_put(struct hci_conn *conn)
 933{
 934	put_device(&conn->dev);
 935}
 936
 937static inline void hci_conn_hold(struct hci_conn *conn)
 938{
 939	BT_DBG("hcon %p orig refcnt %d", conn, atomic_read(&conn->refcnt));
 940
 941	atomic_inc(&conn->refcnt);
 942	cancel_delayed_work(&conn->disc_work);
 943}
 944
 945static inline void hci_conn_drop(struct hci_conn *conn)
 946{
 947	BT_DBG("hcon %p orig refcnt %d", conn, atomic_read(&conn->refcnt));
 948
 949	if (atomic_dec_and_test(&conn->refcnt)) {
 950		unsigned long timeo;
 951
 952		switch (conn->type) {
 953		case ACL_LINK:
 954		case LE_LINK:
 955			cancel_delayed_work(&conn->idle_work);
 956			if (conn->state == BT_CONNECTED) {
 957				timeo = conn->disc_timeout;
 958				if (!conn->out)
 959					timeo *= 2;
 960			} else {
 961				timeo = 0;
 962			}
 963			break;
 964
 965		case AMP_LINK:
 966			timeo = conn->disc_timeout;
 967			break;
 968
 969		default:
 970			timeo = 0;
 971			break;
 972		}
 973
 974		cancel_delayed_work(&conn->disc_work);
 975		queue_delayed_work(conn->hdev->workqueue,
 976				   &conn->disc_work, timeo);
 977	}
 978}
 979
 980/* ----- HCI Devices ----- */
 981static inline void hci_dev_put(struct hci_dev *d)
 982{
 983	BT_DBG("%s orig refcnt %d", d->name,
 984	       atomic_read(&d->dev.kobj.kref.refcount));
 985
 986	put_device(&d->dev);
 987}
 988
 989static inline struct hci_dev *hci_dev_hold(struct hci_dev *d)
 990{
 991	BT_DBG("%s orig refcnt %d", d->name,
 992	       atomic_read(&d->dev.kobj.kref.refcount));
 993
 994	get_device(&d->dev);
 995	return d;
 996}
 997
 998#define hci_dev_lock(d)		mutex_lock(&d->lock)
 999#define hci_dev_unlock(d)	mutex_unlock(&d->lock)
1000
1001#define to_hci_dev(d) container_of(d, struct hci_dev, dev)
1002#define to_hci_conn(c) container_of(c, struct hci_conn, dev)
1003
1004static inline void *hci_get_drvdata(struct hci_dev *hdev)
1005{
1006	return dev_get_drvdata(&hdev->dev);
1007}
1008
1009static inline void hci_set_drvdata(struct hci_dev *hdev, void *data)
1010{
1011	dev_set_drvdata(&hdev->dev, data);
1012}
1013
1014struct hci_dev *hci_dev_get(int index);
1015struct hci_dev *hci_get_route(bdaddr_t *dst, bdaddr_t *src);
1016
1017struct hci_dev *hci_alloc_dev(void);
1018void hci_free_dev(struct hci_dev *hdev);
1019int hci_register_dev(struct hci_dev *hdev);
1020void hci_unregister_dev(struct hci_dev *hdev);
1021int hci_suspend_dev(struct hci_dev *hdev);
1022int hci_resume_dev(struct hci_dev *hdev);
1023int hci_reset_dev(struct hci_dev *hdev);
1024int hci_dev_open(__u16 dev);
1025int hci_dev_close(__u16 dev);
1026int hci_dev_do_close(struct hci_dev *hdev);
1027int hci_dev_reset(__u16 dev);
1028int hci_dev_reset_stat(__u16 dev);
1029int hci_dev_cmd(unsigned int cmd, void __user *arg);
1030int hci_get_dev_list(void __user *arg);
1031int hci_get_dev_info(void __user *arg);
1032int hci_get_conn_list(void __user *arg);
1033int hci_get_conn_info(struct hci_dev *hdev, void __user *arg);
1034int hci_get_auth_info(struct hci_dev *hdev, void __user *arg);
1035int hci_inquiry(void __user *arg);
1036
1037struct bdaddr_list *hci_bdaddr_list_lookup(struct list_head *list,
1038					   bdaddr_t *bdaddr, u8 type);
1039int hci_bdaddr_list_add(struct list_head *list, bdaddr_t *bdaddr, u8 type);
1040int hci_bdaddr_list_del(struct list_head *list, bdaddr_t *bdaddr, u8 type);
1041void hci_bdaddr_list_clear(struct list_head *list);
 
 
 
 
 
1042
1043struct hci_conn_params *hci_conn_params_lookup(struct hci_dev *hdev,
1044					       bdaddr_t *addr, u8 addr_type);
1045struct hci_conn_params *hci_conn_params_add(struct hci_dev *hdev,
1046					    bdaddr_t *addr, u8 addr_type);
 
1047void hci_conn_params_del(struct hci_dev *hdev, bdaddr_t *addr, u8 addr_type);
1048void hci_conn_params_clear_disabled(struct hci_dev *hdev);
 
 
 
 
 
 
1049
1050struct hci_conn_params *hci_pend_le_action_lookup(struct list_head *list,
1051						  bdaddr_t *addr,
1052						  u8 addr_type);
1053
1054void hci_uuids_clear(struct hci_dev *hdev);
1055
1056void hci_link_keys_clear(struct hci_dev *hdev);
1057struct link_key *hci_find_link_key(struct hci_dev *hdev, bdaddr_t *bdaddr);
1058struct link_key *hci_add_link_key(struct hci_dev *hdev, struct hci_conn *conn,
1059				  bdaddr_t *bdaddr, u8 *val, u8 type,
1060				  u8 pin_len, bool *persistent);
 
1061struct smp_ltk *hci_add_ltk(struct hci_dev *hdev, bdaddr_t *bdaddr,
1062			    u8 addr_type, u8 type, u8 authenticated,
1063			    u8 tk[16], u8 enc_size, __le16 ediv, __le64 rand);
1064struct smp_ltk *hci_find_ltk(struct hci_dev *hdev, bdaddr_t *bdaddr,
1065			     u8 addr_type, u8 role);
1066int hci_remove_ltk(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 bdaddr_type);
1067void hci_smp_ltks_clear(struct hci_dev *hdev);
1068int hci_remove_link_key(struct hci_dev *hdev, bdaddr_t *bdaddr);
1069
1070struct smp_irk *hci_find_irk_by_rpa(struct hci_dev *hdev, bdaddr_t *rpa);
1071struct smp_irk *hci_find_irk_by_addr(struct hci_dev *hdev, bdaddr_t *bdaddr,
1072				     u8 addr_type);
1073struct smp_irk *hci_add_irk(struct hci_dev *hdev, bdaddr_t *bdaddr,
1074			    u8 addr_type, u8 val[16], bdaddr_t *rpa);
1075void hci_remove_irk(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 addr_type);
1076void hci_smp_irks_clear(struct hci_dev *hdev);
1077
1078bool hci_bdaddr_is_paired(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 type);
1079
1080void hci_remote_oob_data_clear(struct hci_dev *hdev);
1081struct oob_data *hci_find_remote_oob_data(struct hci_dev *hdev,
1082					  bdaddr_t *bdaddr, u8 bdaddr_type);
1083int hci_add_remote_oob_data(struct hci_dev *hdev, bdaddr_t *bdaddr,
1084			    u8 bdaddr_type, u8 *hash192, u8 *rand192,
1085			    u8 *hash256, u8 *rand256);
1086int hci_remove_remote_oob_data(struct hci_dev *hdev, bdaddr_t *bdaddr,
1087			       u8 bdaddr_type);
1088
1089void hci_adv_instances_clear(struct hci_dev *hdev);
1090struct adv_info *hci_find_adv_instance(struct hci_dev *hdev, u8 instance);
1091struct adv_info *hci_get_next_instance(struct hci_dev *hdev, u8 instance);
1092int hci_add_adv_instance(struct hci_dev *hdev, u8 instance, u32 flags,
1093			 u16 adv_data_len, u8 *adv_data,
1094			 u16 scan_rsp_len, u8 *scan_rsp_data,
1095			 u16 timeout, u16 duration);
1096int hci_remove_adv_instance(struct hci_dev *hdev, u8 instance);
1097
1098void hci_event_packet(struct hci_dev *hdev, struct sk_buff *skb);
1099
1100int hci_recv_frame(struct hci_dev *hdev, struct sk_buff *skb);
1101int hci_recv_diag(struct hci_dev *hdev, struct sk_buff *skb);
 
1102
1103void hci_init_sysfs(struct hci_dev *hdev);
1104void hci_conn_init_sysfs(struct hci_conn *conn);
1105void hci_conn_add_sysfs(struct hci_conn *conn);
1106void hci_conn_del_sysfs(struct hci_conn *conn);
1107
1108#define SET_HCIDEV_DEV(hdev, pdev) ((hdev)->dev.parent = (pdev))
1109
1110/* ----- LMP capabilities ----- */
1111#define lmp_encrypt_capable(dev)   ((dev)->features[0][0] & LMP_ENCRYPT)
1112#define lmp_rswitch_capable(dev)   ((dev)->features[0][0] & LMP_RSWITCH)
1113#define lmp_hold_capable(dev)      ((dev)->features[0][0] & LMP_HOLD)
1114#define lmp_sniff_capable(dev)     ((dev)->features[0][0] & LMP_SNIFF)
1115#define lmp_park_capable(dev)      ((dev)->features[0][1] & LMP_PARK)
1116#define lmp_inq_rssi_capable(dev)  ((dev)->features[0][3] & LMP_RSSI_INQ)
1117#define lmp_esco_capable(dev)      ((dev)->features[0][3] & LMP_ESCO)
1118#define lmp_bredr_capable(dev)     (!((dev)->features[0][4] & LMP_NO_BREDR))
1119#define lmp_le_capable(dev)        ((dev)->features[0][4] & LMP_LE)
1120#define lmp_sniffsubr_capable(dev) ((dev)->features[0][5] & LMP_SNIFF_SUBR)
1121#define lmp_pause_enc_capable(dev) ((dev)->features[0][5] & LMP_PAUSE_ENC)
1122#define lmp_ext_inq_capable(dev)   ((dev)->features[0][6] & LMP_EXT_INQ)
1123#define lmp_le_br_capable(dev)     (!!((dev)->features[0][6] & LMP_SIMUL_LE_BR))
1124#define lmp_ssp_capable(dev)       ((dev)->features[0][6] & LMP_SIMPLE_PAIR)
1125#define lmp_no_flush_capable(dev)  ((dev)->features[0][6] & LMP_NO_FLUSH)
1126#define lmp_lsto_capable(dev)      ((dev)->features[0][7] & LMP_LSTO)
1127#define lmp_inq_tx_pwr_capable(dev) ((dev)->features[0][7] & LMP_INQ_TX_PWR)
1128#define lmp_ext_feat_capable(dev)  ((dev)->features[0][7] & LMP_EXTFEATURES)
1129#define lmp_transp_capable(dev)    ((dev)->features[0][2] & LMP_TRANSPARENT)
1130
1131/* ----- Extended LMP capabilities ----- */
1132#define lmp_csb_master_capable(dev) ((dev)->features[2][0] & LMP_CSB_MASTER)
1133#define lmp_csb_slave_capable(dev)  ((dev)->features[2][0] & LMP_CSB_SLAVE)
1134#define lmp_sync_train_capable(dev) ((dev)->features[2][0] & LMP_SYNC_TRAIN)
1135#define lmp_sync_scan_capable(dev)  ((dev)->features[2][0] & LMP_SYNC_SCAN)
1136#define lmp_sc_capable(dev)         ((dev)->features[2][1] & LMP_SC)
1137#define lmp_ping_capable(dev)       ((dev)->features[2][1] & LMP_PING)
1138
1139/* ----- Host capabilities ----- */
1140#define lmp_host_ssp_capable(dev)  ((dev)->features[1][0] & LMP_HOST_SSP)
1141#define lmp_host_sc_capable(dev)   ((dev)->features[1][0] & LMP_HOST_SC)
1142#define lmp_host_le_capable(dev)   (!!((dev)->features[1][0] & LMP_HOST_LE))
1143#define lmp_host_le_br_capable(dev) (!!((dev)->features[1][0] & LMP_HOST_LE_BREDR))
1144
1145#define hdev_is_powered(dev)   (test_bit(HCI_UP, &(dev)->flags) && \
1146				!hci_dev_test_flag(dev, HCI_AUTO_OFF))
1147#define bredr_sc_enabled(dev)  (lmp_sc_capable(dev) && \
1148				hci_dev_test_flag(dev, HCI_SC_ENABLED))
1149
1150/* ----- HCI protocols ----- */
1151#define HCI_PROTO_DEFER             0x01
1152
1153static inline int hci_proto_connect_ind(struct hci_dev *hdev, bdaddr_t *bdaddr,
1154					__u8 type, __u8 *flags)
1155{
1156	switch (type) {
1157	case ACL_LINK:
1158		return l2cap_connect_ind(hdev, bdaddr);
1159
1160	case SCO_LINK:
1161	case ESCO_LINK:
1162		return sco_connect_ind(hdev, bdaddr, flags);
1163
1164	default:
1165		BT_ERR("unknown link type %d", type);
1166		return -EINVAL;
1167	}
1168}
1169
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1170static inline int hci_proto_disconn_ind(struct hci_conn *conn)
1171{
1172	if (conn->type != ACL_LINK && conn->type != LE_LINK)
1173		return HCI_ERROR_REMOTE_USER_TERM;
1174
1175	return l2cap_disconn_ind(conn);
1176}
1177
1178/* ----- HCI callbacks ----- */
1179struct hci_cb {
1180	struct list_head list;
 
 
 
 
1181
1182	char *name;
 
 
 
1183
1184	void (*connect_cfm)	(struct hci_conn *conn, __u8 status);
1185	void (*disconn_cfm)	(struct hci_conn *conn, __u8 status);
1186	void (*security_cfm)	(struct hci_conn *conn, __u8 status,
1187								__u8 encrypt);
1188	void (*key_change_cfm)	(struct hci_conn *conn, __u8 status);
1189	void (*role_switch_cfm)	(struct hci_conn *conn, __u8 status, __u8 role);
1190};
1191
1192static inline void hci_connect_cfm(struct hci_conn *conn, __u8 status)
 
 
 
 
 
 
 
 
 
1193{
1194	struct hci_cb *cb;
1195
1196	mutex_lock(&hci_cb_list_lock);
1197	list_for_each_entry(cb, &hci_cb_list, list) {
1198		if (cb->connect_cfm)
1199			cb->connect_cfm(conn, status);
1200	}
1201	mutex_unlock(&hci_cb_list_lock);
1202
1203	if (conn->connect_cfm_cb)
1204		conn->connect_cfm_cb(conn, status);
 
 
 
 
 
 
1205}
1206
1207static inline void hci_disconn_cfm(struct hci_conn *conn, __u8 reason)
 
1208{
1209	struct hci_cb *cb;
 
1210
1211	mutex_lock(&hci_cb_list_lock);
1212	list_for_each_entry(cb, &hci_cb_list, list) {
1213		if (cb->disconn_cfm)
1214			cb->disconn_cfm(conn, reason);
1215	}
1216	mutex_unlock(&hci_cb_list_lock);
1217
1218	if (conn->disconn_cfm_cb)
1219		conn->disconn_cfm_cb(conn, reason);
1220}
1221
 
 
 
 
 
 
 
 
 
 
 
 
1222static inline void hci_auth_cfm(struct hci_conn *conn, __u8 status)
1223{
1224	struct hci_cb *cb;
1225	__u8 encrypt;
1226
 
 
1227	if (test_bit(HCI_CONN_ENCRYPT_PEND, &conn->flags))
1228		return;
1229
1230	encrypt = test_bit(HCI_CONN_ENCRYPT, &conn->flags) ? 0x01 : 0x00;
1231
1232	mutex_lock(&hci_cb_list_lock);
1233	list_for_each_entry(cb, &hci_cb_list, list) {
1234		if (cb->security_cfm)
1235			cb->security_cfm(conn, status, encrypt);
1236	}
1237	mutex_unlock(&hci_cb_list_lock);
1238
1239	if (conn->security_cfm_cb)
1240		conn->security_cfm_cb(conn, status);
1241}
1242
1243static inline void hci_encrypt_cfm(struct hci_conn *conn, __u8 status,
1244								__u8 encrypt)
1245{
1246	struct hci_cb *cb;
1247
1248	if (conn->sec_level == BT_SECURITY_SDP)
1249		conn->sec_level = BT_SECURITY_LOW;
1250
1251	if (conn->pending_sec_level > conn->sec_level)
1252		conn->sec_level = conn->pending_sec_level;
1253
1254	mutex_lock(&hci_cb_list_lock);
 
 
1255	list_for_each_entry(cb, &hci_cb_list, list) {
1256		if (cb->security_cfm)
1257			cb->security_cfm(conn, status, encrypt);
1258	}
1259	mutex_unlock(&hci_cb_list_lock);
1260
1261	if (conn->security_cfm_cb)
1262		conn->security_cfm_cb(conn, status);
1263}
1264
1265static inline void hci_key_change_cfm(struct hci_conn *conn, __u8 status)
1266{
1267	struct hci_cb *cb;
1268
1269	mutex_lock(&hci_cb_list_lock);
1270	list_for_each_entry(cb, &hci_cb_list, list) {
1271		if (cb->key_change_cfm)
1272			cb->key_change_cfm(conn, status);
1273	}
1274	mutex_unlock(&hci_cb_list_lock);
1275}
1276
1277static inline void hci_role_switch_cfm(struct hci_conn *conn, __u8 status,
1278								__u8 role)
1279{
1280	struct hci_cb *cb;
1281
1282	mutex_lock(&hci_cb_list_lock);
1283	list_for_each_entry(cb, &hci_cb_list, list) {
1284		if (cb->role_switch_cfm)
1285			cb->role_switch_cfm(conn, status, role);
1286	}
1287	mutex_unlock(&hci_cb_list_lock);
1288}
1289
1290static inline void *eir_get_data(u8 *eir, size_t eir_len, u8 type,
1291				 size_t *data_len)
1292{
1293	size_t parsed = 0;
1294
1295	if (eir_len < 2)
1296		return NULL;
1297
1298	while (parsed < eir_len - 1) {
1299		u8 field_len = eir[0];
1300
1301		if (field_len == 0)
1302			break;
1303
1304		parsed += field_len + 1;
1305
1306		if (parsed > eir_len)
1307			break;
1308
1309		if (eir[1] != type) {
1310			eir += field_len + 1;
1311			continue;
1312		}
1313
1314		/* Zero length data */
1315		if (field_len == 1)
1316			return NULL;
1317
1318		if (data_len)
1319			*data_len = field_len - 1;
1320
1321		return &eir[2];
1322	}
1323
1324	return NULL;
1325}
1326
1327static inline bool hci_bdaddr_is_rpa(bdaddr_t *bdaddr, u8 addr_type)
1328{
1329	if (addr_type != ADDR_LE_DEV_RANDOM)
1330		return false;
1331
1332	if ((bdaddr->b[5] & 0xc0) == 0x40)
1333	       return true;
1334
1335	return false;
1336}
1337
1338static inline bool hci_is_identity_address(bdaddr_t *addr, u8 addr_type)
1339{
1340	if (addr_type == ADDR_LE_DEV_PUBLIC)
1341		return true;
1342
1343	/* Check for Random Static address type */
1344	if ((addr->b[5] & 0xc0) == 0xc0)
1345		return true;
1346
1347	return false;
1348}
1349
1350static inline struct smp_irk *hci_get_irk(struct hci_dev *hdev,
1351					  bdaddr_t *bdaddr, u8 addr_type)
1352{
1353	if (!hci_bdaddr_is_rpa(bdaddr, addr_type))
1354		return NULL;
1355
1356	return hci_find_irk_by_rpa(hdev, bdaddr);
1357}
1358
1359static inline int hci_check_conn_params(u16 min, u16 max, u16 latency,
1360					u16 to_multiplier)
1361{
1362	u16 max_latency;
1363
1364	if (min > max || min < 6 || max > 3200)
1365		return -EINVAL;
1366
1367	if (to_multiplier < 10 || to_multiplier > 3200)
1368		return -EINVAL;
1369
1370	if (max >= to_multiplier * 8)
1371		return -EINVAL;
 
1372
1373	max_latency = (to_multiplier * 4 / max) - 1;
1374	if (latency > 499 || latency > max_latency)
1375		return -EINVAL;
 
 
1376
1377	return 0;
1378}
 
 
 
 
 
1379
1380int hci_register_cb(struct hci_cb *hcb);
1381int hci_unregister_cb(struct hci_cb *hcb);
1382
1383struct sk_buff *__hci_cmd_sync(struct hci_dev *hdev, u16 opcode, u32 plen,
1384			       const void *param, u32 timeout);
1385struct sk_buff *__hci_cmd_sync_ev(struct hci_dev *hdev, u16 opcode, u32 plen,
1386				  const void *param, u8 event, u32 timeout);
1387
1388int hci_send_cmd(struct hci_dev *hdev, __u16 opcode, __u32 plen,
1389		 const void *param);
1390void hci_send_acl(struct hci_chan *chan, struct sk_buff *skb, __u16 flags);
1391void hci_send_sco(struct hci_conn *conn, struct sk_buff *skb);
1392
1393void *hci_sent_cmd_data(struct hci_dev *hdev, __u16 opcode);
1394
1395struct sk_buff *hci_cmd_sync(struct hci_dev *hdev, u16 opcode, u32 plen,
1396			     const void *param, u32 timeout);
1397
1398/* ----- HCI Sockets ----- */
1399void hci_send_to_sock(struct hci_dev *hdev, struct sk_buff *skb);
1400void hci_send_to_channel(unsigned short channel, struct sk_buff *skb,
1401			 int flag, struct sock *skip_sk);
1402void hci_send_to_monitor(struct hci_dev *hdev, struct sk_buff *skb);
1403
1404void hci_sock_dev_event(struct hci_dev *hdev, int event);
1405
1406#define HCI_MGMT_VAR_LEN	BIT(0)
1407#define HCI_MGMT_NO_HDEV	BIT(1)
1408#define HCI_MGMT_UNTRUSTED	BIT(2)
1409#define HCI_MGMT_UNCONFIGURED	BIT(3)
1410
1411struct hci_mgmt_handler {
1412	int (*func) (struct sock *sk, struct hci_dev *hdev, void *data,
1413		     u16 data_len);
1414	size_t data_len;
1415	unsigned long flags;
1416};
1417
1418struct hci_mgmt_chan {
1419	struct list_head list;
1420	unsigned short channel;
1421	size_t handler_count;
1422	const struct hci_mgmt_handler *handlers;
1423	void (*hdev_init) (struct sock *sk, struct hci_dev *hdev);
1424};
1425
1426int hci_mgmt_chan_register(struct hci_mgmt_chan *c);
1427void hci_mgmt_chan_unregister(struct hci_mgmt_chan *c);
1428
1429/* Management interface */
1430#define DISCOV_TYPE_BREDR		(BIT(BDADDR_BREDR))
1431#define DISCOV_TYPE_LE			(BIT(BDADDR_LE_PUBLIC) | \
1432					 BIT(BDADDR_LE_RANDOM))
1433#define DISCOV_TYPE_INTERLEAVED		(BIT(BDADDR_BREDR) | \
1434					 BIT(BDADDR_LE_PUBLIC) | \
1435					 BIT(BDADDR_LE_RANDOM))
1436
1437/* These LE scan and inquiry parameters were chosen according to LE General
1438 * Discovery Procedure specification.
1439 */
1440#define DISCOV_LE_SCAN_WIN		0x12
1441#define DISCOV_LE_SCAN_INT		0x12
1442#define DISCOV_LE_TIMEOUT		10240	/* msec */
1443#define DISCOV_INTERLEAVED_TIMEOUT	5120	/* msec */
1444#define DISCOV_INTERLEAVED_INQUIRY_LEN	0x04
1445#define DISCOV_BREDR_INQUIRY_LEN	0x08
1446#define DISCOV_LE_RESTART_DELAY		msecs_to_jiffies(200)	/* msec */
1447
1448int mgmt_new_settings(struct hci_dev *hdev);
1449void mgmt_index_added(struct hci_dev *hdev);
1450void mgmt_index_removed(struct hci_dev *hdev);
1451void mgmt_set_powered_failed(struct hci_dev *hdev, int err);
1452void mgmt_power_on(struct hci_dev *hdev, int err);
1453void __mgmt_power_off(struct hci_dev *hdev);
 
 
 
 
1454void mgmt_new_link_key(struct hci_dev *hdev, struct link_key *key,
1455		       bool persistent);
1456void mgmt_device_connected(struct hci_dev *hdev, struct hci_conn *conn,
1457			   u32 flags, u8 *name, u8 name_len);
 
1458void mgmt_device_disconnected(struct hci_dev *hdev, bdaddr_t *bdaddr,
1459			      u8 link_type, u8 addr_type, u8 reason,
1460			      bool mgmt_connected);
1461void mgmt_disconnect_failed(struct hci_dev *hdev, bdaddr_t *bdaddr,
1462			    u8 link_type, u8 addr_type, u8 status);
1463void mgmt_connect_failed(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 link_type,
1464			 u8 addr_type, u8 status);
1465void mgmt_pin_code_request(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 secure);
1466void mgmt_pin_code_reply_complete(struct hci_dev *hdev, bdaddr_t *bdaddr,
1467				  u8 status);
1468void mgmt_pin_code_neg_reply_complete(struct hci_dev *hdev, bdaddr_t *bdaddr,
1469				      u8 status);
1470int mgmt_user_confirm_request(struct hci_dev *hdev, bdaddr_t *bdaddr,
1471			      u8 link_type, u8 addr_type, u32 value,
1472			      u8 confirm_hint);
1473int mgmt_user_confirm_reply_complete(struct hci_dev *hdev, bdaddr_t *bdaddr,
1474				     u8 link_type, u8 addr_type, u8 status);
1475int mgmt_user_confirm_neg_reply_complete(struct hci_dev *hdev, bdaddr_t *bdaddr,
1476					 u8 link_type, u8 addr_type, u8 status);
1477int mgmt_user_passkey_request(struct hci_dev *hdev, bdaddr_t *bdaddr,
1478			      u8 link_type, u8 addr_type);
1479int mgmt_user_passkey_reply_complete(struct hci_dev *hdev, bdaddr_t *bdaddr,
1480				     u8 link_type, u8 addr_type, u8 status);
1481int mgmt_user_passkey_neg_reply_complete(struct hci_dev *hdev, bdaddr_t *bdaddr,
1482					 u8 link_type, u8 addr_type, u8 status);
1483int mgmt_user_passkey_notify(struct hci_dev *hdev, bdaddr_t *bdaddr,
1484			     u8 link_type, u8 addr_type, u32 passkey,
1485			     u8 entered);
1486void mgmt_auth_failed(struct hci_conn *conn, u8 status);
 
1487void mgmt_auth_enable_complete(struct hci_dev *hdev, u8 status);
1488void mgmt_ssp_enable_complete(struct hci_dev *hdev, u8 enable, u8 status);
 
1489void mgmt_set_class_of_dev_complete(struct hci_dev *hdev, u8 *dev_class,
1490				    u8 status);
1491void mgmt_set_local_name_complete(struct hci_dev *hdev, u8 *name, u8 status);
1492void mgmt_start_discovery_complete(struct hci_dev *hdev, u8 status);
1493void mgmt_stop_discovery_complete(struct hci_dev *hdev, u8 status);
 
1494void mgmt_device_found(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 link_type,
1495		       u8 addr_type, u8 *dev_class, s8 rssi, u32 flags,
1496		       u8 *eir, u16 eir_len, u8 *scan_rsp, u8 scan_rsp_len);
1497void mgmt_remote_name(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 link_type,
1498		      u8 addr_type, s8 rssi, u8 *name, u8 name_len);
1499void mgmt_discovering(struct hci_dev *hdev, u8 discovering);
1500bool mgmt_powering_down(struct hci_dev *hdev);
 
1501void mgmt_new_ltk(struct hci_dev *hdev, struct smp_ltk *key, bool persistent);
1502void mgmt_new_irk(struct hci_dev *hdev, struct smp_irk *irk, bool persistent);
1503void mgmt_new_csrk(struct hci_dev *hdev, struct smp_csrk *csrk,
1504		   bool persistent);
1505void mgmt_new_conn_param(struct hci_dev *hdev, bdaddr_t *bdaddr,
1506			 u8 bdaddr_type, u8 store_hint, u16 min_interval,
1507			 u16 max_interval, u16 latency, u16 timeout);
1508void mgmt_smp_complete(struct hci_conn *conn, bool complete);
1509bool mgmt_get_connectable(struct hci_dev *hdev);
1510void mgmt_set_connectable_complete(struct hci_dev *hdev, u8 status);
1511void mgmt_set_discoverable_complete(struct hci_dev *hdev, u8 status);
1512u8 mgmt_get_adv_discov_flags(struct hci_dev *hdev);
1513void mgmt_advertising_added(struct sock *sk, struct hci_dev *hdev,
1514			    u8 instance);
1515void mgmt_advertising_removed(struct sock *sk, struct hci_dev *hdev,
1516			      u8 instance);
1517
1518u8 hci_le_conn_update(struct hci_conn *conn, u16 min, u16 max, u16 latency,
1519		      u16 to_multiplier);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1520void hci_le_start_enc(struct hci_conn *conn, __le16 ediv, __le64 rand,
1521		      __u8 ltk[16], __u8 key_size);
1522
 
 
1523void hci_copy_identity_address(struct hci_dev *hdev, bdaddr_t *bdaddr,
1524			       u8 *bdaddr_type);
1525
1526#define SCO_AIRMODE_MASK       0x0003
1527#define SCO_AIRMODE_CVSD       0x0000
1528#define SCO_AIRMODE_TRANSP     0x0003
1529
1530#endif /* __HCI_CORE_H */
v3.15
   1/*
   2   BlueZ - Bluetooth protocol stack for Linux
   3   Copyright (c) 2000-2001, 2010, Code Aurora Forum. All rights reserved.
   4
   5   Written 2000,2001 by Maxim Krasnyansky <maxk@qualcomm.com>
   6
   7   This program is free software; you can redistribute it and/or modify
   8   it under the terms of the GNU General Public License version 2 as
   9   published by the Free Software Foundation;
  10
  11   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
  12   OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  13   FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS.
  14   IN NO EVENT SHALL THE COPYRIGHT HOLDER(S) AND AUTHOR(S) BE LIABLE FOR ANY
  15   CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES
  16   WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  17   ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  18   OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  19
  20   ALL LIABILITY, INCLUDING LIABILITY FOR INFRINGEMENT OF ANY PATENTS,
  21   COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS, RELATING TO USE OF THIS
  22   SOFTWARE IS DISCLAIMED.
  23*/
  24
  25#ifndef __HCI_CORE_H
  26#define __HCI_CORE_H
  27
 
  28#include <net/bluetooth/hci.h>
 
  29
  30/* HCI priority */
  31#define HCI_PRIO_MAX	7
  32
  33/* HCI Core structures */
  34struct inquiry_data {
  35	bdaddr_t	bdaddr;
  36	__u8		pscan_rep_mode;
  37	__u8		pscan_period_mode;
  38	__u8		pscan_mode;
  39	__u8		dev_class[3];
  40	__le16		clock_offset;
  41	__s8		rssi;
  42	__u8		ssp_mode;
  43};
  44
  45struct inquiry_entry {
  46	struct list_head	all;		/* inq_cache.all */
  47	struct list_head	list;		/* unknown or resolve */
  48	enum {
  49		NAME_NOT_KNOWN,
  50		NAME_NEEDED,
  51		NAME_PENDING,
  52		NAME_KNOWN,
  53	} name_state;
  54	__u32			timestamp;
  55	struct inquiry_data	data;
  56};
  57
  58struct discovery_state {
  59	int			type;
  60	enum {
  61		DISCOVERY_STOPPED,
  62		DISCOVERY_STARTING,
  63		DISCOVERY_FINDING,
  64		DISCOVERY_RESOLVING,
  65		DISCOVERY_STOPPING,
  66	} state;
  67	struct list_head	all;	/* All devices found during inquiry */
  68	struct list_head	unknown;	/* Name state not known */
  69	struct list_head	resolve;	/* Name needs to be resolved */
  70	__u32			timestamp;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
  71};
  72
  73struct hci_conn_hash {
  74	struct list_head list;
  75	unsigned int     acl_num;
  76	unsigned int     amp_num;
  77	unsigned int     sco_num;
  78	unsigned int     le_num;
 
  79};
  80
  81struct bdaddr_list {
  82	struct list_head list;
  83	bdaddr_t bdaddr;
  84	u8 bdaddr_type;
  85};
  86
  87struct bt_uuid {
  88	struct list_head list;
  89	u8 uuid[16];
  90	u8 size;
  91	u8 svc_hint;
  92};
  93
  94struct smp_csrk {
  95	bdaddr_t bdaddr;
  96	u8 bdaddr_type;
  97	u8 master;
  98	u8 val[16];
  99};
 100
 101struct smp_ltk {
 102	struct list_head list;
 
 103	bdaddr_t bdaddr;
 104	u8 bdaddr_type;
 105	u8 authenticated;
 106	u8 type;
 107	u8 enc_size;
 108	__le16 ediv;
 109	__le64 rand;
 110	u8 val[16];
 111};
 112
 113struct smp_irk {
 114	struct list_head list;
 
 115	bdaddr_t rpa;
 116	bdaddr_t bdaddr;
 117	u8 addr_type;
 118	u8 val[16];
 119};
 120
 121struct link_key {
 122	struct list_head list;
 
 123	bdaddr_t bdaddr;
 124	u8 type;
 125	u8 val[HCI_LINK_KEY_SIZE];
 126	u8 pin_len;
 127};
 128
 129struct oob_data {
 130	struct list_head list;
 131	bdaddr_t bdaddr;
 
 
 132	u8 hash192[16];
 133	u8 randomizer192[16];
 134	u8 hash256[16];
 135	u8 randomizer256[16];
 136};
 137
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 138#define HCI_MAX_SHORT_NAME_LENGTH	10
 139
 140/* Default LE RPA expiry time, 15 minutes */
 141#define HCI_DEFAULT_RPA_TIMEOUT		(15 * 60)
 142
 
 
 
 
 143struct amp_assoc {
 144	__u16	len;
 145	__u16	offset;
 146	__u16	rem_len;
 147	__u16	len_so_far;
 148	__u8	data[HCI_MAX_AMP_ASSOC_SIZE];
 149};
 150
 151#define HCI_MAX_PAGES	3
 152
 153#define NUM_REASSEMBLY 4
 154struct hci_dev {
 155	struct list_head list;
 156	struct mutex	lock;
 157
 158	char		name[8];
 159	unsigned long	flags;
 160	__u16		id;
 161	__u8		bus;
 162	__u8		dev_type;
 163	bdaddr_t	bdaddr;
 
 
 164	bdaddr_t	random_addr;
 165	bdaddr_t	static_addr;
 166	__u8		adv_addr_type;
 167	__u8		dev_name[HCI_MAX_NAME_LENGTH];
 168	__u8		short_name[HCI_MAX_SHORT_NAME_LENGTH];
 169	__u8		eir[HCI_MAX_EIR_LENGTH];
 170	__u8		dev_class[3];
 171	__u8		major_class;
 172	__u8		minor_class;
 173	__u8		max_page;
 174	__u8		features[HCI_MAX_PAGES][8];
 175	__u8		le_features[8];
 176	__u8		le_white_list_size;
 177	__u8		le_states[8];
 178	__u8		commands[64];
 179	__u8		hci_ver;
 180	__u16		hci_rev;
 181	__u8		lmp_ver;
 182	__u16		manufacturer;
 183	__u16		lmp_subver;
 184	__u16		voice_setting;
 185	__u8		num_iac;
 
 
 186	__u8		io_capability;
 187	__s8		inq_tx_power;
 188	__u16		page_scan_interval;
 189	__u16		page_scan_window;
 190	__u8		page_scan_type;
 191	__u8		le_adv_channel_map;
 
 
 192	__u8		le_scan_type;
 193	__u16		le_scan_interval;
 194	__u16		le_scan_window;
 195	__u16		le_conn_min_interval;
 196	__u16		le_conn_max_interval;
 
 
 
 
 
 
 
 
 
 
 
 197	__u8		ssp_debug_mode;
 
 
 198
 199	__u16		devid_source;
 200	__u16		devid_vendor;
 201	__u16		devid_product;
 202	__u16		devid_version;
 203
 204	__u16		pkt_type;
 205	__u16		esco_type;
 206	__u16		link_policy;
 207	__u16		link_mode;
 208
 209	__u32		idle_timeout;
 210	__u16		sniff_min_interval;
 211	__u16		sniff_max_interval;
 212
 213	__u8		amp_status;
 214	__u32		amp_total_bw;
 215	__u32		amp_max_bw;
 216	__u32		amp_min_latency;
 217	__u32		amp_max_pdu;
 218	__u8		amp_type;
 219	__u16		amp_pal_cap;
 220	__u16		amp_assoc_size;
 221	__u32		amp_max_flush_to;
 222	__u32		amp_be_flush_to;
 223
 224	struct amp_assoc	loc_assoc;
 225
 226	__u8		flow_ctl_mode;
 227
 228	unsigned int	auto_accept_delay;
 229
 230	unsigned long	quirks;
 231
 232	atomic_t	cmd_cnt;
 233	unsigned int	acl_cnt;
 234	unsigned int	sco_cnt;
 235	unsigned int	le_cnt;
 236
 237	unsigned int	acl_mtu;
 238	unsigned int	sco_mtu;
 239	unsigned int	le_mtu;
 240	unsigned int	acl_pkts;
 241	unsigned int	sco_pkts;
 242	unsigned int	le_pkts;
 243
 244	__u16		block_len;
 245	__u16		block_mtu;
 246	__u16		num_blocks;
 247	__u16		block_cnt;
 248
 249	unsigned long	acl_last_tx;
 250	unsigned long	sco_last_tx;
 251	unsigned long	le_last_tx;
 252
 253	struct workqueue_struct	*workqueue;
 254	struct workqueue_struct	*req_workqueue;
 255
 256	struct work_struct	power_on;
 257	struct delayed_work	power_off;
 
 258
 259	__u16			discov_timeout;
 260	struct delayed_work	discov_off;
 261
 262	struct delayed_work	service_cache;
 263
 264	struct timer_list	cmd_timer;
 265
 266	struct work_struct	rx_work;
 267	struct work_struct	cmd_work;
 268	struct work_struct	tx_work;
 269
 
 
 
 
 
 
 
 
 270	struct sk_buff_head	rx_q;
 271	struct sk_buff_head	raw_q;
 272	struct sk_buff_head	cmd_q;
 273
 274	struct sk_buff		*recv_evt;
 275	struct sk_buff		*sent_cmd;
 276	struct sk_buff		*reassembly[NUM_REASSEMBLY];
 277
 278	struct mutex		req_lock;
 279	wait_queue_head_t	req_wait_q;
 280	__u32			req_status;
 281	__u32			req_result;
 
 282
 283	struct crypto_blkcipher	*tfm_aes;
 
 284
 285	struct discovery_state	discovery;
 286	struct hci_conn_hash	conn_hash;
 287
 288	struct list_head	mgmt_pending;
 289	struct list_head	blacklist;
 
 290	struct list_head	uuids;
 291	struct list_head	link_keys;
 292	struct list_head	long_term_keys;
 293	struct list_head	identity_resolving_keys;
 294	struct list_head	remote_oob_data;
 295	struct list_head	le_white_list;
 296	struct list_head	le_conn_params;
 297	struct list_head	pend_le_conns;
 
 298
 299	struct hci_dev_stats	stat;
 300
 301	atomic_t		promisc;
 302
 303	struct dentry		*debugfs;
 304
 305	struct device		dev;
 306
 307	struct rfkill		*rfkill;
 308
 309	unsigned long		dev_flags;
 310
 311	struct delayed_work	le_scan_disable;
 312
 313	__s8			adv_tx_power;
 314	__u8			adv_data[HCI_MAX_AD_LENGTH];
 315	__u8			adv_data_len;
 316	__u8			scan_rsp_data[HCI_MAX_AD_LENGTH];
 317	__u8			scan_rsp_data_len;
 318
 
 
 
 
 
 
 319	__u8			irk[16];
 320	__u32			rpa_timeout;
 321	struct delayed_work	rpa_expired;
 322	bdaddr_t		rpa;
 323
 
 
 324	int (*open)(struct hci_dev *hdev);
 325	int (*close)(struct hci_dev *hdev);
 326	int (*flush)(struct hci_dev *hdev);
 327	int (*setup)(struct hci_dev *hdev);
 
 328	int (*send)(struct hci_dev *hdev, struct sk_buff *skb);
 329	void (*notify)(struct hci_dev *hdev, unsigned int evt);
 
 
 
 
 330};
 331
 332#define HCI_PHY_HANDLE(handle)	(handle & 0xff)
 333
 334struct hci_conn {
 335	struct list_head list;
 336
 337	atomic_t	refcnt;
 338
 339	bdaddr_t	dst;
 340	__u8		dst_type;
 341	bdaddr_t	src;
 342	__u8		src_type;
 343	bdaddr_t	init_addr;
 344	__u8		init_addr_type;
 345	bdaddr_t	resp_addr;
 346	__u8		resp_addr_type;
 347	__u16		handle;
 348	__u16		state;
 349	__u8		mode;
 350	__u8		type;
 
 351	bool		out;
 352	__u8		attempt;
 353	__u8		dev_class[3];
 354	__u8		features[HCI_MAX_PAGES][8];
 355	__u16		pkt_type;
 356	__u16		link_policy;
 357	__u32		link_mode;
 358	__u8		key_type;
 359	__u8		auth_type;
 360	__u8		sec_level;
 361	__u8		pending_sec_level;
 362	__u8		pin_length;
 363	__u8		enc_key_size;
 364	__u8		io_capability;
 365	__u32		passkey_notify;
 366	__u8		passkey_entered;
 367	__u16		disc_timeout;
 
 368	__u16		setting;
 369	__u16		le_conn_min_interval;
 370	__u16		le_conn_max_interval;
 
 
 
 
 
 
 
 
 371	unsigned long	flags;
 372
 
 
 
 
 
 373	__u8		remote_cap;
 374	__u8		remote_auth;
 375	__u8		remote_id;
 376	bool		flush_key;
 377
 378	unsigned int	sent;
 379
 380	struct sk_buff_head data_q;
 381	struct list_head chan_list;
 382
 383	struct delayed_work disc_work;
 384	struct delayed_work auto_accept_work;
 385	struct delayed_work idle_work;
 386	struct delayed_work le_conn_timeout;
 
 387
 388	struct device	dev;
 
 389
 390	struct hci_dev	*hdev;
 391	void		*l2cap_data;
 392	void		*sco_data;
 393	void		*smp_conn;
 394	struct amp_mgr	*amp_mgr;
 395
 396	struct hci_conn	*link;
 397
 398	void (*connect_cfm_cb)	(struct hci_conn *conn, u8 status);
 399	void (*security_cfm_cb)	(struct hci_conn *conn, u8 status);
 400	void (*disconn_cfm_cb)	(struct hci_conn *conn, u8 reason);
 401};
 402
 403struct hci_chan {
 404	struct list_head list;
 405	__u16 handle;
 406	struct hci_conn *conn;
 407	struct sk_buff_head data_q;
 408	unsigned int	sent;
 409	__u8		state;
 410};
 411
 412struct hci_conn_params {
 413	struct list_head list;
 
 414
 415	bdaddr_t addr;
 416	u8 addr_type;
 417
 418	u16 conn_min_interval;
 419	u16 conn_max_interval;
 
 
 420
 421	enum {
 422		HCI_AUTO_CONN_DISABLED,
 
 
 423		HCI_AUTO_CONN_ALWAYS,
 424		HCI_AUTO_CONN_LINK_LOSS,
 
 425	} auto_connect;
 
 
 
 426};
 427
 428extern struct list_head hci_dev_list;
 429extern struct list_head hci_cb_list;
 430extern rwlock_t hci_dev_list_lock;
 431extern rwlock_t hci_cb_list_lock;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 432
 433/* ----- HCI interface to upper protocols ----- */
 434int l2cap_connect_ind(struct hci_dev *hdev, bdaddr_t *bdaddr);
 435void l2cap_connect_cfm(struct hci_conn *hcon, u8 status);
 436int l2cap_disconn_ind(struct hci_conn *hcon);
 437void l2cap_disconn_cfm(struct hci_conn *hcon, u8 reason);
 438int l2cap_security_cfm(struct hci_conn *hcon, u8 status, u8 encrypt);
 439int l2cap_recv_acldata(struct hci_conn *hcon, struct sk_buff *skb, u16 flags);
 440
 
 441int sco_connect_ind(struct hci_dev *hdev, bdaddr_t *bdaddr, __u8 *flags);
 442void sco_connect_cfm(struct hci_conn *hcon, __u8 status);
 443void sco_disconn_cfm(struct hci_conn *hcon, __u8 reason);
 444int sco_recv_scodata(struct hci_conn *hcon, struct sk_buff *skb);
 
 
 
 
 
 
 
 
 
 445
 446/* ----- Inquiry cache ----- */
 447#define INQUIRY_CACHE_AGE_MAX   (HZ*30)   /* 30 seconds */
 448#define INQUIRY_ENTRY_AGE_MAX   (HZ*60)   /* 60 seconds */
 449
 450static inline void discovery_init(struct hci_dev *hdev)
 451{
 452	hdev->discovery.state = DISCOVERY_STOPPED;
 453	INIT_LIST_HEAD(&hdev->discovery.all);
 454	INIT_LIST_HEAD(&hdev->discovery.unknown);
 455	INIT_LIST_HEAD(&hdev->discovery.resolve);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 456}
 457
 458bool hci_discovery_active(struct hci_dev *hdev);
 459
 460void hci_discovery_set_state(struct hci_dev *hdev, int state);
 461
 462static inline int inquiry_cache_empty(struct hci_dev *hdev)
 463{
 464	return list_empty(&hdev->discovery.all);
 465}
 466
 467static inline long inquiry_cache_age(struct hci_dev *hdev)
 468{
 469	struct discovery_state *c = &hdev->discovery;
 470	return jiffies - c->timestamp;
 471}
 472
 473static inline long inquiry_entry_age(struct inquiry_entry *e)
 474{
 475	return jiffies - e->timestamp;
 476}
 477
 478struct inquiry_entry *hci_inquiry_cache_lookup(struct hci_dev *hdev,
 479					       bdaddr_t *bdaddr);
 480struct inquiry_entry *hci_inquiry_cache_lookup_unknown(struct hci_dev *hdev,
 481						       bdaddr_t *bdaddr);
 482struct inquiry_entry *hci_inquiry_cache_lookup_resolve(struct hci_dev *hdev,
 483						       bdaddr_t *bdaddr,
 484						       int state);
 485void hci_inquiry_cache_update_resolve(struct hci_dev *hdev,
 486				      struct inquiry_entry *ie);
 487bool hci_inquiry_cache_update(struct hci_dev *hdev, struct inquiry_data *data,
 488			      bool name_known, bool *ssp);
 489void hci_inquiry_cache_flush(struct hci_dev *hdev);
 490
 491/* ----- HCI Connections ----- */
 492enum {
 493	HCI_CONN_AUTH_PEND,
 494	HCI_CONN_REAUTH_PEND,
 495	HCI_CONN_ENCRYPT_PEND,
 496	HCI_CONN_RSWITCH_PEND,
 497	HCI_CONN_MODE_CHANGE_PEND,
 498	HCI_CONN_SCO_SETUP_PEND,
 499	HCI_CONN_LE_SMP_PEND,
 500	HCI_CONN_MGMT_CONNECTED,
 501	HCI_CONN_SSP_ENABLED,
 502	HCI_CONN_SC_ENABLED,
 503	HCI_CONN_AES_CCM,
 504	HCI_CONN_POWER_SAVE,
 505	HCI_CONN_REMOTE_OOB,
 506	HCI_CONN_6LOWPAN,
 
 
 
 
 
 
 
 
 
 507};
 508
 509static inline bool hci_conn_ssp_enabled(struct hci_conn *conn)
 510{
 511	struct hci_dev *hdev = conn->hdev;
 512	return test_bit(HCI_SSP_ENABLED, &hdev->dev_flags) &&
 513	       test_bit(HCI_CONN_SSP_ENABLED, &conn->flags);
 514}
 515
 516static inline bool hci_conn_sc_enabled(struct hci_conn *conn)
 517{
 518	struct hci_dev *hdev = conn->hdev;
 519	return test_bit(HCI_SC_ENABLED, &hdev->dev_flags) &&
 520	       test_bit(HCI_CONN_SC_ENABLED, &conn->flags);
 521}
 522
 523static inline void hci_conn_hash_add(struct hci_dev *hdev, struct hci_conn *c)
 524{
 525	struct hci_conn_hash *h = &hdev->conn_hash;
 526	list_add_rcu(&c->list, &h->list);
 527	switch (c->type) {
 528	case ACL_LINK:
 529		h->acl_num++;
 530		break;
 531	case AMP_LINK:
 532		h->amp_num++;
 533		break;
 534	case LE_LINK:
 535		h->le_num++;
 
 
 536		break;
 537	case SCO_LINK:
 538	case ESCO_LINK:
 539		h->sco_num++;
 540		break;
 541	}
 542}
 543
 544static inline void hci_conn_hash_del(struct hci_dev *hdev, struct hci_conn *c)
 545{
 546	struct hci_conn_hash *h = &hdev->conn_hash;
 547
 548	list_del_rcu(&c->list);
 549	synchronize_rcu();
 550
 551	switch (c->type) {
 552	case ACL_LINK:
 553		h->acl_num--;
 554		break;
 555	case AMP_LINK:
 556		h->amp_num--;
 557		break;
 558	case LE_LINK:
 559		h->le_num--;
 
 
 560		break;
 561	case SCO_LINK:
 562	case ESCO_LINK:
 563		h->sco_num--;
 564		break;
 565	}
 566}
 567
 568static inline unsigned int hci_conn_num(struct hci_dev *hdev, __u8 type)
 569{
 570	struct hci_conn_hash *h = &hdev->conn_hash;
 571	switch (type) {
 572	case ACL_LINK:
 573		return h->acl_num;
 574	case AMP_LINK:
 575		return h->amp_num;
 576	case LE_LINK:
 577		return h->le_num;
 578	case SCO_LINK:
 579	case ESCO_LINK:
 580		return h->sco_num;
 581	default:
 582		return 0;
 583	}
 584}
 585
 586static inline unsigned int hci_conn_count(struct hci_dev *hdev)
 587{
 588	struct hci_conn_hash *c = &hdev->conn_hash;
 589
 590	return c->acl_num + c->amp_num + c->sco_num + c->le_num;
 591}
 592
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 593static inline struct hci_conn *hci_conn_hash_lookup_handle(struct hci_dev *hdev,
 594								__u16 handle)
 595{
 596	struct hci_conn_hash *h = &hdev->conn_hash;
 597	struct hci_conn  *c;
 598
 599	rcu_read_lock();
 600
 601	list_for_each_entry_rcu(c, &h->list, list) {
 602		if (c->handle == handle) {
 603			rcu_read_unlock();
 604			return c;
 605		}
 606	}
 607	rcu_read_unlock();
 608
 609	return NULL;
 610}
 611
 612static inline struct hci_conn *hci_conn_hash_lookup_ba(struct hci_dev *hdev,
 613							__u8 type, bdaddr_t *ba)
 614{
 615	struct hci_conn_hash *h = &hdev->conn_hash;
 616	struct hci_conn  *c;
 617
 618	rcu_read_lock();
 619
 620	list_for_each_entry_rcu(c, &h->list, list) {
 621		if (c->type == type && !bacmp(&c->dst, ba)) {
 622			rcu_read_unlock();
 623			return c;
 624		}
 625	}
 626
 627	rcu_read_unlock();
 628
 629	return NULL;
 630}
 631
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 632static inline struct hci_conn *hci_conn_hash_lookup_state(struct hci_dev *hdev,
 633							__u8 type, __u16 state)
 634{
 635	struct hci_conn_hash *h = &hdev->conn_hash;
 636	struct hci_conn  *c;
 637
 638	rcu_read_lock();
 639
 640	list_for_each_entry_rcu(c, &h->list, list) {
 641		if (c->type == type && c->state == state) {
 642			rcu_read_unlock();
 643			return c;
 644		}
 645	}
 646
 647	rcu_read_unlock();
 648
 649	return NULL;
 650}
 651
 652void hci_disconnect(struct hci_conn *conn, __u8 reason);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 653bool hci_setup_sync(struct hci_conn *conn, __u16 handle);
 654void hci_sco_setup(struct hci_conn *conn, __u8 status);
 655
 656struct hci_conn *hci_conn_add(struct hci_dev *hdev, int type, bdaddr_t *dst);
 
 657int hci_conn_del(struct hci_conn *conn);
 658void hci_conn_hash_flush(struct hci_dev *hdev);
 659void hci_conn_check_pending(struct hci_dev *hdev);
 660
 661struct hci_chan *hci_chan_create(struct hci_conn *conn);
 662void hci_chan_del(struct hci_chan *chan);
 663void hci_chan_list_flush(struct hci_conn *conn);
 664struct hci_chan *hci_chan_lookup_handle(struct hci_dev *hdev, __u16 handle);
 665
 
 
 
 666struct hci_conn *hci_connect_le(struct hci_dev *hdev, bdaddr_t *dst,
 667				u8 dst_type, u8 sec_level, u8 auth_type);
 
 668struct hci_conn *hci_connect_acl(struct hci_dev *hdev, bdaddr_t *dst,
 669				 u8 sec_level, u8 auth_type);
 670struct hci_conn *hci_connect_sco(struct hci_dev *hdev, int type, bdaddr_t *dst,
 671				 __u16 setting);
 672int hci_conn_check_link_mode(struct hci_conn *conn);
 673int hci_conn_check_secure(struct hci_conn *conn, __u8 sec_level);
 674int hci_conn_security(struct hci_conn *conn, __u8 sec_level, __u8 auth_type);
 675int hci_conn_change_link_key(struct hci_conn *conn);
 676int hci_conn_switch_role(struct hci_conn *conn, __u8 role);
 677
 678void hci_conn_enter_active_mode(struct hci_conn *conn, __u8 force_active);
 679
 680void hci_le_conn_failed(struct hci_conn *conn, u8 status);
 681
 682/*
 683 * hci_conn_get() and hci_conn_put() are used to control the life-time of an
 684 * "hci_conn" object. They do not guarantee that the hci_conn object is running,
 685 * working or anything else. They just guarantee that the object is available
 686 * and can be dereferenced. So you can use its locks, local variables and any
 687 * other constant data.
 688 * Before accessing runtime data, you _must_ lock the object and then check that
 689 * it is still running. As soon as you release the locks, the connection might
 690 * get dropped, though.
 691 *
 692 * On the other hand, hci_conn_hold() and hci_conn_drop() are used to control
 693 * how long the underlying connection is held. So every channel that runs on the
 694 * hci_conn object calls this to prevent the connection from disappearing. As
 695 * long as you hold a device, you must also guarantee that you have a valid
 696 * reference to the device via hci_conn_get() (or the initial reference from
 697 * hci_conn_add()).
 698 * The hold()/drop() ref-count is known to drop below 0 sometimes, which doesn't
 699 * break because nobody cares for that. But this means, we cannot use
 700 * _get()/_drop() in it, but require the caller to have a valid ref (FIXME).
 701 */
 702
 703static inline void hci_conn_get(struct hci_conn *conn)
 704{
 705	get_device(&conn->dev);
 
 706}
 707
 708static inline void hci_conn_put(struct hci_conn *conn)
 709{
 710	put_device(&conn->dev);
 711}
 712
 713static inline void hci_conn_hold(struct hci_conn *conn)
 714{
 715	BT_DBG("hcon %p orig refcnt %d", conn, atomic_read(&conn->refcnt));
 716
 717	atomic_inc(&conn->refcnt);
 718	cancel_delayed_work(&conn->disc_work);
 719}
 720
 721static inline void hci_conn_drop(struct hci_conn *conn)
 722{
 723	BT_DBG("hcon %p orig refcnt %d", conn, atomic_read(&conn->refcnt));
 724
 725	if (atomic_dec_and_test(&conn->refcnt)) {
 726		unsigned long timeo;
 727
 728		switch (conn->type) {
 729		case ACL_LINK:
 730		case LE_LINK:
 731			cancel_delayed_work(&conn->idle_work);
 732			if (conn->state == BT_CONNECTED) {
 733				timeo = conn->disc_timeout;
 734				if (!conn->out)
 735					timeo *= 2;
 736			} else {
 737				timeo = msecs_to_jiffies(10);
 738			}
 739			break;
 740
 741		case AMP_LINK:
 742			timeo = conn->disc_timeout;
 743			break;
 744
 745		default:
 746			timeo = msecs_to_jiffies(10);
 747			break;
 748		}
 749
 750		cancel_delayed_work(&conn->disc_work);
 751		queue_delayed_work(conn->hdev->workqueue,
 752				   &conn->disc_work, timeo);
 753	}
 754}
 755
 756/* ----- HCI Devices ----- */
 757static inline void hci_dev_put(struct hci_dev *d)
 758{
 759	BT_DBG("%s orig refcnt %d", d->name,
 760	       atomic_read(&d->dev.kobj.kref.refcount));
 761
 762	put_device(&d->dev);
 763}
 764
 765static inline struct hci_dev *hci_dev_hold(struct hci_dev *d)
 766{
 767	BT_DBG("%s orig refcnt %d", d->name,
 768	       atomic_read(&d->dev.kobj.kref.refcount));
 769
 770	get_device(&d->dev);
 771	return d;
 772}
 773
 774#define hci_dev_lock(d)		mutex_lock(&d->lock)
 775#define hci_dev_unlock(d)	mutex_unlock(&d->lock)
 776
 777#define to_hci_dev(d) container_of(d, struct hci_dev, dev)
 778#define to_hci_conn(c) container_of(c, struct hci_conn, dev)
 779
 780static inline void *hci_get_drvdata(struct hci_dev *hdev)
 781{
 782	return dev_get_drvdata(&hdev->dev);
 783}
 784
 785static inline void hci_set_drvdata(struct hci_dev *hdev, void *data)
 786{
 787	dev_set_drvdata(&hdev->dev, data);
 788}
 789
 790struct hci_dev *hci_dev_get(int index);
 791struct hci_dev *hci_get_route(bdaddr_t *dst, bdaddr_t *src);
 792
 793struct hci_dev *hci_alloc_dev(void);
 794void hci_free_dev(struct hci_dev *hdev);
 795int hci_register_dev(struct hci_dev *hdev);
 796void hci_unregister_dev(struct hci_dev *hdev);
 797int hci_suspend_dev(struct hci_dev *hdev);
 798int hci_resume_dev(struct hci_dev *hdev);
 
 799int hci_dev_open(__u16 dev);
 800int hci_dev_close(__u16 dev);
 
 801int hci_dev_reset(__u16 dev);
 802int hci_dev_reset_stat(__u16 dev);
 803int hci_dev_cmd(unsigned int cmd, void __user *arg);
 804int hci_get_dev_list(void __user *arg);
 805int hci_get_dev_info(void __user *arg);
 806int hci_get_conn_list(void __user *arg);
 807int hci_get_conn_info(struct hci_dev *hdev, void __user *arg);
 808int hci_get_auth_info(struct hci_dev *hdev, void __user *arg);
 809int hci_inquiry(void __user *arg);
 810
 811struct bdaddr_list *hci_blacklist_lookup(struct hci_dev *hdev,
 812					 bdaddr_t *bdaddr, u8 type);
 813int hci_blacklist_add(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 type);
 814int hci_blacklist_del(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 type);
 815
 816struct bdaddr_list *hci_white_list_lookup(struct hci_dev *hdev,
 817					  bdaddr_t *bdaddr, u8 type);
 818void hci_white_list_clear(struct hci_dev *hdev);
 819int hci_white_list_add(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 type);
 820int hci_white_list_del(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 type);
 821
 822struct hci_conn_params *hci_conn_params_lookup(struct hci_dev *hdev,
 823					       bdaddr_t *addr, u8 addr_type);
 824int hci_conn_params_add(struct hci_dev *hdev, bdaddr_t *addr, u8 addr_type,
 825			u8 auto_connect, u16 conn_min_interval,
 826			u16 conn_max_interval);
 827void hci_conn_params_del(struct hci_dev *hdev, bdaddr_t *addr, u8 addr_type);
 828void hci_conn_params_clear(struct hci_dev *hdev);
 829
 830struct bdaddr_list *hci_pend_le_conn_lookup(struct hci_dev *hdev,
 831					    bdaddr_t *addr, u8 addr_type);
 832void hci_pend_le_conn_add(struct hci_dev *hdev, bdaddr_t *addr, u8 addr_type);
 833void hci_pend_le_conn_del(struct hci_dev *hdev, bdaddr_t *addr, u8 addr_type);
 834void hci_pend_le_conns_clear(struct hci_dev *hdev);
 835
 836void hci_update_background_scan(struct hci_dev *hdev);
 
 
 837
 838void hci_uuids_clear(struct hci_dev *hdev);
 839
 840void hci_link_keys_clear(struct hci_dev *hdev);
 841struct link_key *hci_find_link_key(struct hci_dev *hdev, bdaddr_t *bdaddr);
 842int hci_add_link_key(struct hci_dev *hdev, struct hci_conn *conn, int new_key,
 843		     bdaddr_t *bdaddr, u8 *val, u8 type, u8 pin_len);
 844struct smp_ltk *hci_find_ltk(struct hci_dev *hdev, __le16 ediv, __le64 rand,
 845			     bool master);
 846struct smp_ltk *hci_add_ltk(struct hci_dev *hdev, bdaddr_t *bdaddr,
 847			    u8 addr_type, u8 type, u8 authenticated,
 848			    u8 tk[16], u8 enc_size, __le16 ediv, __le64 rand);
 849struct smp_ltk *hci_find_ltk_by_addr(struct hci_dev *hdev, bdaddr_t *bdaddr,
 850				     u8 addr_type, bool master);
 851int hci_remove_ltk(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 bdaddr_type);
 852void hci_smp_ltks_clear(struct hci_dev *hdev);
 853int hci_remove_link_key(struct hci_dev *hdev, bdaddr_t *bdaddr);
 854
 855struct smp_irk *hci_find_irk_by_rpa(struct hci_dev *hdev, bdaddr_t *rpa);
 856struct smp_irk *hci_find_irk_by_addr(struct hci_dev *hdev, bdaddr_t *bdaddr,
 857				     u8 addr_type);
 858struct smp_irk *hci_add_irk(struct hci_dev *hdev, bdaddr_t *bdaddr,
 859			    u8 addr_type, u8 val[16], bdaddr_t *rpa);
 860void hci_remove_irk(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 addr_type);
 861void hci_smp_irks_clear(struct hci_dev *hdev);
 862
 
 
 863void hci_remote_oob_data_clear(struct hci_dev *hdev);
 864struct oob_data *hci_find_remote_oob_data(struct hci_dev *hdev,
 865					  bdaddr_t *bdaddr);
 866int hci_add_remote_oob_data(struct hci_dev *hdev, bdaddr_t *bdaddr,
 867			    u8 *hash, u8 *randomizer);
 868int hci_add_remote_oob_ext_data(struct hci_dev *hdev, bdaddr_t *bdaddr,
 869				u8 *hash192, u8 *randomizer192,
 870				u8 *hash256, u8 *randomizer256);
 871int hci_remove_remote_oob_data(struct hci_dev *hdev, bdaddr_t *bdaddr);
 
 
 
 
 
 
 
 
 872
 873void hci_event_packet(struct hci_dev *hdev, struct sk_buff *skb);
 874
 875int hci_recv_frame(struct hci_dev *hdev, struct sk_buff *skb);
 876int hci_recv_fragment(struct hci_dev *hdev, int type, void *data, int count);
 877int hci_recv_stream_fragment(struct hci_dev *hdev, void *data, int count);
 878
 879void hci_init_sysfs(struct hci_dev *hdev);
 880void hci_conn_init_sysfs(struct hci_conn *conn);
 881void hci_conn_add_sysfs(struct hci_conn *conn);
 882void hci_conn_del_sysfs(struct hci_conn *conn);
 883
 884#define SET_HCIDEV_DEV(hdev, pdev) ((hdev)->dev.parent = (pdev))
 885
 886/* ----- LMP capabilities ----- */
 887#define lmp_encrypt_capable(dev)   ((dev)->features[0][0] & LMP_ENCRYPT)
 888#define lmp_rswitch_capable(dev)   ((dev)->features[0][0] & LMP_RSWITCH)
 889#define lmp_hold_capable(dev)      ((dev)->features[0][0] & LMP_HOLD)
 890#define lmp_sniff_capable(dev)     ((dev)->features[0][0] & LMP_SNIFF)
 891#define lmp_park_capable(dev)      ((dev)->features[0][1] & LMP_PARK)
 892#define lmp_inq_rssi_capable(dev)  ((dev)->features[0][3] & LMP_RSSI_INQ)
 893#define lmp_esco_capable(dev)      ((dev)->features[0][3] & LMP_ESCO)
 894#define lmp_bredr_capable(dev)     (!((dev)->features[0][4] & LMP_NO_BREDR))
 895#define lmp_le_capable(dev)        ((dev)->features[0][4] & LMP_LE)
 896#define lmp_sniffsubr_capable(dev) ((dev)->features[0][5] & LMP_SNIFF_SUBR)
 897#define lmp_pause_enc_capable(dev) ((dev)->features[0][5] & LMP_PAUSE_ENC)
 898#define lmp_ext_inq_capable(dev)   ((dev)->features[0][6] & LMP_EXT_INQ)
 899#define lmp_le_br_capable(dev)     (!!((dev)->features[0][6] & LMP_SIMUL_LE_BR))
 900#define lmp_ssp_capable(dev)       ((dev)->features[0][6] & LMP_SIMPLE_PAIR)
 901#define lmp_no_flush_capable(dev)  ((dev)->features[0][6] & LMP_NO_FLUSH)
 902#define lmp_lsto_capable(dev)      ((dev)->features[0][7] & LMP_LSTO)
 903#define lmp_inq_tx_pwr_capable(dev) ((dev)->features[0][7] & LMP_INQ_TX_PWR)
 904#define lmp_ext_feat_capable(dev)  ((dev)->features[0][7] & LMP_EXTFEATURES)
 905#define lmp_transp_capable(dev)    ((dev)->features[0][2] & LMP_TRANSPARENT)
 906
 907/* ----- Extended LMP capabilities ----- */
 908#define lmp_csb_master_capable(dev) ((dev)->features[2][0] & LMP_CSB_MASTER)
 909#define lmp_csb_slave_capable(dev)  ((dev)->features[2][0] & LMP_CSB_SLAVE)
 910#define lmp_sync_train_capable(dev) ((dev)->features[2][0] & LMP_SYNC_TRAIN)
 911#define lmp_sync_scan_capable(dev)  ((dev)->features[2][0] & LMP_SYNC_SCAN)
 912#define lmp_sc_capable(dev)         ((dev)->features[2][1] & LMP_SC)
 913#define lmp_ping_capable(dev)       ((dev)->features[2][1] & LMP_PING)
 914
 915/* ----- Host capabilities ----- */
 916#define lmp_host_ssp_capable(dev)  ((dev)->features[1][0] & LMP_HOST_SSP)
 917#define lmp_host_sc_capable(dev)   ((dev)->features[1][0] & LMP_HOST_SC)
 918#define lmp_host_le_capable(dev)   (!!((dev)->features[1][0] & LMP_HOST_LE))
 919#define lmp_host_le_br_capable(dev) (!!((dev)->features[1][0] & LMP_HOST_LE_BREDR))
 920
 
 
 
 
 
 921/* ----- HCI protocols ----- */
 922#define HCI_PROTO_DEFER             0x01
 923
 924static inline int hci_proto_connect_ind(struct hci_dev *hdev, bdaddr_t *bdaddr,
 925					__u8 type, __u8 *flags)
 926{
 927	switch (type) {
 928	case ACL_LINK:
 929		return l2cap_connect_ind(hdev, bdaddr);
 930
 931	case SCO_LINK:
 932	case ESCO_LINK:
 933		return sco_connect_ind(hdev, bdaddr, flags);
 934
 935	default:
 936		BT_ERR("unknown link type %d", type);
 937		return -EINVAL;
 938	}
 939}
 940
 941static inline void hci_proto_connect_cfm(struct hci_conn *conn, __u8 status)
 942{
 943	switch (conn->type) {
 944	case ACL_LINK:
 945	case LE_LINK:
 946		l2cap_connect_cfm(conn, status);
 947		break;
 948
 949	case SCO_LINK:
 950	case ESCO_LINK:
 951		sco_connect_cfm(conn, status);
 952		break;
 953
 954	default:
 955		BT_ERR("unknown link type %d", conn->type);
 956		break;
 957	}
 958
 959	if (conn->connect_cfm_cb)
 960		conn->connect_cfm_cb(conn, status);
 961}
 962
 963static inline int hci_proto_disconn_ind(struct hci_conn *conn)
 964{
 965	if (conn->type != ACL_LINK && conn->type != LE_LINK)
 966		return HCI_ERROR_REMOTE_USER_TERM;
 967
 968	return l2cap_disconn_ind(conn);
 969}
 970
 971static inline void hci_proto_disconn_cfm(struct hci_conn *conn, __u8 reason)
 972{
 973	switch (conn->type) {
 974	case ACL_LINK:
 975	case LE_LINK:
 976		l2cap_disconn_cfm(conn, reason);
 977		break;
 978
 979	case SCO_LINK:
 980	case ESCO_LINK:
 981		sco_disconn_cfm(conn, reason);
 982		break;
 983
 984	/* L2CAP would be handled for BREDR chan */
 985	case AMP_LINK:
 986		break;
 
 
 
 
 987
 988	default:
 989		BT_ERR("unknown link type %d", conn->type);
 990		break;
 991	}
 992
 993	if (conn->disconn_cfm_cb)
 994		conn->disconn_cfm_cb(conn, reason);
 995}
 996
 997static inline void hci_proto_auth_cfm(struct hci_conn *conn, __u8 status)
 998{
 999	__u8 encrypt;
1000
1001	if (conn->type != ACL_LINK && conn->type != LE_LINK)
1002		return;
 
 
 
 
1003
1004	if (test_bit(HCI_CONN_ENCRYPT_PEND, &conn->flags))
1005		return;
1006
1007	encrypt = (conn->link_mode & HCI_LM_ENCRYPT) ? 0x01 : 0x00;
1008	l2cap_security_cfm(conn, status, encrypt);
1009
1010	if (conn->security_cfm_cb)
1011		conn->security_cfm_cb(conn, status);
1012}
1013
1014static inline void hci_proto_encrypt_cfm(struct hci_conn *conn, __u8 status,
1015								__u8 encrypt)
1016{
1017	if (conn->type != ACL_LINK && conn->type != LE_LINK)
1018		return;
1019
1020	l2cap_security_cfm(conn, status, encrypt);
 
 
 
 
 
1021
1022	if (conn->security_cfm_cb)
1023		conn->security_cfm_cb(conn, status);
1024}
1025
1026/* ----- HCI callbacks ----- */
1027struct hci_cb {
1028	struct list_head list;
1029
1030	char *name;
1031
1032	void (*security_cfm)	(struct hci_conn *conn, __u8 status,
1033								__u8 encrypt);
1034	void (*key_change_cfm)	(struct hci_conn *conn, __u8 status);
1035	void (*role_switch_cfm)	(struct hci_conn *conn, __u8 status, __u8 role);
1036};
1037
1038static inline void hci_auth_cfm(struct hci_conn *conn, __u8 status)
1039{
1040	struct hci_cb *cb;
1041	__u8 encrypt;
1042
1043	hci_proto_auth_cfm(conn, status);
1044
1045	if (test_bit(HCI_CONN_ENCRYPT_PEND, &conn->flags))
1046		return;
1047
1048	encrypt = (conn->link_mode & HCI_LM_ENCRYPT) ? 0x01 : 0x00;
1049
1050	read_lock(&hci_cb_list_lock);
1051	list_for_each_entry(cb, &hci_cb_list, list) {
1052		if (cb->security_cfm)
1053			cb->security_cfm(conn, status, encrypt);
1054	}
1055	read_unlock(&hci_cb_list_lock);
 
 
 
1056}
1057
1058static inline void hci_encrypt_cfm(struct hci_conn *conn, __u8 status,
1059								__u8 encrypt)
1060{
1061	struct hci_cb *cb;
1062
1063	if (conn->sec_level == BT_SECURITY_SDP)
1064		conn->sec_level = BT_SECURITY_LOW;
1065
1066	if (conn->pending_sec_level > conn->sec_level)
1067		conn->sec_level = conn->pending_sec_level;
1068
1069	hci_proto_encrypt_cfm(conn, status, encrypt);
1070
1071	read_lock(&hci_cb_list_lock);
1072	list_for_each_entry(cb, &hci_cb_list, list) {
1073		if (cb->security_cfm)
1074			cb->security_cfm(conn, status, encrypt);
1075	}
1076	read_unlock(&hci_cb_list_lock);
 
 
 
1077}
1078
1079static inline void hci_key_change_cfm(struct hci_conn *conn, __u8 status)
1080{
1081	struct hci_cb *cb;
1082
1083	read_lock(&hci_cb_list_lock);
1084	list_for_each_entry(cb, &hci_cb_list, list) {
1085		if (cb->key_change_cfm)
1086			cb->key_change_cfm(conn, status);
1087	}
1088	read_unlock(&hci_cb_list_lock);
1089}
1090
1091static inline void hci_role_switch_cfm(struct hci_conn *conn, __u8 status,
1092								__u8 role)
1093{
1094	struct hci_cb *cb;
1095
1096	read_lock(&hci_cb_list_lock);
1097	list_for_each_entry(cb, &hci_cb_list, list) {
1098		if (cb->role_switch_cfm)
1099			cb->role_switch_cfm(conn, status, role);
1100	}
1101	read_unlock(&hci_cb_list_lock);
1102}
1103
1104static inline bool eir_has_data_type(u8 *data, size_t data_len, u8 type)
 
1105{
1106	size_t parsed = 0;
1107
1108	if (data_len < 2)
1109		return false;
1110
1111	while (parsed < data_len - 1) {
1112		u8 field_len = data[0];
1113
1114		if (field_len == 0)
1115			break;
1116
1117		parsed += field_len + 1;
1118
1119		if (parsed > data_len)
1120			break;
1121
1122		if (data[1] == type)
1123			return true;
 
 
 
 
 
 
1124
1125		data += field_len + 1;
 
 
 
1126	}
1127
1128	return false;
1129}
1130
1131static inline bool hci_bdaddr_is_rpa(bdaddr_t *bdaddr, u8 addr_type)
1132{
1133	if (addr_type != 0x01)
1134		return false;
1135
1136	if ((bdaddr->b[5] & 0xc0) == 0x40)
1137	       return true;
1138
1139	return false;
1140}
1141
 
 
 
 
 
 
 
 
 
 
 
 
1142static inline struct smp_irk *hci_get_irk(struct hci_dev *hdev,
1143					  bdaddr_t *bdaddr, u8 addr_type)
1144{
1145	if (!hci_bdaddr_is_rpa(bdaddr, addr_type))
1146		return NULL;
1147
1148	return hci_find_irk_by_rpa(hdev, bdaddr);
1149}
1150
1151int hci_register_cb(struct hci_cb *hcb);
1152int hci_unregister_cb(struct hci_cb *hcb);
 
 
 
 
 
 
 
 
1153
1154struct hci_request {
1155	struct hci_dev		*hdev;
1156	struct sk_buff_head	cmd_q;
1157
1158	/* If something goes wrong when building the HCI request, the error
1159	 * value is stored in this field.
1160	 */
1161	int			err;
1162};
1163
1164void hci_req_init(struct hci_request *req, struct hci_dev *hdev);
1165int hci_req_run(struct hci_request *req, hci_req_complete_t complete);
1166void hci_req_add(struct hci_request *req, u16 opcode, u32 plen,
1167		 const void *param);
1168void hci_req_add_ev(struct hci_request *req, u16 opcode, u32 plen,
1169		    const void *param, u8 event);
1170void hci_req_cmd_complete(struct hci_dev *hdev, u16 opcode, u8 status);
1171
1172void hci_req_add_le_scan_disable(struct hci_request *req);
1173void hci_req_add_le_passive_scan(struct hci_request *req);
1174
1175struct sk_buff *__hci_cmd_sync(struct hci_dev *hdev, u16 opcode, u32 plen,
1176			       const void *param, u32 timeout);
1177struct sk_buff *__hci_cmd_sync_ev(struct hci_dev *hdev, u16 opcode, u32 plen,
1178				  const void *param, u8 event, u32 timeout);
1179
1180int hci_send_cmd(struct hci_dev *hdev, __u16 opcode, __u32 plen,
1181		 const void *param);
1182void hci_send_acl(struct hci_chan *chan, struct sk_buff *skb, __u16 flags);
1183void hci_send_sco(struct hci_conn *conn, struct sk_buff *skb);
1184
1185void *hci_sent_cmd_data(struct hci_dev *hdev, __u16 opcode);
1186
 
 
 
1187/* ----- HCI Sockets ----- */
1188void hci_send_to_sock(struct hci_dev *hdev, struct sk_buff *skb);
1189void hci_send_to_control(struct sk_buff *skb, struct sock *skip_sk);
 
1190void hci_send_to_monitor(struct hci_dev *hdev, struct sk_buff *skb);
1191
1192void hci_sock_dev_event(struct hci_dev *hdev, int event);
1193
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1194/* Management interface */
1195#define DISCOV_TYPE_BREDR		(BIT(BDADDR_BREDR))
1196#define DISCOV_TYPE_LE			(BIT(BDADDR_LE_PUBLIC) | \
1197					 BIT(BDADDR_LE_RANDOM))
1198#define DISCOV_TYPE_INTERLEAVED		(BIT(BDADDR_BREDR) | \
1199					 BIT(BDADDR_LE_PUBLIC) | \
1200					 BIT(BDADDR_LE_RANDOM))
1201
1202/* These LE scan and inquiry parameters were chosen according to LE General
1203 * Discovery Procedure specification.
1204 */
1205#define DISCOV_LE_SCAN_WIN		0x12
1206#define DISCOV_LE_SCAN_INT		0x12
1207#define DISCOV_LE_TIMEOUT		msecs_to_jiffies(10240)
1208#define DISCOV_INTERLEAVED_TIMEOUT	msecs_to_jiffies(5120)
1209#define DISCOV_INTERLEAVED_INQUIRY_LEN	0x04
1210#define DISCOV_BREDR_INQUIRY_LEN	0x08
 
1211
1212int mgmt_control(struct sock *sk, struct msghdr *msg, size_t len);
1213void mgmt_index_added(struct hci_dev *hdev);
1214void mgmt_index_removed(struct hci_dev *hdev);
1215void mgmt_set_powered_failed(struct hci_dev *hdev, int err);
1216int mgmt_powered(struct hci_dev *hdev, u8 powered);
1217void mgmt_discoverable_timeout(struct hci_dev *hdev);
1218void mgmt_discoverable(struct hci_dev *hdev, u8 discoverable);
1219void mgmt_connectable(struct hci_dev *hdev, u8 connectable);
1220void mgmt_advertising(struct hci_dev *hdev, u8 advertising);
1221void mgmt_write_scan_failed(struct hci_dev *hdev, u8 scan, u8 status);
1222void mgmt_new_link_key(struct hci_dev *hdev, struct link_key *key,
1223		       bool persistent);
1224void mgmt_device_connected(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 link_type,
1225			   u8 addr_type, u32 flags, u8 *name, u8 name_len,
1226			   u8 *dev_class);
1227void mgmt_device_disconnected(struct hci_dev *hdev, bdaddr_t *bdaddr,
1228			      u8 link_type, u8 addr_type, u8 reason,
1229			      bool mgmt_connected);
1230void mgmt_disconnect_failed(struct hci_dev *hdev, bdaddr_t *bdaddr,
1231			    u8 link_type, u8 addr_type, u8 status);
1232void mgmt_connect_failed(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 link_type,
1233			 u8 addr_type, u8 status);
1234void mgmt_pin_code_request(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 secure);
1235void mgmt_pin_code_reply_complete(struct hci_dev *hdev, bdaddr_t *bdaddr,
1236				  u8 status);
1237void mgmt_pin_code_neg_reply_complete(struct hci_dev *hdev, bdaddr_t *bdaddr,
1238				      u8 status);
1239int mgmt_user_confirm_request(struct hci_dev *hdev, bdaddr_t *bdaddr,
1240			      u8 link_type, u8 addr_type, u32 value,
1241			      u8 confirm_hint);
1242int mgmt_user_confirm_reply_complete(struct hci_dev *hdev, bdaddr_t *bdaddr,
1243				     u8 link_type, u8 addr_type, u8 status);
1244int mgmt_user_confirm_neg_reply_complete(struct hci_dev *hdev, bdaddr_t *bdaddr,
1245					 u8 link_type, u8 addr_type, u8 status);
1246int mgmt_user_passkey_request(struct hci_dev *hdev, bdaddr_t *bdaddr,
1247			      u8 link_type, u8 addr_type);
1248int mgmt_user_passkey_reply_complete(struct hci_dev *hdev, bdaddr_t *bdaddr,
1249				     u8 link_type, u8 addr_type, u8 status);
1250int mgmt_user_passkey_neg_reply_complete(struct hci_dev *hdev, bdaddr_t *bdaddr,
1251					 u8 link_type, u8 addr_type, u8 status);
1252int mgmt_user_passkey_notify(struct hci_dev *hdev, bdaddr_t *bdaddr,
1253			     u8 link_type, u8 addr_type, u32 passkey,
1254			     u8 entered);
1255void mgmt_auth_failed(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 link_type,
1256		      u8 addr_type, u8 status);
1257void mgmt_auth_enable_complete(struct hci_dev *hdev, u8 status);
1258void mgmt_ssp_enable_complete(struct hci_dev *hdev, u8 enable, u8 status);
1259void mgmt_sc_enable_complete(struct hci_dev *hdev, u8 enable, u8 status);
1260void mgmt_set_class_of_dev_complete(struct hci_dev *hdev, u8 *dev_class,
1261				    u8 status);
1262void mgmt_set_local_name_complete(struct hci_dev *hdev, u8 *name, u8 status);
1263void mgmt_read_local_oob_data_complete(struct hci_dev *hdev, u8 *hash192,
1264				       u8 *randomizer192, u8 *hash256,
1265				       u8 *randomizer256, u8 status);
1266void mgmt_device_found(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 link_type,
1267		       u8 addr_type, u8 *dev_class, s8 rssi, u8 cfm_name,
1268		       u8 ssp, u8 *eir, u16 eir_len);
1269void mgmt_remote_name(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 link_type,
1270		      u8 addr_type, s8 rssi, u8 *name, u8 name_len);
1271void mgmt_discovering(struct hci_dev *hdev, u8 discovering);
1272int mgmt_device_blocked(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 type);
1273int mgmt_device_unblocked(struct hci_dev *hdev, bdaddr_t *bdaddr, u8 type);
1274void mgmt_new_ltk(struct hci_dev *hdev, struct smp_ltk *key, bool persistent);
1275void mgmt_new_irk(struct hci_dev *hdev, struct smp_irk *irk);
1276void mgmt_new_csrk(struct hci_dev *hdev, struct smp_csrk *csrk,
1277		   bool persistent);
1278void mgmt_reenable_advertising(struct hci_dev *hdev);
 
 
1279void mgmt_smp_complete(struct hci_conn *conn, bool complete);
 
 
 
 
 
 
 
 
1280
1281/* HCI info for socket */
1282#define hci_pi(sk) ((struct hci_pinfo *) sk)
1283
1284struct hci_pinfo {
1285	struct bt_sock    bt;
1286	struct hci_dev    *hdev;
1287	struct hci_filter filter;
1288	__u32             cmsg_mask;
1289	unsigned short   channel;
1290};
1291
1292/* HCI security filter */
1293#define HCI_SFLT_MAX_OGF  5
1294
1295struct hci_sec_filter {
1296	__u32 type_mask;
1297	__u32 event_mask[2];
1298	__u32 ocf_mask[HCI_SFLT_MAX_OGF + 1][4];
1299};
1300
1301/* ----- HCI requests ----- */
1302#define HCI_REQ_DONE	  0
1303#define HCI_REQ_PEND	  1
1304#define HCI_REQ_CANCELED  2
1305
1306#define hci_req_lock(d)		mutex_lock(&d->req_lock)
1307#define hci_req_unlock(d)	mutex_unlock(&d->req_lock)
1308
1309void hci_le_conn_update(struct hci_conn *conn, u16 min, u16 max,
1310					u16 latency, u16 to_multiplier);
1311void hci_le_start_enc(struct hci_conn *conn, __le16 ediv, __le64 rand,
1312							__u8 ltk[16]);
1313
1314int hci_update_random_address(struct hci_request *req, bool require_privacy,
1315			      u8 *own_addr_type);
1316void hci_copy_identity_address(struct hci_dev *hdev, bdaddr_t *bdaddr,
1317			       u8 *bdaddr_type);
1318
1319#define SCO_AIRMODE_MASK       0x0003
1320#define SCO_AIRMODE_CVSD       0x0000
1321#define SCO_AIRMODE_TRANSP     0x0003
1322
1323#endif /* __HCI_CORE_H */