xref: /linux/include/net/bluetooth/hci_sync.h (revision 92048ab2e2e6cc90ad1cc9f55deb5cec4d731793)
16a98e383SMarcel Holtmann /* SPDX-License-Identifier: GPL-2.0 */
26a98e383SMarcel Holtmann /*
36a98e383SMarcel Holtmann  * BlueZ - Bluetooth protocol stack for Linux
46a98e383SMarcel Holtmann  *
56a98e383SMarcel Holtmann  * Copyright (C) 2021 Intel Corporation
66a98e383SMarcel Holtmann  */
76a98e383SMarcel Holtmann 
8a1f6c3aeSLuiz Augusto von Dentz #define UINT_PTR(_handle)		((void *)((uintptr_t)_handle))
9a1f6c3aeSLuiz Augusto von Dentz #define PTR_UINT(_ptr)			((uintptr_t)((void *)_ptr))
10a1f6c3aeSLuiz Augusto von Dentz 
116a98e383SMarcel Holtmann typedef int (*hci_cmd_sync_work_func_t)(struct hci_dev *hdev, void *data);
126a98e383SMarcel Holtmann typedef void (*hci_cmd_sync_work_destroy_t)(struct hci_dev *hdev, void *data,
136a98e383SMarcel Holtmann 					    int err);
146a98e383SMarcel Holtmann 
156a98e383SMarcel Holtmann struct hci_cmd_sync_work_entry {
166a98e383SMarcel Holtmann 	struct list_head list;
176a98e383SMarcel Holtmann 	hci_cmd_sync_work_func_t func;
186a98e383SMarcel Holtmann 	void *data;
196a98e383SMarcel Holtmann 	hci_cmd_sync_work_destroy_t destroy;
206a98e383SMarcel Holtmann };
216a98e383SMarcel Holtmann 
223fe318eeSBrian Gix struct adv_info;
236a98e383SMarcel Holtmann /* Function with sync suffix shall not be called with hdev->lock held as they
246a98e383SMarcel Holtmann  * wait the command to complete and in the meantime an event could be received
256a98e383SMarcel Holtmann  * which could attempt to acquire hdev->lock causing a deadlock.
266a98e383SMarcel Holtmann  */
276a98e383SMarcel Holtmann struct sk_buff *__hci_cmd_sync(struct hci_dev *hdev, u16 opcode, u32 plen,
286a98e383SMarcel Holtmann 			       const void *param, u32 timeout);
296a98e383SMarcel Holtmann struct sk_buff *hci_cmd_sync(struct hci_dev *hdev, u16 opcode, u32 plen,
306a98e383SMarcel Holtmann 			     const void *param, u32 timeout);
316a98e383SMarcel Holtmann struct sk_buff *__hci_cmd_sync_ev(struct hci_dev *hdev, u16 opcode, u32 plen,
326a98e383SMarcel Holtmann 				  const void *param, u8 event, u32 timeout);
336a98e383SMarcel Holtmann struct sk_buff *__hci_cmd_sync_sk(struct hci_dev *hdev, u16 opcode, u32 plen,
346a98e383SMarcel Holtmann 				  const void *param, u8 event, u32 timeout,
356a98e383SMarcel Holtmann 				  struct sock *sk);
366a98e383SMarcel Holtmann int __hci_cmd_sync_status(struct hci_dev *hdev, u16 opcode, u32 plen,
376a98e383SMarcel Holtmann 			  const void *param, u32 timeout);
386a98e383SMarcel Holtmann int __hci_cmd_sync_status_sk(struct hci_dev *hdev, u16 opcode, u32 plen,
396a98e383SMarcel Holtmann 			     const void *param, u8 event, u32 timeout,
406a98e383SMarcel Holtmann 			     struct sock *sk);
41f1a8f402SLuiz Augusto von Dentz int hci_cmd_sync_status(struct hci_dev *hdev, u16 opcode, u32 plen,
42f1a8f402SLuiz Augusto von Dentz 			const void *param, u32 timeout);
436a98e383SMarcel Holtmann 
446a98e383SMarcel Holtmann void hci_cmd_sync_init(struct hci_dev *hdev);
456a98e383SMarcel Holtmann void hci_cmd_sync_clear(struct hci_dev *hdev);
46914b08b3SBenjamin Berg void hci_cmd_sync_cancel(struct hci_dev *hdev, int err);
4763298d6eSLuiz Augusto von Dentz void hci_cmd_sync_cancel_sync(struct hci_dev *hdev, int err);
486a98e383SMarcel Holtmann 
49d883a466SLuiz Augusto von Dentz int hci_cmd_sync_submit(struct hci_dev *hdev, hci_cmd_sync_work_func_t func,
50d883a466SLuiz Augusto von Dentz 			void *data, hci_cmd_sync_work_destroy_t destroy);
516a98e383SMarcel Holtmann int hci_cmd_sync_queue(struct hci_dev *hdev, hci_cmd_sync_work_func_t func,
526a98e383SMarcel Holtmann 		       void *data, hci_cmd_sync_work_destroy_t destroy);
53881559afSLuiz Augusto von Dentz int hci_cmd_sync_queue_once(struct hci_dev *hdev, hci_cmd_sync_work_func_t func,
54881559afSLuiz Augusto von Dentz 			    void *data, hci_cmd_sync_work_destroy_t destroy);
55505ea2b2SLuiz Augusto von Dentz struct hci_cmd_sync_work_entry *
56505ea2b2SLuiz Augusto von Dentz hci_cmd_sync_lookup_entry(struct hci_dev *hdev, hci_cmd_sync_work_func_t func,
57505ea2b2SLuiz Augusto von Dentz 			  void *data, hci_cmd_sync_work_destroy_t destroy);
58505ea2b2SLuiz Augusto von Dentz void hci_cmd_sync_cancel_entry(struct hci_dev *hdev,
59505ea2b2SLuiz Augusto von Dentz 			       struct hci_cmd_sync_work_entry *entry);
60505ea2b2SLuiz Augusto von Dentz bool hci_cmd_sync_dequeue(struct hci_dev *hdev, hci_cmd_sync_work_func_t func,
61505ea2b2SLuiz Augusto von Dentz 			  void *data, hci_cmd_sync_work_destroy_t destroy);
62505ea2b2SLuiz Augusto von Dentz bool hci_cmd_sync_dequeue_once(struct hci_dev *hdev,
63505ea2b2SLuiz Augusto von Dentz 			      hci_cmd_sync_work_func_t func, void *data,
64505ea2b2SLuiz Augusto von Dentz 			      hci_cmd_sync_work_destroy_t destroy);
65161510ccSLuiz Augusto von Dentz 
66161510ccSLuiz Augusto von Dentz int hci_update_eir_sync(struct hci_dev *hdev);
67161510ccSLuiz Augusto von Dentz int hci_update_class_sync(struct hci_dev *hdev);
68cba6b758SLuiz Augusto von Dentz 
69cba6b758SLuiz Augusto von Dentz int hci_update_eir_sync(struct hci_dev *hdev);
70cba6b758SLuiz Augusto von Dentz int hci_update_class_sync(struct hci_dev *hdev);
716f6ff38aSBrian Gix int hci_update_name_sync(struct hci_dev *hdev);
723244845cSBrian Gix int hci_write_ssp_mode_sync(struct hci_dev *hdev, u8 mode);
73cba6b758SLuiz Augusto von Dentz 
743fe318eeSBrian Gix int hci_get_random_address(struct hci_dev *hdev, bool require_privacy,
753fe318eeSBrian Gix 			   bool use_rpa, struct adv_info *adv_instance,
763fe318eeSBrian Gix 			   u8 *own_addr_type, bdaddr_t *rand_addr);
773fe318eeSBrian Gix 
78cba6b758SLuiz Augusto von Dentz int hci_update_random_address_sync(struct hci_dev *hdev, bool require_privacy,
79cba6b758SLuiz Augusto von Dentz 				   bool rpa, u8 *own_addr_type);
80cba6b758SLuiz Augusto von Dentz 
81cba6b758SLuiz Augusto von Dentz int hci_update_scan_rsp_data_sync(struct hci_dev *hdev, u8 instance);
82cba6b758SLuiz Augusto von Dentz int hci_update_adv_data_sync(struct hci_dev *hdev, u8 instance);
83651cd3d6SBrian Gix int hci_update_adv_data(struct hci_dev *hdev, u8 instance);
84cba6b758SLuiz Augusto von Dentz int hci_schedule_adv_instance_sync(struct hci_dev *hdev, u8 instance,
85cba6b758SLuiz Augusto von Dentz 				   bool force);
86cba6b758SLuiz Augusto von Dentz 
87cba6b758SLuiz Augusto von Dentz int hci_setup_ext_adv_instance_sync(struct hci_dev *hdev, u8 instance);
88cba6b758SLuiz Augusto von Dentz int hci_start_ext_adv_sync(struct hci_dev *hdev, u8 instance);
89cba6b758SLuiz Augusto von Dentz int hci_enable_ext_advertising_sync(struct hci_dev *hdev, u8 instance);
90cba6b758SLuiz Augusto von Dentz int hci_enable_advertising_sync(struct hci_dev *hdev);
91abfeea47SLuiz Augusto von Dentz int hci_enable_advertising(struct hci_dev *hdev);
92cba6b758SLuiz Augusto von Dentz 
93eca0ae4aSLuiz Augusto von Dentz int hci_start_per_adv_sync(struct hci_dev *hdev, u8 instance, u8 data_len,
94eca0ae4aSLuiz Augusto von Dentz 			   u8 *data, u32 flags, u16 min_interval,
95eca0ae4aSLuiz Augusto von Dentz 			   u16 max_interval, u16 sync_interval);
96eca0ae4aSLuiz Augusto von Dentz 
97a254b90cSIulia Tanasescu int hci_disable_per_advertising_sync(struct hci_dev *hdev, u8 instance);
98a254b90cSIulia Tanasescu 
99cba6b758SLuiz Augusto von Dentz int hci_remove_advertising_sync(struct hci_dev *hdev, struct sock *sk,
100cba6b758SLuiz Augusto von Dentz 				u8 instance, bool force);
101cba6b758SLuiz Augusto von Dentz int hci_disable_advertising_sync(struct hci_dev *hdev);
102c249ea9bSBrian Gix int hci_clear_adv_instance_sync(struct hci_dev *hdev, struct sock *sk,
103c249ea9bSBrian Gix 				u8 instance, bool force);
104e8907f76SLuiz Augusto von Dentz int hci_update_passive_scan_sync(struct hci_dev *hdev);
105ad383c2cSLuiz Augusto von Dentz int hci_update_passive_scan(struct hci_dev *hdev);
10647db6b42SBrian Gix int hci_read_rssi_sync(struct hci_dev *hdev, __le16 handle);
10747db6b42SBrian Gix int hci_read_tx_power_sync(struct hci_dev *hdev, __le16 handle, u8 type);
1082f2eb0c9SBrian Gix int hci_write_sc_support_sync(struct hci_dev *hdev, u8 val);
1095a750137SBrian Gix int hci_read_clock_sync(struct hci_dev *hdev, struct hci_cp_read_clock *cp);
110cf75ad8bSLuiz Augusto von Dentz 
111353a0249SBrian Gix int hci_write_fast_connectable_sync(struct hci_dev *hdev, bool enable);
112451d95a9SBrian Gix int hci_update_scan_sync(struct hci_dev *hdev);
113bb876725SBrian Gix int hci_update_scan(struct hci_dev *hdev);
114353a0249SBrian Gix 
115d81a494cSBrian Gix int hci_write_le_host_supported_sync(struct hci_dev *hdev, u8 le, u8 simul);
116d81a494cSBrian Gix int hci_remove_ext_adv_instance_sync(struct hci_dev *hdev, u8 instance,
117d81a494cSBrian Gix 				     struct sock *sk);
118eca0ae4aSLuiz Augusto von Dentz int hci_remove_ext_adv_instance(struct hci_dev *hdev, u8 instance);
119f892244bSBrian Gix struct sk_buff *hci_read_local_oob_data_sync(struct hci_dev *hdev, bool ext,
120f892244bSBrian Gix 					     struct sock *sk);
121d81a494cSBrian Gix 
122d0b13706SLuiz Augusto von Dentz int hci_reset_sync(struct hci_dev *hdev);
123cf75ad8bSLuiz Augusto von Dentz int hci_dev_open_sync(struct hci_dev *hdev);
124cf75ad8bSLuiz Augusto von Dentz int hci_dev_close_sync(struct hci_dev *hdev);
125cf75ad8bSLuiz Augusto von Dentz 
126cf75ad8bSLuiz Augusto von Dentz int hci_powered_update_sync(struct hci_dev *hdev);
127cf75ad8bSLuiz Augusto von Dentz int hci_set_powered_sync(struct hci_dev *hdev, u8 val);
128abfeea47SLuiz Augusto von Dentz 
1292bd1b237SLuiz Augusto von Dentz int hci_update_discoverable_sync(struct hci_dev *hdev);
1302bd1b237SLuiz Augusto von Dentz int hci_update_discoverable(struct hci_dev *hdev);
1312bd1b237SLuiz Augusto von Dentz 
132f056a657SLuiz Augusto von Dentz int hci_update_connectable_sync(struct hci_dev *hdev);
133f056a657SLuiz Augusto von Dentz 
134*92048ab2SLuiz Augusto von Dentz int hci_inquiry_sync(struct hci_dev *hdev, u8 length, u8 num_rsp);
135*92048ab2SLuiz Augusto von Dentz 
136abfeea47SLuiz Augusto von Dentz int hci_start_discovery_sync(struct hci_dev *hdev);
137abfeea47SLuiz Augusto von Dentz int hci_stop_discovery_sync(struct hci_dev *hdev);
138182ee45dSLuiz Augusto von Dentz 
139182ee45dSLuiz Augusto von Dentz int hci_suspend_sync(struct hci_dev *hdev);
140182ee45dSLuiz Augusto von Dentz int hci_resume_sync(struct hci_dev *hdev);
1418e8b92eeSLuiz Augusto von Dentz 
1428e8b92eeSLuiz Augusto von Dentz struct hci_conn;
1430ece498cSLuiz Augusto von Dentz struct hci_conn_params;
1448e8b92eeSLuiz Augusto von Dentz 
1451f7435c8SLuiz Augusto von Dentz int hci_abort_conn_sync(struct hci_dev *hdev, struct hci_conn *conn, u8 reason);
1461f7435c8SLuiz Augusto von Dentz 
1477f74563eSPauli Virtanen int hci_le_create_cis_sync(struct hci_dev *hdev);
148c09b80beSLuiz Augusto von Dentz 
14926afbd82SLuiz Augusto von Dentz int hci_le_remove_cig_sync(struct hci_dev *hdev, u8 handle);
150eca0ae4aSLuiz Augusto von Dentz 
151eca0ae4aSLuiz Augusto von Dentz int hci_le_terminate_big_sync(struct hci_dev *hdev, u8 handle, u8 reason);
152eca0ae4aSLuiz Augusto von Dentz 
153eca0ae4aSLuiz Augusto von Dentz int hci_le_big_terminate_sync(struct hci_dev *hdev, u8 handle);
154eca0ae4aSLuiz Augusto von Dentz 
155eca0ae4aSLuiz Augusto von Dentz int hci_le_pa_terminate_sync(struct hci_dev *hdev, u16 handle);
15645340097SJonas Dreßler 
1575f641f03SLuiz Augusto von Dentz int hci_connect_acl_sync(struct hci_dev *hdev, struct hci_conn *conn);
158881559afSLuiz Augusto von Dentz 
159881559afSLuiz Augusto von Dentz int hci_connect_le_sync(struct hci_dev *hdev, struct hci_conn *conn);
160881559afSLuiz Augusto von Dentz 
161881559afSLuiz Augusto von Dentz int hci_cancel_connect_sync(struct hci_dev *hdev, struct hci_conn *conn);
1620ece498cSLuiz Augusto von Dentz int hci_le_conn_update_sync(struct hci_dev *hdev, struct hci_conn *conn,
1630ece498cSLuiz Augusto von Dentz 			    struct hci_conn_params *params);
164