src/lib/usbdebug.c

   1 /*
   2  * This file is part of the coreboot project.
   3  *
   4  * Copyright (C) 2006 Eric Biederman (ebiederm@xmission.com)
   5  *
   6  * This program is free software; you can redistribute it and/or modify
   7  * it under the terms of the GNU General Public License as published by
   8  * the Free Software Foundation; version 2 of the License.
   9  *
  10  * This program is distributed in the hope that it will be useful,
  11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13  * GNU General Public License for more details.
  14  *
  15  * You should have received a copy of the GNU General Public License
  16  * along with this program; if not, write to the Free Software
  17  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA, 02110-1301 USA
  18  */
  19 /*
  20  *      2006.12.10 yhlu moved it to corbeoot and use struct instead
  21  */
  22 #if !defined(__ROMCC__)
  23 #include <console/console.h>
  24 #else
  25 #if CONFIG_CACHE_AS_RAM==0
  26 #define printk(BIOS_DEBUG, fmt, arg...)   do {} while(0)
  27 #endif
  28 #endif
  29
  30 #include <arch/io.h>
  31
  32 #include <usb_ch9.h>
  33 #include <ehci.h>
  34 #include <usbdebug.h>
  35
  36 #define USB_DEBUG_DEVNUM 127
  37
  38 #define DBGP_DATA_TOGGLE        0x8800
  39 #define DBGP_PID_UPDATE(x, tok) \
  40         ((((x) ^ DBGP_DATA_TOGGLE) & 0xffff00) | ((tok) & 0xff))
  41
  42 #define DBGP_LEN_UPDATE(x, len) (((x) & ~0x0f) | ((len) & 0x0f))
  43 /*
  44  * USB Packet IDs (PIDs)
  45  */
  46
  47 /* token */
  48 #define USB_PID_OUT             0xe1
  49 #define USB_PID_IN              0x69
  50 #define USB_PID_SOF             0xa5
  51 #define USB_PID_SETUP           0x2d
  52 /* handshake */
  53 #define USB_PID_ACK             0xd2
  54 #define USB_PID_NAK             0x5a
  55 #define USB_PID_STALL           0x1e
  56 #define USB_PID_NYET            0x96
  57 /* data */
  58 #define USB_PID_DATA0           0xc3
  59 #define USB_PID_DATA1           0x4b
  60 #define USB_PID_DATA2           0x87
  61 #define USB_PID_MDATA           0x0f
  62 /* Special */
  63 #define USB_PID_PREAMBLE        0x3c
  64 #define USB_PID_ERR             0x3c
  65 #define USB_PID_SPLIT           0x78
  66 #define USB_PID_PING            0xb4
  67 #define USB_PID_UNDEF_0         0xf0
  68
  69 #define USB_PID_DATA_TOGGLE     0x88
  70 #define DBGP_CLAIM (DBGP_OWNER | DBGP_ENABLED | DBGP_INUSE)
  71
  72 #define PCI_CAP_ID_EHCI_DEBUG   0xa
  73
  74 #define HUB_ROOT_RESET_TIME     50      /* times are in msec */
  75 #define HUB_SHORT_RESET_TIME    10
  76 #define HUB_LONG_RESET_TIME     200
  77 #define HUB_RESET_TIMEOUT       500
  78
  79 #define DBGP_MAX_PACKET         8
  80
  81 static int dbgp_wait_until_complete(struct ehci_dbg_port *ehci_debug)
  82 {
  83         unsigned ctrl;
  84         int loop = 0x100000;
  85         do {
  86                 ctrl = read32((unsigned long)&ehci_debug->control);
  87                 /* Stop when the transaction is finished */
  88                 if (ctrl & DBGP_DONE)
  89                         break;
  90         } while(--loop>0);
  91
  92         if (!loop) return -1000;
  93
  94         /* Now that we have observed the completed transaction,
  95          * clear the done bit.
  96          */
  97         write32((unsigned long)&ehci_debug->control, ctrl | DBGP_DONE);
  98         return (ctrl & DBGP_ERROR) ? -DBGP_ERRCODE(ctrl) : DBGP_LEN(ctrl);
  99 }
 100
 101 static void dbgp_mdelay(int ms)
 102 {
 103         int i;
 104         while (ms--) {
 105                 for (i = 0; i < 1000; i++)
 106                         inb(0x80);
 107         }
 108 }
 109
 110 static void dbgp_breath(void)
 111 {
 112         /* Sleep to give the debug port a chance to breathe */
 113 }
 114
 115 static int dbgp_wait_until_done(struct ehci_dbg_port *ehci_debug, unsigned ctrl)
 116 {
 117         unsigned pids, lpid;
 118         int ret;
 119
 120         int loop = 3;
 121 retry:
 122         write32((unsigned long)&ehci_debug->control, ctrl | DBGP_GO);
 123         ret = dbgp_wait_until_complete(ehci_debug);
 124         pids = read32((unsigned long)&ehci_debug->pids);
 125         lpid = DBGP_PID_GET(pids);
 126
 127         if (ret < 0)
 128                 return ret;
 129
 130         /* If the port is getting full or it has dropped data
 131          * start pacing ourselves, not necessary but it's friendly.
 132          */
 133         if ((lpid == USB_PID_NAK) || (lpid == USB_PID_NYET))
 134                 dbgp_breath();
 135
 136         /* If I get a NACK reissue the transmission */
 137         if (lpid == USB_PID_NAK) {
 138                 if (--loop > 0) goto retry;
 139         }
 140
 141         return ret;
 142 }
 143
 144 static void dbgp_set_data(struct ehci_dbg_port *ehci_debug, const void *buf, int size)
 145 {
 146         const unsigned char *bytes = buf;
 147         unsigned lo, hi;
 148         int i;
 149         lo = hi = 0;
 150         for (i = 0; i < 4 && i < size; i++)
 151                 lo |= bytes[i] << (8*i);
 152         for (; i < 8 && i < size; i++)
 153                 hi |= bytes[i] << (8*(i - 4));
 154         write32((unsigned long)&ehci_debug->data03, lo);
 155         write32((unsigned long)&ehci_debug->data47, hi);
 156 }
 157
 158 static void dbgp_get_data(struct ehci_dbg_port *ehci_debug, void *buf, int size)
 159 {
 160         unsigned char *bytes = buf;
 161         unsigned lo, hi;
 162         int i;
 163         lo = read32((unsigned long)&ehci_debug->data03);
 164         hi = read32((unsigned long)&ehci_debug->data47);
 165         for (i = 0; i < 4 && i < size; i++)
 166                 bytes[i] = (lo >> (8*i)) & 0xff;
 167         for (; i < 8 && i < size; i++)
 168                 bytes[i] = (hi >> (8*(i - 4))) & 0xff;
 169 }
 170
 171 static int dbgp_bulk_write(struct ehci_dbg_port *ehci_debug, unsigned devnum, unsigned endpoint, const char *bytes, int size)
 172 {
 173         unsigned pids, addr, ctrl;
 174         int ret;
 175         if (size > DBGP_MAX_PACKET)
 176                 return -1;
 177
 178         addr = DBGP_EPADDR(devnum, endpoint);
 179
 180         pids = read32((unsigned long)&ehci_debug->pids);
 181         pids = DBGP_PID_UPDATE(pids, USB_PID_OUT);
 182
 183         ctrl = read32((unsigned long)&ehci_debug->control);
 184         ctrl = DBGP_LEN_UPDATE(ctrl, size);
 185         ctrl |= DBGP_OUT;
 186         ctrl |= DBGP_GO;
 187
 188         dbgp_set_data(ehci_debug, bytes, size);
 189         write32((unsigned long)&ehci_debug->address, addr);
 190         write32((unsigned long)&ehci_debug->pids, pids);
 191
 192         ret = dbgp_wait_until_done(ehci_debug, ctrl);
 193         if (ret < 0) {
 194                 return ret;
 195         }
 196         return ret;
 197 }
 198
 199 int dbgp_bulk_write_x(struct ehci_debug_info *dbg_info, const char *bytes, int size)
 200 {
 201         return dbgp_bulk_write(dbg_info->ehci_debug, dbg_info->devnum, dbg_info->endpoint_out, bytes, size);
 202 }
 203
 204 static int dbgp_bulk_read(struct ehci_dbg_port *ehci_debug, unsigned devnum, unsigned endpoint, void *data, int size)
 205 {
 206         unsigned pids, addr, ctrl;
 207         int ret;
 208
 209         if (size > DBGP_MAX_PACKET)
 210                 return -1;
 211
 212         addr = DBGP_EPADDR(devnum, endpoint);
 213
 214         pids = read32((unsigned long)&ehci_debug->pids);
 215         pids = DBGP_PID_UPDATE(pids, USB_PID_IN);
 216
 217         ctrl = read32((unsigned long)&ehci_debug->control);
 218         ctrl = DBGP_LEN_UPDATE(ctrl, size);
 219         ctrl &= ~DBGP_OUT;
 220         ctrl |= DBGP_GO;
 221
 222         write32((unsigned long)&ehci_debug->address, addr);
 223         write32((unsigned long)&ehci_debug->pids, pids);
 224         ret = dbgp_wait_until_done(ehci_debug, ctrl);
 225         if (ret < 0)
 226                 return ret;
 227         if (size > ret)
 228                 size = ret;
 229         dbgp_get_data(ehci_debug, data, size);
 230         return ret;
 231 }
 232 int dbgp_bulk_read_x(struct ehci_debug_info *dbg_info, void *data, int size)
 233 {
 234         return dbgp_bulk_read(dbg_info->ehci_debug, dbg_info->devnum, dbg_info->endpoint_in, data, size);
 235 }
 236
 237 int dbgp_control_msg(struct ehci_dbg_port *ehci_debug, unsigned devnum, int requesttype, int request,
 238         int value, int index, void *data, int size)
 239 {
 240         unsigned pids, addr, ctrl;
 241         struct usb_ctrlrequest req;
 242         int read;
 243         int ret;
 244
 245         read = (requesttype & USB_DIR_IN) != 0;
 246         if (size > (read?DBGP_MAX_PACKET:0))
 247                 return -1;
 248
 249         /* Compute the control message */
 250         req.bRequestType = requesttype;
 251         req.bRequest = request;
 252         req.wValue = value;
 253         req.wIndex = index;
 254         req.wLength = size;
 255
 256         pids = DBGP_PID_SET(USB_PID_DATA0, USB_PID_SETUP);
 257         addr = DBGP_EPADDR(devnum, 0);
 258
 259         ctrl = read32((unsigned long)&ehci_debug->control);
 260         ctrl = DBGP_LEN_UPDATE(ctrl, sizeof(req));
 261         ctrl |= DBGP_OUT;
 262         ctrl |= DBGP_GO;
 263
 264         /* Send the setup message */
 265         dbgp_set_data(ehci_debug, &req, sizeof(req));
 266         write32((unsigned long)&ehci_debug->address, addr);
 267         write32((unsigned long)&ehci_debug->pids, pids);
 268         ret = dbgp_wait_until_done(ehci_debug, ctrl);
 269         if (ret < 0)
 270                 return ret;
 271
 272
 273         /* Read the result */
 274         ret = dbgp_bulk_read(ehci_debug, devnum, 0, data, size);
 275         return ret;
 276 }
 277
 278 static int ehci_reset_port(struct ehci_regs *ehci_regs, int port)
 279 {
 280         unsigned portsc;
 281         unsigned delay_time, delay_ms;
 282         int loop;
 283
 284         /* Reset the usb debug port */
 285         portsc = read32((unsigned long)&ehci_regs->port_status[port - 1]);
 286         portsc &= ~PORT_PE;
 287         portsc |= PORT_RESET;
 288         write32((unsigned long)&ehci_regs->port_status[port - 1], portsc);
 289
 290         delay_ms = HUB_ROOT_RESET_TIME;
 291         for (delay_time = 0; delay_time < HUB_RESET_TIMEOUT;
 292              delay_time += delay_ms) {
 293                 dbgp_mdelay(delay_ms);
 294
 295                 portsc = read32((unsigned long)&ehci_regs->port_status[port - 1]);
 296                 if (portsc & PORT_RESET) {
 297                         /* force reset to complete */
 298                         loop = 2;
 299                         write32((unsigned long)&ehci_regs->port_status[port - 1],
 300                                         portsc & ~(PORT_RWC_BITS | PORT_RESET));
 301                         do {
 302                                 dbgp_mdelay(delay_ms);
 303                                 portsc = read32((unsigned long)&ehci_regs->port_status[port - 1]);
 304                                 delay_time += delay_ms;
 305                         } while ((portsc & PORT_RESET) && (--loop > 0));
 306                         if (!loop) {
 307                                 printk(BIOS_DEBUG, "ehci_reset_port forced done");
 308                         }
 309                 }
 310
 311                 /* Device went away? */
 312                 if (!(portsc & PORT_CONNECT))
 313                         return -107;//-ENOTCONN;
 314
 315                 /* bomb out completely if something weird happend */
 316                 if ((portsc & PORT_CSC))
 317                         return -22;//-EINVAL;
 318
 319                 /* If we've finished resetting, then break out of the loop */
 320                 if (!(portsc & PORT_RESET) && (portsc & PORT_PE))
 321                         return 0;
 322         }
 323         return -16;//-EBUSY;
 324 }
 325
 326 int ehci_wait_for_port(struct ehci_regs *ehci_regs, int port)
 327 {
 328         unsigned status;
 329         int ret, reps;
 330         for (reps = 0; reps < 3; reps++) {
 331                 dbgp_mdelay(100);
 332                 status = read32((unsigned long)&ehci_regs->status);
 333                 if (status & STS_PCD) {
 334                         ret = ehci_reset_port(ehci_regs, port);
 335                         if (ret == 0)
 336                                 return 0;
 337                 }
 338         }
 339         return -107; //-ENOTCONN;
 340 }
 341
 342
 343 #define DBGP_DEBUG 1
 344 #if DBGP_DEBUG
 345 # define dbgp_printk(fmt_arg...) printk(BIOS_DEBUG, fmt_arg)
 346 #else
 347 #define dbgp_printk(fmt_arg...)   do {} while(0)
 348 #endif
 349
 350 #ifdef __PRE_RAM__
 351 static void usbdebug_init(unsigned ehci_bar, unsigned offset, struct ehci_debug_info *info)
 352 {
 353         struct ehci_caps *ehci_caps;
 354         struct ehci_regs *ehci_regs;
 355         struct ehci_dbg_port *ehci_debug;
 356         unsigned dbgp_endpoint_out;
 357         unsigned dbgp_endpoint_in;
 358         struct usb_debug_descriptor dbgp_desc;
 359         unsigned ctrl, devnum;
 360         int ret;
 361         int loop;
 362
 363         unsigned cmd,  status, portsc, hcs_params, debug_port, n_ports, new_debug_port;
 364         int i;
 365         unsigned port_map_tried;
 366
 367         unsigned playtimes = 3;
 368
 369         ehci_caps  = (struct ehci_caps *)ehci_bar;
 370         ehci_regs  = (struct ehci_regs *)(ehci_bar + HC_LENGTH(read32((unsigned long)&ehci_caps->hc_capbase)));
 371         ehci_debug = (struct ehci_dbg_port *)(ehci_bar + offset);
 372
 373         info->ehci_debug = (void *)0;
 374
 375         new_debug_port = 0;
 376
 377 try_next_time:
 378         port_map_tried = 0;
 379
 380 try_next_port:
 381         hcs_params = read32((unsigned long)&ehci_caps->hcs_params);
 382         debug_port = HCS_DEBUG_PORT(hcs_params);
 383         n_ports    = HCS_N_PORTS(hcs_params);
 384
 385         dbgp_printk("ehci_bar: 0x%x\n", ehci_bar);
 386         dbgp_printk("debug_port: %d\n", debug_port);
 387         dbgp_printk("n_ports:    %d\n", n_ports);
 388
 389 #if 1
 390         for (i = 1; i <= n_ports; i++) {
 391                 portsc = read32((unsigned long)&ehci_regs->port_status[i-1]);
 392                 dbgp_printk("PORTSC #%d: %08x\n", i, portsc);
 393         }
 394 #endif
 395
 396         if(port_map_tried && (new_debug_port!=debug_port)) {
 397                 if(--playtimes) {
 398                         set_debug_port(debug_port);
 399                         goto try_next_time;
 400                 }
 401                 return;
 402         }
 403
 404         /* Reset the EHCI controller */
 405         loop = 10;
 406         cmd = read32((unsigned long)&ehci_regs->command);
 407         cmd |= CMD_RESET;
 408         write32((unsigned long)&ehci_regs->command, cmd);
 409         do {
 410                 cmd = read32((unsigned long)&ehci_regs->command);
 411         } while ((cmd & CMD_RESET) && (--loop > 0));
 412
 413         if(!loop)
 414                 dbgp_printk("Could not reset EHCI controller.\n");
 415         else
 416                 dbgp_printk("EHCI controller reset successfully.\n");
 417
 418         /* Claim ownership, but do not enable yet */
 419         ctrl = read32((unsigned long)&ehci_debug->control);
 420         ctrl |= DBGP_OWNER;
 421         ctrl &= ~(DBGP_ENABLED | DBGP_INUSE);
 422         write32((unsigned long)&ehci_debug->control, ctrl);
 423
 424         /* Start the ehci running */
 425         cmd = read32((unsigned long)&ehci_regs->command);
 426         cmd &= ~(CMD_LRESET | CMD_IAAD | CMD_PSE | CMD_ASE | CMD_RESET);
 427         cmd |= CMD_RUN;
 428         write32((unsigned long)&ehci_regs->command, cmd);
 429
 430         /* Ensure everything is routed to the EHCI */
 431         write32((unsigned long)&ehci_regs->configured_flag, FLAG_CF);
 432
 433         /* Wait until the controller is no longer halted */
 434         loop = 10;
 435         do {
 436                 status = read32((unsigned long)&ehci_regs->status);
 437         } while ((status & STS_HALT) && (--loop>0));
 438
 439         if(!loop) {
 440                 dbgp_printk("EHCI could not be started.\n");
 441                 return;
 442         }
 443         dbgp_printk("EHCI started.\n");
 444
 445         /* Wait for a device to show up in the debug port */
 446         ret = ehci_wait_for_port(ehci_regs, debug_port);
 447         if (ret < 0) {
 448                 dbgp_printk("No device found in debug port %d\n", debug_port);
 449                 goto next_debug_port;
 450         }
 451         dbgp_printk("EHCI done waiting for port.\n");
 452
 453         /* Enable the debug port */
 454         ctrl = read32((unsigned long)&ehci_debug->control);
 455         ctrl |= DBGP_CLAIM;
 456         write32((unsigned long)&ehci_debug->control, ctrl);
 457         ctrl = read32((unsigned long)&ehci_debug->control);
 458         if ((ctrl & DBGP_CLAIM) != DBGP_CLAIM) {
 459                 dbgp_printk("No device in EHCI debug port.\n");
 460                 write32((unsigned long)&ehci_debug->control, ctrl & ~DBGP_CLAIM);
 461                 goto err;
 462         }
 463         dbgp_printk("EHCI debug port enabled.\n");
 464
 465         /* Completely transfer the debug device to the debug controller */
 466         portsc = read32((unsigned long)&ehci_regs->port_status[debug_port - 1]);
 467         portsc &= ~PORT_PE;
 468         write32((unsigned long)&ehci_regs->port_status[debug_port - 1], portsc);
 469
 470         dbgp_mdelay(100);
 471
 472         /* Find the debug device and make it device number 127 */
 473         for (devnum = 0; devnum <= 127; devnum++) {
 474                 ret = dbgp_control_msg(ehci_debug, devnum,
 475                         USB_DIR_IN | USB_TYPE_STANDARD | USB_RECIP_DEVICE,
 476                         USB_REQ_GET_DESCRIPTOR, (USB_DT_DEBUG << 8), 0,
 477                         &dbgp_desc, sizeof(dbgp_desc));
 478                 if (ret > 0)
 479                         break;
 480         }
 481         if (devnum > 127) {
 482                 dbgp_printk("Could not find attached debug device.\n");
 483                 goto err;
 484         }
 485         if (ret < 0) {
 486                 dbgp_printk("Attached device is not a debug device.\n");
 487                 goto err;
 488         }
 489         dbgp_endpoint_out = dbgp_desc.bDebugOutEndpoint;
 490         dbgp_endpoint_in = dbgp_desc.bDebugInEndpoint;
 491
 492         /* Move the device to 127 if it isn't already there */
 493         if (devnum != USB_DEBUG_DEVNUM) {
 494                 ret = dbgp_control_msg(ehci_debug, devnum,
 495                         USB_DIR_OUT | USB_TYPE_STANDARD | USB_RECIP_DEVICE,
 496                         USB_REQ_SET_ADDRESS, USB_DEBUG_DEVNUM, 0, (void *)0, 0);
 497                 if (ret < 0) {
 498                         dbgp_printk("Could not move attached device to %d.\n",
 499                                 USB_DEBUG_DEVNUM);
 500                         goto err;
 501                 }
 502                 devnum = USB_DEBUG_DEVNUM;
 503                 dbgp_printk("EHCI debug device renamed to 127.\n");
 504         }
 505
 506         /* Enable the debug interface */
 507         ret = dbgp_control_msg(ehci_debug, USB_DEBUG_DEVNUM,
 508                 USB_DIR_OUT | USB_TYPE_STANDARD | USB_RECIP_DEVICE,
 509                 USB_REQ_SET_FEATURE, USB_DEVICE_DEBUG_MODE, 0, (void *)0, 0);
 510         if (ret < 0) {
 511                 dbgp_printk("Could not enable EHCI debug device.\n");
 512                 goto err;
 513         }
 514         dbgp_printk("EHCI debug interface enabled.\n");
 515
 516         /* Perform a small write to get the even/odd data state in sync
 517          */
 518         ret = dbgp_bulk_write(ehci_debug, USB_DEBUG_DEVNUM, dbgp_endpoint_out, " ",1);
 519         if (ret < 0) {
 520                 dbgp_printk("dbgp_bulk_write failed: %d\n", ret);
 521                 goto err;
 522         }
 523         dbgp_printk("Test write done\n");
 524
 525         info->ehci_caps = ehci_caps;
 526         info->ehci_regs = ehci_regs;
 527         info->ehci_debug = ehci_debug;
 528         info->devnum = devnum;
 529         info->endpoint_out = dbgp_endpoint_out;
 530         info->endpoint_in = dbgp_endpoint_in;
 531
 532         return;
 533 err:
 534         /* Things didn't work so remove my claim */
 535         ctrl = read32((unsigned long)&ehci_debug->control);
 536         ctrl &= ~(DBGP_CLAIM | DBGP_OUT);
 537         write32((unsigned long)(unsigned long)&ehci_debug->control, ctrl);
 538
 539 next_debug_port:
 540         port_map_tried |= (1<<(debug_port-1));
 541         if(port_map_tried != ((1<<n_ports) -1)) {
 542                 new_debug_port = ((debug_port-1+1)%n_ports) + 1;
 543                 set_debug_port(new_debug_port);
 544                 goto try_next_port;
 545         }
 546         if(--playtimes) {
 547                 set_debug_port(debug_port);
 548                 goto try_next_time;
 549         }
 550
 551 }
 552 #endif
 553
 554