1 /* $NetBSD: pci.c,v 1.119 2008/09/19 14:37:13 joerg Exp $ */ 2 3 /* 4 * Copyright (c) 1995, 1996, 1997, 1998 5 * Christopher G. Demetriou. All rights reserved. 6 * Copyright (c) 1994 Charles M. Hannum. All rights reserved. 7 * 8 * Redistribution and use in source and binary forms, with or without 9 * modification, are permitted provided that the following conditions 10 * are met: 11 * 1. Redistributions of source code must retain the above copyright 12 * notice, this list of conditions and the following disclaimer. 13 * 2. Redistributions in binary form must reproduce the above copyright 14 * notice, this list of conditions and the following disclaimer in the 15 * documentation and/or other materials provided with the distribution. 16 * 3. All advertising materials mentioning features or use of this software 17 * must display the following acknowledgement: 18 * This product includes software developed by Charles M. Hannum. 19 * 4. The name of the author may not be used to endorse or promote products 20 * derived from this software without specific prior written permission. 21 * 22 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 23 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 24 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 25 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 26 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 27 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 28 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 29 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 30 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 31 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 32 */ 33 34 /* 35 * PCI bus autoconfiguration. 36 */ 37 38 #include <sys/cdefs.h> 39 __KERNEL_RCSID(0, "$NetBSD: pci.c,v 1.119 2008/09/19 14:37:13 joerg Exp $"); 40 41 #include "opt_pci.h" 42 43 #include <sys/param.h> 44 #include <sys/malloc.h> 45 #include <sys/systm.h> 46 #include <sys/device.h> 47 48 #include <dev/pci/pcireg.h> 49 #include <dev/pci/pcivar.h> 50 #include <dev/pci/pcidevs.h> 51 52 #include <uvm/uvm_extern.h> 53 54 #include <net/if.h> 55 56 #include "locators.h" 57 58 static bool pci_child_register(device_t); 59 60 #ifdef PCI_CONFIG_DUMP 61 int pci_config_dump = 1; 62 #else 63 int pci_config_dump = 0; 64 #endif 65 66 int pciprint(void *, const char *); 67 68 #ifdef PCI_MACHDEP_ENUMERATE_BUS 69 #define pci_enumerate_bus PCI_MACHDEP_ENUMERATE_BUS 70 #else 71 int pci_enumerate_bus(struct pci_softc *, const int *, 72 int (*)(struct pci_attach_args *), struct pci_attach_args *); 73 #endif 74 75 /* 76 * Important note about PCI-ISA bridges: 77 * 78 * Callbacks are used to configure these devices so that ISA/EISA bridges 79 * can attach their child busses after PCI configuration is done. 80 * 81 * This works because: 82 * (1) there can be at most one ISA/EISA bridge per PCI bus, and 83 * (2) any ISA/EISA bridges must be attached to primary PCI 84 * busses (i.e. bus zero). 85 * 86 * That boils down to: there can only be one of these outstanding 87 * at a time, it is cleared when configuring PCI bus 0 before any 88 * subdevices have been found, and it is run after all subdevices 89 * of PCI bus 0 have been found. 90 * 91 * This is needed because there are some (legacy) PCI devices which 92 * can show up as ISA/EISA devices as well (the prime example of which 93 * are VGA controllers). If you attach ISA from a PCI-ISA/EISA bridge, 94 * and the bridge is seen before the video board is, the board can show 95 * up as an ISA device, and that can (bogusly) complicate the PCI device's 96 * attach code, or make the PCI device not be properly attached at all. 97 * 98 * We use the generic config_defer() facility to achieve this. 99 */ 100 101 int 102 pcirescan(device_t self, const char *ifattr, const int *locators) 103 { 104 struct pci_softc *sc = device_private(self); 105 106 KASSERT(ifattr && !strcmp(ifattr, "pci")); 107 KASSERT(locators); 108 109 pci_enumerate_bus(sc, locators, NULL, NULL); 110 return 0; 111 } 112 113 int 114 pcimatch(device_t parent, cfdata_t cf, void *aux) 115 { 116 struct pcibus_attach_args *pba = aux; 117 118 /* Check the locators */ 119 if (cf->cf_loc[PCIBUSCF_BUS] != PCIBUSCF_BUS_DEFAULT && 120 cf->cf_loc[PCIBUSCF_BUS] != pba->pba_bus) 121 return (0); 122 123 /* sanity */ 124 if (pba->pba_bus < 0 || pba->pba_bus > 255) 125 return (0); 126 127 /* 128 * XXX check other (hardware?) indicators 129 */ 130 131 return (1); 132 } 133 134 void 135 pciattach(device_t parent, device_t self, void *aux) 136 { 137 struct pcibus_attach_args *pba = aux; 138 struct pci_softc *sc = device_private(self); 139 int io_enabled, mem_enabled, mrl_enabled, mrm_enabled, mwi_enabled; 140 const char *sep = ""; 141 static const int wildcard[PCICF_NLOCS] = { 142 PCICF_DEV_DEFAULT, PCICF_FUNCTION_DEFAULT 143 }; 144 145 sc->sc_dev = self; 146 147 pci_attach_hook(parent, self, pba); 148 149 aprint_naive("\n"); 150 aprint_normal("\n"); 151 152 io_enabled = (pba->pba_flags & PCI_FLAGS_IO_ENABLED); 153 mem_enabled = (pba->pba_flags & PCI_FLAGS_MEM_ENABLED); 154 mrl_enabled = (pba->pba_flags & PCI_FLAGS_MRL_OKAY); 155 mrm_enabled = (pba->pba_flags & PCI_FLAGS_MRM_OKAY); 156 mwi_enabled = (pba->pba_flags & PCI_FLAGS_MWI_OKAY); 157 158 if (io_enabled == 0 && mem_enabled == 0) { 159 aprint_error_dev(self, "no spaces enabled!\n"); 160 goto fail; 161 } 162 163 #define PRINT(str) \ 164 do { \ 165 aprint_verbose("%s%s", sep, str); \ 166 sep = ", "; \ 167 } while (/*CONSTCOND*/0) 168 169 aprint_verbose_dev(self, ""); 170 171 if (io_enabled) 172 PRINT("i/o space"); 173 if (mem_enabled) 174 PRINT("memory space"); 175 aprint_verbose(" enabled"); 176 177 if (mrl_enabled || mrm_enabled || mwi_enabled) { 178 if (mrl_enabled) 179 PRINT("rd/line"); 180 if (mrm_enabled) 181 PRINT("rd/mult"); 182 if (mwi_enabled) 183 PRINT("wr/inv"); 184 aprint_verbose(" ok"); 185 } 186 187 aprint_verbose("\n"); 188 189 #undef PRINT 190 191 sc->sc_iot = pba->pba_iot; 192 sc->sc_memt = pba->pba_memt; 193 sc->sc_dmat = pba->pba_dmat; 194 sc->sc_dmat64 = pba->pba_dmat64; 195 sc->sc_pc = pba->pba_pc; 196 sc->sc_bus = pba->pba_bus; 197 sc->sc_bridgetag = pba->pba_bridgetag; 198 sc->sc_maxndevs = pci_bus_maxdevs(pba->pba_pc, pba->pba_bus); 199 sc->sc_intrswiz = pba->pba_intrswiz; 200 sc->sc_intrtag = pba->pba_intrtag; 201 sc->sc_flags = pba->pba_flags; 202 203 device_pmf_driver_set_child_register(sc->sc_dev, pci_child_register); 204 205 pcirescan(sc->sc_dev, "pci", wildcard); 206 207 fail: 208 if (!pmf_device_register(self, NULL, NULL)) 209 aprint_error_dev(self, "couldn't establish power handler\n"); 210 } 211 212 int 213 pcidetach(device_t self, int flags) 214 { 215 int rc; 216 217 if ((rc = config_detach_children(self, flags)) != 0) 218 return rc; 219 pmf_device_deregister(self); 220 return 0; 221 } 222 223 int 224 pciprint(void *aux, const char *pnp) 225 { 226 struct pci_attach_args *pa = aux; 227 char devinfo[256]; 228 const struct pci_quirkdata *qd; 229 230 if (pnp) { 231 pci_devinfo(pa->pa_id, pa->pa_class, 1, devinfo, sizeof(devinfo)); 232 aprint_normal("%s at %s", devinfo, pnp); 233 } 234 aprint_normal(" dev %d function %d", pa->pa_device, pa->pa_function); 235 if (pci_config_dump) { 236 printf(": "); 237 pci_conf_print(pa->pa_pc, pa->pa_tag, NULL); 238 if (!pnp) 239 pci_devinfo(pa->pa_id, pa->pa_class, 1, devinfo, sizeof(devinfo)); 240 printf("%s at %s", devinfo, pnp ? pnp : "?"); 241 printf(" dev %d function %d (", pa->pa_device, pa->pa_function); 242 #ifdef __i386__ 243 printf("tag %#lx, intrtag %#lx, intrswiz %#lx, intrpin %#lx", 244 *(long *)&pa->pa_tag, *(long *)&pa->pa_intrtag, 245 (long)pa->pa_intrswiz, (long)pa->pa_intrpin); 246 #else 247 printf("intrswiz %#lx, intrpin %#lx", 248 (long)pa->pa_intrswiz, (long)pa->pa_intrpin); 249 #endif 250 printf(", i/o %s, mem %s,", 251 pa->pa_flags & PCI_FLAGS_IO_ENABLED ? "on" : "off", 252 pa->pa_flags & PCI_FLAGS_MEM_ENABLED ? "on" : "off"); 253 qd = pci_lookup_quirkdata(PCI_VENDOR(pa->pa_id), 254 PCI_PRODUCT(pa->pa_id)); 255 if (qd == NULL) { 256 printf(" no quirks"); 257 } else { 258 bitmask_snprintf(qd->quirks, 259 "\002\001multifn\002singlefn\003skipfunc0" 260 "\004skipfunc1\005skipfunc2\006skipfunc3" 261 "\007skipfunc4\010skipfunc5\011skipfunc6" 262 "\012skipfunc7", 263 devinfo, sizeof (devinfo)); 264 printf(" quirks %s", devinfo); 265 } 266 printf(")"); 267 } 268 return (UNCONF); 269 } 270 271 int 272 pci_probe_device(struct pci_softc *sc, pcitag_t tag, 273 int (*match)(struct pci_attach_args *), struct pci_attach_args *pap) 274 { 275 pci_chipset_tag_t pc = sc->sc_pc; 276 struct pci_attach_args pa; 277 pcireg_t id, csr, class, intr, bhlcr; 278 int ret, pin, bus, device, function; 279 int locs[PCICF_NLOCS]; 280 device_t subdev; 281 282 pci_decompose_tag(pc, tag, &bus, &device, &function); 283 284 /* a driver already attached? */ 285 if (sc->PCI_SC_DEVICESC(device, function).c_dev != NULL && !match) 286 return (0); 287 288 bhlcr = pci_conf_read(pc, tag, PCI_BHLC_REG); 289 if (PCI_HDRTYPE_TYPE(bhlcr) > 2) 290 return (0); 291 292 id = pci_conf_read(pc, tag, PCI_ID_REG); 293 csr = pci_conf_read(pc, tag, PCI_COMMAND_STATUS_REG); 294 class = pci_conf_read(pc, tag, PCI_CLASS_REG); 295 296 /* Invalid vendor ID value? */ 297 if (PCI_VENDOR(id) == PCI_VENDOR_INVALID) 298 return (0); 299 /* XXX Not invalid, but we've done this ~forever. */ 300 if (PCI_VENDOR(id) == 0) 301 return (0); 302 303 pa.pa_iot = sc->sc_iot; 304 pa.pa_memt = sc->sc_memt; 305 pa.pa_dmat = sc->sc_dmat; 306 pa.pa_dmat64 = sc->sc_dmat64; 307 pa.pa_pc = pc; 308 pa.pa_bus = bus; 309 pa.pa_device = device; 310 pa.pa_function = function; 311 pa.pa_tag = tag; 312 pa.pa_id = id; 313 pa.pa_class = class; 314 315 /* 316 * Set up memory, I/O enable, and PCI command flags 317 * as appropriate. 318 */ 319 pa.pa_flags = sc->sc_flags; 320 if ((csr & PCI_COMMAND_IO_ENABLE) == 0) 321 pa.pa_flags &= ~PCI_FLAGS_IO_ENABLED; 322 if ((csr & PCI_COMMAND_MEM_ENABLE) == 0) 323 pa.pa_flags &= ~PCI_FLAGS_MEM_ENABLED; 324 325 /* 326 * If the cache line size is not configured, then 327 * clear the MRL/MRM/MWI command-ok flags. 328 */ 329 if (PCI_CACHELINE(bhlcr) == 0) 330 pa.pa_flags &= ~(PCI_FLAGS_MRL_OKAY| 331 PCI_FLAGS_MRM_OKAY|PCI_FLAGS_MWI_OKAY); 332 333 if (sc->sc_bridgetag == NULL) { 334 pa.pa_intrswiz = 0; 335 pa.pa_intrtag = tag; 336 } else { 337 pa.pa_intrswiz = sc->sc_intrswiz + device; 338 pa.pa_intrtag = sc->sc_intrtag; 339 } 340 341 intr = pci_conf_read(pc, tag, PCI_INTERRUPT_REG); 342 343 pin = PCI_INTERRUPT_PIN(intr); 344 pa.pa_rawintrpin = pin; 345 if (pin == PCI_INTERRUPT_PIN_NONE) { 346 /* no interrupt */ 347 pa.pa_intrpin = 0; 348 } else { 349 /* 350 * swizzle it based on the number of busses we're 351 * behind and our device number. 352 */ 353 pa.pa_intrpin = /* XXX */ 354 ((pin + pa.pa_intrswiz - 1) % 4) + 1; 355 } 356 pa.pa_intrline = PCI_INTERRUPT_LINE(intr); 357 358 if (match != NULL) { 359 ret = (*match)(&pa); 360 if (ret != 0 && pap != NULL) 361 *pap = pa; 362 } else { 363 struct pci_child *c; 364 locs[PCICF_DEV] = device; 365 locs[PCICF_FUNCTION] = function; 366 367 subdev = config_found_sm_loc(sc->sc_dev, "pci", locs, &pa, 368 pciprint, config_stdsubmatch); 369 370 c = &sc->PCI_SC_DEVICESC(device, function); 371 c->c_dev = subdev; 372 pci_conf_capture(pc, tag, &c->c_conf); 373 if (pci_get_powerstate(pc, tag, &c->c_powerstate) == 0) 374 c->c_psok = true; 375 else 376 c->c_psok = false; 377 ret = (subdev != NULL); 378 } 379 380 return (ret); 381 } 382 383 void 384 pcidevdetached(device_t self, device_t child) 385 { 386 struct pci_softc *sc = device_private(self); 387 int d, f; 388 pcitag_t tag; 389 struct pci_child *c; 390 391 d = device_locator(child, PCICF_DEV); 392 f = device_locator(child, PCICF_FUNCTION); 393 394 c = &sc->PCI_SC_DEVICESC(d, f); 395 396 KASSERT(c->c_dev == child); 397 398 tag = pci_make_tag(sc->sc_pc, sc->sc_bus, d, f); 399 if (c->c_psok) 400 pci_set_powerstate(sc->sc_pc, tag, c->c_powerstate); 401 pci_conf_restore(sc->sc_pc, tag, &c->c_conf); 402 c->c_dev = NULL; 403 } 404 405 CFATTACH_DECL2_NEW(pci, sizeof(struct pci_softc), 406 pcimatch, pciattach, pcidetach, NULL, pcirescan, pcidevdetached); 407 408 int 409 pci_get_capability(pci_chipset_tag_t pc, pcitag_t tag, int capid, 410 int *offset, pcireg_t *value) 411 { 412 pcireg_t reg; 413 unsigned int ofs; 414 415 reg = pci_conf_read(pc, tag, PCI_COMMAND_STATUS_REG); 416 if (!(reg & PCI_STATUS_CAPLIST_SUPPORT)) 417 return (0); 418 419 /* Determine the Capability List Pointer register to start with. */ 420 reg = pci_conf_read(pc, tag, PCI_BHLC_REG); 421 switch (PCI_HDRTYPE_TYPE(reg)) { 422 case 0: /* standard device header */ 423 case 1: /* PCI-PCI bridge header */ 424 ofs = PCI_CAPLISTPTR_REG; 425 break; 426 case 2: /* PCI-CardBus Bridge header */ 427 ofs = PCI_CARDBUS_CAPLISTPTR_REG; 428 break; 429 default: 430 return (0); 431 } 432 433 ofs = PCI_CAPLIST_PTR(pci_conf_read(pc, tag, ofs)); 434 while (ofs != 0) { 435 if ((ofs & 3) || (ofs < 0x40)) { 436 int bus, device, function; 437 438 pci_decompose_tag(pc, tag, &bus, &device, &function); 439 440 printf("Skipping broken PCI header on %d:%d:%d\n", 441 bus, device, function); 442 break; 443 } 444 reg = pci_conf_read(pc, tag, ofs); 445 if (PCI_CAPLIST_CAP(reg) == capid) { 446 if (offset) 447 *offset = ofs; 448 if (value) 449 *value = reg; 450 return (1); 451 } 452 ofs = PCI_CAPLIST_NEXT(reg); 453 } 454 455 return (0); 456 } 457 458 int 459 pci_find_device(struct pci_attach_args *pa, 460 int (*match)(struct pci_attach_args *)) 461 { 462 extern struct cfdriver pci_cd; 463 device_t pcidev; 464 int i; 465 static const int wildcard[2] = { 466 PCICF_DEV_DEFAULT, 467 PCICF_FUNCTION_DEFAULT 468 }; 469 470 for (i = 0; i < pci_cd.cd_ndevs; i++) { 471 pcidev = device_lookup(&pci_cd, i); 472 if (pcidev != NULL && 473 pci_enumerate_bus(device_private(pcidev), wildcard, 474 match, pa) != 0) 475 return (1); 476 } 477 return (0); 478 } 479 480 #ifndef PCI_MACHDEP_ENUMERATE_BUS 481 /* 482 * Generic PCI bus enumeration routine. Used unless machine-dependent 483 * code needs to provide something else. 484 */ 485 int 486 pci_enumerate_bus(struct pci_softc *sc, const int *locators, 487 int (*match)(struct pci_attach_args *), struct pci_attach_args *pap) 488 { 489 pci_chipset_tag_t pc = sc->sc_pc; 490 int device, function, nfunctions, ret; 491 const struct pci_quirkdata *qd; 492 pcireg_t id, bhlcr; 493 pcitag_t tag; 494 #ifdef __PCI_BUS_DEVORDER 495 char devs[32]; 496 int i; 497 #endif 498 499 #ifdef __PCI_BUS_DEVORDER 500 pci_bus_devorder(sc->sc_pc, sc->sc_bus, devs); 501 for (i = 0; (device = devs[i]) < 32 && device >= 0; i++) 502 #else 503 for (device = 0; device < sc->sc_maxndevs; device++) 504 #endif 505 { 506 if ((locators[PCICF_DEV] != PCICF_DEV_DEFAULT) && 507 (locators[PCICF_DEV] != device)) 508 continue; 509 510 tag = pci_make_tag(pc, sc->sc_bus, device, 0); 511 512 bhlcr = pci_conf_read(pc, tag, PCI_BHLC_REG); 513 if (PCI_HDRTYPE_TYPE(bhlcr) > 2) 514 continue; 515 516 id = pci_conf_read(pc, tag, PCI_ID_REG); 517 518 /* Invalid vendor ID value? */ 519 if (PCI_VENDOR(id) == PCI_VENDOR_INVALID) 520 continue; 521 /* XXX Not invalid, but we've done this ~forever. */ 522 if (PCI_VENDOR(id) == 0) 523 continue; 524 525 qd = pci_lookup_quirkdata(PCI_VENDOR(id), PCI_PRODUCT(id)); 526 527 if (qd != NULL && 528 (qd->quirks & PCI_QUIRK_MULTIFUNCTION) != 0) 529 nfunctions = 8; 530 else if (qd != NULL && 531 (qd->quirks & PCI_QUIRK_MONOFUNCTION) != 0) 532 nfunctions = 1; 533 else 534 nfunctions = PCI_HDRTYPE_MULTIFN(bhlcr) ? 8 : 1; 535 536 for (function = 0; function < nfunctions; function++) { 537 if ((locators[PCICF_FUNCTION] != PCICF_FUNCTION_DEFAULT) 538 && (locators[PCICF_FUNCTION] != function)) 539 continue; 540 541 if (qd != NULL && 542 (qd->quirks & PCI_QUIRK_SKIP_FUNC(function)) != 0) 543 continue; 544 tag = pci_make_tag(pc, sc->sc_bus, device, function); 545 ret = pci_probe_device(sc, tag, match, pap); 546 if (match != NULL && ret != 0) 547 return (ret); 548 } 549 } 550 return (0); 551 } 552 #endif /* PCI_MACHDEP_ENUMERATE_BUS */ 553 554 555 /* 556 * Vital Product Data (PCI 2.2) 557 */ 558 559 int 560 pci_vpd_read(pci_chipset_tag_t pc, pcitag_t tag, int offset, int count, 561 pcireg_t *data) 562 { 563 uint32_t reg; 564 int ofs, i, j; 565 566 KASSERT(data != NULL); 567 KASSERT((offset + count) < 0x7fff); 568 569 if (pci_get_capability(pc, tag, PCI_CAP_VPD, &ofs, ®) == 0) 570 return (1); 571 572 for (i = 0; i < count; offset += sizeof(*data), i++) { 573 reg &= 0x0000ffff; 574 reg &= ~PCI_VPD_OPFLAG; 575 reg |= PCI_VPD_ADDRESS(offset); 576 pci_conf_write(pc, tag, ofs, reg); 577 578 /* 579 * PCI 2.2 does not specify how long we should poll 580 * for completion nor whether the operation can fail. 581 */ 582 j = 0; 583 do { 584 if (j++ == 20) 585 return (1); 586 delay(4); 587 reg = pci_conf_read(pc, tag, ofs); 588 } while ((reg & PCI_VPD_OPFLAG) == 0); 589 data[i] = pci_conf_read(pc, tag, PCI_VPD_DATAREG(ofs)); 590 } 591 592 return (0); 593 } 594 595 int 596 pci_vpd_write(pci_chipset_tag_t pc, pcitag_t tag, int offset, int count, 597 pcireg_t *data) 598 { 599 pcireg_t reg; 600 int ofs, i, j; 601 602 KASSERT(data != NULL); 603 KASSERT((offset + count) < 0x7fff); 604 605 if (pci_get_capability(pc, tag, PCI_CAP_VPD, &ofs, ®) == 0) 606 return (1); 607 608 for (i = 0; i < count; offset += sizeof(*data), i++) { 609 pci_conf_write(pc, tag, PCI_VPD_DATAREG(ofs), data[i]); 610 611 reg &= 0x0000ffff; 612 reg |= PCI_VPD_OPFLAG; 613 reg |= PCI_VPD_ADDRESS(offset); 614 pci_conf_write(pc, tag, ofs, reg); 615 616 /* 617 * PCI 2.2 does not specify how long we should poll 618 * for completion nor whether the operation can fail. 619 */ 620 j = 0; 621 do { 622 if (j++ == 20) 623 return (1); 624 delay(1); 625 reg = pci_conf_read(pc, tag, ofs); 626 } while (reg & PCI_VPD_OPFLAG); 627 } 628 629 return (0); 630 } 631 632 int 633 pci_dma64_available(struct pci_attach_args *pa) 634 { 635 #ifdef _PCI_HAVE_DMA64 636 if (BUS_DMA_TAG_VALID(pa->pa_dmat64) && 637 ((uint64_t)physmem << PAGE_SHIFT) > 0xffffffffULL) 638 return 1; 639 #endif 640 return 0; 641 } 642 643 void 644 pci_conf_capture(pci_chipset_tag_t pc, pcitag_t tag, 645 struct pci_conf_state *pcs) 646 { 647 int off; 648 649 for (off = 0; off < 16; off++) 650 pcs->reg[off] = pci_conf_read(pc, tag, (off * 4)); 651 652 return; 653 } 654 655 void 656 pci_conf_restore(pci_chipset_tag_t pc, pcitag_t tag, 657 struct pci_conf_state *pcs) 658 { 659 int off; 660 pcireg_t val; 661 662 for (off = 15; off >= 0; off--) { 663 val = pci_conf_read(pc, tag, (off * 4)); 664 if (val != pcs->reg[off]) 665 pci_conf_write(pc, tag, (off * 4), pcs->reg[off]); 666 } 667 668 return; 669 } 670 671 /* 672 * Power Management Capability (Rev 2.2) 673 */ 674 static int 675 pci_get_powerstate_int(pci_chipset_tag_t pc, pcitag_t tag , pcireg_t *state, 676 int offset) 677 { 678 pcireg_t value, now; 679 680 value = pci_conf_read(pc, tag, offset + PCI_PMCSR); 681 now = value & PCI_PMCSR_STATE_MASK; 682 switch (now) { 683 case PCI_PMCSR_STATE_D0: 684 case PCI_PMCSR_STATE_D1: 685 case PCI_PMCSR_STATE_D2: 686 case PCI_PMCSR_STATE_D3: 687 *state = now; 688 return 0; 689 default: 690 return EINVAL; 691 } 692 } 693 694 int 695 pci_get_powerstate(pci_chipset_tag_t pc, pcitag_t tag , pcireg_t *state) 696 { 697 int offset; 698 pcireg_t value; 699 700 if (!pci_get_capability(pc, tag, PCI_CAP_PWRMGMT, &offset, &value)) 701 return EOPNOTSUPP; 702 703 return pci_get_powerstate_int(pc, tag, state, offset); 704 } 705 706 static int 707 pci_set_powerstate_int(pci_chipset_tag_t pc, pcitag_t tag, pcireg_t state, 708 int offset, pcireg_t cap_reg) 709 { 710 pcireg_t value, cap, now; 711 712 cap = cap_reg >> PCI_PMCR_SHIFT; 713 value = pci_conf_read(pc, tag, offset + PCI_PMCSR); 714 now = value & PCI_PMCSR_STATE_MASK; 715 value &= ~PCI_PMCSR_STATE_MASK; 716 717 if (now == state) 718 return 0; 719 switch (state) { 720 case PCI_PMCSR_STATE_D0: 721 break; 722 case PCI_PMCSR_STATE_D1: 723 if (now == PCI_PMCSR_STATE_D2 || now == PCI_PMCSR_STATE_D3) { 724 printf("invalid transition from %d to D1\n", (int)now); 725 return EINVAL; 726 } 727 if (!(cap & PCI_PMCR_D1SUPP)) { 728 printf("D1 not supported\n"); 729 return EOPNOTSUPP; 730 } 731 break; 732 case PCI_PMCSR_STATE_D2: 733 if (now == PCI_PMCSR_STATE_D3) { 734 printf("invalid transition from %d to D2\n", (int)now); 735 return EINVAL; 736 } 737 if (!(cap & PCI_PMCR_D2SUPP)) { 738 printf("D2 not supported\n"); 739 return EOPNOTSUPP; 740 } 741 break; 742 case PCI_PMCSR_STATE_D3: 743 break; 744 default: 745 return EINVAL; 746 } 747 value |= state; 748 pci_conf_write(pc, tag, offset + PCI_PMCSR, value); 749 /* delay according to pcipm1.2, ch. 5.6.1 */ 750 if (state == PCI_PMCSR_STATE_D3 || now == PCI_PMCSR_STATE_D3) 751 DELAY(10000); 752 else if (state == PCI_PMCSR_STATE_D2 || now == PCI_PMCSR_STATE_D2) 753 DELAY(200); 754 755 return 0; 756 } 757 758 int 759 pci_set_powerstate(pci_chipset_tag_t pc, pcitag_t tag, pcireg_t state) 760 { 761 int offset; 762 pcireg_t value; 763 764 if (!pci_get_capability(pc, tag, PCI_CAP_PWRMGMT, &offset, &value)) { 765 printf("pci_set_powerstate not supported\n"); 766 return EOPNOTSUPP; 767 } 768 769 return pci_set_powerstate_int(pc, tag, state, offset, value); 770 } 771 772 int 773 pci_activate(pci_chipset_tag_t pc, pcitag_t tag, device_t dev, 774 int (*wakefun)(pci_chipset_tag_t, pcitag_t, device_t, pcireg_t)) 775 { 776 pcireg_t pmode; 777 int error; 778 779 if ((error = pci_get_powerstate(pc, tag, &pmode))) 780 return error; 781 782 switch (pmode) { 783 case PCI_PMCSR_STATE_D0: 784 break; 785 case PCI_PMCSR_STATE_D3: 786 if (wakefun == NULL) { 787 /* 788 * The card has lost all configuration data in 789 * this state, so punt. 790 */ 791 aprint_error_dev(dev, 792 "unable to wake up from power state D3\n"); 793 return EOPNOTSUPP; 794 } 795 /*FALLTHROUGH*/ 796 default: 797 if (wakefun) { 798 error = (*wakefun)(pc, tag, dev, pmode); 799 if (error) 800 return error; 801 } 802 aprint_normal_dev(dev, "waking up from power state D%d\n", 803 pmode); 804 if ((error = pci_set_powerstate(pc, tag, PCI_PMCSR_STATE_D0))) 805 return error; 806 } 807 return 0; 808 } 809 810 int 811 pci_activate_null(pci_chipset_tag_t pc, pcitag_t tag, 812 device_t dev, pcireg_t state) 813 { 814 return 0; 815 } 816 817 /* I have disabled this code for now. --dyoung 818 * 819 * Insofar as I understand what the PCI retry timeout is [1], 820 * I see no justification for any driver to disable when it 821 * attaches/resumes a device. 822 * 823 * A PCI bus bridge may tell a bus master to retry its transaction 824 * at a later time if the resources to complete the transaction 825 * are not immediately available. Taking a guess, PCI bus masters 826 * that implement a PCI retry timeout register count down from the 827 * retry timeout to 0 while it retries a delayed PCI transaction. 828 * When it reaches 0, it stops retrying. A PCI master is *never* 829 * supposed to stop retrying a delayed transaction, though. 830 * 831 * Incidentally, I initially suspected that writing 0 to the register 832 * would not disable *retries*, but would disable the timeout. 833 * That is, any device whose retry timeout was set to 0 would 834 * *never* timeout. However, I found out, by using PCI debug 835 * facilities on the AMD Elan SC520, that if I write 0 to the retry 836 * timeout register on an ath(4) MiniPCI card, the card really does 837 * not retry transactions. 838 * 839 * Some uses of this register have mentioned "interference" with 840 * a CPU's "C3 sleep state." It seems to me that if a bus master 841 * is properly put to sleep, it will neither initiate new transactions, 842 * nor retry delayed transactions, so disabling retries should not 843 * be necessary. 844 * 845 * [1] The timeout does not appear to be documented in any PCI 846 * standard, and we have no documentation of it for the devices by 847 * Atheros, and others, that supposedly implement it. 848 */ 849 void 850 pci_disable_retry(pci_chipset_tag_t pc, pcitag_t tag) 851 { 852 #if 0 853 pcireg_t retry; 854 855 /* 856 * Disable retry timeout to keep PCI Tx retries from 857 * interfering with ACPI C3 CPU state. 858 */ 859 retry = pci_conf_read(pc, tag, PCI_RETRY_TIMEOUT_REG); 860 retry &= ~PCI_RETRY_TIMEOUT_REG_MASK; 861 pci_conf_write(pc, tag, PCI_RETRY_TIMEOUT_REG, retry); 862 #endif 863 } 864 865 struct pci_child_power { 866 struct pci_conf_state p_pciconf; 867 pci_chipset_tag_t p_pc; 868 pcitag_t p_tag; 869 bool p_has_pm; 870 int p_pm_offset; 871 pcireg_t p_pm_cap; 872 pcireg_t p_class; 873 }; 874 875 static bool 876 pci_child_suspend(device_t dv PMF_FN_ARGS) 877 { 878 struct pci_child_power *priv = device_pmf_bus_private(dv); 879 pcireg_t ocsr, csr; 880 881 pci_conf_capture(priv->p_pc, priv->p_tag, &priv->p_pciconf); 882 883 if (!priv->p_has_pm) 884 return true; /* ??? hopefully handled by ACPI */ 885 if (PCI_CLASS(priv->p_class) == PCI_CLASS_DISPLAY) 886 return true; /* XXX */ 887 888 /* disable decoding and busmastering, see pcipm1.2 ch. 8.2.1 */ 889 ocsr = pci_conf_read(priv->p_pc, priv->p_tag, PCI_COMMAND_STATUS_REG); 890 csr = ocsr & ~(PCI_COMMAND_IO_ENABLE | PCI_COMMAND_MEM_ENABLE 891 | PCI_COMMAND_MASTER_ENABLE); 892 pci_conf_write(priv->p_pc, priv->p_tag, PCI_COMMAND_STATUS_REG, csr); 893 if (pci_set_powerstate_int(priv->p_pc, priv->p_tag, 894 PCI_PMCSR_STATE_D3, priv->p_pm_offset, priv->p_pm_cap)) { 895 pci_conf_write(priv->p_pc, priv->p_tag, 896 PCI_COMMAND_STATUS_REG, ocsr); 897 aprint_error_dev(dv, "unsupported state, continuing.\n"); 898 return false; 899 } 900 return true; 901 } 902 903 static bool 904 pci_child_resume(device_t dv PMF_FN_ARGS) 905 { 906 struct pci_child_power *priv = device_pmf_bus_private(dv); 907 908 if (priv->p_has_pm && 909 pci_set_powerstate_int(priv->p_pc, priv->p_tag, 910 PCI_PMCSR_STATE_D0, priv->p_pm_offset, priv->p_pm_cap)) { 911 aprint_error_dev(dv, "unsupported state, continuing.\n"); 912 return false; 913 } 914 915 pci_conf_restore(priv->p_pc, priv->p_tag, &priv->p_pciconf); 916 917 return true; 918 } 919 920 static bool 921 pci_child_shutdown(device_t dv, int how) 922 { 923 struct pci_child_power *priv = device_pmf_bus_private(dv); 924 pcireg_t csr; 925 926 /* disable busmastering */ 927 csr = pci_conf_read(priv->p_pc, priv->p_tag, PCI_COMMAND_STATUS_REG); 928 csr &= ~PCI_COMMAND_MASTER_ENABLE; 929 pci_conf_write(priv->p_pc, priv->p_tag, PCI_COMMAND_STATUS_REG, csr); 930 return true; 931 } 932 933 static void 934 pci_child_deregister(device_t dv) 935 { 936 struct pci_child_power *priv = device_pmf_bus_private(dv); 937 938 free(priv, M_DEVBUF); 939 } 940 941 static bool 942 pci_child_register(device_t child) 943 { 944 device_t self = device_parent(child); 945 struct pci_softc *sc = device_private(self); 946 struct pci_child_power *priv; 947 int device, function, off; 948 pcireg_t reg; 949 950 priv = malloc(sizeof(*priv), M_DEVBUF, M_WAITOK); 951 952 device = device_locator(child, PCICF_DEV); 953 function = device_locator(child, PCICF_FUNCTION); 954 955 priv->p_pc = sc->sc_pc; 956 priv->p_tag = pci_make_tag(priv->p_pc, sc->sc_bus, device, 957 function); 958 priv->p_class = pci_conf_read(priv->p_pc, priv->p_tag, PCI_CLASS_REG); 959 960 if (pci_get_capability(priv->p_pc, priv->p_tag, 961 PCI_CAP_PWRMGMT, &off, ®)) { 962 priv->p_has_pm = true; 963 priv->p_pm_offset = off; 964 priv->p_pm_cap = reg; 965 } else { 966 priv->p_has_pm = false; 967 priv->p_pm_offset = -1; 968 } 969 970 device_pmf_bus_register(child, priv, pci_child_suspend, 971 pci_child_resume, pci_child_shutdown, pci_child_deregister); 972 973 return true; 974 } 975