xref: /openbmc/linux/net/bluetooth/hci_request.h (revision 867e6d38)
1 /*
2    BlueZ - Bluetooth protocol stack for Linux
3    Copyright (C) 2014 Intel Corporation
4 
5    This program is free software; you can redistribute it and/or modify
6    it under the terms of the GNU General Public License version 2 as
7    published by the Free Software Foundation;
8 
9    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
10    OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
11    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS.
12    IN NO EVENT SHALL THE COPYRIGHT HOLDER(S) AND AUTHOR(S) BE LIABLE FOR ANY
13    CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES
14    WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
15    ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
16    OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
17 
18    ALL LIABILITY, INCLUDING LIABILITY FOR INFRINGEMENT OF ANY PATENTS,
19    COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS, RELATING TO USE OF THIS
20    SOFTWARE IS DISCLAIMED.
21 */
22 
23 #include <asm/unaligned.h>
24 
25 #define hci_req_sync_lock(hdev)   mutex_lock(&hdev->req_lock)
26 #define hci_req_sync_unlock(hdev) mutex_unlock(&hdev->req_lock)
27 
28 struct hci_request {
29 	struct hci_dev		*hdev;
30 	struct sk_buff_head	cmd_q;
31 
32 	/* If something goes wrong when building the HCI request, the error
33 	 * value is stored in this field.
34 	 */
35 	int			err;
36 };
37 
38 void hci_req_init(struct hci_request *req, struct hci_dev *hdev);
39 void hci_req_purge(struct hci_request *req);
40 bool hci_req_status_pend(struct hci_dev *hdev);
41 int hci_req_run(struct hci_request *req, hci_req_complete_t complete);
42 int hci_req_run_skb(struct hci_request *req, hci_req_complete_skb_t complete);
43 void hci_req_add(struct hci_request *req, u16 opcode, u32 plen,
44 		 const void *param);
45 void hci_req_add_ev(struct hci_request *req, u16 opcode, u32 plen,
46 		    const void *param, u8 event);
47 void hci_req_cmd_complete(struct hci_dev *hdev, u16 opcode, u8 status,
48 			  hci_req_complete_t *req_complete,
49 			  hci_req_complete_skb_t *req_complete_skb);
50 
51 int hci_req_sync(struct hci_dev *hdev, int (*req)(struct hci_request *req,
52 						  unsigned long opt),
53 		 unsigned long opt, u32 timeout, u8 *hci_status);
54 int __hci_req_sync(struct hci_dev *hdev, int (*func)(struct hci_request *req,
55 						     unsigned long opt),
56 		   unsigned long opt, u32 timeout, u8 *hci_status);
57 void hci_req_sync_cancel(struct hci_dev *hdev, int err);
58 
59 struct sk_buff *hci_prepare_cmd(struct hci_dev *hdev, u16 opcode, u32 plen,
60 				const void *param);
61 
62 int __hci_req_hci_power_on(struct hci_dev *hdev);
63 
64 void __hci_req_write_fast_connectable(struct hci_request *req, bool enable);
65 void __hci_req_update_name(struct hci_request *req);
66 void __hci_req_update_eir(struct hci_request *req);
67 
68 void hci_req_add_le_scan_disable(struct hci_request *req, bool rpa_le_conn);
69 void hci_req_add_le_passive_scan(struct hci_request *req);
70 
71 void hci_req_prepare_suspend(struct hci_dev *hdev, enum suspended_state next);
72 
73 void hci_req_disable_address_resolution(struct hci_dev *hdev);
74 void __hci_req_pause_adv_instances(struct hci_request *req);
75 int hci_req_resume_adv_instances(struct hci_dev *hdev);
76 void hci_req_reenable_advertising(struct hci_dev *hdev);
77 void __hci_req_enable_advertising(struct hci_request *req);
78 void __hci_req_disable_advertising(struct hci_request *req);
79 void __hci_req_update_adv_data(struct hci_request *req, u8 instance);
80 int hci_req_update_adv_data(struct hci_dev *hdev, u8 instance);
81 void __hci_req_update_scan_rsp_data(struct hci_request *req, u8 instance);
82 
83 int __hci_req_schedule_adv_instance(struct hci_request *req, u8 instance,
84 				    bool force);
85 void hci_req_clear_adv_instance(struct hci_dev *hdev, struct sock *sk,
86 				struct hci_request *req, u8 instance,
87 				bool force);
88 
89 int __hci_req_setup_ext_adv_instance(struct hci_request *req, u8 instance);
90 int __hci_req_start_ext_adv(struct hci_request *req, u8 instance);
91 int __hci_req_enable_ext_advertising(struct hci_request *req, u8 instance);
92 int __hci_req_disable_ext_adv_instance(struct hci_request *req, u8 instance);
93 int __hci_req_remove_ext_adv_instance(struct hci_request *req, u8 instance);
94 void __hci_req_clear_ext_adv_sets(struct hci_request *req);
95 int hci_get_random_address(struct hci_dev *hdev, bool require_privacy,
96 			   bool use_rpa, struct adv_info *adv_instance,
97 			   u8 *own_addr_type, bdaddr_t *rand_addr);
98 
99 void __hci_req_update_class(struct hci_request *req);
100 
101 /* Returns true if HCI commands were queued */
102 bool hci_req_stop_discovery(struct hci_request *req);
103 
104 static inline void hci_req_update_scan(struct hci_dev *hdev)
105 {
106 	queue_work(hdev->req_workqueue, &hdev->scan_update);
107 }
108 
109 void __hci_req_update_scan(struct hci_request *req);
110 
111 int hci_update_random_address(struct hci_request *req, bool require_privacy,
112 			      bool use_rpa, u8 *own_addr_type);
113 
114 int hci_abort_conn(struct hci_conn *conn, u8 reason);
115 void __hci_abort_conn(struct hci_request *req, struct hci_conn *conn,
116 		      u8 reason);
117 
118 static inline void hci_update_background_scan(struct hci_dev *hdev)
119 {
120 	queue_work(hdev->req_workqueue, &hdev->bg_scan_update);
121 }
122 
123 void hci_request_setup(struct hci_dev *hdev);
124 void hci_request_cancel_all(struct hci_dev *hdev);
125 
126 u8 append_local_name(struct hci_dev *hdev, u8 *ptr, u8 ad_len);
127 
128 static inline u16 eir_append_data(u8 *eir, u16 eir_len, u8 type,
129 				  u8 *data, u8 data_len)
130 {
131 	eir[eir_len++] = sizeof(type) + data_len;
132 	eir[eir_len++] = type;
133 	memcpy(&eir[eir_len], data, data_len);
134 	eir_len += data_len;
135 
136 	return eir_len;
137 }
138 
139 static inline u16 eir_append_le16(u8 *eir, u16 eir_len, u8 type, u16 data)
140 {
141 	eir[eir_len++] = sizeof(type) + sizeof(data);
142 	eir[eir_len++] = type;
143 	put_unaligned_le16(data, &eir[eir_len]);
144 	eir_len += sizeof(data);
145 
146 	return eir_len;
147 }
148