1
/* usb.c - Generic USB interfaces. */
3
* GRUB -- GRand Unified Bootloader
4
* Copyright (C) 2008 Free Software Foundation, Inc.
6
* GRUB is free software: you can redistribute it and/or modify
7
* it under the terms of the GNU General Public License as published by
8
* the Free Software Foundation, either version 3 of the License, or
9
* (at your option) any later version.
11
* GRUB is distributed in the hope that it will be useful,
12
* but WITHOUT ANY WARRANTY; without even the implied warranty of
13
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14
* GNU General Public License for more details.
16
* You should have received a copy of the GNU General Public License
17
* along with GRUB. If not, see <http://www.gnu.org/licenses/>.
23
#include <grub/misc.h>
24
#include <grub/list.h>
26
static grub_usb_controller_dev_t grub_usb_list;
27
struct grub_usb_attach_desc *attach_hooks;
30
grub_usb_controller_dev_register (grub_usb_controller_dev_t usb)
32
auto int iterate_hook (grub_usb_controller_t dev);
34
/* Iterate over all controllers found by the driver. */
35
int iterate_hook (grub_usb_controller_t dev)
39
/* Enable the ports of the USB Root Hub. */
40
grub_usb_root_hub (dev);
45
usb->next = grub_usb_list;
49
usb->iterate (iterate_hook);
53
grub_usb_controller_dev_unregister (grub_usb_controller_dev_t usb)
55
grub_usb_controller_dev_t *p, q;
57
for (p = &grub_usb_list, q = *p; q; p = &(q->next), q = q->next)
67
grub_usb_controller_iterate (int (*hook) (grub_usb_controller_t dev))
69
grub_usb_controller_dev_t p;
71
auto int iterate_hook (grub_usb_controller_t dev);
73
int iterate_hook (grub_usb_controller_t dev)
81
/* Iterate over all controller drivers. */
82
for (p = grub_usb_list; p; p = p->next)
84
/* Iterate over the busses of the controllers. XXX: Actually, a
85
hub driver should do this. */
86
if (p->iterate (iterate_hook))
96
grub_usb_clear_halt (grub_usb_device_t dev, int endpoint)
98
dev->toggle[endpoint] = 0;
99
return grub_usb_control_msg (dev, (GRUB_USB_REQTYPE_OUT
100
| GRUB_USB_REQTYPE_STANDARD
101
| GRUB_USB_REQTYPE_TARGET_ENDP),
102
GRUB_USB_REQ_CLEAR_FEATURE,
103
GRUB_USB_FEATURE_ENDP_HALT,
108
grub_usb_set_configuration (grub_usb_device_t dev, int configuration)
110
grub_memset (dev->toggle, 0, sizeof (dev->toggle));
112
return grub_usb_control_msg (dev, (GRUB_USB_REQTYPE_OUT
113
| GRUB_USB_REQTYPE_STANDARD
114
| GRUB_USB_REQTYPE_TARGET_DEV),
115
GRUB_USB_REQ_SET_CONFIGURATION, configuration,
120
grub_usb_get_descriptor (grub_usb_device_t dev,
121
grub_uint8_t type, grub_uint8_t index,
122
grub_size_t size, char *data)
124
return grub_usb_control_msg (dev, (GRUB_USB_REQTYPE_IN
125
| GRUB_USB_REQTYPE_STANDARD
126
| GRUB_USB_REQTYPE_TARGET_DEV),
127
GRUB_USB_REQ_GET_DESCRIPTOR,
132
struct grub_usb_desc_endp *
133
grub_usb_get_endpdescriptor (grub_usb_device_t usbdev, int addr)
137
for (i = 0; i < usbdev->config[0].descconf->numif; i++)
139
struct grub_usb_desc_if *interf;
142
interf = usbdev->config[0].interf[i].descif;
144
for (j = 0; j < interf->endpointcnt; j++)
146
struct grub_usb_desc_endp *endp;
147
endp = &usbdev->config[0].interf[i].descendp[j];
149
if (endp->endp_addr == addr)
158
grub_usb_device_initialize (grub_usb_device_t dev)
160
struct grub_usb_desc_device *descdev;
161
struct grub_usb_desc_config config;
165
/* First we have to read first 8 bytes only and determine
166
* max. size of packet */
167
dev->descdev.maxsize0 = 0; /* invalidating, for safety only, can be removed if it is sure it is zero here */
168
err = grub_usb_get_descriptor (dev, GRUB_USB_DESCRIPTOR_DEVICE,
169
0, 8, (char *) &dev->descdev);
173
/* Now we have valid value in dev->descdev.maxsize0,
174
* so we can read whole device descriptor */
175
err = grub_usb_get_descriptor (dev, GRUB_USB_DESCRIPTOR_DEVICE,
176
0, sizeof (struct grub_usb_desc_device),
177
(char *) &dev->descdev);
180
descdev = &dev->descdev;
182
for (i = 0; i < 8; i++)
183
dev->config[i].descconf = NULL;
185
for (i = 0; i < descdev->configcnt; i++)
191
/* First just read the first 4 bytes of the configuration
192
descriptor, after that it is known how many bytes really have
194
err = grub_usb_get_descriptor (dev, GRUB_USB_DESCRIPTOR_CONFIG, i, 4,
197
data = grub_malloc (config.totallen);
200
err = GRUB_USB_ERR_INTERNAL;
204
dev->config[i].descconf = (struct grub_usb_desc_config *) data;
205
err = grub_usb_get_descriptor (dev, GRUB_USB_DESCRIPTOR_CONFIG, i,
206
config.totallen, data);
210
/* Skip the configuration descriptor. */
211
pos = sizeof (struct grub_usb_desc_config);
213
/* Read all interfaces. */
214
for (currif = 0; currif < dev->config[i].descconf->numif; currif++)
216
dev->config[i].interf[currif].descif
217
= (struct grub_usb_desc_if *) &data[pos];
218
pos += sizeof (struct grub_usb_desc_if);
220
/* Point to the first endpoint. */
221
dev->config[i].interf[currif].descendp
222
= (struct grub_usb_desc_endp *) &data[pos];
223
pos += (sizeof (struct grub_usb_desc_endp)
224
* dev->config[i].interf[currif].descif->endpointcnt);
228
return GRUB_USB_ERR_NONE;
232
for (i = 0; i < 8; i++)
233
grub_free (dev->config[i].descconf);
238
void grub_usb_device_attach (grub_usb_device_t dev)
242
/* XXX: Just check configuration 0 for now. */
243
for (i = 0; i < dev->config[0].descconf->numif; i++)
245
struct grub_usb_desc_if *interf;
246
struct grub_usb_attach_desc *desc;
248
interf = dev->config[0].interf[i].descif;
250
grub_dprintf ("usb", "iterate: interf=%d, class=%d, subclass=%d, protocol=%d\n",
251
i, interf->class, interf->subclass, interf->protocol);
253
if (dev->config[0].interf[i].attached)
256
for (desc = attach_hooks; desc; desc = desc->next)
257
if (interf->class == desc->class && desc->hook (dev, 0, i))
258
dev->config[0].interf[i].attached = 1;
263
grub_usb_register_attach_hook_class (struct grub_usb_attach_desc *desc)
265
auto int usb_iterate (grub_usb_device_t dev);
267
int usb_iterate (grub_usb_device_t usbdev)
269
struct grub_usb_desc_device *descdev = &usbdev->descdev;
272
if (descdev->class != 0 || descdev->subclass || descdev->protocol != 0
273
|| descdev->configcnt == 0)
276
/* XXX: Just check configuration 0 for now. */
277
for (i = 0; i < usbdev->config[0].descconf->numif; i++)
279
struct grub_usb_desc_if *interf;
281
interf = usbdev->config[0].interf[i].descif;
283
grub_dprintf ("usb", "iterate: interf=%d, class=%d, subclass=%d, protocol=%d\n",
284
i, interf->class, interf->subclass, interf->protocol);
286
if (usbdev->config[0].interf[i].attached)
289
if (interf->class != desc->class)
291
if (desc->hook (usbdev, 0, i))
292
usbdev->config[0].interf[i].attached = 1;
298
desc->next = attach_hooks;
301
grub_usb_iterate (usb_iterate);
305
grub_usb_unregister_attach_hook_class (struct grub_usb_attach_desc *desc)
307
grub_list_remove (GRUB_AS_LIST_P (&attach_hooks), GRUB_AS_LIST (desc));