1/******************************************************************************
2 *
3 * Module Name: evmisc - ACPI device notification handler dispatch
4 * and ACPI Global Lock support
| 1/******************************************************************************
2 *
3 * Module Name: evmisc - ACPI device notification handler dispatch
4 * and ACPI Global Lock support
|
5 * $Revision: 31 $
| 5 * $Revision: 32 $
|
6 *
7 *****************************************************************************/
8
9/******************************************************************************
10 *
11 * 1. Copyright Notice
12 *
13 * Some or all of this work - Copyright (c) 1999, 2000, 2001, Intel Corp.
14 * All rights reserved.
15 *
16 * 2. License
17 *
18 * 2.1. This is your license from Intel Corp. under its intellectual property
19 * rights. You may have additional license terms from the party that provided
20 * you this software, covering your right to use that party's intellectual
21 * property rights.
22 *
23 * 2.2. Intel grants, free of charge, to any person ("Licensee") obtaining a
24 * copy of the source code appearing in this file ("Covered Code") an
25 * irrevocable, perpetual, worldwide license under Intel's copyrights in the
26 * base code distributed originally by Intel ("Original Intel Code") to copy,
27 * make derivatives, distribute, use and display any portion of the Covered
28 * Code in any form, with the right to sublicense such rights; and
29 *
30 * 2.3. Intel grants Licensee a non-exclusive and non-transferable patent
31 * license (with the right to sublicense), under only those claims of Intel
32 * patents that are infringed by the Original Intel Code, to make, use, sell,
33 * offer to sell, and import the Covered Code and derivative works thereof
34 * solely to the minimum extent necessary to exercise the above copyright
35 * license, and in no event shall the patent license extend to any additions
36 * to or modifications of the Original Intel Code. No other license or right
37 * is granted directly or by implication, estoppel or otherwise;
38 *
39 * The above copyright and patent license is granted only if the following
40 * conditions are met:
41 *
42 * 3. Conditions
43 *
44 * 3.1. Redistribution of Source with Rights to Further Distribute Source.
45 * Redistribution of source code of any substantial portion of the Covered
46 * Code or modification with rights to further distribute source must include
47 * the above Copyright Notice, the above License, this list of Conditions,
48 * and the following Disclaimer and Export Compliance provision. In addition,
49 * Licensee must cause all Covered Code to which Licensee contributes to
50 * contain a file documenting the changes Licensee made to create that Covered
51 * Code and the date of any change. Licensee must include in that file the
52 * documentation of any changes made by any predecessor Licensee. Licensee
53 * must include a prominent statement that the modification is derived,
54 * directly or indirectly, from Original Intel Code.
55 *
56 * 3.2. Redistribution of Source with no Rights to Further Distribute Source.
57 * Redistribution of source code of any substantial portion of the Covered
58 * Code or modification without rights to further distribute source must
59 * include the following Disclaimer and Export Compliance provision in the
60 * documentation and/or other materials provided with distribution. In
61 * addition, Licensee may not authorize further sublicense of source of any
62 * portion of the Covered Code, and must include terms to the effect that the
63 * license from Licensee to its licensee is limited to the intellectual
64 * property embodied in the software Licensee provides to its licensee, and
65 * not to intellectual property embodied in modifications its licensee may
66 * make.
67 *
68 * 3.3. Redistribution of Executable. Redistribution in executable form of any
69 * substantial portion of the Covered Code or modification must reproduce the
70 * above Copyright Notice, and the following Disclaimer and Export Compliance
71 * provision in the documentation and/or other materials provided with the
72 * distribution.
73 *
74 * 3.4. Intel retains all right, title, and interest in and to the Original
75 * Intel Code.
76 *
77 * 3.5. Neither the name Intel nor any other trademark owned or controlled by
78 * Intel shall be used in advertising or otherwise to promote the sale, use or
79 * other dealings in products derived from or relating to the Covered Code
80 * without prior written authorization from Intel.
81 *
82 * 4. Disclaimer and Export Compliance
83 *
84 * 4.1. INTEL MAKES NO WARRANTY OF ANY KIND REGARDING ANY SOFTWARE PROVIDED
85 * HERE. ANY SOFTWARE ORIGINATING FROM INTEL OR DERIVED FROM INTEL SOFTWARE
86 * IS PROVIDED "AS IS," AND INTEL WILL NOT PROVIDE ANY SUPPORT, ASSISTANCE,
87 * INSTALLATION, TRAINING OR OTHER SERVICES. INTEL WILL NOT PROVIDE ANY
88 * UPDATES, ENHANCEMENTS OR EXTENSIONS. INTEL SPECIFICALLY DISCLAIMS ANY
89 * IMPLIED WARRANTIES OF MERCHANTABILITY, NONINFRINGEMENT AND FITNESS FOR A
90 * PARTICULAR PURPOSE.
91 *
92 * 4.2. IN NO EVENT SHALL INTEL HAVE ANY LIABILITY TO LICENSEE, ITS LICENSEES
93 * OR ANY OTHER THIRD PARTY, FOR ANY LOST PROFITS, LOST DATA, LOSS OF USE OR
94 * COSTS OF PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES, OR FOR ANY INDIRECT,
95 * SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THIS AGREEMENT, UNDER ANY
96 * CAUSE OF ACTION OR THEORY OF LIABILITY, AND IRRESPECTIVE OF WHETHER INTEL
97 * HAS ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES. THESE LIMITATIONS
98 * SHALL APPLY NOTWITHSTANDING THE FAILURE OF THE ESSENTIAL PURPOSE OF ANY
99 * LIMITED REMEDY.
100 *
101 * 4.3. Licensee shall not export, either directly or indirectly, any of this
102 * software or system incorporating such software without first obtaining any
103 * required license or other approval from the U. S. Department of Commerce or
104 * any other agency or department of the United States Government. In the
105 * event Licensee exports any such software from the United States or
106 * re-exports any such software from a foreign destination, Licensee shall
107 * ensure that the distribution and export/re-export of the software is in
108 * compliance with all laws, regulations, orders, or other restrictions of the
109 * U.S. Export Administration Regulations. Licensee agrees that neither it nor
110 * any of its subsidiaries will export/re-export any technical data, process,
111 * software, or service, directly or indirectly, to any country for which the
112 * United States government or any agency thereof requires an export license,
113 * other governmental approval, or letter of assurance, without first obtaining
114 * such license, approval or letter.
115 *
116 *****************************************************************************/
117
118#include "acpi.h"
119#include "acevents.h"
120#include "acnamesp.h"
121#include "acinterp.h"
122#include "achware.h"
123
124#define _COMPONENT ACPI_EVENTS
125 MODULE_NAME ("evmisc")
126
127
128/*******************************************************************************
129 *
130 * FUNCTION: AcpiEvQueueNotifyRequest
131 *
132 * PARAMETERS:
133 *
134 * RETURN: None.
135 *
136 * DESCRIPTION: Dispatch a device notification event to a previously
137 * installed handler.
138 *
139 ******************************************************************************/
140
141ACPI_STATUS
142AcpiEvQueueNotifyRequest (
143 ACPI_NAMESPACE_NODE *Node,
144 UINT32 NotifyValue)
145{
146 ACPI_OPERAND_OBJECT *ObjDesc;
147 ACPI_OPERAND_OBJECT *HandlerObj = NULL;
148 ACPI_GENERIC_STATE *NotifyInfo;
149 ACPI_STATUS Status = AE_OK;
150
151
152 PROC_NAME ("EvQueueNotifyRequest");
153
154
155 /*
156 * For value 1 (Ejection Request), some device method may need to be run.
157 * For value 2 (Device Wake) if _PRW exists, the _PS0 method may need to be run.
158 * For value 0x80 (Status Change) on the power button or sleep button,
159 * initiate soft-off or sleep operation?
160 */
161
| 6 *
7 *****************************************************************************/
8
9/******************************************************************************
10 *
11 * 1. Copyright Notice
12 *
13 * Some or all of this work - Copyright (c) 1999, 2000, 2001, Intel Corp.
14 * All rights reserved.
15 *
16 * 2. License
17 *
18 * 2.1. This is your license from Intel Corp. under its intellectual property
19 * rights. You may have additional license terms from the party that provided
20 * you this software, covering your right to use that party's intellectual
21 * property rights.
22 *
23 * 2.2. Intel grants, free of charge, to any person ("Licensee") obtaining a
24 * copy of the source code appearing in this file ("Covered Code") an
25 * irrevocable, perpetual, worldwide license under Intel's copyrights in the
26 * base code distributed originally by Intel ("Original Intel Code") to copy,
27 * make derivatives, distribute, use and display any portion of the Covered
28 * Code in any form, with the right to sublicense such rights; and
29 *
30 * 2.3. Intel grants Licensee a non-exclusive and non-transferable patent
31 * license (with the right to sublicense), under only those claims of Intel
32 * patents that are infringed by the Original Intel Code, to make, use, sell,
33 * offer to sell, and import the Covered Code and derivative works thereof
34 * solely to the minimum extent necessary to exercise the above copyright
35 * license, and in no event shall the patent license extend to any additions
36 * to or modifications of the Original Intel Code. No other license or right
37 * is granted directly or by implication, estoppel or otherwise;
38 *
39 * The above copyright and patent license is granted only if the following
40 * conditions are met:
41 *
42 * 3. Conditions
43 *
44 * 3.1. Redistribution of Source with Rights to Further Distribute Source.
45 * Redistribution of source code of any substantial portion of the Covered
46 * Code or modification with rights to further distribute source must include
47 * the above Copyright Notice, the above License, this list of Conditions,
48 * and the following Disclaimer and Export Compliance provision. In addition,
49 * Licensee must cause all Covered Code to which Licensee contributes to
50 * contain a file documenting the changes Licensee made to create that Covered
51 * Code and the date of any change. Licensee must include in that file the
52 * documentation of any changes made by any predecessor Licensee. Licensee
53 * must include a prominent statement that the modification is derived,
54 * directly or indirectly, from Original Intel Code.
55 *
56 * 3.2. Redistribution of Source with no Rights to Further Distribute Source.
57 * Redistribution of source code of any substantial portion of the Covered
58 * Code or modification without rights to further distribute source must
59 * include the following Disclaimer and Export Compliance provision in the
60 * documentation and/or other materials provided with distribution. In
61 * addition, Licensee may not authorize further sublicense of source of any
62 * portion of the Covered Code, and must include terms to the effect that the
63 * license from Licensee to its licensee is limited to the intellectual
64 * property embodied in the software Licensee provides to its licensee, and
65 * not to intellectual property embodied in modifications its licensee may
66 * make.
67 *
68 * 3.3. Redistribution of Executable. Redistribution in executable form of any
69 * substantial portion of the Covered Code or modification must reproduce the
70 * above Copyright Notice, and the following Disclaimer and Export Compliance
71 * provision in the documentation and/or other materials provided with the
72 * distribution.
73 *
74 * 3.4. Intel retains all right, title, and interest in and to the Original
75 * Intel Code.
76 *
77 * 3.5. Neither the name Intel nor any other trademark owned or controlled by
78 * Intel shall be used in advertising or otherwise to promote the sale, use or
79 * other dealings in products derived from or relating to the Covered Code
80 * without prior written authorization from Intel.
81 *
82 * 4. Disclaimer and Export Compliance
83 *
84 * 4.1. INTEL MAKES NO WARRANTY OF ANY KIND REGARDING ANY SOFTWARE PROVIDED
85 * HERE. ANY SOFTWARE ORIGINATING FROM INTEL OR DERIVED FROM INTEL SOFTWARE
86 * IS PROVIDED "AS IS," AND INTEL WILL NOT PROVIDE ANY SUPPORT, ASSISTANCE,
87 * INSTALLATION, TRAINING OR OTHER SERVICES. INTEL WILL NOT PROVIDE ANY
88 * UPDATES, ENHANCEMENTS OR EXTENSIONS. INTEL SPECIFICALLY DISCLAIMS ANY
89 * IMPLIED WARRANTIES OF MERCHANTABILITY, NONINFRINGEMENT AND FITNESS FOR A
90 * PARTICULAR PURPOSE.
91 *
92 * 4.2. IN NO EVENT SHALL INTEL HAVE ANY LIABILITY TO LICENSEE, ITS LICENSEES
93 * OR ANY OTHER THIRD PARTY, FOR ANY LOST PROFITS, LOST DATA, LOSS OF USE OR
94 * COSTS OF PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES, OR FOR ANY INDIRECT,
95 * SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THIS AGREEMENT, UNDER ANY
96 * CAUSE OF ACTION OR THEORY OF LIABILITY, AND IRRESPECTIVE OF WHETHER INTEL
97 * HAS ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES. THESE LIMITATIONS
98 * SHALL APPLY NOTWITHSTANDING THE FAILURE OF THE ESSENTIAL PURPOSE OF ANY
99 * LIMITED REMEDY.
100 *
101 * 4.3. Licensee shall not export, either directly or indirectly, any of this
102 * software or system incorporating such software without first obtaining any
103 * required license or other approval from the U. S. Department of Commerce or
104 * any other agency or department of the United States Government. In the
105 * event Licensee exports any such software from the United States or
106 * re-exports any such software from a foreign destination, Licensee shall
107 * ensure that the distribution and export/re-export of the software is in
108 * compliance with all laws, regulations, orders, or other restrictions of the
109 * U.S. Export Administration Regulations. Licensee agrees that neither it nor
110 * any of its subsidiaries will export/re-export any technical data, process,
111 * software, or service, directly or indirectly, to any country for which the
112 * United States government or any agency thereof requires an export license,
113 * other governmental approval, or letter of assurance, without first obtaining
114 * such license, approval or letter.
115 *
116 *****************************************************************************/
117
118#include "acpi.h"
119#include "acevents.h"
120#include "acnamesp.h"
121#include "acinterp.h"
122#include "achware.h"
123
124#define _COMPONENT ACPI_EVENTS
125 MODULE_NAME ("evmisc")
126
127
128/*******************************************************************************
129 *
130 * FUNCTION: AcpiEvQueueNotifyRequest
131 *
132 * PARAMETERS:
133 *
134 * RETURN: None.
135 *
136 * DESCRIPTION: Dispatch a device notification event to a previously
137 * installed handler.
138 *
139 ******************************************************************************/
140
141ACPI_STATUS
142AcpiEvQueueNotifyRequest (
143 ACPI_NAMESPACE_NODE *Node,
144 UINT32 NotifyValue)
145{
146 ACPI_OPERAND_OBJECT *ObjDesc;
147 ACPI_OPERAND_OBJECT *HandlerObj = NULL;
148 ACPI_GENERIC_STATE *NotifyInfo;
149 ACPI_STATUS Status = AE_OK;
150
151
152 PROC_NAME ("EvQueueNotifyRequest");
153
154
155 /*
156 * For value 1 (Ejection Request), some device method may need to be run.
157 * For value 2 (Device Wake) if _PRW exists, the _PS0 method may need to be run.
158 * For value 0x80 (Status Change) on the power button or sleep button,
159 * initiate soft-off or sleep operation?
160 */
161
|
162 DEBUG_PRINTP (ACPI_INFO,
163 ("Dispatching Notify(%X) on node %p\n", NotifyValue, Node));
| 162 ACPI_DEBUG_PRINT ((ACPI_DB_INFO,
163 "Dispatching Notify(%X) on node %p\n", NotifyValue, Node));
|
164
165 switch (NotifyValue)
166 {
167 case 0:
| 164
165 switch (NotifyValue)
166 {
167 case 0:
|
168 DEBUG_PRINTP (ACPI_INFO, ("Notify value: Re-enumerate Devices\n"));
| 168 ACPI_DEBUG_PRINT ((ACPI_DB_INFO, "Notify value: Re-enumerate Devices\n"));
|
169 break;
170
171 case 1:
| 169 break;
170
171 case 1:
|
172 DEBUG_PRINTP (ACPI_INFO, ("Notify value: Ejection Request\n"));
| 172 ACPI_DEBUG_PRINT ((ACPI_DB_INFO, "Notify value: Ejection Request\n"));
|
173 break;
174
175 case 2:
| 173 break;
174
175 case 2:
|
176 DEBUG_PRINTP (ACPI_INFO, ("Notify value: Device Wake\n"));
| 176 ACPI_DEBUG_PRINT ((ACPI_DB_INFO, "Notify value: Device Wake\n"));
|
177 break;
178
179 case 0x80:
| 177 break;
178
179 case 0x80:
|
180 DEBUG_PRINTP (ACPI_INFO, ("Notify value: Status Change\n"));
| 180 ACPI_DEBUG_PRINT ((ACPI_DB_INFO, "Notify value: Status Change\n"));
|
181 break;
182
183 default:
| 181 break;
182
183 default:
|
184 DEBUG_PRINTP (ACPI_INFO, ("Unknown Notify Value: %lx \n", NotifyValue));
| 184 ACPI_DEBUG_PRINT ((ACPI_DB_INFO, "Unknown Notify Value: %lx \n", NotifyValue));
|
185 break;
186 }
187
188
189 /*
190 * Get the notify object attached to the device Node
191 */
192
193 ObjDesc = AcpiNsGetAttachedObject (Node);
194 if (ObjDesc)
195 {
196
197 /* We have the notify object, Get the right handler */
198
199 switch (Node->Type)
200 {
201 case ACPI_TYPE_DEVICE:
202 if (NotifyValue <= MAX_SYS_NOTIFY)
203 {
204 HandlerObj = ObjDesc->Device.SysHandler;
205 }
206 else
207 {
208 HandlerObj = ObjDesc->Device.DrvHandler;
209 }
210 break;
211
212 case ACPI_TYPE_THERMAL:
213 if (NotifyValue <= MAX_SYS_NOTIFY)
214 {
215 HandlerObj = ObjDesc->ThermalZone.SysHandler;
216 }
217 else
218 {
219 HandlerObj = ObjDesc->ThermalZone.DrvHandler;
220 }
221 break;
222 }
223 }
224
225
226 /* If there is any handler to run, schedule the dispatcher */
227
228 if ((AcpiGbl_SysNotify.Handler && (NotifyValue <= MAX_SYS_NOTIFY)) ||
229 (AcpiGbl_DrvNotify.Handler && (NotifyValue > MAX_SYS_NOTIFY)) ||
230 HandlerObj)
231 {
232
233 NotifyInfo = AcpiUtCreateGenericState ();
234 if (!NotifyInfo)
235 {
236 return (AE_NO_MEMORY);
237 }
238
239 NotifyInfo->Notify.Node = Node;
240 NotifyInfo->Notify.Value = (UINT16) NotifyValue;
241 NotifyInfo->Notify.HandlerObj = HandlerObj;
242
243 Status = AcpiOsQueueForExecution (OSD_PRIORITY_HIGH,
244 AcpiEvNotifyDispatch, NotifyInfo);
245 if (ACPI_FAILURE (Status))
246 {
247 AcpiUtDeleteGenericState (NotifyInfo);
248 }
249 }
250
251 if (!HandlerObj)
252 {
253 /* There is no per-device notify handler for this device */
254
| 185 break;
186 }
187
188
189 /*
190 * Get the notify object attached to the device Node
191 */
192
193 ObjDesc = AcpiNsGetAttachedObject (Node);
194 if (ObjDesc)
195 {
196
197 /* We have the notify object, Get the right handler */
198
199 switch (Node->Type)
200 {
201 case ACPI_TYPE_DEVICE:
202 if (NotifyValue <= MAX_SYS_NOTIFY)
203 {
204 HandlerObj = ObjDesc->Device.SysHandler;
205 }
206 else
207 {
208 HandlerObj = ObjDesc->Device.DrvHandler;
209 }
210 break;
211
212 case ACPI_TYPE_THERMAL:
213 if (NotifyValue <= MAX_SYS_NOTIFY)
214 {
215 HandlerObj = ObjDesc->ThermalZone.SysHandler;
216 }
217 else
218 {
219 HandlerObj = ObjDesc->ThermalZone.DrvHandler;
220 }
221 break;
222 }
223 }
224
225
226 /* If there is any handler to run, schedule the dispatcher */
227
228 if ((AcpiGbl_SysNotify.Handler && (NotifyValue <= MAX_SYS_NOTIFY)) ||
229 (AcpiGbl_DrvNotify.Handler && (NotifyValue > MAX_SYS_NOTIFY)) ||
230 HandlerObj)
231 {
232
233 NotifyInfo = AcpiUtCreateGenericState ();
234 if (!NotifyInfo)
235 {
236 return (AE_NO_MEMORY);
237 }
238
239 NotifyInfo->Notify.Node = Node;
240 NotifyInfo->Notify.Value = (UINT16) NotifyValue;
241 NotifyInfo->Notify.HandlerObj = HandlerObj;
242
243 Status = AcpiOsQueueForExecution (OSD_PRIORITY_HIGH,
244 AcpiEvNotifyDispatch, NotifyInfo);
245 if (ACPI_FAILURE (Status))
246 {
247 AcpiUtDeleteGenericState (NotifyInfo);
248 }
249 }
250
251 if (!HandlerObj)
252 {
253 /* There is no per-device notify handler for this device */
254
|
255 DEBUG_PRINTP (ACPI_INFO, ("No notify handler for node %p \n", Node));
| 255 ACPI_DEBUG_PRINT ((ACPI_DB_INFO, "No notify handler for node %p \n", Node));
|
256 }
257
258 return (Status);
259}
260
261
262/*******************************************************************************
263 *
264 * FUNCTION: AcpiEvNotifyDispatch
265 *
266 * PARAMETERS:
267 *
268 * RETURN: None.
269 *
270 * DESCRIPTION: Dispatch a device notification event to a previously
271 * installed handler.
272 *
273 ******************************************************************************/
274
275void
276AcpiEvNotifyDispatch (
277 void *Context)
278{
279 ACPI_GENERIC_STATE *NotifyInfo = (ACPI_GENERIC_STATE *) Context;
280 ACPI_NOTIFY_HANDLER GlobalHandler = NULL;
281 void *GlobalContext = NULL;
282 ACPI_OPERAND_OBJECT *HandlerObj;
283
284
285 /*
286 * We will invoke a global notify handler if installed.
287 * This is done _before_ we invoke the per-device handler attached to the device.
288 */
289
290 if (NotifyInfo->Notify.Value <= MAX_SYS_NOTIFY)
291 {
292 /* Global system notification handler */
293
294 if (AcpiGbl_SysNotify.Handler)
295 {
296 GlobalHandler = AcpiGbl_SysNotify.Handler;
297 GlobalContext = AcpiGbl_SysNotify.Context;
298 }
299 }
300
301 else
302 {
303 /* Global driver notification handler */
304
305 if (AcpiGbl_DrvNotify.Handler)
306 {
307 GlobalHandler = AcpiGbl_DrvNotify.Handler;
308 GlobalContext = AcpiGbl_DrvNotify.Context;
309 }
310 }
311
312
313 /* Invoke the system handler first, if present */
314
315 if (GlobalHandler)
316 {
317 GlobalHandler (NotifyInfo->Notify.Node, NotifyInfo->Notify.Value, GlobalContext);
318 }
319
320 /* Now invoke the per-device handler, if present */
321
322 HandlerObj = NotifyInfo->Notify.HandlerObj;
323 if (HandlerObj)
324 {
325 HandlerObj->NotifyHandler.Handler (NotifyInfo->Notify.Node, NotifyInfo->Notify.Value,
326 HandlerObj->NotifyHandler.Context);
327 }
328
329
330 /* All done with the info object */
331
332 AcpiUtDeleteGenericState (NotifyInfo);
333}
334
335
336/*******************************************************************************
337 *
338 * FUNCTION: AcpiEvGlobalLockThread
339 *
340 * RETURN: None
341 *
342 * DESCRIPTION: Invoked by SCI interrupt handler upon acquisition of the
343 * Global Lock. Simply signal all threads that are waiting
344 * for the lock.
345 *
346 ******************************************************************************/
347
348static void
349AcpiEvGlobalLockThread (
350 void *Context)
351{
352
353 /* Signal threads that are waiting for the lock */
354
355 if (AcpiGbl_GlobalLockThreadCount)
356 {
357 /* Send sufficient units to the semaphore */
358
359 AcpiOsSignalSemaphore (AcpiGbl_GlobalLockSemaphore,
360 AcpiGbl_GlobalLockThreadCount);
361 }
362}
363
364
365/*******************************************************************************
366 *
367 * FUNCTION: AcpiEvGlobalLockHandler
368 *
369 * RETURN: Status
370 *
371 * DESCRIPTION: Invoked directly from the SCI handler when a global lock
372 * release interrupt occurs. Grab the global lock and queue
373 * the global lock thread for execution
374 *
375 ******************************************************************************/
376
377static UINT32
378AcpiEvGlobalLockHandler (
379 void *Context)
380{
381 BOOLEAN Acquired = FALSE;
382 void *GlobalLock;
383
384
385 /*
386 * Attempt to get the lock
387 * If we don't get it now, it will be marked pending and we will
388 * take another interrupt when it becomes free.
389 */
390
391 GlobalLock = AcpiGbl_FACS->GlobalLock;
392 ACPI_ACQUIRE_GLOBAL_LOCK (GlobalLock, Acquired);
393 if (Acquired)
394 {
395 /* Got the lock, now wake all threads waiting for it */
396
397 AcpiGbl_GlobalLockAcquired = TRUE;
398
399 /* Run the Global Lock thread which will signal all waiting threads */
400
401 AcpiOsQueueForExecution (OSD_PRIORITY_HIGH, AcpiEvGlobalLockThread,
402 Context);
403 }
404
405 return (INTERRUPT_HANDLED);
406}
407
408
409/*******************************************************************************
410 *
411 * FUNCTION: AcpiEvInitGlobalLockHandler
412 *
413 * RETURN: Status
414 *
415 * DESCRIPTION: Install a handler for the global lock release event
416 *
417 ******************************************************************************/
418
419ACPI_STATUS
420AcpiEvInitGlobalLockHandler (void)
421{
422 ACPI_STATUS Status;
423
424
425 FUNCTION_TRACE ("EvInitGlobalLockHandler");
426
427
428 AcpiGbl_GlobalLockPresent = TRUE;
429 Status = AcpiInstallFixedEventHandler (ACPI_EVENT_GLOBAL,
430 AcpiEvGlobalLockHandler, NULL);
431
432 /*
433 * If the global lock does not exist on this platform, the attempt
434 * to enable GBL_STS will fail (the GBL_EN bit will not stick)
435 * Map to AE_OK, but mark global lock as not present.
436 * Any attempt to actually use the global lock will be flagged
437 * with an error.
438 */
439 if (Status == AE_NO_HARDWARE_RESPONSE)
440 {
441 AcpiGbl_GlobalLockPresent = FALSE;
442 Status = AE_OK;
443 }
444
445 return_ACPI_STATUS (Status);
446}
447
448
449/******************************************************************************
450 *
451 * FUNCTION: AcpiEvAcquireGlobalLock
452 *
453 * RETURN: Status
454 *
455 * DESCRIPTION: Attempt to gain ownership of the Global Lock.
456 *
457 *****************************************************************************/
458
459ACPI_STATUS
460AcpiEvAcquireGlobalLock(void)
461{
462 ACPI_STATUS Status = AE_OK;
463 BOOLEAN Acquired = FALSE;
464 void *GlobalLock;
465
466
467 FUNCTION_TRACE ("EvAcquireGlobalLock");
468
469 /* Make sure that we actually have a global lock */
470
471 if (!AcpiGbl_GlobalLockPresent)
472 {
473 return_ACPI_STATUS (AE_NO_GLOBAL_LOCK);
474 }
475
476 /* One more thread wants the global lock */
477
478 AcpiGbl_GlobalLockThreadCount++;
479
480
481 /* If we (OS side) have the hardware lock already, we are done */
482
483 if (AcpiGbl_GlobalLockAcquired)
484 {
485 return_ACPI_STATUS (AE_OK);
486 }
487
488 /* Only if the FACS is valid */
489
490 if (!AcpiGbl_FACS)
491 {
492 return_ACPI_STATUS (AE_OK);
493 }
494
495
496 /* We must acquire the actual hardware lock */
497
498 GlobalLock = AcpiGbl_FACS->GlobalLock;
499 ACPI_ACQUIRE_GLOBAL_LOCK (GlobalLock, Acquired);
500 if (Acquired)
501 {
502 /* We got the lock */
503
| 256 }
257
258 return (Status);
259}
260
261
262/*******************************************************************************
263 *
264 * FUNCTION: AcpiEvNotifyDispatch
265 *
266 * PARAMETERS:
267 *
268 * RETURN: None.
269 *
270 * DESCRIPTION: Dispatch a device notification event to a previously
271 * installed handler.
272 *
273 ******************************************************************************/
274
275void
276AcpiEvNotifyDispatch (
277 void *Context)
278{
279 ACPI_GENERIC_STATE *NotifyInfo = (ACPI_GENERIC_STATE *) Context;
280 ACPI_NOTIFY_HANDLER GlobalHandler = NULL;
281 void *GlobalContext = NULL;
282 ACPI_OPERAND_OBJECT *HandlerObj;
283
284
285 /*
286 * We will invoke a global notify handler if installed.
287 * This is done _before_ we invoke the per-device handler attached to the device.
288 */
289
290 if (NotifyInfo->Notify.Value <= MAX_SYS_NOTIFY)
291 {
292 /* Global system notification handler */
293
294 if (AcpiGbl_SysNotify.Handler)
295 {
296 GlobalHandler = AcpiGbl_SysNotify.Handler;
297 GlobalContext = AcpiGbl_SysNotify.Context;
298 }
299 }
300
301 else
302 {
303 /* Global driver notification handler */
304
305 if (AcpiGbl_DrvNotify.Handler)
306 {
307 GlobalHandler = AcpiGbl_DrvNotify.Handler;
308 GlobalContext = AcpiGbl_DrvNotify.Context;
309 }
310 }
311
312
313 /* Invoke the system handler first, if present */
314
315 if (GlobalHandler)
316 {
317 GlobalHandler (NotifyInfo->Notify.Node, NotifyInfo->Notify.Value, GlobalContext);
318 }
319
320 /* Now invoke the per-device handler, if present */
321
322 HandlerObj = NotifyInfo->Notify.HandlerObj;
323 if (HandlerObj)
324 {
325 HandlerObj->NotifyHandler.Handler (NotifyInfo->Notify.Node, NotifyInfo->Notify.Value,
326 HandlerObj->NotifyHandler.Context);
327 }
328
329
330 /* All done with the info object */
331
332 AcpiUtDeleteGenericState (NotifyInfo);
333}
334
335
336/*******************************************************************************
337 *
338 * FUNCTION: AcpiEvGlobalLockThread
339 *
340 * RETURN: None
341 *
342 * DESCRIPTION: Invoked by SCI interrupt handler upon acquisition of the
343 * Global Lock. Simply signal all threads that are waiting
344 * for the lock.
345 *
346 ******************************************************************************/
347
348static void
349AcpiEvGlobalLockThread (
350 void *Context)
351{
352
353 /* Signal threads that are waiting for the lock */
354
355 if (AcpiGbl_GlobalLockThreadCount)
356 {
357 /* Send sufficient units to the semaphore */
358
359 AcpiOsSignalSemaphore (AcpiGbl_GlobalLockSemaphore,
360 AcpiGbl_GlobalLockThreadCount);
361 }
362}
363
364
365/*******************************************************************************
366 *
367 * FUNCTION: AcpiEvGlobalLockHandler
368 *
369 * RETURN: Status
370 *
371 * DESCRIPTION: Invoked directly from the SCI handler when a global lock
372 * release interrupt occurs. Grab the global lock and queue
373 * the global lock thread for execution
374 *
375 ******************************************************************************/
376
377static UINT32
378AcpiEvGlobalLockHandler (
379 void *Context)
380{
381 BOOLEAN Acquired = FALSE;
382 void *GlobalLock;
383
384
385 /*
386 * Attempt to get the lock
387 * If we don't get it now, it will be marked pending and we will
388 * take another interrupt when it becomes free.
389 */
390
391 GlobalLock = AcpiGbl_FACS->GlobalLock;
392 ACPI_ACQUIRE_GLOBAL_LOCK (GlobalLock, Acquired);
393 if (Acquired)
394 {
395 /* Got the lock, now wake all threads waiting for it */
396
397 AcpiGbl_GlobalLockAcquired = TRUE;
398
399 /* Run the Global Lock thread which will signal all waiting threads */
400
401 AcpiOsQueueForExecution (OSD_PRIORITY_HIGH, AcpiEvGlobalLockThread,
402 Context);
403 }
404
405 return (INTERRUPT_HANDLED);
406}
407
408
409/*******************************************************************************
410 *
411 * FUNCTION: AcpiEvInitGlobalLockHandler
412 *
413 * RETURN: Status
414 *
415 * DESCRIPTION: Install a handler for the global lock release event
416 *
417 ******************************************************************************/
418
419ACPI_STATUS
420AcpiEvInitGlobalLockHandler (void)
421{
422 ACPI_STATUS Status;
423
424
425 FUNCTION_TRACE ("EvInitGlobalLockHandler");
426
427
428 AcpiGbl_GlobalLockPresent = TRUE;
429 Status = AcpiInstallFixedEventHandler (ACPI_EVENT_GLOBAL,
430 AcpiEvGlobalLockHandler, NULL);
431
432 /*
433 * If the global lock does not exist on this platform, the attempt
434 * to enable GBL_STS will fail (the GBL_EN bit will not stick)
435 * Map to AE_OK, but mark global lock as not present.
436 * Any attempt to actually use the global lock will be flagged
437 * with an error.
438 */
439 if (Status == AE_NO_HARDWARE_RESPONSE)
440 {
441 AcpiGbl_GlobalLockPresent = FALSE;
442 Status = AE_OK;
443 }
444
445 return_ACPI_STATUS (Status);
446}
447
448
449/******************************************************************************
450 *
451 * FUNCTION: AcpiEvAcquireGlobalLock
452 *
453 * RETURN: Status
454 *
455 * DESCRIPTION: Attempt to gain ownership of the Global Lock.
456 *
457 *****************************************************************************/
458
459ACPI_STATUS
460AcpiEvAcquireGlobalLock(void)
461{
462 ACPI_STATUS Status = AE_OK;
463 BOOLEAN Acquired = FALSE;
464 void *GlobalLock;
465
466
467 FUNCTION_TRACE ("EvAcquireGlobalLock");
468
469 /* Make sure that we actually have a global lock */
470
471 if (!AcpiGbl_GlobalLockPresent)
472 {
473 return_ACPI_STATUS (AE_NO_GLOBAL_LOCK);
474 }
475
476 /* One more thread wants the global lock */
477
478 AcpiGbl_GlobalLockThreadCount++;
479
480
481 /* If we (OS side) have the hardware lock already, we are done */
482
483 if (AcpiGbl_GlobalLockAcquired)
484 {
485 return_ACPI_STATUS (AE_OK);
486 }
487
488 /* Only if the FACS is valid */
489
490 if (!AcpiGbl_FACS)
491 {
492 return_ACPI_STATUS (AE_OK);
493 }
494
495
496 /* We must acquire the actual hardware lock */
497
498 GlobalLock = AcpiGbl_FACS->GlobalLock;
499 ACPI_ACQUIRE_GLOBAL_LOCK (GlobalLock, Acquired);
500 if (Acquired)
501 {
502 /* We got the lock */
503
|
504 DEBUG_PRINTP (ACPI_INFO, ("Acquired the Global Lock\n"));
| 504 ACPI_DEBUG_PRINT ((ACPI_DB_INFO, "Acquired the Global Lock\n"));
|
505
506 AcpiGbl_GlobalLockAcquired = TRUE;
507 return_ACPI_STATUS (AE_OK);
508 }
509
510
511 /*
512 * Did not get the lock. The pending bit was set above, and we must now
513 * wait until we get the global lock released interrupt.
514 */
515
| 505
506 AcpiGbl_GlobalLockAcquired = TRUE;
507 return_ACPI_STATUS (AE_OK);
508 }
509
510
511 /*
512 * Did not get the lock. The pending bit was set above, and we must now
513 * wait until we get the global lock released interrupt.
514 */
515
|
516 DEBUG_PRINTP (ACPI_INFO, ("Waiting for the HW Global Lock\n"));
| 516 ACPI_DEBUG_PRINT ((ACPI_DB_INFO, "Waiting for the HW Global Lock\n"));
|
517
518 /*
519 * Acquire the global lock semaphore first.
520 * Since this wait will block, we must release the interpreter
521 */
522
523 Status = AcpiExSystemWaitSemaphore (AcpiGbl_GlobalLockSemaphore,
524 ACPI_UINT32_MAX);
525 return_ACPI_STATUS (Status);
526}
527
528
529/*******************************************************************************
530 *
531 * FUNCTION: AcpiEvReleaseGlobalLock
532 *
533 * DESCRIPTION: Releases ownership of the Global Lock.
534 *
535 ******************************************************************************/
536
537void
538AcpiEvReleaseGlobalLock (void)
539{
540 BOOLEAN Pending = FALSE;
541 void *GlobalLock;
542
543
544 FUNCTION_TRACE ("EvReleaseGlobalLock");
545
546 if (!AcpiGbl_GlobalLockThreadCount)
547 {
548 REPORT_WARNING(("Global Lock has not be acquired, cannot release\n"));
549 return_VOID;
550 }
551
552 /* One fewer thread has the global lock */
553
554 AcpiGbl_GlobalLockThreadCount--;
555
556 /* Have all threads released the lock? */
557
558 if (!AcpiGbl_GlobalLockThreadCount)
559 {
560 /*
561 * No more threads holding lock, we can do the actual hardware
562 * release
563 */
564
565 GlobalLock = AcpiGbl_FACS->GlobalLock;
566 ACPI_RELEASE_GLOBAL_LOCK (GlobalLock, Pending);
567 AcpiGbl_GlobalLockAcquired = FALSE;
568
569 /*
570 * If the pending bit was set, we must write GBL_RLS to the control
571 * register
572 */
573 if (Pending)
574 {
575 AcpiHwRegisterBitAccess (ACPI_WRITE, ACPI_MTX_LOCK,
576 GBL_RLS, 1);
577 }
578 }
579
580 return_VOID;
581}
| 517
518 /*
519 * Acquire the global lock semaphore first.
520 * Since this wait will block, we must release the interpreter
521 */
522
523 Status = AcpiExSystemWaitSemaphore (AcpiGbl_GlobalLockSemaphore,
524 ACPI_UINT32_MAX);
525 return_ACPI_STATUS (Status);
526}
527
528
529/*******************************************************************************
530 *
531 * FUNCTION: AcpiEvReleaseGlobalLock
532 *
533 * DESCRIPTION: Releases ownership of the Global Lock.
534 *
535 ******************************************************************************/
536
537void
538AcpiEvReleaseGlobalLock (void)
539{
540 BOOLEAN Pending = FALSE;
541 void *GlobalLock;
542
543
544 FUNCTION_TRACE ("EvReleaseGlobalLock");
545
546 if (!AcpiGbl_GlobalLockThreadCount)
547 {
548 REPORT_WARNING(("Global Lock has not be acquired, cannot release\n"));
549 return_VOID;
550 }
551
552 /* One fewer thread has the global lock */
553
554 AcpiGbl_GlobalLockThreadCount--;
555
556 /* Have all threads released the lock? */
557
558 if (!AcpiGbl_GlobalLockThreadCount)
559 {
560 /*
561 * No more threads holding lock, we can do the actual hardware
562 * release
563 */
564
565 GlobalLock = AcpiGbl_FACS->GlobalLock;
566 ACPI_RELEASE_GLOBAL_LOCK (GlobalLock, Pending);
567 AcpiGbl_GlobalLockAcquired = FALSE;
568
569 /*
570 * If the pending bit was set, we must write GBL_RLS to the control
571 * register
572 */
573 if (Pending)
574 {
575 AcpiHwRegisterBitAccess (ACPI_WRITE, ACPI_MTX_LOCK,
576 GBL_RLS, 1);
577 }
578 }
579
580 return_VOID;
581}
|