root / hw / usb.h @ 0dad6c35
History | View | Annotate | Download (14.8 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 | bb36d470 | bellard | /* specific usb messages, also sent in the 'pid' parameter */
|
43 | bb36d470 | bellard | #define USB_MSG_ATTACH 0x100 |
44 | bb36d470 | bellard | #define USB_MSG_DETACH 0x101 |
45 | bb36d470 | bellard | #define USB_MSG_RESET 0x102 |
46 | bb36d470 | bellard | |
47 | 5fafdf24 | ths | #define USB_RET_NODEV (-1) |
48 | bb36d470 | bellard | #define USB_RET_NAK (-2) |
49 | bb36d470 | bellard | #define USB_RET_STALL (-3) |
50 | bb36d470 | bellard | #define USB_RET_BABBLE (-4) |
51 | 4d611c9a | pbrook | #define USB_RET_ASYNC (-5) |
52 | bb36d470 | bellard | |
53 | bb36d470 | bellard | #define USB_SPEED_LOW 0 |
54 | bb36d470 | bellard | #define USB_SPEED_FULL 1 |
55 | bb36d470 | bellard | #define USB_SPEED_HIGH 2 |
56 | 843d4e0c | Gerd Hoffmann | #define USB_SPEED_SUPER 3 |
57 | 843d4e0c | Gerd Hoffmann | |
58 | 843d4e0c | Gerd Hoffmann | #define USB_SPEED_MASK_LOW (1 << USB_SPEED_LOW) |
59 | 843d4e0c | Gerd Hoffmann | #define USB_SPEED_MASK_FULL (1 << USB_SPEED_FULL) |
60 | 843d4e0c | Gerd Hoffmann | #define USB_SPEED_MASK_HIGH (1 << USB_SPEED_HIGH) |
61 | 843d4e0c | Gerd Hoffmann | #define USB_SPEED_MASK_SUPER (1 << USB_SPEED_SUPER) |
62 | bb36d470 | bellard | |
63 | bb36d470 | bellard | #define USB_STATE_NOTATTACHED 0 |
64 | bb36d470 | bellard | #define USB_STATE_ATTACHED 1 |
65 | bb36d470 | bellard | //#define USB_STATE_POWERED 2
|
66 | bb36d470 | bellard | #define USB_STATE_DEFAULT 3 |
67 | bb36d470 | bellard | //#define USB_STATE_ADDRESS 4
|
68 | bb36d470 | bellard | //#define USB_STATE_CONFIGURED 5
|
69 | bb36d470 | bellard | #define USB_STATE_SUSPENDED 6 |
70 | bb36d470 | bellard | |
71 | a594cfbf | bellard | #define USB_CLASS_AUDIO 1 |
72 | a594cfbf | bellard | #define USB_CLASS_COMM 2 |
73 | a594cfbf | bellard | #define USB_CLASS_HID 3 |
74 | a594cfbf | bellard | #define USB_CLASS_PHYSICAL 5 |
75 | a594cfbf | bellard | #define USB_CLASS_STILL_IMAGE 6 |
76 | a594cfbf | bellard | #define USB_CLASS_PRINTER 7 |
77 | a594cfbf | bellard | #define USB_CLASS_MASS_STORAGE 8 |
78 | a594cfbf | bellard | #define USB_CLASS_HUB 9 |
79 | a594cfbf | bellard | #define USB_CLASS_CDC_DATA 0x0a |
80 | a594cfbf | bellard | #define USB_CLASS_CSCID 0x0b |
81 | a594cfbf | bellard | #define USB_CLASS_CONTENT_SEC 0x0d |
82 | a594cfbf | bellard | #define USB_CLASS_APP_SPEC 0xfe |
83 | a594cfbf | bellard | #define USB_CLASS_VENDOR_SPEC 0xff |
84 | a594cfbf | bellard | |
85 | b870472d | H. Peter Anvin | #define USB_SUBCLASS_UNDEFINED 0 |
86 | b870472d | H. Peter Anvin | #define USB_SUBCLASS_AUDIO_CONTROL 1 |
87 | b870472d | H. Peter Anvin | #define USB_SUBCLASS_AUDIO_STREAMING 2 |
88 | b870472d | H. Peter Anvin | #define USB_SUBCLASS_AUDIO_MIDISTREAMING 3 |
89 | b870472d | H. Peter Anvin | |
90 | bb36d470 | bellard | #define USB_DIR_OUT 0 |
91 | bb36d470 | bellard | #define USB_DIR_IN 0x80 |
92 | bb36d470 | bellard | |
93 | bb36d470 | bellard | #define USB_TYPE_MASK (0x03 << 5) |
94 | bb36d470 | bellard | #define USB_TYPE_STANDARD (0x00 << 5) |
95 | bb36d470 | bellard | #define USB_TYPE_CLASS (0x01 << 5) |
96 | bb36d470 | bellard | #define USB_TYPE_VENDOR (0x02 << 5) |
97 | bb36d470 | bellard | #define USB_TYPE_RESERVED (0x03 << 5) |
98 | bb36d470 | bellard | |
99 | bb36d470 | bellard | #define USB_RECIP_MASK 0x1f |
100 | bb36d470 | bellard | #define USB_RECIP_DEVICE 0x00 |
101 | bb36d470 | bellard | #define USB_RECIP_INTERFACE 0x01 |
102 | bb36d470 | bellard | #define USB_RECIP_ENDPOINT 0x02 |
103 | bb36d470 | bellard | #define USB_RECIP_OTHER 0x03 |
104 | bb36d470 | bellard | |
105 | bb36d470 | bellard | #define DeviceRequest ((USB_DIR_IN|USB_TYPE_STANDARD|USB_RECIP_DEVICE)<<8) |
106 | bb36d470 | bellard | #define DeviceOutRequest ((USB_DIR_OUT|USB_TYPE_STANDARD|USB_RECIP_DEVICE)<<8) |
107 | 59ae540c | bellard | #define InterfaceRequest \
|
108 | 59ae540c | bellard | ((USB_DIR_IN|USB_TYPE_STANDARD|USB_RECIP_INTERFACE)<<8)
|
109 | 59ae540c | bellard | #define InterfaceOutRequest \
|
110 | 59ae540c | bellard | ((USB_DIR_OUT|USB_TYPE_STANDARD|USB_RECIP_INTERFACE)<<8)
|
111 | 59ae540c | bellard | #define EndpointRequest ((USB_DIR_IN|USB_TYPE_STANDARD|USB_RECIP_ENDPOINT)<<8) |
112 | 59ae540c | bellard | #define EndpointOutRequest \
|
113 | 59ae540c | bellard | ((USB_DIR_OUT|USB_TYPE_STANDARD|USB_RECIP_ENDPOINT)<<8)
|
114 | f3571b1a | Max Reitz | #define ClassInterfaceRequest \
|
115 | f3571b1a | Max Reitz | ((USB_DIR_IN|USB_TYPE_CLASS|USB_RECIP_INTERFACE)<<8)
|
116 | f3571b1a | Max Reitz | #define ClassInterfaceOutRequest \
|
117 | f3571b1a | Max Reitz | ((USB_DIR_OUT|USB_TYPE_CLASS|USB_RECIP_INTERFACE)<<8)
|
118 | bb36d470 | bellard | |
119 | bb36d470 | bellard | #define USB_REQ_GET_STATUS 0x00 |
120 | bb36d470 | bellard | #define USB_REQ_CLEAR_FEATURE 0x01 |
121 | bb36d470 | bellard | #define USB_REQ_SET_FEATURE 0x03 |
122 | bb36d470 | bellard | #define USB_REQ_SET_ADDRESS 0x05 |
123 | bb36d470 | bellard | #define USB_REQ_GET_DESCRIPTOR 0x06 |
124 | bb36d470 | bellard | #define USB_REQ_SET_DESCRIPTOR 0x07 |
125 | bb36d470 | bellard | #define USB_REQ_GET_CONFIGURATION 0x08 |
126 | bb36d470 | bellard | #define USB_REQ_SET_CONFIGURATION 0x09 |
127 | bb36d470 | bellard | #define USB_REQ_GET_INTERFACE 0x0A |
128 | bb36d470 | bellard | #define USB_REQ_SET_INTERFACE 0x0B |
129 | bb36d470 | bellard | #define USB_REQ_SYNCH_FRAME 0x0C |
130 | bb36d470 | bellard | |
131 | bb36d470 | bellard | #define USB_DEVICE_SELF_POWERED 0 |
132 | bb36d470 | bellard | #define USB_DEVICE_REMOTE_WAKEUP 1 |
133 | bb36d470 | bellard | |
134 | bb36d470 | bellard | #define USB_DT_DEVICE 0x01 |
135 | bb36d470 | bellard | #define USB_DT_CONFIG 0x02 |
136 | bb36d470 | bellard | #define USB_DT_STRING 0x03 |
137 | bb36d470 | bellard | #define USB_DT_INTERFACE 0x04 |
138 | bb36d470 | bellard | #define USB_DT_ENDPOINT 0x05 |
139 | 25620cba | Gerd Hoffmann | #define USB_DT_DEVICE_QUALIFIER 0x06 |
140 | 25620cba | Gerd Hoffmann | #define USB_DT_OTHER_SPEED_CONFIG 0x07 |
141 | a7fb71d1 | Gerd Hoffmann | #define USB_DT_DEBUG 0x0A |
142 | c6d3ad0f | Brad Hards | #define USB_DT_INTERFACE_ASSOC 0x0B |
143 | b870472d | H. Peter Anvin | #define USB_DT_CS_INTERFACE 0x24 |
144 | b870472d | H. Peter Anvin | #define USB_DT_CS_ENDPOINT 0x25 |
145 | bb36d470 | bellard | |
146 | 942ac052 | balrog | #define USB_ENDPOINT_XFER_CONTROL 0 |
147 | 942ac052 | balrog | #define USB_ENDPOINT_XFER_ISOC 1 |
148 | 942ac052 | balrog | #define USB_ENDPOINT_XFER_BULK 2 |
149 | 942ac052 | balrog | #define USB_ENDPOINT_XFER_INT 3 |
150 | d8e17efd | Gerd Hoffmann | #define USB_ENDPOINT_XFER_INVALID 255 |
151 | 942ac052 | balrog | |
152 | 806b6024 | Gerd Hoffmann | typedef struct USBBus USBBus; |
153 | 07771f6f | Gerd Hoffmann | typedef struct USBBusOps USBBusOps; |
154 | bb36d470 | bellard | typedef struct USBPort USBPort; |
155 | bb36d470 | bellard | typedef struct USBDevice USBDevice; |
156 | 4d611c9a | pbrook | typedef struct USBPacket USBPacket; |
157 | d8e17efd | Gerd Hoffmann | typedef struct USBEndpoint USBEndpoint; |
158 | bb36d470 | bellard | |
159 | 37fb59d3 | Gerd Hoffmann | typedef struct USBDesc USBDesc; |
160 | 37fb59d3 | Gerd Hoffmann | typedef struct USBDescID USBDescID; |
161 | 37fb59d3 | Gerd Hoffmann | typedef struct USBDescDevice USBDescDevice; |
162 | 37fb59d3 | Gerd Hoffmann | typedef struct USBDescConfig USBDescConfig; |
163 | 6e625fc7 | Brad Hards | typedef struct USBDescIfaceAssoc USBDescIfaceAssoc; |
164 | 37fb59d3 | Gerd Hoffmann | typedef struct USBDescIface USBDescIface; |
165 | 37fb59d3 | Gerd Hoffmann | typedef struct USBDescEndpoint USBDescEndpoint; |
166 | 37fb59d3 | Gerd Hoffmann | typedef struct USBDescOther USBDescOther; |
167 | 132a3f55 | Gerd Hoffmann | typedef struct USBDescString USBDescString; |
168 | 132a3f55 | Gerd Hoffmann | |
169 | 132a3f55 | Gerd Hoffmann | struct USBDescString {
|
170 | 132a3f55 | Gerd Hoffmann | uint8_t index; |
171 | 132a3f55 | Gerd Hoffmann | char *str;
|
172 | 132a3f55 | Gerd Hoffmann | QLIST_ENTRY(USBDescString) next; |
173 | 132a3f55 | Gerd Hoffmann | }; |
174 | 37fb59d3 | Gerd Hoffmann | |
175 | 1de14d43 | Gerd Hoffmann | #define USB_MAX_ENDPOINTS 15 |
176 | 1de14d43 | Gerd Hoffmann | #define USB_MAX_INTERFACES 16 |
177 | 1de14d43 | Gerd Hoffmann | |
178 | d8e17efd | Gerd Hoffmann | struct USBEndpoint {
|
179 | d8e17efd | Gerd Hoffmann | uint8_t type; |
180 | 82f02fe9 | Gerd Hoffmann | uint8_t ifnum; |
181 | f003397c | Gerd Hoffmann | int max_packet_size;
|
182 | 25d5de7d | Gerd Hoffmann | USBDevice *dev; |
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 | 806b6024 | Gerd Hoffmann | * Process USB packet.
|
238 | 89b9b79f | aliguori | * Called by the HC (Host Controller).
|
239 | 89b9b79f | aliguori | *
|
240 | 806b6024 | Gerd Hoffmann | * Returns length of the transaction
|
241 | 89b9b79f | aliguori | * or one of the USB_RET_XXX codes.
|
242 | 806b6024 | Gerd Hoffmann | */
|
243 | 4d611c9a | pbrook | int (*handle_packet)(USBDevice *dev, USBPacket *p);
|
244 | 89b9b79f | aliguori | |
245 | 806b6024 | Gerd Hoffmann | /*
|
246 | eb5e680a | Gerd Hoffmann | * Called when a packet is canceled.
|
247 | eb5e680a | Gerd Hoffmann | */
|
248 | eb5e680a | Gerd Hoffmann | void (*cancel_packet)(USBDevice *dev, USBPacket *p);
|
249 | eb5e680a | Gerd Hoffmann | |
250 | eb5e680a | Gerd Hoffmann | /*
|
251 | 89b9b79f | aliguori | * Called when device is destroyed.
|
252 | 89b9b79f | aliguori | */
|
253 | 059809e4 | bellard | void (*handle_destroy)(USBDevice *dev);
|
254 | 059809e4 | bellard | |
255 | 89b9b79f | aliguori | /*
|
256 | b6f77fbe | Gerd Hoffmann | * Attach the device
|
257 | b6f77fbe | Gerd Hoffmann | */
|
258 | b6f77fbe | Gerd Hoffmann | void (*handle_attach)(USBDevice *dev);
|
259 | b6f77fbe | Gerd Hoffmann | |
260 | b6f77fbe | Gerd Hoffmann | /*
|
261 | 89b9b79f | aliguori | * Reset the device
|
262 | 806b6024 | Gerd Hoffmann | */
|
263 | 059809e4 | bellard | void (*handle_reset)(USBDevice *dev);
|
264 | 89b9b79f | aliguori | |
265 | 89b9b79f | aliguori | /*
|
266 | 89b9b79f | aliguori | * Process control request.
|
267 | 89b9b79f | aliguori | * Called from handle_packet().
|
268 | 89b9b79f | aliguori | *
|
269 | 89b9b79f | aliguori | * Returns length or one of the USB_RET_ codes.
|
270 | 89b9b79f | aliguori | */
|
271 | 007fd62f | Hans de Goede | int (*handle_control)(USBDevice *dev, USBPacket *p, int request, int value, |
272 | bb36d470 | bellard | int index, int length, uint8_t *data); |
273 | 89b9b79f | aliguori | |
274 | 89b9b79f | aliguori | /*
|
275 | 89b9b79f | aliguori | * Process data transfers (both BULK and ISOC).
|
276 | 89b9b79f | aliguori | * Called from handle_packet().
|
277 | 89b9b79f | aliguori | *
|
278 | 89b9b79f | aliguori | * Returns length or one of the USB_RET_ codes.
|
279 | 89b9b79f | aliguori | */
|
280 | 4d611c9a | pbrook | int (*handle_data)(USBDevice *dev, USBPacket *p);
|
281 | 0958b4cc | Gerd Hoffmann | |
282 | 1de14d43 | Gerd Hoffmann | void (*set_interface)(USBDevice *dev, int interface, |
283 | 1de14d43 | Gerd Hoffmann | int alt_old, int alt_new); |
284 | 1de14d43 | Gerd Hoffmann | |
285 | 06384698 | Markus Armbruster | const char *product_desc; |
286 | 37fb59d3 | Gerd Hoffmann | const USBDesc *usb_desc;
|
287 | 62aed765 | Anthony Liguori | } USBDeviceClass; |
288 | bb36d470 | bellard | |
289 | 0d86d2be | Gerd Hoffmann | typedef struct USBPortOps { |
290 | 618c169b | Gerd Hoffmann | void (*attach)(USBPort *port);
|
291 | 618c169b | Gerd Hoffmann | void (*detach)(USBPort *port);
|
292 | 4706ab6c | Hans de Goede | /*
|
293 | 4706ab6c | Hans de Goede | * This gets called when a device downstream from the device attached to
|
294 | 4706ab6c | Hans de Goede | * the port (iow attached through a hub) gets detached.
|
295 | 4706ab6c | Hans de Goede | */
|
296 | 4706ab6c | Hans de Goede | void (*child_detach)(USBPort *port, USBDevice *child);
|
297 | d47e59b8 | Hans de Goede | void (*wakeup)(USBPort *port);
|
298 | d47e59b8 | Hans de Goede | /*
|
299 | d47e59b8 | Hans de Goede | * Note that port->dev will be different then the device from which
|
300 | d47e59b8 | Hans de Goede | * the packet originated when a hub is involved, if you want the orginating
|
301 | d47e59b8 | Hans de Goede | * device use p->owner
|
302 | d47e59b8 | Hans de Goede | */
|
303 | d47e59b8 | Hans de Goede | void (*complete)(USBPort *port, USBPacket *p);
|
304 | 0d86d2be | Gerd Hoffmann | } USBPortOps; |
305 | 0d92ed30 | pbrook | |
306 | bb36d470 | bellard | /* USB port on which a device can be connected */
|
307 | bb36d470 | bellard | struct USBPort {
|
308 | a594cfbf | bellard | USBDevice *dev; |
309 | 843d4e0c | Gerd Hoffmann | int speedmask;
|
310 | c7a2196a | Gerd Hoffmann | char path[16]; |
311 | 0d86d2be | Gerd Hoffmann | USBPortOps *ops; |
312 | bb36d470 | bellard | void *opaque;
|
313 | bb36d470 | bellard | int index; /* internal port index, may be used with the opaque */ |
314 | 72cf2d4f | Blue Swirl | QTAILQ_ENTRY(USBPort) next; |
315 | bb36d470 | bellard | }; |
316 | bb36d470 | bellard | |
317 | 4d611c9a | pbrook | typedef void USBCallback(USBPacket * packet, void *opaque); |
318 | 4d611c9a | pbrook | |
319 | 4d611c9a | pbrook | /* Structure used to hold information about an active USB packet. */
|
320 | 4d611c9a | pbrook | struct USBPacket {
|
321 | 4d611c9a | pbrook | /* Data fields for use by the driver. */
|
322 | 4d611c9a | pbrook | int pid;
|
323 | 4d611c9a | pbrook | uint8_t devaddr; |
324 | 4d611c9a | pbrook | uint8_t devep; |
325 | 4f4321c1 | Gerd Hoffmann | QEMUIOVector iov; |
326 | 4f4321c1 | Gerd Hoffmann | int result; /* transfer length or USB_RET_* status code */ |
327 | 4d611c9a | pbrook | /* Internal use by the USB layer. */
|
328 | 25d5de7d | Gerd Hoffmann | USBEndpoint *owner; |
329 | 4d611c9a | pbrook | }; |
330 | 4d611c9a | pbrook | |
331 | 4f4321c1 | Gerd Hoffmann | void usb_packet_init(USBPacket *p);
|
332 | 4f4321c1 | Gerd Hoffmann | void usb_packet_setup(USBPacket *p, int pid, uint8_t addr, uint8_t ep); |
333 | 4f4321c1 | Gerd Hoffmann | void usb_packet_addbuf(USBPacket *p, void *ptr, size_t len); |
334 | 4f4321c1 | Gerd Hoffmann | int usb_packet_map(USBPacket *p, QEMUSGList *sgl);
|
335 | 4f4321c1 | Gerd Hoffmann | void usb_packet_unmap(USBPacket *p);
|
336 | 4f4321c1 | Gerd Hoffmann | void usb_packet_copy(USBPacket *p, void *ptr, size_t bytes); |
337 | 4f4321c1 | Gerd Hoffmann | void usb_packet_skip(USBPacket *p, size_t bytes);
|
338 | 4f4321c1 | Gerd Hoffmann | void usb_packet_cleanup(USBPacket *p);
|
339 | 4f4321c1 | Gerd Hoffmann | |
340 | 53aa8c0e | Gerd Hoffmann | int usb_handle_packet(USBDevice *dev, USBPacket *p);
|
341 | 4ff658fb | Gerd Hoffmann | void usb_packet_complete(USBDevice *dev, USBPacket *p);
|
342 | 4ff658fb | Gerd Hoffmann | void usb_cancel_packet(USBPacket * p);
|
343 | 53aa8c0e | Gerd Hoffmann | |
344 | d8e17efd | Gerd Hoffmann | void usb_ep_init(USBDevice *dev);
|
345 | 5b6780d0 | Gerd Hoffmann | void usb_ep_dump(USBDevice *dev);
|
346 | d8e17efd | Gerd Hoffmann | struct USBEndpoint *usb_ep_get(USBDevice *dev, int pid, int ep); |
347 | d8e17efd | Gerd Hoffmann | uint8_t usb_ep_get_type(USBDevice *dev, int pid, int ep); |
348 | 82f02fe9 | Gerd Hoffmann | uint8_t usb_ep_get_ifnum(USBDevice *dev, int pid, int ep); |
349 | d8e17efd | Gerd Hoffmann | void usb_ep_set_type(USBDevice *dev, int pid, int ep, uint8_t type); |
350 | 82f02fe9 | Gerd Hoffmann | void usb_ep_set_ifnum(USBDevice *dev, int pid, int ep, uint8_t ifnum); |
351 | f003397c | Gerd Hoffmann | void usb_ep_set_max_packet_size(USBDevice *dev, int pid, int ep, |
352 | f003397c | Gerd Hoffmann | uint16_t raw); |
353 | f003397c | Gerd Hoffmann | int usb_ep_get_max_packet_size(USBDevice *dev, int pid, int ep); |
354 | d8e17efd | Gerd Hoffmann | |
355 | 891fb2cd | Gerd Hoffmann | void usb_attach(USBPort *port);
|
356 | 891fb2cd | Gerd Hoffmann | void usb_detach(USBPort *port);
|
357 | e0b8e72d | Gerd Hoffmann | void usb_reset(USBPort *port);
|
358 | 01eacab6 | Gerd Hoffmann | void usb_wakeup(USBDevice *dev);
|
359 | 4d611c9a | pbrook | int usb_generic_handle_packet(USBDevice *s, USBPacket *p);
|
360 | 50b7963e | Hans de Goede | void usb_generic_async_ctrl_complete(USBDevice *s, USBPacket *p);
|
361 | bb36d470 | bellard | int set_usb_string(uint8_t *buf, const char *str); |
362 | 4d611c9a | pbrook | void usb_send_msg(USBDevice *dev, int msg); |
363 | 4d611c9a | pbrook | |
364 | bb36d470 | bellard | /* usb-linux.c */
|
365 | a594cfbf | bellard | USBDevice *usb_host_device_open(const char *devname); |
366 | 5d0c5750 | aliguori | int usb_host_device_close(const char *devname); |
367 | 376253ec | aliguori | void usb_host_info(Monitor *mon);
|
368 | 59ae540c | bellard | |
369 | e6a6d5ab | balrog | /* usb-bt.c */
|
370 | e6a6d5ab | balrog | USBDevice *usb_bt_init(HCIInfo *hci); |
371 | e6a6d5ab | balrog | |
372 | 87ecb68b | pbrook | /* usb ports of the VM */
|
373 | 87ecb68b | pbrook | |
374 | 87ecb68b | pbrook | #define VM_USB_HUB_SIZE 8 |
375 | 87ecb68b | pbrook | |
376 | 942ac052 | balrog | /* usb-musb.c */
|
377 | 942ac052 | balrog | enum musb_irq_source_e {
|
378 | 942ac052 | balrog | musb_irq_suspend = 0,
|
379 | 942ac052 | balrog | musb_irq_resume, |
380 | 942ac052 | balrog | musb_irq_rst_babble, |
381 | 942ac052 | balrog | musb_irq_sof, |
382 | 942ac052 | balrog | musb_irq_connect, |
383 | 942ac052 | balrog | musb_irq_disconnect, |
384 | 942ac052 | balrog | musb_irq_vbus_request, |
385 | 942ac052 | balrog | musb_irq_vbus_error, |
386 | 942ac052 | balrog | musb_irq_rx, |
387 | 942ac052 | balrog | musb_irq_tx, |
388 | 942ac052 | balrog | musb_set_vbus, |
389 | 942ac052 | balrog | musb_set_session, |
390 | 9147b752 | Peter Maydell | /* Add new interrupts here */
|
391 | 9147b752 | Peter Maydell | musb_irq_max, /* total number of interrupts defined */
|
392 | 942ac052 | balrog | }; |
393 | 942ac052 | balrog | |
394 | bc24a225 | Paul Brook | typedef struct MUSBState MUSBState; |
395 | 406c2075 | Peter Maydell | MUSBState *musb_init(DeviceState *parent_device, int gpio_base);
|
396 | 5b1cdb4e | Juha Riihimäki | void musb_reset(MUSBState *s);
|
397 | bc24a225 | Paul Brook | uint32_t musb_core_intr_get(MUSBState *s); |
398 | bc24a225 | Paul Brook | void musb_core_intr_clear(MUSBState *s, uint32_t mask);
|
399 | bc24a225 | Paul Brook | void musb_set_size(MUSBState *s, int epnum, int size, int is_tx); |
400 | 806b6024 | Gerd Hoffmann | |
401 | 806b6024 | Gerd Hoffmann | /* usb-bus.c */
|
402 | 806b6024 | Gerd Hoffmann | |
403 | 806b6024 | Gerd Hoffmann | struct USBBus {
|
404 | 806b6024 | Gerd Hoffmann | BusState qbus; |
405 | 07771f6f | Gerd Hoffmann | USBBusOps *ops; |
406 | 806b6024 | Gerd Hoffmann | int busnr;
|
407 | 806b6024 | Gerd Hoffmann | int nfree;
|
408 | 806b6024 | Gerd Hoffmann | int nused;
|
409 | 72cf2d4f | Blue Swirl | QTAILQ_HEAD(, USBPort) free; |
410 | 72cf2d4f | Blue Swirl | QTAILQ_HEAD(, USBPort) used; |
411 | 72cf2d4f | Blue Swirl | QTAILQ_ENTRY(USBBus) next; |
412 | 806b6024 | Gerd Hoffmann | }; |
413 | 806b6024 | Gerd Hoffmann | |
414 | 07771f6f | Gerd Hoffmann | struct USBBusOps {
|
415 | ae60fea9 | Hans de Goede | int (*register_companion)(USBBus *bus, USBPort *ports[],
|
416 | ae60fea9 | Hans de Goede | uint32_t portcount, uint32_t firstport); |
417 | 07771f6f | Gerd Hoffmann | }; |
418 | 07771f6f | Gerd Hoffmann | |
419 | 07771f6f | Gerd Hoffmann | void usb_bus_new(USBBus *bus, USBBusOps *ops, DeviceState *host);
|
420 | 806b6024 | Gerd Hoffmann | USBBus *usb_bus_find(int busnr);
|
421 | ba02430f | Anthony Liguori | void usb_legacy_register(const char *typename, const char *usbdevice_name, |
422 | ba02430f | Anthony Liguori | USBDevice *(*usbdevice_init)(const char *params)); |
423 | a5d2f727 | Gerd Hoffmann | USBDevice *usb_create(USBBus *bus, const char *name); |
424 | 806b6024 | Gerd Hoffmann | USBDevice *usb_create_simple(USBBus *bus, const char *name); |
425 | 0958b4cc | Gerd Hoffmann | USBDevice *usbdevice_create(const char *cmdline); |
426 | a5d2f727 | Gerd Hoffmann | void usb_register_port(USBBus *bus, USBPort *port, void *opaque, int index, |
427 | ace1318b | Gerd Hoffmann | USBPortOps *ops, int speedmask);
|
428 | ae60fea9 | Hans de Goede | int usb_register_companion(const char *masterbus, USBPort *ports[], |
429 | ae60fea9 | Hans de Goede | uint32_t portcount, uint32_t firstport, |
430 | ae60fea9 | Hans de Goede | void *opaque, USBPortOps *ops, int speedmask); |
431 | c7a2196a | Gerd Hoffmann | void usb_port_location(USBPort *downstream, USBPort *upstream, int portnr); |
432 | a8e662b5 | Gerd Hoffmann | void usb_unregister_port(USBBus *bus, USBPort *port);
|
433 | 891fb2cd | Gerd Hoffmann | int usb_claim_port(USBDevice *dev);
|
434 | 891fb2cd | Gerd Hoffmann | void usb_release_port(USBDevice *dev);
|
435 | a5d2f727 | Gerd Hoffmann | int usb_device_attach(USBDevice *dev);
|
436 | a8e662b5 | Gerd Hoffmann | int usb_device_detach(USBDevice *dev);
|
437 | a5d2f727 | Gerd Hoffmann | int usb_device_delete_addr(int busnr, int addr); |
438 | a5d2f727 | Gerd Hoffmann | |
439 | a5d2f727 | Gerd Hoffmann | static inline USBBus *usb_bus_from_device(USBDevice *d) |
440 | a5d2f727 | Gerd Hoffmann | { |
441 | a5d2f727 | Gerd Hoffmann | return DO_UPCAST(USBBus, qbus, d->qdev.parent_bus);
|
442 | a5d2f727 | Gerd Hoffmann | } |
443 | 701a8f76 | Paolo Bonzini | |
444 | 701a8f76 | Paolo Bonzini | extern const VMStateDescription vmstate_usb_device; |
445 | 701a8f76 | Paolo Bonzini | |
446 | 701a8f76 | Paolo Bonzini | #define VMSTATE_USB_DEVICE(_field, _state) { \
|
447 | 701a8f76 | Paolo Bonzini | .name = (stringify(_field)), \ |
448 | 701a8f76 | Paolo Bonzini | .size = sizeof(USBDevice), \
|
449 | 701a8f76 | Paolo Bonzini | .vmsd = &vmstate_usb_device, \ |
450 | 701a8f76 | Paolo Bonzini | .flags = VMS_STRUCT, \ |
451 | 701a8f76 | Paolo Bonzini | .offset = vmstate_offset_value(_state, _field, USBDevice), \ |
452 | 701a8f76 | Paolo Bonzini | } |
453 | 701a8f76 | Paolo Bonzini | |
454 | 62aed765 | Anthony Liguori | int usb_device_handle_packet(USBDevice *dev, USBPacket *p);
|
455 | 62aed765 | Anthony Liguori | |
456 | 62aed765 | Anthony Liguori | void usb_device_cancel_packet(USBDevice *dev, USBPacket *p);
|
457 | 62aed765 | Anthony Liguori | |
458 | 62aed765 | Anthony Liguori | void usb_device_handle_attach(USBDevice *dev);
|
459 | 62aed765 | Anthony Liguori | |
460 | 62aed765 | Anthony Liguori | void usb_device_handle_reset(USBDevice *dev);
|
461 | 62aed765 | Anthony Liguori | |
462 | 62aed765 | Anthony Liguori | int usb_device_handle_control(USBDevice *dev, USBPacket *p, int request, int value, |
463 | 62aed765 | Anthony Liguori | int index, int length, uint8_t *data); |
464 | 62aed765 | Anthony Liguori | |
465 | 62aed765 | Anthony Liguori | int usb_device_handle_data(USBDevice *dev, USBPacket *p);
|
466 | 62aed765 | Anthony Liguori | |
467 | 62aed765 | Anthony Liguori | void usb_device_set_interface(USBDevice *dev, int interface, |
468 | 62aed765 | Anthony Liguori | int alt_old, int alt_new); |
469 | 62aed765 | Anthony Liguori | |
470 | 62aed765 | Anthony Liguori | const char *usb_device_get_product_desc(USBDevice *dev); |
471 | 62aed765 | Anthony Liguori | |
472 | 62aed765 | Anthony Liguori | const USBDesc *usb_device_get_usb_desc(USBDevice *dev);
|
473 | 62aed765 | Anthony Liguori | |
474 | 62aed765 | Anthony Liguori | #endif
|