blob: 5d1fde30e344a4e96eca5db5164a7a02cfae3bc3 [file] [log] [blame]
Vivek Gautam4912dcc2013-09-14 14:02:45 +05301/*
2 * USB HOST XHCI Controller stack
3 *
4 * Based on xHCI host controller driver in linux-kernel
5 * by Sarah Sharp.
6 *
7 * Copyright (C) 2008 Intel Corp.
8 * Author: Sarah Sharp
9 *
10 * Copyright (C) 2013 Samsung Electronics Co.Ltd
11 * Authors: Vivek Gautam <gautam.vivek@samsung.com>
12 * Vikas Sajjan <vikas.sajjan@samsung.com>
13 *
14 * SPDX-License-Identifier: GPL-2.0+
15 */
16
17/**
18 * This file gives the xhci stack for usb3.0 looking into
19 * xhci specification Rev1.0 (5/21/10).
20 * The quirk devices support hasn't been given yet.
21 */
22
23#include <common.h>
24#include <asm/byteorder.h>
25#include <usb.h>
26#include <malloc.h>
27#include <watchdog.h>
28#include <asm/cache.h>
29#include <asm/unaligned.h>
30#include <asm-generic/errno.h>
31#include "xhci.h"
32
33#ifndef CONFIG_USB_MAX_CONTROLLER_COUNT
34#define CONFIG_USB_MAX_CONTROLLER_COUNT 1
35#endif
36
37static struct descriptor {
38 struct usb_hub_descriptor hub;
39 struct usb_device_descriptor device;
40 struct usb_config_descriptor config;
41 struct usb_interface_descriptor interface;
42 struct usb_endpoint_descriptor endpoint;
43 struct usb_ss_ep_comp_descriptor ep_companion;
44} __attribute__ ((packed)) descriptor = {
45 {
46 0xc, /* bDescLength */
47 0x2a, /* bDescriptorType: hub descriptor */
48 2, /* bNrPorts -- runtime modified */
49 cpu_to_le16(0x8), /* wHubCharacteristics */
50 10, /* bPwrOn2PwrGood */
51 0, /* bHubCntrCurrent */
52 {}, /* Device removable */
53 {} /* at most 7 ports! XXX */
54 },
55 {
56 0x12, /* bLength */
57 1, /* bDescriptorType: UDESC_DEVICE */
58 cpu_to_le16(0x0300), /* bcdUSB: v3.0 */
59 9, /* bDeviceClass: UDCLASS_HUB */
60 0, /* bDeviceSubClass: UDSUBCLASS_HUB */
61 3, /* bDeviceProtocol: UDPROTO_SSHUBSTT */
62 9, /* bMaxPacketSize: 512 bytes 2^9 */
63 0x0000, /* idVendor */
64 0x0000, /* idProduct */
65 cpu_to_le16(0x0100), /* bcdDevice */
66 1, /* iManufacturer */
67 2, /* iProduct */
68 0, /* iSerialNumber */
69 1 /* bNumConfigurations: 1 */
70 },
71 {
72 0x9,
73 2, /* bDescriptorType: UDESC_CONFIG */
74 cpu_to_le16(0x1f), /* includes SS endpoint descriptor */
75 1, /* bNumInterface */
76 1, /* bConfigurationValue */
77 0, /* iConfiguration */
78 0x40, /* bmAttributes: UC_SELF_POWER */
79 0 /* bMaxPower */
80 },
81 {
82 0x9, /* bLength */
83 4, /* bDescriptorType: UDESC_INTERFACE */
84 0, /* bInterfaceNumber */
85 0, /* bAlternateSetting */
86 1, /* bNumEndpoints */
87 9, /* bInterfaceClass: UICLASS_HUB */
88 0, /* bInterfaceSubClass: UISUBCLASS_HUB */
89 0, /* bInterfaceProtocol: UIPROTO_HSHUBSTT */
90 0 /* iInterface */
91 },
92 {
93 0x7, /* bLength */
94 5, /* bDescriptorType: UDESC_ENDPOINT */
95 0x81, /* bEndpointAddress: IN endpoint 1 */
96 3, /* bmAttributes: UE_INTERRUPT */
97 8, /* wMaxPacketSize */
98 255 /* bInterval */
99 },
100 {
101 0x06, /* ss_bLength */
102 0x30, /* ss_bDescriptorType: SS EP Companion */
103 0x00, /* ss_bMaxBurst: allows 1 TX between ACKs */
104 /* ss_bmAttributes: 1 packet per service interval */
105 0x00,
106 /* ss_wBytesPerInterval: 15 bits for max 15 ports */
107 cpu_to_le16(0x02),
108 },
109};
110
111static struct xhci_ctrl xhcic[CONFIG_USB_MAX_CONTROLLER_COUNT];
112
Simon Glassa49e27b2015-03-25 12:22:49 -0600113struct xhci_ctrl *xhci_get_ctrl(struct usb_device *udev)
114{
115 return udev->controller;
116}
117
Vivek Gautam4912dcc2013-09-14 14:02:45 +0530118/**
119 * Waits for as per specified amount of time
120 * for the "result" to match with "done"
121 *
122 * @param ptr pointer to the register to be read
123 * @param mask mask for the value read
124 * @param done value to be campared with result
125 * @param usec time to wait till
126 * @return 0 if handshake is success else < 0 on failure
127 */
128static int handshake(uint32_t volatile *ptr, uint32_t mask,
129 uint32_t done, int usec)
130{
131 uint32_t result;
132
133 do {
134 result = xhci_readl(ptr);
135 if (result == ~(uint32_t)0)
136 return -ENODEV;
137 result &= mask;
138 if (result == done)
139 return 0;
140 usec--;
141 udelay(1);
142 } while (usec > 0);
143
144 return -ETIMEDOUT;
145}
146
147/**
148 * Set the run bit and wait for the host to be running.
149 *
150 * @param hcor pointer to host controller operation registers
151 * @return status of the Handshake
152 */
153static int xhci_start(struct xhci_hcor *hcor)
154{
155 u32 temp;
156 int ret;
157
158 puts("Starting the controller\n");
159 temp = xhci_readl(&hcor->or_usbcmd);
160 temp |= (CMD_RUN);
161 xhci_writel(&hcor->or_usbcmd, temp);
162
163 /*
164 * Wait for the HCHalted Status bit to be 0 to indicate the host is
165 * running.
166 */
167 ret = handshake(&hcor->or_usbsts, STS_HALT, 0, XHCI_MAX_HALT_USEC);
168 if (ret)
169 debug("Host took too long to start, "
170 "waited %u microseconds.\n",
171 XHCI_MAX_HALT_USEC);
172 return ret;
173}
174
175/**
176 * Resets the XHCI Controller
177 *
178 * @param hcor pointer to host controller operation registers
179 * @return -EBUSY if XHCI Controller is not halted else status of handshake
180 */
181int xhci_reset(struct xhci_hcor *hcor)
182{
183 u32 cmd;
184 u32 state;
185 int ret;
186
187 /* Halting the Host first */
188 debug("// Halt the HC\n");
189 state = xhci_readl(&hcor->or_usbsts) & STS_HALT;
190 if (!state) {
191 cmd = xhci_readl(&hcor->or_usbcmd);
192 cmd &= ~CMD_RUN;
193 xhci_writel(&hcor->or_usbcmd, cmd);
194 }
195
196 ret = handshake(&hcor->or_usbsts,
197 STS_HALT, STS_HALT, XHCI_MAX_HALT_USEC);
198 if (ret) {
199 printf("Host not halted after %u microseconds.\n",
200 XHCI_MAX_HALT_USEC);
201 return -EBUSY;
202 }
203
204 debug("// Reset the HC\n");
205 cmd = xhci_readl(&hcor->or_usbcmd);
206 cmd |= CMD_RESET;
207 xhci_writel(&hcor->or_usbcmd, cmd);
208
209 ret = handshake(&hcor->or_usbcmd, CMD_RESET, 0, XHCI_MAX_RESET_USEC);
210 if (ret)
211 return ret;
212
213 /*
214 * xHCI cannot write to any doorbells or operational registers other
215 * than status until the "Controller Not Ready" flag is cleared.
216 */
217 return handshake(&hcor->or_usbsts, STS_CNR, 0, XHCI_MAX_RESET_USEC);
218}
219
220/**
221 * Used for passing endpoint bitmasks between the core and HCDs.
222 * Find the index for an endpoint given its descriptor.
223 * Use the return value to right shift 1 for the bitmask.
224 *
225 * Index = (epnum * 2) + direction - 1,
226 * where direction = 0 for OUT, 1 for IN.
227 * For control endpoints, the IN index is used (OUT index is unused), so
228 * index = (epnum * 2) + direction - 1 = (epnum * 2) + 1 - 1 = (epnum * 2)
229 *
230 * @param desc USB enpdoint Descriptor
231 * @return index of the Endpoint
232 */
233static unsigned int xhci_get_ep_index(struct usb_endpoint_descriptor *desc)
234{
235 unsigned int index;
236
237 if (usb_endpoint_xfer_control(desc))
238 index = (unsigned int)(usb_endpoint_num(desc) * 2);
239 else
240 index = (unsigned int)((usb_endpoint_num(desc) * 2) -
241 (usb_endpoint_dir_in(desc) ? 0 : 1));
242
243 return index;
244}
245
246/**
247 * Issue a configure endpoint command or evaluate context command
248 * and wait for it to finish.
249 *
250 * @param udev pointer to the Device Data Structure
251 * @param ctx_change flag to indicate the Context has changed or NOT
252 * @return 0 on success, -1 on failure
253 */
254static int xhci_configure_endpoints(struct usb_device *udev, bool ctx_change)
255{
256 struct xhci_container_ctx *in_ctx;
257 struct xhci_virt_device *virt_dev;
Simon Glassa49e27b2015-03-25 12:22:49 -0600258 struct xhci_ctrl *ctrl = xhci_get_ctrl(udev);
Vivek Gautam4912dcc2013-09-14 14:02:45 +0530259 union xhci_trb *event;
260
261 virt_dev = ctrl->devs[udev->slot_id];
262 in_ctx = virt_dev->in_ctx;
263
Sergey Temerkhanov38593462015-04-01 17:18:45 +0300264 xhci_flush_cache((uintptr_t)in_ctx->bytes, in_ctx->size);
Vivek Gautam4912dcc2013-09-14 14:02:45 +0530265 xhci_queue_command(ctrl, in_ctx->bytes, udev->slot_id, 0,
266 ctx_change ? TRB_EVAL_CONTEXT : TRB_CONFIG_EP);
267 event = xhci_wait_for_event(ctrl, TRB_COMPLETION);
268 BUG_ON(TRB_TO_SLOT_ID(le32_to_cpu(event->event_cmd.flags))
269 != udev->slot_id);
270
271 switch (GET_COMP_CODE(le32_to_cpu(event->event_cmd.status))) {
272 case COMP_SUCCESS:
273 debug("Successful %s command\n",
274 ctx_change ? "Evaluate Context" : "Configure Endpoint");
275 break;
276 default:
277 printf("ERROR: %s command returned completion code %d.\n",
278 ctx_change ? "Evaluate Context" : "Configure Endpoint",
279 GET_COMP_CODE(le32_to_cpu(event->event_cmd.status)));
280 return -EINVAL;
281 }
282
283 xhci_acknowledge_event(ctrl);
284
285 return 0;
286}
287
288/**
289 * Configure the endpoint, programming the device contexts.
290 *
291 * @param udev pointer to the USB device structure
292 * @return returns the status of the xhci_configure_endpoints
293 */
294static int xhci_set_configuration(struct usb_device *udev)
295{
296 struct xhci_container_ctx *in_ctx;
297 struct xhci_container_ctx *out_ctx;
298 struct xhci_input_control_ctx *ctrl_ctx;
299 struct xhci_slot_ctx *slot_ctx;
300 struct xhci_ep_ctx *ep_ctx[MAX_EP_CTX_NUM];
301 int cur_ep;
302 int max_ep_flag = 0;
303 int ep_index;
304 unsigned int dir;
305 unsigned int ep_type;
Simon Glassa49e27b2015-03-25 12:22:49 -0600306 struct xhci_ctrl *ctrl = xhci_get_ctrl(udev);
Vivek Gautam4912dcc2013-09-14 14:02:45 +0530307 int num_of_ep;
308 int ep_flag = 0;
309 u64 trb_64 = 0;
310 int slot_id = udev->slot_id;
311 struct xhci_virt_device *virt_dev = ctrl->devs[slot_id];
312 struct usb_interface *ifdesc;
313
314 out_ctx = virt_dev->out_ctx;
315 in_ctx = virt_dev->in_ctx;
316
317 num_of_ep = udev->config.if_desc[0].no_of_ep;
318 ifdesc = &udev->config.if_desc[0];
319
320 ctrl_ctx = xhci_get_input_control_ctx(in_ctx);
321 /* Zero the input context control */
322 ctrl_ctx->add_flags = 0;
323 ctrl_ctx->drop_flags = 0;
324
325 /* EP_FLAG gives values 1 & 4 for EP1OUT and EP2IN */
326 for (cur_ep = 0; cur_ep < num_of_ep; cur_ep++) {
327 ep_flag = xhci_get_ep_index(&ifdesc->ep_desc[cur_ep]);
328 ctrl_ctx->add_flags |= cpu_to_le32(1 << (ep_flag + 1));
329 if (max_ep_flag < ep_flag)
330 max_ep_flag = ep_flag;
331 }
332
Sergey Temerkhanov38593462015-04-01 17:18:45 +0300333 xhci_inval_cache((uintptr_t)out_ctx->bytes, out_ctx->size);
Vivek Gautam4912dcc2013-09-14 14:02:45 +0530334
335 /* slot context */
336 xhci_slot_copy(ctrl, in_ctx, out_ctx);
337 slot_ctx = xhci_get_slot_ctx(ctrl, in_ctx);
338 slot_ctx->dev_info &= ~(LAST_CTX_MASK);
339 slot_ctx->dev_info |= cpu_to_le32(LAST_CTX(max_ep_flag + 1) | 0);
340
341 xhci_endpoint_copy(ctrl, in_ctx, out_ctx, 0);
342
343 /* filling up ep contexts */
344 for (cur_ep = 0; cur_ep < num_of_ep; cur_ep++) {
345 struct usb_endpoint_descriptor *endpt_desc = NULL;
346
347 endpt_desc = &ifdesc->ep_desc[cur_ep];
348 trb_64 = 0;
349
350 ep_index = xhci_get_ep_index(endpt_desc);
351 ep_ctx[ep_index] = xhci_get_ep_ctx(ctrl, in_ctx, ep_index);
352
353 /* Allocate the ep rings */
354 virt_dev->eps[ep_index].ring = xhci_ring_alloc(1, true);
355 if (!virt_dev->eps[ep_index].ring)
356 return -ENOMEM;
357
358 /*NOTE: ep_desc[0] actually represents EP1 and so on */
359 dir = (((endpt_desc->bEndpointAddress) & (0x80)) >> 7);
360 ep_type = (((endpt_desc->bmAttributes) & (0x3)) | (dir << 2));
361 ep_ctx[ep_index]->ep_info2 =
362 cpu_to_le32(ep_type << EP_TYPE_SHIFT);
363 ep_ctx[ep_index]->ep_info2 |=
364 cpu_to_le32(MAX_PACKET
365 (get_unaligned(&endpt_desc->wMaxPacketSize)));
366
367 ep_ctx[ep_index]->ep_info2 |=
368 cpu_to_le32(((0 & MAX_BURST_MASK) << MAX_BURST_SHIFT) |
369 ((3 & ERROR_COUNT_MASK) << ERROR_COUNT_SHIFT));
370
371 trb_64 = (uintptr_t)
372 virt_dev->eps[ep_index].ring->enqueue;
373 ep_ctx[ep_index]->deq = cpu_to_le64(trb_64 |
374 virt_dev->eps[ep_index].ring->cycle_state);
375 }
376
377 return xhci_configure_endpoints(udev, false);
378}
379
380/**
381 * Issue an Address Device command (which will issue a SetAddress request to
382 * the device).
383 *
384 * @param udev pointer to the Device Data Structure
385 * @return 0 if successful else error code on failure
386 */
Simon Glass4ec422c2015-03-25 12:22:51 -0600387static int xhci_address_device(struct usb_device *udev, int root_portnr)
Vivek Gautam4912dcc2013-09-14 14:02:45 +0530388{
389 int ret = 0;
Simon Glassa49e27b2015-03-25 12:22:49 -0600390 struct xhci_ctrl *ctrl = xhci_get_ctrl(udev);
Vivek Gautam4912dcc2013-09-14 14:02:45 +0530391 struct xhci_slot_ctx *slot_ctx;
392 struct xhci_input_control_ctx *ctrl_ctx;
393 struct xhci_virt_device *virt_dev;
394 int slot_id = udev->slot_id;
395 union xhci_trb *event;
396
397 virt_dev = ctrl->devs[slot_id];
398
399 /*
400 * This is the first Set Address since device plug-in
401 * so setting up the slot context.
402 */
Simon Glass4ec422c2015-03-25 12:22:51 -0600403 debug("Setting up addressable devices %p\n", ctrl->dcbaa);
404 xhci_setup_addressable_virt_dev(ctrl, udev->slot_id, udev->speed,
405 root_portnr);
Vivek Gautam4912dcc2013-09-14 14:02:45 +0530406
407 ctrl_ctx = xhci_get_input_control_ctx(virt_dev->in_ctx);
408 ctrl_ctx->add_flags = cpu_to_le32(SLOT_FLAG | EP0_FLAG);
409 ctrl_ctx->drop_flags = 0;
410
411 xhci_queue_command(ctrl, (void *)ctrl_ctx, slot_id, 0, TRB_ADDR_DEV);
412 event = xhci_wait_for_event(ctrl, TRB_COMPLETION);
413 BUG_ON(TRB_TO_SLOT_ID(le32_to_cpu(event->event_cmd.flags)) != slot_id);
414
415 switch (GET_COMP_CODE(le32_to_cpu(event->event_cmd.status))) {
416 case COMP_CTX_STATE:
417 case COMP_EBADSLT:
418 printf("Setup ERROR: address device command for slot %d.\n",
419 slot_id);
420 ret = -EINVAL;
421 break;
422 case COMP_TX_ERR:
423 puts("Device not responding to set address.\n");
424 ret = -EPROTO;
425 break;
426 case COMP_DEV_ERR:
427 puts("ERROR: Incompatible device"
428 "for address device command.\n");
429 ret = -ENODEV;
430 break;
431 case COMP_SUCCESS:
432 debug("Successful Address Device command\n");
433 udev->status = 0;
434 break;
435 default:
436 printf("ERROR: unexpected command completion code 0x%x.\n",
437 GET_COMP_CODE(le32_to_cpu(event->event_cmd.status)));
438 ret = -EINVAL;
439 break;
440 }
441
442 xhci_acknowledge_event(ctrl);
443
444 if (ret < 0)
445 /*
446 * TODO: Unsuccessful Address Device command shall leave the
447 * slot in default state. So, issue Disable Slot command now.
448 */
449 return ret;
450
Sergey Temerkhanov38593462015-04-01 17:18:45 +0300451 xhci_inval_cache((uintptr_t)virt_dev->out_ctx->bytes,
452 virt_dev->out_ctx->size);
Vivek Gautam4912dcc2013-09-14 14:02:45 +0530453 slot_ctx = xhci_get_slot_ctx(ctrl, virt_dev->out_ctx);
454
455 debug("xHC internal address is: %d\n",
456 le32_to_cpu(slot_ctx->dev_state) & DEV_ADDR_MASK);
457
458 return 0;
459}
460
461/**
462 * Issue Enable slot command to the controller to allocate
463 * device slot and assign the slot id. It fails if the xHC
464 * ran out of device slots, the Enable Slot command timed out,
465 * or allocating memory failed.
466 *
467 * @param udev pointer to the Device Data Structure
468 * @return Returns 0 on succes else return error code on failure
469 */
470int usb_alloc_device(struct usb_device *udev)
471{
Simon Glassa49e27b2015-03-25 12:22:49 -0600472 struct xhci_ctrl *ctrl = xhci_get_ctrl(udev);
Vivek Gautam4912dcc2013-09-14 14:02:45 +0530473 union xhci_trb *event;
Vivek Gautam4912dcc2013-09-14 14:02:45 +0530474 int ret;
475
476 /*
477 * Root hub will be first device to be initailized.
478 * If this device is root-hub, don't do any xHC related
479 * stuff.
480 */
481 if (ctrl->rootdev == 0) {
482 udev->speed = USB_SPEED_SUPER;
483 return 0;
484 }
485
486 xhci_queue_command(ctrl, NULL, 0, 0, TRB_ENABLE_SLOT);
487 event = xhci_wait_for_event(ctrl, TRB_COMPLETION);
488 BUG_ON(GET_COMP_CODE(le32_to_cpu(event->event_cmd.status))
489 != COMP_SUCCESS);
490
491 udev->slot_id = TRB_TO_SLOT_ID(le32_to_cpu(event->event_cmd.flags));
492
493 xhci_acknowledge_event(ctrl);
494
Simon Glass88a37842015-03-25 12:22:50 -0600495 ret = xhci_alloc_virt_device(ctrl, udev->slot_id);
Vivek Gautam4912dcc2013-09-14 14:02:45 +0530496 if (ret < 0) {
497 /*
498 * TODO: Unsuccessful Address Device command shall leave
499 * the slot in default. So, issue Disable Slot command now.
500 */
501 puts("Could not allocate xHCI USB device data structures\n");
502 return ret;
503 }
504
505 return 0;
506}
507
508/*
509 * Full speed devices may have a max packet size greater than 8 bytes, but the
510 * USB core doesn't know that until it reads the first 8 bytes of the
511 * descriptor. If the usb_device's max packet size changes after that point,
512 * we need to issue an evaluate context command and wait on it.
513 *
514 * @param udev pointer to the Device Data Structure
515 * @return returns the status of the xhci_configure_endpoints
516 */
517int xhci_check_maxpacket(struct usb_device *udev)
518{
Simon Glassa49e27b2015-03-25 12:22:49 -0600519 struct xhci_ctrl *ctrl = xhci_get_ctrl(udev);
Vivek Gautam4912dcc2013-09-14 14:02:45 +0530520 unsigned int slot_id = udev->slot_id;
521 int ep_index = 0; /* control endpoint */
522 struct xhci_container_ctx *in_ctx;
523 struct xhci_container_ctx *out_ctx;
524 struct xhci_input_control_ctx *ctrl_ctx;
525 struct xhci_ep_ctx *ep_ctx;
526 int max_packet_size;
527 int hw_max_packet_size;
528 int ret = 0;
529 struct usb_interface *ifdesc;
530
531 ifdesc = &udev->config.if_desc[0];
532
533 out_ctx = ctrl->devs[slot_id]->out_ctx;
Sergey Temerkhanov38593462015-04-01 17:18:45 +0300534 xhci_inval_cache((uintptr_t)out_ctx->bytes, out_ctx->size);
Vivek Gautam4912dcc2013-09-14 14:02:45 +0530535
536 ep_ctx = xhci_get_ep_ctx(ctrl, out_ctx, ep_index);
537 hw_max_packet_size = MAX_PACKET_DECODED(le32_to_cpu(ep_ctx->ep_info2));
538 max_packet_size = usb_endpoint_maxp(&ifdesc->ep_desc[0]);
539 if (hw_max_packet_size != max_packet_size) {
540 debug("Max Packet Size for ep 0 changed.\n");
541 debug("Max packet size in usb_device = %d\n", max_packet_size);
542 debug("Max packet size in xHCI HW = %d\n", hw_max_packet_size);
543 debug("Issuing evaluate context command.\n");
544
545 /* Set up the modified control endpoint 0 */
546 xhci_endpoint_copy(ctrl, ctrl->devs[slot_id]->in_ctx,
547 ctrl->devs[slot_id]->out_ctx, ep_index);
548 in_ctx = ctrl->devs[slot_id]->in_ctx;
549 ep_ctx = xhci_get_ep_ctx(ctrl, in_ctx, ep_index);
550 ep_ctx->ep_info2 &= cpu_to_le32(~MAX_PACKET_MASK);
551 ep_ctx->ep_info2 |= cpu_to_le32(MAX_PACKET(max_packet_size));
552
553 /*
554 * Set up the input context flags for the command
555 * FIXME: This won't work if a non-default control endpoint
556 * changes max packet sizes.
557 */
558 ctrl_ctx = xhci_get_input_control_ctx(in_ctx);
559 ctrl_ctx->add_flags = cpu_to_le32(EP0_FLAG);
560 ctrl_ctx->drop_flags = 0;
561
562 ret = xhci_configure_endpoints(udev, true);
563 }
564 return ret;
565}
566
567/**
568 * Clears the Change bits of the Port Status Register
569 *
570 * @param wValue request value
571 * @param wIndex request index
572 * @param addr address of posrt status register
573 * @param port_status state of port status register
574 * @return none
575 */
576static void xhci_clear_port_change_bit(u16 wValue,
577 u16 wIndex, volatile uint32_t *addr, u32 port_status)
578{
579 char *port_change_bit;
580 u32 status;
581
582 switch (wValue) {
583 case USB_PORT_FEAT_C_RESET:
584 status = PORT_RC;
585 port_change_bit = "reset";
586 break;
587 case USB_PORT_FEAT_C_CONNECTION:
588 status = PORT_CSC;
589 port_change_bit = "connect";
590 break;
591 case USB_PORT_FEAT_C_OVER_CURRENT:
592 status = PORT_OCC;
593 port_change_bit = "over-current";
594 break;
595 case USB_PORT_FEAT_C_ENABLE:
596 status = PORT_PEC;
597 port_change_bit = "enable/disable";
598 break;
599 case USB_PORT_FEAT_C_SUSPEND:
600 status = PORT_PLC;
601 port_change_bit = "suspend/resume";
602 break;
603 default:
604 /* Should never happen */
605 return;
606 }
607
608 /* Change bits are all write 1 to clear */
609 xhci_writel(addr, port_status | status);
610
611 port_status = xhci_readl(addr);
612 debug("clear port %s change, actual port %d status = 0x%x\n",
613 port_change_bit, wIndex, port_status);
614}
615
616/**
617 * Save Read Only (RO) bits and save read/write bits where
618 * writing a 0 clears the bit and writing a 1 sets the bit (RWS).
619 * For all other types (RW1S, RW1CS, RW, and RZ), writing a '0' has no effect.
620 *
621 * @param state state of the Port Status and Control Regsiter
622 * @return a value that would result in the port being in the
623 * same state, if the value was written to the port
624 * status control register.
625 */
626static u32 xhci_port_state_to_neutral(u32 state)
627{
628 /* Save read-only status and port state */
629 return (state & XHCI_PORT_RO) | (state & XHCI_PORT_RWS);
630}
631
632/**
633 * Submits the Requests to the XHCI Host Controller
634 *
635 * @param udev pointer to the USB device structure
636 * @param pipe contains the DIR_IN or OUT , devnum
637 * @param buffer buffer to be read/written based on the request
638 * @return returns 0 if successful else -1 on failure
639 */
640static int xhci_submit_root(struct usb_device *udev, unsigned long pipe,
641 void *buffer, struct devrequest *req)
642{
643 uint8_t tmpbuf[4];
644 u16 typeReq;
645 void *srcptr = NULL;
646 int len, srclen;
647 uint32_t reg;
648 volatile uint32_t *status_reg;
Simon Glassa49e27b2015-03-25 12:22:49 -0600649 struct xhci_ctrl *ctrl = xhci_get_ctrl(udev);
Vivek Gautam4912dcc2013-09-14 14:02:45 +0530650 struct xhci_hcor *hcor = ctrl->hcor;
651
Jeroen Hofsteeb351e462014-06-12 00:31:27 +0200652 if ((req->requesttype & USB_RT_PORT) &&
653 le16_to_cpu(req->index) > CONFIG_SYS_USB_XHCI_MAX_ROOT_PORTS) {
Vivek Gautam4912dcc2013-09-14 14:02:45 +0530654 printf("The request port(%d) is not configured\n",
655 le16_to_cpu(req->index) - 1);
656 return -EINVAL;
657 }
658
659 status_reg = (volatile uint32_t *)
660 (&hcor->portregs[le16_to_cpu(req->index) - 1].or_portsc);
661 srclen = 0;
662
663 typeReq = req->request | req->requesttype << 8;
664
665 switch (typeReq) {
666 case DeviceRequest | USB_REQ_GET_DESCRIPTOR:
667 switch (le16_to_cpu(req->value) >> 8) {
668 case USB_DT_DEVICE:
669 debug("USB_DT_DEVICE request\n");
670 srcptr = &descriptor.device;
671 srclen = 0x12;
672 break;
673 case USB_DT_CONFIG:
674 debug("USB_DT_CONFIG config\n");
675 srcptr = &descriptor.config;
676 srclen = 0x19;
677 break;
678 case USB_DT_STRING:
679 debug("USB_DT_STRING config\n");
680 switch (le16_to_cpu(req->value) & 0xff) {
681 case 0: /* Language */
682 srcptr = "\4\3\11\4";
683 srclen = 4;
684 break;
685 case 1: /* Vendor String */
686 srcptr = "\16\3u\0-\0b\0o\0o\0t\0";
687 srclen = 14;
688 break;
689 case 2: /* Product Name */
690 srcptr = "\52\3X\0H\0C\0I\0 "
691 "\0H\0o\0s\0t\0 "
692 "\0C\0o\0n\0t\0r\0o\0l\0l\0e\0r\0";
693 srclen = 42;
694 break;
695 default:
696 printf("unknown value DT_STRING %x\n",
697 le16_to_cpu(req->value));
698 goto unknown;
699 }
700 break;
701 default:
702 printf("unknown value %x\n", le16_to_cpu(req->value));
703 goto unknown;
704 }
705 break;
706 case USB_REQ_GET_DESCRIPTOR | ((USB_DIR_IN | USB_RT_HUB) << 8):
707 switch (le16_to_cpu(req->value) >> 8) {
708 case USB_DT_HUB:
709 debug("USB_DT_HUB config\n");
710 srcptr = &descriptor.hub;
711 srclen = 0x8;
712 break;
713 default:
714 printf("unknown value %x\n", le16_to_cpu(req->value));
715 goto unknown;
716 }
717 break;
718 case USB_REQ_SET_ADDRESS | (USB_RECIP_DEVICE << 8):
719 debug("USB_REQ_SET_ADDRESS\n");
720 ctrl->rootdev = le16_to_cpu(req->value);
721 break;
722 case DeviceOutRequest | USB_REQ_SET_CONFIGURATION:
723 /* Do nothing */
724 break;
725 case USB_REQ_GET_STATUS | ((USB_DIR_IN | USB_RT_HUB) << 8):
726 tmpbuf[0] = 1; /* USB_STATUS_SELFPOWERED */
727 tmpbuf[1] = 0;
728 srcptr = tmpbuf;
729 srclen = 2;
730 break;
731 case USB_REQ_GET_STATUS | ((USB_RT_PORT | USB_DIR_IN) << 8):
732 memset(tmpbuf, 0, 4);
733 reg = xhci_readl(status_reg);
734 if (reg & PORT_CONNECT) {
735 tmpbuf[0] |= USB_PORT_STAT_CONNECTION;
736 switch (reg & DEV_SPEED_MASK) {
737 case XDEV_FS:
738 debug("SPEED = FULLSPEED\n");
739 break;
740 case XDEV_LS:
741 debug("SPEED = LOWSPEED\n");
742 tmpbuf[1] |= USB_PORT_STAT_LOW_SPEED >> 8;
743 break;
744 case XDEV_HS:
745 debug("SPEED = HIGHSPEED\n");
746 tmpbuf[1] |= USB_PORT_STAT_HIGH_SPEED >> 8;
747 break;
748 case XDEV_SS:
749 debug("SPEED = SUPERSPEED\n");
750 tmpbuf[1] |= USB_PORT_STAT_SUPER_SPEED >> 8;
751 break;
752 }
753 }
754 if (reg & PORT_PE)
755 tmpbuf[0] |= USB_PORT_STAT_ENABLE;
756 if ((reg & PORT_PLS_MASK) == XDEV_U3)
757 tmpbuf[0] |= USB_PORT_STAT_SUSPEND;
758 if (reg & PORT_OC)
759 tmpbuf[0] |= USB_PORT_STAT_OVERCURRENT;
760 if (reg & PORT_RESET)
761 tmpbuf[0] |= USB_PORT_STAT_RESET;
762 if (reg & PORT_POWER)
763 /*
764 * XXX: This Port power bit (for USB 3.0 hub)
765 * we are faking in USB 2.0 hub port status;
766 * since there's a change in bit positions in
767 * two:
768 * USB 2.0 port status PP is at position[8]
769 * USB 3.0 port status PP is at position[9]
770 * So, we are still keeping it at position [8]
771 */
772 tmpbuf[1] |= USB_PORT_STAT_POWER >> 8;
773 if (reg & PORT_CSC)
774 tmpbuf[2] |= USB_PORT_STAT_C_CONNECTION;
775 if (reg & PORT_PEC)
776 tmpbuf[2] |= USB_PORT_STAT_C_ENABLE;
777 if (reg & PORT_OCC)
778 tmpbuf[2] |= USB_PORT_STAT_C_OVERCURRENT;
779 if (reg & PORT_RC)
780 tmpbuf[2] |= USB_PORT_STAT_C_RESET;
781
782 srcptr = tmpbuf;
783 srclen = 4;
784 break;
785 case USB_REQ_SET_FEATURE | ((USB_DIR_OUT | USB_RT_PORT) << 8):
786 reg = xhci_readl(status_reg);
787 reg = xhci_port_state_to_neutral(reg);
788 switch (le16_to_cpu(req->value)) {
789 case USB_PORT_FEAT_ENABLE:
790 reg |= PORT_PE;
791 xhci_writel(status_reg, reg);
792 break;
793 case USB_PORT_FEAT_POWER:
794 reg |= PORT_POWER;
795 xhci_writel(status_reg, reg);
796 break;
797 case USB_PORT_FEAT_RESET:
798 reg |= PORT_RESET;
799 xhci_writel(status_reg, reg);
800 break;
801 default:
802 printf("unknown feature %x\n", le16_to_cpu(req->value));
803 goto unknown;
804 }
805 break;
806 case USB_REQ_CLEAR_FEATURE | ((USB_DIR_OUT | USB_RT_PORT) << 8):
807 reg = xhci_readl(status_reg);
808 reg = xhci_port_state_to_neutral(reg);
809 switch (le16_to_cpu(req->value)) {
810 case USB_PORT_FEAT_ENABLE:
811 reg &= ~PORT_PE;
812 break;
813 case USB_PORT_FEAT_POWER:
814 reg &= ~PORT_POWER;
815 break;
816 case USB_PORT_FEAT_C_RESET:
817 case USB_PORT_FEAT_C_CONNECTION:
818 case USB_PORT_FEAT_C_OVER_CURRENT:
819 case USB_PORT_FEAT_C_ENABLE:
820 xhci_clear_port_change_bit((le16_to_cpu(req->value)),
821 le16_to_cpu(req->index),
822 status_reg, reg);
823 break;
824 default:
825 printf("unknown feature %x\n", le16_to_cpu(req->value));
826 goto unknown;
827 }
828 xhci_writel(status_reg, reg);
829 break;
830 default:
831 puts("Unknown request\n");
832 goto unknown;
833 }
834
835 debug("scrlen = %d\n req->length = %d\n",
836 srclen, le16_to_cpu(req->length));
837
Masahiro Yamadadb204642014-11-07 03:03:31 +0900838 len = min(srclen, (int)le16_to_cpu(req->length));
Vivek Gautam4912dcc2013-09-14 14:02:45 +0530839
840 if (srcptr != NULL && len > 0)
841 memcpy(buffer, srcptr, len);
842 else
843 debug("Len is 0\n");
844
845 udev->act_len = len;
846 udev->status = 0;
847
848 return 0;
849
850unknown:
851 udev->act_len = 0;
852 udev->status = USB_ST_STALLED;
853
854 return -ENODEV;
855}
856
857/**
858 * Submits the INT request to XHCI Host cotroller
859 *
860 * @param udev pointer to the USB device
861 * @param pipe contains the DIR_IN or OUT , devnum
862 * @param buffer buffer to be read/written based on the request
863 * @param length length of the buffer
864 * @param interval interval of the interrupt
865 * @return 0
866 */
867int
868submit_int_msg(struct usb_device *udev, unsigned long pipe, void *buffer,
869 int length, int interval)
870{
871 /*
872 * TODO: Not addressing any interrupt type transfer requests
873 * Add support for it later.
874 */
875 return -EINVAL;
876}
877
878/**
879 * submit the BULK type of request to the USB Device
880 *
881 * @param udev pointer to the USB device
882 * @param pipe contains the DIR_IN or OUT , devnum
883 * @param buffer buffer to be read/written based on the request
884 * @param length length of the buffer
885 * @return returns 0 if successful else -1 on failure
886 */
887int
888submit_bulk_msg(struct usb_device *udev, unsigned long pipe, void *buffer,
889 int length)
890{
891 if (usb_pipetype(pipe) != PIPE_BULK) {
892 printf("non-bulk pipe (type=%lu)", usb_pipetype(pipe));
893 return -EINVAL;
894 }
895
896 return xhci_bulk_tx(udev, pipe, length, buffer);
897}
898
899/**
900 * submit the control type of request to the Root hub/Device based on the devnum
901 *
902 * @param udev pointer to the USB device
903 * @param pipe contains the DIR_IN or OUT , devnum
904 * @param buffer buffer to be read/written based on the request
905 * @param length length of the buffer
906 * @param setup Request type
Simon Glass4ec422c2015-03-25 12:22:51 -0600907 * @param root_portnr Root port number that this device is on
Vivek Gautam4912dcc2013-09-14 14:02:45 +0530908 * @return returns 0 if successful else -1 on failure
909 */
Simon Glass4ec422c2015-03-25 12:22:51 -0600910static int _xhci_submit_control_msg(struct usb_device *udev, unsigned long pipe,
911 void *buffer, int length,
912 struct devrequest *setup, int root_portnr)
Vivek Gautam4912dcc2013-09-14 14:02:45 +0530913{
Simon Glassa49e27b2015-03-25 12:22:49 -0600914 struct xhci_ctrl *ctrl = xhci_get_ctrl(udev);
Vivek Gautam4912dcc2013-09-14 14:02:45 +0530915 int ret = 0;
916
917 if (usb_pipetype(pipe) != PIPE_CONTROL) {
918 printf("non-control pipe (type=%lu)", usb_pipetype(pipe));
919 return -EINVAL;
920 }
921
922 if (usb_pipedevice(pipe) == ctrl->rootdev)
923 return xhci_submit_root(udev, pipe, buffer, setup);
924
925 if (setup->request == USB_REQ_SET_ADDRESS)
Simon Glass4ec422c2015-03-25 12:22:51 -0600926 return xhci_address_device(udev, root_portnr);
Vivek Gautam4912dcc2013-09-14 14:02:45 +0530927
928 if (setup->request == USB_REQ_SET_CONFIGURATION) {
929 ret = xhci_set_configuration(udev);
930 if (ret) {
931 puts("Failed to configure xHCI endpoint\n");
932 return ret;
933 }
934 }
935
936 return xhci_ctrl_tx(udev, pipe, setup, length, buffer);
937}
938
Simon Glass686a8122015-03-25 12:22:52 -0600939static int xhci_lowlevel_init(struct xhci_ctrl *ctrl)
Vivek Gautam4912dcc2013-09-14 14:02:45 +0530940{
Simon Glass686a8122015-03-25 12:22:52 -0600941 struct xhci_hccr *hccr;
942 struct xhci_hcor *hcor;
Vivek Gautam4912dcc2013-09-14 14:02:45 +0530943 uint32_t val;
944 uint32_t val2;
945 uint32_t reg;
Vivek Gautam4912dcc2013-09-14 14:02:45 +0530946
Simon Glass686a8122015-03-25 12:22:52 -0600947 hccr = ctrl->hccr;
948 hcor = ctrl->hcor;
Vivek Gautam4912dcc2013-09-14 14:02:45 +0530949 /*
950 * Program the Number of Device Slots Enabled field in the CONFIG
951 * register with the max value of slots the HC can handle.
952 */
953 val = (xhci_readl(&hccr->cr_hcsparams1) & HCS_SLOTS_MASK);
954 val2 = xhci_readl(&hcor->or_config);
955 val |= (val2 & ~HCS_SLOTS_MASK);
956 xhci_writel(&hcor->or_config, val);
957
958 /* initializing xhci data structures */
959 if (xhci_mem_init(ctrl, hccr, hcor) < 0)
960 return -ENOMEM;
961
962 reg = xhci_readl(&hccr->cr_hcsparams1);
963 descriptor.hub.bNbrPorts = ((reg & HCS_MAX_PORTS_MASK) >>
964 HCS_MAX_PORTS_SHIFT);
965 printf("Register %x NbrPorts %d\n", reg, descriptor.hub.bNbrPorts);
966
967 /* Port Indicators */
968 reg = xhci_readl(&hccr->cr_hccparams);
969 if (HCS_INDICATOR(reg))
970 put_unaligned(get_unaligned(&descriptor.hub.wHubCharacteristics)
971 | 0x80, &descriptor.hub.wHubCharacteristics);
972
973 /* Port Power Control */
974 if (HCC_PPC(reg))
975 put_unaligned(get_unaligned(&descriptor.hub.wHubCharacteristics)
976 | 0x01, &descriptor.hub.wHubCharacteristics);
977
978 if (xhci_start(hcor)) {
979 xhci_reset(hcor);
980 return -ENODEV;
981 }
982
983 /* Zero'ing IRQ control register and IRQ pending register */
984 xhci_writel(&ctrl->ir_set->irq_control, 0x0);
985 xhci_writel(&ctrl->ir_set->irq_pending, 0x0);
986
987 reg = HC_VERSION(xhci_readl(&hccr->cr_capbase));
988 printf("USB XHCI %x.%02x\n", reg >> 8, reg & 0xff);
989
Simon Glass686a8122015-03-25 12:22:52 -0600990 return 0;
991}
992
993static int xhci_lowlevel_stop(struct xhci_ctrl *ctrl)
994{
995 u32 temp;
996
997 xhci_reset(ctrl->hcor);
998
999 debug("// Disabling event ring interrupts\n");
1000 temp = xhci_readl(&ctrl->hcor->or_usbsts);
1001 xhci_writel(&ctrl->hcor->or_usbsts, temp & ~STS_EINT);
1002 temp = xhci_readl(&ctrl->ir_set->irq_pending);
1003 xhci_writel(&ctrl->ir_set->irq_pending, ER_IRQ_DISABLE(temp));
Vivek Gautam4912dcc2013-09-14 14:02:45 +05301004
1005 return 0;
1006}
1007
Simon Glass4ec422c2015-03-25 12:22:51 -06001008int submit_control_msg(struct usb_device *udev, unsigned long pipe,
1009 void *buffer, int length, struct devrequest *setup)
1010{
1011 struct usb_device *hop = udev;
1012
1013 if (hop->parent)
1014 while (hop->parent->parent)
1015 hop = hop->parent;
1016
1017 return _xhci_submit_control_msg(udev, pipe, buffer, length, setup,
1018 hop->portnr);
1019}
1020
Vivek Gautam4912dcc2013-09-14 14:02:45 +05301021/**
Simon Glass686a8122015-03-25 12:22:52 -06001022 * Intialises the XHCI host controller
1023 * and allocates the necessary data structures
1024 *
1025 * @param index index to the host controller data structure
1026 * @return pointer to the intialised controller
1027 */
1028int usb_lowlevel_init(int index, enum usb_init_type init, void **controller)
1029{
1030 struct xhci_hccr *hccr;
1031 struct xhci_hcor *hcor;
1032 struct xhci_ctrl *ctrl;
1033 int ret;
1034
1035 if (xhci_hcd_init(index, &hccr, (struct xhci_hcor **)&hcor) != 0)
1036 return -ENODEV;
1037
1038 if (xhci_reset(hcor) != 0)
1039 return -ENODEV;
1040
1041 ctrl = &xhcic[index];
1042
1043 ctrl->hccr = hccr;
1044 ctrl->hcor = hcor;
1045
1046 ret = xhci_lowlevel_init(ctrl);
1047
1048 *controller = &xhcic[index];
1049
1050 return ret;
1051}
1052
1053/**
Vivek Gautam4912dcc2013-09-14 14:02:45 +05301054 * Stops the XHCI host controller
1055 * and cleans up all the related data structures
1056 *
1057 * @param index index to the host controller data structure
1058 * @return none
1059 */
1060int usb_lowlevel_stop(int index)
1061{
1062 struct xhci_ctrl *ctrl = (xhcic + index);
Vivek Gautam4912dcc2013-09-14 14:02:45 +05301063
Simon Glass686a8122015-03-25 12:22:52 -06001064 xhci_lowlevel_stop(ctrl);
Vivek Gautam4912dcc2013-09-14 14:02:45 +05301065 xhci_hcd_stop(index);
Vivek Gautam4912dcc2013-09-14 14:02:45 +05301066 xhci_cleanup(ctrl);
1067
1068 return 0;
1069}