root / hw / usb.h @ 0834c9ea
History | View | Annotate | Download (16 kB)
1 | 62aed765 | Anthony Liguori | #ifndef QEMU_USB_H
|
---|---|---|---|
2 | 62aed765 | Anthony Liguori | #define QEMU_USB_H
|
3 | 62aed765 | Anthony Liguori | |
4 | bb36d470 | bellard | /*
|
5 | bb36d470 | bellard | * QEMU USB API
|
6 | 5fafdf24 | ths | *
|
7 | bb36d470 | bellard | * Copyright (c) 2005 Fabrice Bellard
|
8 | 5fafdf24 | ths | *
|
9 | bb36d470 | bellard | * Permission is hereby granted, free of charge, to any person obtaining a copy
|
10 | bb36d470 | bellard | * of this software and associated documentation files (the "Software"), to deal
|
11 | bb36d470 | bellard | * in the Software without restriction, including without limitation the rights
|
12 | bb36d470 | bellard | * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
13 | bb36d470 | bellard | * copies of the Software, and to permit persons to whom the Software is
|
14 | bb36d470 | bellard | * furnished to do so, subject to the following conditions:
|
15 | bb36d470 | bellard | *
|
16 | bb36d470 | bellard | * The above copyright notice and this permission notice shall be included in
|
17 | bb36d470 | bellard | * all copies or substantial portions of the Software.
|
18 | bb36d470 | bellard | *
|
19 | bb36d470 | bellard | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
20 | bb36d470 | bellard | * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
21 | bb36d470 | bellard | * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
|
22 | bb36d470 | bellard | * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
23 | bb36d470 | bellard | * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
24 | bb36d470 | bellard | * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
25 | bb36d470 | bellard | * THE SOFTWARE.
|
26 | bb36d470 | bellard | */
|
27 | c0f4ce77 | aliguori | |
28 | 806b6024 | Gerd Hoffmann | #include "qdev.h" |
29 | 72cf2d4f | Blue Swirl | #include "qemu-queue.h" |
30 | c0f4ce77 | aliguori | |
31 | 8e257816 | Brad Hards | /* Constants related to the USB / PCI interaction */
|
32 | 8e257816 | Brad Hards | #define USB_SBRN 0x60 /* Serial Bus Release Number Register */ |
33 | 8e257816 | Brad Hards | #define USB_RELEASE_1 0x10 /* USB 1.0 */ |
34 | 8e257816 | Brad Hards | #define USB_RELEASE_2 0x20 /* USB 2.0 */ |
35 | 8e257816 | Brad Hards | #define USB_RELEASE_3 0x30 /* USB 3.0 */ |
36 | 8e257816 | Brad Hards | |
37 | bb36d470 | bellard | #define USB_TOKEN_SETUP 0x2d |
38 | bb36d470 | bellard | #define USB_TOKEN_IN 0x69 /* device -> host */ |
39 | bb36d470 | bellard | #define USB_TOKEN_OUT 0xe1 /* host -> device */ |
40 | bb36d470 | bellard | |
41 | d61000a8 | Hans de Goede | #define USB_RET_NODEV (-1) |
42 | d61000a8 | Hans de Goede | #define USB_RET_NAK (-2) |
43 | d61000a8 | Hans de Goede | #define USB_RET_STALL (-3) |
44 | d61000a8 | Hans de Goede | #define USB_RET_BABBLE (-4) |
45 | d61000a8 | Hans de Goede | #define USB_RET_IOERROR (-5) |
46 | d61000a8 | Hans de Goede | #define USB_RET_ASYNC (-6) |
47 | bb36d470 | bellard | |
48 | bb36d470 | bellard | #define USB_SPEED_LOW 0 |
49 | bb36d470 | bellard | #define USB_SPEED_FULL 1 |
50 | bb36d470 | bellard | #define USB_SPEED_HIGH 2 |
51 | 843d4e0c | Gerd Hoffmann | #define USB_SPEED_SUPER 3 |
52 | 843d4e0c | Gerd Hoffmann | |
53 | 843d4e0c | Gerd Hoffmann | #define USB_SPEED_MASK_LOW (1 << USB_SPEED_LOW) |
54 | 843d4e0c | Gerd Hoffmann | #define USB_SPEED_MASK_FULL (1 << USB_SPEED_FULL) |
55 | 843d4e0c | Gerd Hoffmann | #define USB_SPEED_MASK_HIGH (1 << USB_SPEED_HIGH) |
56 | 843d4e0c | Gerd Hoffmann | #define USB_SPEED_MASK_SUPER (1 << USB_SPEED_SUPER) |
57 | bb36d470 | bellard | |
58 | bb36d470 | bellard | #define USB_STATE_NOTATTACHED 0 |
59 | bb36d470 | bellard | #define USB_STATE_ATTACHED 1 |
60 | bb36d470 | bellard | //#define USB_STATE_POWERED 2
|
61 | bb36d470 | bellard | #define USB_STATE_DEFAULT 3 |
62 | bb36d470 | bellard | //#define USB_STATE_ADDRESS 4
|
63 | bb36d470 | bellard | //#define USB_STATE_CONFIGURED 5
|
64 | bb36d470 | bellard | #define USB_STATE_SUSPENDED 6 |
65 | bb36d470 | bellard | |
66 | a594cfbf | bellard | #define USB_CLASS_AUDIO 1 |
67 | a594cfbf | bellard | #define USB_CLASS_COMM 2 |
68 | a594cfbf | bellard | #define USB_CLASS_HID 3 |
69 | a594cfbf | bellard | #define USB_CLASS_PHYSICAL 5 |
70 | a594cfbf | bellard | #define USB_CLASS_STILL_IMAGE 6 |
71 | a594cfbf | bellard | #define USB_CLASS_PRINTER 7 |
72 | a594cfbf | bellard | #define USB_CLASS_MASS_STORAGE 8 |
73 | a594cfbf | bellard | #define USB_CLASS_HUB 9 |
74 | a594cfbf | bellard | #define USB_CLASS_CDC_DATA 0x0a |
75 | a594cfbf | bellard | #define USB_CLASS_CSCID 0x0b |
76 | a594cfbf | bellard | #define USB_CLASS_CONTENT_SEC 0x0d |
77 | a594cfbf | bellard | #define USB_CLASS_APP_SPEC 0xfe |
78 | a594cfbf | bellard | #define USB_CLASS_VENDOR_SPEC 0xff |
79 | a594cfbf | bellard | |
80 | b870472d | H. Peter Anvin | #define USB_SUBCLASS_UNDEFINED 0 |
81 | b870472d | H. Peter Anvin | #define USB_SUBCLASS_AUDIO_CONTROL 1 |
82 | b870472d | H. Peter Anvin | #define USB_SUBCLASS_AUDIO_STREAMING 2 |
83 | b870472d | H. Peter Anvin | #define USB_SUBCLASS_AUDIO_MIDISTREAMING 3 |
84 | b870472d | H. Peter Anvin | |
85 | bb36d470 | bellard | #define USB_DIR_OUT 0 |
86 | bb36d470 | bellard | #define USB_DIR_IN 0x80 |
87 | bb36d470 | bellard | |
88 | bb36d470 | bellard | #define USB_TYPE_MASK (0x03 << 5) |
89 | bb36d470 | bellard | #define USB_TYPE_STANDARD (0x00 << 5) |
90 | bb36d470 | bellard | #define USB_TYPE_CLASS (0x01 << 5) |
91 | bb36d470 | bellard | #define USB_TYPE_VENDOR (0x02 << 5) |
92 | bb36d470 | bellard | #define USB_TYPE_RESERVED (0x03 << 5) |
93 | bb36d470 | bellard | |
94 | bb36d470 | bellard | #define USB_RECIP_MASK 0x1f |
95 | bb36d470 | bellard | #define USB_RECIP_DEVICE 0x00 |
96 | bb36d470 | bellard | #define USB_RECIP_INTERFACE 0x01 |
97 | bb36d470 | bellard | #define USB_RECIP_ENDPOINT 0x02 |
98 | bb36d470 | bellard | #define USB_RECIP_OTHER 0x03 |
99 | bb36d470 | bellard | |
100 | bb36d470 | bellard | #define DeviceRequest ((USB_DIR_IN|USB_TYPE_STANDARD|USB_RECIP_DEVICE)<<8) |
101 | bb36d470 | bellard | #define DeviceOutRequest ((USB_DIR_OUT|USB_TYPE_STANDARD|USB_RECIP_DEVICE)<<8) |
102 | 59ae540c | bellard | #define InterfaceRequest \
|
103 | 59ae540c | bellard | ((USB_DIR_IN|USB_TYPE_STANDARD|USB_RECIP_INTERFACE)<<8)
|
104 | 59ae540c | bellard | #define InterfaceOutRequest \
|
105 | 59ae540c | bellard | ((USB_DIR_OUT|USB_TYPE_STANDARD|USB_RECIP_INTERFACE)<<8)
|
106 | 59ae540c | bellard | #define EndpointRequest ((USB_DIR_IN|USB_TYPE_STANDARD|USB_RECIP_ENDPOINT)<<8) |
107 | 59ae540c | bellard | #define EndpointOutRequest \
|
108 | 59ae540c | bellard | ((USB_DIR_OUT|USB_TYPE_STANDARD|USB_RECIP_ENDPOINT)<<8)
|
109 | f3571b1a | Max Reitz | #define ClassInterfaceRequest \
|
110 | f3571b1a | Max Reitz | ((USB_DIR_IN|USB_TYPE_CLASS|USB_RECIP_INTERFACE)<<8)
|
111 | f3571b1a | Max Reitz | #define ClassInterfaceOutRequest \
|
112 | f3571b1a | Max Reitz | ((USB_DIR_OUT|USB_TYPE_CLASS|USB_RECIP_INTERFACE)<<8)
|
113 | bb36d470 | bellard | |
114 | bb36d470 | bellard | #define USB_REQ_GET_STATUS 0x00 |
115 | bb36d470 | bellard | #define USB_REQ_CLEAR_FEATURE 0x01 |
116 | bb36d470 | bellard | #define USB_REQ_SET_FEATURE 0x03 |
117 | bb36d470 | bellard | #define USB_REQ_SET_ADDRESS 0x05 |
118 | bb36d470 | bellard | #define USB_REQ_GET_DESCRIPTOR 0x06 |
119 | bb36d470 | bellard | #define USB_REQ_SET_DESCRIPTOR 0x07 |
120 | bb36d470 | bellard | #define USB_REQ_GET_CONFIGURATION 0x08 |
121 | bb36d470 | bellard | #define USB_REQ_SET_CONFIGURATION 0x09 |
122 | bb36d470 | bellard | #define USB_REQ_GET_INTERFACE 0x0A |
123 | bb36d470 | bellard | #define USB_REQ_SET_INTERFACE 0x0B |
124 | bb36d470 | bellard | #define USB_REQ_SYNCH_FRAME 0x0C |
125 | bb36d470 | bellard | |
126 | bb36d470 | bellard | #define USB_DEVICE_SELF_POWERED 0 |
127 | bb36d470 | bellard | #define USB_DEVICE_REMOTE_WAKEUP 1 |
128 | bb36d470 | bellard | |
129 | bb36d470 | bellard | #define USB_DT_DEVICE 0x01 |
130 | bb36d470 | bellard | #define USB_DT_CONFIG 0x02 |
131 | bb36d470 | bellard | #define USB_DT_STRING 0x03 |
132 | bb36d470 | bellard | #define USB_DT_INTERFACE 0x04 |
133 | bb36d470 | bellard | #define USB_DT_ENDPOINT 0x05 |
134 | 25620cba | Gerd Hoffmann | #define USB_DT_DEVICE_QUALIFIER 0x06 |
135 | 25620cba | Gerd Hoffmann | #define USB_DT_OTHER_SPEED_CONFIG 0x07 |
136 | a7fb71d1 | Gerd Hoffmann | #define USB_DT_DEBUG 0x0A |
137 | c6d3ad0f | Brad Hards | #define USB_DT_INTERFACE_ASSOC 0x0B |
138 | 2077469b | Gerd Hoffmann | #define USB_DT_BOS 0x0F |
139 | 2077469b | Gerd Hoffmann | #define USB_DT_DEVICE_CAPABILITY 0x10 |
140 | b870472d | H. Peter Anvin | #define USB_DT_CS_INTERFACE 0x24 |
141 | b870472d | H. Peter Anvin | #define USB_DT_CS_ENDPOINT 0x25 |
142 | b43a2851 | Gerd Hoffmann | #define USB_DT_ENDPOINT_COMPANION 0x30 |
143 | bb36d470 | bellard | |
144 | 2077469b | Gerd Hoffmann | #define USB_DEV_CAP_WIRELESS 0x01 |
145 | 2077469b | Gerd Hoffmann | #define USB_DEV_CAP_USB2_EXT 0x02 |
146 | 2077469b | Gerd Hoffmann | #define USB_DEV_CAP_SUPERSPEED 0x03 |
147 | 2077469b | Gerd Hoffmann | |
148 | 942ac052 | balrog | #define USB_ENDPOINT_XFER_CONTROL 0 |
149 | 942ac052 | balrog | #define USB_ENDPOINT_XFER_ISOC 1 |
150 | 942ac052 | balrog | #define USB_ENDPOINT_XFER_BULK 2 |
151 | 942ac052 | balrog | #define USB_ENDPOINT_XFER_INT 3 |
152 | d8e17efd | Gerd Hoffmann | #define USB_ENDPOINT_XFER_INVALID 255 |
153 | 942ac052 | balrog | |
154 | 7c37e6a4 | Gerd Hoffmann | #define USB_INTERFACE_INVALID 255 |
155 | 7c37e6a4 | Gerd Hoffmann | |
156 | 806b6024 | Gerd Hoffmann | typedef struct USBBus USBBus; |
157 | 07771f6f | Gerd Hoffmann | typedef struct USBBusOps USBBusOps; |
158 | bb36d470 | bellard | typedef struct USBPort USBPort; |
159 | bb36d470 | bellard | typedef struct USBDevice USBDevice; |
160 | 4d611c9a | pbrook | typedef struct USBPacket USBPacket; |
161 | d8e17efd | Gerd Hoffmann | typedef struct USBEndpoint USBEndpoint; |
162 | bb36d470 | bellard | |
163 | 37fb59d3 | Gerd Hoffmann | typedef struct USBDesc USBDesc; |
164 | 37fb59d3 | Gerd Hoffmann | typedef struct USBDescID USBDescID; |
165 | 37fb59d3 | Gerd Hoffmann | typedef struct USBDescDevice USBDescDevice; |
166 | 37fb59d3 | Gerd Hoffmann | typedef struct USBDescConfig USBDescConfig; |
167 | 6e625fc7 | Brad Hards | typedef struct USBDescIfaceAssoc USBDescIfaceAssoc; |
168 | 37fb59d3 | Gerd Hoffmann | typedef struct USBDescIface USBDescIface; |
169 | 37fb59d3 | Gerd Hoffmann | typedef struct USBDescEndpoint USBDescEndpoint; |
170 | 37fb59d3 | Gerd Hoffmann | typedef struct USBDescOther USBDescOther; |
171 | 132a3f55 | Gerd Hoffmann | typedef struct USBDescString USBDescString; |
172 | 132a3f55 | Gerd Hoffmann | |
173 | 132a3f55 | Gerd Hoffmann | struct USBDescString {
|
174 | 132a3f55 | Gerd Hoffmann | uint8_t index; |
175 | 132a3f55 | Gerd Hoffmann | char *str;
|
176 | 132a3f55 | Gerd Hoffmann | QLIST_ENTRY(USBDescString) next; |
177 | 132a3f55 | Gerd Hoffmann | }; |
178 | 37fb59d3 | Gerd Hoffmann | |
179 | 1de14d43 | Gerd Hoffmann | #define USB_MAX_ENDPOINTS 15 |
180 | 1de14d43 | Gerd Hoffmann | #define USB_MAX_INTERFACES 16 |
181 | 1de14d43 | Gerd Hoffmann | |
182 | d8e17efd | Gerd Hoffmann | struct USBEndpoint {
|
183 | 63095ab5 | Gerd Hoffmann | uint8_t nr; |
184 | 63095ab5 | Gerd Hoffmann | uint8_t pid; |
185 | d8e17efd | Gerd Hoffmann | uint8_t type; |
186 | 82f02fe9 | Gerd Hoffmann | uint8_t ifnum; |
187 | f003397c | Gerd Hoffmann | int max_packet_size;
|
188 | 7936e0f0 | Gerd Hoffmann | bool pipeline;
|
189 | 0132b4b6 | Hans de Goede | bool halted;
|
190 | 25d5de7d | Gerd Hoffmann | USBDevice *dev; |
191 | db4be873 | Gerd Hoffmann | QTAILQ_HEAD(, USBPacket) queue; |
192 | d8e17efd | Gerd Hoffmann | }; |
193 | d8e17efd | Gerd Hoffmann | |
194 | eeb0cf9a | Gerd Hoffmann | enum USBDeviceFlags {
|
195 | eeb0cf9a | Gerd Hoffmann | USB_DEV_FLAG_FULL_PATH, |
196 | eeb0cf9a | Gerd Hoffmann | }; |
197 | eeb0cf9a | Gerd Hoffmann | |
198 | bb36d470 | bellard | /* definition of a USB device */
|
199 | bb36d470 | bellard | struct USBDevice {
|
200 | 806b6024 | Gerd Hoffmann | DeviceState qdev; |
201 | 618c169b | Gerd Hoffmann | USBPort *port; |
202 | 5f69076b | Gerd Hoffmann | char *port_path;
|
203 | bb36d470 | bellard | void *opaque;
|
204 | eeb0cf9a | Gerd Hoffmann | uint32_t flags; |
205 | 89b9b79f | aliguori | |
206 | ba3f9bfb | Hans de Goede | /* Actual connected speed */
|
207 | 806b6024 | Gerd Hoffmann | int speed;
|
208 | ba3f9bfb | Hans de Goede | /* Supported speeds, not in info because it may be variable (hostdevs) */
|
209 | ba3f9bfb | Hans de Goede | int speedmask;
|
210 | 806b6024 | Gerd Hoffmann | uint8_t addr; |
211 | 0fe6d12e | Markus Armbruster | char product_desc[32]; |
212 | 61e094c0 | Gerd Hoffmann | int auto_attach;
|
213 | a5d2f727 | Gerd Hoffmann | int attached;
|
214 | 806b6024 | Gerd Hoffmann | |
215 | c1ecb40a | Gerd Hoffmann | int32_t state; |
216 | 806b6024 | Gerd Hoffmann | uint8_t setup_buf[8];
|
217 | 19f33223 | Hans de Goede | uint8_t data_buf[4096];
|
218 | c1ecb40a | Gerd Hoffmann | int32_t remote_wakeup; |
219 | c1ecb40a | Gerd Hoffmann | int32_t setup_state; |
220 | c1ecb40a | Gerd Hoffmann | int32_t setup_len; |
221 | c1ecb40a | Gerd Hoffmann | int32_t setup_index; |
222 | 132a3f55 | Gerd Hoffmann | |
223 | 25d5de7d | Gerd Hoffmann | USBEndpoint ep_ctl; |
224 | d8e17efd | Gerd Hoffmann | USBEndpoint ep_in[USB_MAX_ENDPOINTS]; |
225 | d8e17efd | Gerd Hoffmann | USBEndpoint ep_out[USB_MAX_ENDPOINTS]; |
226 | d8e17efd | Gerd Hoffmann | |
227 | 132a3f55 | Gerd Hoffmann | QLIST_HEAD(, USBDescString) strings; |
228 | a980a065 | Gerd Hoffmann | const USBDescDevice *device;
|
229 | 65360511 | Gerd Hoffmann | |
230 | 65360511 | Gerd Hoffmann | int configuration;
|
231 | 65360511 | Gerd Hoffmann | int ninterfaces;
|
232 | 1de14d43 | Gerd Hoffmann | int altsetting[USB_MAX_INTERFACES];
|
233 | a980a065 | Gerd Hoffmann | const USBDescConfig *config;
|
234 | 1de14d43 | Gerd Hoffmann | const USBDescIface *ifaces[USB_MAX_INTERFACES];
|
235 | 806b6024 | Gerd Hoffmann | }; |
236 | 806b6024 | Gerd Hoffmann | |
237 | 62aed765 | Anthony Liguori | #define TYPE_USB_DEVICE "usb-device" |
238 | 62aed765 | Anthony Liguori | #define USB_DEVICE(obj) \
|
239 | 62aed765 | Anthony Liguori | OBJECT_CHECK(USBDevice, (obj), TYPE_USB_DEVICE) |
240 | 62aed765 | Anthony Liguori | #define USB_DEVICE_CLASS(klass) \
|
241 | 62aed765 | Anthony Liguori | OBJECT_CLASS_CHECK(USBDeviceClass, (klass), TYPE_USB_DEVICE) |
242 | 62aed765 | Anthony Liguori | #define USB_DEVICE_GET_CLASS(obj) \
|
243 | 62aed765 | Anthony Liguori | OBJECT_GET_CLASS(USBDeviceClass, (obj), TYPE_USB_DEVICE) |
244 | 62aed765 | Anthony Liguori | |
245 | 62aed765 | Anthony Liguori | typedef struct USBDeviceClass { |
246 | 62aed765 | Anthony Liguori | DeviceClass parent_class; |
247 | 62aed765 | Anthony Liguori | |
248 | 806b6024 | Gerd Hoffmann | int (*init)(USBDevice *dev);
|
249 | 806b6024 | Gerd Hoffmann | |
250 | 806b6024 | Gerd Hoffmann | /*
|
251 | 73796fe6 | Gerd Hoffmann | * Walk (enabled) downstream ports, check for a matching device.
|
252 | 73796fe6 | Gerd Hoffmann | * Only hubs implement this.
|
253 | 73796fe6 | Gerd Hoffmann | */
|
254 | 73796fe6 | Gerd Hoffmann | USBDevice *(*find_device)(USBDevice *dev, uint8_t addr); |
255 | 73796fe6 | Gerd Hoffmann | |
256 | 73796fe6 | Gerd Hoffmann | /*
|
257 | eb5e680a | Gerd Hoffmann | * Called when a packet is canceled.
|
258 | eb5e680a | Gerd Hoffmann | */
|
259 | eb5e680a | Gerd Hoffmann | void (*cancel_packet)(USBDevice *dev, USBPacket *p);
|
260 | eb5e680a | Gerd Hoffmann | |
261 | eb5e680a | Gerd Hoffmann | /*
|
262 | 89b9b79f | aliguori | * Called when device is destroyed.
|
263 | 89b9b79f | aliguori | */
|
264 | 059809e4 | bellard | void (*handle_destroy)(USBDevice *dev);
|
265 | 059809e4 | bellard | |
266 | 89b9b79f | aliguori | /*
|
267 | b6f77fbe | Gerd Hoffmann | * Attach the device
|
268 | b6f77fbe | Gerd Hoffmann | */
|
269 | b6f77fbe | Gerd Hoffmann | void (*handle_attach)(USBDevice *dev);
|
270 | b6f77fbe | Gerd Hoffmann | |
271 | b6f77fbe | Gerd Hoffmann | /*
|
272 | 89b9b79f | aliguori | * Reset the device
|
273 | 806b6024 | Gerd Hoffmann | */
|
274 | 059809e4 | bellard | void (*handle_reset)(USBDevice *dev);
|
275 | 89b9b79f | aliguori | |
276 | 89b9b79f | aliguori | /*
|
277 | 89b9b79f | aliguori | * Process control request.
|
278 | 89b9b79f | aliguori | * Called from handle_packet().
|
279 | 89b9b79f | aliguori | *
|
280 | 89b9b79f | aliguori | * Returns length or one of the USB_RET_ codes.
|
281 | 89b9b79f | aliguori | */
|
282 | 007fd62f | Hans de Goede | int (*handle_control)(USBDevice *dev, USBPacket *p, int request, int value, |
283 | bb36d470 | bellard | int index, int length, uint8_t *data); |
284 | 89b9b79f | aliguori | |
285 | 89b9b79f | aliguori | /*
|
286 | 89b9b79f | aliguori | * Process data transfers (both BULK and ISOC).
|
287 | 89b9b79f | aliguori | * Called from handle_packet().
|
288 | 89b9b79f | aliguori | *
|
289 | 89b9b79f | aliguori | * Returns length or one of the USB_RET_ codes.
|
290 | 89b9b79f | aliguori | */
|
291 | 4d611c9a | pbrook | int (*handle_data)(USBDevice *dev, USBPacket *p);
|
292 | 0958b4cc | Gerd Hoffmann | |
293 | 1de14d43 | Gerd Hoffmann | void (*set_interface)(USBDevice *dev, int interface, |
294 | 1de14d43 | Gerd Hoffmann | int alt_old, int alt_new); |
295 | 1de14d43 | Gerd Hoffmann | |
296 | 06384698 | Markus Armbruster | const char *product_desc; |
297 | 37fb59d3 | Gerd Hoffmann | const USBDesc *usb_desc;
|
298 | 62aed765 | Anthony Liguori | } USBDeviceClass; |
299 | bb36d470 | bellard | |
300 | 0d86d2be | Gerd Hoffmann | typedef struct USBPortOps { |
301 | 618c169b | Gerd Hoffmann | void (*attach)(USBPort *port);
|
302 | 618c169b | Gerd Hoffmann | void (*detach)(USBPort *port);
|
303 | 4706ab6c | Hans de Goede | /*
|
304 | 4706ab6c | Hans de Goede | * This gets called when a device downstream from the device attached to
|
305 | 4706ab6c | Hans de Goede | * the port (iow attached through a hub) gets detached.
|
306 | 4706ab6c | Hans de Goede | */
|
307 | 4706ab6c | Hans de Goede | void (*child_detach)(USBPort *port, USBDevice *child);
|
308 | d47e59b8 | Hans de Goede | void (*wakeup)(USBPort *port);
|
309 | d47e59b8 | Hans de Goede | /*
|
310 | d47e59b8 | Hans de Goede | * Note that port->dev will be different then the device from which
|
311 | f53c398a | Gerd Hoffmann | * the packet originated when a hub is involved.
|
312 | d47e59b8 | Hans de Goede | */
|
313 | d47e59b8 | Hans de Goede | void (*complete)(USBPort *port, USBPacket *p);
|
314 | 0d86d2be | Gerd Hoffmann | } USBPortOps; |
315 | 0d92ed30 | pbrook | |
316 | bb36d470 | bellard | /* USB port on which a device can be connected */
|
317 | bb36d470 | bellard | struct USBPort {
|
318 | a594cfbf | bellard | USBDevice *dev; |
319 | 843d4e0c | Gerd Hoffmann | int speedmask;
|
320 | c7a2196a | Gerd Hoffmann | char path[16]; |
321 | 0d86d2be | Gerd Hoffmann | USBPortOps *ops; |
322 | bb36d470 | bellard | void *opaque;
|
323 | bb36d470 | bellard | int index; /* internal port index, may be used with the opaque */ |
324 | 72cf2d4f | Blue Swirl | QTAILQ_ENTRY(USBPort) next; |
325 | bb36d470 | bellard | }; |
326 | bb36d470 | bellard | |
327 | 4d611c9a | pbrook | typedef void USBCallback(USBPacket * packet, void *opaque); |
328 | 4d611c9a | pbrook | |
329 | f53c398a | Gerd Hoffmann | typedef enum USBPacketState { |
330 | f53c398a | Gerd Hoffmann | USB_PACKET_UNDEFINED = 0,
|
331 | f53c398a | Gerd Hoffmann | USB_PACKET_SETUP, |
332 | db4be873 | Gerd Hoffmann | USB_PACKET_QUEUED, |
333 | f53c398a | Gerd Hoffmann | USB_PACKET_ASYNC, |
334 | f53c398a | Gerd Hoffmann | USB_PACKET_COMPLETE, |
335 | f53c398a | Gerd Hoffmann | USB_PACKET_CANCELED, |
336 | f53c398a | Gerd Hoffmann | } USBPacketState; |
337 | f53c398a | Gerd Hoffmann | |
338 | db4be873 | Gerd Hoffmann | /* Structure used to hold information about an active USB packet. */
|
339 | 4d611c9a | pbrook | struct USBPacket {
|
340 | 4d611c9a | pbrook | /* Data fields for use by the driver. */
|
341 | 4d611c9a | pbrook | int pid;
|
342 | e983395d | Gerd Hoffmann | uint64_t id; |
343 | f53c398a | Gerd Hoffmann | USBEndpoint *ep; |
344 | 4f4321c1 | Gerd Hoffmann | QEMUIOVector iov; |
345 | 1b4b29a1 | Gerd Hoffmann | uint64_t parameter; /* control transfers */
|
346 | 4f4321c1 | Gerd Hoffmann | int result; /* transfer length or USB_RET_* status code */ |
347 | 4d611c9a | pbrook | /* Internal use by the USB layer. */
|
348 | f53c398a | Gerd Hoffmann | USBPacketState state; |
349 | db4be873 | Gerd Hoffmann | QTAILQ_ENTRY(USBPacket) queue; |
350 | 4d611c9a | pbrook | }; |
351 | 4d611c9a | pbrook | |
352 | 4f4321c1 | Gerd Hoffmann | void usb_packet_init(USBPacket *p);
|
353 | db4be873 | Gerd Hoffmann | void usb_packet_set_state(USBPacket *p, USBPacketState state);
|
354 | 5ac2731c | Gerd Hoffmann | void usb_packet_check_state(USBPacket *p, USBPacketState expected);
|
355 | e983395d | Gerd Hoffmann | void usb_packet_setup(USBPacket *p, int pid, USBEndpoint *ep, uint64_t id); |
356 | 4f4321c1 | Gerd Hoffmann | void usb_packet_addbuf(USBPacket *p, void *ptr, size_t len); |
357 | 4f4321c1 | Gerd Hoffmann | int usb_packet_map(USBPacket *p, QEMUSGList *sgl);
|
358 | e2f89926 | David Gibson | void usb_packet_unmap(USBPacket *p, QEMUSGList *sgl);
|
359 | 4f4321c1 | Gerd Hoffmann | void usb_packet_copy(USBPacket *p, void *ptr, size_t bytes); |
360 | 4f4321c1 | Gerd Hoffmann | void usb_packet_skip(USBPacket *p, size_t bytes);
|
361 | 4f4321c1 | Gerd Hoffmann | void usb_packet_cleanup(USBPacket *p);
|
362 | 4f4321c1 | Gerd Hoffmann | |
363 | f53c398a | Gerd Hoffmann | static inline bool usb_packet_is_inflight(USBPacket *p) |
364 | f53c398a | Gerd Hoffmann | { |
365 | db4be873 | Gerd Hoffmann | return (p->state == USB_PACKET_QUEUED ||
|
366 | db4be873 | Gerd Hoffmann | p->state == USB_PACKET_ASYNC); |
367 | f53c398a | Gerd Hoffmann | } |
368 | f53c398a | Gerd Hoffmann | |
369 | 73796fe6 | Gerd Hoffmann | USBDevice *usb_find_device(USBPort *port, uint8_t addr); |
370 | 73796fe6 | Gerd Hoffmann | |
371 | 53aa8c0e | Gerd Hoffmann | int usb_handle_packet(USBDevice *dev, USBPacket *p);
|
372 | 4ff658fb | Gerd Hoffmann | void usb_packet_complete(USBDevice *dev, USBPacket *p);
|
373 | 4ff658fb | Gerd Hoffmann | void usb_cancel_packet(USBPacket * p);
|
374 | 53aa8c0e | Gerd Hoffmann | |
375 | d8e17efd | Gerd Hoffmann | void usb_ep_init(USBDevice *dev);
|
376 | 19deaa08 | Gerd Hoffmann | void usb_ep_reset(USBDevice *dev);
|
377 | 5b6780d0 | Gerd Hoffmann | void usb_ep_dump(USBDevice *dev);
|
378 | d8e17efd | Gerd Hoffmann | struct USBEndpoint *usb_ep_get(USBDevice *dev, int pid, int ep); |
379 | d8e17efd | Gerd Hoffmann | uint8_t usb_ep_get_type(USBDevice *dev, int pid, int ep); |
380 | 82f02fe9 | Gerd Hoffmann | uint8_t usb_ep_get_ifnum(USBDevice *dev, int pid, int ep); |
381 | d8e17efd | Gerd Hoffmann | void usb_ep_set_type(USBDevice *dev, int pid, int ep, uint8_t type); |
382 | 82f02fe9 | Gerd Hoffmann | void usb_ep_set_ifnum(USBDevice *dev, int pid, int ep, uint8_t ifnum); |
383 | f003397c | Gerd Hoffmann | void usb_ep_set_max_packet_size(USBDevice *dev, int pid, int ep, |
384 | f003397c | Gerd Hoffmann | uint16_t raw); |
385 | f003397c | Gerd Hoffmann | int usb_ep_get_max_packet_size(USBDevice *dev, int pid, int ep); |
386 | 7936e0f0 | Gerd Hoffmann | void usb_ep_set_pipeline(USBDevice *dev, int pid, int ep, bool enabled); |
387 | c13a9e61 | Hans de Goede | USBPacket *usb_ep_find_packet_by_id(USBDevice *dev, int pid, int ep, |
388 | c13a9e61 | Hans de Goede | uint64_t id); |
389 | d8e17efd | Gerd Hoffmann | |
390 | 891fb2cd | Gerd Hoffmann | void usb_attach(USBPort *port);
|
391 | 891fb2cd | Gerd Hoffmann | void usb_detach(USBPort *port);
|
392 | d28f4e2d | Gerd Hoffmann | void usb_port_reset(USBPort *port);
|
393 | d28f4e2d | Gerd Hoffmann | void usb_device_reset(USBDevice *dev);
|
394 | 7567b51f | Gerd Hoffmann | void usb_wakeup(USBEndpoint *ep);
|
395 | 50b7963e | Hans de Goede | void usb_generic_async_ctrl_complete(USBDevice *s, USBPacket *p);
|
396 | bb36d470 | bellard | int set_usb_string(uint8_t *buf, const char *str); |
397 | 4d611c9a | pbrook | |
398 | bb36d470 | bellard | /* usb-linux.c */
|
399 | 3741715c | Jan Kiszka | USBDevice *usb_host_device_open(USBBus *bus, const char *devname); |
400 | 5d0c5750 | aliguori | int usb_host_device_close(const char *devname); |
401 | 376253ec | aliguori | void usb_host_info(Monitor *mon);
|
402 | 59ae540c | bellard | |
403 | e6a6d5ab | balrog | /* usb-bt.c */
|
404 | 3741715c | Jan Kiszka | USBDevice *usb_bt_init(USBBus *bus, HCIInfo *hci); |
405 | e6a6d5ab | balrog | |
406 | 87ecb68b | pbrook | /* usb ports of the VM */
|
407 | 87ecb68b | pbrook | |
408 | 87ecb68b | pbrook | #define VM_USB_HUB_SIZE 8 |
409 | 87ecb68b | pbrook | |
410 | 942ac052 | balrog | /* usb-musb.c */
|
411 | 942ac052 | balrog | enum musb_irq_source_e {
|
412 | 942ac052 | balrog | musb_irq_suspend = 0,
|
413 | 942ac052 | balrog | musb_irq_resume, |
414 | 942ac052 | balrog | musb_irq_rst_babble, |
415 | 942ac052 | balrog | musb_irq_sof, |
416 | 942ac052 | balrog | musb_irq_connect, |
417 | 942ac052 | balrog | musb_irq_disconnect, |
418 | 942ac052 | balrog | musb_irq_vbus_request, |
419 | 942ac052 | balrog | musb_irq_vbus_error, |
420 | 942ac052 | balrog | musb_irq_rx, |
421 | 942ac052 | balrog | musb_irq_tx, |
422 | 942ac052 | balrog | musb_set_vbus, |
423 | 942ac052 | balrog | musb_set_session, |
424 | 9147b752 | Peter Maydell | /* Add new interrupts here */
|
425 | 9147b752 | Peter Maydell | musb_irq_max, /* total number of interrupts defined */
|
426 | 942ac052 | balrog | }; |
427 | 942ac052 | balrog | |
428 | bc24a225 | Paul Brook | typedef struct MUSBState MUSBState; |
429 | 406c2075 | Peter Maydell | MUSBState *musb_init(DeviceState *parent_device, int gpio_base);
|
430 | 5b1cdb4e | Juha Riihimäki | void musb_reset(MUSBState *s);
|
431 | bc24a225 | Paul Brook | uint32_t musb_core_intr_get(MUSBState *s); |
432 | bc24a225 | Paul Brook | void musb_core_intr_clear(MUSBState *s, uint32_t mask);
|
433 | bc24a225 | Paul Brook | void musb_set_size(MUSBState *s, int epnum, int size, int is_tx); |
434 | 806b6024 | Gerd Hoffmann | |
435 | 806b6024 | Gerd Hoffmann | /* usb-bus.c */
|
436 | 806b6024 | Gerd Hoffmann | |
437 | 0d936928 | Anthony Liguori | #define TYPE_USB_BUS "usb-bus" |
438 | 0d936928 | Anthony Liguori | #define USB_BUS(obj) OBJECT_CHECK(USBBus, (obj), TYPE_USB_BUS)
|
439 | 0d936928 | Anthony Liguori | |
440 | 806b6024 | Gerd Hoffmann | struct USBBus {
|
441 | 806b6024 | Gerd Hoffmann | BusState qbus; |
442 | 07771f6f | Gerd Hoffmann | USBBusOps *ops; |
443 | 806b6024 | Gerd Hoffmann | int busnr;
|
444 | 806b6024 | Gerd Hoffmann | int nfree;
|
445 | 806b6024 | Gerd Hoffmann | int nused;
|
446 | 72cf2d4f | Blue Swirl | QTAILQ_HEAD(, USBPort) free; |
447 | 72cf2d4f | Blue Swirl | QTAILQ_HEAD(, USBPort) used; |
448 | 72cf2d4f | Blue Swirl | QTAILQ_ENTRY(USBBus) next; |
449 | 806b6024 | Gerd Hoffmann | }; |
450 | 806b6024 | Gerd Hoffmann | |
451 | 07771f6f | Gerd Hoffmann | struct USBBusOps {
|
452 | ae60fea9 | Hans de Goede | int (*register_companion)(USBBus *bus, USBPort *ports[],
|
453 | ae60fea9 | Hans de Goede | uint32_t portcount, uint32_t firstport); |
454 | 37f32f0f | Gerd Hoffmann | void (*wakeup_endpoint)(USBBus *bus, USBEndpoint *ep);
|
455 | 07771f6f | Gerd Hoffmann | }; |
456 | 07771f6f | Gerd Hoffmann | |
457 | 07771f6f | Gerd Hoffmann | void usb_bus_new(USBBus *bus, USBBusOps *ops, DeviceState *host);
|
458 | 806b6024 | Gerd Hoffmann | USBBus *usb_bus_find(int busnr);
|
459 | ba02430f | Anthony Liguori | void usb_legacy_register(const char *typename, const char *usbdevice_name, |
460 | 3741715c | Jan Kiszka | USBDevice *(*usbdevice_init)(USBBus *bus, |
461 | 3741715c | Jan Kiszka | const char *params)); |
462 | a5d2f727 | Gerd Hoffmann | USBDevice *usb_create(USBBus *bus, const char *name); |
463 | 806b6024 | Gerd Hoffmann | USBDevice *usb_create_simple(USBBus *bus, const char *name); |
464 | 0958b4cc | Gerd Hoffmann | USBDevice *usbdevice_create(const char *cmdline); |
465 | a5d2f727 | Gerd Hoffmann | void usb_register_port(USBBus *bus, USBPort *port, void *opaque, int index, |
466 | ace1318b | Gerd Hoffmann | USBPortOps *ops, int speedmask);
|
467 | ae60fea9 | Hans de Goede | int usb_register_companion(const char *masterbus, USBPort *ports[], |
468 | ae60fea9 | Hans de Goede | uint32_t portcount, uint32_t firstport, |
469 | ae60fea9 | Hans de Goede | void *opaque, USBPortOps *ops, int speedmask); |
470 | c7a2196a | Gerd Hoffmann | void usb_port_location(USBPort *downstream, USBPort *upstream, int portnr); |
471 | a8e662b5 | Gerd Hoffmann | void usb_unregister_port(USBBus *bus, USBPort *port);
|
472 | 891fb2cd | Gerd Hoffmann | int usb_claim_port(USBDevice *dev);
|
473 | 891fb2cd | Gerd Hoffmann | void usb_release_port(USBDevice *dev);
|
474 | a5d2f727 | Gerd Hoffmann | int usb_device_attach(USBDevice *dev);
|
475 | a8e662b5 | Gerd Hoffmann | int usb_device_detach(USBDevice *dev);
|
476 | a5d2f727 | Gerd Hoffmann | int usb_device_delete_addr(int busnr, int addr); |
477 | a5d2f727 | Gerd Hoffmann | |
478 | a5d2f727 | Gerd Hoffmann | static inline USBBus *usb_bus_from_device(USBDevice *d) |
479 | a5d2f727 | Gerd Hoffmann | { |
480 | a5d2f727 | Gerd Hoffmann | return DO_UPCAST(USBBus, qbus, d->qdev.parent_bus);
|
481 | a5d2f727 | Gerd Hoffmann | } |
482 | 701a8f76 | Paolo Bonzini | |
483 | 701a8f76 | Paolo Bonzini | extern const VMStateDescription vmstate_usb_device; |
484 | 701a8f76 | Paolo Bonzini | |
485 | 701a8f76 | Paolo Bonzini | #define VMSTATE_USB_DEVICE(_field, _state) { \
|
486 | 701a8f76 | Paolo Bonzini | .name = (stringify(_field)), \ |
487 | 701a8f76 | Paolo Bonzini | .size = sizeof(USBDevice), \
|
488 | 701a8f76 | Paolo Bonzini | .vmsd = &vmstate_usb_device, \ |
489 | 701a8f76 | Paolo Bonzini | .flags = VMS_STRUCT, \ |
490 | 701a8f76 | Paolo Bonzini | .offset = vmstate_offset_value(_state, _field, USBDevice), \ |
491 | 701a8f76 | Paolo Bonzini | } |
492 | 701a8f76 | Paolo Bonzini | |
493 | 73796fe6 | Gerd Hoffmann | USBDevice *usb_device_find_device(USBDevice *dev, uint8_t addr); |
494 | 73796fe6 | Gerd Hoffmann | |
495 | 62aed765 | Anthony Liguori | void usb_device_cancel_packet(USBDevice *dev, USBPacket *p);
|
496 | 62aed765 | Anthony Liguori | |
497 | 62aed765 | Anthony Liguori | void usb_device_handle_attach(USBDevice *dev);
|
498 | 62aed765 | Anthony Liguori | |
499 | 62aed765 | Anthony Liguori | void usb_device_handle_reset(USBDevice *dev);
|
500 | 62aed765 | Anthony Liguori | |
501 | 62aed765 | Anthony Liguori | int usb_device_handle_control(USBDevice *dev, USBPacket *p, int request, int value, |
502 | 62aed765 | Anthony Liguori | int index, int length, uint8_t *data); |
503 | 62aed765 | Anthony Liguori | |
504 | 62aed765 | Anthony Liguori | int usb_device_handle_data(USBDevice *dev, USBPacket *p);
|
505 | 62aed765 | Anthony Liguori | |
506 | 62aed765 | Anthony Liguori | void usb_device_set_interface(USBDevice *dev, int interface, |
507 | 62aed765 | Anthony Liguori | int alt_old, int alt_new); |
508 | 62aed765 | Anthony Liguori | |
509 | 62aed765 | Anthony Liguori | const char *usb_device_get_product_desc(USBDevice *dev); |
510 | 62aed765 | Anthony Liguori | |
511 | 62aed765 | Anthony Liguori | const USBDesc *usb_device_get_usb_desc(USBDevice *dev);
|
512 | 62aed765 | Anthony Liguori | |
513 | 62aed765 | Anthony Liguori | #endif
|