Fix LINT building, broken by ACPI update.
[dragonfly.git] / sys / dev / acpica5 / acpi_pci_link.c
1 /*
2  * Copyright (c) 2002 Mitsuru IWASAKI <iwasaki@jp.kfreebsd.org>
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  * 2. Redistributions in binary form must reproduce the above copyright
11  *    notice, this list of conditions and the following disclaimer in the
12  *    documentation and/or other materials provided with the distribution.
13  *
14  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24  * SUCH DAMAGE.
25  * __FBSDID("$FreeBSD: src/sys/dev/acpica/acpi_pci_link.c,v 1.56.2.1.6.1 2009/04/15 03:14:26 kensmith Exp $");
26  */
27
28 #define MPASS(ex)               MPASS4(ex, #ex, __FILE__, __LINE__)
29 #define MPASS4(ex, what, file, line)                                    \
30         KASSERT((ex), ("Assertion %s failed at %s:%d", what, file, line))
31
32 #include <sys/cdefs.h>
33
34 #include "opt_acpi.h"
35 #include <sys/param.h>
36 #include <sys/bus.h>
37 #include <sys/kernel.h>
38 #include <sys/limits.h>
39 #include <sys/malloc.h>
40 #include <sys/module.h>
41
42 #include "acpi.h"
43 #include <dev/acpica5/acpivar.h>
44 #include <dev/acpica5/acpi_pcibvar.h>
45
46 #include <bus/pci/i386/pci_cfgreg.h>
47 #include <bus/pci/pcireg.h>
48 #include <bus/pci/pcivar.h>
49 #include "pcib_if.h"
50
51 /* Hooks for the ACPI CA debugging infrastructure. */
52 #define _COMPONENT      ACPI_BUS
53 ACPI_MODULE_NAME("PCI_LINK")
54
55 ACPI_SERIAL_DECL(pci_link, "ACPI PCI link");
56
57 #define NUM_ISA_INTERRUPTS      16
58 #define NUM_ACPI_INTERRUPTS     256
59
60 /*
61  * An ACPI PCI link device may contain multiple links.  Each link has its
62  * own ACPI resource.  _PRT entries specify which link is being used via
63  * the Source Index.
64  *
65  * XXX: A note about Source Indices and DPFs:  Currently we assume that
66  * the DPF start and end tags are not counted towards the index that
67  * Source Index corresponds to.  Also, we assume that when DPFs are in use
68  * they various sets overlap in terms of Indices.  Here's an example
69  * resource list indicating these assumptions:
70  *
71  * Resource             Index
72  * --------             -----
73  * I/O Port             0
74  * Start DPF            -
75  * IRQ                  1
76  * MemIO                2
77  * Start DPF            -
78  * IRQ                  1
79  * MemIO                2
80  * End DPF              -
81  * DMA Channel          3
82  *
83  * The XXX is because I'm not sure if this is a valid assumption to make.
84  */
85
86 /* States during DPF processing. */
87 #define DPF_OUTSIDE     0
88 #define DPF_FIRST       1
89 #define DPF_IGNORE      2
90
91 struct link;
92
93 struct acpi_pci_link_softc {
94         int     pl_num_links;
95         int     pl_crs_bad;
96         struct link *pl_links;
97         device_t pl_dev;
98 };
99
100 struct link {
101         struct acpi_pci_link_softc *l_sc;
102         uint8_t l_bios_irq;
103         uint8_t l_irq;
104         uint8_t l_initial_irq;
105         int     l_res_index;
106         int     l_num_irqs;
107         int     *l_irqs;
108         int     l_references;
109         int     l_routed:1;
110         int     l_isa_irq:1;
111         ACPI_RESOURCE l_prs_template;
112 };
113
114 struct link_count_request {
115         int     in_dpf;
116         int     count;
117 };
118
119 struct link_res_request {
120         struct acpi_pci_link_softc *sc;
121         int     in_dpf;
122         int     res_index;
123         int     link_index;
124 };
125
126 MALLOC_DEFINE(M_PCI_LINK, "pci_link", "ACPI PCI Link structures");
127
128 static int pci_link_interrupt_weights[NUM_ACPI_INTERRUPTS];
129 static int pci_link_bios_isa_irqs;
130
131 static char *pci_link_ids[] = { "PNP0C0F", NULL };
132
133 /*
134  * Fetch the short name associated with an ACPI handle and save it in the
135  * passed in buffer.
136  */
137 static ACPI_STATUS
138 acpi_short_name(ACPI_HANDLE handle, char *buffer, size_t buflen)
139 {
140         ACPI_BUFFER buf;
141
142         buf.Length = buflen;
143         buf.Pointer = buffer;
144         return (AcpiGetName(handle, ACPI_SINGLE_NAME, &buf));
145 }
146
147 static int
148 acpi_pci_link_probe(device_t dev)
149 {
150         char descr[28], name[12];
151
152         /*
153          * We explicitly do not check _STA since not all systems set it to
154          * sensible values.
155          */
156         if (!acpi_enabled("pci_link") ||
157             ACPI_ID_PROBE(device_get_parent(dev), dev, pci_link_ids) == NULL)
158                 return (ENXIO);
159
160         if (ACPI_SUCCESS(acpi_short_name(acpi_get_handle(dev), name,
161             sizeof(name)))) {
162                 ksnprintf(descr, sizeof(descr), "ACPI PCI Link %s", name);
163                 device_set_desc_copy(dev, descr);
164         } else
165                 device_set_desc(dev, "ACPI PCI Link");
166         device_quiet(dev);
167         return (0);
168 }
169
170 static ACPI_STATUS
171 acpi_count_irq_resources(ACPI_RESOURCE *res, void *context)
172 {
173         struct link_count_request *req;
174
175         req = (struct link_count_request *)context;
176         switch (res->Type) {
177         case ACPI_RESOURCE_TYPE_START_DEPENDENT:
178                 switch (req->in_dpf) {
179                 case DPF_OUTSIDE:
180                         /* We've started the first DPF. */
181                         req->in_dpf = DPF_FIRST;
182                         break;
183                 case DPF_FIRST:
184                         /* We've started the second DPF. */
185                         req->in_dpf = DPF_IGNORE;
186                         break;
187                 }
188                 break;
189         case ACPI_RESOURCE_TYPE_END_DEPENDENT:
190                 /* We are finished with DPF parsing. */
191                 KASSERT(req->in_dpf != DPF_OUTSIDE,
192                     ("%s: end dpf when not parsing a dpf", __func__));
193                 req->in_dpf = DPF_OUTSIDE;
194                 break;
195         case ACPI_RESOURCE_TYPE_IRQ:
196         case ACPI_RESOURCE_TYPE_EXTENDED_IRQ:
197                 /*
198                  * Don't count resources if we are in a DPF set that we are
199                  * ignoring.
200                  */
201                 if (req->in_dpf != DPF_IGNORE)
202                         req->count++;
203         }
204         return (AE_OK);
205 }
206
207 static ACPI_STATUS
208 link_add_crs(ACPI_RESOURCE *res, void *context)
209 {
210         struct link_res_request *req;
211         struct link *link;
212
213         ACPI_SERIAL_ASSERT(pci_link);
214         req = (struct link_res_request *)context;
215         switch (res->Type) {
216         case ACPI_RESOURCE_TYPE_START_DEPENDENT:
217                 switch (req->in_dpf) {
218                 case DPF_OUTSIDE:
219                         /* We've started the first DPF. */
220                         req->in_dpf = DPF_FIRST;
221                         break;
222                 case DPF_FIRST:
223                         /* We've started the second DPF. */
224                         panic(
225                 "%s: Multiple dependent functions within a current resource",
226                             __func__);
227                         break;
228                 }
229                 break;
230         case ACPI_RESOURCE_TYPE_END_DEPENDENT:
231                 /* We are finished with DPF parsing. */
232                 KASSERT(req->in_dpf != DPF_OUTSIDE,
233                     ("%s: end dpf when not parsing a dpf", __func__));
234                 req->in_dpf = DPF_OUTSIDE;
235                 break;
236         case ACPI_RESOURCE_TYPE_IRQ:
237         case ACPI_RESOURCE_TYPE_EXTENDED_IRQ:
238                 KASSERT(req->link_index < req->sc->pl_num_links,
239                     ("%s: array boundary violation", __func__));
240                 link = &req->sc->pl_links[req->link_index];
241                 link->l_res_index = req->res_index;
242                 req->link_index++;
243                 req->res_index++;
244
245                 /*
246                  * Only use the current value if there's one IRQ.  Some
247                  * systems return multiple IRQs (which is nonsense for _CRS)
248                  * when the link hasn't been programmed.
249                  */
250                 if (res->Type == ACPI_RESOURCE_TYPE_IRQ) {
251                         if (res->Data.Irq.InterruptCount == 1)
252                                 link->l_irq = res->Data.Irq.Interrupts[0];
253                 } else if (res->Data.ExtendedIrq.InterruptCount == 1)
254                         link->l_irq = res->Data.ExtendedIrq.Interrupts[0];
255
256                 /*
257                  * An IRQ of zero means that the link isn't routed.
258                  */
259                 if (link->l_irq == 0)
260                         link->l_irq = PCI_INVALID_IRQ;
261                 break;
262         default:
263                 req->res_index++;
264         }
265         return (AE_OK);
266 }
267
268 /*
269  * Populate the set of possible IRQs for each device.
270  */
271 static ACPI_STATUS
272 link_add_prs(ACPI_RESOURCE *res, void *context)
273 {
274         struct link_res_request *req;
275         struct link *link;
276         UINT8 *irqs = NULL;
277         UINT32 *ext_irqs = NULL;
278         int i, is_ext_irq = 1;
279
280         ACPI_SERIAL_ASSERT(pci_link);
281         req = (struct link_res_request *)context;
282         switch (res->Type) {
283         case ACPI_RESOURCE_TYPE_START_DEPENDENT:
284                 switch (req->in_dpf) {
285                 case DPF_OUTSIDE:
286                         /* We've started the first DPF. */
287                         req->in_dpf = DPF_FIRST;
288                         break;
289                 case DPF_FIRST:
290                         /* We've started the second DPF. */
291                         req->in_dpf = DPF_IGNORE;
292                         break;
293                 }
294                 break;
295         case ACPI_RESOURCE_TYPE_END_DEPENDENT:
296                 /* We are finished with DPF parsing. */
297                 KASSERT(req->in_dpf != DPF_OUTSIDE,
298                     ("%s: end dpf when not parsing a dpf", __func__));
299                 req->in_dpf = DPF_OUTSIDE;
300                 break;
301         case ACPI_RESOURCE_TYPE_IRQ:
302                 is_ext_irq = 0;
303                 /* fall through */
304         case ACPI_RESOURCE_TYPE_EXTENDED_IRQ:
305                 /*
306                  * Don't parse resources if we are in a DPF set that we are
307                  * ignoring.
308                  */
309                 if (req->in_dpf == DPF_IGNORE)
310                         break;
311
312                 KASSERT(req->link_index < req->sc->pl_num_links,
313                     ("%s: array boundary violation", __func__));
314                 link = &req->sc->pl_links[req->link_index];
315                 if (link->l_res_index == -1) {
316                         KASSERT(req->sc->pl_crs_bad,
317                             ("res_index should be set"));
318                         link->l_res_index = req->res_index;
319                 }
320                 req->link_index++;
321                 req->res_index++;
322
323                 /*
324                  * Stash a copy of the resource for later use when doing
325                  * _SRS.
326                  */
327                 bcopy(res, &link->l_prs_template, sizeof(ACPI_RESOURCE));
328                 if (is_ext_irq) {
329                         link->l_num_irqs =
330                             res->Data.ExtendedIrq.InterruptCount;
331                         ext_irqs = res->Data.ExtendedIrq.Interrupts;
332                 } else {
333                         link->l_num_irqs = res->Data.Irq.InterruptCount;
334                         irqs = res->Data.Irq.Interrupts;
335                 }
336                 if (link->l_num_irqs == 0)
337                         break;
338
339                 /*
340                  * Save a list of the valid IRQs.  Also, if all of the
341                  * valid IRQs are ISA IRQs, then mark this link as
342                  * routed via an ISA interrupt.
343                  */
344                 link->l_isa_irq = TRUE;
345
346                 link->l_irqs = kmalloc(sizeof(int) * link->l_num_irqs,
347                     M_PCI_LINK, M_WAITOK | M_ZERO);
348                 for (i = 0; i < link->l_num_irqs; i++) {
349                         if (is_ext_irq) {
350                                 link->l_irqs[i] = ext_irqs[i];
351                                 if (ext_irqs[i] >= NUM_ISA_INTERRUPTS)
352                                         link->l_isa_irq = FALSE;
353                         } else {
354                                 link->l_irqs[i] = irqs[i];
355                                 if (irqs[i] >= NUM_ISA_INTERRUPTS)
356                                         link->l_isa_irq = FALSE;
357                         }
358                 }
359                 break;
360         default:
361                 if (req->in_dpf == DPF_IGNORE)
362                         break;
363                 if (req->sc->pl_crs_bad)
364                         device_printf(req->sc->pl_dev,
365                     "Warning: possible resource %d will be lost during _SRS\n",
366                             req->res_index);
367                 req->res_index++;
368         }
369         return (AE_OK);
370 }
371
372 static int
373 link_valid_irq(struct link *link, int irq)
374 {
375         int i;
376
377         ACPI_SERIAL_ASSERT(pci_link);
378
379         /* Invalid interrupts are never valid. */
380         if (!PCI_INTERRUPT_VALID(irq))
381                 return (FALSE);
382
383         /* Any interrupt in the list of possible interrupts is valid. */
384         for (i = 0; i < link->l_num_irqs; i++)
385                 if (link->l_irqs[i] == irq)
386                          return (TRUE);
387
388         /*
389          * For links routed via an ISA interrupt, if the SCI is routed via
390          * an ISA interrupt, the SCI is always treated as a valid IRQ.
391          */
392         if (link->l_isa_irq && AcpiGbl_FADT.SciInterrupt == irq &&
393             irq < NUM_ISA_INTERRUPTS)
394                 return (TRUE);
395
396         /* If the interrupt wasn't found in the list it is not valid. */
397         return (FALSE);
398 }
399
400 static void
401 acpi_pci_link_dump(struct acpi_pci_link_softc *sc, int header, const char *tag)
402 {
403         struct link *link;
404         char buf[16];
405         int i, j;
406
407         ACPI_SERIAL_ASSERT(pci_link);
408         if (header) {
409                 ksnprintf(buf, sizeof(buf), "%s:",
410                     device_get_nameunit(sc->pl_dev));
411                 kprintf("%-16.16s  Index  IRQ  Rtd  Ref  IRQs\n", buf);
412         }
413         for (i = 0; i < sc->pl_num_links; i++) {
414                 link = &sc->pl_links[i];
415                 kprintf("  %-14.14s  %5d  %3d   %c   %3d ", i == 0 ? tag : "", i,
416                     link->l_irq, link->l_routed ? 'Y' : 'N',
417                     link->l_references);
418                 if (link->l_num_irqs == 0)
419                         kprintf(" none");
420                 else for (j = 0; j < link->l_num_irqs; j++)
421                         kprintf(" %d", link->l_irqs[j]);
422                 kprintf("\n");
423         }
424 }
425
426 static int
427 acpi_pci_link_attach(device_t dev)
428 {
429         struct acpi_pci_link_softc *sc;
430         struct link_count_request creq;
431         struct link_res_request rreq;
432         ACPI_STATUS status;
433         int i;
434
435         sc = device_get_softc(dev);
436         sc->pl_dev = dev;
437         ACPI_SERIAL_INIT(pci_link);
438         ACPI_SERIAL_BEGIN(pci_link);
439
440         /*
441          * Count the number of current resources so we know how big of
442          * a link array to allocate.  On some systems, _CRS is broken,
443          * so for those systems try to derive the count from _PRS instead.
444          */
445         creq.in_dpf = DPF_OUTSIDE;
446         creq.count = 0;
447         status = AcpiWalkResources(acpi_get_handle(dev), "_CRS",
448             acpi_count_irq_resources, &creq);
449         sc->pl_crs_bad = ACPI_FAILURE(status);
450         if (sc->pl_crs_bad) {
451                 creq.in_dpf = DPF_OUTSIDE;
452                 creq.count = 0;
453                 status = AcpiWalkResources(acpi_get_handle(dev), "_PRS",
454                     acpi_count_irq_resources, &creq);
455                 if (ACPI_FAILURE(status)) {
456                         device_printf(dev,
457                             "Unable to parse _CRS or _PRS: %s\n",
458                             AcpiFormatException(status));
459                         ACPI_SERIAL_END(pci_link);
460                         return (ENXIO);
461                 }
462         }
463         sc->pl_num_links = creq.count;
464         if (creq.count == 0) {
465                 ACPI_SERIAL_END(pci_link);
466                 return (0);
467         }
468         sc->pl_links = kmalloc(sizeof(struct link) * sc->pl_num_links,
469             M_PCI_LINK, M_WAITOK | M_ZERO);
470
471         /* Initialize the child links. */
472         for (i = 0; i < sc->pl_num_links; i++) {
473                 sc->pl_links[i].l_irq = PCI_INVALID_IRQ;
474                 sc->pl_links[i].l_bios_irq = PCI_INVALID_IRQ;
475                 sc->pl_links[i].l_sc = sc;
476                 sc->pl_links[i].l_isa_irq = FALSE;
477                 sc->pl_links[i].l_res_index = -1;
478         }
479
480         /* Try to read the current settings from _CRS if it is valid. */
481         if (!sc->pl_crs_bad) {
482                 rreq.in_dpf = DPF_OUTSIDE;
483                 rreq.link_index = 0;
484                 rreq.res_index = 0;
485                 rreq.sc = sc;
486                 status = AcpiWalkResources(acpi_get_handle(dev), "_CRS",
487                     link_add_crs, &rreq);
488                 if (ACPI_FAILURE(status)) {
489                         device_printf(dev, "Unable to parse _CRS: %s\n",
490                             AcpiFormatException(status));
491                         goto fail;
492                 }
493         }
494
495         /*
496          * Try to read the possible settings from _PRS.  Note that if the
497          * _CRS is toast, we depend on having a working _PRS.  However, if
498          * _CRS works, then it is ok for _PRS to be missing.
499          */
500         rreq.in_dpf = DPF_OUTSIDE;
501         rreq.link_index = 0;
502         rreq.res_index = 0;
503         rreq.sc = sc;
504         status = AcpiWalkResources(acpi_get_handle(dev), "_PRS",
505             link_add_prs, &rreq);
506         if (ACPI_FAILURE(status) &&
507             (status != AE_NOT_FOUND || sc->pl_crs_bad)) {
508                 device_printf(dev, "Unable to parse _PRS: %s\n",
509                     AcpiFormatException(status));
510                 goto fail;
511         }
512         if (bootverbose)
513                 acpi_pci_link_dump(sc, 1, "Initial Probe");
514
515         /* Verify initial IRQs if we have _PRS. */
516         if (status != AE_NOT_FOUND)
517                 for (i = 0; i < sc->pl_num_links; i++)
518                         if (!link_valid_irq(&sc->pl_links[i],
519                             sc->pl_links[i].l_irq))
520                                 sc->pl_links[i].l_irq = PCI_INVALID_IRQ;
521         if (bootverbose)
522                 acpi_pci_link_dump(sc, 0, "Validation");
523
524         /* Save initial IRQs. */
525         for (i = 0; i < sc->pl_num_links; i++)
526                 sc->pl_links[i].l_initial_irq = sc->pl_links[i].l_irq;
527
528         /*
529          * Try to disable this link.  If successful, set the current IRQ to
530          * zero and flags to indicate this link is not routed.  If we can't
531          * run _DIS (i.e., the method doesn't exist), assume the initial
532          * IRQ was routed by the BIOS.
533          */
534         if (ACPI_SUCCESS(AcpiEvaluateObject(acpi_get_handle(dev), "_DIS", NULL,
535             NULL)))
536                 for (i = 0; i < sc->pl_num_links; i++)
537                         sc->pl_links[i].l_irq = PCI_INVALID_IRQ;
538         else
539                 for (i = 0; i < sc->pl_num_links; i++)
540                         if (PCI_INTERRUPT_VALID(sc->pl_links[i].l_irq))
541                                 sc->pl_links[i].l_routed = TRUE;
542         if (bootverbose)
543                 acpi_pci_link_dump(sc, 0, "After Disable");
544         ACPI_SERIAL_END(pci_link);
545         return (0);
546 fail:
547         ACPI_SERIAL_END(pci_link);
548         for (i = 0; i < sc->pl_num_links; i++)
549                 if (sc->pl_links[i].l_irqs != NULL)
550                         kfree(sc->pl_links[i].l_irqs, M_PCI_LINK);
551         kfree(sc->pl_links, M_PCI_LINK);
552         return (ENXIO);
553 }
554
555 /* XXX: Note that this is identical to pci_pir_search_irq(). */
556 static uint8_t
557 acpi_pci_link_search_irq(int bus, int device, int pin)
558 {
559         uint32_t value;
560         uint8_t func, maxfunc;
561
562         /* See if we have a valid device at function 0. */
563         value = pci_cfgregread(bus, device, 0, PCIR_HDRTYPE, 1);
564         if ((value & PCIM_HDRTYPE) > PCI_MAXHDRTYPE)
565                 return (PCI_INVALID_IRQ);
566         if (value & PCIM_MFDEV)
567                 maxfunc = PCI_FUNCMAX;
568         else
569                 maxfunc = 0;
570
571         /* Scan all possible functions at this device. */
572         for (func = 0; func <= maxfunc; func++) {
573                 value = pci_cfgregread(bus, device, func, PCIR_DEVVENDOR, 4);
574                 if (value == 0xffffffff)
575                         continue;
576                 value = pci_cfgregread(bus, device, func, PCIR_INTPIN, 1);
577
578                 /*
579                  * See if it uses the pin in question.  Note that the passed
580                  * in pin uses 0 for A, .. 3 for D whereas the intpin
581                  * register uses 0 for no interrupt, 1 for A, .. 4 for D.
582                  */
583                 if (value != pin + 1)
584                         continue;
585                 value = pci_cfgregread(bus, device, func, PCIR_INTLINE, 1);
586                 if (bootverbose)
587                         kprintf(
588                 "ACPI: Found matching pin for %d.%d.INT%c at func %d: %d\n",
589                             bus, device, pin + 'A', func, value);
590                 if (value != PCI_INVALID_IRQ)
591                         return (value);
592         }
593         return (PCI_INVALID_IRQ);
594 }
595
596 /*
597  * Find the link structure that corresponds to the resource index passed in
598  * via 'source_index'.
599  */
600 static struct link *
601 acpi_pci_link_lookup(device_t dev, int source_index)
602 {
603         struct acpi_pci_link_softc *sc;
604         int i;
605
606         ACPI_SERIAL_ASSERT(pci_link);
607         sc = device_get_softc(dev);
608         for (i = 0; i < sc->pl_num_links; i++)
609                 if (sc->pl_links[i].l_res_index == source_index)
610                         return (&sc->pl_links[i]);
611         return (NULL);
612 }
613
614 void
615 acpi_pci_link_add_reference(device_t dev, int index, device_t pcib, int slot,
616     int pin)
617 {
618         struct link *link;
619         uint8_t bios_irq;
620         uintptr_t bus;
621
622         /*
623          * Look up the PCI bus for the specified PCI bridge device.  Note
624          * that the PCI bridge device might not have any children yet.
625          * However, looking up its bus number doesn't require a valid child
626          * device, so we just pass NULL.
627          */
628         if (BUS_READ_IVAR(pcib, NULL, PCIB_IVAR_BUS, &bus) != 0) {
629                 device_printf(pcib, "Unable to read PCI bus number");
630                 panic("PCI bridge without a bus number");
631         }
632
633         /* Bump the reference count. */
634         ACPI_SERIAL_BEGIN(pci_link);
635         link = acpi_pci_link_lookup(dev, index);
636         if (link == NULL) {
637                 device_printf(dev, "apparently invalid index %d\n", index);
638                 ACPI_SERIAL_END(pci_link);
639                 return;
640         }
641         link->l_references++;
642         if (link->l_routed)
643                 pci_link_interrupt_weights[link->l_irq]++;
644
645         /*
646          * The BIOS only routes interrupts via ISA IRQs using the ATPICs
647          * (8259As).  Thus, if this link is routed via an ISA IRQ, go
648          * look to see if the BIOS routed an IRQ for this link at the
649          * indicated (bus, slot, pin).  If so, we prefer that IRQ for
650          * this link and add that IRQ to our list of known-good IRQs.
651          * This provides a good work-around for link devices whose _CRS
652          * method is either broken or bogus.  We only use the value
653          * returned by _CRS if we can't find a valid IRQ via this method
654          * in fact.
655          *
656          * If this link is not routed via an ISA IRQ (because we are using
657          * APIC for example), then don't bother looking up the BIOS IRQ
658          * as if we find one it won't be valid anyway.
659          */
660         if (!link->l_isa_irq) {
661                 ACPI_SERIAL_END(pci_link);
662                 return;
663         }
664
665         /* Try to find a BIOS IRQ setting from any matching devices. */
666         bios_irq = acpi_pci_link_search_irq(bus, slot, pin);
667         if (!PCI_INTERRUPT_VALID(bios_irq)) {
668                 ACPI_SERIAL_END(pci_link);
669                 return;
670         }
671
672         /* Validate the BIOS IRQ. */
673         if (!link_valid_irq(link, bios_irq)) {
674                 device_printf(dev, "BIOS IRQ %u for %d.%d.INT%c is invalid\n",
675                     bios_irq, (int)bus, slot, pin + 'A');
676         } else if (!PCI_INTERRUPT_VALID(link->l_bios_irq)) {
677                 link->l_bios_irq = bios_irq;
678                 if (bios_irq < NUM_ISA_INTERRUPTS)
679                         pci_link_bios_isa_irqs |= (1 << bios_irq);
680                 if (bios_irq != link->l_initial_irq &&
681                     PCI_INTERRUPT_VALID(link->l_initial_irq))
682                         device_printf(dev,
683                             "BIOS IRQ %u does not match initial IRQ %u\n",
684                             bios_irq, link->l_initial_irq);
685         } else if (bios_irq != link->l_bios_irq)
686                 device_printf(dev,
687             "BIOS IRQ %u for %d.%d.INT%c does not match previous BIOS IRQ %u\n",
688                     bios_irq, (int)bus, slot, pin + 'A',
689                     link->l_bios_irq);
690         ACPI_SERIAL_END(pci_link);
691 }
692
693 static ACPI_STATUS
694 acpi_pci_link_srs_from_crs(struct acpi_pci_link_softc *sc, ACPI_BUFFER *srsbuf)
695 {
696         ACPI_RESOURCE *resource, *end, newres, *resptr;
697         ACPI_BUFFER crsbuf;
698         ACPI_STATUS status;
699         struct link *link;
700         int i, in_dpf;
701
702         /* Fetch the _CRS. */
703         ACPI_SERIAL_ASSERT(pci_link);
704         crsbuf.Pointer = NULL;
705         crsbuf.Length = ACPI_ALLOCATE_BUFFER;
706         status = AcpiGetCurrentResources(acpi_get_handle(sc->pl_dev), &crsbuf);
707         if (ACPI_SUCCESS(status) && crsbuf.Pointer == NULL)
708                 status = AE_NO_MEMORY;
709         if (ACPI_FAILURE(status)) {
710                 if (bootverbose)
711                         device_printf(sc->pl_dev,
712                             "Unable to fetch current resources: %s\n",
713                             AcpiFormatException(status));
714                 return (status);
715         }
716
717         /* Fill in IRQ resources via link structures. */
718         srsbuf->Pointer = NULL;
719         link = sc->pl_links;
720         i = 0;
721         in_dpf = DPF_OUTSIDE;
722         resource = (ACPI_RESOURCE *)crsbuf.Pointer;
723         end = (ACPI_RESOURCE *)((char *)crsbuf.Pointer + crsbuf.Length);
724         for (;;) {
725                 switch (resource->Type) {
726                 case ACPI_RESOURCE_TYPE_START_DEPENDENT:
727                         switch (in_dpf) {
728                         case DPF_OUTSIDE:
729                                 /* We've started the first DPF. */
730                                 in_dpf = DPF_FIRST;
731                                 break;
732                         case DPF_FIRST:
733                                 /* We've started the second DPF. */
734                                 panic(
735                 "%s: Multiple dependent functions within a current resource",
736                                     __func__);
737                                 break;
738                         }
739                         resptr = NULL;
740                         break;
741                 case ACPI_RESOURCE_TYPE_END_DEPENDENT:
742                         /* We are finished with DPF parsing. */
743                         KASSERT(in_dpf != DPF_OUTSIDE,
744                             ("%s: end dpf when not parsing a dpf", __func__));
745                         in_dpf = DPF_OUTSIDE;
746                         resptr = NULL;
747                         break;
748                 case ACPI_RESOURCE_TYPE_IRQ:
749                         MPASS(i < sc->pl_num_links);
750                         MPASS(link->l_prs_template.Type == ACPI_RESOURCE_TYPE_IRQ);
751                         newres = link->l_prs_template;
752                         resptr = &newres;
753                         resptr->Data.Irq.InterruptCount = 1;
754                         if (PCI_INTERRUPT_VALID(link->l_irq)) {
755                                 KASSERT(link->l_irq < NUM_ISA_INTERRUPTS,
756                 ("%s: can't put non-ISA IRQ %d in legacy IRQ resource type",
757                                     __func__, link->l_irq));
758                                 resptr->Data.Irq.Interrupts[0] = link->l_irq;
759                         } else
760                                 resptr->Data.Irq.Interrupts[0] = 0;
761                         link++;
762                         i++;
763                         break;
764                 case ACPI_RESOURCE_TYPE_EXTENDED_IRQ:
765                         MPASS(i < sc->pl_num_links);
766                         MPASS(link->l_prs_template.Type == ACPI_RESOURCE_TYPE_EXTENDED_IRQ);
767                         newres = link->l_prs_template;
768                         resptr = &newres;
769                         resptr->Data.ExtendedIrq.InterruptCount = 1;
770                         if (PCI_INTERRUPT_VALID(link->l_irq))
771                                 resptr->Data.ExtendedIrq.Interrupts[0] =
772                                     link->l_irq;
773                         else
774                                 resptr->Data.ExtendedIrq.Interrupts[0] = 0;
775                         link++;
776                         i++;
777                         break;
778                 default:
779                         resptr = resource;
780                 }
781                 if (resptr != NULL) {
782                         status = acpi_AppendBufferResource(srsbuf, resptr);
783                         if (ACPI_FAILURE(status)) {
784                                 device_printf(sc->pl_dev,
785                                     "Unable to build resources: %s\n",
786                                     AcpiFormatException(status));
787                                 if (srsbuf->Pointer != NULL)
788                                         AcpiOsFree(srsbuf->Pointer);
789                                 AcpiOsFree(crsbuf.Pointer);
790                                 return (status);
791                         }
792                 }
793                 if (resource->Type == ACPI_RESOURCE_TYPE_END_TAG)
794                         break;
795                 resource = ACPI_NEXT_RESOURCE(resource);
796                 if (resource >= end)
797                         break;
798         }
799         AcpiOsFree(crsbuf.Pointer);
800         return (AE_OK);
801 }
802
803 static ACPI_STATUS
804 acpi_pci_link_srs_from_links(struct acpi_pci_link_softc *sc,
805     ACPI_BUFFER *srsbuf)
806 {
807         ACPI_RESOURCE newres;
808         ACPI_STATUS status;
809         struct link *link;
810         int i;
811
812         /* Start off with an empty buffer. */
813         srsbuf->Pointer = NULL;
814         link = sc->pl_links;
815         for (i = 0; i < sc->pl_num_links; i++) {
816
817                 /* Add a new IRQ resource from each link. */
818                 link = &sc->pl_links[i];
819                 newres = link->l_prs_template;
820                 if (newres.Type == ACPI_RESOURCE_TYPE_IRQ) {
821
822                         /* Build an IRQ resource. */
823                         newres.Data.Irq.InterruptCount = 1;
824                         if (PCI_INTERRUPT_VALID(link->l_irq)) {
825                                 KASSERT(link->l_irq < NUM_ISA_INTERRUPTS,
826                 ("%s: can't put non-ISA IRQ %d in legacy IRQ resource type",
827                                     __func__, link->l_irq));
828                                 newres.Data.Irq.Interrupts[0] = link->l_irq;
829                         } else
830                                 newres.Data.Irq.Interrupts[0] = 0;
831                 } else {
832
833                         /* Build an ExtIRQ resuorce. */
834                         newres.Data.ExtendedIrq.InterruptCount = 1;
835                         if (PCI_INTERRUPT_VALID(link->l_irq))
836                                 newres.Data.ExtendedIrq.Interrupts[0] =
837                                     link->l_irq;
838                         else
839                                 newres.Data.ExtendedIrq.Interrupts[0] = 0;
840                 }
841
842                 /* Add the new resource to the end of the _SRS buffer. */
843                 status = acpi_AppendBufferResource(srsbuf, &newres);
844                 if (ACPI_FAILURE(status)) {
845                         device_printf(sc->pl_dev,
846                             "Unable to build resources: %s\n",
847                             AcpiFormatException(status));
848                         if (srsbuf->Pointer != NULL)
849                                 AcpiOsFree(srsbuf->Pointer);
850                         return (status);
851                 }
852         }
853         return (AE_OK);
854 }
855
856 static ACPI_STATUS
857 acpi_pci_link_route_irqs(device_t dev)
858 {
859         struct acpi_pci_link_softc *sc;
860         ACPI_RESOURCE *resource, *end;
861         ACPI_BUFFER srsbuf;
862         ACPI_STATUS status;
863         struct link *link;
864         int i;
865
866         ACPI_SERIAL_ASSERT(pci_link);
867         sc = device_get_softc(dev);
868         if (sc->pl_crs_bad)
869                 status = acpi_pci_link_srs_from_links(sc, &srsbuf);
870         else
871                 status = acpi_pci_link_srs_from_crs(sc, &srsbuf);
872
873         /* Write out new resources via _SRS. */
874         status = AcpiSetCurrentResources(acpi_get_handle(dev), &srsbuf);
875         if (ACPI_FAILURE(status)) {
876                 device_printf(dev, "Unable to route IRQs: %s\n",
877                     AcpiFormatException(status));
878                 AcpiOsFree(srsbuf.Pointer);
879                 return (status);
880         }
881
882         /*
883          * Perform acpi_config_intr() on each IRQ resource if it was just
884          * routed for the first time.
885          */
886         link = sc->pl_links;
887         i = 0;
888         resource = (ACPI_RESOURCE *)srsbuf.Pointer;
889         end = (ACPI_RESOURCE *)((char *)srsbuf.Pointer + srsbuf.Length);
890         for (;;) {
891                 if (resource->Type == ACPI_RESOURCE_TYPE_END_TAG)
892                         break;
893                 switch (resource->Type) {
894                 case ACPI_RESOURCE_TYPE_IRQ:
895                 case ACPI_RESOURCE_TYPE_EXTENDED_IRQ:
896                         MPASS(i < sc->pl_num_links);
897
898                         /*
899                          * Only configure the interrupt and update the
900                          * weights if this link has a valid IRQ and was
901                          * previously unrouted.
902                          */
903                         if (!link->l_routed &&
904                             PCI_INTERRUPT_VALID(link->l_irq)) {
905                                 link->l_routed = TRUE;
906                                 acpi_config_intr(dev, resource);
907                                 pci_link_interrupt_weights[link->l_irq] +=
908                                     link->l_references;
909                         }
910                         link++;
911                         i++;
912                         break;
913                 }
914                 resource = ACPI_NEXT_RESOURCE(resource);
915                 if (resource >= end)
916                         break;
917         }
918         AcpiOsFree(srsbuf.Pointer);
919         return (AE_OK);
920 }
921
922 static int
923 acpi_pci_link_resume(device_t dev)
924 {
925         struct acpi_pci_link_softc *sc;
926         ACPI_STATUS status;
927         int i, routed;
928
929         /*
930          * If all of our links are routed, then restore the link via _SRS,
931          * otherwise, disable the link via _DIS.
932          */
933         ACPI_SERIAL_BEGIN(pci_link);
934         sc = device_get_softc(dev);
935         routed = 0;
936         for (i = 0; i < sc->pl_num_links; i++)
937                 if (sc->pl_links[i].l_routed)
938                         routed++;
939         if (routed == sc->pl_num_links)
940                 status = acpi_pci_link_route_irqs(dev);
941         else {
942                 AcpiEvaluateObject(acpi_get_handle(dev), "_DIS", NULL, NULL);
943                 status = AE_OK;
944         }
945         ACPI_SERIAL_END(pci_link);
946         if (ACPI_FAILURE(status))
947                 return (ENXIO);
948         else
949                 return (0);
950 }
951
952 /*
953  * Pick an IRQ to use for this unrouted link.
954  */
955 static uint8_t
956 acpi_pci_link_choose_irq(device_t dev, struct link *link)
957 {
958         char tunable_buffer[64], link_name[5];
959         u_int8_t best_irq, pos_irq;
960         int best_weight, pos_weight, i;
961
962         KASSERT(!link->l_routed, ("%s: link already routed", __func__));
963         KASSERT(!PCI_INTERRUPT_VALID(link->l_irq),
964             ("%s: link already has an IRQ", __func__));
965
966         /* Check for a tunable override. */
967         if (ACPI_SUCCESS(acpi_short_name(acpi_get_handle(dev), link_name,
968             sizeof(link_name)))) {
969                 ksnprintf(tunable_buffer, sizeof(tunable_buffer),
970                     "hw.pci.link.%s.%d.irq", link_name, link->l_res_index);
971                 if (kgetenv_int(tunable_buffer, &i) && PCI_INTERRUPT_VALID(i)) {
972                         if (!link_valid_irq(link, i))
973                                 device_printf(dev,
974                                     "Warning, IRQ %d is not listed as valid\n",
975                                     i);
976                         return (i);
977                 }
978                 ksnprintf(tunable_buffer, sizeof(tunable_buffer),
979                     "hw.pci.link.%s.irq", link_name);
980                 if (kgetenv_int(tunable_buffer, &i) && PCI_INTERRUPT_VALID(i)) {
981                         if (!link_valid_irq(link, i))
982                                 device_printf(dev,
983                                     "Warning, IRQ %d is not listed as valid\n",
984                                     i);
985                         return (i);
986                 }
987         }
988
989         /*
990          * If we have a valid BIOS IRQ, use that.  We trust what the BIOS
991          * says it routed over what _CRS says the link thinks is routed.
992          */
993         if (PCI_INTERRUPT_VALID(link->l_bios_irq))
994                 return (link->l_bios_irq);
995
996         /*
997          * If we don't have a BIOS IRQ but do have a valid IRQ from _CRS,
998          * then use that.
999          */
1000         if (PCI_INTERRUPT_VALID(link->l_initial_irq))
1001                 return (link->l_initial_irq);
1002
1003         /*
1004          * Ok, we have no useful hints, so we have to pick from the
1005          * possible IRQs.  For ISA IRQs we only use interrupts that
1006          * have already been used by the BIOS.
1007          */
1008         best_irq = PCI_INVALID_IRQ;
1009         best_weight = INT_MAX;
1010         for (i = 0; i < link->l_num_irqs; i++) {
1011                 pos_irq = link->l_irqs[i];
1012                 if (pos_irq < NUM_ISA_INTERRUPTS &&
1013                     (pci_link_bios_isa_irqs & 1 << pos_irq) == 0)
1014                         continue;
1015                 pos_weight = pci_link_interrupt_weights[pos_irq];
1016                 if (pos_weight < best_weight) {
1017                         best_weight = pos_weight;
1018                         best_irq = pos_irq;
1019                 }
1020         }
1021
1022         /*
1023          * If this is an ISA IRQ, try using the SCI if it is also an ISA
1024          * interrupt as a fallback.
1025          */
1026         if (link->l_isa_irq) {
1027                 pos_irq = AcpiGbl_FADT.SciInterrupt;
1028                 pos_weight = pci_link_interrupt_weights[pos_irq];
1029                 if (pos_weight < best_weight) {
1030                         best_weight = pos_weight;
1031                         best_irq = pos_irq;
1032                 }
1033         }
1034
1035         if (PCI_INTERRUPT_VALID(best_irq)) {
1036                 if (bootverbose)
1037                         device_printf(dev, "Picked IRQ %u with weight %d\n",
1038                             best_irq, best_weight);
1039         } else
1040                 device_printf(dev, "Unable to choose an IRQ\n");
1041         return (best_irq);
1042 }
1043
1044 int
1045 acpi_pci_link_route_interrupt(device_t dev, int index)
1046 {
1047         struct link *link;
1048
1049         if (!acpi_enabled("pci_link"))
1050                 return (PCI_INVALID_IRQ);
1051
1052         ACPI_SERIAL_BEGIN(pci_link);
1053         link = acpi_pci_link_lookup(dev, index);
1054         if (link == NULL)
1055                 panic("%s: apparently invalid index %d", __func__, index);
1056
1057         /*
1058          * If this link device is already routed to an interrupt, just return
1059          * the interrupt it is routed to.
1060          */
1061         if (link->l_routed) {
1062                 KASSERT(PCI_INTERRUPT_VALID(link->l_irq),
1063                     ("%s: link is routed but has an invalid IRQ", __func__));
1064                 ACPI_SERIAL_END(pci_link);
1065                 return (link->l_irq);
1066         }
1067
1068         /* Choose an IRQ if we need one. */
1069         if (!PCI_INTERRUPT_VALID(link->l_irq)) {
1070                 link->l_irq = acpi_pci_link_choose_irq(dev, link);
1071
1072                 /*
1073                  * Try to route the interrupt we picked.  If it fails, then
1074                  * assume the interrupt is not routed.
1075                  */
1076                 if (PCI_INTERRUPT_VALID(link->l_irq)) {
1077                         acpi_pci_link_route_irqs(dev);
1078                         if (!link->l_routed)
1079                                 link->l_irq = PCI_INVALID_IRQ;
1080                 }
1081         }
1082         ACPI_SERIAL_END(pci_link);
1083         return (link->l_irq);
1084 }
1085
1086 /*
1087  * This is gross, but we abuse the identify routine to perform one-time
1088  * SYSINIT() style initialization for the driver.
1089  */
1090 static void
1091 acpi_pci_link_identify(driver_t *driver, device_t parent)
1092 {
1093
1094         /*
1095          * If the SCI is an ISA IRQ, add it to the bitmask of known good
1096          * ISA IRQs.
1097          *
1098          * XXX: If we are using the APIC, the SCI might have been
1099          * rerouted to an APIC pin in which case this is invalid.  However,
1100          * if we are using the APIC, we also shouldn't be having any PCI
1101          * interrupts routed via ISA IRQs, so this is probably ok.
1102          */
1103         if (AcpiGbl_FADT.SciInterrupt < NUM_ISA_INTERRUPTS)
1104                 pci_link_bios_isa_irqs |= (1 << AcpiGbl_FADT.SciInterrupt);
1105 }
1106
1107 static device_method_t acpi_pci_link_methods[] = {
1108         /* Device interface */
1109         DEVMETHOD(device_identify,      acpi_pci_link_identify),
1110         DEVMETHOD(device_probe,         acpi_pci_link_probe),
1111         DEVMETHOD(device_attach,        acpi_pci_link_attach),
1112         DEVMETHOD(device_resume,        acpi_pci_link_resume),
1113
1114         {0, 0}
1115 };
1116
1117 static driver_t acpi_pci_link_driver = {
1118         "pci_link",
1119         acpi_pci_link_methods,
1120         sizeof(struct acpi_pci_link_softc),
1121 };
1122
1123 static devclass_t pci_link_devclass;
1124
1125 DRIVER_MODULE(acpi_pci_link, acpi, acpi_pci_link_driver, pci_link_devclass, 0,
1126     0);
1127 MODULE_DEPEND(acpi_pci_link, acpi, 1, 1, 1);