drivers/acpi/pci_bind.c

   1 /*
   2  *  pci_bind.c - ACPI PCI Device Binding ($Revision: 2 $)
   3  *
   4  *  Copyright (C) 2001, 2002 Andy Grover <andrew.grover@intel.com>
   5  *  Copyright (C) 2001, 2002 Paul Diefenbaugh <paul.s.diefenbaugh@intel.com>
   6  *
   7  * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
   8  *
   9  *  This program is free software; you can redistribute it and/or modify
  10  *  it under the terms of the GNU General Public License as published by
  11  *  the Free Software Foundation; either version 2 of the License, or (at
  12  *  your option) any later version.
  13  *
  14  *  This program is distributed in the hope that it will be useful, but
  15  *  WITHOUT ANY WARRANTY; without even the implied warranty of
  16  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  17  *  General Public License for more details.
  18  *
  19  *  You should have received a copy of the GNU General Public License along
  20  *  with this program; if not, write to the Free Software Foundation, Inc.,
  21  *  59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
  22  *
  23  * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  24  */
  25
  26 #include <linux/kernel.h>
  27 #include <linux/module.h>
  28 #include <linux/init.h>
  29 #include <linux/types.h>
  30 #include <linux/proc_fs.h>
  31 #include <linux/spinlock.h>
  32 #include <linux/pm.h>
  33 #include <linux/pci.h>
  34 #include <linux/acpi.h>
  35 #include <acpi/acpi_bus.h>
  36 #include <acpi/acpi_drivers.h>
  37
  38 #define _COMPONENT              ACPI_PCI_COMPONENT
  39 ACPI_MODULE_NAME("pci_bind");
  40
  41 struct acpi_pci_data {
  42         struct acpi_pci_id id;
  43         struct pci_bus *bus;
  44         struct pci_dev *dev;
  45 };
  46
  47 static int acpi_pci_bind(struct acpi_device *device);
  48 static int acpi_pci_unbind(struct acpi_device *device);
  49
  50 static void acpi_pci_data_handler(acpi_handle handle, u32 function,
  51                                   void *context)
  52 {
  53
  54         /* TBD: Anything we need to do here? */
  55
  56         return;
  57 }
  58
  59 /**
  60  * acpi_get_pci_id
  61  * ------------------
  62  * This function is used by the ACPI Interpreter (a.k.a. Core Subsystem)
  63  * to resolve PCI information for ACPI-PCI devices defined in the namespace.
  64  * This typically occurs when resolving PCI operation region information.
  65  */
  66 acpi_status acpi_get_pci_id(acpi_handle handle, struct acpi_pci_id *id)
  67 {
  68         int result = 0;
  69         acpi_status status = AE_OK;
  70         struct acpi_device *device = NULL;
  71         struct acpi_pci_data *data = NULL;
  72
  73
  74         if (!id)
  75                 return AE_BAD_PARAMETER;
  76
  77         result = acpi_bus_get_device(handle, &device);
  78         if (result) {
  79                 printk(KERN_ERR PREFIX
  80                             "Invalid ACPI Bus context for device %s\n",
  81                             acpi_device_bid(device));
  82                 return AE_NOT_EXIST;
  83         }
  84
  85         status = acpi_get_data(handle, acpi_pci_data_handler, (void **)&data);
  86         if (ACPI_FAILURE(status) || !data) {
  87                 ACPI_EXCEPTION((AE_INFO, status,
  88                                 "Invalid ACPI-PCI context for device %s",
  89                                 acpi_device_bid(device)));
  90                 return status;
  91         }
  92
  93         *id = data->id;
  94
  95         /*
  96            id->segment = data->id.segment;
  97            id->bus = data->id.bus;
  98            id->device = data->id.device;
  99            id->function = data->id.function;
 100          */
 101
 102         ACPI_DEBUG_PRINT((ACPI_DB_INFO,
 103                           "Device %s has PCI address %04x:%02x:%02x.%d\n",
 104                           acpi_device_bid(device), id->segment, id->bus,
 105                           id->device, id->function));
 106
 107         return AE_OK;
 108 }
 109
 110 EXPORT_SYMBOL(acpi_get_pci_id);
 111
 112 static int acpi_pci_bind(struct acpi_device *device)
 113 {
 114         int result = 0;
 115         acpi_status status;
 116         struct acpi_pci_data *data;
 117         struct acpi_pci_data *pdata;
 118         struct acpi_buffer buffer = { ACPI_ALLOCATE_BUFFER, NULL };
 119         acpi_handle handle;
 120
 121         if (!device || !device->parent)
 122                 return -EINVAL;
 123
 124         data = kzalloc(sizeof(struct acpi_pci_data), GFP_KERNEL);
 125         if (!data)
 126                 return -ENOMEM;
 127
 128         status = acpi_get_name(device->handle, ACPI_FULL_PATHNAME, &buffer);
 129         if (ACPI_FAILURE(status)) {
 130                 kfree(data);
 131                 return -ENODEV;
 132         }
 133
 134         ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Binding PCI device [%s]...\n",
 135                           (char *)buffer.pointer));
 136
 137         /*
 138          * Segment & Bus
 139          * -------------
 140          * These are obtained via the parent device's ACPI-PCI context.
 141          */
 142         status = acpi_get_data(device->parent->handle, acpi_pci_data_handler,
 143                                (void **)&pdata);
 144         if (ACPI_FAILURE(status) || !pdata || !pdata->bus) {
 145                 ACPI_EXCEPTION((AE_INFO, status,
 146                                 "Invalid ACPI-PCI context for parent device %s",
 147                                 acpi_device_bid(device->parent)));
 148                 result = -ENODEV;
 149                 goto end;
 150         }
 151         data->id.segment = pdata->id.segment;
 152         data->id.bus = pdata->bus->number;
 153
 154         /*
 155          * Device & Function
 156          * -----------------
 157          * These are simply obtained from the device's _ADR method.  Note
 158          * that a value of zero is valid.
 159          */
 160         data->id.device = device->pnp.bus_address >> 16;
 161         data->id.function = device->pnp.bus_address & 0xFFFF;
 162
 163         ACPI_DEBUG_PRINT((ACPI_DB_INFO, "...to %04x:%02x:%02x.%d\n",
 164                           data->id.segment, data->id.bus, data->id.device,
 165                           data->id.function));
 166
 167         /*
 168          * TBD: Support slot devices (e.g. function=0xFFFF).
 169          */
 170
 171         /*
 172          * Locate PCI Device
 173          * -----------------
 174          * Locate matching device in PCI namespace.  If it doesn't exist
 175          * this typically means that the device isn't currently inserted
 176          * (e.g. docking station, port replicator, etc.).
 177          */
 178         data->dev = pci_get_slot(pdata->bus,
 179                                 PCI_DEVFN(data->id.device, data->id.function));
 180         if (!data->dev) {
 181                 ACPI_DEBUG_PRINT((ACPI_DB_INFO,
 182                                   "Device %04x:%02x:%02x.%d not present in PCI namespace\n",
 183                                   data->id.segment, data->id.bus,
 184                                   data->id.device, data->id.function));
 185                 result = -ENODEV;
 186                 goto end;
 187         }
 188         if (!data->dev->bus) {
 189                 printk(KERN_ERR PREFIX
 190                             "Device %04x:%02x:%02x.%d has invalid 'bus' field\n",
 191                             data->id.segment, data->id.bus,
 192                             data->id.device, data->id.function);
 193                 result = -ENODEV;
 194                 goto end;
 195         }
 196
 197         /*
 198          * PCI Bridge?
 199          * -----------
 200          * If so, set the 'bus' field and install the 'bind' function to
 201          * facilitate callbacks for all of its children.
 202          */
 203         if (data->dev->subordinate) {
 204                 ACPI_DEBUG_PRINT((ACPI_DB_INFO,
 205                                   "Device %04x:%02x:%02x.%d is a PCI bridge\n",
 206                                   data->id.segment, data->id.bus,
 207                                   data->id.device, data->id.function));
 208                 data->bus = data->dev->subordinate;
 209                 device->ops.bind = acpi_pci_bind;
 210                 device->ops.unbind = acpi_pci_unbind;
 211         }
 212
 213         /*
 214          * Attach ACPI-PCI Context
 215          * -----------------------
 216          * Thus binding the ACPI and PCI devices.
 217          */
 218         status = acpi_attach_data(device->handle, acpi_pci_data_handler, data);
 219         if (ACPI_FAILURE(status)) {
 220                 ACPI_EXCEPTION((AE_INFO, status,
 221                                 "Unable to attach ACPI-PCI context to device %s",
 222                                 acpi_device_bid(device)));
 223                 result = -ENODEV;
 224                 goto end;
 225         }
 226
 227         /*
 228          * PCI Routing Table
 229          * -----------------
 230          * Evaluate and parse _PRT, if exists.  This code is independent of
 231          * PCI bridges (above) to allow parsing of _PRT objects within the
 232          * scope of non-bridge devices.  Note that _PRTs within the scope of
 233          * a PCI bridge assume the bridge's subordinate bus number.
 234          *
 235          * TBD: Can _PRTs exist within the scope of non-bridge PCI devices?
 236          */
 237         status = acpi_get_handle(device->handle, METHOD_NAME__PRT, &handle);
 238         if (ACPI_SUCCESS(status)) {
 239                 if (data->bus)  /* PCI-PCI bridge */
 240                         acpi_pci_irq_add_prt(device->handle, data->id.segment,
 241                                              data->bus->number);
 242                 else            /* non-bridge PCI device */
 243                         acpi_pci_irq_add_prt(device->handle, data->id.segment,
 244                                              data->id.bus);
 245         }
 246
 247       end:
 248         kfree(buffer.pointer);
 249         if (result) {
 250                 pci_dev_put(data->dev);
 251                 kfree(data);
 252         }
 253         return result;
 254 }
 255
 256 static int acpi_pci_unbind(struct acpi_device *device)
 257 {
 258         int result = 0;
 259         acpi_status status;
 260         struct acpi_pci_data *data;
 261         struct acpi_buffer buffer = { ACPI_ALLOCATE_BUFFER, NULL };
 262
 263
 264         if (!device || !device->parent)
 265                 return -EINVAL;
 266
 267         status = acpi_get_name(device->handle, ACPI_FULL_PATHNAME, &buffer);
 268         if (ACPI_FAILURE(status))
 269                 return -ENODEV;
 270
 271         ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Unbinding PCI device [%s]...\n",
 272                           (char *) buffer.pointer));
 273         kfree(buffer.pointer);
 274
 275         status =
 276             acpi_get_data(device->handle, acpi_pci_data_handler,
 277                           (void **)&data);
 278         if (ACPI_FAILURE(status)) {
 279                 result = -ENODEV;
 280                 goto end;
 281         }
 282
 283         status = acpi_detach_data(device->handle, acpi_pci_data_handler);
 284         if (ACPI_FAILURE(status)) {
 285                 ACPI_EXCEPTION((AE_INFO, status,
 286                                 "Unable to detach data from device %s",
 287                                 acpi_device_bid(device)));
 288                 result = -ENODEV;
 289                 goto end;
 290         }
 291         if (data->dev->subordinate) {
 292                 acpi_pci_irq_del_prt(data->id.segment, data->bus->number);
 293         }
 294         pci_dev_put(data->dev);
 295         kfree(data);
 296
 297       end:
 298         return result;
 299 }
 300
 301 int
 302 acpi_pci_bind_root(struct acpi_device *device,
 303                    struct acpi_pci_id *id, struct pci_bus *bus)
 304 {
 305         int result = 0;
 306         acpi_status status;
 307         struct acpi_pci_data *data = NULL;
 308         struct acpi_buffer buffer = { ACPI_ALLOCATE_BUFFER, NULL };
 309
 310         if (!device || !id || !bus) {
 311                 return -EINVAL;
 312         }
 313
 314         data = kzalloc(sizeof(struct acpi_pci_data), GFP_KERNEL);
 315         if (!data)
 316                 return -ENOMEM;
 317
 318         data->id = *id;
 319         data->bus = bus;
 320         device->ops.bind = acpi_pci_bind;
 321         device->ops.unbind = acpi_pci_unbind;
 322
 323         status = acpi_get_name(device->handle, ACPI_FULL_PATHNAME, &buffer);
 324         if (ACPI_FAILURE(status)) {
 325                 kfree (data);
 326                 return -ENODEV;
 327         }
 328
 329         ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Binding PCI root bridge [%s] to "
 330                         "%04x:%02x\n", (char *)buffer.pointer,
 331                         id->segment, id->bus));
 332
 333         status = acpi_attach_data(device->handle, acpi_pci_data_handler, data);
 334         if (ACPI_FAILURE(status)) {
 335                 ACPI_EXCEPTION((AE_INFO, status,
 336                                 "Unable to attach ACPI-PCI context to device %s",
 337                                 (char *)buffer.pointer));
 338                 result = -ENODEV;
 339                 goto end;
 340         }
 341
 342       end:
 343         kfree(buffer.pointer);
 344         if (result != 0)
 345                 kfree(data);
 346
 347         return result;
 348 }