1/* SPDX-License-Identifier: GPL-2.0-or-later */
2/*
3 *
4 * BlueZ - Bluetooth protocol stack for Linux
5 *
6 * Copyright (C) 2000-2001 Qualcomm Incorporated
7 * Copyright (C) 2002-2003 Maxim Krasnyansky <maxk@qualcomm.com>
8 * Copyright (C) 2002-2010 Marcel Holtmann <marcel@holtmann.org>
9 *
10 *
11 */
12
13#ifndef __HCI_LIB_H
14#define __HCI_LIB_H
15
16#ifdef __cplusplus
17extern "C" {
18#endif
19
20struct hci_request {
21 uint16_t ogf;
22 uint16_t ocf;
23 int event;
24 void *cparam;
25 int clen;
26 void *rparam;
27 int rlen;
28};
29
30struct hci_version {
31 uint16_t manufacturer;
32 uint8_t hci_ver;
33 uint16_t hci_rev;
34 uint8_t lmp_ver;
35 uint16_t lmp_subver;
36};
37
38int hci_open_dev(int dev_id);
39int hci_close_dev(int dd);
40int hci_send_cmd(int dd, uint16_t ogf, uint16_t ocf, uint8_t plen, void *param);
41int hci_send_req(int dd, struct hci_request *req, int timeout);
42
43int hci_create_connection(int dd, const bdaddr_t *bdaddr, uint16_t ptype, uint16_t clkoffset, uint8_t rswitch, uint16_t *handle, int to);
44int hci_disconnect(int dd, uint16_t handle, uint8_t reason, int to);
45
46int hci_inquiry(int dev_id, int len, int num_rsp, const uint8_t *lap, inquiry_info **ii, long flags);
47int hci_devinfo(int dev_id, struct hci_dev_info *di);
48int hci_devba(int dev_id, bdaddr_t *bdaddr);
49int hci_devid(const char *str);
50
51int hci_read_local_name(int dd, int len, char *name, int to);
52int hci_write_local_name(int dd, const char *name, int to);
53int hci_read_remote_name(int dd, const bdaddr_t *bdaddr, int len, char *name, int to);
54int hci_read_remote_name_with_clock_offset(int dd, const bdaddr_t *bdaddr, uint8_t pscan_rep_mode, uint16_t clkoffset, int len, char *name, int to);
55int hci_read_remote_name_cancel(int dd, const bdaddr_t *bdaddr, int to);
56int hci_read_remote_version(int dd, uint16_t handle, struct hci_version *ver, int to);
57int hci_read_remote_features(int dd, uint16_t handle, uint8_t *features, int to);
58int hci_read_remote_ext_features(int dd, uint16_t handle, uint8_t page, uint8_t *max_page, uint8_t *features, int to);
59int hci_read_clock_offset(int dd, uint16_t handle, uint16_t *clkoffset, int to);
60int hci_read_local_version(int dd, struct hci_version *ver, int to);
61int hci_read_local_commands(int dd, uint8_t *commands, int to);
62int hci_read_local_features(int dd, uint8_t *features, int to);
63int hci_read_local_ext_features(int dd, uint8_t page, uint8_t *max_page, uint8_t *features, int to);
64int hci_read_bd_addr(int dd, bdaddr_t *bdaddr, int to);
65int hci_read_class_of_dev(int dd, uint8_t *cls, int to);
66int hci_write_class_of_dev(int dd, uint32_t cls, int to);
67int hci_read_voice_setting(int dd, uint16_t *vs, int to);
68int hci_write_voice_setting(int dd, uint16_t vs, int to);
69int hci_read_current_iac_lap(int dd, uint8_t *num_iac, uint8_t *lap, int to);
70int hci_write_current_iac_lap(int dd, uint8_t num_iac, uint8_t *lap, int to);
71int hci_read_stored_link_key(int dd, bdaddr_t *bdaddr, uint8_t all, int to);
72int hci_write_stored_link_key(int dd, bdaddr_t *bdaddr, uint8_t *key, int to);
73int hci_delete_stored_link_key(int dd, bdaddr_t *bdaddr, uint8_t all, int to);
74int hci_authenticate_link(int dd, uint16_t handle, int to);
75int hci_encrypt_link(int dd, uint16_t handle, uint8_t encrypt, int to);
76int hci_change_link_key(int dd, uint16_t handle, int to);
77int hci_switch_role(int dd, bdaddr_t *bdaddr, uint8_t role, int to);
78int hci_park_mode(int dd, uint16_t handle, uint16_t max_interval, uint16_t min_interval, int to);
79int hci_exit_park_mode(int dd, uint16_t handle, int to);
80int hci_read_inquiry_scan_type(int dd, uint8_t *type, int to);
81int hci_write_inquiry_scan_type(int dd, uint8_t type, int to);
82int hci_read_inquiry_mode(int dd, uint8_t *mode, int to);
83int hci_write_inquiry_mode(int dd, uint8_t mode, int to);
84int hci_read_afh_mode(int dd, uint8_t *mode, int to);
85int hci_write_afh_mode(int dd, uint8_t mode, int to);
86int hci_read_ext_inquiry_response(int dd, uint8_t *fec, uint8_t *data, int to);
87int hci_write_ext_inquiry_response(int dd, uint8_t fec, uint8_t *data, int to);
88int hci_read_simple_pairing_mode(int dd, uint8_t *mode, int to);
89int hci_write_simple_pairing_mode(int dd, uint8_t mode, int to);
90int hci_read_local_oob_data(int dd, uint8_t *hash, uint8_t *randomizer, int to);
91int hci_read_inq_response_tx_power_level(int dd, int8_t *level, int to);
92int hci_read_inquiry_transmit_power_level(int dd, int8_t *level, int to);
93int hci_write_inquiry_transmit_power_level(int dd, int8_t level, int to);
94int hci_read_transmit_power_level(int dd, uint16_t handle, uint8_t type, int8_t *level, int to);
95int hci_read_link_policy(int dd, uint16_t handle, uint16_t *policy, int to);
96int hci_write_link_policy(int dd, uint16_t handle, uint16_t policy, int to);
97int hci_read_link_supervision_timeout(int dd, uint16_t handle, uint16_t *timeout, int to);
98int hci_write_link_supervision_timeout(int dd, uint16_t handle, uint16_t timeout, int to);
99int hci_set_afh_classification(int dd, uint8_t *map, int to);
100int hci_read_link_quality(int dd, uint16_t handle, uint8_t *link_quality, int to);
101int hci_read_rssi(int dd, uint16_t handle, int8_t *rssi, int to);
102int hci_read_afh_map(int dd, uint16_t handle, uint8_t *mode, uint8_t *map, int to);
103int hci_read_clock(int dd, uint16_t handle, uint8_t which, uint32_t *clock, uint16_t *accuracy, int to);
104
105int hci_le_set_scan_enable(int dev_id, uint8_t enable, uint8_t filter_dup, int to);
106int hci_le_set_scan_parameters(int dev_id, uint8_t type, uint16_t interval,
107 uint16_t window, uint8_t own_type,
108 uint8_t filter, int to);
109int hci_le_set_advertise_enable(int dev_id, uint8_t enable, int to);
110int hci_le_create_conn(int dd, uint16_t interval, uint16_t window,
111 uint8_t initiator_filter, uint8_t peer_bdaddr_type,
112 bdaddr_t peer_bdaddr, uint8_t own_bdaddr_type,
113 uint16_t min_interval, uint16_t max_interval,
114 uint16_t latency, uint16_t supervision_timeout,
115 uint16_t min_ce_length, uint16_t max_ce_length,
116 uint16_t *handle, int to);
117int hci_le_conn_update(int dd, uint16_t handle, uint16_t min_interval,
118 uint16_t max_interval, uint16_t latency,
119 uint16_t supervision_timeout, int to);
120int hci_le_add_white_list(int dd, const bdaddr_t *bdaddr, uint8_t type, int to);
121int hci_le_rm_white_list(int dd, const bdaddr_t *bdaddr, uint8_t type, int to);
122int hci_le_read_white_list_size(int dd, uint8_t *size, int to);
123int hci_le_clear_white_list(int dd, int to);
124int hci_le_add_resolving_list(int dd, const bdaddr_t *bdaddr, uint8_t type,
125 uint8_t *peer_irk, uint8_t *local_irk, int to);
126int hci_le_rm_resolving_list(int dd, const bdaddr_t *bdaddr, uint8_t type, int to);
127int hci_le_clear_resolving_list(int dd, int to);
128int hci_le_read_resolving_list_size(int dd, uint8_t *size, int to);
129int hci_le_set_address_resolution_enable(int dev_id, uint8_t enable, int to);
130int hci_le_read_remote_features(int dd, uint16_t handle, uint8_t *features, int to);
131
132int hci_for_each_dev(int flag, int(*func)(int dd, int dev_id, long arg), long arg);
133int hci_get_route(bdaddr_t *bdaddr);
134
135char *hci_bustostr(int bus);
136char *hci_typetostr(int type);
137char *hci_dtypetostr(int type);
138char *hci_dflagstostr(uint32_t flags);
139char *hci_ptypetostr(unsigned int ptype);
140int hci_strtoptype(char *str, unsigned int *val);
141char *hci_scoptypetostr(unsigned int ptype);
142int hci_strtoscoptype(char *str, unsigned int *val);
143char *hci_lptostr(unsigned int ptype);
144int hci_strtolp(char *str, unsigned int *val);
145char *hci_lmtostr(unsigned int ptype);
146int hci_strtolm(char *str, unsigned int *val);
147
148char *hci_cmdtostr(unsigned int cmd);
149char *hci_commandstostr(uint8_t *commands, char *pref, int width);
150
151char *hci_vertostr(unsigned int ver);
152int hci_strtover(char *str, unsigned int *ver);
153char *lmp_vertostr(unsigned int ver);
154int lmp_strtover(char *str, unsigned int *ver);
155char *pal_vertostr(unsigned int ver);
156int pal_strtover(char *str, unsigned int *ver);
157
158char *lmp_featurestostr(uint8_t *features, char *pref, int width);
159
160static inline void hci_set_bit(int nr, void *addr)
161{
162 *((uint32_t *) addr + (nr >> 5)) |= (1 << (nr & 31));
163}
164
165static inline void hci_clear_bit(int nr, void *addr)
166{
167 *((uint32_t *) addr + (nr >> 5)) &= ~(1 << (nr & 31));
168}
169
170static inline int hci_test_bit(int nr, void *addr)
171{
172 return *((uint32_t *) addr + (nr >> 5)) & (1 << (nr & 31));
173}
174
175/* HCI filter tools */
176static inline void hci_filter_clear(struct hci_filter *f)
177{
178 memset(s: f, c: 0, n: sizeof(*f));
179}
180static inline void hci_filter_set_ptype(int t, struct hci_filter *f)
181{
182 hci_set_bit(nr: (t == HCI_VENDOR_PKT) ? 0 : (t & HCI_FLT_TYPE_BITS), addr: &f->type_mask);
183}
184static inline void hci_filter_clear_ptype(int t, struct hci_filter *f)
185{
186 hci_clear_bit(nr: (t == HCI_VENDOR_PKT) ? 0 : (t & HCI_FLT_TYPE_BITS), addr: &f->type_mask);
187}
188static inline int hci_filter_test_ptype(int t, struct hci_filter *f)
189{
190 return hci_test_bit(nr: (t == HCI_VENDOR_PKT) ? 0 : (t & HCI_FLT_TYPE_BITS), addr: &f->type_mask);
191}
192static inline void hci_filter_all_ptypes(struct hci_filter *f)
193{
194 memset(s: (void *) &f->type_mask, c: 0xff, n: sizeof(f->type_mask));
195}
196static inline void hci_filter_set_event(int e, struct hci_filter *f)
197{
198 hci_set_bit(nr: (e & HCI_FLT_EVENT_BITS), addr: &f->event_mask);
199}
200static inline void hci_filter_clear_event(int e, struct hci_filter *f)
201{
202 hci_clear_bit(nr: (e & HCI_FLT_EVENT_BITS), addr: &f->event_mask);
203}
204static inline int hci_filter_test_event(int e, struct hci_filter *f)
205{
206 return hci_test_bit(nr: (e & HCI_FLT_EVENT_BITS), addr: &f->event_mask);
207}
208static inline void hci_filter_all_events(struct hci_filter *f)
209{
210 memset(s: (void *) f->event_mask, c: 0xff, n: sizeof(f->event_mask));
211}
212static inline void hci_filter_set_opcode(int opcode, struct hci_filter *f)
213{
214 f->opcode = opcode;
215}
216static inline void hci_filter_clear_opcode(struct hci_filter *f)
217{
218 f->opcode = 0;
219}
220static inline int hci_filter_test_opcode(int opcode, struct hci_filter *f)
221{
222 return (f->opcode == opcode);
223}
224
225#ifdef __cplusplus
226}
227#endif
228
229#endif /* __HCI_LIB_H */
230

source code of include/bluetooth/hci_lib.h