2 BlueZ - Bluetooth protocol stack for Linux
3 Copyright (c) 2000-2001, 2010, Code Aurora Forum. All rights reserved.
5 Written 2000,2001 by Maxim Krasnyansky <maxk@qualcomm.com>
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License version 2 as
9 published by the Free Software Foundation;
11 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
12 OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
13 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS.
14 IN NO EVENT SHALL THE COPYRIGHT HOLDER(S) AND AUTHOR(S) BE LIABLE FOR ANY
15 CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES
16 WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
17 ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
18 OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
20 ALL LIABILITY, INCLUDING LIABILITY FOR INFRINGEMENT OF ANY PATENTS,
21 COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS, RELATING TO USE OF THIS
22 SOFTWARE IS DISCLAIMED.
28 #include <net/bluetooth/hci.h>
30 /* HCI upper protocols */
31 #define HCI_PROTO_L2CAP 0
32 #define HCI_PROTO_SCO 1
34 /* HCI Core structures */
38 __u8 pscan_period_mode
;
46 struct inquiry_entry
{
47 struct inquiry_entry
*next
;
49 struct inquiry_data data
;
52 struct inquiry_cache
{
55 struct inquiry_entry
*list
;
58 struct hci_conn_hash
{
59 struct list_head list
;
66 struct list_head list
;
69 #define NUM_REASSEMBLY 4
71 struct list_head list
;
97 __u16 sniff_min_interval
;
98 __u16 sniff_max_interval
;
100 unsigned long quirks
;
103 unsigned int acl_cnt
;
104 unsigned int sco_cnt
;
106 unsigned int acl_mtu
;
107 unsigned int sco_mtu
;
108 unsigned int acl_pkts
;
109 unsigned int sco_pkts
;
111 unsigned long cmd_last_tx
;
112 unsigned long acl_last_tx
;
113 unsigned long sco_last_tx
;
115 struct workqueue_struct
*workqueue
;
117 struct work_struct power_on
;
118 struct work_struct power_off
;
119 struct timer_list off_timer
;
121 struct tasklet_struct cmd_task
;
122 struct tasklet_struct rx_task
;
123 struct tasklet_struct tx_task
;
125 struct sk_buff_head rx_q
;
126 struct sk_buff_head raw_q
;
127 struct sk_buff_head cmd_q
;
129 struct sk_buff
*sent_cmd
;
130 struct sk_buff
*reassembly
[NUM_REASSEMBLY
];
132 struct mutex req_lock
;
133 wait_queue_head_t req_wait_q
;
138 struct inquiry_cache inq_cache
;
139 struct hci_conn_hash conn_hash
;
140 struct list_head blacklist
;
142 struct hci_dev_stats stat
;
144 struct sk_buff_head driver_init
;
151 struct dentry
*debugfs
;
153 struct device
*parent
;
156 struct rfkill
*rfkill
;
158 struct module
*owner
;
160 int (*open
)(struct hci_dev
*hdev
);
161 int (*close
)(struct hci_dev
*hdev
);
162 int (*flush
)(struct hci_dev
*hdev
);
163 int (*send
)(struct sk_buff
*skb
);
164 void (*destruct
)(struct hci_dev
*hdev
);
165 void (*notify
)(struct hci_dev
*hdev
, unsigned int evt
);
166 int (*ioctl
)(struct hci_dev
*hdev
, unsigned int cmd
, unsigned long arg
);
170 struct list_head list
;
191 __u8 pending_sec_level
;
198 struct sk_buff_head data_q
;
200 struct timer_list disc_timer
;
201 struct timer_list idle_timer
;
203 struct work_struct work_add
;
204 struct work_struct work_del
;
209 struct hci_dev
*hdev
;
214 struct hci_conn
*link
;
217 extern struct hci_proto
*hci_proto
[];
218 extern struct list_head hci_dev_list
;
219 extern struct list_head hci_cb_list
;
220 extern rwlock_t hci_dev_list_lock
;
221 extern rwlock_t hci_cb_list_lock
;
223 /* ----- Inquiry cache ----- */
224 #define INQUIRY_CACHE_AGE_MAX (HZ*30) /* 30 seconds */
225 #define INQUIRY_ENTRY_AGE_MAX (HZ*60) /* 60 seconds */
227 #define inquiry_cache_lock(c) spin_lock(&c->lock)
228 #define inquiry_cache_unlock(c) spin_unlock(&c->lock)
229 #define inquiry_cache_lock_bh(c) spin_lock_bh(&c->lock)
230 #define inquiry_cache_unlock_bh(c) spin_unlock_bh(&c->lock)
232 static inline void inquiry_cache_init(struct hci_dev
*hdev
)
234 struct inquiry_cache
*c
= &hdev
->inq_cache
;
235 spin_lock_init(&c
->lock
);
239 static inline int inquiry_cache_empty(struct hci_dev
*hdev
)
241 struct inquiry_cache
*c
= &hdev
->inq_cache
;
242 return c
->list
== NULL
;
245 static inline long inquiry_cache_age(struct hci_dev
*hdev
)
247 struct inquiry_cache
*c
= &hdev
->inq_cache
;
248 return jiffies
- c
->timestamp
;
251 static inline long inquiry_entry_age(struct inquiry_entry
*e
)
253 return jiffies
- e
->timestamp
;
256 struct inquiry_entry
*hci_inquiry_cache_lookup(struct hci_dev
*hdev
, bdaddr_t
*bdaddr
);
257 void hci_inquiry_cache_update(struct hci_dev
*hdev
, struct inquiry_data
*data
);
259 /* ----- HCI Connections ----- */
262 HCI_CONN_ENCRYPT_PEND
,
263 HCI_CONN_RSWITCH_PEND
,
264 HCI_CONN_MODE_CHANGE_PEND
,
265 HCI_CONN_SCO_SETUP_PEND
,
268 static inline void hci_conn_hash_init(struct hci_dev
*hdev
)
270 struct hci_conn_hash
*h
= &hdev
->conn_hash
;
271 INIT_LIST_HEAD(&h
->list
);
272 spin_lock_init(&h
->lock
);
277 static inline void hci_conn_hash_add(struct hci_dev
*hdev
, struct hci_conn
*c
)
279 struct hci_conn_hash
*h
= &hdev
->conn_hash
;
280 list_add(&c
->list
, &h
->list
);
281 if (c
->type
== ACL_LINK
)
287 static inline void hci_conn_hash_del(struct hci_dev
*hdev
, struct hci_conn
*c
)
289 struct hci_conn_hash
*h
= &hdev
->conn_hash
;
291 if (c
->type
== ACL_LINK
)
297 static inline struct hci_conn
*hci_conn_hash_lookup_handle(struct hci_dev
*hdev
,
300 struct hci_conn_hash
*h
= &hdev
->conn_hash
;
304 list_for_each(p
, &h
->list
) {
305 c
= list_entry(p
, struct hci_conn
, list
);
306 if (c
->handle
== handle
)
312 static inline struct hci_conn
*hci_conn_hash_lookup_ba(struct hci_dev
*hdev
,
313 __u8 type
, bdaddr_t
*ba
)
315 struct hci_conn_hash
*h
= &hdev
->conn_hash
;
319 list_for_each(p
, &h
->list
) {
320 c
= list_entry(p
, struct hci_conn
, list
);
321 if (c
->type
== type
&& !bacmp(&c
->dst
, ba
))
327 static inline struct hci_conn
*hci_conn_hash_lookup_state(struct hci_dev
*hdev
,
328 __u8 type
, __u16 state
)
330 struct hci_conn_hash
*h
= &hdev
->conn_hash
;
334 list_for_each(p
, &h
->list
) {
335 c
= list_entry(p
, struct hci_conn
, list
);
336 if (c
->type
== type
&& c
->state
== state
)
342 void hci_acl_connect(struct hci_conn
*conn
);
343 void hci_acl_disconn(struct hci_conn
*conn
, __u8 reason
);
344 void hci_add_sco(struct hci_conn
*conn
, __u16 handle
);
345 void hci_setup_sync(struct hci_conn
*conn
, __u16 handle
);
346 void hci_sco_setup(struct hci_conn
*conn
, __u8 status
);
348 struct hci_conn
*hci_conn_add(struct hci_dev
*hdev
, int type
, bdaddr_t
*dst
);
349 int hci_conn_del(struct hci_conn
*conn
);
350 void hci_conn_hash_flush(struct hci_dev
*hdev
);
351 void hci_conn_check_pending(struct hci_dev
*hdev
);
353 struct hci_conn
*hci_connect(struct hci_dev
*hdev
, int type
, bdaddr_t
*dst
, __u8 sec_level
, __u8 auth_type
);
354 int hci_conn_check_link_mode(struct hci_conn
*conn
);
355 int hci_conn_security(struct hci_conn
*conn
, __u8 sec_level
, __u8 auth_type
);
356 int hci_conn_change_link_key(struct hci_conn
*conn
);
357 int hci_conn_switch_role(struct hci_conn
*conn
, __u8 role
);
359 void hci_conn_enter_active_mode(struct hci_conn
*conn
);
360 void hci_conn_enter_sniff_mode(struct hci_conn
*conn
);
362 void hci_conn_hold_device(struct hci_conn
*conn
);
363 void hci_conn_put_device(struct hci_conn
*conn
);
365 static inline void hci_conn_hold(struct hci_conn
*conn
)
367 atomic_inc(&conn
->refcnt
);
368 del_timer(&conn
->disc_timer
);
371 static inline void hci_conn_put(struct hci_conn
*conn
)
373 if (atomic_dec_and_test(&conn
->refcnt
)) {
375 if (conn
->type
== ACL_LINK
) {
376 del_timer(&conn
->idle_timer
);
377 if (conn
->state
== BT_CONNECTED
) {
378 timeo
= msecs_to_jiffies(conn
->disc_timeout
);
382 timeo
= msecs_to_jiffies(10);
384 timeo
= msecs_to_jiffies(10);
385 mod_timer(&conn
->disc_timer
, jiffies
+ timeo
);
389 /* ----- HCI Devices ----- */
390 static inline void __hci_dev_put(struct hci_dev
*d
)
392 if (atomic_dec_and_test(&d
->refcnt
))
396 static inline void hci_dev_put(struct hci_dev
*d
)
399 module_put(d
->owner
);
402 static inline struct hci_dev
*__hci_dev_hold(struct hci_dev
*d
)
404 atomic_inc(&d
->refcnt
);
408 static inline struct hci_dev
*hci_dev_hold(struct hci_dev
*d
)
410 if (try_module_get(d
->owner
))
411 return __hci_dev_hold(d
);
415 #define hci_dev_lock(d) spin_lock(&d->lock)
416 #define hci_dev_unlock(d) spin_unlock(&d->lock)
417 #define hci_dev_lock_bh(d) spin_lock_bh(&d->lock)
418 #define hci_dev_unlock_bh(d) spin_unlock_bh(&d->lock)
420 struct hci_dev
*hci_dev_get(int index
);
421 struct hci_dev
*hci_get_route(bdaddr_t
*src
, bdaddr_t
*dst
);
423 struct hci_dev
*hci_alloc_dev(void);
424 void hci_free_dev(struct hci_dev
*hdev
);
425 int hci_register_dev(struct hci_dev
*hdev
);
426 int hci_unregister_dev(struct hci_dev
*hdev
);
427 int hci_suspend_dev(struct hci_dev
*hdev
);
428 int hci_resume_dev(struct hci_dev
*hdev
);
429 int hci_dev_open(__u16 dev
);
430 int hci_dev_close(__u16 dev
);
431 int hci_dev_reset(__u16 dev
);
432 int hci_dev_reset_stat(__u16 dev
);
433 int hci_dev_cmd(unsigned int cmd
, void __user
*arg
);
434 int hci_get_dev_list(void __user
*arg
);
435 int hci_get_dev_info(void __user
*arg
);
436 int hci_get_conn_list(void __user
*arg
);
437 int hci_get_conn_info(struct hci_dev
*hdev
, void __user
*arg
);
438 int hci_get_auth_info(struct hci_dev
*hdev
, void __user
*arg
);
439 int hci_inquiry(void __user
*arg
);
441 struct bdaddr_list
*hci_blacklist_lookup(struct hci_dev
*hdev
, bdaddr_t
*bdaddr
);
442 int hci_blacklist_clear(struct hci_dev
*hdev
);
444 void hci_del_off_timer(struct hci_dev
*hdev
);
446 void hci_event_packet(struct hci_dev
*hdev
, struct sk_buff
*skb
);
448 int hci_recv_frame(struct sk_buff
*skb
);
449 int hci_recv_fragment(struct hci_dev
*hdev
, int type
, void *data
, int count
);
450 int hci_recv_stream_fragment(struct hci_dev
*hdev
, void *data
, int count
);
452 int hci_register_sysfs(struct hci_dev
*hdev
);
453 void hci_unregister_sysfs(struct hci_dev
*hdev
);
454 void hci_conn_init_sysfs(struct hci_conn
*conn
);
455 void hci_conn_add_sysfs(struct hci_conn
*conn
);
456 void hci_conn_del_sysfs(struct hci_conn
*conn
);
458 #define SET_HCIDEV_DEV(hdev, pdev) ((hdev)->parent = (pdev))
460 /* ----- LMP capabilities ----- */
461 #define lmp_rswitch_capable(dev) ((dev)->features[0] & LMP_RSWITCH)
462 #define lmp_encrypt_capable(dev) ((dev)->features[0] & LMP_ENCRYPT)
463 #define lmp_sniff_capable(dev) ((dev)->features[0] & LMP_SNIFF)
464 #define lmp_sniffsubr_capable(dev) ((dev)->features[5] & LMP_SNIFF_SUBR)
465 #define lmp_esco_capable(dev) ((dev)->features[3] & LMP_ESCO)
466 #define lmp_ssp_capable(dev) ((dev)->features[6] & LMP_SIMPLE_PAIR)
467 #define lmp_no_flush_capable(dev) ((dev)->features[6] & LMP_NO_FLUSH)
469 /* ----- HCI protocols ----- */
477 int (*connect_ind
) (struct hci_dev
*hdev
, bdaddr_t
*bdaddr
, __u8 type
);
478 int (*connect_cfm
) (struct hci_conn
*conn
, __u8 status
);
479 int (*disconn_ind
) (struct hci_conn
*conn
);
480 int (*disconn_cfm
) (struct hci_conn
*conn
, __u8 reason
);
481 int (*recv_acldata
) (struct hci_conn
*conn
, struct sk_buff
*skb
, __u16 flags
);
482 int (*recv_scodata
) (struct hci_conn
*conn
, struct sk_buff
*skb
);
483 int (*security_cfm
) (struct hci_conn
*conn
, __u8 status
, __u8 encrypt
);
486 static inline int hci_proto_connect_ind(struct hci_dev
*hdev
, bdaddr_t
*bdaddr
, __u8 type
)
488 register struct hci_proto
*hp
;
491 hp
= hci_proto
[HCI_PROTO_L2CAP
];
492 if (hp
&& hp
->connect_ind
)
493 mask
|= hp
->connect_ind(hdev
, bdaddr
, type
);
495 hp
= hci_proto
[HCI_PROTO_SCO
];
496 if (hp
&& hp
->connect_ind
)
497 mask
|= hp
->connect_ind(hdev
, bdaddr
, type
);
502 static inline void hci_proto_connect_cfm(struct hci_conn
*conn
, __u8 status
)
504 register struct hci_proto
*hp
;
506 hp
= hci_proto
[HCI_PROTO_L2CAP
];
507 if (hp
&& hp
->connect_cfm
)
508 hp
->connect_cfm(conn
, status
);
510 hp
= hci_proto
[HCI_PROTO_SCO
];
511 if (hp
&& hp
->connect_cfm
)
512 hp
->connect_cfm(conn
, status
);
515 static inline int hci_proto_disconn_ind(struct hci_conn
*conn
)
517 register struct hci_proto
*hp
;
520 hp
= hci_proto
[HCI_PROTO_L2CAP
];
521 if (hp
&& hp
->disconn_ind
)
522 reason
= hp
->disconn_ind(conn
);
524 hp
= hci_proto
[HCI_PROTO_SCO
];
525 if (hp
&& hp
->disconn_ind
)
526 reason
= hp
->disconn_ind(conn
);
531 static inline void hci_proto_disconn_cfm(struct hci_conn
*conn
, __u8 reason
)
533 register struct hci_proto
*hp
;
535 hp
= hci_proto
[HCI_PROTO_L2CAP
];
536 if (hp
&& hp
->disconn_cfm
)
537 hp
->disconn_cfm(conn
, reason
);
539 hp
= hci_proto
[HCI_PROTO_SCO
];
540 if (hp
&& hp
->disconn_cfm
)
541 hp
->disconn_cfm(conn
, reason
);
544 static inline void hci_proto_auth_cfm(struct hci_conn
*conn
, __u8 status
)
546 register struct hci_proto
*hp
;
549 if (test_bit(HCI_CONN_ENCRYPT_PEND
, &conn
->pend
))
552 encrypt
= (conn
->link_mode
& HCI_LM_ENCRYPT
) ? 0x01 : 0x00;
554 hp
= hci_proto
[HCI_PROTO_L2CAP
];
555 if (hp
&& hp
->security_cfm
)
556 hp
->security_cfm(conn
, status
, encrypt
);
558 hp
= hci_proto
[HCI_PROTO_SCO
];
559 if (hp
&& hp
->security_cfm
)
560 hp
->security_cfm(conn
, status
, encrypt
);
563 static inline void hci_proto_encrypt_cfm(struct hci_conn
*conn
, __u8 status
, __u8 encrypt
)
565 register struct hci_proto
*hp
;
567 hp
= hci_proto
[HCI_PROTO_L2CAP
];
568 if (hp
&& hp
->security_cfm
)
569 hp
->security_cfm(conn
, status
, encrypt
);
571 hp
= hci_proto
[HCI_PROTO_SCO
];
572 if (hp
&& hp
->security_cfm
)
573 hp
->security_cfm(conn
, status
, encrypt
);
576 int hci_register_proto(struct hci_proto
*hproto
);
577 int hci_unregister_proto(struct hci_proto
*hproto
);
579 /* ----- HCI callbacks ----- */
581 struct list_head list
;
585 void (*security_cfm
) (struct hci_conn
*conn
, __u8 status
, __u8 encrypt
);
586 void (*key_change_cfm
) (struct hci_conn
*conn
, __u8 status
);
587 void (*role_switch_cfm
) (struct hci_conn
*conn
, __u8 status
, __u8 role
);
590 static inline void hci_auth_cfm(struct hci_conn
*conn
, __u8 status
)
595 hci_proto_auth_cfm(conn
, status
);
597 if (test_bit(HCI_CONN_ENCRYPT_PEND
, &conn
->pend
))
600 encrypt
= (conn
->link_mode
& HCI_LM_ENCRYPT
) ? 0x01 : 0x00;
602 read_lock_bh(&hci_cb_list_lock
);
603 list_for_each(p
, &hci_cb_list
) {
604 struct hci_cb
*cb
= list_entry(p
, struct hci_cb
, list
);
605 if (cb
->security_cfm
)
606 cb
->security_cfm(conn
, status
, encrypt
);
608 read_unlock_bh(&hci_cb_list_lock
);
611 static inline void hci_encrypt_cfm(struct hci_conn
*conn
, __u8 status
, __u8 encrypt
)
615 if (conn
->sec_level
== BT_SECURITY_SDP
)
616 conn
->sec_level
= BT_SECURITY_LOW
;
618 hci_proto_encrypt_cfm(conn
, status
, encrypt
);
620 read_lock_bh(&hci_cb_list_lock
);
621 list_for_each(p
, &hci_cb_list
) {
622 struct hci_cb
*cb
= list_entry(p
, struct hci_cb
, list
);
623 if (cb
->security_cfm
)
624 cb
->security_cfm(conn
, status
, encrypt
);
626 read_unlock_bh(&hci_cb_list_lock
);
629 static inline void hci_key_change_cfm(struct hci_conn
*conn
, __u8 status
)
633 read_lock_bh(&hci_cb_list_lock
);
634 list_for_each(p
, &hci_cb_list
) {
635 struct hci_cb
*cb
= list_entry(p
, struct hci_cb
, list
);
636 if (cb
->key_change_cfm
)
637 cb
->key_change_cfm(conn
, status
);
639 read_unlock_bh(&hci_cb_list_lock
);
642 static inline void hci_role_switch_cfm(struct hci_conn
*conn
, __u8 status
, __u8 role
)
646 read_lock_bh(&hci_cb_list_lock
);
647 list_for_each(p
, &hci_cb_list
) {
648 struct hci_cb
*cb
= list_entry(p
, struct hci_cb
, list
);
649 if (cb
->role_switch_cfm
)
650 cb
->role_switch_cfm(conn
, status
, role
);
652 read_unlock_bh(&hci_cb_list_lock
);
655 int hci_register_cb(struct hci_cb
*hcb
);
656 int hci_unregister_cb(struct hci_cb
*hcb
);
658 int hci_register_notifier(struct notifier_block
*nb
);
659 int hci_unregister_notifier(struct notifier_block
*nb
);
661 int hci_send_cmd(struct hci_dev
*hdev
, __u16 opcode
, __u32 plen
, void *param
);
662 void hci_send_acl(struct hci_conn
*conn
, struct sk_buff
*skb
, __u16 flags
);
663 void hci_send_sco(struct hci_conn
*conn
, struct sk_buff
*skb
);
665 void *hci_sent_cmd_data(struct hci_dev
*hdev
, __u16 opcode
);
667 void hci_si_event(struct hci_dev
*hdev
, int type
, int dlen
, void *data
);
669 /* ----- HCI Sockets ----- */
670 void hci_send_to_sock(struct hci_dev
*hdev
, struct sk_buff
*skb
,
671 struct sock
*skip_sk
);
673 /* Management interface */
674 int mgmt_control(struct sock
*sk
, struct msghdr
*msg
, size_t len
);
675 int mgmt_index_added(u16 index
);
676 int mgmt_index_removed(u16 index
);
677 int mgmt_powered(u16 index
, u8 powered
);
679 /* HCI info for socket */
680 #define hci_pi(sk) ((struct hci_pinfo *) sk)
684 struct hci_dev
*hdev
;
685 struct hci_filter filter
;
687 unsigned short channel
;
690 /* HCI security filter */
691 #define HCI_SFLT_MAX_OGF 5
693 struct hci_sec_filter
{
696 __u32 ocf_mask
[HCI_SFLT_MAX_OGF
+ 1][4];
699 /* ----- HCI requests ----- */
700 #define HCI_REQ_DONE 0
701 #define HCI_REQ_PEND 1
702 #define HCI_REQ_CANCELED 2
704 #define hci_req_lock(d) mutex_lock(&d->req_lock)
705 #define hci_req_unlock(d) mutex_unlock(&d->req_lock)
707 void hci_req_complete(struct hci_dev
*hdev
, __u16 cmd
, int result
);
709 #endif /* __HCI_CORE_H */