Subversion Repositories Kolibri OS

Rev

Go to most recent revision | Details | Last modification | View Log | RSS feed

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