1 /****************************************************************************** 2 * 3 * Module Name: evxfgpe - External Interfaces for General Purpose Events (GPEs) 4 * 5 *****************************************************************************/ 6 7 /* 8 * Copyright (C) 2000 - 2013, 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 <linux/export.h> 45 #include <acpi/acpi.h> 46 #include "accommon.h" 47 #include "acevents.h" 48 #include "acnamesp.h" 49 50 #define _COMPONENT ACPI_EVENTS 51 ACPI_MODULE_NAME("evxfgpe") 52 53 #if (!ACPI_REDUCED_HARDWARE) /* Entire module */ 54 /******************************************************************************* 55 * 56 * FUNCTION: acpi_update_all_gpes 57 * 58 * PARAMETERS: None 59 * 60 * RETURN: Status 61 * 62 * DESCRIPTION: Complete GPE initialization and enable all GPEs that have 63 * associated _Lxx or _Exx methods and are not pointed to by any 64 * device _PRW methods (this indicates that these GPEs are 65 * generally intended for system or device wakeup. Such GPEs 66 * have to be enabled directly when the devices whose _PRW 67 * methods point to them are set up for wakeup signaling.) 68 * 69 * NOTE: Should be called after any GPEs are added to the system. Primarily, 70 * after the system _PRW methods have been run, but also after a GPE Block 71 * Device has been added or if any new GPE methods have been added via a 72 * dynamic table load. 73 * 74 ******************************************************************************/ 75 76 acpi_status acpi_update_all_gpes(void) 77 { 78 acpi_status status; 79 80 ACPI_FUNCTION_TRACE(acpi_update_all_gpes); 81 82 status = acpi_ut_acquire_mutex(ACPI_MTX_EVENTS); 83 if (ACPI_FAILURE(status)) { 84 return_ACPI_STATUS(status); 85 } 86 87 if (acpi_gbl_all_gpes_initialized) { 88 goto unlock_and_exit; 89 } 90 91 status = acpi_ev_walk_gpe_list(acpi_ev_initialize_gpe_block, NULL); 92 if (ACPI_SUCCESS(status)) { 93 acpi_gbl_all_gpes_initialized = TRUE; 94 } 95 96 unlock_and_exit: 97 (void)acpi_ut_release_mutex(ACPI_MTX_EVENTS); 98 99 return_ACPI_STATUS(status); 100 } 101 102 ACPI_EXPORT_SYMBOL(acpi_update_all_gpes) 103 104 /******************************************************************************* 105 * 106 * FUNCTION: acpi_enable_gpe 107 * 108 * PARAMETERS: gpe_device - Parent GPE Device. NULL for GPE0/GPE1 109 * gpe_number - GPE level within the GPE block 110 * 111 * RETURN: Status 112 * 113 * DESCRIPTION: Add a reference to a GPE. On the first reference, the GPE is 114 * hardware-enabled. 115 * 116 ******************************************************************************/ 117 118 acpi_status acpi_enable_gpe(acpi_handle gpe_device, u32 gpe_number) 119 { 120 acpi_status status = AE_BAD_PARAMETER; 121 struct acpi_gpe_event_info *gpe_event_info; 122 acpi_cpu_flags flags; 123 124 ACPI_FUNCTION_TRACE(acpi_enable_gpe); 125 126 flags = acpi_os_acquire_lock(acpi_gbl_gpe_lock); 127 128 /* Ensure that we have a valid GPE number */ 129 130 gpe_event_info = acpi_ev_get_gpe_event_info(gpe_device, gpe_number); 131 if (gpe_event_info) { 132 status = acpi_ev_add_gpe_reference(gpe_event_info); 133 } 134 135 acpi_os_release_lock(acpi_gbl_gpe_lock, flags); 136 return_ACPI_STATUS(status); 137 } 138 ACPI_EXPORT_SYMBOL(acpi_enable_gpe) 139 140 /******************************************************************************* 141 * 142 * FUNCTION: acpi_disable_gpe 143 * 144 * PARAMETERS: gpe_device - Parent GPE Device. NULL for GPE0/GPE1 145 * gpe_number - GPE level within the GPE block 146 * 147 * RETURN: Status 148 * 149 * DESCRIPTION: Remove a reference to a GPE. When the last reference is 150 * removed, only then is the GPE disabled (for runtime GPEs), or 151 * the GPE mask bit disabled (for wake GPEs) 152 * 153 ******************************************************************************/ 154 155 acpi_status acpi_disable_gpe(acpi_handle gpe_device, u32 gpe_number) 156 { 157 acpi_status status = AE_BAD_PARAMETER; 158 struct acpi_gpe_event_info *gpe_event_info; 159 acpi_cpu_flags flags; 160 161 ACPI_FUNCTION_TRACE(acpi_disable_gpe); 162 163 flags = acpi_os_acquire_lock(acpi_gbl_gpe_lock); 164 165 /* Ensure that we have a valid GPE number */ 166 167 gpe_event_info = acpi_ev_get_gpe_event_info(gpe_device, gpe_number); 168 if (gpe_event_info) { 169 status = acpi_ev_remove_gpe_reference(gpe_event_info) ; 170 } 171 172 acpi_os_release_lock(acpi_gbl_gpe_lock, flags); 173 return_ACPI_STATUS(status); 174 } 175 176 ACPI_EXPORT_SYMBOL(acpi_disable_gpe) 177 178 179 /******************************************************************************* 180 * 181 * FUNCTION: acpi_setup_gpe_for_wake 182 * 183 * PARAMETERS: wake_device - Device associated with the GPE (via _PRW) 184 * gpe_device - Parent GPE Device. NULL for GPE0/GPE1 185 * gpe_number - GPE level within the GPE block 186 * 187 * RETURN: Status 188 * 189 * DESCRIPTION: Mark a GPE as having the ability to wake the system. This 190 * interface is intended to be used as the host executes the 191 * _PRW methods (Power Resources for Wake) in the system tables. 192 * Each _PRW appears under a Device Object (The wake_device), and 193 * contains the info for the wake GPE associated with the 194 * wake_device. 195 * 196 ******************************************************************************/ 197 acpi_status 198 acpi_setup_gpe_for_wake(acpi_handle wake_device, 199 acpi_handle gpe_device, u32 gpe_number) 200 { 201 acpi_status status; 202 struct acpi_gpe_event_info *gpe_event_info; 203 struct acpi_namespace_node *device_node; 204 struct acpi_gpe_notify_info *notify; 205 struct acpi_gpe_notify_info *new_notify; 206 acpi_cpu_flags flags; 207 208 ACPI_FUNCTION_TRACE(acpi_setup_gpe_for_wake); 209 210 /* Parameter Validation */ 211 212 if (!wake_device) { 213 /* 214 * By forcing wake_device to be valid, we automatically enable the 215 * implicit notify feature on all hosts. 216 */ 217 return_ACPI_STATUS(AE_BAD_PARAMETER); 218 } 219 220 /* Handle root object case */ 221 222 if (wake_device == ACPI_ROOT_OBJECT) { 223 device_node = acpi_gbl_root_node; 224 } else { 225 device_node = 226 ACPI_CAST_PTR(struct acpi_namespace_node, wake_device); 227 } 228 229 /* Validate wake_device is of type Device */ 230 231 if (device_node->type != ACPI_TYPE_DEVICE) { 232 return_ACPI_STATUS (AE_BAD_PARAMETER); 233 } 234 235 /* 236 * Allocate a new notify object up front, in case it is needed. 237 * Memory allocation while holding a spinlock is a big no-no 238 * on some hosts. 239 */ 240 new_notify = ACPI_ALLOCATE_ZEROED(sizeof(struct acpi_gpe_notify_info)); 241 if (!new_notify) { 242 return_ACPI_STATUS(AE_NO_MEMORY); 243 } 244 245 flags = acpi_os_acquire_lock(acpi_gbl_gpe_lock); 246 247 /* Ensure that we have a valid GPE number */ 248 249 gpe_event_info = acpi_ev_get_gpe_event_info(gpe_device, gpe_number); 250 if (!gpe_event_info) { 251 status = AE_BAD_PARAMETER; 252 goto unlock_and_exit; 253 } 254 255 /* 256 * If there is no method or handler for this GPE, then the 257 * wake_device will be notified whenever this GPE fires. This is 258 * known as an "implicit notify". Note: The GPE is assumed to be 259 * level-triggered (for windows compatibility). 260 */ 261 if ((gpe_event_info->flags & ACPI_GPE_DISPATCH_MASK) == 262 ACPI_GPE_DISPATCH_NONE) { 263 /* 264 * This is the first device for implicit notify on this GPE. 265 * Just set the flags here, and enter the NOTIFY block below. 266 */ 267 gpe_event_info->flags = 268 (ACPI_GPE_DISPATCH_NOTIFY | ACPI_GPE_LEVEL_TRIGGERED); 269 } 270 271 /* 272 * If we already have an implicit notify on this GPE, add 273 * this device to the notify list. 274 */ 275 if ((gpe_event_info->flags & ACPI_GPE_DISPATCH_MASK) == 276 ACPI_GPE_DISPATCH_NOTIFY) { 277 278 /* Ensure that the device is not already in the list */ 279 280 notify = gpe_event_info->dispatch.notify_list; 281 while (notify) { 282 if (notify->device_node == device_node) { 283 status = AE_ALREADY_EXISTS; 284 goto unlock_and_exit; 285 } 286 notify = notify->next; 287 } 288 289 /* Add this device to the notify list for this GPE */ 290 291 new_notify->device_node = device_node; 292 new_notify->next = gpe_event_info->dispatch.notify_list; 293 gpe_event_info->dispatch.notify_list = new_notify; 294 new_notify = NULL; 295 } 296 297 /* Mark the GPE as a possible wake event */ 298 299 gpe_event_info->flags |= ACPI_GPE_CAN_WAKE; 300 status = AE_OK; 301 302 unlock_and_exit: 303 acpi_os_release_lock(acpi_gbl_gpe_lock, flags); 304 305 /* Delete the notify object if it was not used above */ 306 307 if (new_notify) { 308 ACPI_FREE(new_notify); 309 } 310 return_ACPI_STATUS(status); 311 } 312 ACPI_EXPORT_SYMBOL(acpi_setup_gpe_for_wake) 313 314 /******************************************************************************* 315 * 316 * FUNCTION: acpi_set_gpe_wake_mask 317 * 318 * PARAMETERS: gpe_device - Parent GPE Device. NULL for GPE0/GPE1 319 * gpe_number - GPE level within the GPE block 320 * action - Enable or Disable 321 * 322 * RETURN: Status 323 * 324 * DESCRIPTION: Set or clear the GPE's wakeup enable mask bit. The GPE must 325 * already be marked as a WAKE GPE. 326 * 327 ******************************************************************************/ 328 329 acpi_status 330 acpi_set_gpe_wake_mask(acpi_handle gpe_device, u32 gpe_number, u8 action) 331 { 332 acpi_status status = AE_OK; 333 struct acpi_gpe_event_info *gpe_event_info; 334 struct acpi_gpe_register_info *gpe_register_info; 335 acpi_cpu_flags flags; 336 u32 register_bit; 337 338 ACPI_FUNCTION_TRACE(acpi_set_gpe_wake_mask); 339 340 flags = acpi_os_acquire_lock(acpi_gbl_gpe_lock); 341 342 /* 343 * Ensure that we have a valid GPE number and that this GPE is in 344 * fact a wake GPE 345 */ 346 gpe_event_info = acpi_ev_get_gpe_event_info(gpe_device, gpe_number); 347 if (!gpe_event_info) { 348 status = AE_BAD_PARAMETER; 349 goto unlock_and_exit; 350 } 351 352 if (!(gpe_event_info->flags & ACPI_GPE_CAN_WAKE)) { 353 status = AE_TYPE; 354 goto unlock_and_exit; 355 } 356 357 gpe_register_info = gpe_event_info->register_info; 358 if (!gpe_register_info) { 359 status = AE_NOT_EXIST; 360 goto unlock_and_exit; 361 } 362 363 register_bit = acpi_hw_get_gpe_register_bit(gpe_event_info); 364 365 /* Perform the action */ 366 367 switch (action) { 368 case ACPI_GPE_ENABLE: 369 370 ACPI_SET_BIT(gpe_register_info->enable_for_wake, 371 (u8)register_bit); 372 break; 373 374 case ACPI_GPE_DISABLE: 375 376 ACPI_CLEAR_BIT(gpe_register_info->enable_for_wake, 377 (u8)register_bit); 378 break; 379 380 default: 381 382 ACPI_ERROR((AE_INFO, "%u, Invalid action", action)); 383 status = AE_BAD_PARAMETER; 384 break; 385 } 386 387 unlock_and_exit: 388 acpi_os_release_lock(acpi_gbl_gpe_lock, flags); 389 return_ACPI_STATUS(status); 390 } 391 392 ACPI_EXPORT_SYMBOL(acpi_set_gpe_wake_mask) 393 394 /******************************************************************************* 395 * 396 * FUNCTION: acpi_clear_gpe 397 * 398 * PARAMETERS: gpe_device - Parent GPE Device. NULL for GPE0/GPE1 399 * gpe_number - GPE level within the GPE block 400 * 401 * RETURN: Status 402 * 403 * DESCRIPTION: Clear an ACPI event (general purpose) 404 * 405 ******************************************************************************/ 406 acpi_status acpi_clear_gpe(acpi_handle gpe_device, u32 gpe_number) 407 { 408 acpi_status status = AE_OK; 409 struct acpi_gpe_event_info *gpe_event_info; 410 acpi_cpu_flags flags; 411 412 ACPI_FUNCTION_TRACE(acpi_clear_gpe); 413 414 flags = acpi_os_acquire_lock(acpi_gbl_gpe_lock); 415 416 /* Ensure that we have a valid GPE number */ 417 418 gpe_event_info = acpi_ev_get_gpe_event_info(gpe_device, gpe_number); 419 if (!gpe_event_info) { 420 status = AE_BAD_PARAMETER; 421 goto unlock_and_exit; 422 } 423 424 status = acpi_hw_clear_gpe(gpe_event_info); 425 426 unlock_and_exit: 427 acpi_os_release_lock(acpi_gbl_gpe_lock, flags); 428 return_ACPI_STATUS(status); 429 } 430 431 ACPI_EXPORT_SYMBOL(acpi_clear_gpe) 432 433 /******************************************************************************* 434 * 435 * FUNCTION: acpi_get_gpe_status 436 * 437 * PARAMETERS: gpe_device - Parent GPE Device. NULL for GPE0/GPE1 438 * gpe_number - GPE level within the GPE block 439 * event_status - Where the current status of the event 440 * will be returned 441 * 442 * RETURN: Status 443 * 444 * DESCRIPTION: Get the current status of a GPE (signalled/not_signalled) 445 * 446 ******************************************************************************/ 447 acpi_status 448 acpi_get_gpe_status(acpi_handle gpe_device, 449 u32 gpe_number, acpi_event_status *event_status) 450 { 451 acpi_status status = AE_OK; 452 struct acpi_gpe_event_info *gpe_event_info; 453 acpi_cpu_flags flags; 454 455 ACPI_FUNCTION_TRACE(acpi_get_gpe_status); 456 457 flags = acpi_os_acquire_lock(acpi_gbl_gpe_lock); 458 459 /* Ensure that we have a valid GPE number */ 460 461 gpe_event_info = acpi_ev_get_gpe_event_info(gpe_device, gpe_number); 462 if (!gpe_event_info) { 463 status = AE_BAD_PARAMETER; 464 goto unlock_and_exit; 465 } 466 467 /* Obtain status on the requested GPE number */ 468 469 status = acpi_hw_get_gpe_status(gpe_event_info, event_status); 470 471 if (gpe_event_info->flags & ACPI_GPE_DISPATCH_MASK) 472 *event_status |= ACPI_EVENT_FLAG_HANDLE; 473 474 unlock_and_exit: 475 acpi_os_release_lock(acpi_gbl_gpe_lock, flags); 476 return_ACPI_STATUS(status); 477 } 478 479 ACPI_EXPORT_SYMBOL(acpi_get_gpe_status) 480 481 /****************************************************************************** 482 * 483 * FUNCTION: acpi_disable_all_gpes 484 * 485 * PARAMETERS: None 486 * 487 * RETURN: Status 488 * 489 * DESCRIPTION: Disable and clear all GPEs in all GPE blocks 490 * 491 ******************************************************************************/ 492 493 acpi_status acpi_disable_all_gpes(void) 494 { 495 acpi_status status; 496 497 ACPI_FUNCTION_TRACE(acpi_disable_all_gpes); 498 499 status = acpi_ut_acquire_mutex(ACPI_MTX_EVENTS); 500 if (ACPI_FAILURE(status)) { 501 return_ACPI_STATUS(status); 502 } 503 504 status = acpi_hw_disable_all_gpes(); 505 (void)acpi_ut_release_mutex(ACPI_MTX_EVENTS); 506 507 return_ACPI_STATUS(status); 508 } 509 510 ACPI_EXPORT_SYMBOL(acpi_disable_all_gpes) 511 512 /****************************************************************************** 513 * 514 * FUNCTION: acpi_enable_all_runtime_gpes 515 * 516 * PARAMETERS: None 517 * 518 * RETURN: Status 519 * 520 * DESCRIPTION: Enable all "runtime" GPEs, in all GPE blocks 521 * 522 ******************************************************************************/ 523 524 acpi_status acpi_enable_all_runtime_gpes(void) 525 { 526 acpi_status status; 527 528 ACPI_FUNCTION_TRACE(acpi_enable_all_runtime_gpes); 529 530 status = acpi_ut_acquire_mutex(ACPI_MTX_EVENTS); 531 if (ACPI_FAILURE(status)) { 532 return_ACPI_STATUS(status); 533 } 534 535 status = acpi_hw_enable_all_runtime_gpes(); 536 (void)acpi_ut_release_mutex(ACPI_MTX_EVENTS); 537 538 return_ACPI_STATUS(status); 539 } 540 541 ACPI_EXPORT_SYMBOL(acpi_enable_all_runtime_gpes) 542 543 /******************************************************************************* 544 * 545 * FUNCTION: acpi_install_gpe_block 546 * 547 * PARAMETERS: gpe_device - Handle to the parent GPE Block Device 548 * gpe_block_address - Address and space_ID 549 * register_count - Number of GPE register pairs in the block 550 * interrupt_number - H/W interrupt for the block 551 * 552 * RETURN: Status 553 * 554 * DESCRIPTION: Create and Install a block of GPE registers. The GPEs are not 555 * enabled here. 556 * 557 ******************************************************************************/ 558 acpi_status 559 acpi_install_gpe_block(acpi_handle gpe_device, 560 struct acpi_generic_address *gpe_block_address, 561 u32 register_count, u32 interrupt_number) 562 { 563 acpi_status status; 564 union acpi_operand_object *obj_desc; 565 struct acpi_namespace_node *node; 566 struct acpi_gpe_block_info *gpe_block; 567 568 ACPI_FUNCTION_TRACE(acpi_install_gpe_block); 569 570 if ((!gpe_device) || (!gpe_block_address) || (!register_count)) { 571 return_ACPI_STATUS(AE_BAD_PARAMETER); 572 } 573 574 status = acpi_ut_acquire_mutex(ACPI_MTX_NAMESPACE); 575 if (ACPI_FAILURE(status)) { 576 return_ACPI_STATUS(status); 577 } 578 579 node = acpi_ns_validate_handle(gpe_device); 580 if (!node) { 581 status = AE_BAD_PARAMETER; 582 goto unlock_and_exit; 583 } 584 585 /* 586 * For user-installed GPE Block Devices, the gpe_block_base_number 587 * is always zero 588 */ 589 status = 590 acpi_ev_create_gpe_block(node, gpe_block_address, register_count, 0, 591 interrupt_number, &gpe_block); 592 if (ACPI_FAILURE(status)) { 593 goto unlock_and_exit; 594 } 595 596 /* Install block in the device_object attached to the node */ 597 598 obj_desc = acpi_ns_get_attached_object(node); 599 if (!obj_desc) { 600 601 /* 602 * No object, create a new one (Device nodes do not always have 603 * an attached object) 604 */ 605 obj_desc = acpi_ut_create_internal_object(ACPI_TYPE_DEVICE); 606 if (!obj_desc) { 607 status = AE_NO_MEMORY; 608 goto unlock_and_exit; 609 } 610 611 status = 612 acpi_ns_attach_object(node, obj_desc, ACPI_TYPE_DEVICE); 613 614 /* Remove local reference to the object */ 615 616 acpi_ut_remove_reference(obj_desc); 617 618 if (ACPI_FAILURE(status)) { 619 goto unlock_and_exit; 620 } 621 } 622 623 /* Now install the GPE block in the device_object */ 624 625 obj_desc->device.gpe_block = gpe_block; 626 627 unlock_and_exit: 628 (void)acpi_ut_release_mutex(ACPI_MTX_NAMESPACE); 629 return_ACPI_STATUS(status); 630 } 631 632 ACPI_EXPORT_SYMBOL(acpi_install_gpe_block) 633 634 /******************************************************************************* 635 * 636 * FUNCTION: acpi_remove_gpe_block 637 * 638 * PARAMETERS: gpe_device - Handle to the parent GPE Block Device 639 * 640 * RETURN: Status 641 * 642 * DESCRIPTION: Remove a previously installed block of GPE registers 643 * 644 ******************************************************************************/ 645 acpi_status acpi_remove_gpe_block(acpi_handle gpe_device) 646 { 647 union acpi_operand_object *obj_desc; 648 acpi_status status; 649 struct acpi_namespace_node *node; 650 651 ACPI_FUNCTION_TRACE(acpi_remove_gpe_block); 652 653 if (!gpe_device) { 654 return_ACPI_STATUS(AE_BAD_PARAMETER); 655 } 656 657 status = acpi_ut_acquire_mutex(ACPI_MTX_NAMESPACE); 658 if (ACPI_FAILURE(status)) { 659 return_ACPI_STATUS(status); 660 } 661 662 node = acpi_ns_validate_handle(gpe_device); 663 if (!node) { 664 status = AE_BAD_PARAMETER; 665 goto unlock_and_exit; 666 } 667 668 /* Get the device_object attached to the node */ 669 670 obj_desc = acpi_ns_get_attached_object(node); 671 if (!obj_desc || !obj_desc->device.gpe_block) { 672 return_ACPI_STATUS(AE_NULL_OBJECT); 673 } 674 675 /* Delete the GPE block (but not the device_object) */ 676 677 status = acpi_ev_delete_gpe_block(obj_desc->device.gpe_block); 678 if (ACPI_SUCCESS(status)) { 679 obj_desc->device.gpe_block = NULL; 680 } 681 682 unlock_and_exit: 683 (void)acpi_ut_release_mutex(ACPI_MTX_NAMESPACE); 684 return_ACPI_STATUS(status); 685 } 686 687 ACPI_EXPORT_SYMBOL(acpi_remove_gpe_block) 688 689 /******************************************************************************* 690 * 691 * FUNCTION: acpi_get_gpe_device 692 * 693 * PARAMETERS: index - System GPE index (0-current_gpe_count) 694 * gpe_device - Where the parent GPE Device is returned 695 * 696 * RETURN: Status 697 * 698 * DESCRIPTION: Obtain the GPE device associated with the input index. A NULL 699 * gpe device indicates that the gpe number is contained in one of 700 * the FADT-defined gpe blocks. Otherwise, the GPE block device. 701 * 702 ******************************************************************************/ 703 acpi_status acpi_get_gpe_device(u32 index, acpi_handle * gpe_device) 704 { 705 struct acpi_gpe_device_info info; 706 acpi_status status; 707 708 ACPI_FUNCTION_TRACE(acpi_get_gpe_device); 709 710 if (!gpe_device) { 711 return_ACPI_STATUS(AE_BAD_PARAMETER); 712 } 713 714 if (index >= acpi_current_gpe_count) { 715 return_ACPI_STATUS(AE_NOT_EXIST); 716 } 717 718 /* Setup and walk the GPE list */ 719 720 info.index = index; 721 info.status = AE_NOT_EXIST; 722 info.gpe_device = NULL; 723 info.next_block_base_index = 0; 724 725 status = acpi_ev_walk_gpe_list(acpi_ev_get_gpe_device, &info); 726 if (ACPI_FAILURE(status)) { 727 return_ACPI_STATUS(status); 728 } 729 730 *gpe_device = ACPI_CAST_PTR(acpi_handle, info.gpe_device); 731 return_ACPI_STATUS(info.status); 732 } 733 734 ACPI_EXPORT_SYMBOL(acpi_get_gpe_device) 735 #endif /* !ACPI_REDUCED_HARDWARE */ 736