1 // SPDX-License-Identifier: BSD-3-Clause OR GPL-2.0 2 /****************************************************************************** 3 * 4 * Module Name: evgpe - General Purpose Event handling and dispatch 5 * 6 * Copyright (C) 2000 - 2020, Intel Corp. 7 * 8 *****************************************************************************/ 9 10 #include <acpi/acpi.h> 11 #include "accommon.h" 12 #include "acevents.h" 13 #include "acnamesp.h" 14 15 #define _COMPONENT ACPI_EVENTS 16 ACPI_MODULE_NAME("evgpe") 17 #if (!ACPI_REDUCED_HARDWARE) /* Entire module */ 18 /* Local prototypes */ 19 static void ACPI_SYSTEM_XFACE acpi_ev_asynch_execute_gpe_method(void *context); 20 21 static void ACPI_SYSTEM_XFACE acpi_ev_asynch_enable_gpe(void *context); 22 23 /******************************************************************************* 24 * 25 * FUNCTION: acpi_ev_update_gpe_enable_mask 26 * 27 * PARAMETERS: gpe_event_info - GPE to update 28 * 29 * RETURN: Status 30 * 31 * DESCRIPTION: Updates GPE register enable mask based upon whether there are 32 * runtime references to this GPE 33 * 34 ******************************************************************************/ 35 36 acpi_status 37 acpi_ev_update_gpe_enable_mask(struct acpi_gpe_event_info *gpe_event_info) 38 { 39 struct acpi_gpe_register_info *gpe_register_info; 40 u32 register_bit; 41 42 ACPI_FUNCTION_TRACE(ev_update_gpe_enable_mask); 43 44 gpe_register_info = gpe_event_info->register_info; 45 if (!gpe_register_info) { 46 return_ACPI_STATUS(AE_NOT_EXIST); 47 } 48 49 register_bit = acpi_hw_get_gpe_register_bit(gpe_event_info); 50 51 /* Clear the run bit up front */ 52 53 ACPI_CLEAR_BIT(gpe_register_info->enable_for_run, register_bit); 54 55 /* Set the mask bit only if there are references to this GPE */ 56 57 if (gpe_event_info->runtime_count) { 58 ACPI_SET_BIT(gpe_register_info->enable_for_run, 59 (u8)register_bit); 60 } 61 62 gpe_register_info->enable_mask = gpe_register_info->enable_for_run; 63 return_ACPI_STATUS(AE_OK); 64 } 65 66 /******************************************************************************* 67 * 68 * FUNCTION: acpi_ev_enable_gpe 69 * 70 * PARAMETERS: gpe_event_info - GPE to enable 71 * 72 * RETURN: Status 73 * 74 * DESCRIPTION: Enable a GPE. 75 * 76 ******************************************************************************/ 77 78 acpi_status acpi_ev_enable_gpe(struct acpi_gpe_event_info *gpe_event_info) 79 { 80 acpi_status status; 81 82 ACPI_FUNCTION_TRACE(ev_enable_gpe); 83 84 /* Enable the requested GPE */ 85 86 status = acpi_hw_low_set_gpe(gpe_event_info, ACPI_GPE_ENABLE); 87 return_ACPI_STATUS(status); 88 } 89 90 /******************************************************************************* 91 * 92 * FUNCTION: acpi_ev_mask_gpe 93 * 94 * PARAMETERS: gpe_event_info - GPE to be blocked/unblocked 95 * is_masked - Whether the GPE is masked or not 96 * 97 * RETURN: Status 98 * 99 * DESCRIPTION: Unconditionally mask/unmask a GPE during runtime. 100 * 101 ******************************************************************************/ 102 103 acpi_status 104 acpi_ev_mask_gpe(struct acpi_gpe_event_info *gpe_event_info, u8 is_masked) 105 { 106 struct acpi_gpe_register_info *gpe_register_info; 107 u32 register_bit; 108 109 ACPI_FUNCTION_TRACE(ev_mask_gpe); 110 111 gpe_register_info = gpe_event_info->register_info; 112 if (!gpe_register_info) { 113 return_ACPI_STATUS(AE_NOT_EXIST); 114 } 115 116 register_bit = acpi_hw_get_gpe_register_bit(gpe_event_info); 117 118 /* Perform the action */ 119 120 if (is_masked) { 121 if (register_bit & gpe_register_info->mask_for_run) { 122 return_ACPI_STATUS(AE_BAD_PARAMETER); 123 } 124 125 (void)acpi_hw_low_set_gpe(gpe_event_info, ACPI_GPE_DISABLE); 126 ACPI_SET_BIT(gpe_register_info->mask_for_run, (u8)register_bit); 127 } else { 128 if (!(register_bit & gpe_register_info->mask_for_run)) { 129 return_ACPI_STATUS(AE_BAD_PARAMETER); 130 } 131 132 ACPI_CLEAR_BIT(gpe_register_info->mask_for_run, 133 (u8)register_bit); 134 if (gpe_event_info->runtime_count 135 && !gpe_event_info->disable_for_dispatch) { 136 (void)acpi_hw_low_set_gpe(gpe_event_info, 137 ACPI_GPE_ENABLE); 138 } 139 } 140 141 return_ACPI_STATUS(AE_OK); 142 } 143 144 /******************************************************************************* 145 * 146 * FUNCTION: acpi_ev_add_gpe_reference 147 * 148 * PARAMETERS: gpe_event_info - Add a reference to this GPE 149 * clear_on_enable - Clear GPE status before enabling it 150 * 151 * RETURN: Status 152 * 153 * DESCRIPTION: Add a reference to a GPE. On the first reference, the GPE is 154 * hardware-enabled. 155 * 156 ******************************************************************************/ 157 158 acpi_status 159 acpi_ev_add_gpe_reference(struct acpi_gpe_event_info *gpe_event_info, 160 u8 clear_on_enable) 161 { 162 acpi_status status = AE_OK; 163 164 ACPI_FUNCTION_TRACE(ev_add_gpe_reference); 165 166 if (gpe_event_info->runtime_count == ACPI_UINT8_MAX) { 167 return_ACPI_STATUS(AE_LIMIT); 168 } 169 170 gpe_event_info->runtime_count++; 171 if (gpe_event_info->runtime_count == 1) { 172 173 /* Enable on first reference */ 174 175 if (clear_on_enable) { 176 (void)acpi_hw_clear_gpe(gpe_event_info); 177 } 178 179 status = acpi_ev_update_gpe_enable_mask(gpe_event_info); 180 if (ACPI_SUCCESS(status)) { 181 status = acpi_ev_enable_gpe(gpe_event_info); 182 } 183 184 if (ACPI_FAILURE(status)) { 185 gpe_event_info->runtime_count--; 186 } 187 } 188 189 return_ACPI_STATUS(status); 190 } 191 192 /******************************************************************************* 193 * 194 * FUNCTION: acpi_ev_remove_gpe_reference 195 * 196 * PARAMETERS: gpe_event_info - Remove a reference to this GPE 197 * 198 * RETURN: Status 199 * 200 * DESCRIPTION: Remove a reference to a GPE. When the last reference is 201 * removed, the GPE is hardware-disabled. 202 * 203 ******************************************************************************/ 204 205 acpi_status 206 acpi_ev_remove_gpe_reference(struct acpi_gpe_event_info *gpe_event_info) 207 { 208 acpi_status status = AE_OK; 209 210 ACPI_FUNCTION_TRACE(ev_remove_gpe_reference); 211 212 if (!gpe_event_info->runtime_count) { 213 return_ACPI_STATUS(AE_LIMIT); 214 } 215 216 gpe_event_info->runtime_count--; 217 if (!gpe_event_info->runtime_count) { 218 219 /* Disable on last reference */ 220 221 status = acpi_ev_update_gpe_enable_mask(gpe_event_info); 222 if (ACPI_SUCCESS(status)) { 223 status = 224 acpi_hw_low_set_gpe(gpe_event_info, 225 ACPI_GPE_DISABLE); 226 } 227 228 if (ACPI_FAILURE(status)) { 229 gpe_event_info->runtime_count++; 230 } 231 } 232 233 return_ACPI_STATUS(status); 234 } 235 236 /******************************************************************************* 237 * 238 * FUNCTION: acpi_ev_low_get_gpe_info 239 * 240 * PARAMETERS: gpe_number - Raw GPE number 241 * gpe_block - A GPE info block 242 * 243 * RETURN: A GPE event_info struct. NULL if not a valid GPE (The gpe_number 244 * is not within the specified GPE block) 245 * 246 * DESCRIPTION: Returns the event_info struct associated with this GPE. This is 247 * the low-level implementation of ev_get_gpe_event_info. 248 * 249 ******************************************************************************/ 250 251 struct acpi_gpe_event_info *acpi_ev_low_get_gpe_info(u32 gpe_number, 252 struct acpi_gpe_block_info 253 *gpe_block) 254 { 255 u32 gpe_index; 256 257 /* 258 * Validate that the gpe_number is within the specified gpe_block. 259 * (Two steps) 260 */ 261 if (!gpe_block || (gpe_number < gpe_block->block_base_number)) { 262 return (NULL); 263 } 264 265 gpe_index = gpe_number - gpe_block->block_base_number; 266 if (gpe_index >= gpe_block->gpe_count) { 267 return (NULL); 268 } 269 270 return (&gpe_block->event_info[gpe_index]); 271 } 272 273 274 /******************************************************************************* 275 * 276 * FUNCTION: acpi_ev_get_gpe_event_info 277 * 278 * PARAMETERS: gpe_device - Device node. NULL for GPE0/GPE1 279 * gpe_number - Raw GPE number 280 * 281 * RETURN: A GPE event_info struct. NULL if not a valid GPE 282 * 283 * DESCRIPTION: Returns the event_info struct associated with this GPE. 284 * Validates the gpe_block and the gpe_number 285 * 286 * Should be called only when the GPE lists are semaphore locked 287 * and not subject to change. 288 * 289 ******************************************************************************/ 290 291 struct acpi_gpe_event_info *acpi_ev_get_gpe_event_info(acpi_handle gpe_device, 292 u32 gpe_number) 293 { 294 union acpi_operand_object *obj_desc; 295 struct acpi_gpe_event_info *gpe_info; 296 u32 i; 297 298 ACPI_FUNCTION_ENTRY(); 299 300 /* A NULL gpe_device means use the FADT-defined GPE block(s) */ 301 302 if (!gpe_device) { 303 304 /* Examine GPE Block 0 and 1 (These blocks are permanent) */ 305 306 for (i = 0; i < ACPI_MAX_GPE_BLOCKS; i++) { 307 gpe_info = acpi_ev_low_get_gpe_info(gpe_number, 308 acpi_gbl_gpe_fadt_blocks 309 [i]); 310 if (gpe_info) { 311 return (gpe_info); 312 } 313 } 314 315 /* The gpe_number was not in the range of either FADT GPE block */ 316 317 return (NULL); 318 } 319 320 /* A Non-NULL gpe_device means this is a GPE Block Device */ 321 322 obj_desc = 323 acpi_ns_get_attached_object((struct acpi_namespace_node *) 324 gpe_device); 325 if (!obj_desc || !obj_desc->device.gpe_block) { 326 return (NULL); 327 } 328 329 return (acpi_ev_low_get_gpe_info 330 (gpe_number, obj_desc->device.gpe_block)); 331 } 332 333 /******************************************************************************* 334 * 335 * FUNCTION: acpi_ev_gpe_detect 336 * 337 * PARAMETERS: gpe_xrupt_list - Interrupt block for this interrupt. 338 * Can have multiple GPE blocks attached. 339 * 340 * RETURN: INTERRUPT_HANDLED or INTERRUPT_NOT_HANDLED 341 * 342 * DESCRIPTION: Detect if any GP events have occurred. This function is 343 * executed at interrupt level. 344 * 345 ******************************************************************************/ 346 347 u32 acpi_ev_gpe_detect(struct acpi_gpe_xrupt_info *gpe_xrupt_list) 348 { 349 struct acpi_gpe_block_info *gpe_block; 350 struct acpi_namespace_node *gpe_device; 351 struct acpi_gpe_register_info *gpe_register_info; 352 struct acpi_gpe_event_info *gpe_event_info; 353 u32 gpe_number; 354 u32 int_status = ACPI_INTERRUPT_NOT_HANDLED; 355 acpi_cpu_flags flags; 356 u32 i; 357 u32 j; 358 359 ACPI_FUNCTION_NAME(ev_gpe_detect); 360 361 /* Check for the case where there are no GPEs */ 362 363 if (!gpe_xrupt_list) { 364 return (int_status); 365 } 366 367 /* 368 * We need to obtain the GPE lock for both the data structs and registers 369 * Note: Not necessary to obtain the hardware lock, since the GPE 370 * registers are owned by the gpe_lock. 371 */ 372 flags = acpi_os_acquire_lock(acpi_gbl_gpe_lock); 373 374 /* Examine all GPE blocks attached to this interrupt level */ 375 376 gpe_block = gpe_xrupt_list->gpe_block_list_head; 377 while (gpe_block) { 378 gpe_device = gpe_block->node; 379 380 /* 381 * Read all of the 8-bit GPE status and enable registers in this GPE 382 * block, saving all of them. Find all currently active GP events. 383 */ 384 for (i = 0; i < gpe_block->register_count; i++) { 385 386 /* Get the next status/enable pair */ 387 388 gpe_register_info = &gpe_block->register_info[i]; 389 390 /* 391 * Optimization: If there are no GPEs enabled within this 392 * register, we can safely ignore the entire register. 393 */ 394 if (!(gpe_register_info->enable_for_run | 395 gpe_register_info->enable_for_wake)) { 396 ACPI_DEBUG_PRINT((ACPI_DB_INTERRUPTS, 397 "Ignore disabled registers for GPE %02X-%02X: " 398 "RunEnable=%02X, WakeEnable=%02X\n", 399 gpe_register_info-> 400 base_gpe_number, 401 gpe_register_info-> 402 base_gpe_number + 403 (ACPI_GPE_REGISTER_WIDTH - 1), 404 gpe_register_info-> 405 enable_for_run, 406 gpe_register_info-> 407 enable_for_wake)); 408 continue; 409 } 410 411 /* Now look at the individual GPEs in this byte register */ 412 413 for (j = 0; j < ACPI_GPE_REGISTER_WIDTH; j++) { 414 415 /* Detect and dispatch one GPE bit */ 416 417 gpe_event_info = 418 &gpe_block-> 419 event_info[((acpi_size)i * 420 ACPI_GPE_REGISTER_WIDTH) + j]; 421 gpe_number = 422 j + gpe_register_info->base_gpe_number; 423 acpi_os_release_lock(acpi_gbl_gpe_lock, flags); 424 int_status |= 425 acpi_ev_detect_gpe(gpe_device, 426 gpe_event_info, 427 gpe_number); 428 flags = acpi_os_acquire_lock(acpi_gbl_gpe_lock); 429 } 430 } 431 432 gpe_block = gpe_block->next; 433 } 434 435 acpi_os_release_lock(acpi_gbl_gpe_lock, flags); 436 return (int_status); 437 } 438 439 /******************************************************************************* 440 * 441 * FUNCTION: acpi_ev_asynch_execute_gpe_method 442 * 443 * PARAMETERS: Context (gpe_event_info) - Info for this GPE 444 * 445 * RETURN: None 446 * 447 * DESCRIPTION: Perform the actual execution of a GPE control method. This 448 * function is called from an invocation of acpi_os_execute and 449 * therefore does NOT execute at interrupt level - so that 450 * the control method itself is not executed in the context of 451 * an interrupt handler. 452 * 453 ******************************************************************************/ 454 455 static void ACPI_SYSTEM_XFACE acpi_ev_asynch_execute_gpe_method(void *context) 456 { 457 struct acpi_gpe_event_info *gpe_event_info = context; 458 acpi_status status = AE_OK; 459 struct acpi_evaluate_info *info; 460 struct acpi_gpe_notify_info *notify; 461 462 ACPI_FUNCTION_TRACE(ev_asynch_execute_gpe_method); 463 464 /* Do the correct dispatch - normal method or implicit notify */ 465 466 switch (ACPI_GPE_DISPATCH_TYPE(gpe_event_info->flags)) { 467 case ACPI_GPE_DISPATCH_NOTIFY: 468 /* 469 * Implicit notify. 470 * Dispatch a DEVICE_WAKE notify to the appropriate handler. 471 * NOTE: the request is queued for execution after this method 472 * completes. The notify handlers are NOT invoked synchronously 473 * from this thread -- because handlers may in turn run other 474 * control methods. 475 * 476 * June 2012: Expand implicit notify mechanism to support 477 * notifies on multiple device objects. 478 */ 479 notify = gpe_event_info->dispatch.notify_list; 480 while (ACPI_SUCCESS(status) && notify) { 481 status = 482 acpi_ev_queue_notify_request(notify->device_node, 483 ACPI_NOTIFY_DEVICE_WAKE); 484 485 notify = notify->next; 486 } 487 488 break; 489 490 case ACPI_GPE_DISPATCH_METHOD: 491 492 /* Allocate the evaluation information block */ 493 494 info = ACPI_ALLOCATE_ZEROED(sizeof(struct acpi_evaluate_info)); 495 if (!info) { 496 status = AE_NO_MEMORY; 497 } else { 498 /* 499 * Invoke the GPE Method (_Lxx, _Exx) i.e., evaluate the 500 * _Lxx/_Exx control method that corresponds to this GPE 501 */ 502 info->prefix_node = 503 gpe_event_info->dispatch.method_node; 504 info->flags = ACPI_IGNORE_RETURN_VALUE; 505 506 status = acpi_ns_evaluate(info); 507 ACPI_FREE(info); 508 } 509 510 if (ACPI_FAILURE(status)) { 511 ACPI_EXCEPTION((AE_INFO, status, 512 "while evaluating GPE method [%4.4s]", 513 acpi_ut_get_node_name(gpe_event_info-> 514 dispatch. 515 method_node))); 516 } 517 break; 518 519 default: 520 521 goto error_exit; /* Should never happen */ 522 } 523 524 /* Defer enabling of GPE until all notify handlers are done */ 525 526 status = acpi_os_execute(OSL_NOTIFY_HANDLER, 527 acpi_ev_asynch_enable_gpe, gpe_event_info); 528 if (ACPI_SUCCESS(status)) { 529 return_VOID; 530 } 531 532 error_exit: 533 acpi_ev_asynch_enable_gpe(gpe_event_info); 534 return_VOID; 535 } 536 537 538 /******************************************************************************* 539 * 540 * FUNCTION: acpi_ev_asynch_enable_gpe 541 * 542 * PARAMETERS: Context (gpe_event_info) - Info for this GPE 543 * Callback from acpi_os_execute 544 * 545 * RETURN: None 546 * 547 * DESCRIPTION: Asynchronous clear/enable for GPE. This allows the GPE to 548 * complete (i.e., finish execution of Notify) 549 * 550 ******************************************************************************/ 551 552 static void ACPI_SYSTEM_XFACE acpi_ev_asynch_enable_gpe(void *context) 553 { 554 struct acpi_gpe_event_info *gpe_event_info = context; 555 acpi_cpu_flags flags; 556 557 flags = acpi_os_acquire_lock(acpi_gbl_gpe_lock); 558 (void)acpi_ev_finish_gpe(gpe_event_info); 559 acpi_os_release_lock(acpi_gbl_gpe_lock, flags); 560 561 return; 562 } 563 564 565 /******************************************************************************* 566 * 567 * FUNCTION: acpi_ev_finish_gpe 568 * 569 * PARAMETERS: gpe_event_info - Info for this GPE 570 * 571 * RETURN: Status 572 * 573 * DESCRIPTION: Clear/Enable a GPE. Common code that is used after execution 574 * of a GPE method or a synchronous or asynchronous GPE handler. 575 * 576 ******************************************************************************/ 577 578 acpi_status acpi_ev_finish_gpe(struct acpi_gpe_event_info *gpe_event_info) 579 { 580 acpi_status status; 581 582 if ((gpe_event_info->flags & ACPI_GPE_XRUPT_TYPE_MASK) == 583 ACPI_GPE_LEVEL_TRIGGERED) { 584 /* 585 * GPE is level-triggered, we clear the GPE status bit after 586 * handling the event. 587 */ 588 status = acpi_hw_clear_gpe(gpe_event_info); 589 if (ACPI_FAILURE(status)) { 590 return (status); 591 } 592 } 593 594 /* 595 * Enable this GPE, conditionally. This means that the GPE will 596 * only be physically enabled if the enable_mask bit is set 597 * in the event_info. 598 */ 599 (void)acpi_hw_low_set_gpe(gpe_event_info, ACPI_GPE_CONDITIONAL_ENABLE); 600 gpe_event_info->disable_for_dispatch = FALSE; 601 return (AE_OK); 602 } 603 604 605 /******************************************************************************* 606 * 607 * FUNCTION: acpi_ev_detect_gpe 608 * 609 * PARAMETERS: gpe_device - Device node. NULL for GPE0/GPE1 610 * gpe_event_info - Info for this GPE 611 * gpe_number - Number relative to the parent GPE block 612 * 613 * RETURN: INTERRUPT_HANDLED or INTERRUPT_NOT_HANDLED 614 * 615 * DESCRIPTION: Detect and dispatch a General Purpose Event to either a function 616 * (e.g. EC) or method (e.g. _Lxx/_Exx) handler. 617 * NOTE: GPE is W1C, so it is possible to handle a single GPE from both 618 * task and irq context in parallel as long as the process to 619 * detect and mask the GPE is atomic. 620 * However the atomicity of ACPI_GPE_DISPATCH_RAW_HANDLER is 621 * dependent on the raw handler itself. 622 * 623 ******************************************************************************/ 624 625 u32 626 acpi_ev_detect_gpe(struct acpi_namespace_node *gpe_device, 627 struct acpi_gpe_event_info *gpe_event_info, u32 gpe_number) 628 { 629 u32 int_status = ACPI_INTERRUPT_NOT_HANDLED; 630 u8 enabled_status_byte; 631 u64 status_reg; 632 u64 enable_reg; 633 u32 register_bit; 634 struct acpi_gpe_register_info *gpe_register_info; 635 struct acpi_gpe_handler_info *gpe_handler_info; 636 acpi_cpu_flags flags; 637 acpi_status status; 638 639 ACPI_FUNCTION_TRACE(ev_gpe_detect); 640 641 flags = acpi_os_acquire_lock(acpi_gbl_gpe_lock); 642 643 if (!gpe_event_info) { 644 gpe_event_info = acpi_ev_get_gpe_event_info(gpe_device, gpe_number); 645 if (!gpe_event_info) 646 goto error_exit; 647 } 648 649 /* Get the info block for the entire GPE register */ 650 651 gpe_register_info = gpe_event_info->register_info; 652 653 /* Get the register bitmask for this GPE */ 654 655 register_bit = acpi_hw_get_gpe_register_bit(gpe_event_info); 656 657 /* GPE currently enabled (enable bit == 1)? */ 658 659 status = acpi_hw_read(&enable_reg, &gpe_register_info->enable_address); 660 if (ACPI_FAILURE(status)) { 661 goto error_exit; 662 } 663 664 /* GPE currently active (status bit == 1)? */ 665 666 status = acpi_hw_read(&status_reg, &gpe_register_info->status_address); 667 if (ACPI_FAILURE(status)) { 668 goto error_exit; 669 } 670 671 /* Check if there is anything active at all in this GPE */ 672 673 ACPI_DEBUG_PRINT((ACPI_DB_INTERRUPTS, 674 "Read registers for GPE %02X: Status=%02X, Enable=%02X, " 675 "RunEnable=%02X, WakeEnable=%02X\n", 676 gpe_number, 677 (u32)(status_reg & register_bit), 678 (u32)(enable_reg & register_bit), 679 gpe_register_info->enable_for_run, 680 gpe_register_info->enable_for_wake)); 681 682 enabled_status_byte = (u8)(status_reg & enable_reg); 683 if (!(enabled_status_byte & register_bit)) { 684 goto error_exit; 685 } 686 687 /* Invoke global event handler if present */ 688 689 acpi_gpe_count++; 690 if (acpi_gbl_global_event_handler) { 691 acpi_gbl_global_event_handler(ACPI_EVENT_TYPE_GPE, 692 gpe_device, gpe_number, 693 acpi_gbl_global_event_handler_context); 694 } 695 696 /* Found an active GPE */ 697 698 if (ACPI_GPE_DISPATCH_TYPE(gpe_event_info->flags) == 699 ACPI_GPE_DISPATCH_RAW_HANDLER) { 700 701 /* Dispatch the event to a raw handler */ 702 703 gpe_handler_info = gpe_event_info->dispatch.handler; 704 705 /* 706 * There is no protection around the namespace node 707 * and the GPE handler to ensure a safe destruction 708 * because: 709 * 1. The namespace node is expected to always 710 * exist after loading a table. 711 * 2. The GPE handler is expected to be flushed by 712 * acpi_os_wait_events_complete() before the 713 * destruction. 714 */ 715 acpi_os_release_lock(acpi_gbl_gpe_lock, flags); 716 int_status |= 717 gpe_handler_info->address(gpe_device, gpe_number, 718 gpe_handler_info->context); 719 flags = acpi_os_acquire_lock(acpi_gbl_gpe_lock); 720 } else { 721 /* Dispatch the event to a standard handler or method. */ 722 723 int_status |= acpi_ev_gpe_dispatch(gpe_device, 724 gpe_event_info, gpe_number); 725 } 726 727 error_exit: 728 acpi_os_release_lock(acpi_gbl_gpe_lock, flags); 729 return (int_status); 730 } 731 732 /******************************************************************************* 733 * 734 * FUNCTION: acpi_ev_gpe_dispatch 735 * 736 * PARAMETERS: gpe_device - Device node. NULL for GPE0/GPE1 737 * gpe_event_info - Info for this GPE 738 * gpe_number - Number relative to the parent GPE block 739 * 740 * RETURN: INTERRUPT_HANDLED or INTERRUPT_NOT_HANDLED 741 * 742 * DESCRIPTION: Dispatch a General Purpose Event to either a function (e.g. EC) 743 * or method (e.g. _Lxx/_Exx) handler. 744 * 745 ******************************************************************************/ 746 747 u32 748 acpi_ev_gpe_dispatch(struct acpi_namespace_node *gpe_device, 749 struct acpi_gpe_event_info *gpe_event_info, u32 gpe_number) 750 { 751 acpi_status status; 752 u32 return_value; 753 754 ACPI_FUNCTION_TRACE(ev_gpe_dispatch); 755 756 /* 757 * Always disable the GPE so that it does not keep firing before 758 * any asynchronous activity completes (either from the execution 759 * of a GPE method or an asynchronous GPE handler.) 760 * 761 * If there is no handler or method to run, just disable the 762 * GPE and leave it disabled permanently to prevent further such 763 * pointless events from firing. 764 */ 765 status = acpi_hw_low_set_gpe(gpe_event_info, ACPI_GPE_DISABLE); 766 if (ACPI_FAILURE(status)) { 767 ACPI_EXCEPTION((AE_INFO, status, 768 "Unable to disable GPE %02X", gpe_number)); 769 return_UINT32(ACPI_INTERRUPT_NOT_HANDLED); 770 } 771 772 /* 773 * If edge-triggered, clear the GPE status bit now. Note that 774 * level-triggered events are cleared after the GPE is serviced. 775 */ 776 if ((gpe_event_info->flags & ACPI_GPE_XRUPT_TYPE_MASK) == 777 ACPI_GPE_EDGE_TRIGGERED) { 778 status = acpi_hw_clear_gpe(gpe_event_info); 779 if (ACPI_FAILURE(status)) { 780 ACPI_EXCEPTION((AE_INFO, status, 781 "Unable to clear GPE %02X", 782 gpe_number)); 783 (void)acpi_hw_low_set_gpe(gpe_event_info, 784 ACPI_GPE_CONDITIONAL_ENABLE); 785 return_UINT32(ACPI_INTERRUPT_NOT_HANDLED); 786 } 787 } 788 789 gpe_event_info->disable_for_dispatch = TRUE; 790 791 /* 792 * Dispatch the GPE to either an installed handler or the control 793 * method associated with this GPE (_Lxx or _Exx). If a handler 794 * exists, we invoke it and do not attempt to run the method. 795 * If there is neither a handler nor a method, leave the GPE 796 * disabled. 797 */ 798 switch (ACPI_GPE_DISPATCH_TYPE(gpe_event_info->flags)) { 799 case ACPI_GPE_DISPATCH_HANDLER: 800 801 /* Invoke the installed handler (at interrupt level) */ 802 803 return_value = 804 gpe_event_info->dispatch.handler->address(gpe_device, 805 gpe_number, 806 gpe_event_info-> 807 dispatch.handler-> 808 context); 809 810 /* If requested, clear (if level-triggered) and re-enable the GPE */ 811 812 if (return_value & ACPI_REENABLE_GPE) { 813 (void)acpi_ev_finish_gpe(gpe_event_info); 814 } 815 break; 816 817 case ACPI_GPE_DISPATCH_METHOD: 818 case ACPI_GPE_DISPATCH_NOTIFY: 819 /* 820 * Execute the method associated with the GPE 821 * NOTE: Level-triggered GPEs are cleared after the method completes. 822 */ 823 status = acpi_os_execute(OSL_GPE_HANDLER, 824 acpi_ev_asynch_execute_gpe_method, 825 gpe_event_info); 826 if (ACPI_FAILURE(status)) { 827 ACPI_EXCEPTION((AE_INFO, status, 828 "Unable to queue handler for GPE %02X - event disabled", 829 gpe_number)); 830 } 831 break; 832 833 default: 834 /* 835 * No handler or method to run! 836 * 03/2010: This case should no longer be possible. We will not allow 837 * a GPE to be enabled if it has no handler or method. 838 */ 839 ACPI_ERROR((AE_INFO, 840 "No handler or method for GPE %02X, disabling event", 841 gpe_number)); 842 843 break; 844 } 845 846 return_UINT32(ACPI_INTERRUPT_HANDLED); 847 } 848 849 #endif /* !ACPI_REDUCED_HARDWARE */ 850