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