xref: /linux/include/net/bluetooth/hci_sync.h (revision c532de5a67a70f8533d495f8f2aaa9a0491c3ad0)
1 /* SPDX-License-Identifier: GPL-2.0 */
2 /*
3  * BlueZ - Bluetooth protocol stack for Linux
4  *
5  * Copyright (C) 2021 Intel Corporation
6  */
7 
8 #define UINT_PTR(_handle)		((void *)((uintptr_t)_handle))
9 #define PTR_UINT(_ptr)			((uintptr_t)((void *)_ptr))
10 
11 #define HCI_REQ_DONE	  0
12 #define HCI_REQ_PEND	  1
13 #define HCI_REQ_CANCELED  2
14 
15 #define hci_req_sync_lock(hdev)   mutex_lock(&hdev->req_lock)
16 #define hci_req_sync_unlock(hdev) mutex_unlock(&hdev->req_lock)
17 
18 struct hci_request {
19 	struct hci_dev		*hdev;
20 	struct sk_buff_head	cmd_q;
21 
22 	/* If something goes wrong when building the HCI request, the error
23 	 * value is stored in this field.
24 	 */
25 	int			err;
26 };
27 
28 typedef int (*hci_cmd_sync_work_func_t)(struct hci_dev *hdev, void *data);
29 typedef void (*hci_cmd_sync_work_destroy_t)(struct hci_dev *hdev, void *data,
30 					    int err);
31 
32 struct hci_cmd_sync_work_entry {
33 	struct list_head list;
34 	hci_cmd_sync_work_func_t func;
35 	void *data;
36 	hci_cmd_sync_work_destroy_t destroy;
37 };
38 
39 struct adv_info;
40 
41 struct sk_buff *hci_cmd_sync_alloc(struct hci_dev *hdev, u16 opcode, u32 plen,
42 				   const void *param, struct sock *sk);
43 
44 /* Function with sync suffix shall not be called with hdev->lock held as they
45  * wait the command to complete and in the meantime an event could be received
46  * which could attempt to acquire hdev->lock causing a deadlock.
47  */
48 struct sk_buff *__hci_cmd_sync(struct hci_dev *hdev, u16 opcode, u32 plen,
49 			       const void *param, u32 timeout);
50 struct sk_buff *hci_cmd_sync(struct hci_dev *hdev, u16 opcode, u32 plen,
51 			     const void *param, u32 timeout);
52 struct sk_buff *__hci_cmd_sync_ev(struct hci_dev *hdev, u16 opcode, u32 plen,
53 				  const void *param, u8 event, u32 timeout);
54 struct sk_buff *__hci_cmd_sync_sk(struct hci_dev *hdev, u16 opcode, u32 plen,
55 				  const void *param, u8 event, u32 timeout,
56 				  struct sock *sk);
57 int __hci_cmd_sync_status(struct hci_dev *hdev, u16 opcode, u32 plen,
58 			  const void *param, u32 timeout);
59 int __hci_cmd_sync_status_sk(struct hci_dev *hdev, u16 opcode, u32 plen,
60 			     const void *param, u8 event, u32 timeout,
61 			     struct sock *sk);
62 int hci_cmd_sync_status(struct hci_dev *hdev, u16 opcode, u32 plen,
63 			const void *param, u32 timeout);
64 
65 void hci_cmd_sync_init(struct hci_dev *hdev);
66 void hci_cmd_sync_clear(struct hci_dev *hdev);
67 void hci_cmd_sync_cancel(struct hci_dev *hdev, int err);
68 void hci_cmd_sync_cancel_sync(struct hci_dev *hdev, int err);
69 
70 int hci_cmd_sync_submit(struct hci_dev *hdev, hci_cmd_sync_work_func_t func,
71 			void *data, hci_cmd_sync_work_destroy_t destroy);
72 int hci_cmd_sync_queue(struct hci_dev *hdev, hci_cmd_sync_work_func_t func,
73 		       void *data, hci_cmd_sync_work_destroy_t destroy);
74 int hci_cmd_sync_queue_once(struct hci_dev *hdev, hci_cmd_sync_work_func_t func,
75 			    void *data, hci_cmd_sync_work_destroy_t destroy);
76 int hci_cmd_sync_run(struct hci_dev *hdev, hci_cmd_sync_work_func_t func,
77 		     void *data, hci_cmd_sync_work_destroy_t destroy);
78 int hci_cmd_sync_run_once(struct hci_dev *hdev, hci_cmd_sync_work_func_t func,
79 			  void *data, hci_cmd_sync_work_destroy_t destroy);
80 struct hci_cmd_sync_work_entry *
81 hci_cmd_sync_lookup_entry(struct hci_dev *hdev, hci_cmd_sync_work_func_t func,
82 			  void *data, hci_cmd_sync_work_destroy_t destroy);
83 void hci_cmd_sync_cancel_entry(struct hci_dev *hdev,
84 			       struct hci_cmd_sync_work_entry *entry);
85 bool hci_cmd_sync_dequeue(struct hci_dev *hdev, hci_cmd_sync_work_func_t func,
86 			  void *data, hci_cmd_sync_work_destroy_t destroy);
87 bool hci_cmd_sync_dequeue_once(struct hci_dev *hdev,
88 			      hci_cmd_sync_work_func_t func, void *data,
89 			      hci_cmd_sync_work_destroy_t destroy);
90 
91 int hci_update_eir_sync(struct hci_dev *hdev);
92 int hci_update_class_sync(struct hci_dev *hdev);
93 
94 int hci_update_eir_sync(struct hci_dev *hdev);
95 int hci_update_class_sync(struct hci_dev *hdev);
96 int hci_update_name_sync(struct hci_dev *hdev);
97 int hci_write_ssp_mode_sync(struct hci_dev *hdev, u8 mode);
98 
99 int hci_get_random_address(struct hci_dev *hdev, bool require_privacy,
100 			   bool use_rpa, struct adv_info *adv_instance,
101 			   u8 *own_addr_type, bdaddr_t *rand_addr);
102 
103 int hci_update_random_address_sync(struct hci_dev *hdev, bool require_privacy,
104 				   bool rpa, u8 *own_addr_type);
105 
106 int hci_update_scan_rsp_data_sync(struct hci_dev *hdev, u8 instance);
107 int hci_update_adv_data_sync(struct hci_dev *hdev, u8 instance);
108 int hci_update_adv_data(struct hci_dev *hdev, u8 instance);
109 int hci_schedule_adv_instance_sync(struct hci_dev *hdev, u8 instance,
110 				   bool force);
111 
112 int hci_setup_ext_adv_instance_sync(struct hci_dev *hdev, u8 instance);
113 int hci_start_ext_adv_sync(struct hci_dev *hdev, u8 instance);
114 int hci_enable_ext_advertising_sync(struct hci_dev *hdev, u8 instance);
115 int hci_enable_advertising_sync(struct hci_dev *hdev);
116 int hci_enable_advertising(struct hci_dev *hdev);
117 
118 int hci_start_per_adv_sync(struct hci_dev *hdev, u8 instance, u8 data_len,
119 			   u8 *data, u32 flags, u16 min_interval,
120 			   u16 max_interval, u16 sync_interval);
121 
122 int hci_disable_per_advertising_sync(struct hci_dev *hdev, u8 instance);
123 
124 int hci_remove_advertising_sync(struct hci_dev *hdev, struct sock *sk,
125 				u8 instance, bool force);
126 int hci_disable_advertising_sync(struct hci_dev *hdev);
127 int hci_clear_adv_instance_sync(struct hci_dev *hdev, struct sock *sk,
128 				u8 instance, bool force);
129 int hci_update_passive_scan_sync(struct hci_dev *hdev);
130 int hci_update_passive_scan(struct hci_dev *hdev);
131 int hci_read_rssi_sync(struct hci_dev *hdev, __le16 handle);
132 int hci_read_tx_power_sync(struct hci_dev *hdev, __le16 handle, u8 type);
133 int hci_write_sc_support_sync(struct hci_dev *hdev, u8 val);
134 int hci_read_clock_sync(struct hci_dev *hdev, struct hci_cp_read_clock *cp);
135 
136 int hci_write_fast_connectable_sync(struct hci_dev *hdev, bool enable);
137 int hci_update_scan_sync(struct hci_dev *hdev);
138 int hci_update_scan(struct hci_dev *hdev);
139 
140 int hci_write_le_host_supported_sync(struct hci_dev *hdev, u8 le, u8 simul);
141 int hci_remove_ext_adv_instance_sync(struct hci_dev *hdev, u8 instance,
142 				     struct sock *sk);
143 int hci_remove_ext_adv_instance(struct hci_dev *hdev, u8 instance);
144 struct sk_buff *hci_read_local_oob_data_sync(struct hci_dev *hdev, bool ext,
145 					     struct sock *sk);
146 
147 int hci_reset_sync(struct hci_dev *hdev);
148 int hci_dev_open_sync(struct hci_dev *hdev);
149 int hci_dev_close_sync(struct hci_dev *hdev);
150 
151 int hci_powered_update_sync(struct hci_dev *hdev);
152 int hci_set_powered_sync(struct hci_dev *hdev, u8 val);
153 
154 int hci_update_discoverable_sync(struct hci_dev *hdev);
155 int hci_update_discoverable(struct hci_dev *hdev);
156 
157 int hci_update_connectable_sync(struct hci_dev *hdev);
158 
159 int hci_inquiry_sync(struct hci_dev *hdev, u8 length, u8 num_rsp);
160 
161 int hci_start_discovery_sync(struct hci_dev *hdev);
162 int hci_stop_discovery_sync(struct hci_dev *hdev);
163 
164 int hci_suspend_sync(struct hci_dev *hdev);
165 int hci_resume_sync(struct hci_dev *hdev);
166 
167 struct hci_conn;
168 struct hci_conn_params;
169 
170 int hci_abort_conn_sync(struct hci_dev *hdev, struct hci_conn *conn, u8 reason);
171 
172 int hci_le_create_cis_sync(struct hci_dev *hdev);
173 
174 int hci_le_remove_cig_sync(struct hci_dev *hdev, u8 handle);
175 
176 int hci_le_terminate_big_sync(struct hci_dev *hdev, u8 handle, u8 reason);
177 
178 int hci_le_big_terminate_sync(struct hci_dev *hdev, u8 handle);
179 
180 int hci_le_pa_terminate_sync(struct hci_dev *hdev, u16 handle);
181 
182 int hci_connect_acl_sync(struct hci_dev *hdev, struct hci_conn *conn);
183 
184 int hci_connect_le_sync(struct hci_dev *hdev, struct hci_conn *conn);
185 
186 int hci_cancel_connect_sync(struct hci_dev *hdev, struct hci_conn *conn);
187 int hci_le_conn_update_sync(struct hci_dev *hdev, struct hci_conn *conn,
188 			    struct hci_conn_params *params);
189