evgpe.c 22 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769
  1. /******************************************************************************
  2. *
  3. * Module Name: evgpe - General Purpose Event handling and dispatch
  4. *
  5. *****************************************************************************/
  6. /*
  7. * Copyright (C) 2000 - 2011, Intel Corp.
  8. * All rights reserved.
  9. *
  10. * Redistribution and use in source and binary forms, with or without
  11. * modification, are permitted provided that the following conditions
  12. * are met:
  13. * 1. Redistributions of source code must retain the above copyright
  14. * notice, this list of conditions, and the following disclaimer,
  15. * without modification.
  16. * 2. Redistributions in binary form must reproduce at minimum a disclaimer
  17. * substantially similar to the "NO WARRANTY" disclaimer below
  18. * ("Disclaimer") and any redistribution must be conditioned upon
  19. * including a substantially similar Disclaimer requirement for further
  20. * binary redistribution.
  21. * 3. Neither the names of the above-listed copyright holders nor the names
  22. * of any contributors may be used to endorse or promote products derived
  23. * from this software without specific prior written permission.
  24. *
  25. * Alternatively, this software may be distributed under the terms of the
  26. * GNU General Public License ("GPL") version 2 as published by the Free
  27. * Software Foundation.
  28. *
  29. * NO WARRANTY
  30. * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  31. * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  32. * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
  33. * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  34. * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  35. * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  36. * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  37. * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
  38. * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
  39. * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  40. * POSSIBILITY OF SUCH DAMAGES.
  41. */
  42. #include <acpi/acpi.h>
  43. #include "accommon.h"
  44. #include "acevents.h"
  45. #include "acnamesp.h"
  46. #define _COMPONENT ACPI_EVENTS
  47. ACPI_MODULE_NAME("evgpe")
  48. /* Local prototypes */
  49. static void ACPI_SYSTEM_XFACE acpi_ev_asynch_execute_gpe_method(void *context);
  50. static void ACPI_SYSTEM_XFACE acpi_ev_asynch_enable_gpe(void *context);
  51. /*******************************************************************************
  52. *
  53. * FUNCTION: acpi_ev_update_gpe_enable_mask
  54. *
  55. * PARAMETERS: gpe_event_info - GPE to update
  56. *
  57. * RETURN: Status
  58. *
  59. * DESCRIPTION: Updates GPE register enable mask based upon whether there are
  60. * runtime references to this GPE
  61. *
  62. ******************************************************************************/
  63. acpi_status
  64. acpi_ev_update_gpe_enable_mask(struct acpi_gpe_event_info *gpe_event_info)
  65. {
  66. struct acpi_gpe_register_info *gpe_register_info;
  67. u32 register_bit;
  68. ACPI_FUNCTION_TRACE(ev_update_gpe_enable_mask);
  69. gpe_register_info = gpe_event_info->register_info;
  70. if (!gpe_register_info) {
  71. return_ACPI_STATUS(AE_NOT_EXIST);
  72. }
  73. register_bit = acpi_hw_get_gpe_register_bit(gpe_event_info,
  74. gpe_register_info);
  75. /* Clear the run bit up front */
  76. ACPI_CLEAR_BIT(gpe_register_info->enable_for_run, register_bit);
  77. /* Set the mask bit only if there are references to this GPE */
  78. if (gpe_event_info->runtime_count) {
  79. ACPI_SET_BIT(gpe_register_info->enable_for_run, (u8)register_bit);
  80. }
  81. return_ACPI_STATUS(AE_OK);
  82. }
  83. /*******************************************************************************
  84. *
  85. * FUNCTION: acpi_ev_enable_gpe
  86. *
  87. * PARAMETERS: gpe_event_info - GPE to enable
  88. *
  89. * RETURN: Status
  90. *
  91. * DESCRIPTION: Clear a GPE of stale events and enable it.
  92. *
  93. ******************************************************************************/
  94. acpi_status
  95. acpi_ev_enable_gpe(struct acpi_gpe_event_info *gpe_event_info)
  96. {
  97. acpi_status status;
  98. ACPI_FUNCTION_TRACE(ev_enable_gpe);
  99. /*
  100. * We will only allow a GPE to be enabled if it has either an associated
  101. * method (_Lxx/_Exx) or a handler, or is using the implicit notify
  102. * feature. Otherwise, the GPE will be immediately disabled by
  103. * acpi_ev_gpe_dispatch the first time it fires.
  104. */
  105. if ((gpe_event_info->flags & ACPI_GPE_DISPATCH_MASK) ==
  106. ACPI_GPE_DISPATCH_NONE) {
  107. return_ACPI_STATUS(AE_NO_HANDLER);
  108. }
  109. /* Clear the GPE (of stale events) */
  110. status = acpi_hw_clear_gpe(gpe_event_info);
  111. if (ACPI_FAILURE(status)) {
  112. return_ACPI_STATUS(status);
  113. }
  114. /* Enable the requested GPE */
  115. status = acpi_hw_low_set_gpe(gpe_event_info, ACPI_GPE_ENABLE);
  116. return_ACPI_STATUS(status);
  117. }
  118. /*******************************************************************************
  119. *
  120. * FUNCTION: acpi_ev_add_gpe_reference
  121. *
  122. * PARAMETERS: gpe_event_info - Add a reference to this GPE
  123. *
  124. * RETURN: Status
  125. *
  126. * DESCRIPTION: Add a reference to a GPE. On the first reference, the GPE is
  127. * hardware-enabled.
  128. *
  129. ******************************************************************************/
  130. acpi_status acpi_ev_add_gpe_reference(struct acpi_gpe_event_info *gpe_event_info)
  131. {
  132. acpi_status status = AE_OK;
  133. ACPI_FUNCTION_TRACE(ev_add_gpe_reference);
  134. if (gpe_event_info->runtime_count == ACPI_UINT8_MAX) {
  135. return_ACPI_STATUS(AE_LIMIT);
  136. }
  137. gpe_event_info->runtime_count++;
  138. if (gpe_event_info->runtime_count == 1) {
  139. /* Enable on first reference */
  140. status = acpi_ev_update_gpe_enable_mask(gpe_event_info);
  141. if (ACPI_SUCCESS(status)) {
  142. status = acpi_ev_enable_gpe(gpe_event_info);
  143. }
  144. if (ACPI_FAILURE(status)) {
  145. gpe_event_info->runtime_count--;
  146. }
  147. }
  148. return_ACPI_STATUS(status);
  149. }
  150. /*******************************************************************************
  151. *
  152. * FUNCTION: acpi_ev_remove_gpe_reference
  153. *
  154. * PARAMETERS: gpe_event_info - Remove a reference to this GPE
  155. *
  156. * RETURN: Status
  157. *
  158. * DESCRIPTION: Remove a reference to a GPE. When the last reference is
  159. * removed, the GPE is hardware-disabled.
  160. *
  161. ******************************************************************************/
  162. acpi_status acpi_ev_remove_gpe_reference(struct acpi_gpe_event_info *gpe_event_info)
  163. {
  164. acpi_status status = AE_OK;
  165. ACPI_FUNCTION_TRACE(ev_remove_gpe_reference);
  166. if (!gpe_event_info->runtime_count) {
  167. return_ACPI_STATUS(AE_LIMIT);
  168. }
  169. gpe_event_info->runtime_count--;
  170. if (!gpe_event_info->runtime_count) {
  171. /* Disable on last reference */
  172. status = acpi_ev_update_gpe_enable_mask(gpe_event_info);
  173. if (ACPI_SUCCESS(status)) {
  174. status = acpi_hw_low_set_gpe(gpe_event_info,
  175. ACPI_GPE_DISABLE);
  176. }
  177. if (ACPI_FAILURE(status)) {
  178. gpe_event_info->runtime_count++;
  179. }
  180. }
  181. return_ACPI_STATUS(status);
  182. }
  183. /*******************************************************************************
  184. *
  185. * FUNCTION: acpi_ev_low_get_gpe_info
  186. *
  187. * PARAMETERS: gpe_number - Raw GPE number
  188. * gpe_block - A GPE info block
  189. *
  190. * RETURN: A GPE event_info struct. NULL if not a valid GPE (The gpe_number
  191. * is not within the specified GPE block)
  192. *
  193. * DESCRIPTION: Returns the event_info struct associated with this GPE. This is
  194. * the low-level implementation of ev_get_gpe_event_info.
  195. *
  196. ******************************************************************************/
  197. struct acpi_gpe_event_info *acpi_ev_low_get_gpe_info(u32 gpe_number,
  198. struct acpi_gpe_block_info
  199. *gpe_block)
  200. {
  201. u32 gpe_index;
  202. /*
  203. * Validate that the gpe_number is within the specified gpe_block.
  204. * (Two steps)
  205. */
  206. if (!gpe_block || (gpe_number < gpe_block->block_base_number)) {
  207. return (NULL);
  208. }
  209. gpe_index = gpe_number - gpe_block->block_base_number;
  210. if (gpe_index >= gpe_block->gpe_count) {
  211. return (NULL);
  212. }
  213. return (&gpe_block->event_info[gpe_index]);
  214. }
  215. /*******************************************************************************
  216. *
  217. * FUNCTION: acpi_ev_get_gpe_event_info
  218. *
  219. * PARAMETERS: gpe_device - Device node. NULL for GPE0/GPE1
  220. * gpe_number - Raw GPE number
  221. *
  222. * RETURN: A GPE event_info struct. NULL if not a valid GPE
  223. *
  224. * DESCRIPTION: Returns the event_info struct associated with this GPE.
  225. * Validates the gpe_block and the gpe_number
  226. *
  227. * Should be called only when the GPE lists are semaphore locked
  228. * and not subject to change.
  229. *
  230. ******************************************************************************/
  231. struct acpi_gpe_event_info *acpi_ev_get_gpe_event_info(acpi_handle gpe_device,
  232. u32 gpe_number)
  233. {
  234. union acpi_operand_object *obj_desc;
  235. struct acpi_gpe_event_info *gpe_info;
  236. u32 i;
  237. ACPI_FUNCTION_ENTRY();
  238. /* A NULL gpe_device means use the FADT-defined GPE block(s) */
  239. if (!gpe_device) {
  240. /* Examine GPE Block 0 and 1 (These blocks are permanent) */
  241. for (i = 0; i < ACPI_MAX_GPE_BLOCKS; i++) {
  242. gpe_info = acpi_ev_low_get_gpe_info(gpe_number,
  243. acpi_gbl_gpe_fadt_blocks
  244. [i]);
  245. if (gpe_info) {
  246. return (gpe_info);
  247. }
  248. }
  249. /* The gpe_number was not in the range of either FADT GPE block */
  250. return (NULL);
  251. }
  252. /* A Non-NULL gpe_device means this is a GPE Block Device */
  253. obj_desc = acpi_ns_get_attached_object((struct acpi_namespace_node *)
  254. gpe_device);
  255. if (!obj_desc || !obj_desc->device.gpe_block) {
  256. return (NULL);
  257. }
  258. return (acpi_ev_low_get_gpe_info
  259. (gpe_number, obj_desc->device.gpe_block));
  260. }
  261. /*******************************************************************************
  262. *
  263. * FUNCTION: acpi_ev_gpe_detect
  264. *
  265. * PARAMETERS: gpe_xrupt_list - Interrupt block for this interrupt.
  266. * Can have multiple GPE blocks attached.
  267. *
  268. * RETURN: INTERRUPT_HANDLED or INTERRUPT_NOT_HANDLED
  269. *
  270. * DESCRIPTION: Detect if any GP events have occurred. This function is
  271. * executed at interrupt level.
  272. *
  273. ******************************************************************************/
  274. u32 acpi_ev_gpe_detect(struct acpi_gpe_xrupt_info * gpe_xrupt_list)
  275. {
  276. acpi_status status;
  277. struct acpi_gpe_block_info *gpe_block;
  278. struct acpi_gpe_register_info *gpe_register_info;
  279. u32 int_status = ACPI_INTERRUPT_NOT_HANDLED;
  280. u8 enabled_status_byte;
  281. u32 status_reg;
  282. u32 enable_reg;
  283. acpi_cpu_flags flags;
  284. u32 i;
  285. u32 j;
  286. ACPI_FUNCTION_NAME(ev_gpe_detect);
  287. /* Check for the case where there are no GPEs */
  288. if (!gpe_xrupt_list) {
  289. return (int_status);
  290. }
  291. /*
  292. * We need to obtain the GPE lock for both the data structs and registers
  293. * Note: Not necessary to obtain the hardware lock, since the GPE
  294. * registers are owned by the gpe_lock.
  295. */
  296. flags = acpi_os_acquire_lock(acpi_gbl_gpe_lock);
  297. /* Examine all GPE blocks attached to this interrupt level */
  298. gpe_block = gpe_xrupt_list->gpe_block_list_head;
  299. while (gpe_block) {
  300. /*
  301. * Read all of the 8-bit GPE status and enable registers in this GPE
  302. * block, saving all of them. Find all currently active GP events.
  303. */
  304. for (i = 0; i < gpe_block->register_count; i++) {
  305. /* Get the next status/enable pair */
  306. gpe_register_info = &gpe_block->register_info[i];
  307. /*
  308. * Optimization: If there are no GPEs enabled within this
  309. * register, we can safely ignore the entire register.
  310. */
  311. if (!(gpe_register_info->enable_for_run |
  312. gpe_register_info->enable_for_wake)) {
  313. continue;
  314. }
  315. /* Read the Status Register */
  316. status =
  317. acpi_hw_read(&status_reg,
  318. &gpe_register_info->status_address);
  319. if (ACPI_FAILURE(status)) {
  320. goto unlock_and_exit;
  321. }
  322. /* Read the Enable Register */
  323. status =
  324. acpi_hw_read(&enable_reg,
  325. &gpe_register_info->enable_address);
  326. if (ACPI_FAILURE(status)) {
  327. goto unlock_and_exit;
  328. }
  329. ACPI_DEBUG_PRINT((ACPI_DB_INTERRUPTS,
  330. "Read GPE Register at GPE%02X: Status=%02X, Enable=%02X\n",
  331. gpe_register_info->base_gpe_number,
  332. status_reg, enable_reg));
  333. /* Check if there is anything active at all in this register */
  334. enabled_status_byte = (u8) (status_reg & enable_reg);
  335. if (!enabled_status_byte) {
  336. /* No active GPEs in this register, move on */
  337. continue;
  338. }
  339. /* Now look at the individual GPEs in this byte register */
  340. for (j = 0; j < ACPI_GPE_REGISTER_WIDTH; j++) {
  341. /* Examine one GPE bit */
  342. if (enabled_status_byte & (1 << j)) {
  343. /*
  344. * Found an active GPE. Dispatch the event to a handler
  345. * or method.
  346. */
  347. int_status |=
  348. acpi_ev_gpe_dispatch(gpe_block->
  349. node,
  350. &gpe_block->
  351. event_info[((acpi_size) i * ACPI_GPE_REGISTER_WIDTH) + j], j + gpe_register_info->base_gpe_number);
  352. }
  353. }
  354. }
  355. gpe_block = gpe_block->next;
  356. }
  357. unlock_and_exit:
  358. acpi_os_release_lock(acpi_gbl_gpe_lock, flags);
  359. return (int_status);
  360. }
  361. /*******************************************************************************
  362. *
  363. * FUNCTION: acpi_ev_asynch_execute_gpe_method
  364. *
  365. * PARAMETERS: Context (gpe_event_info) - Info for this GPE
  366. *
  367. * RETURN: None
  368. *
  369. * DESCRIPTION: Perform the actual execution of a GPE control method. This
  370. * function is called from an invocation of acpi_os_execute and
  371. * therefore does NOT execute at interrupt level - so that
  372. * the control method itself is not executed in the context of
  373. * an interrupt handler.
  374. *
  375. ******************************************************************************/
  376. static void ACPI_SYSTEM_XFACE acpi_ev_asynch_execute_gpe_method(void *context)
  377. {
  378. struct acpi_gpe_event_info *gpe_event_info = context;
  379. acpi_status status;
  380. struct acpi_gpe_event_info *local_gpe_event_info;
  381. struct acpi_evaluate_info *info;
  382. struct acpi_gpe_notify_object *notify_object;
  383. ACPI_FUNCTION_TRACE(ev_asynch_execute_gpe_method);
  384. /* Allocate a local GPE block */
  385. local_gpe_event_info =
  386. ACPI_ALLOCATE_ZEROED(sizeof(struct acpi_gpe_event_info));
  387. if (!local_gpe_event_info) {
  388. ACPI_EXCEPTION((AE_INFO, AE_NO_MEMORY, "while handling a GPE"));
  389. return_VOID;
  390. }
  391. status = acpi_ut_acquire_mutex(ACPI_MTX_EVENTS);
  392. if (ACPI_FAILURE(status)) {
  393. ACPI_FREE(local_gpe_event_info);
  394. return_VOID;
  395. }
  396. /* Must revalidate the gpe_number/gpe_block */
  397. if (!acpi_ev_valid_gpe_event(gpe_event_info)) {
  398. status = acpi_ut_release_mutex(ACPI_MTX_EVENTS);
  399. ACPI_FREE(local_gpe_event_info);
  400. return_VOID;
  401. }
  402. /*
  403. * Take a snapshot of the GPE info for this level - we copy the info to
  404. * prevent a race condition with remove_handler/remove_block.
  405. */
  406. ACPI_MEMCPY(local_gpe_event_info, gpe_event_info,
  407. sizeof(struct acpi_gpe_event_info));
  408. status = acpi_ut_release_mutex(ACPI_MTX_EVENTS);
  409. if (ACPI_FAILURE(status)) {
  410. return_VOID;
  411. }
  412. /* Do the correct dispatch - normal method or implicit notify */
  413. switch (local_gpe_event_info->flags & ACPI_GPE_DISPATCH_MASK) {
  414. case ACPI_GPE_DISPATCH_NOTIFY:
  415. /*
  416. * Implicit notify.
  417. * Dispatch a DEVICE_WAKE notify to the appropriate handler.
  418. * NOTE: the request is queued for execution after this method
  419. * completes. The notify handlers are NOT invoked synchronously
  420. * from this thread -- because handlers may in turn run other
  421. * control methods.
  422. */
  423. status = acpi_ev_queue_notify_request(
  424. local_gpe_event_info->dispatch.device.node,
  425. ACPI_NOTIFY_DEVICE_WAKE);
  426. notify_object = local_gpe_event_info->dispatch.device.next;
  427. while (ACPI_SUCCESS(status) && notify_object) {
  428. status = acpi_ev_queue_notify_request(
  429. notify_object->node,
  430. ACPI_NOTIFY_DEVICE_WAKE);
  431. notify_object = notify_object->next;
  432. }
  433. break;
  434. case ACPI_GPE_DISPATCH_METHOD:
  435. /* Allocate the evaluation information block */
  436. info = ACPI_ALLOCATE_ZEROED(sizeof(struct acpi_evaluate_info));
  437. if (!info) {
  438. status = AE_NO_MEMORY;
  439. } else {
  440. /*
  441. * Invoke the GPE Method (_Lxx, _Exx) i.e., evaluate the _Lxx/_Exx
  442. * control method that corresponds to this GPE
  443. */
  444. info->prefix_node =
  445. local_gpe_event_info->dispatch.method_node;
  446. info->flags = ACPI_IGNORE_RETURN_VALUE;
  447. status = acpi_ns_evaluate(info);
  448. ACPI_FREE(info);
  449. }
  450. if (ACPI_FAILURE(status)) {
  451. ACPI_EXCEPTION((AE_INFO, status,
  452. "while evaluating GPE method [%4.4s]",
  453. acpi_ut_get_node_name
  454. (local_gpe_event_info->dispatch.
  455. method_node)));
  456. }
  457. break;
  458. default:
  459. return_VOID; /* Should never happen */
  460. }
  461. /* Defer enabling of GPE until all notify handlers are done */
  462. status = acpi_os_execute(OSL_NOTIFY_HANDLER,
  463. acpi_ev_asynch_enable_gpe,
  464. local_gpe_event_info);
  465. if (ACPI_FAILURE(status)) {
  466. ACPI_FREE(local_gpe_event_info);
  467. }
  468. return_VOID;
  469. }
  470. /*******************************************************************************
  471. *
  472. * FUNCTION: acpi_ev_asynch_enable_gpe
  473. *
  474. * PARAMETERS: Context (gpe_event_info) - Info for this GPE
  475. * Callback from acpi_os_execute
  476. *
  477. * RETURN: None
  478. *
  479. * DESCRIPTION: Asynchronous clear/enable for GPE. This allows the GPE to
  480. * complete (i.e., finish execution of Notify)
  481. *
  482. ******************************************************************************/
  483. static void ACPI_SYSTEM_XFACE acpi_ev_asynch_enable_gpe(void *context)
  484. {
  485. struct acpi_gpe_event_info *gpe_event_info = context;
  486. (void)acpi_ev_finish_gpe(gpe_event_info);
  487. ACPI_FREE(gpe_event_info);
  488. return;
  489. }
  490. /*******************************************************************************
  491. *
  492. * FUNCTION: acpi_ev_finish_gpe
  493. *
  494. * PARAMETERS: gpe_event_info - Info for this GPE
  495. *
  496. * RETURN: Status
  497. *
  498. * DESCRIPTION: Clear/Enable a GPE. Common code that is used after execution
  499. * of a GPE method or a synchronous or asynchronous GPE handler.
  500. *
  501. ******************************************************************************/
  502. acpi_status acpi_ev_finish_gpe(struct acpi_gpe_event_info *gpe_event_info)
  503. {
  504. acpi_status status;
  505. if ((gpe_event_info->flags & ACPI_GPE_XRUPT_TYPE_MASK) ==
  506. ACPI_GPE_LEVEL_TRIGGERED) {
  507. /*
  508. * GPE is level-triggered, we clear the GPE status bit after
  509. * handling the event.
  510. */
  511. status = acpi_hw_clear_gpe(gpe_event_info);
  512. if (ACPI_FAILURE(status)) {
  513. return (status);
  514. }
  515. }
  516. /*
  517. * Enable this GPE, conditionally. This means that the GPE will
  518. * only be physically enabled if the enable_for_run bit is set
  519. * in the event_info.
  520. */
  521. (void)acpi_hw_low_set_gpe(gpe_event_info, ACPI_GPE_CONDITIONAL_ENABLE);
  522. return (AE_OK);
  523. }
  524. /*******************************************************************************
  525. *
  526. * FUNCTION: acpi_ev_gpe_dispatch
  527. *
  528. * PARAMETERS: gpe_device - Device node. NULL for GPE0/GPE1
  529. * gpe_event_info - Info for this GPE
  530. * gpe_number - Number relative to the parent GPE block
  531. *
  532. * RETURN: INTERRUPT_HANDLED or INTERRUPT_NOT_HANDLED
  533. *
  534. * DESCRIPTION: Dispatch a General Purpose Event to either a function (e.g. EC)
  535. * or method (e.g. _Lxx/_Exx) handler.
  536. *
  537. * This function executes at interrupt level.
  538. *
  539. ******************************************************************************/
  540. u32
  541. acpi_ev_gpe_dispatch(struct acpi_namespace_node *gpe_device,
  542. struct acpi_gpe_event_info *gpe_event_info, u32 gpe_number)
  543. {
  544. acpi_status status;
  545. u32 return_value;
  546. ACPI_FUNCTION_TRACE(ev_gpe_dispatch);
  547. /* Invoke global event handler if present */
  548. acpi_gpe_count++;
  549. if (acpi_gbl_global_event_handler) {
  550. acpi_gbl_global_event_handler(ACPI_EVENT_TYPE_GPE, gpe_device,
  551. gpe_number,
  552. acpi_gbl_global_event_handler_context);
  553. }
  554. /*
  555. * If edge-triggered, clear the GPE status bit now. Note that
  556. * level-triggered events are cleared after the GPE is serviced.
  557. */
  558. if ((gpe_event_info->flags & ACPI_GPE_XRUPT_TYPE_MASK) ==
  559. ACPI_GPE_EDGE_TRIGGERED) {
  560. status = acpi_hw_clear_gpe(gpe_event_info);
  561. if (ACPI_FAILURE(status)) {
  562. ACPI_EXCEPTION((AE_INFO, status,
  563. "Unable to clear GPE%02X", gpe_number));
  564. return_UINT32(ACPI_INTERRUPT_NOT_HANDLED);
  565. }
  566. }
  567. /*
  568. * Always disable the GPE so that it does not keep firing before
  569. * any asynchronous activity completes (either from the execution
  570. * of a GPE method or an asynchronous GPE handler.)
  571. *
  572. * If there is no handler or method to run, just disable the
  573. * GPE and leave it disabled permanently to prevent further such
  574. * pointless events from firing.
  575. */
  576. status = acpi_hw_low_set_gpe(gpe_event_info, ACPI_GPE_DISABLE);
  577. if (ACPI_FAILURE(status)) {
  578. ACPI_EXCEPTION((AE_INFO, status,
  579. "Unable to disable GPE%02X", gpe_number));
  580. return_UINT32(ACPI_INTERRUPT_NOT_HANDLED);
  581. }
  582. /*
  583. * Dispatch the GPE to either an installed handler or the control
  584. * method associated with this GPE (_Lxx or _Exx). If a handler
  585. * exists, we invoke it and do not attempt to run the method.
  586. * If there is neither a handler nor a method, leave the GPE
  587. * disabled.
  588. */
  589. switch (gpe_event_info->flags & ACPI_GPE_DISPATCH_MASK) {
  590. case ACPI_GPE_DISPATCH_HANDLER:
  591. /* Invoke the installed handler (at interrupt level) */
  592. return_value =
  593. gpe_event_info->dispatch.handler->address(gpe_device,
  594. gpe_number,
  595. gpe_event_info->
  596. dispatch.handler->
  597. context);
  598. /* If requested, clear (if level-triggered) and reenable the GPE */
  599. if (return_value & ACPI_REENABLE_GPE) {
  600. (void)acpi_ev_finish_gpe(gpe_event_info);
  601. }
  602. break;
  603. case ACPI_GPE_DISPATCH_METHOD:
  604. case ACPI_GPE_DISPATCH_NOTIFY:
  605. /*
  606. * Execute the method associated with the GPE
  607. * NOTE: Level-triggered GPEs are cleared after the method completes.
  608. */
  609. status = acpi_os_execute(OSL_GPE_HANDLER,
  610. acpi_ev_asynch_execute_gpe_method,
  611. gpe_event_info);
  612. if (ACPI_FAILURE(status)) {
  613. ACPI_EXCEPTION((AE_INFO, status,
  614. "Unable to queue handler for GPE%2X - event disabled",
  615. gpe_number));
  616. }
  617. break;
  618. default:
  619. /*
  620. * No handler or method to run!
  621. * 03/2010: This case should no longer be possible. We will not allow
  622. * a GPE to be enabled if it has no handler or method.
  623. */
  624. ACPI_ERROR((AE_INFO,
  625. "No handler or method for GPE%02X, disabling event",
  626. gpe_number));
  627. break;
  628. }
  629. return_UINT32(ACPI_INTERRUPT_HANDLED);
  630. }