1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
|
/*
* Public libusb header file
* Copyright (C) 2007 Daniel Drake <dsd@gentoo.org>
* Copyright (c) 2001 Johannes Erdfelt <johannes@erdfelt.com>
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
*/
#ifndef __LIBUSB_H__
#define __LIBUSB_H__
#include <stdint.h>
#include <sys/time.h>
#ifdef __cplusplus
extern "C" {
#endif
/* standard USB stuff */
/* Device and/or Interface Class codes */
#define LIBUSB_CLASS_PER_INTERFACE 0 /* for DeviceClass */
#define LIBUSB_CLASS_AUDIO 1
#define LIBUSB_CLASS_COMM 2
#define LIBUSB_CLASS_HID 3
#define LIBUSB_CLASS_PRINTER 7
#define LIBUSB_CLASS_PTP 6
#define LIBUSB_CLASS_MASS_STORAGE 8
#define LIBUSB_CLASS_HUB 9
#define LIBUSB_CLASS_DATA 10
#define LIBUSB_CLASS_VENDOR_SPEC 0xff
/* Descriptor types */
#define LIBUSB_DT_DEVICE 0x01
#define LIBUSB_DT_CONFIG 0x02
#define LIBUSB_DT_STRING 0x03
#define LIBUSB_DT_INTERFACE 0x04
#define LIBUSB_DT_ENDPOINT 0x05
#define LIBUSB_DT_HID 0x21
#define LIBUSB_DT_REPORT 0x22
#define LIBUSB_DT_PHYSICAL 0x23
#define LIBUSB_DT_HUB 0x29
/* Descriptor sizes per descriptor type */
#define LIBUSB_DT_DEVICE_SIZE 18
#define LIBUSB_DT_CONFIG_SIZE 9
#define LIBUSB_DT_INTERFACE_SIZE 9
#define LIBUSB_DT_ENDPOINT_SIZE 7
#define LIBUSB_DT_ENDPOINT_AUDIO_SIZE 9 /* Audio extension */
#define LIBUSB_DT_HUB_NONVAR_SIZE 7
#define LIBUSB_ENDPOINT_ADDRESS_MASK 0x0f /* in bEndpointAddress */
#define LIBUSB_ENDPOINT_DIR_MASK 0x80
#define LIBUSB_ENDPOINT_IN 0x80
#define LIBUSB_ENDPOINT_OUT 0x00
#define LIBUSB_ENDPOINT_TYPE_MASK 0x03 /* in bmAttributes */
#define LIBUSB_ENDPOINT_TYPE_CONTROL 0
#define LIBUSB_ENDPOINT_TYPE_ISOCHRONOUS 1
#define LIBUSB_ENDPOINT_TYPE_BULK 2
#define LIBUSB_ENDPOINT_TYPE_INTERRUPT 3
/* Standard requests */
#define LIBUSB_REQ_GET_STATUS 0x00
#define LIBUSB_REQ_CLEAR_FEATURE 0x01
/* 0x02 is reserved */
#define LIBUSB_REQ_SET_FEATURE 0x03
/* 0x04 is reserved */
#define LIBUSB_REQ_SET_ADDRESS 0x05
#define LIBUSB_REQ_GET_DESCRIPTOR 0x06
#define LIBUSB_REQ_SET_DESCRIPTOR 0x07
#define LIBUSB_REQ_GET_CONFIGURATION 0x08
#define LIBUSB_REQ_SET_CONFIGURATION 0x09
#define LIBUSB_REQ_GET_INTERFACE 0x0A
#define LIBUSB_REQ_SET_INTERFACE 0x0B
#define LIBUSB_REQ_SYNCH_FRAME 0x0C
#define LIBUSB_TYPE_STANDARD (0x00 << 5)
#define LIBUSB_TYPE_CLASS (0x01 << 5)
#define LIBUSB_TYPE_VENDOR (0x02 << 5)
#define LIBUSB_TYPE_RESERVED (0x03 << 5)
#define LIBUSB_RECIP_DEVICE 0x00
#define LIBUSB_RECIP_INTERFACE 0x01
#define LIBUSB_RECIP_ENDPOINT 0x02
#define LIBUSB_RECIP_OTHER 0x03
struct libusb_dev_descriptor {
uint8_t bLength;
uint8_t bDescriptorType;
uint16_t bcdUSB;
uint8_t bDeviceClass;
uint8_t bDeviceSubClass;
uint8_t bDeviceProtocol;
uint8_t bMaxPacketSize0;
uint16_t idVendor;
uint16_t idProduct;
uint16_t bcdDevice;
uint8_t iManufacturer;
uint8_t iProduct;
uint8_t iSerialNumber;
uint8_t bNumConfigurations;
};
struct libusb_endpoint_descriptor {
uint8_t bLength;
uint8_t bDescriptorType;
uint8_t bEndpointAddress;
uint8_t bmAttributes;
uint16_t wMaxPacketSize;
uint8_t bInterval;
uint8_t bRefresh;
uint8_t bSynchAddress;
unsigned char *extra; /* Extra descriptors */
int extralen;
};
struct libusb_interface_descriptor {
uint8_t bLength;
uint8_t bDescriptorType;
uint8_t bInterfaceNumber;
uint8_t bAlternateSetting;
uint8_t bNumEndpoints;
uint8_t bInterfaceClass;
uint8_t bInterfaceSubClass;
uint8_t bInterfaceProtocol;
uint8_t iInterface;
struct libusb_endpoint_descriptor *endpoint;
unsigned char *extra; /* Extra descriptors */
int extralen;
};
struct libusb_interface {
struct libusb_interface_descriptor *altsetting;
int num_altsetting;
};
struct libusb_config_descriptor {
uint8_t bLength;
uint8_t bDescriptorType;
uint16_t wTotalLength;
uint8_t bNumInterfaces;
uint8_t bConfigurationValue;
uint8_t iConfiguration;
uint8_t bmAttributes;
uint8_t MaxPower;
struct libusb_interface *interface;
unsigned char *extra; /* Extra descriptors */
int extralen;
};
/* off-the-wire structures */
struct libusb_ctrl_setup {
uint8_t bRequestType;
uint8_t bRequest;
uint16_t wValue;
uint16_t wIndex;
uint16_t wLength;
} __attribute__((packed));
/* libusb */
struct libusb_dev;
typedef struct libusb_dev libusb_dev;
struct libusb_dev_handle;
typedef struct libusb_dev_handle libusb_dev_handle;
struct libusb_urb_handle;
typedef struct libusb_urb_handle libusb_urb_handle;
enum libusb_urb_cb_status {
FP_URB_SILENT_COMPLETION = 0,
FP_URB_COMPLETED,
FP_URB_TIMEOUT,
FP_URB_CANCELLED,
};
struct libusb_control_transfer {
uint8_t requesttype;
uint8_t request;
uint16_t value;
uint16_t index;
uint16_t length;
unsigned char *data;
};
typedef void (*libusb_ctrl_cb_fn)(libusb_dev_handle *devh, libusb_urb_handle *urbh,
enum libusb_urb_cb_status status, struct libusb_ctrl_setup *setup,
unsigned char *data, int actual_length, void *user_data);
struct libusb_bulk_transfer {
unsigned char endpoint;
unsigned char *data;
int length;
};
typedef void (*libusb_bulk_cb_fn)(libusb_dev_handle *devh, libusb_urb_handle *urbh,
enum libusb_urb_cb_status status, unsigned char endpoint,
int rqlength, unsigned char *data, int actual_length, void *user_data);
int libusb_init(int signum);
void libusb_exit(void);
int libusb_find_devices(void);
libusb_dev *libusb_get_devices(void);
struct libusb_dev_descriptor *libusb_dev_get_descriptor(libusb_dev *dev);
struct libusb_config_descriptor *libusb_dev_get_config(libusb_dev *dev);
libusb_dev *libusb_dev_next(libusb_dev *dev);
libusb_dev_handle *libusb_open(libusb_dev *dev);
void libusb_close(libusb_dev_handle *devh);
struct libusb_dev *libusb_devh_get_dev(libusb_dev_handle *devh);
int libusb_claim_interface(libusb_dev_handle *dev, int iface);
int libusb_release_interface(libusb_dev_handle *dev, int iface);
/* async I/O */
struct libusb_pollfd {
int fd;
short events;
};
libusb_urb_handle *libusb_async_control_transfer(libusb_dev_handle *devh,
struct libusb_control_transfer *transfer, libusb_ctrl_cb_fn callback,
void *user_data, unsigned int timeout);
libusb_urb_handle *libusb_async_bulk_transfer(libusb_dev_handle *devh,
struct libusb_bulk_transfer *transfer, libusb_bulk_cb_fn callback,
void *user_data, unsigned int timeout);
libusb_urb_handle *libusb_async_interrupt_transfer(libusb_dev_handle *devh,
struct libusb_bulk_transfer *transfer, libusb_bulk_cb_fn callback,
void *user_data, unsigned int timeout);
int libusb_urb_handle_cancel(libusb_dev_handle *devh, libusb_urb_handle *urbh);
int libusb_urb_handle_cancel_sync(libusb_dev_handle *devh,
libusb_urb_handle *urbh);
void libusb_urb_handle_free(libusb_urb_handle *urbh);
int libusb_poll_timeout(struct timeval *tv);
int libusb_poll(void);
size_t libusb_get_pollfds(struct libusb_pollfd **pollfds);
/* sync I/O */
int libusb_control_transfer(libusb_dev_handle *devh,
struct libusb_control_transfer *transfer, unsigned int timeout);
int libusb_bulk_transfer(libusb_dev_handle *devh,
struct libusb_bulk_transfer *transfer, int *transferred,
unsigned int timeout);
int libusb_interrupt_transfer(libusb_dev_handle *devh,
struct libusb_bulk_transfer *transfer, int *transferred,
unsigned int timeout);
#ifdef __cplusplus
}
#endif
#endif
|
