drivers/acpi/acpica/evrgnini.c

   1 /******************************************************************************
   2  *
   3  * Module Name: evrgnini- ACPI address_space (op_region) init
   4  *
   5  *****************************************************************************/
   6
   7 /*
   8  * Copyright (C) 2000 - 2016, Intel Corp.
   9  * All rights reserved.
  10  *
  11  * Redistribution and use in source and binary forms, with or without
  12  * modification, are permitted provided that the following conditions
  13  * are met:
  14  * 1. Redistributions of source code must retain the above copyright
  15  *    notice, this list of conditions, and the following disclaimer,
  16  *    without modification.
  17  * 2. Redistributions in binary form must reproduce at minimum a disclaimer
  18  *    substantially similar to the "NO WARRANTY" disclaimer below
  19  *    ("Disclaimer") and any redistribution must be conditioned upon
  20  *    including a substantially similar Disclaimer requirement for further
  21  *    binary redistribution.
  22  * 3. Neither the names of the above-listed copyright holders nor the names
  23  *    of any contributors may be used to endorse or promote products derived
  24  *    from this software without specific prior written permission.
  25  *
  26  * Alternatively, this software may be distributed under the terms of the
  27  * GNU General Public License ("GPL") version 2 as published by the Free
  28  * Software Foundation.
  29  *
  30  * NO WARRANTY
  31  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  32  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  33  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
  34  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  35  * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  36  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  37  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  38  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
  39  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
  40  * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  41  * POSSIBILITY OF SUCH DAMAGES.
  42  */
  43
  44 #include <acpi/acpi.h>
  45 #include "accommon.h"
  46 #include "acevents.h"
  47 #include "acnamesp.h"
  48
  49 #define _COMPONENT          ACPI_EVENTS
  50 ACPI_MODULE_NAME("evrgnini")
  51
  52 /* Local prototypes */
  53 static u8 acpi_ev_is_pci_root_bridge(struct acpi_namespace_node *node);
  54
  55 /*******************************************************************************
  56  *
  57  * FUNCTION:    acpi_ev_system_memory_region_setup
  58  *
  59  * PARAMETERS:  handle              - Region we are interested in
  60  *              function            - Start or stop
  61  *              handler_context     - Address space handler context
  62  *              region_context      - Region specific context
  63  *
  64  * RETURN:      Status
  65  *
  66  * DESCRIPTION: Setup a system_memory operation region
  67  *
  68  ******************************************************************************/
  69
  70 acpi_status
  71 acpi_ev_system_memory_region_setup(acpi_handle handle,
  72                                    u32 function,
  73                                    void *handler_context, void **region_context)
  74 {
  75         union acpi_operand_object *region_desc =
  76             (union acpi_operand_object *)handle;
  77         struct acpi_mem_space_context *local_region_context;
  78
  79         ACPI_FUNCTION_TRACE(ev_system_memory_region_setup);
  80
  81         if (function == ACPI_REGION_DEACTIVATE) {
  82                 if (*region_context) {
  83                         local_region_context =
  84                             (struct acpi_mem_space_context *)*region_context;
  85
  86                         /* Delete a cached mapping if present */
  87
  88                         if (local_region_context->mapped_length) {
  89                                 acpi_os_unmap_memory(local_region_context->
  90                                                      mapped_logical_address,
  91                                                      local_region_context->
  92                                                      mapped_length);
  93                         }
  94                         ACPI_FREE(local_region_context);
  95                         *region_context = NULL;
  96                 }
  97                 return_ACPI_STATUS(AE_OK);
  98         }
  99
 100         /* Create a new context */
 101
 102         local_region_context =
 103             ACPI_ALLOCATE_ZEROED(sizeof(struct acpi_mem_space_context));
 104         if (!(local_region_context)) {
 105                 return_ACPI_STATUS(AE_NO_MEMORY);
 106         }
 107
 108         /* Save the region length and address for use in the handler */
 109
 110         local_region_context->length = region_desc->region.length;
 111         local_region_context->address = region_desc->region.address;
 112
 113         *region_context = local_region_context;
 114         return_ACPI_STATUS(AE_OK);
 115 }
 116
 117 /*******************************************************************************
 118  *
 119  * FUNCTION:    acpi_ev_io_space_region_setup
 120  *
 121  * PARAMETERS:  handle              - Region we are interested in
 122  *              function            - Start or stop
 123  *              handler_context     - Address space handler context
 124  *              region_context      - Region specific context
 125  *
 126  * RETURN:      Status
 127  *
 128  * DESCRIPTION: Setup a IO operation region
 129  *
 130  ******************************************************************************/
 131
 132 acpi_status
 133 acpi_ev_io_space_region_setup(acpi_handle handle,
 134                               u32 function,
 135                               void *handler_context, void **region_context)
 136 {
 137         ACPI_FUNCTION_TRACE(ev_io_space_region_setup);
 138
 139         if (function == ACPI_REGION_DEACTIVATE) {
 140                 *region_context = NULL;
 141         } else {
 142                 *region_context = handler_context;
 143         }
 144
 145         return_ACPI_STATUS(AE_OK);
 146 }
 147
 148 /*******************************************************************************
 149  *
 150  * FUNCTION:    acpi_ev_pci_config_region_setup
 151  *
 152  * PARAMETERS:  handle              - Region we are interested in
 153  *              function            - Start or stop
 154  *              handler_context     - Address space handler context
 155  *              region_context      - Region specific context
 156  *
 157  * RETURN:      Status
 158  *
 159  * DESCRIPTION: Setup a PCI_Config operation region
 160  *
 161  * MUTEX:       Assumes namespace is not locked
 162  *
 163  ******************************************************************************/
 164
 165 acpi_status
 166 acpi_ev_pci_config_region_setup(acpi_handle handle,
 167                                 u32 function,
 168                                 void *handler_context, void **region_context)
 169 {
 170         acpi_status status = AE_OK;
 171         u64 pci_value;
 172         struct acpi_pci_id *pci_id = *region_context;
 173         union acpi_operand_object *handler_obj;
 174         struct acpi_namespace_node *parent_node;
 175         struct acpi_namespace_node *pci_root_node;
 176         struct acpi_namespace_node *pci_device_node;
 177         union acpi_operand_object *region_obj =
 178             (union acpi_operand_object *)handle;
 179
 180         ACPI_FUNCTION_TRACE(ev_pci_config_region_setup);
 181
 182         handler_obj = region_obj->region.handler;
 183         if (!handler_obj) {
 184                 /*
 185                  * No installed handler. This shouldn't happen because the dispatch
 186                  * routine checks before we get here, but we check again just in case.
 187                  */
 188                 ACPI_DEBUG_PRINT((ACPI_DB_OPREGION,
 189                                   "Attempting to init a region %p, with no handler\n",
 190                                   region_obj));
 191                 return_ACPI_STATUS(AE_NOT_EXIST);
 192         }
 193
 194         *region_context = NULL;
 195         if (function == ACPI_REGION_DEACTIVATE) {
 196                 if (pci_id) {
 197                         ACPI_FREE(pci_id);
 198                 }
 199                 return_ACPI_STATUS(status);
 200         }
 201
 202         parent_node = region_obj->region.node->parent;
 203
 204         /*
 205          * Get the _SEG and _BBN values from the device upon which the handler
 206          * is installed.
 207          *
 208          * We need to get the _SEG and _BBN objects relative to the PCI BUS device.
 209          * This is the device the handler has been registered to handle.
 210          */
 211
 212         /*
 213          * If the address_space.Node is still pointing to the root, we need
 214          * to scan upward for a PCI Root bridge and re-associate the op_region
 215          * handlers with that device.
 216          */
 217         if (handler_obj->address_space.node == acpi_gbl_root_node) {
 218
 219                 /* Start search from the parent object */
 220
 221                 pci_root_node = parent_node;
 222                 while (pci_root_node != acpi_gbl_root_node) {
 223
 224                         /* Get the _HID/_CID in order to detect a root_bridge */
 225
 226                         if (acpi_ev_is_pci_root_bridge(pci_root_node)) {
 227
 228                                 /* Install a handler for this PCI root bridge */
 229
 230                                 status = acpi_install_address_space_handler((acpi_handle)pci_root_node, ACPI_ADR_SPACE_PCI_CONFIG, ACPI_DEFAULT_HANDLER, NULL, NULL);
 231                                 if (ACPI_FAILURE(status)) {
 232                                         if (status == AE_SAME_HANDLER) {
 233                                                 /*
 234                                                  * It is OK if the handler is already installed on the
 235                                                  * root bridge. Still need to return a context object
 236                                                  * for the new PCI_Config operation region, however.
 237                                                  */
 238                                                 status = AE_OK;
 239                                         } else {
 240                                                 ACPI_EXCEPTION((AE_INFO, status,
 241                                                                 "Could not install PciConfig handler "
 242                                                                 "for Root Bridge %4.4s",
 243                                                                 acpi_ut_get_node_name
 244                                                                 (pci_root_node)));
 245                                         }
 246                                 }
 247                                 break;
 248                         }
 249
 250                         pci_root_node = pci_root_node->parent;
 251                 }
 252
 253                 /* PCI root bridge not found, use namespace root node */
 254         } else {
 255                 pci_root_node = handler_obj->address_space.node;
 256         }
 257
 258         /*
 259          * If this region is now initialized, we are done.
 260          * (install_address_space_handler could have initialized it)
 261          */
 262         if (region_obj->region.flags & AOPOBJ_SETUP_COMPLETE) {
 263                 return_ACPI_STATUS(AE_OK);
 264         }
 265
 266         /* Region is still not initialized. Create a new context */
 267
 268         pci_id = ACPI_ALLOCATE_ZEROED(sizeof(struct acpi_pci_id));
 269         if (!pci_id) {
 270                 return_ACPI_STATUS(AE_NO_MEMORY);
 271         }
 272
 273         /*
 274          * For PCI_Config space access, we need the segment, bus, device and
 275          * function numbers. Acquire them here.
 276          *
 277          * Find the parent device object. (This allows the operation region to be
 278          * within a subscope under the device, such as a control method.)
 279          */
 280         pci_device_node = region_obj->region.node;
 281         while (pci_device_node && (pci_device_node->type != ACPI_TYPE_DEVICE)) {
 282                 pci_device_node = pci_device_node->parent;
 283         }
 284
 285         if (!pci_device_node) {
 286                 ACPI_FREE(pci_id);
 287                 return_ACPI_STATUS(AE_AML_OPERAND_TYPE);
 288         }
 289
 290         /*
 291          * Get the PCI device and function numbers from the _ADR object
 292          * contained in the parent's scope.
 293          */
 294         status = acpi_ut_evaluate_numeric_object(METHOD_NAME__ADR,
 295                                                  pci_device_node, &pci_value);
 296
 297         /*
 298          * The default is zero, and since the allocation above zeroed the data,
 299          * just do nothing on failure.
 300          */
 301         if (ACPI_SUCCESS(status)) {
 302                 pci_id->device = ACPI_HIWORD(ACPI_LODWORD(pci_value));
 303                 pci_id->function = ACPI_LOWORD(ACPI_LODWORD(pci_value));
 304         }
 305
 306         /* The PCI segment number comes from the _SEG method */
 307
 308         status = acpi_ut_evaluate_numeric_object(METHOD_NAME__SEG,
 309                                                  pci_root_node, &pci_value);
 310         if (ACPI_SUCCESS(status)) {
 311                 pci_id->segment = ACPI_LOWORD(pci_value);
 312         }
 313
 314         /* The PCI bus number comes from the _BBN method */
 315
 316         status = acpi_ut_evaluate_numeric_object(METHOD_NAME__BBN,
 317                                                  pci_root_node, &pci_value);
 318         if (ACPI_SUCCESS(status)) {
 319                 pci_id->bus = ACPI_LOWORD(pci_value);
 320         }
 321
 322         /* Complete/update the PCI ID for this device */
 323
 324         status =
 325             acpi_hw_derive_pci_id(pci_id, pci_root_node,
 326                                   region_obj->region.node);
 327         if (ACPI_FAILURE(status)) {
 328                 ACPI_FREE(pci_id);
 329                 return_ACPI_STATUS(status);
 330         }
 331
 332         *region_context = pci_id;
 333         return_ACPI_STATUS(AE_OK);
 334 }
 335
 336 /*******************************************************************************
 337  *
 338  * FUNCTION:    acpi_ev_is_pci_root_bridge
 339  *
 340  * PARAMETERS:  node            - Device node being examined
 341  *
 342  * RETURN:      TRUE if device is a PCI/PCI-Express Root Bridge
 343  *
 344  * DESCRIPTION: Determine if the input device represents a PCI Root Bridge by
 345  *              examining the _HID and _CID for the device.
 346  *
 347  ******************************************************************************/
 348
 349 static u8 acpi_ev_is_pci_root_bridge(struct acpi_namespace_node *node)
 350 {
 351         acpi_status status;
 352         struct acpi_pnp_device_id *hid;
 353         struct acpi_pnp_device_id_list *cid;
 354         u32 i;
 355         u8 match;
 356
 357         /* Get the _HID and check for a PCI Root Bridge */
 358
 359         status = acpi_ut_execute_HID(node, &hid);
 360         if (ACPI_FAILURE(status)) {
 361                 return (FALSE);
 362         }
 363
 364         match = acpi_ut_is_pci_root_bridge(hid->string);
 365         ACPI_FREE(hid);
 366
 367         if (match) {
 368                 return (TRUE);
 369         }
 370
 371         /* The _HID did not match. Get the _CID and check for a PCI Root Bridge */
 372
 373         status = acpi_ut_execute_CID(node, &cid);
 374         if (ACPI_FAILURE(status)) {
 375                 return (FALSE);
 376         }
 377
 378         /* Check all _CIDs in the returned list */
 379
 380         for (i = 0; i < cid->count; i++) {
 381                 if (acpi_ut_is_pci_root_bridge(cid->ids[i].string)) {
 382                         ACPI_FREE(cid);
 383                         return (TRUE);
 384                 }
 385         }
 386
 387         ACPI_FREE(cid);
 388         return (FALSE);
 389 }
 390
 391 /*******************************************************************************
 392  *
 393  * FUNCTION:    acpi_ev_pci_bar_region_setup
 394  *
 395  * PARAMETERS:  handle              - Region we are interested in
 396  *              function            - Start or stop
 397  *              handler_context     - Address space handler context
 398  *              region_context      - Region specific context
 399  *
 400  * RETURN:      Status
 401  *
 402  * DESCRIPTION: Setup a pci_BAR operation region
 403  *
 404  * MUTEX:       Assumes namespace is not locked
 405  *
 406  ******************************************************************************/
 407
 408 acpi_status
 409 acpi_ev_pci_bar_region_setup(acpi_handle handle,
 410                              u32 function,
 411                              void *handler_context, void **region_context)
 412 {
 413         ACPI_FUNCTION_TRACE(ev_pci_bar_region_setup);
 414
 415         return_ACPI_STATUS(AE_OK);
 416 }
 417
 418 /*******************************************************************************
 419  *
 420  * FUNCTION:    acpi_ev_cmos_region_setup
 421  *
 422  * PARAMETERS:  handle              - Region we are interested in
 423  *              function            - Start or stop
 424  *              handler_context     - Address space handler context
 425  *              region_context      - Region specific context
 426  *
 427  * RETURN:      Status
 428  *
 429  * DESCRIPTION: Setup a CMOS operation region
 430  *
 431  * MUTEX:       Assumes namespace is not locked
 432  *
 433  ******************************************************************************/
 434
 435 acpi_status
 436 acpi_ev_cmos_region_setup(acpi_handle handle,
 437                           u32 function,
 438                           void *handler_context, void **region_context)
 439 {
 440         ACPI_FUNCTION_TRACE(ev_cmos_region_setup);
 441
 442         return_ACPI_STATUS(AE_OK);
 443 }
 444
 445 /*******************************************************************************
 446  *
 447  * FUNCTION:    acpi_ev_default_region_setup
 448  *
 449  * PARAMETERS:  handle              - Region we are interested in
 450  *              function            - Start or stop
 451  *              handler_context     - Address space handler context
 452  *              region_context      - Region specific context
 453  *
 454  * RETURN:      Status
 455  *
 456  * DESCRIPTION: Default region initialization
 457  *
 458  ******************************************************************************/
 459
 460 acpi_status
 461 acpi_ev_default_region_setup(acpi_handle handle,
 462                              u32 function,
 463                              void *handler_context, void **region_context)
 464 {
 465         ACPI_FUNCTION_TRACE(ev_default_region_setup);
 466
 467         if (function == ACPI_REGION_DEACTIVATE) {
 468                 *region_context = NULL;
 469         } else {
 470                 *region_context = handler_context;
 471         }
 472
 473         return_ACPI_STATUS(AE_OK);
 474 }
 475
 476 /*******************************************************************************
 477  *
 478  * FUNCTION:    acpi_ev_initialize_region
 479  *
 480  * PARAMETERS:  region_obj      - Region we are initializing
 481  *              acpi_ns_locked  - Is namespace locked?
 482  *
 483  * RETURN:      Status
 484  *
 485  * DESCRIPTION: Initializes the region, finds any _REG methods and saves them
 486  *              for execution at a later time
 487  *
 488  *              Get the appropriate address space handler for a newly
 489  *              created region.
 490  *
 491  *              This also performs address space specific initialization. For
 492  *              example, PCI regions must have an _ADR object that contains
 493  *              a PCI address in the scope of the definition. This address is
 494  *              required to perform an access to PCI config space.
 495  *
 496  * MUTEX:       Interpreter should be unlocked, because we may run the _REG
 497  *              method for this region.
 498  *
 499  ******************************************************************************/
 500
 501 acpi_status
 502 acpi_ev_initialize_region(union acpi_operand_object *region_obj,
 503                           u8 acpi_ns_locked)
 504 {
 505         union acpi_operand_object *handler_obj;
 506         union acpi_operand_object *obj_desc;
 507         acpi_adr_space_type space_id;
 508         struct acpi_namespace_node *node;
 509         acpi_status status;
 510
 511         ACPI_FUNCTION_TRACE_U32(ev_initialize_region, acpi_ns_locked);
 512
 513         if (!region_obj) {
 514                 return_ACPI_STATUS(AE_BAD_PARAMETER);
 515         }
 516
 517         if (region_obj->common.flags & AOPOBJ_OBJECT_INITIALIZED) {
 518                 return_ACPI_STATUS(AE_OK);
 519         }
 520
 521         region_obj->common.flags |= AOPOBJ_OBJECT_INITIALIZED;
 522
 523         node = region_obj->region.node->parent;
 524         space_id = region_obj->region.space_id;
 525
 526         /*
 527          * The following loop depends upon the root Node having no parent
 528          * ie: acpi_gbl_root_node->Parent being set to NULL
 529          */
 530         while (node) {
 531
 532                 /* Check to see if a handler exists */
 533
 534                 handler_obj = NULL;
 535                 obj_desc = acpi_ns_get_attached_object(node);
 536                 if (obj_desc) {
 537
 538                         /* Can only be a handler if the object exists */
 539
 540                         switch (node->type) {
 541                         case ACPI_TYPE_DEVICE:
 542                         case ACPI_TYPE_PROCESSOR:
 543                         case ACPI_TYPE_THERMAL:
 544
 545                                 handler_obj = obj_desc->common_notify.handler;
 546                                 break;
 547
 548                         case ACPI_TYPE_METHOD:
 549                                 /*
 550                                  * If we are executing module level code, the original
 551                                  * Node's object was replaced by this Method object and we
 552                                  * saved the handler in the method object.
 553                                  *
 554                                  * See acpi_ns_exec_module_code
 555                                  */
 556                                 if (obj_desc->method.
 557                                     info_flags & ACPI_METHOD_MODULE_LEVEL) {
 558                                         handler_obj =
 559                                             obj_desc->method.dispatch.handler;
 560                                 }
 561                                 break;
 562
 563                         default:
 564
 565                                 /* Ignore other objects */
 566
 567                                 break;
 568                         }
 569
 570                         handler_obj =
 571                             acpi_ev_find_region_handler(space_id, handler_obj);
 572                         if (handler_obj) {
 573
 574                                 /* Found correct handler */
 575
 576                                 ACPI_DEBUG_PRINT((ACPI_DB_OPREGION,
 577                                                   "Found handler %p for region %p in obj %p\n",
 578                                                   handler_obj, region_obj,
 579                                                   obj_desc));
 580
 581                                 status =
 582                                     acpi_ev_attach_region(handler_obj,
 583                                                           region_obj,
 584                                                           acpi_ns_locked);
 585
 586                                 /*
 587                                  * Tell all users that this region is usable by
 588                                  * running the _REG method
 589                                  */
 590                                 if (acpi_ns_locked) {
 591                                         status =
 592                                             acpi_ut_release_mutex
 593                                             (ACPI_MTX_NAMESPACE);
 594                                         if (ACPI_FAILURE(status)) {
 595                                                 return_ACPI_STATUS(status);
 596                                         }
 597                                 }
 598
 599                                 status =
 600                                     acpi_ev_execute_reg_method(region_obj,
 601                                                                ACPI_REG_CONNECT);
 602
 603                                 if (acpi_ns_locked) {
 604                                         status =
 605                                             acpi_ut_acquire_mutex
 606                                             (ACPI_MTX_NAMESPACE);
 607                                         if (ACPI_FAILURE(status)) {
 608                                                 return_ACPI_STATUS(status);
 609                                         }
 610                                 }
 611
 612                                 return_ACPI_STATUS(AE_OK);
 613                         }
 614                 }
 615
 616                 /* This node does not have the handler we need; Pop up one level */
 617
 618                 node = node->parent;
 619         }
 620
 621         /* If we get here, there is no handler for this region */
 622
 623         ACPI_DEBUG_PRINT((ACPI_DB_OPREGION,
 624                           "No handler for RegionType %s(%X) (RegionObj %p)\n",
 625                           acpi_ut_get_region_name(space_id), space_id,
 626                           region_obj));
 627
 628         return_ACPI_STATUS(AE_NOT_EXIST);
 629 }