wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 1 | /* |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 2 | * Most of this source has been derived from the Linux USB |
Wolfgang Denk | 460c322 | 2005-08-04 01:14:12 +0200 | [diff] [blame] | 3 | * project: |
| 4 | * (C) Copyright Linus Torvalds 1999 |
| 5 | * (C) Copyright Johannes Erdfelt 1999-2001 |
| 6 | * (C) Copyright Andreas Gal 1999 |
| 7 | * (C) Copyright Gregory P. Smith 1999 |
| 8 | * (C) Copyright Deti Fliegl 1999 (new USB architecture) |
| 9 | * (C) Copyright Randy Dunlap 2000 |
| 10 | * (C) Copyright David Brownell 2000 (kernel hotplug, usb_device_id) |
| 11 | * (C) Copyright Yggdrasil Computing, Inc. 2000 |
| 12 | * (usb_device_id matching changes by Adam J. Richter) |
| 13 | * |
| 14 | * Adapted for U-Boot: |
| 15 | * (C) Copyright 2001 Denis Peter, MPL AG Switzerland |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 16 | * |
Wolfgang Denk | 1a45966 | 2013-07-08 09:37:19 +0200 | [diff] [blame] | 17 | * SPDX-License-Identifier: GPL-2.0+ |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 18 | */ |
| 19 | |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 20 | /* |
| 21 | * How it works: |
| 22 | * |
| 23 | * Since this is a bootloader, the devices will not be automatic |
| 24 | * (re)configured on hotplug, but after a restart of the USB the |
| 25 | * device should work. |
| 26 | * |
| 27 | * For each transfer (except "Interrupt") we wait for completion. |
| 28 | */ |
| 29 | #include <common.h> |
| 30 | #include <command.h> |
Simon Glass | 95fbfe4 | 2015-03-25 12:22:08 -0600 | [diff] [blame] | 31 | #include <dm.h> |
Simon Glass | cf92e05 | 2015-09-02 17:24:58 -0600 | [diff] [blame^] | 32 | #include <memalign.h> |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 33 | #include <asm/processor.h> |
Mike Frysinger | 66cf641 | 2012-04-04 18:44:53 +0000 | [diff] [blame] | 34 | #include <linux/compiler.h> |
Wolfgang Denk | 9c998aa | 2005-07-21 11:57:57 +0200 | [diff] [blame] | 35 | #include <linux/ctype.h> |
Christian Eggers | c918261 | 2008-05-21 22:12:00 +0200 | [diff] [blame] | 36 | #include <asm/byteorder.h> |
Tom Rini | b2fb47f | 2011-12-15 08:40:51 -0700 | [diff] [blame] | 37 | #include <asm/unaligned.h> |
Marek Vasut | 97b9eb9 | 2014-08-01 03:09:53 +0200 | [diff] [blame] | 38 | #include <errno.h> |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 39 | #include <usb.h> |
| 40 | #ifdef CONFIG_4xx |
Stefan Roese | 3048bcb | 2007-10-03 15:01:02 +0200 | [diff] [blame] | 41 | #include <asm/4xx_pci.h> |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 42 | #endif |
| 43 | |
wdenk | cd0a9de | 2004-02-23 20:48:38 +0000 | [diff] [blame] | 44 | #define USB_BUFSIZ 512 |
| 45 | |
Simon Glass | 95fbfe4 | 2015-03-25 12:22:08 -0600 | [diff] [blame] | 46 | static int asynch_allowed; |
| 47 | char usb_started; /* flag for the started/stopped USB status */ |
| 48 | |
| 49 | #ifndef CONFIG_DM_USB |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 50 | static struct usb_device usb_dev[USB_MAX_DEVICE]; |
| 51 | static int dev_index; |
Bartlomiej Sieka | e51aae3 | 2006-08-03 23:20:13 +0200 | [diff] [blame] | 52 | |
Lucas Stach | 93c2582 | 2012-09-26 00:14:36 +0200 | [diff] [blame] | 53 | #ifndef CONFIG_USB_MAX_CONTROLLER_COUNT |
| 54 | #define CONFIG_USB_MAX_CONTROLLER_COUNT 1 |
| 55 | #endif |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 56 | |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 57 | /*************************************************************************** |
| 58 | * Init USB Device |
| 59 | */ |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 60 | int usb_init(void) |
| 61 | { |
Lucas Stach | 93c2582 | 2012-09-26 00:14:36 +0200 | [diff] [blame] | 62 | void *ctrl; |
| 63 | struct usb_device *dev; |
| 64 | int i, start_index = 0; |
Hans de Goede | d906bbc | 2015-01-11 20:34:46 +0100 | [diff] [blame] | 65 | int controllers_initialized = 0; |
Marek Vasut | 97b9eb9 | 2014-08-01 03:09:53 +0200 | [diff] [blame] | 66 | int ret; |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 67 | |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 68 | dev_index = 0; |
| 69 | asynch_allowed = 1; |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 70 | usb_hub_reset(); |
Lucas Stach | 93c2582 | 2012-09-26 00:14:36 +0200 | [diff] [blame] | 71 | |
| 72 | /* first make all devices unknown */ |
| 73 | for (i = 0; i < USB_MAX_DEVICE; i++) { |
| 74 | memset(&usb_dev[i], 0, sizeof(struct usb_device)); |
| 75 | usb_dev[i].devnum = -1; |
| 76 | } |
| 77 | |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 78 | /* init low_level USB */ |
Lucas Stach | 93c2582 | 2012-09-26 00:14:36 +0200 | [diff] [blame] | 79 | for (i = 0; i < CONFIG_USB_MAX_CONTROLLER_COUNT; i++) { |
| 80 | /* init low_level USB */ |
| 81 | printf("USB%d: ", i); |
Marek Vasut | 97b9eb9 | 2014-08-01 03:09:53 +0200 | [diff] [blame] | 82 | ret = usb_lowlevel_init(i, USB_INIT_HOST, &ctrl); |
| 83 | if (ret == -ENODEV) { /* No such device. */ |
| 84 | puts("Port not available.\n"); |
Hans de Goede | d906bbc | 2015-01-11 20:34:46 +0100 | [diff] [blame] | 85 | controllers_initialized++; |
Marek Vasut | 97b9eb9 | 2014-08-01 03:09:53 +0200 | [diff] [blame] | 86 | continue; |
| 87 | } |
| 88 | |
| 89 | if (ret) { /* Other error. */ |
Lucas Stach | 93c2582 | 2012-09-26 00:14:36 +0200 | [diff] [blame] | 90 | puts("lowlevel init failed\n"); |
| 91 | continue; |
| 92 | } |
| 93 | /* |
| 94 | * lowlevel init is OK, now scan the bus for devices |
| 95 | * i.e. search HUBs and configure them |
| 96 | */ |
Hans de Goede | d906bbc | 2015-01-11 20:34:46 +0100 | [diff] [blame] | 97 | controllers_initialized++; |
Lucas Stach | 93c2582 | 2012-09-26 00:14:36 +0200 | [diff] [blame] | 98 | start_index = dev_index; |
| 99 | printf("scanning bus %d for devices... ", i); |
Simon Glass | 79b5888 | 2015-03-25 12:22:01 -0600 | [diff] [blame] | 100 | ret = usb_alloc_new_device(ctrl, &dev); |
| 101 | if (ret) |
Paul Kocialkowski | 8879be8 | 2015-04-04 15:12:28 +0200 | [diff] [blame] | 102 | break; |
| 103 | |
Lucas Stach | 93c2582 | 2012-09-26 00:14:36 +0200 | [diff] [blame] | 104 | /* |
| 105 | * device 0 is always present |
| 106 | * (root hub, so let it analyze) |
| 107 | */ |
Paul Kocialkowski | 8879be8 | 2015-04-04 15:12:28 +0200 | [diff] [blame] | 108 | ret = usb_new_device(dev); |
| 109 | if (ret) |
Simon Glass | 79b5888 | 2015-03-25 12:22:01 -0600 | [diff] [blame] | 110 | usb_free_device(dev->controller); |
Lucas Stach | 93c2582 | 2012-09-26 00:14:36 +0200 | [diff] [blame] | 111 | |
Paul Kocialkowski | 8879be8 | 2015-04-04 15:12:28 +0200 | [diff] [blame] | 112 | if (start_index == dev_index) { |
Lucas Stach | 93c2582 | 2012-09-26 00:14:36 +0200 | [diff] [blame] | 113 | puts("No USB Device found\n"); |
Paul Kocialkowski | 8879be8 | 2015-04-04 15:12:28 +0200 | [diff] [blame] | 114 | continue; |
| 115 | } else { |
Lucas Stach | 93c2582 | 2012-09-26 00:14:36 +0200 | [diff] [blame] | 116 | printf("%d USB Device(s) found\n", |
| 117 | dev_index - start_index); |
Paul Kocialkowski | 8879be8 | 2015-04-04 15:12:28 +0200 | [diff] [blame] | 118 | } |
Lucas Stach | 93c2582 | 2012-09-26 00:14:36 +0200 | [diff] [blame] | 119 | |
Bartlomiej Sieka | e51aae3 | 2006-08-03 23:20:13 +0200 | [diff] [blame] | 120 | usb_started = 1; |
Lucas Stach | 93c2582 | 2012-09-26 00:14:36 +0200 | [diff] [blame] | 121 | } |
| 122 | |
Vivek Gautam | ceb4972 | 2013-04-12 16:34:33 +0530 | [diff] [blame] | 123 | debug("scan end\n"); |
Lucas Stach | 93c2582 | 2012-09-26 00:14:36 +0200 | [diff] [blame] | 124 | /* if we were not able to find at least one working bus, bail out */ |
Hans de Goede | d906bbc | 2015-01-11 20:34:46 +0100 | [diff] [blame] | 125 | if (controllers_initialized == 0) |
Lucas Stach | 93c2582 | 2012-09-26 00:14:36 +0200 | [diff] [blame] | 126 | puts("USB error: all controllers failed lowlevel init\n"); |
Lucas Stach | 93c2582 | 2012-09-26 00:14:36 +0200 | [diff] [blame] | 127 | |
Paul Kocialkowski | 5a80b34 | 2015-04-04 15:12:27 +0200 | [diff] [blame] | 128 | return usb_started ? 0 : -ENODEV; |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 129 | } |
| 130 | |
| 131 | /****************************************************************************** |
| 132 | * Stop USB this stops the LowLevel Part and deregisters USB devices. |
| 133 | */ |
| 134 | int usb_stop(void) |
| 135 | { |
Lucas Stach | 93c2582 | 2012-09-26 00:14:36 +0200 | [diff] [blame] | 136 | int i; |
Remy Bohmer | eba1f2f | 2008-08-20 11:22:02 +0200 | [diff] [blame] | 137 | |
| 138 | if (usb_started) { |
| 139 | asynch_allowed = 1; |
| 140 | usb_started = 0; |
| 141 | usb_hub_reset(); |
Lucas Stach | 93c2582 | 2012-09-26 00:14:36 +0200 | [diff] [blame] | 142 | |
| 143 | for (i = 0; i < CONFIG_USB_MAX_CONTROLLER_COUNT; i++) { |
| 144 | if (usb_lowlevel_stop(i)) |
| 145 | printf("failed to stop USB controller %d\n", i); |
| 146 | } |
Remy Bohmer | eba1f2f | 2008-08-20 11:22:02 +0200 | [diff] [blame] | 147 | } |
Lucas Stach | 93c2582 | 2012-09-26 00:14:36 +0200 | [diff] [blame] | 148 | |
| 149 | return 0; |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 150 | } |
| 151 | |
Vincent Palatin | 08f3bb0 | 2015-05-04 11:30:54 -0600 | [diff] [blame] | 152 | /****************************************************************************** |
| 153 | * Detect if a USB device has been plugged or unplugged. |
| 154 | */ |
| 155 | int usb_detect_change(void) |
| 156 | { |
| 157 | int i, j; |
| 158 | int change = 0; |
| 159 | |
| 160 | for (j = 0; j < USB_MAX_DEVICE; j++) { |
| 161 | for (i = 0; i < usb_dev[j].maxchild; i++) { |
| 162 | struct usb_port_status status; |
| 163 | |
| 164 | if (usb_get_port_status(&usb_dev[j], i + 1, |
| 165 | &status) < 0) |
| 166 | /* USB request failed */ |
| 167 | continue; |
| 168 | |
| 169 | if (le16_to_cpu(status.wPortChange) & |
| 170 | USB_PORT_STAT_C_CONNECTION) |
| 171 | change++; |
| 172 | } |
| 173 | } |
| 174 | |
| 175 | return change; |
| 176 | } |
| 177 | |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 178 | /* |
| 179 | * disables the asynch behaviour of the control message. This is used for data |
| 180 | * transfers that uses the exclusiv access to the control and bulk messages. |
Simon Glass | 89d4836 | 2011-02-16 11:14:33 -0800 | [diff] [blame] | 181 | * Returns the old value so it can be restored later. |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 182 | */ |
Simon Glass | 89d4836 | 2011-02-16 11:14:33 -0800 | [diff] [blame] | 183 | int usb_disable_asynch(int disable) |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 184 | { |
Simon Glass | 89d4836 | 2011-02-16 11:14:33 -0800 | [diff] [blame] | 185 | int old_value = asynch_allowed; |
| 186 | |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 187 | asynch_allowed = !disable; |
Simon Glass | 89d4836 | 2011-02-16 11:14:33 -0800 | [diff] [blame] | 188 | return old_value; |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 189 | } |
Simon Glass | 95fbfe4 | 2015-03-25 12:22:08 -0600 | [diff] [blame] | 190 | #endif /* !CONFIG_DM_USB */ |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 191 | |
| 192 | |
| 193 | /*------------------------------------------------------------------- |
| 194 | * Message wrappers. |
| 195 | * |
| 196 | */ |
| 197 | |
| 198 | /* |
| 199 | * submits an Interrupt Message |
| 200 | */ |
| 201 | int usb_submit_int_msg(struct usb_device *dev, unsigned long pipe, |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 202 | void *buffer, int transfer_len, int interval) |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 203 | { |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 204 | return submit_int_msg(dev, pipe, buffer, transfer_len, interval); |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 205 | } |
| 206 | |
| 207 | /* |
| 208 | * submits a control message and waits for comletion (at least timeout * 1ms) |
| 209 | * If timeout is 0, we don't wait for completion (used as example to set and |
| 210 | * clear keyboards LEDs). For data transfers, (storage transfers) we don't |
| 211 | * allow control messages with 0 timeout, by previousely resetting the flag |
| 212 | * asynch_allowed (usb_disable_asynch(1)). |
| 213 | * returns the transfered length if OK or -1 if error. The transfered length |
| 214 | * and the current status are stored in the dev->act_len and dev->status. |
| 215 | */ |
| 216 | int usb_control_msg(struct usb_device *dev, unsigned int pipe, |
| 217 | unsigned char request, unsigned char requesttype, |
| 218 | unsigned short value, unsigned short index, |
| 219 | void *data, unsigned short size, int timeout) |
| 220 | { |
Puneet Saxena | f576613 | 2012-04-03 14:56:06 +0530 | [diff] [blame] | 221 | ALLOC_CACHE_ALIGN_BUFFER(struct devrequest, setup_packet, 1); |
Hans de Goede | 651d95c | 2015-05-10 14:10:14 +0200 | [diff] [blame] | 222 | int err; |
Marek Vasut | e159e48 | 2012-02-13 18:58:18 +0000 | [diff] [blame] | 223 | |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 224 | if ((timeout == 0) && (!asynch_allowed)) { |
| 225 | /* request for a asynch control pipe is not allowed */ |
Paul Kocialkowski | 5a80b34 | 2015-04-04 15:12:27 +0200 | [diff] [blame] | 226 | return -EINVAL; |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 227 | } |
Wolfgang Denk | 9c998aa | 2005-07-21 11:57:57 +0200 | [diff] [blame] | 228 | |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 229 | /* set setup command */ |
Puneet Saxena | f576613 | 2012-04-03 14:56:06 +0530 | [diff] [blame] | 230 | setup_packet->requesttype = requesttype; |
| 231 | setup_packet->request = request; |
| 232 | setup_packet->value = cpu_to_le16(value); |
| 233 | setup_packet->index = cpu_to_le16(index); |
| 234 | setup_packet->length = cpu_to_le16(size); |
Vivek Gautam | ceb4972 | 2013-04-12 16:34:33 +0530 | [diff] [blame] | 235 | debug("usb_control_msg: request: 0x%X, requesttype: 0x%X, " \ |
| 236 | "value 0x%X index 0x%X length 0x%X\n", |
| 237 | request, requesttype, value, index, size); |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 238 | dev->status = USB_ST_NOT_PROC; /*not yet processed */ |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 239 | |
Hans de Goede | 651d95c | 2015-05-10 14:10:14 +0200 | [diff] [blame] | 240 | err = submit_control_msg(dev, pipe, data, size, setup_packet); |
| 241 | if (err < 0) |
| 242 | return err; |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 243 | if (timeout == 0) |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 244 | return (int)size; |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 245 | |
Remy Bohmer | 84d36b3 | 2010-02-01 19:40:47 +0100 | [diff] [blame] | 246 | /* |
| 247 | * Wait for status to update until timeout expires, USB driver |
| 248 | * interrupt handler may set the status when the USB operation has |
| 249 | * been completed. |
| 250 | */ |
| 251 | while (timeout--) { |
| 252 | if (!((volatile unsigned long)dev->status & USB_ST_NOT_PROC)) |
| 253 | break; |
Mike Frysinger | 5b84dd6 | 2012-03-05 13:47:00 +0000 | [diff] [blame] | 254 | mdelay(1); |
Remy Bohmer | 4886720 | 2008-10-10 10:23:21 +0200 | [diff] [blame] | 255 | } |
Remy Bohmer | 84d36b3 | 2010-02-01 19:40:47 +0100 | [diff] [blame] | 256 | if (dev->status) |
| 257 | return -1; |
Remy Bohmer | 4886720 | 2008-10-10 10:23:21 +0200 | [diff] [blame] | 258 | |
| 259 | return dev->act_len; |
Remy Bohmer | 84d36b3 | 2010-02-01 19:40:47 +0100 | [diff] [blame] | 260 | |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 261 | } |
| 262 | |
| 263 | /*------------------------------------------------------------------- |
| 264 | * submits bulk message, and waits for completion. returns 0 if Ok or |
Paul Kocialkowski | 5a80b34 | 2015-04-04 15:12:27 +0200 | [diff] [blame] | 265 | * negative if Error. |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 266 | * synchronous behavior |
| 267 | */ |
| 268 | int usb_bulk_msg(struct usb_device *dev, unsigned int pipe, |
| 269 | void *data, int len, int *actual_length, int timeout) |
| 270 | { |
| 271 | if (len < 0) |
Paul Kocialkowski | 5a80b34 | 2015-04-04 15:12:27 +0200 | [diff] [blame] | 272 | return -EINVAL; |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 273 | dev->status = USB_ST_NOT_PROC; /*not yet processed */ |
Ilya Yanok | fd06028 | 2012-07-15 04:43:51 +0000 | [diff] [blame] | 274 | if (submit_bulk_msg(dev, pipe, data, len) < 0) |
Paul Kocialkowski | 5a80b34 | 2015-04-04 15:12:27 +0200 | [diff] [blame] | 275 | return -EIO; |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 276 | while (timeout--) { |
| 277 | if (!((volatile unsigned long)dev->status & USB_ST_NOT_PROC)) |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 278 | break; |
Mike Frysinger | 5b84dd6 | 2012-03-05 13:47:00 +0000 | [diff] [blame] | 279 | mdelay(1); |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 280 | } |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 281 | *actual_length = dev->act_len; |
| 282 | if (dev->status == 0) |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 283 | return 0; |
| 284 | else |
Paul Kocialkowski | 5a80b34 | 2015-04-04 15:12:27 +0200 | [diff] [blame] | 285 | return -EIO; |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 286 | } |
| 287 | |
| 288 | |
| 289 | /*------------------------------------------------------------------- |
| 290 | * Max Packet stuff |
| 291 | */ |
| 292 | |
| 293 | /* |
| 294 | * returns the max packet size, depending on the pipe direction and |
| 295 | * the configurations values |
| 296 | */ |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 297 | int usb_maxpacket(struct usb_device *dev, unsigned long pipe) |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 298 | { |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 299 | /* direction is out -> use emaxpacket out */ |
| 300 | if ((pipe & USB_DIR_IN) == 0) |
Michael Trimarchi | de39f8c | 2008-11-26 17:41:34 +0100 | [diff] [blame] | 301 | return dev->epmaxpacketout[((pipe>>15) & 0xf)]; |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 302 | else |
Michael Trimarchi | de39f8c | 2008-11-26 17:41:34 +0100 | [diff] [blame] | 303 | return dev->epmaxpacketin[((pipe>>15) & 0xf)]; |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 304 | } |
| 305 | |
Marek Vasut | 5e8baf8 | 2011-11-05 23:35:12 +0100 | [diff] [blame] | 306 | /* |
| 307 | * The routine usb_set_maxpacket_ep() is extracted from the loop of routine |
Remy Bohmer | be19d32 | 2008-09-16 14:55:42 +0200 | [diff] [blame] | 308 | * usb_set_maxpacket(), because the optimizer of GCC 4.x chokes on this routine |
| 309 | * when it is inlined in 1 single routine. What happens is that the register r3 |
| 310 | * is used as loop-count 'i', but gets overwritten later on. |
| 311 | * This is clearly a compiler bug, but it is easier to workaround it here than |
| 312 | * to update the compiler (Occurs with at least several GCC 4.{1,2},x |
| 313 | * CodeSourcery compilers like e.g. 2007q3, 2008q1, 2008q3 lite editions on ARM) |
Marek Vasut | 5e8baf8 | 2011-11-05 23:35:12 +0100 | [diff] [blame] | 314 | * |
| 315 | * NOTE: Similar behaviour was observed with GCC4.6 on ARMv5. |
Remy Bohmer | be19d32 | 2008-09-16 14:55:42 +0200 | [diff] [blame] | 316 | */ |
Mike Frysinger | 66cf641 | 2012-04-04 18:44:53 +0000 | [diff] [blame] | 317 | static void noinline |
Marek Vasut | 5e8baf8 | 2011-11-05 23:35:12 +0100 | [diff] [blame] | 318 | usb_set_maxpacket_ep(struct usb_device *dev, int if_idx, int ep_idx) |
Remy Bohmer | be19d32 | 2008-09-16 14:55:42 +0200 | [diff] [blame] | 319 | { |
| 320 | int b; |
Marek Vasut | 5e8baf8 | 2011-11-05 23:35:12 +0100 | [diff] [blame] | 321 | struct usb_endpoint_descriptor *ep; |
Tom Rini | b2fb47f | 2011-12-15 08:40:51 -0700 | [diff] [blame] | 322 | u16 ep_wMaxPacketSize; |
Marek Vasut | 5e8baf8 | 2011-11-05 23:35:12 +0100 | [diff] [blame] | 323 | |
| 324 | ep = &dev->config.if_desc[if_idx].ep_desc[ep_idx]; |
Remy Bohmer | be19d32 | 2008-09-16 14:55:42 +0200 | [diff] [blame] | 325 | |
| 326 | b = ep->bEndpointAddress & USB_ENDPOINT_NUMBER_MASK; |
Tom Rini | b2fb47f | 2011-12-15 08:40:51 -0700 | [diff] [blame] | 327 | ep_wMaxPacketSize = get_unaligned(&ep->wMaxPacketSize); |
Remy Bohmer | be19d32 | 2008-09-16 14:55:42 +0200 | [diff] [blame] | 328 | |
| 329 | if ((ep->bmAttributes & USB_ENDPOINT_XFERTYPE_MASK) == |
| 330 | USB_ENDPOINT_XFER_CONTROL) { |
| 331 | /* Control => bidirectional */ |
Tom Rini | b2fb47f | 2011-12-15 08:40:51 -0700 | [diff] [blame] | 332 | dev->epmaxpacketout[b] = ep_wMaxPacketSize; |
| 333 | dev->epmaxpacketin[b] = ep_wMaxPacketSize; |
Vivek Gautam | ceb4972 | 2013-04-12 16:34:33 +0530 | [diff] [blame] | 334 | debug("##Control EP epmaxpacketout/in[%d] = %d\n", |
| 335 | b, dev->epmaxpacketin[b]); |
Remy Bohmer | be19d32 | 2008-09-16 14:55:42 +0200 | [diff] [blame] | 336 | } else { |
| 337 | if ((ep->bEndpointAddress & 0x80) == 0) { |
| 338 | /* OUT Endpoint */ |
Tom Rini | b2fb47f | 2011-12-15 08:40:51 -0700 | [diff] [blame] | 339 | if (ep_wMaxPacketSize > dev->epmaxpacketout[b]) { |
| 340 | dev->epmaxpacketout[b] = ep_wMaxPacketSize; |
Vivek Gautam | ceb4972 | 2013-04-12 16:34:33 +0530 | [diff] [blame] | 341 | debug("##EP epmaxpacketout[%d] = %d\n", |
| 342 | b, dev->epmaxpacketout[b]); |
Remy Bohmer | be19d32 | 2008-09-16 14:55:42 +0200 | [diff] [blame] | 343 | } |
| 344 | } else { |
| 345 | /* IN Endpoint */ |
Tom Rini | b2fb47f | 2011-12-15 08:40:51 -0700 | [diff] [blame] | 346 | if (ep_wMaxPacketSize > dev->epmaxpacketin[b]) { |
| 347 | dev->epmaxpacketin[b] = ep_wMaxPacketSize; |
Vivek Gautam | ceb4972 | 2013-04-12 16:34:33 +0530 | [diff] [blame] | 348 | debug("##EP epmaxpacketin[%d] = %d\n", |
| 349 | b, dev->epmaxpacketin[b]); |
Remy Bohmer | be19d32 | 2008-09-16 14:55:42 +0200 | [diff] [blame] | 350 | } |
| 351 | } /* if out */ |
| 352 | } /* if control */ |
| 353 | } |
| 354 | |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 355 | /* |
| 356 | * set the max packed value of all endpoints in the given configuration |
| 357 | */ |
Marek Vasut | c08b1b2 | 2012-02-13 18:58:16 +0000 | [diff] [blame] | 358 | static int usb_set_maxpacket(struct usb_device *dev) |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 359 | { |
Remy Bohmer | be19d32 | 2008-09-16 14:55:42 +0200 | [diff] [blame] | 360 | int i, ii; |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 361 | |
Tom Rix | 8f8bd56 | 2009-10-31 12:37:38 -0500 | [diff] [blame] | 362 | for (i = 0; i < dev->config.desc.bNumInterfaces; i++) |
| 363 | for (ii = 0; ii < dev->config.if_desc[i].desc.bNumEndpoints; ii++) |
Marek Vasut | 5e8baf8 | 2011-11-05 23:35:12 +0100 | [diff] [blame] | 364 | usb_set_maxpacket_ep(dev, i, ii); |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 365 | |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 366 | return 0; |
| 367 | } |
| 368 | |
| 369 | /******************************************************************************* |
| 370 | * Parse the config, located in buffer, and fills the dev->config structure. |
| 371 | * Note that all little/big endian swapping are done automatically. |
Julius Werner | eaf3e61 | 2013-07-19 13:12:08 -0700 | [diff] [blame] | 372 | * (wTotalLength has already been swapped and sanitized when it was read.) |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 373 | */ |
Marek Vasut | c08b1b2 | 2012-02-13 18:58:16 +0000 | [diff] [blame] | 374 | static int usb_parse_config(struct usb_device *dev, |
| 375 | unsigned char *buffer, int cfgno) |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 376 | { |
| 377 | struct usb_descriptor_header *head; |
Bartlomiej Sieka | 7455af4 | 2006-08-02 00:54:18 +0200 | [diff] [blame] | 378 | int index, ifno, epno, curr_if_num; |
Tom Rini | b2fb47f | 2011-12-15 08:40:51 -0700 | [diff] [blame] | 379 | u16 ep_wMaxPacketSize; |
Vivek Gautam | 605bd75 | 2013-04-12 16:34:34 +0530 | [diff] [blame] | 380 | struct usb_interface *if_desc = NULL; |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 381 | |
Bartlomiej Sieka | 7455af4 | 2006-08-02 00:54:18 +0200 | [diff] [blame] | 382 | ifno = -1; |
| 383 | epno = -1; |
| 384 | curr_if_num = -1; |
| 385 | |
| 386 | dev->configno = cfgno; |
| 387 | head = (struct usb_descriptor_header *) &buffer[0]; |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 388 | if (head->bDescriptorType != USB_DT_CONFIG) { |
| 389 | printf(" ERROR: NOT USB_CONFIG_DESC %x\n", |
| 390 | head->bDescriptorType); |
Paul Kocialkowski | 5a80b34 | 2015-04-04 15:12:27 +0200 | [diff] [blame] | 391 | return -EINVAL; |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 392 | } |
Julius Werner | eaf3e61 | 2013-07-19 13:12:08 -0700 | [diff] [blame] | 393 | if (head->bLength != USB_DT_CONFIG_SIZE) { |
| 394 | printf("ERROR: Invalid USB CFG length (%d)\n", head->bLength); |
Paul Kocialkowski | 5a80b34 | 2015-04-04 15:12:27 +0200 | [diff] [blame] | 395 | return -EINVAL; |
Julius Werner | eaf3e61 | 2013-07-19 13:12:08 -0700 | [diff] [blame] | 396 | } |
| 397 | memcpy(&dev->config, head, USB_DT_CONFIG_SIZE); |
Bartlomiej Sieka | 7455af4 | 2006-08-02 00:54:18 +0200 | [diff] [blame] | 398 | dev->config.no_of_if = 0; |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 399 | |
Tom Rix | 8f8bd56 | 2009-10-31 12:37:38 -0500 | [diff] [blame] | 400 | index = dev->config.desc.bLength; |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 401 | /* Ok the first entry must be a configuration entry, |
| 402 | * now process the others */ |
Bartlomiej Sieka | 7455af4 | 2006-08-02 00:54:18 +0200 | [diff] [blame] | 403 | head = (struct usb_descriptor_header *) &buffer[index]; |
Julius Werner | eaf3e61 | 2013-07-19 13:12:08 -0700 | [diff] [blame] | 404 | while (index + 1 < dev->config.desc.wTotalLength && head->bLength) { |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 405 | switch (head->bDescriptorType) { |
| 406 | case USB_DT_INTERFACE: |
Julius Werner | eaf3e61 | 2013-07-19 13:12:08 -0700 | [diff] [blame] | 407 | if (head->bLength != USB_DT_INTERFACE_SIZE) { |
| 408 | printf("ERROR: Invalid USB IF length (%d)\n", |
| 409 | head->bLength); |
| 410 | break; |
| 411 | } |
| 412 | if (index + USB_DT_INTERFACE_SIZE > |
| 413 | dev->config.desc.wTotalLength) { |
| 414 | puts("USB IF descriptor overflowed buffer!\n"); |
| 415 | break; |
| 416 | } |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 417 | if (((struct usb_interface_descriptor *) \ |
Julius Werner | eaf3e61 | 2013-07-19 13:12:08 -0700 | [diff] [blame] | 418 | head)->bInterfaceNumber != curr_if_num) { |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 419 | /* this is a new interface, copy new desc */ |
| 420 | ifno = dev->config.no_of_if; |
Julius Werner | eaf3e61 | 2013-07-19 13:12:08 -0700 | [diff] [blame] | 421 | if (ifno >= USB_MAXINTERFACES) { |
| 422 | puts("Too many USB interfaces!\n"); |
| 423 | /* try to go on with what we have */ |
Paul Kocialkowski | 5a80b34 | 2015-04-04 15:12:27 +0200 | [diff] [blame] | 424 | return -EINVAL; |
Julius Werner | eaf3e61 | 2013-07-19 13:12:08 -0700 | [diff] [blame] | 425 | } |
Vivek Gautam | 605bd75 | 2013-04-12 16:34:34 +0530 | [diff] [blame] | 426 | if_desc = &dev->config.if_desc[ifno]; |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 427 | dev->config.no_of_if++; |
Julius Werner | eaf3e61 | 2013-07-19 13:12:08 -0700 | [diff] [blame] | 428 | memcpy(if_desc, head, |
| 429 | USB_DT_INTERFACE_SIZE); |
Vivek Gautam | 605bd75 | 2013-04-12 16:34:34 +0530 | [diff] [blame] | 430 | if_desc->no_of_ep = 0; |
| 431 | if_desc->num_altsetting = 1; |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 432 | curr_if_num = |
Vivek Gautam | 605bd75 | 2013-04-12 16:34:34 +0530 | [diff] [blame] | 433 | if_desc->desc.bInterfaceNumber; |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 434 | } else { |
| 435 | /* found alternate setting for the interface */ |
Vivek Gautam | 605bd75 | 2013-04-12 16:34:34 +0530 | [diff] [blame] | 436 | if (ifno >= 0) { |
| 437 | if_desc = &dev->config.if_desc[ifno]; |
| 438 | if_desc->num_altsetting++; |
| 439 | } |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 440 | } |
| 441 | break; |
| 442 | case USB_DT_ENDPOINT: |
Julius Werner | eaf3e61 | 2013-07-19 13:12:08 -0700 | [diff] [blame] | 443 | if (head->bLength != USB_DT_ENDPOINT_SIZE) { |
| 444 | printf("ERROR: Invalid USB EP length (%d)\n", |
| 445 | head->bLength); |
| 446 | break; |
| 447 | } |
| 448 | if (index + USB_DT_ENDPOINT_SIZE > |
| 449 | dev->config.desc.wTotalLength) { |
| 450 | puts("USB EP descriptor overflowed buffer!\n"); |
| 451 | break; |
| 452 | } |
| 453 | if (ifno < 0) { |
| 454 | puts("Endpoint descriptor out of order!\n"); |
| 455 | break; |
| 456 | } |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 457 | epno = dev->config.if_desc[ifno].no_of_ep; |
Vivek Gautam | 605bd75 | 2013-04-12 16:34:34 +0530 | [diff] [blame] | 458 | if_desc = &dev->config.if_desc[ifno]; |
Julius Werner | eaf3e61 | 2013-07-19 13:12:08 -0700 | [diff] [blame] | 459 | if (epno > USB_MAXENDPOINTS) { |
| 460 | printf("Interface %d has too many endpoints!\n", |
| 461 | if_desc->desc.bInterfaceNumber); |
Paul Kocialkowski | 5a80b34 | 2015-04-04 15:12:27 +0200 | [diff] [blame] | 462 | return -EINVAL; |
Julius Werner | eaf3e61 | 2013-07-19 13:12:08 -0700 | [diff] [blame] | 463 | } |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 464 | /* found an endpoint */ |
Vivek Gautam | 605bd75 | 2013-04-12 16:34:34 +0530 | [diff] [blame] | 465 | if_desc->no_of_ep++; |
Julius Werner | eaf3e61 | 2013-07-19 13:12:08 -0700 | [diff] [blame] | 466 | memcpy(&if_desc->ep_desc[epno], head, |
| 467 | USB_DT_ENDPOINT_SIZE); |
Tom Rini | b2fb47f | 2011-12-15 08:40:51 -0700 | [diff] [blame] | 468 | ep_wMaxPacketSize = get_unaligned(&dev->config.\ |
| 469 | if_desc[ifno].\ |
| 470 | ep_desc[epno].\ |
| 471 | wMaxPacketSize); |
| 472 | put_unaligned(le16_to_cpu(ep_wMaxPacketSize), |
| 473 | &dev->config.\ |
| 474 | if_desc[ifno].\ |
| 475 | ep_desc[epno].\ |
| 476 | wMaxPacketSize); |
Vivek Gautam | ceb4972 | 2013-04-12 16:34:33 +0530 | [diff] [blame] | 477 | debug("if %d, ep %d\n", ifno, epno); |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 478 | break; |
Vivek Gautam | 6497c66 | 2013-04-12 16:34:38 +0530 | [diff] [blame] | 479 | case USB_DT_SS_ENDPOINT_COMP: |
Julius Werner | eaf3e61 | 2013-07-19 13:12:08 -0700 | [diff] [blame] | 480 | if (head->bLength != USB_DT_SS_EP_COMP_SIZE) { |
| 481 | printf("ERROR: Invalid USB EPC length (%d)\n", |
| 482 | head->bLength); |
| 483 | break; |
| 484 | } |
| 485 | if (index + USB_DT_SS_EP_COMP_SIZE > |
| 486 | dev->config.desc.wTotalLength) { |
| 487 | puts("USB EPC descriptor overflowed buffer!\n"); |
| 488 | break; |
| 489 | } |
| 490 | if (ifno < 0 || epno < 0) { |
| 491 | puts("EPC descriptor out of order!\n"); |
| 492 | break; |
| 493 | } |
Vivek Gautam | 6497c66 | 2013-04-12 16:34:38 +0530 | [diff] [blame] | 494 | if_desc = &dev->config.if_desc[ifno]; |
Julius Werner | eaf3e61 | 2013-07-19 13:12:08 -0700 | [diff] [blame] | 495 | memcpy(&if_desc->ss_ep_comp_desc[epno], head, |
| 496 | USB_DT_SS_EP_COMP_SIZE); |
Vivek Gautam | 6497c66 | 2013-04-12 16:34:38 +0530 | [diff] [blame] | 497 | break; |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 498 | default: |
| 499 | if (head->bLength == 0) |
Paul Kocialkowski | 5a80b34 | 2015-04-04 15:12:27 +0200 | [diff] [blame] | 500 | return -EINVAL; |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 501 | |
Vivek Gautam | ceb4972 | 2013-04-12 16:34:33 +0530 | [diff] [blame] | 502 | debug("unknown Description Type : %x\n", |
| 503 | head->bDescriptorType); |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 504 | |
Vivek Gautam | ceb4972 | 2013-04-12 16:34:33 +0530 | [diff] [blame] | 505 | #ifdef DEBUG |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 506 | { |
Wolfgang Denk | fad2e1b | 2011-10-05 23:11:19 +0200 | [diff] [blame] | 507 | unsigned char *ch = (unsigned char *)head; |
Vivek Gautam | ceb4972 | 2013-04-12 16:34:33 +0530 | [diff] [blame] | 508 | int i; |
| 509 | |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 510 | for (i = 0; i < head->bLength; i++) |
Vivek Gautam | ceb4972 | 2013-04-12 16:34:33 +0530 | [diff] [blame] | 511 | debug("%02X ", *ch++); |
| 512 | debug("\n\n\n"); |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 513 | } |
Vivek Gautam | ceb4972 | 2013-04-12 16:34:33 +0530 | [diff] [blame] | 514 | #endif |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 515 | break; |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 516 | } |
Bartlomiej Sieka | 7455af4 | 2006-08-02 00:54:18 +0200 | [diff] [blame] | 517 | index += head->bLength; |
| 518 | head = (struct usb_descriptor_header *)&buffer[index]; |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 519 | } |
Paul Kocialkowski | 5a80b34 | 2015-04-04 15:12:27 +0200 | [diff] [blame] | 520 | return 0; |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 521 | } |
| 522 | |
| 523 | /*********************************************************************** |
| 524 | * Clears an endpoint |
| 525 | * endp: endpoint number in bits 0-3; |
| 526 | * direction flag in bit 7 (1 = IN, 0 = OUT) |
| 527 | */ |
| 528 | int usb_clear_halt(struct usb_device *dev, int pipe) |
| 529 | { |
| 530 | int result; |
Wolfgang Denk | 9c998aa | 2005-07-21 11:57:57 +0200 | [diff] [blame] | 531 | int endp = usb_pipeendpoint(pipe)|(usb_pipein(pipe)<<7); |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 532 | |
| 533 | result = usb_control_msg(dev, usb_sndctrlpipe(dev, 0), |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 534 | USB_REQ_CLEAR_FEATURE, USB_RECIP_ENDPOINT, 0, |
| 535 | endp, NULL, 0, USB_CNTL_TIMEOUT * 3); |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 536 | |
| 537 | /* don't clear if failed */ |
| 538 | if (result < 0) |
| 539 | return result; |
Wolfgang Denk | 9c998aa | 2005-07-21 11:57:57 +0200 | [diff] [blame] | 540 | |
Wolfgang Denk | 095b8a3 | 2005-08-02 17:06:17 +0200 | [diff] [blame] | 541 | /* |
Wolfgang Denk | 9c998aa | 2005-07-21 11:57:57 +0200 | [diff] [blame] | 542 | * NOTE: we do not get status and verify reset was successful |
| 543 | * as some devices are reported to lock up upon this check.. |
| 544 | */ |
| 545 | |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 546 | usb_endpoint_running(dev, usb_pipeendpoint(pipe), usb_pipeout(pipe)); |
Wolfgang Denk | 9c998aa | 2005-07-21 11:57:57 +0200 | [diff] [blame] | 547 | |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 548 | /* toggle is reset on clear */ |
| 549 | usb_settoggle(dev, usb_pipeendpoint(pipe), usb_pipeout(pipe), 0); |
| 550 | return 0; |
| 551 | } |
| 552 | |
| 553 | |
| 554 | /********************************************************************** |
| 555 | * get_descriptor type |
| 556 | */ |
Marek Vasut | c08b1b2 | 2012-02-13 18:58:16 +0000 | [diff] [blame] | 557 | static int usb_get_descriptor(struct usb_device *dev, unsigned char type, |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 558 | unsigned char index, void *buf, int size) |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 559 | { |
| 560 | int res; |
Wolfgang Denk | 53677ef | 2008-05-20 16:00:29 +0200 | [diff] [blame] | 561 | res = usb_control_msg(dev, usb_rcvctrlpipe(dev, 0), |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 562 | USB_REQ_GET_DESCRIPTOR, USB_DIR_IN, |
| 563 | (type << 8) + index, 0, |
| 564 | buf, size, USB_CNTL_TIMEOUT); |
| 565 | return res; |
| 566 | } |
| 567 | |
| 568 | /********************************************************************** |
| 569 | * gets configuration cfgno and store it in the buffer |
| 570 | */ |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 571 | int usb_get_configuration_no(struct usb_device *dev, |
| 572 | unsigned char *buffer, int cfgno) |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 573 | { |
Wolfgang Denk | 53677ef | 2008-05-20 16:00:29 +0200 | [diff] [blame] | 574 | int result; |
Julius Werner | eaf3e61 | 2013-07-19 13:12:08 -0700 | [diff] [blame] | 575 | unsigned int length; |
Ilya Yanok | c60795f | 2012-11-06 13:48:20 +0000 | [diff] [blame] | 576 | struct usb_config_descriptor *config; |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 577 | |
Ilya Yanok | c60795f | 2012-11-06 13:48:20 +0000 | [diff] [blame] | 578 | config = (struct usb_config_descriptor *)&buffer[0]; |
Remy Bohmer | 4886720 | 2008-10-10 10:23:21 +0200 | [diff] [blame] | 579 | result = usb_get_descriptor(dev, USB_DT_CONFIG, cfgno, buffer, 9); |
| 580 | if (result < 9) { |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 581 | if (result < 0) |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 582 | printf("unable to get descriptor, error %lX\n", |
| 583 | dev->status); |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 584 | else |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 585 | printf("config descriptor too short " \ |
Remy Bohmer | 4886720 | 2008-10-10 10:23:21 +0200 | [diff] [blame] | 586 | "(expected %i, got %i)\n", 9, result); |
Paul Kocialkowski | 5a80b34 | 2015-04-04 15:12:27 +0200 | [diff] [blame] | 587 | return -EIO; |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 588 | } |
Julius Werner | eaf3e61 | 2013-07-19 13:12:08 -0700 | [diff] [blame] | 589 | length = le16_to_cpu(config->wTotalLength); |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 590 | |
Julius Werner | eaf3e61 | 2013-07-19 13:12:08 -0700 | [diff] [blame] | 591 | if (length > USB_BUFSIZ) { |
| 592 | printf("%s: failed to get descriptor - too long: %d\n", |
| 593 | __func__, length); |
Paul Kocialkowski | 5a80b34 | 2015-04-04 15:12:27 +0200 | [diff] [blame] | 594 | return -EIO; |
wdenk | cd0a9de | 2004-02-23 20:48:38 +0000 | [diff] [blame] | 595 | } |
| 596 | |
Julius Werner | eaf3e61 | 2013-07-19 13:12:08 -0700 | [diff] [blame] | 597 | result = usb_get_descriptor(dev, USB_DT_CONFIG, cfgno, buffer, length); |
| 598 | debug("get_conf_no %d Result %d, wLength %d\n", cfgno, result, length); |
| 599 | config->wTotalLength = length; /* validated, with CPU byte order */ |
| 600 | |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 601 | return result; |
| 602 | } |
| 603 | |
| 604 | /******************************************************************** |
| 605 | * set address of a device to the value in dev->devnum. |
| 606 | * This can only be done by addressing the device via the default address (0) |
| 607 | */ |
Marek Vasut | c08b1b2 | 2012-02-13 18:58:16 +0000 | [diff] [blame] | 608 | static int usb_set_address(struct usb_device *dev) |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 609 | { |
| 610 | int res; |
| 611 | |
Vivek Gautam | ceb4972 | 2013-04-12 16:34:33 +0530 | [diff] [blame] | 612 | debug("set address %d\n", dev->devnum); |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 613 | res = usb_control_msg(dev, usb_snddefctrl(dev), |
| 614 | USB_REQ_SET_ADDRESS, 0, |
| 615 | (dev->devnum), 0, |
| 616 | NULL, 0, USB_CNTL_TIMEOUT); |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 617 | return res; |
| 618 | } |
| 619 | |
| 620 | /******************************************************************** |
| 621 | * set interface number to interface |
| 622 | */ |
| 623 | int usb_set_interface(struct usb_device *dev, int interface, int alternate) |
| 624 | { |
Tom Rix | 8f8bd56 | 2009-10-31 12:37:38 -0500 | [diff] [blame] | 625 | struct usb_interface *if_face = NULL; |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 626 | int ret, i; |
| 627 | |
Tom Rix | 8f8bd56 | 2009-10-31 12:37:38 -0500 | [diff] [blame] | 628 | for (i = 0; i < dev->config.desc.bNumInterfaces; i++) { |
| 629 | if (dev->config.if_desc[i].desc.bInterfaceNumber == interface) { |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 630 | if_face = &dev->config.if_desc[i]; |
| 631 | break; |
| 632 | } |
| 633 | } |
| 634 | if (!if_face) { |
| 635 | printf("selecting invalid interface %d", interface); |
Paul Kocialkowski | 5a80b34 | 2015-04-04 15:12:27 +0200 | [diff] [blame] | 636 | return -EINVAL; |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 637 | } |
Bartlomiej Sieka | 7455af4 | 2006-08-02 00:54:18 +0200 | [diff] [blame] | 638 | /* |
| 639 | * We should return now for devices with only one alternate setting. |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 640 | * According to 9.4.10 of the Universal Serial Bus Specification |
| 641 | * Revision 2.0 such devices can return with a STALL. This results in |
| 642 | * some USB sticks timeouting during initialization and then being |
| 643 | * unusable in U-Boot. |
Bartlomiej Sieka | 7455af4 | 2006-08-02 00:54:18 +0200 | [diff] [blame] | 644 | */ |
| 645 | if (if_face->num_altsetting == 1) |
| 646 | return 0; |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 647 | |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 648 | ret = usb_control_msg(dev, usb_sndctrlpipe(dev, 0), |
| 649 | USB_REQ_SET_INTERFACE, USB_RECIP_INTERFACE, |
| 650 | alternate, interface, NULL, 0, |
| 651 | USB_CNTL_TIMEOUT * 5); |
| 652 | if (ret < 0) |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 653 | return ret; |
| 654 | |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 655 | return 0; |
| 656 | } |
| 657 | |
| 658 | /******************************************************************** |
| 659 | * set configuration number to configuration |
| 660 | */ |
Marek Vasut | c08b1b2 | 2012-02-13 18:58:16 +0000 | [diff] [blame] | 661 | static int usb_set_configuration(struct usb_device *dev, int configuration) |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 662 | { |
| 663 | int res; |
Vivek Gautam | ceb4972 | 2013-04-12 16:34:33 +0530 | [diff] [blame] | 664 | debug("set configuration %d\n", configuration); |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 665 | /* set setup command */ |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 666 | res = usb_control_msg(dev, usb_sndctrlpipe(dev, 0), |
| 667 | USB_REQ_SET_CONFIGURATION, 0, |
| 668 | configuration, 0, |
| 669 | NULL, 0, USB_CNTL_TIMEOUT); |
| 670 | if (res == 0) { |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 671 | dev->toggle[0] = 0; |
| 672 | dev->toggle[1] = 0; |
| 673 | return 0; |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 674 | } else |
Paul Kocialkowski | 5a80b34 | 2015-04-04 15:12:27 +0200 | [diff] [blame] | 675 | return -EIO; |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 676 | } |
| 677 | |
| 678 | /******************************************************************** |
| 679 | * set protocol to protocol |
| 680 | */ |
| 681 | int usb_set_protocol(struct usb_device *dev, int ifnum, int protocol) |
| 682 | { |
| 683 | return usb_control_msg(dev, usb_sndctrlpipe(dev, 0), |
| 684 | USB_REQ_SET_PROTOCOL, USB_TYPE_CLASS | USB_RECIP_INTERFACE, |
| 685 | protocol, ifnum, NULL, 0, USB_CNTL_TIMEOUT); |
| 686 | } |
| 687 | |
| 688 | /******************************************************************** |
| 689 | * set idle |
| 690 | */ |
| 691 | int usb_set_idle(struct usb_device *dev, int ifnum, int duration, int report_id) |
| 692 | { |
| 693 | return usb_control_msg(dev, usb_sndctrlpipe(dev, 0), |
| 694 | USB_REQ_SET_IDLE, USB_TYPE_CLASS | USB_RECIP_INTERFACE, |
| 695 | (duration << 8) | report_id, ifnum, NULL, 0, USB_CNTL_TIMEOUT); |
| 696 | } |
| 697 | |
| 698 | /******************************************************************** |
| 699 | * get report |
| 700 | */ |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 701 | int usb_get_report(struct usb_device *dev, int ifnum, unsigned char type, |
| 702 | unsigned char id, void *buf, int size) |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 703 | { |
| 704 | return usb_control_msg(dev, usb_rcvctrlpipe(dev, 0), |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 705 | USB_REQ_GET_REPORT, |
| 706 | USB_DIR_IN | USB_TYPE_CLASS | USB_RECIP_INTERFACE, |
| 707 | (type << 8) + id, ifnum, buf, size, USB_CNTL_TIMEOUT); |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 708 | } |
| 709 | |
| 710 | /******************************************************************** |
| 711 | * get class descriptor |
| 712 | */ |
| 713 | int usb_get_class_descriptor(struct usb_device *dev, int ifnum, |
| 714 | unsigned char type, unsigned char id, void *buf, int size) |
| 715 | { |
| 716 | return usb_control_msg(dev, usb_rcvctrlpipe(dev, 0), |
| 717 | USB_REQ_GET_DESCRIPTOR, USB_RECIP_INTERFACE | USB_DIR_IN, |
| 718 | (type << 8) + id, ifnum, buf, size, USB_CNTL_TIMEOUT); |
| 719 | } |
| 720 | |
| 721 | /******************************************************************** |
| 722 | * get string index in buffer |
| 723 | */ |
Marek Vasut | c08b1b2 | 2012-02-13 18:58:16 +0000 | [diff] [blame] | 724 | static int usb_get_string(struct usb_device *dev, unsigned short langid, |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 725 | unsigned char index, void *buf, int size) |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 726 | { |
Wolfgang Denk | 9c998aa | 2005-07-21 11:57:57 +0200 | [diff] [blame] | 727 | int i; |
| 728 | int result; |
| 729 | |
| 730 | for (i = 0; i < 3; ++i) { |
| 731 | /* some devices are flaky */ |
| 732 | result = usb_control_msg(dev, usb_rcvctrlpipe(dev, 0), |
| 733 | USB_REQ_GET_DESCRIPTOR, USB_DIR_IN, |
Wolfgang Denk | 095b8a3 | 2005-08-02 17:06:17 +0200 | [diff] [blame] | 734 | (USB_DT_STRING << 8) + index, langid, buf, size, |
Wolfgang Denk | 9c998aa | 2005-07-21 11:57:57 +0200 | [diff] [blame] | 735 | USB_CNTL_TIMEOUT); |
| 736 | |
| 737 | if (result > 0) |
| 738 | break; |
Wolfgang Denk | 095b8a3 | 2005-08-02 17:06:17 +0200 | [diff] [blame] | 739 | } |
| 740 | |
Wolfgang Denk | 9c998aa | 2005-07-21 11:57:57 +0200 | [diff] [blame] | 741 | return result; |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 742 | } |
| 743 | |
Wolfgang Denk | 9c998aa | 2005-07-21 11:57:57 +0200 | [diff] [blame] | 744 | |
| 745 | static void usb_try_string_workarounds(unsigned char *buf, int *length) |
| 746 | { |
| 747 | int newlength, oldlength = *length; |
| 748 | |
| 749 | for (newlength = 2; newlength + 1 < oldlength; newlength += 2) |
| 750 | if (!isprint(buf[newlength]) || buf[newlength + 1]) |
| 751 | break; |
| 752 | |
| 753 | if (newlength > 2) { |
| 754 | buf[0] = newlength; |
| 755 | *length = newlength; |
| 756 | } |
| 757 | } |
| 758 | |
| 759 | |
| 760 | static int usb_string_sub(struct usb_device *dev, unsigned int langid, |
| 761 | unsigned int index, unsigned char *buf) |
| 762 | { |
| 763 | int rc; |
| 764 | |
| 765 | /* Try to read the string descriptor by asking for the maximum |
| 766 | * possible number of bytes */ |
| 767 | rc = usb_get_string(dev, langid, index, buf, 255); |
| 768 | |
| 769 | /* If that failed try to read the descriptor length, then |
| 770 | * ask for just that many bytes */ |
| 771 | if (rc < 2) { |
| 772 | rc = usb_get_string(dev, langid, index, buf, 2); |
| 773 | if (rc == 2) |
| 774 | rc = usb_get_string(dev, langid, index, buf, buf[0]); |
| 775 | } |
| 776 | |
| 777 | if (rc >= 2) { |
| 778 | if (!buf[0] && !buf[1]) |
| 779 | usb_try_string_workarounds(buf, &rc); |
| 780 | |
| 781 | /* There might be extra junk at the end of the descriptor */ |
| 782 | if (buf[0] < rc) |
| 783 | rc = buf[0]; |
| 784 | |
| 785 | rc = rc - (rc & 1); /* force a multiple of two */ |
| 786 | } |
| 787 | |
| 788 | if (rc < 2) |
Paul Kocialkowski | 5a80b34 | 2015-04-04 15:12:27 +0200 | [diff] [blame] | 789 | rc = -EINVAL; |
Wolfgang Denk | 9c998aa | 2005-07-21 11:57:57 +0200 | [diff] [blame] | 790 | |
| 791 | return rc; |
| 792 | } |
| 793 | |
| 794 | |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 795 | /******************************************************************** |
| 796 | * usb_string: |
| 797 | * Get string index and translate it to ascii. |
| 798 | * returns string length (> 0) or error (< 0) |
| 799 | */ |
| 800 | int usb_string(struct usb_device *dev, int index, char *buf, size_t size) |
| 801 | { |
Puneet Saxena | f576613 | 2012-04-03 14:56:06 +0530 | [diff] [blame] | 802 | ALLOC_CACHE_ALIGN_BUFFER(unsigned char, mybuf, USB_BUFSIZ); |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 803 | unsigned char *tbuf; |
| 804 | int err; |
| 805 | unsigned int u, idx; |
| 806 | |
| 807 | if (size <= 0 || !buf || !index) |
Paul Kocialkowski | 5a80b34 | 2015-04-04 15:12:27 +0200 | [diff] [blame] | 808 | return -EINVAL; |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 809 | buf[0] = 0; |
Wolfgang Denk | d0ff51b | 2008-07-14 15:19:07 +0200 | [diff] [blame] | 810 | tbuf = &mybuf[0]; |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 811 | |
| 812 | /* get langid for strings if it's not yet known */ |
| 813 | if (!dev->have_langid) { |
Wolfgang Denk | 9c998aa | 2005-07-21 11:57:57 +0200 | [diff] [blame] | 814 | err = usb_string_sub(dev, 0, 0, tbuf); |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 815 | if (err < 0) { |
Vivek Gautam | ceb4972 | 2013-04-12 16:34:33 +0530 | [diff] [blame] | 816 | debug("error getting string descriptor 0 " \ |
| 817 | "(error=%lx)\n", dev->status); |
Paul Kocialkowski | 5a80b34 | 2015-04-04 15:12:27 +0200 | [diff] [blame] | 818 | return -EIO; |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 819 | } else if (tbuf[0] < 4) { |
Vivek Gautam | ceb4972 | 2013-04-12 16:34:33 +0530 | [diff] [blame] | 820 | debug("string descriptor 0 too short\n"); |
Paul Kocialkowski | 5a80b34 | 2015-04-04 15:12:27 +0200 | [diff] [blame] | 821 | return -EIO; |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 822 | } else { |
| 823 | dev->have_langid = -1; |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 824 | dev->string_langid = tbuf[2] | (tbuf[3] << 8); |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 825 | /* always use the first langid listed */ |
Vivek Gautam | ceb4972 | 2013-04-12 16:34:33 +0530 | [diff] [blame] | 826 | debug("USB device number %d default " \ |
| 827 | "language ID 0x%x\n", |
| 828 | dev->devnum, dev->string_langid); |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 829 | } |
| 830 | } |
Wolfgang Denk | 9c998aa | 2005-07-21 11:57:57 +0200 | [diff] [blame] | 831 | |
| 832 | err = usb_string_sub(dev, dev->string_langid, index, tbuf); |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 833 | if (err < 0) |
| 834 | return err; |
wdenk | cd0a9de | 2004-02-23 20:48:38 +0000 | [diff] [blame] | 835 | |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 836 | size--; /* leave room for trailing NULL char in output buffer */ |
| 837 | for (idx = 0, u = 2; u < err; u += 2) { |
| 838 | if (idx >= size) |
| 839 | break; |
| 840 | if (tbuf[u+1]) /* high byte */ |
| 841 | buf[idx++] = '?'; /* non-ASCII character */ |
| 842 | else |
| 843 | buf[idx++] = tbuf[u]; |
| 844 | } |
| 845 | buf[idx] = 0; |
| 846 | err = idx; |
| 847 | return err; |
| 848 | } |
| 849 | |
| 850 | |
| 851 | /******************************************************************** |
| 852 | * USB device handling: |
| 853 | * the USB device are static allocated [USB_MAX_DEVICE]. |
| 854 | */ |
| 855 | |
Simon Glass | 95fbfe4 | 2015-03-25 12:22:08 -0600 | [diff] [blame] | 856 | #ifndef CONFIG_DM_USB |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 857 | |
| 858 | /* returns a pointer to the device with the index [index]. |
| 859 | * if the device is not assigned (dev->devnum==-1) returns NULL |
| 860 | */ |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 861 | struct usb_device *usb_get_dev_index(int index) |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 862 | { |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 863 | if (usb_dev[index].devnum == -1) |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 864 | return NULL; |
| 865 | else |
| 866 | return &usb_dev[index]; |
| 867 | } |
| 868 | |
Simon Glass | 79b5888 | 2015-03-25 12:22:01 -0600 | [diff] [blame] | 869 | int usb_alloc_new_device(struct udevice *controller, struct usb_device **devp) |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 870 | { |
| 871 | int i; |
Vivek Gautam | ceb4972 | 2013-04-12 16:34:33 +0530 | [diff] [blame] | 872 | debug("New Device %d\n", dev_index); |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 873 | if (dev_index == USB_MAX_DEVICE) { |
| 874 | printf("ERROR, too many USB Devices, max=%d\n", USB_MAX_DEVICE); |
Simon Glass | 79b5888 | 2015-03-25 12:22:01 -0600 | [diff] [blame] | 875 | return -ENOSPC; |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 876 | } |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 877 | /* default Address is 0, real addresses start with 1 */ |
| 878 | usb_dev[dev_index].devnum = dev_index + 1; |
| 879 | usb_dev[dev_index].maxchild = 0; |
| 880 | for (i = 0; i < USB_MAXCHILDREN; i++) |
| 881 | usb_dev[dev_index].children[i] = NULL; |
| 882 | usb_dev[dev_index].parent = NULL; |
Lucas Stach | c7e3b2b | 2012-09-26 00:14:34 +0200 | [diff] [blame] | 883 | usb_dev[dev_index].controller = controller; |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 884 | dev_index++; |
Simon Glass | 79b5888 | 2015-03-25 12:22:01 -0600 | [diff] [blame] | 885 | *devp = &usb_dev[dev_index - 1]; |
| 886 | |
| 887 | return 0; |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 888 | } |
| 889 | |
Milind Choudhary | 359439d | 2012-12-12 17:55:28 -0800 | [diff] [blame] | 890 | /* |
| 891 | * Free the newly created device node. |
| 892 | * Called in error cases where configuring a newly attached |
| 893 | * device fails for some reason. |
| 894 | */ |
Simon Glass | 79b5888 | 2015-03-25 12:22:01 -0600 | [diff] [blame] | 895 | void usb_free_device(struct udevice *controller) |
Milind Choudhary | 359439d | 2012-12-12 17:55:28 -0800 | [diff] [blame] | 896 | { |
| 897 | dev_index--; |
Vivek Gautam | ceb4972 | 2013-04-12 16:34:33 +0530 | [diff] [blame] | 898 | debug("Freeing device node: %d\n", dev_index); |
Milind Choudhary | 359439d | 2012-12-12 17:55:28 -0800 | [diff] [blame] | 899 | memset(&usb_dev[dev_index], 0, sizeof(struct usb_device)); |
| 900 | usb_dev[dev_index].devnum = -1; |
| 901 | } |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 902 | |
| 903 | /* |
Vivek Gautam | 5853e13 | 2013-09-14 14:02:45 +0530 | [diff] [blame] | 904 | * XHCI issues Enable Slot command and thereafter |
| 905 | * allocates device contexts. Provide a weak alias |
| 906 | * function for the purpose, so that XHCI overrides it |
| 907 | * and EHCI/OHCI just work out of the box. |
| 908 | */ |
| 909 | __weak int usb_alloc_device(struct usb_device *udev) |
| 910 | { |
| 911 | return 0; |
| 912 | } |
Simon Glass | 95fbfe4 | 2015-03-25 12:22:08 -0600 | [diff] [blame] | 913 | #endif /* !CONFIG_DM_USB */ |
Simon Glass | 862e75c | 2015-03-25 12:22:04 -0600 | [diff] [blame] | 914 | |
Hans de Goede | 682c9f8 | 2015-06-17 21:33:47 +0200 | [diff] [blame] | 915 | static int usb_hub_port_reset(struct usb_device *dev, struct usb_device *hub) |
Simon Glass | 862e75c | 2015-03-25 12:22:04 -0600 | [diff] [blame] | 916 | { |
| 917 | if (hub) { |
| 918 | unsigned short portstatus; |
| 919 | int err; |
| 920 | |
| 921 | /* reset the port for the second time */ |
Hans de Goede | 682c9f8 | 2015-06-17 21:33:47 +0200 | [diff] [blame] | 922 | err = legacy_hub_port_reset(hub, dev->portnr - 1, &portstatus); |
Simon Glass | 862e75c | 2015-03-25 12:22:04 -0600 | [diff] [blame] | 923 | if (err < 0) { |
Hans de Goede | 682c9f8 | 2015-06-17 21:33:47 +0200 | [diff] [blame] | 924 | printf("\n Couldn't reset port %i\n", dev->portnr); |
Simon Glass | 862e75c | 2015-03-25 12:22:04 -0600 | [diff] [blame] | 925 | return err; |
| 926 | } |
| 927 | } else { |
Hans de Goede | 8802f56 | 2015-06-17 21:33:48 +0200 | [diff] [blame] | 928 | usb_reset_root_port(dev); |
Simon Glass | 862e75c | 2015-03-25 12:22:04 -0600 | [diff] [blame] | 929 | } |
| 930 | |
| 931 | return 0; |
| 932 | } |
| 933 | |
Simon Glass | 0ed2790 | 2015-03-25 12:22:07 -0600 | [diff] [blame] | 934 | static int get_descriptor_len(struct usb_device *dev, int len, int expect_len) |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 935 | { |
Simon Glass | 128fcac | 2015-03-25 12:22:05 -0600 | [diff] [blame] | 936 | __maybe_unused struct usb_device_descriptor *desc; |
Puneet Saxena | f576613 | 2012-04-03 14:56:06 +0530 | [diff] [blame] | 937 | ALLOC_CACHE_ALIGN_BUFFER(unsigned char, tmpbuf, USB_BUFSIZ); |
Simon Glass | 0ed2790 | 2015-03-25 12:22:07 -0600 | [diff] [blame] | 938 | int err; |
| 939 | |
| 940 | desc = (struct usb_device_descriptor *)tmpbuf; |
| 941 | |
| 942 | err = usb_get_descriptor(dev, USB_DT_DEVICE, 0, desc, len); |
| 943 | if (err < expect_len) { |
| 944 | if (err < 0) { |
| 945 | printf("unable to get device descriptor (error=%d)\n", |
| 946 | err); |
| 947 | return err; |
| 948 | } else { |
| 949 | printf("USB device descriptor short read (expected %i, got %i)\n", |
| 950 | expect_len, err); |
| 951 | return -EIO; |
| 952 | } |
| 953 | } |
| 954 | memcpy(&dev->descriptor, tmpbuf, sizeof(dev->descriptor)); |
| 955 | |
| 956 | return 0; |
| 957 | } |
| 958 | |
| 959 | static int usb_setup_descriptor(struct usb_device *dev, bool do_read) |
| 960 | { |
Vivek Gautam | 5853e13 | 2013-09-14 14:02:45 +0530 | [diff] [blame] | 961 | /* |
Simon Glass | 53d8aa0 | 2015-03-25 12:22:03 -0600 | [diff] [blame] | 962 | * This is a Windows scheme of initialization sequence, with double |
Remy Bohmer | 4886720 | 2008-10-10 10:23:21 +0200 | [diff] [blame] | 963 | * reset of the device (Linux uses the same sequence) |
Remy Bohmer | c9e8436 | 2008-09-16 14:55:44 +0200 | [diff] [blame] | 964 | * Some equipment is said to work only with such init sequence; this |
| 965 | * patch is based on the work by Alan Stern: |
Michael Trimarchi | de39f8c | 2008-11-26 17:41:34 +0100 | [diff] [blame] | 966 | * http://sourceforge.net/mailarchive/forum.php? |
| 967 | * thread_id=5729457&forum_id=5398 |
Wolfgang Denk | 9c998aa | 2005-07-21 11:57:57 +0200 | [diff] [blame] | 968 | */ |
Wolfgang Denk | 9c998aa | 2005-07-21 11:57:57 +0200 | [diff] [blame] | 969 | |
Simon Glass | 53d8aa0 | 2015-03-25 12:22:03 -0600 | [diff] [blame] | 970 | /* |
| 971 | * send 64-byte GET-DEVICE-DESCRIPTOR request. Since the descriptor is |
Wolfgang Denk | 9c998aa | 2005-07-21 11:57:57 +0200 | [diff] [blame] | 972 | * only 18 bytes long, this will terminate with a short packet. But if |
| 973 | * the maxpacket size is 8 or 16 the device may be waiting to transmit |
Hans de Goede | 2b338ef | 2015-05-05 23:56:04 +0200 | [diff] [blame] | 974 | * some more, or keeps on retransmitting the 8 byte header. |
| 975 | */ |
Wolfgang Denk | 9c998aa | 2005-07-21 11:57:57 +0200 | [diff] [blame] | 976 | |
Hans de Goede | 2b338ef | 2015-05-05 23:56:04 +0200 | [diff] [blame] | 977 | if (dev->speed == USB_SPEED_LOW) { |
| 978 | dev->descriptor.bMaxPacketSize0 = 8; |
| 979 | dev->maxpacketsize = PACKET_SIZE_8; |
| 980 | } else { |
| 981 | dev->descriptor.bMaxPacketSize0 = 64; |
| 982 | dev->maxpacketsize = PACKET_SIZE_64; |
| 983 | } |
| 984 | dev->epmaxpacketin[0] = dev->descriptor.bMaxPacketSize0; |
| 985 | dev->epmaxpacketout[0] = dev->descriptor.bMaxPacketSize0; |
Remy Bohmer | 4886720 | 2008-10-10 10:23:21 +0200 | [diff] [blame] | 986 | |
Simon Glass | 128fcac | 2015-03-25 12:22:05 -0600 | [diff] [blame] | 987 | if (do_read) { |
| 988 | int err; |
Simon Glass | 862e75c | 2015-03-25 12:22:04 -0600 | [diff] [blame] | 989 | |
Simon Glass | 128fcac | 2015-03-25 12:22:05 -0600 | [diff] [blame] | 990 | /* |
| 991 | * Validate we've received only at least 8 bytes, not that we've |
| 992 | * received the entire descriptor. The reasoning is: |
| 993 | * - The code only uses fields in the first 8 bytes, so that's all we |
| 994 | * need to have fetched at this stage. |
| 995 | * - The smallest maxpacket size is 8 bytes. Before we know the actual |
| 996 | * maxpacket the device uses, the USB controller may only accept a |
| 997 | * single packet. Consequently we are only guaranteed to receive 1 |
| 998 | * packet (at least 8 bytes) even in a non-error case. |
| 999 | * |
| 1000 | * At least the DWC2 controller needs to be programmed with the number |
| 1001 | * of packets in addition to the number of bytes. A request for 64 |
| 1002 | * bytes of data with the maxpacket guessed as 64 (above) yields a |
| 1003 | * request for 1 packet. |
| 1004 | */ |
Simon Glass | 0ed2790 | 2015-03-25 12:22:07 -0600 | [diff] [blame] | 1005 | err = get_descriptor_len(dev, 64, 8); |
| 1006 | if (err) |
| 1007 | return err; |
Wolfgang Denk | 9c998aa | 2005-07-21 11:57:57 +0200 | [diff] [blame] | 1008 | } |
Remy Bohmer | 4886720 | 2008-10-10 10:23:21 +0200 | [diff] [blame] | 1009 | |
Michael Trimarchi | de39f8c | 2008-11-26 17:41:34 +0100 | [diff] [blame] | 1010 | dev->epmaxpacketin[0] = dev->descriptor.bMaxPacketSize0; |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 1011 | dev->epmaxpacketout[0] = dev->descriptor.bMaxPacketSize0; |
| 1012 | switch (dev->descriptor.bMaxPacketSize0) { |
Michael Trimarchi | de39f8c | 2008-11-26 17:41:34 +0100 | [diff] [blame] | 1013 | case 8: |
| 1014 | dev->maxpacketsize = PACKET_SIZE_8; |
| 1015 | break; |
| 1016 | case 16: |
| 1017 | dev->maxpacketsize = PACKET_SIZE_16; |
| 1018 | break; |
| 1019 | case 32: |
| 1020 | dev->maxpacketsize = PACKET_SIZE_32; |
| 1021 | break; |
| 1022 | case 64: |
| 1023 | dev->maxpacketsize = PACKET_SIZE_64; |
| 1024 | break; |
Paul Kocialkowski | 04ee6ee | 2015-04-04 15:12:29 +0200 | [diff] [blame] | 1025 | default: |
| 1026 | printf("usb_new_device: invalid max packet size\n"); |
| 1027 | return -EIO; |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 1028 | } |
Simon Glass | 128fcac | 2015-03-25 12:22:05 -0600 | [diff] [blame] | 1029 | |
| 1030 | return 0; |
| 1031 | } |
| 1032 | |
Simon Glass | 91398f9 | 2015-03-25 12:22:06 -0600 | [diff] [blame] | 1033 | static int usb_prepare_device(struct usb_device *dev, int addr, bool do_read, |
Hans de Goede | 9eb72dd | 2015-06-17 21:33:46 +0200 | [diff] [blame] | 1034 | struct usb_device *parent) |
Simon Glass | 91398f9 | 2015-03-25 12:22:06 -0600 | [diff] [blame] | 1035 | { |
| 1036 | int err; |
| 1037 | |
| 1038 | /* |
| 1039 | * Allocate usb 3.0 device context. |
| 1040 | * USB 3.0 (xHCI) protocol tries to allocate device slot |
| 1041 | * and related data structures first. This call does that. |
| 1042 | * Refer to sec 4.3.2 in xHCI spec rev1.0 |
| 1043 | */ |
| 1044 | err = usb_alloc_device(dev); |
| 1045 | if (err) { |
| 1046 | printf("Cannot allocate device context to get SLOT_ID\n"); |
| 1047 | return err; |
| 1048 | } |
| 1049 | err = usb_setup_descriptor(dev, do_read); |
| 1050 | if (err) |
| 1051 | return err; |
Hans de Goede | 682c9f8 | 2015-06-17 21:33:47 +0200 | [diff] [blame] | 1052 | err = usb_hub_port_reset(dev, parent); |
Simon Glass | 91398f9 | 2015-03-25 12:22:06 -0600 | [diff] [blame] | 1053 | if (err) |
| 1054 | return err; |
| 1055 | |
| 1056 | dev->devnum = addr; |
| 1057 | |
| 1058 | err = usb_set_address(dev); /* set address */ |
| 1059 | |
| 1060 | if (err < 0) { |
| 1061 | printf("\n USB device not accepting new address " \ |
| 1062 | "(error=%lX)\n", dev->status); |
| 1063 | return err; |
| 1064 | } |
| 1065 | |
| 1066 | mdelay(10); /* Let the SET_ADDRESS settle */ |
| 1067 | |
| 1068 | return 0; |
| 1069 | } |
| 1070 | |
Simon Glass | 95fbfe4 | 2015-03-25 12:22:08 -0600 | [diff] [blame] | 1071 | int usb_select_config(struct usb_device *dev) |
Simon Glass | 128fcac | 2015-03-25 12:22:05 -0600 | [diff] [blame] | 1072 | { |
Simon Glass | 128fcac | 2015-03-25 12:22:05 -0600 | [diff] [blame] | 1073 | ALLOC_CACHE_ALIGN_BUFFER(unsigned char, tmpbuf, USB_BUFSIZ); |
Simon Glass | 0ed2790 | 2015-03-25 12:22:07 -0600 | [diff] [blame] | 1074 | int err; |
Simon Glass | 128fcac | 2015-03-25 12:22:05 -0600 | [diff] [blame] | 1075 | |
Simon Glass | 0ed2790 | 2015-03-25 12:22:07 -0600 | [diff] [blame] | 1076 | err = get_descriptor_len(dev, USB_DT_DEVICE_SIZE, USB_DT_DEVICE_SIZE); |
| 1077 | if (err) |
| 1078 | return err; |
Simon Glass | 128fcac | 2015-03-25 12:22:05 -0600 | [diff] [blame] | 1079 | |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 1080 | /* correct le values */ |
Christian Eggers | c918261 | 2008-05-21 22:12:00 +0200 | [diff] [blame] | 1081 | le16_to_cpus(&dev->descriptor.bcdUSB); |
| 1082 | le16_to_cpus(&dev->descriptor.idVendor); |
| 1083 | le16_to_cpus(&dev->descriptor.idProduct); |
| 1084 | le16_to_cpus(&dev->descriptor.bcdDevice); |
Simon Glass | 0ed2790 | 2015-03-25 12:22:07 -0600 | [diff] [blame] | 1085 | |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 1086 | /* only support for one config for now */ |
Vincent Palatin | 8b8d779 | 2012-07-24 07:12:02 +0000 | [diff] [blame] | 1087 | err = usb_get_configuration_no(dev, tmpbuf, 0); |
| 1088 | if (err < 0) { |
| 1089 | printf("usb_new_device: Cannot read configuration, " \ |
| 1090 | "skipping device %04x:%04x\n", |
| 1091 | dev->descriptor.idVendor, dev->descriptor.idProduct); |
Simon Glass | 0ed2790 | 2015-03-25 12:22:07 -0600 | [diff] [blame] | 1092 | return err; |
Vincent Palatin | 8b8d779 | 2012-07-24 07:12:02 +0000 | [diff] [blame] | 1093 | } |
Puneet Saxena | f576613 | 2012-04-03 14:56:06 +0530 | [diff] [blame] | 1094 | usb_parse_config(dev, tmpbuf, 0); |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 1095 | usb_set_maxpacket(dev); |
Simon Glass | 0ed2790 | 2015-03-25 12:22:07 -0600 | [diff] [blame] | 1096 | /* |
| 1097 | * we set the default configuration here |
| 1098 | * This seems premature. If the driver wants a different configuration |
| 1099 | * it will need to select itself. |
| 1100 | */ |
| 1101 | err = usb_set_configuration(dev, dev->config.desc.bConfigurationValue); |
| 1102 | if (err < 0) { |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 1103 | printf("failed to set default configuration " \ |
| 1104 | "len %d, status %lX\n", dev->act_len, dev->status); |
Simon Glass | 0ed2790 | 2015-03-25 12:22:07 -0600 | [diff] [blame] | 1105 | return err; |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 1106 | } |
Vivek Gautam | ceb4972 | 2013-04-12 16:34:33 +0530 | [diff] [blame] | 1107 | debug("new device strings: Mfr=%d, Product=%d, SerialNumber=%d\n", |
| 1108 | dev->descriptor.iManufacturer, dev->descriptor.iProduct, |
| 1109 | dev->descriptor.iSerialNumber); |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 1110 | memset(dev->mf, 0, sizeof(dev->mf)); |
| 1111 | memset(dev->prod, 0, sizeof(dev->prod)); |
| 1112 | memset(dev->serial, 0, sizeof(dev->serial)); |
| 1113 | if (dev->descriptor.iManufacturer) |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 1114 | usb_string(dev, dev->descriptor.iManufacturer, |
| 1115 | dev->mf, sizeof(dev->mf)); |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 1116 | if (dev->descriptor.iProduct) |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 1117 | usb_string(dev, dev->descriptor.iProduct, |
| 1118 | dev->prod, sizeof(dev->prod)); |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 1119 | if (dev->descriptor.iSerialNumber) |
Remy Bohmer | 6f5794a | 2008-09-16 14:55:43 +0200 | [diff] [blame] | 1120 | usb_string(dev, dev->descriptor.iSerialNumber, |
| 1121 | dev->serial, sizeof(dev->serial)); |
Vivek Gautam | ceb4972 | 2013-04-12 16:34:33 +0530 | [diff] [blame] | 1122 | debug("Manufacturer %s\n", dev->mf); |
| 1123 | debug("Product %s\n", dev->prod); |
| 1124 | debug("SerialNumber %s\n", dev->serial); |
Simon Glass | 0ed2790 | 2015-03-25 12:22:07 -0600 | [diff] [blame] | 1125 | |
| 1126 | return 0; |
| 1127 | } |
| 1128 | |
Simon Glass | 95fbfe4 | 2015-03-25 12:22:08 -0600 | [diff] [blame] | 1129 | int usb_setup_device(struct usb_device *dev, bool do_read, |
Hans de Goede | 9eb72dd | 2015-06-17 21:33:46 +0200 | [diff] [blame] | 1130 | struct usb_device *parent) |
Simon Glass | 0ed2790 | 2015-03-25 12:22:07 -0600 | [diff] [blame] | 1131 | { |
| 1132 | int addr; |
| 1133 | int ret; |
| 1134 | |
| 1135 | /* We still haven't set the Address yet */ |
| 1136 | addr = dev->devnum; |
| 1137 | dev->devnum = 0; |
| 1138 | |
Hans de Goede | 9eb72dd | 2015-06-17 21:33:46 +0200 | [diff] [blame] | 1139 | ret = usb_prepare_device(dev, addr, do_read, parent); |
Simon Glass | 0ed2790 | 2015-03-25 12:22:07 -0600 | [diff] [blame] | 1140 | if (ret) |
| 1141 | return ret; |
| 1142 | ret = usb_select_config(dev); |
| 1143 | |
| 1144 | return ret; |
| 1145 | } |
| 1146 | |
Simon Glass | 95fbfe4 | 2015-03-25 12:22:08 -0600 | [diff] [blame] | 1147 | #ifndef CONFIG_DM_USB |
Simon Glass | 0ed2790 | 2015-03-25 12:22:07 -0600 | [diff] [blame] | 1148 | /* |
| 1149 | * By the time we get here, the device has gotten a new device ID |
| 1150 | * and is in the default state. We need to identify the thing and |
| 1151 | * get the ball rolling.. |
| 1152 | * |
| 1153 | * Returns 0 for success, != 0 for error. |
| 1154 | */ |
| 1155 | int usb_new_device(struct usb_device *dev) |
| 1156 | { |
| 1157 | bool do_read = true; |
| 1158 | int err; |
| 1159 | |
| 1160 | /* |
| 1161 | * XHCI needs to issue a Address device command to setup |
| 1162 | * proper device context structures, before it can interact |
| 1163 | * with the device. So a get_descriptor will fail before any |
| 1164 | * of that is done for XHCI unlike EHCI. |
| 1165 | */ |
| 1166 | #ifdef CONFIG_USB_XHCI |
| 1167 | do_read = false; |
| 1168 | #endif |
Hans de Goede | 9eb72dd | 2015-06-17 21:33:46 +0200 | [diff] [blame] | 1169 | err = usb_setup_device(dev, do_read, dev->parent); |
Simon Glass | 0ed2790 | 2015-03-25 12:22:07 -0600 | [diff] [blame] | 1170 | if (err) |
| 1171 | return err; |
| 1172 | |
| 1173 | /* Now probe if the device is a hub */ |
| 1174 | err = usb_hub_probe(dev, 0); |
| 1175 | if (err < 0) |
| 1176 | return err; |
| 1177 | |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 1178 | return 0; |
| 1179 | } |
Simon Glass | 95fbfe4 | 2015-03-25 12:22:08 -0600 | [diff] [blame] | 1180 | #endif |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 1181 | |
Mateusz Zalega | 16297cf | 2013-10-04 19:22:26 +0200 | [diff] [blame] | 1182 | __weak |
Troy Kisky | bba6791 | 2013-10-10 15:27:55 -0700 | [diff] [blame] | 1183 | int board_usb_init(int index, enum usb_init_type init) |
Mateusz Zalega | 16297cf | 2013-10-04 19:22:26 +0200 | [diff] [blame] | 1184 | { |
| 1185 | return 0; |
| 1186 | } |
Kishon Vijay Abraham I | db378d7 | 2015-02-23 18:40:18 +0530 | [diff] [blame] | 1187 | |
| 1188 | __weak |
| 1189 | int board_usb_cleanup(int index, enum usb_init_type init) |
| 1190 | { |
| 1191 | return 0; |
| 1192 | } |
Simon Glass | 95fbfe4 | 2015-03-25 12:22:08 -0600 | [diff] [blame] | 1193 | |
| 1194 | bool usb_device_has_child_on_port(struct usb_device *parent, int port) |
| 1195 | { |
| 1196 | #ifdef CONFIG_DM_USB |
| 1197 | return false; |
| 1198 | #else |
| 1199 | return parent->children[port] != NULL; |
| 1200 | #endif |
| 1201 | } |
| 1202 | |
wdenk | affae2b | 2002-08-17 09:36:01 +0000 | [diff] [blame] | 1203 | /* EOF */ |