evgpe.c 22 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786
  1. /******************************************************************************
  2. *
  3. * Module Name: evgpe - General Purpose Event handling and dispatch
  4. *
  5. *****************************************************************************/
  6. /*
  7. * Copyright (C) 2000 - 2012, 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. #if (!ACPI_REDUCED_HARDWARE) /* Entire module */
  49. /* Local prototypes */
  50. static void ACPI_SYSTEM_XFACE acpi_ev_asynch_execute_gpe_method(void *context);
  51. static void ACPI_SYSTEM_XFACE acpi_ev_asynch_enable_gpe(void *context);
  52. /*******************************************************************************
  53. *
  54. * FUNCTION: acpi_ev_update_gpe_enable_mask
  55. *
  56. * PARAMETERS: gpe_event_info - GPE to update
  57. *
  58. * RETURN: Status
  59. *
  60. * DESCRIPTION: Updates GPE register enable mask based upon whether there are
  61. * runtime references to this GPE
  62. *
  63. ******************************************************************************/
  64. acpi_status
  65. acpi_ev_update_gpe_enable_mask(struct acpi_gpe_event_info *gpe_event_info)
  66. {
  67. struct acpi_gpe_register_info *gpe_register_info;
  68. u32 register_bit;
  69. ACPI_FUNCTION_TRACE(ev_update_gpe_enable_mask);
  70. gpe_register_info = gpe_event_info->register_info;
  71. if (!gpe_register_info) {
  72. return_ACPI_STATUS(AE_NOT_EXIST);
  73. }
  74. register_bit = acpi_hw_get_gpe_register_bit(gpe_event_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. ACPI_DEBUG_PRINT((ACPI_DB_INTERRUPTS,
  314. "Ignore disabled registers for GPE%02X-GPE%02X: "
  315. "RunEnable=%02X, WakeEnable=%02X\n",
  316. gpe_register_info->
  317. base_gpe_number,
  318. gpe_register_info->
  319. base_gpe_number +
  320. (ACPI_GPE_REGISTER_WIDTH - 1),
  321. gpe_register_info->
  322. enable_for_run,
  323. gpe_register_info->
  324. enable_for_wake));
  325. continue;
  326. }
  327. /* Read the Status Register */
  328. status =
  329. acpi_hw_read(&status_reg,
  330. &gpe_register_info->status_address);
  331. if (ACPI_FAILURE(status)) {
  332. goto unlock_and_exit;
  333. }
  334. /* Read the Enable Register */
  335. status =
  336. acpi_hw_read(&enable_reg,
  337. &gpe_register_info->enable_address);
  338. if (ACPI_FAILURE(status)) {
  339. goto unlock_and_exit;
  340. }
  341. ACPI_DEBUG_PRINT((ACPI_DB_INTERRUPTS,
  342. "Read registers for GPE%02X-GPE%02X: Status=%02X, Enable=%02X, "
  343. "RunEnable=%02X, WakeEnable=%02X\n",
  344. gpe_register_info->base_gpe_number,
  345. gpe_register_info->base_gpe_number +
  346. (ACPI_GPE_REGISTER_WIDTH - 1),
  347. status_reg, enable_reg,
  348. gpe_register_info->enable_for_run,
  349. gpe_register_info->enable_for_wake));
  350. /* Check if there is anything active at all in this register */
  351. enabled_status_byte = (u8) (status_reg & enable_reg);
  352. if (!enabled_status_byte) {
  353. /* No active GPEs in this register, move on */
  354. continue;
  355. }
  356. /* Now look at the individual GPEs in this byte register */
  357. for (j = 0; j < ACPI_GPE_REGISTER_WIDTH; j++) {
  358. /* Examine one GPE bit */
  359. if (enabled_status_byte & (1 << j)) {
  360. /*
  361. * Found an active GPE. Dispatch the event to a handler
  362. * or method.
  363. */
  364. int_status |=
  365. acpi_ev_gpe_dispatch(gpe_block->
  366. node,
  367. &gpe_block->
  368. event_info[((acpi_size) i * ACPI_GPE_REGISTER_WIDTH) + j], j + gpe_register_info->base_gpe_number);
  369. }
  370. }
  371. }
  372. gpe_block = gpe_block->next;
  373. }
  374. unlock_and_exit:
  375. acpi_os_release_lock(acpi_gbl_gpe_lock, flags);
  376. return (int_status);
  377. }
  378. /*******************************************************************************
  379. *
  380. * FUNCTION: acpi_ev_asynch_execute_gpe_method
  381. *
  382. * PARAMETERS: Context (gpe_event_info) - Info for this GPE
  383. *
  384. * RETURN: None
  385. *
  386. * DESCRIPTION: Perform the actual execution of a GPE control method. This
  387. * function is called from an invocation of acpi_os_execute and
  388. * therefore does NOT execute at interrupt level - so that
  389. * the control method itself is not executed in the context of
  390. * an interrupt handler.
  391. *
  392. ******************************************************************************/
  393. static void ACPI_SYSTEM_XFACE acpi_ev_asynch_execute_gpe_method(void *context)
  394. {
  395. struct acpi_gpe_event_info *gpe_event_info = context;
  396. acpi_status status;
  397. struct acpi_gpe_event_info *local_gpe_event_info;
  398. struct acpi_evaluate_info *info;
  399. struct acpi_gpe_notify_info *notify;
  400. ACPI_FUNCTION_TRACE(ev_asynch_execute_gpe_method);
  401. /* Allocate a local GPE block */
  402. local_gpe_event_info =
  403. ACPI_ALLOCATE_ZEROED(sizeof(struct acpi_gpe_event_info));
  404. if (!local_gpe_event_info) {
  405. ACPI_EXCEPTION((AE_INFO, AE_NO_MEMORY, "while handling a GPE"));
  406. return_VOID;
  407. }
  408. status = acpi_ut_acquire_mutex(ACPI_MTX_EVENTS);
  409. if (ACPI_FAILURE(status)) {
  410. ACPI_FREE(local_gpe_event_info);
  411. return_VOID;
  412. }
  413. /* Must revalidate the gpe_number/gpe_block */
  414. if (!acpi_ev_valid_gpe_event(gpe_event_info)) {
  415. status = acpi_ut_release_mutex(ACPI_MTX_EVENTS);
  416. ACPI_FREE(local_gpe_event_info);
  417. return_VOID;
  418. }
  419. /*
  420. * Take a snapshot of the GPE info for this level - we copy the info to
  421. * prevent a race condition with remove_handler/remove_block.
  422. */
  423. ACPI_MEMCPY(local_gpe_event_info, gpe_event_info,
  424. sizeof(struct acpi_gpe_event_info));
  425. status = acpi_ut_release_mutex(ACPI_MTX_EVENTS);
  426. if (ACPI_FAILURE(status)) {
  427. return_VOID;
  428. }
  429. /* Do the correct dispatch - normal method or implicit notify */
  430. switch (local_gpe_event_info->flags & ACPI_GPE_DISPATCH_MASK) {
  431. case ACPI_GPE_DISPATCH_NOTIFY:
  432. /*
  433. * Implicit notify.
  434. * Dispatch a DEVICE_WAKE notify to the appropriate handler.
  435. * NOTE: the request is queued for execution after this method
  436. * completes. The notify handlers are NOT invoked synchronously
  437. * from this thread -- because handlers may in turn run other
  438. * control methods.
  439. *
  440. * June 2012: Expand implicit notify mechanism to support
  441. * notifies on multiple device objects.
  442. */
  443. notify = local_gpe_event_info->dispatch.notify_list;
  444. while (ACPI_SUCCESS(status) && notify) {
  445. status =
  446. acpi_ev_queue_notify_request(notify->device_node,
  447. ACPI_NOTIFY_DEVICE_WAKE);
  448. notify = notify->next;
  449. }
  450. break;
  451. case ACPI_GPE_DISPATCH_METHOD:
  452. /* Allocate the evaluation information block */
  453. info = ACPI_ALLOCATE_ZEROED(sizeof(struct acpi_evaluate_info));
  454. if (!info) {
  455. status = AE_NO_MEMORY;
  456. } else {
  457. /*
  458. * Invoke the GPE Method (_Lxx, _Exx) i.e., evaluate the _Lxx/_Exx
  459. * control method that corresponds to this GPE
  460. */
  461. info->prefix_node =
  462. local_gpe_event_info->dispatch.method_node;
  463. info->flags = ACPI_IGNORE_RETURN_VALUE;
  464. status = acpi_ns_evaluate(info);
  465. ACPI_FREE(info);
  466. }
  467. if (ACPI_FAILURE(status)) {
  468. ACPI_EXCEPTION((AE_INFO, status,
  469. "while evaluating GPE method [%4.4s]",
  470. acpi_ut_get_node_name
  471. (local_gpe_event_info->dispatch.
  472. method_node)));
  473. }
  474. break;
  475. default:
  476. return_VOID; /* Should never happen */
  477. }
  478. /* Defer enabling of GPE until all notify handlers are done */
  479. status = acpi_os_execute(OSL_NOTIFY_HANDLER,
  480. acpi_ev_asynch_enable_gpe,
  481. local_gpe_event_info);
  482. if (ACPI_FAILURE(status)) {
  483. ACPI_FREE(local_gpe_event_info);
  484. }
  485. return_VOID;
  486. }
  487. /*******************************************************************************
  488. *
  489. * FUNCTION: acpi_ev_asynch_enable_gpe
  490. *
  491. * PARAMETERS: Context (gpe_event_info) - Info for this GPE
  492. * Callback from acpi_os_execute
  493. *
  494. * RETURN: None
  495. *
  496. * DESCRIPTION: Asynchronous clear/enable for GPE. This allows the GPE to
  497. * complete (i.e., finish execution of Notify)
  498. *
  499. ******************************************************************************/
  500. static void ACPI_SYSTEM_XFACE acpi_ev_asynch_enable_gpe(void *context)
  501. {
  502. struct acpi_gpe_event_info *gpe_event_info = context;
  503. (void)acpi_ev_finish_gpe(gpe_event_info);
  504. ACPI_FREE(gpe_event_info);
  505. return;
  506. }
  507. /*******************************************************************************
  508. *
  509. * FUNCTION: acpi_ev_finish_gpe
  510. *
  511. * PARAMETERS: gpe_event_info - Info for this GPE
  512. *
  513. * RETURN: Status
  514. *
  515. * DESCRIPTION: Clear/Enable a GPE. Common code that is used after execution
  516. * of a GPE method or a synchronous or asynchronous GPE handler.
  517. *
  518. ******************************************************************************/
  519. acpi_status acpi_ev_finish_gpe(struct acpi_gpe_event_info *gpe_event_info)
  520. {
  521. acpi_status status;
  522. if ((gpe_event_info->flags & ACPI_GPE_XRUPT_TYPE_MASK) ==
  523. ACPI_GPE_LEVEL_TRIGGERED) {
  524. /*
  525. * GPE is level-triggered, we clear the GPE status bit after
  526. * handling the event.
  527. */
  528. status = acpi_hw_clear_gpe(gpe_event_info);
  529. if (ACPI_FAILURE(status)) {
  530. return (status);
  531. }
  532. }
  533. /*
  534. * Enable this GPE, conditionally. This means that the GPE will
  535. * only be physically enabled if the enable_for_run bit is set
  536. * in the event_info.
  537. */
  538. (void)acpi_hw_low_set_gpe(gpe_event_info, ACPI_GPE_CONDITIONAL_ENABLE);
  539. return (AE_OK);
  540. }
  541. /*******************************************************************************
  542. *
  543. * FUNCTION: acpi_ev_gpe_dispatch
  544. *
  545. * PARAMETERS: gpe_device - Device node. NULL for GPE0/GPE1
  546. * gpe_event_info - Info for this GPE
  547. * gpe_number - Number relative to the parent GPE block
  548. *
  549. * RETURN: INTERRUPT_HANDLED or INTERRUPT_NOT_HANDLED
  550. *
  551. * DESCRIPTION: Dispatch a General Purpose Event to either a function (e.g. EC)
  552. * or method (e.g. _Lxx/_Exx) handler.
  553. *
  554. * This function executes at interrupt level.
  555. *
  556. ******************************************************************************/
  557. u32
  558. acpi_ev_gpe_dispatch(struct acpi_namespace_node *gpe_device,
  559. struct acpi_gpe_event_info *gpe_event_info, u32 gpe_number)
  560. {
  561. acpi_status status;
  562. u32 return_value;
  563. ACPI_FUNCTION_TRACE(ev_gpe_dispatch);
  564. /* Invoke global event handler if present */
  565. acpi_gpe_count++;
  566. if (acpi_gbl_global_event_handler) {
  567. acpi_gbl_global_event_handler(ACPI_EVENT_TYPE_GPE, gpe_device,
  568. gpe_number,
  569. acpi_gbl_global_event_handler_context);
  570. }
  571. /*
  572. * If edge-triggered, clear the GPE status bit now. Note that
  573. * level-triggered events are cleared after the GPE is serviced.
  574. */
  575. if ((gpe_event_info->flags & ACPI_GPE_XRUPT_TYPE_MASK) ==
  576. ACPI_GPE_EDGE_TRIGGERED) {
  577. status = acpi_hw_clear_gpe(gpe_event_info);
  578. if (ACPI_FAILURE(status)) {
  579. ACPI_EXCEPTION((AE_INFO, status,
  580. "Unable to clear GPE%02X", gpe_number));
  581. return_UINT32(ACPI_INTERRUPT_NOT_HANDLED);
  582. }
  583. }
  584. /*
  585. * Always disable the GPE so that it does not keep firing before
  586. * any asynchronous activity completes (either from the execution
  587. * of a GPE method or an asynchronous GPE handler.)
  588. *
  589. * If there is no handler or method to run, just disable the
  590. * GPE and leave it disabled permanently to prevent further such
  591. * pointless events from firing.
  592. */
  593. status = acpi_hw_low_set_gpe(gpe_event_info, ACPI_GPE_DISABLE);
  594. if (ACPI_FAILURE(status)) {
  595. ACPI_EXCEPTION((AE_INFO, status,
  596. "Unable to disable GPE%02X", gpe_number));
  597. return_UINT32(ACPI_INTERRUPT_NOT_HANDLED);
  598. }
  599. /*
  600. * Dispatch the GPE to either an installed handler or the control
  601. * method associated with this GPE (_Lxx or _Exx). If a handler
  602. * exists, we invoke it and do not attempt to run the method.
  603. * If there is neither a handler nor a method, leave the GPE
  604. * disabled.
  605. */
  606. switch (gpe_event_info->flags & ACPI_GPE_DISPATCH_MASK) {
  607. case ACPI_GPE_DISPATCH_HANDLER:
  608. /* Invoke the installed handler (at interrupt level) */
  609. return_value =
  610. gpe_event_info->dispatch.handler->address(gpe_device,
  611. gpe_number,
  612. gpe_event_info->
  613. dispatch.handler->
  614. context);
  615. /* If requested, clear (if level-triggered) and reenable the GPE */
  616. if (return_value & ACPI_REENABLE_GPE) {
  617. (void)acpi_ev_finish_gpe(gpe_event_info);
  618. }
  619. break;
  620. case ACPI_GPE_DISPATCH_METHOD:
  621. case ACPI_GPE_DISPATCH_NOTIFY:
  622. /*
  623. * Execute the method associated with the GPE
  624. * NOTE: Level-triggered GPEs are cleared after the method completes.
  625. */
  626. status = acpi_os_execute(OSL_GPE_HANDLER,
  627. acpi_ev_asynch_execute_gpe_method,
  628. gpe_event_info);
  629. if (ACPI_FAILURE(status)) {
  630. ACPI_EXCEPTION((AE_INFO, status,
  631. "Unable to queue handler for GPE%2X - event disabled",
  632. gpe_number));
  633. }
  634. break;
  635. default:
  636. /*
  637. * No handler or method to run!
  638. * 03/2010: This case should no longer be possible. We will not allow
  639. * a GPE to be enabled if it has no handler or method.
  640. */
  641. ACPI_ERROR((AE_INFO,
  642. "No handler or method for GPE%02X, disabling event",
  643. gpe_number));
  644. break;
  645. }
  646. return_UINT32(ACPI_INTERRUPT_HANDLED);
  647. }
  648. #endif /* !ACPI_REDUCED_HARDWARE */