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