13 * All rights reserved.
14 *
15 * 2. License
16 *
17 * 2.1. This is your license from Intel Corp. under its intellectual property
18 * rights. You may have additional license terms from the party that provided
19 * you this software, covering your right to use that party's intellectual
20 * property rights.
21 *
22 * 2.2. Intel grants, free of charge, to any person ("Licensee") obtaining a
23 * copy of the source code appearing in this file ("Covered Code") an
24 * irrevocable, perpetual, worldwide license under Intel's copyrights in the
25 * base code distributed originally by Intel ("Original Intel Code") to copy,
26 * make derivatives, distribute, use and display any portion of the Covered
27 * Code in any form, with the right to sublicense such rights; and
28 *
29 * 2.3. Intel grants Licensee a non-exclusive and non-transferable patent
30 * license (with the right to sublicense), under only those claims of Intel
31 * patents that are infringed by the Original Intel Code, to make, use, sell,
32 * offer to sell, and import the Covered Code and derivative works thereof
33 * solely to the minimum extent necessary to exercise the above copyright
34 * license, and in no event shall the patent license extend to any additions
35 * to or modifications of the Original Intel Code. No other license or right
36 * is granted directly or by implication, estoppel or otherwise;
37 *
38 * The above copyright and patent license is granted only if the following
39 * conditions are met:
40 *
41 * 3. Conditions
42 *
43 * 3.1. Redistribution of Source with Rights to Further Distribute Source.
44 * Redistribution of source code of any substantial portion of the Covered
45 * Code or modification with rights to further distribute source must include
46 * the above Copyright Notice, the above License, this list of Conditions,
47 * and the following Disclaimer and Export Compliance provision. In addition,
48 * Licensee must cause all Covered Code to which Licensee contributes to
49 * contain a file documenting the changes Licensee made to create that Covered
50 * Code and the date of any change. Licensee must include in that file the
51 * documentation of any changes made by any predecessor Licensee. Licensee
52 * must include a prominent statement that the modification is derived,
53 * directly or indirectly, from Original Intel Code.
54 *
55 * 3.2. Redistribution of Source with no Rights to Further Distribute Source.
56 * Redistribution of source code of any substantial portion of the Covered
57 * Code or modification without rights to further distribute source must
58 * include the following Disclaimer and Export Compliance provision in the
59 * documentation and/or other materials provided with distribution. In
60 * addition, Licensee may not authorize further sublicense of source of any
61 * portion of the Covered Code, and must include terms to the effect that the
62 * license from Licensee to its licensee is limited to the intellectual
63 * property embodied in the software Licensee provides to its licensee, and
64 * not to intellectual property embodied in modifications its licensee may
65 * make.
66 *
67 * 3.3. Redistribution of Executable. Redistribution in executable form of any
68 * substantial portion of the Covered Code or modification must reproduce the
69 * above Copyright Notice, and the following Disclaimer and Export Compliance
70 * provision in the documentation and/or other materials provided with the
71 * distribution.
72 *
73 * 3.4. Intel retains all right, title, and interest in and to the Original
74 * Intel Code.
75 *
76 * 3.5. Neither the name Intel nor any other trademark owned or controlled by
77 * Intel shall be used in advertising or otherwise to promote the sale, use or
78 * other dealings in products derived from or relating to the Covered Code
79 * without prior written authorization from Intel.
80 *
81 * 4. Disclaimer and Export Compliance
82 *
83 * 4.1. INTEL MAKES NO WARRANTY OF ANY KIND REGARDING ANY SOFTWARE PROVIDED
84 * HERE. ANY SOFTWARE ORIGINATING FROM INTEL OR DERIVED FROM INTEL SOFTWARE
85 * IS PROVIDED "AS IS," AND INTEL WILL NOT PROVIDE ANY SUPPORT, ASSISTANCE,
86 * INSTALLATION, TRAINING OR OTHER SERVICES. INTEL WILL NOT PROVIDE ANY
87 * UPDATES, ENHANCEMENTS OR EXTENSIONS. INTEL SPECIFICALLY DISCLAIMS ANY
88 * IMPLIED WARRANTIES OF MERCHANTABILITY, NONINFRINGEMENT AND FITNESS FOR A
89 * PARTICULAR PURPOSE.
90 *
91 * 4.2. IN NO EVENT SHALL INTEL HAVE ANY LIABILITY TO LICENSEE, ITS LICENSEES
92 * OR ANY OTHER THIRD PARTY, FOR ANY LOST PROFITS, LOST DATA, LOSS OF USE OR
93 * COSTS OF PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES, OR FOR ANY INDIRECT,
94 * SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THIS AGREEMENT, UNDER ANY
95 * CAUSE OF ACTION OR THEORY OF LIABILITY, AND IRRESPECTIVE OF WHETHER INTEL
96 * HAS ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES. THESE LIMITATIONS
97 * SHALL APPLY NOTWITHSTANDING THE FAILURE OF THE ESSENTIAL PURPOSE OF ANY
98 * LIMITED REMEDY.
99 *
100 * 4.3. Licensee shall not export, either directly or indirectly, any of this
101 * software or system incorporating such software without first obtaining any
102 * required license or other approval from the U. S. Department of Commerce or
103 * any other agency or department of the United States Government. In the
104 * event Licensee exports any such software from the United States or
105 * re-exports any such software from a foreign destination, Licensee shall
106 * ensure that the distribution and export/re-export of the software is in
107 * compliance with all laws, regulations, orders, or other restrictions of the
108 * U.S. Export Administration Regulations. Licensee agrees that neither it nor
109 * any of its subsidiaries will export/re-export any technical data, process,
110 * software, or service, directly or indirectly, to any country for which the
111 * United States government or any agency thereof requires an export license,
112 * other governmental approval, or letter of assurance, without first obtaining
113 * such license, approval or letter.
114 *
115 *****************************************************************************/
116
117
118#define __UTXFACE_C__
119
120#include "acpi.h"
121#include "acevents.h"
122#include "acnamesp.h"
123#include "acparser.h"
124#include "acdispat.h"
125#include "acdebug.h"
126
127#define _COMPONENT ACPI_UTILITIES
128 ACPI_MODULE_NAME ("utxface")
129
130
131/*******************************************************************************
132 *
133 * FUNCTION: AcpiInitializeSubsystem
134 *
135 * PARAMETERS: None
136 *
137 * RETURN: Status
138 *
139 * DESCRIPTION: Initializes all global variables. This is the first function
140 * called, so any early initialization belongs here.
141 *
142 ******************************************************************************/
143
144ACPI_STATUS
145AcpiInitializeSubsystem (
146 void)
147{
148 ACPI_STATUS Status;
149
150 ACPI_FUNCTION_TRACE ("AcpiInitializeSubsystem");
151
152
153 ACPI_DEBUG_EXEC (AcpiUtInitStackPtrTrace ());
154
155
156 /* Initialize all globals used by the subsystem */
157
158 AcpiUtInitGlobals ();
159
160 /* Initialize the OS-Dependent layer */
161
162 Status = AcpiOsInitialize ();
163 if (ACPI_FAILURE (Status))
164 {
165 ACPI_REPORT_ERROR (("OSD failed to initialize, %s\n",
166 AcpiFormatException (Status)));
167 return_ACPI_STATUS (Status);
168 }
169
170 /* Create the default mutex objects */
171
172 Status = AcpiUtMutexInitialize ();
173 if (ACPI_FAILURE (Status))
174 {
175 ACPI_REPORT_ERROR (("Global mutex creation failure, %s\n",
176 AcpiFormatException (Status)));
177 return_ACPI_STATUS (Status);
178 }
179
180 /*
181 * Initialize the namespace manager and
182 * the root of the namespace tree
183 */
184
185 Status = AcpiNsRootInitialize ();
186 if (ACPI_FAILURE (Status))
187 {
188 ACPI_REPORT_ERROR (("Namespace initialization failure, %s\n",
189 AcpiFormatException (Status)));
190 return_ACPI_STATUS (Status);
191 }
192
193
194 /* If configured, initialize the AML debugger */
195
196 ACPI_DEBUGGER_EXEC (Status = AcpiDbInitialize ());
197
198 return_ACPI_STATUS (Status);
199}
200
201
202/*******************************************************************************
203 *
204 * FUNCTION: AcpiEnableSubsystem
205 *
206 * PARAMETERS: Flags - Init/enable Options
207 *
208 * RETURN: Status
209 *
210 * DESCRIPTION: Completes the subsystem initialization including hardware.
211 * Puts system into ACPI mode if it isn't already.
212 *
213 ******************************************************************************/
214
215ACPI_STATUS
216AcpiEnableSubsystem (
217 UINT32 Flags)
218{
219 ACPI_STATUS Status = AE_OK;
220
221
222 ACPI_FUNCTION_TRACE ("AcpiEnableSubsystem");
223
224
225 /*
226 * We must initialize the hardware before we can enable ACPI.
227 * The values from the FADT are validated here.
228 */
229 if (!(Flags & ACPI_NO_HARDWARE_INIT))
230 {
231 ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "[Init] Initializing ACPI hardware\n"));
232
233 Status = AcpiHwInitialize ();
234 if (ACPI_FAILURE (Status))
235 {
236 return_ACPI_STATUS (Status);
237 }
238 }
239
240 /*
241 * Enable ACPI mode
242 */
243 if (!(Flags & ACPI_NO_ACPI_ENABLE))
244 {
245 ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "[Init] Going into ACPI mode\n"));
246
247 AcpiGbl_OriginalMode = AcpiHwGetMode();
248
249 Status = AcpiEnable ();
250 if (ACPI_FAILURE (Status))
251 {
252 ACPI_DEBUG_PRINT ((ACPI_DB_WARN, "AcpiEnable failed.\n"));
253 return_ACPI_STATUS (Status);
254 }
255 }
256
257 /*
258 * Initialize ACPI Event handling
259 *
260 * NOTE: We must have the hardware AND events initialized before we can execute
261 * ANY control methods SAFELY. Any control method can require ACPI hardware
262 * support, so the hardware MUST be initialized before execution!
263 */
264 if (!(Flags & ACPI_NO_EVENT_INIT))
265 {
266 ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "[Init] Initializing ACPI events\n"));
267
268 Status = AcpiEvInitialize ();
269 if (ACPI_FAILURE (Status))
270 {
271 return_ACPI_STATUS (Status);
272 }
273 }
274
275 /* Install the SCI handler, Global Lock handler, and GPE handlers */
276
277 if (!(Flags & ACPI_NO_HANDLER_INIT))
278 {
279 ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "[Init] Installing SCI/GL/GPE handlers\n"));
280
281 Status = AcpiEvHandlerInitialize ();
282 if (ACPI_FAILURE (Status))
283 {
284 return_ACPI_STATUS (Status);
285 }
286 }
287
288 return_ACPI_STATUS (Status);
289}
290
291/*******************************************************************************
292 *
293 * FUNCTION: AcpiInitializeObjects
294 *
295 * PARAMETERS: Flags - Init/enable Options
296 *
297 * RETURN: Status
298 *
299 * DESCRIPTION: Completes namespace initialization by initializing device
300 * objects and executing AML code for Regions, buffers, etc.
301 *
302 ******************************************************************************/
303
304ACPI_STATUS
305AcpiInitializeObjects (
306 UINT32 Flags)
307{
308 ACPI_STATUS Status = AE_OK;
309
310
311 ACPI_FUNCTION_TRACE ("AcpiInitializeObjects");
312
313
314 /*
315 * Install the default OpRegion handlers. These are installed unless
316 * other handlers have already been installed via the
317 * InstallAddressSpaceHandler interface.
318 *
319 * NOTE: This will cause _REG methods to be run. Any objects accessed
320 * by the _REG methods will be automatically initialized, even if they
321 * contain executable AML (see call to AcpiNsInitializeObjects below).
322 */
323 if (!(Flags & ACPI_NO_ADDRESS_SPACE_INIT))
324 {
325 ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "[Init] Installing default address space handlers\n"));
326
327 Status = AcpiEvInitAddressSpaces ();
328 if (ACPI_FAILURE (Status))
329 {
330 return_ACPI_STATUS (Status);
331 }
332 }
333
334 /*
335 * Initialize the objects that remain uninitialized. This
336 * runs the executable AML that may be part of the declaration of these
337 * objects: OperationRegions, BufferFields, Buffers, and Packages.
338 */
339 if (!(Flags & ACPI_NO_OBJECT_INIT))
340 {
341 ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "[Init] Initializing ACPI Objects\n"));
342
343 Status = AcpiNsInitializeObjects ();
344 if (ACPI_FAILURE (Status))
345 {
346 return_ACPI_STATUS (Status);
347 }
348 }
349
350 /*
351 * Initialize all device objects in the namespace
352 * This runs the _STA and _INI methods.
353 */
354 if (!(Flags & ACPI_NO_DEVICE_INIT))
355 {
356 ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "[Init] Initializing ACPI Devices\n"));
357
358 Status = AcpiNsInitializeDevices ();
359 if (ACPI_FAILURE (Status))
360 {
361 return_ACPI_STATUS (Status);
362 }
363 }
364
365 /*
366 * Empty the caches (delete the cached objects) on the assumption that
367 * the table load filled them up more than they will be at runtime --
368 * thus wasting non-paged memory.
369 */
370 Status = AcpiPurgeCachedObjects ();
371
372 AcpiGbl_StartupFlags |= ACPI_INITIALIZED_OK;
373 return_ACPI_STATUS (Status);
374}
375
376
377/*******************************************************************************
378 *
379 * FUNCTION: AcpiTerminate
380 *
381 * PARAMETERS: None
382 *
383 * RETURN: Status
384 *
385 * DESCRIPTION: Shutdown the ACPI subsystem. Release all resources.
386 *
387 ******************************************************************************/
388
389ACPI_STATUS
390AcpiTerminate (void)
391{
392 ACPI_STATUS Status;
393
394
395 ACPI_FUNCTION_TRACE ("AcpiTerminate");
396
397
398 /* Terminate the AML Debugger if present */
399
400 ACPI_DEBUGGER_EXEC(AcpiGbl_DbTerminateThreads = TRUE);
401
402 /* Shutdown and free all resources */
403
404 AcpiUtSubsystemShutdown ();
405
406
407 /* Free the mutex objects */
408
409 AcpiUtMutexTerminate ();
410
411
412#ifdef ACPI_DEBUGGER
413
414 /* Shut down the debugger */
415
416 AcpiDbTerminate ();
417#endif
418
419 /* Now we can shutdown the OS-dependent layer */
420
421 Status = AcpiOsTerminate ();
422 return_ACPI_STATUS (Status);
423}
424
425
426/*****************************************************************************
427 *
428 * FUNCTION: AcpiSubsystemStatus
429 *
430 * PARAMETERS: None
431 *
432 * RETURN: Status of the ACPI subsystem
433 *
434 * DESCRIPTION: Other drivers that use the ACPI subsystem should call this
435 * before making any other calls, to ensure the subsystem initial-
436 * ized successfully.
437 *
438 ****************************************************************************/
439
440ACPI_STATUS
441AcpiSubsystemStatus (void)
442{
443 if (AcpiGbl_StartupFlags & ACPI_INITIALIZED_OK)
444 {
445 return (AE_OK);
446 }
447 else
448 {
449 return (AE_ERROR);
450 }
451}
452
453
454/******************************************************************************
455 *
456 * FUNCTION: AcpiGetSystemInfo
457 *
458 * PARAMETERS: OutBuffer - a pointer to a buffer to receive the
459 * resources for the device
460 * BufferLength - the number of bytes available in the buffer
461 *
462 * RETURN: Status - the status of the call
463 *
464 * DESCRIPTION: This function is called to get information about the current
465 * state of the ACPI subsystem. It will return system information
466 * in the OutBuffer.
467 *
468 * If the function fails an appropriate status will be returned
469 * and the value of OutBuffer is undefined.
470 *
471 ******************************************************************************/
472
473ACPI_STATUS
474AcpiGetSystemInfo (
475 ACPI_BUFFER *OutBuffer)
476{
477 ACPI_SYSTEM_INFO *InfoPtr;
478 UINT32 i;
479 ACPI_STATUS Status;
480
481
482 ACPI_FUNCTION_TRACE ("AcpiGetSystemInfo");
483
484
485 /* Parameter validation */
486
487 Status = AcpiUtValidateBuffer (OutBuffer);
488 if (ACPI_FAILURE (Status))
489 {
490 return_ACPI_STATUS (Status);
491 }
492
493 /* Validate/Allocate/Clear caller buffer */
494
495 Status = AcpiUtInitializeBuffer (OutBuffer, sizeof (ACPI_SYSTEM_INFO));
496 if (ACPI_FAILURE (Status))
497 {
498 return_ACPI_STATUS (Status);
499 }
500
501 /*
502 * Populate the return buffer
503 */
504 InfoPtr = (ACPI_SYSTEM_INFO *) OutBuffer->Pointer;
505
506 InfoPtr->AcpiCaVersion = ACPI_CA_VERSION;
507
508 /* System flags (ACPI capabilities) */
509
510 InfoPtr->Flags = ACPI_SYS_MODE_ACPI;
511
512 /* Timer resolution - 24 or 32 bits */
513
514 if (!AcpiGbl_FADT)
515 {
516 InfoPtr->TimerResolution = 0;
517 }
518 else if (AcpiGbl_FADT->TmrValExt == 0)
519 {
520 InfoPtr->TimerResolution = 24;
521 }
522 else
523 {
524 InfoPtr->TimerResolution = 32;
525 }
526
527 /* Clear the reserved fields */
528
529 InfoPtr->Reserved1 = 0;
530 InfoPtr->Reserved2 = 0;
531
532 /* Current debug levels */
533
534 InfoPtr->DebugLayer = AcpiDbgLayer;
535 InfoPtr->DebugLevel = AcpiDbgLevel;
536
537 /* Current status of the ACPI tables, per table type */
538
539 InfoPtr->NumTableTypes = NUM_ACPI_TABLE_TYPES;
540 for (i = 0; i < NUM_ACPI_TABLE_TYPES; i++)
541 {
542 InfoPtr->TableInfo[i].Count = AcpiGbl_TableLists[i].Count;
543 }
544
545 return_ACPI_STATUS (AE_OK);
546}
547
548
549/*****************************************************************************
550 *
551 * FUNCTION: AcpiInstallInitializationHandler
552 *
553 * PARAMETERS: Handler - Callback procedure
554 *
555 * RETURN: Status
556 *
557 * DESCRIPTION: Install an initialization handler
558 *
559 * TBD: When a second function is added, must save the Function also.
560 *
561 ****************************************************************************/
562
563ACPI_STATUS
564AcpiInstallInitializationHandler (
565 ACPI_INIT_HANDLER Handler,
566 UINT32 Function)
567{
568
569 if (!Handler)
570 {
571 return (AE_BAD_PARAMETER);
572 }
573
574 if (AcpiGbl_InitHandler)
575 {
576 return (AE_ALREADY_EXISTS);
577 }
578
579 AcpiGbl_InitHandler = Handler;
580 return AE_OK;
581}
582
583
584/*****************************************************************************
585 *
586 * FUNCTION: AcpiPurgeCachedObjects
587 *
588 * PARAMETERS: None
589 *
590 * RETURN: Status
591 *
592 * DESCRIPTION: Empty all caches (delete the cached objects)
593 *
594 ****************************************************************************/
595
596ACPI_STATUS
597AcpiPurgeCachedObjects (void)
598{
599 ACPI_FUNCTION_TRACE ("AcpiPurgeCachedObjects");
600
601
602 AcpiUtDeleteGenericStateCache ();
603 AcpiUtDeleteObjectCache ();
604 AcpiDsDeleteWalkStateCache ();
605 AcpiPsDeleteParseCache ();
606
607 return_ACPI_STATUS (AE_OK);
608}
| 13 * All rights reserved.
14 *
15 * 2. License
16 *
17 * 2.1. This is your license from Intel Corp. under its intellectual property
18 * rights. You may have additional license terms from the party that provided
19 * you this software, covering your right to use that party's intellectual
20 * property rights.
21 *
22 * 2.2. Intel grants, free of charge, to any person ("Licensee") obtaining a
23 * copy of the source code appearing in this file ("Covered Code") an
24 * irrevocable, perpetual, worldwide license under Intel's copyrights in the
25 * base code distributed originally by Intel ("Original Intel Code") to copy,
26 * make derivatives, distribute, use and display any portion of the Covered
27 * Code in any form, with the right to sublicense such rights; and
28 *
29 * 2.3. Intel grants Licensee a non-exclusive and non-transferable patent
30 * license (with the right to sublicense), under only those claims of Intel
31 * patents that are infringed by the Original Intel Code, to make, use, sell,
32 * offer to sell, and import the Covered Code and derivative works thereof
33 * solely to the minimum extent necessary to exercise the above copyright
34 * license, and in no event shall the patent license extend to any additions
35 * to or modifications of the Original Intel Code. No other license or right
36 * is granted directly or by implication, estoppel or otherwise;
37 *
38 * The above copyright and patent license is granted only if the following
39 * conditions are met:
40 *
41 * 3. Conditions
42 *
43 * 3.1. Redistribution of Source with Rights to Further Distribute Source.
44 * Redistribution of source code of any substantial portion of the Covered
45 * Code or modification with rights to further distribute source must include
46 * the above Copyright Notice, the above License, this list of Conditions,
47 * and the following Disclaimer and Export Compliance provision. In addition,
48 * Licensee must cause all Covered Code to which Licensee contributes to
49 * contain a file documenting the changes Licensee made to create that Covered
50 * Code and the date of any change. Licensee must include in that file the
51 * documentation of any changes made by any predecessor Licensee. Licensee
52 * must include a prominent statement that the modification is derived,
53 * directly or indirectly, from Original Intel Code.
54 *
55 * 3.2. Redistribution of Source with no Rights to Further Distribute Source.
56 * Redistribution of source code of any substantial portion of the Covered
57 * Code or modification without rights to further distribute source must
58 * include the following Disclaimer and Export Compliance provision in the
59 * documentation and/or other materials provided with distribution. In
60 * addition, Licensee may not authorize further sublicense of source of any
61 * portion of the Covered Code, and must include terms to the effect that the
62 * license from Licensee to its licensee is limited to the intellectual
63 * property embodied in the software Licensee provides to its licensee, and
64 * not to intellectual property embodied in modifications its licensee may
65 * make.
66 *
67 * 3.3. Redistribution of Executable. Redistribution in executable form of any
68 * substantial portion of the Covered Code or modification must reproduce the
69 * above Copyright Notice, and the following Disclaimer and Export Compliance
70 * provision in the documentation and/or other materials provided with the
71 * distribution.
72 *
73 * 3.4. Intel retains all right, title, and interest in and to the Original
74 * Intel Code.
75 *
76 * 3.5. Neither the name Intel nor any other trademark owned or controlled by
77 * Intel shall be used in advertising or otherwise to promote the sale, use or
78 * other dealings in products derived from or relating to the Covered Code
79 * without prior written authorization from Intel.
80 *
81 * 4. Disclaimer and Export Compliance
82 *
83 * 4.1. INTEL MAKES NO WARRANTY OF ANY KIND REGARDING ANY SOFTWARE PROVIDED
84 * HERE. ANY SOFTWARE ORIGINATING FROM INTEL OR DERIVED FROM INTEL SOFTWARE
85 * IS PROVIDED "AS IS," AND INTEL WILL NOT PROVIDE ANY SUPPORT, ASSISTANCE,
86 * INSTALLATION, TRAINING OR OTHER SERVICES. INTEL WILL NOT PROVIDE ANY
87 * UPDATES, ENHANCEMENTS OR EXTENSIONS. INTEL SPECIFICALLY DISCLAIMS ANY
88 * IMPLIED WARRANTIES OF MERCHANTABILITY, NONINFRINGEMENT AND FITNESS FOR A
89 * PARTICULAR PURPOSE.
90 *
91 * 4.2. IN NO EVENT SHALL INTEL HAVE ANY LIABILITY TO LICENSEE, ITS LICENSEES
92 * OR ANY OTHER THIRD PARTY, FOR ANY LOST PROFITS, LOST DATA, LOSS OF USE OR
93 * COSTS OF PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES, OR FOR ANY INDIRECT,
94 * SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THIS AGREEMENT, UNDER ANY
95 * CAUSE OF ACTION OR THEORY OF LIABILITY, AND IRRESPECTIVE OF WHETHER INTEL
96 * HAS ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES. THESE LIMITATIONS
97 * SHALL APPLY NOTWITHSTANDING THE FAILURE OF THE ESSENTIAL PURPOSE OF ANY
98 * LIMITED REMEDY.
99 *
100 * 4.3. Licensee shall not export, either directly or indirectly, any of this
101 * software or system incorporating such software without first obtaining any
102 * required license or other approval from the U. S. Department of Commerce or
103 * any other agency or department of the United States Government. In the
104 * event Licensee exports any such software from the United States or
105 * re-exports any such software from a foreign destination, Licensee shall
106 * ensure that the distribution and export/re-export of the software is in
107 * compliance with all laws, regulations, orders, or other restrictions of the
108 * U.S. Export Administration Regulations. Licensee agrees that neither it nor
109 * any of its subsidiaries will export/re-export any technical data, process,
110 * software, or service, directly or indirectly, to any country for which the
111 * United States government or any agency thereof requires an export license,
112 * other governmental approval, or letter of assurance, without first obtaining
113 * such license, approval or letter.
114 *
115 *****************************************************************************/
116
117
118#define __UTXFACE_C__
119
120#include "acpi.h"
121#include "acevents.h"
122#include "acnamesp.h"
123#include "acparser.h"
124#include "acdispat.h"
125#include "acdebug.h"
126
127#define _COMPONENT ACPI_UTILITIES
128 ACPI_MODULE_NAME ("utxface")
129
130
131/*******************************************************************************
132 *
133 * FUNCTION: AcpiInitializeSubsystem
134 *
135 * PARAMETERS: None
136 *
137 * RETURN: Status
138 *
139 * DESCRIPTION: Initializes all global variables. This is the first function
140 * called, so any early initialization belongs here.
141 *
142 ******************************************************************************/
143
144ACPI_STATUS
145AcpiInitializeSubsystem (
146 void)
147{
148 ACPI_STATUS Status;
149
150 ACPI_FUNCTION_TRACE ("AcpiInitializeSubsystem");
151
152
153 ACPI_DEBUG_EXEC (AcpiUtInitStackPtrTrace ());
154
155
156 /* Initialize all globals used by the subsystem */
157
158 AcpiUtInitGlobals ();
159
160 /* Initialize the OS-Dependent layer */
161
162 Status = AcpiOsInitialize ();
163 if (ACPI_FAILURE (Status))
164 {
165 ACPI_REPORT_ERROR (("OSD failed to initialize, %s\n",
166 AcpiFormatException (Status)));
167 return_ACPI_STATUS (Status);
168 }
169
170 /* Create the default mutex objects */
171
172 Status = AcpiUtMutexInitialize ();
173 if (ACPI_FAILURE (Status))
174 {
175 ACPI_REPORT_ERROR (("Global mutex creation failure, %s\n",
176 AcpiFormatException (Status)));
177 return_ACPI_STATUS (Status);
178 }
179
180 /*
181 * Initialize the namespace manager and
182 * the root of the namespace tree
183 */
184
185 Status = AcpiNsRootInitialize ();
186 if (ACPI_FAILURE (Status))
187 {
188 ACPI_REPORT_ERROR (("Namespace initialization failure, %s\n",
189 AcpiFormatException (Status)));
190 return_ACPI_STATUS (Status);
191 }
192
193
194 /* If configured, initialize the AML debugger */
195
196 ACPI_DEBUGGER_EXEC (Status = AcpiDbInitialize ());
197
198 return_ACPI_STATUS (Status);
199}
200
201
202/*******************************************************************************
203 *
204 * FUNCTION: AcpiEnableSubsystem
205 *
206 * PARAMETERS: Flags - Init/enable Options
207 *
208 * RETURN: Status
209 *
210 * DESCRIPTION: Completes the subsystem initialization including hardware.
211 * Puts system into ACPI mode if it isn't already.
212 *
213 ******************************************************************************/
214
215ACPI_STATUS
216AcpiEnableSubsystem (
217 UINT32 Flags)
218{
219 ACPI_STATUS Status = AE_OK;
220
221
222 ACPI_FUNCTION_TRACE ("AcpiEnableSubsystem");
223
224
225 /*
226 * We must initialize the hardware before we can enable ACPI.
227 * The values from the FADT are validated here.
228 */
229 if (!(Flags & ACPI_NO_HARDWARE_INIT))
230 {
231 ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "[Init] Initializing ACPI hardware\n"));
232
233 Status = AcpiHwInitialize ();
234 if (ACPI_FAILURE (Status))
235 {
236 return_ACPI_STATUS (Status);
237 }
238 }
239
240 /*
241 * Enable ACPI mode
242 */
243 if (!(Flags & ACPI_NO_ACPI_ENABLE))
244 {
245 ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "[Init] Going into ACPI mode\n"));
246
247 AcpiGbl_OriginalMode = AcpiHwGetMode();
248
249 Status = AcpiEnable ();
250 if (ACPI_FAILURE (Status))
251 {
252 ACPI_DEBUG_PRINT ((ACPI_DB_WARN, "AcpiEnable failed.\n"));
253 return_ACPI_STATUS (Status);
254 }
255 }
256
257 /*
258 * Initialize ACPI Event handling
259 *
260 * NOTE: We must have the hardware AND events initialized before we can execute
261 * ANY control methods SAFELY. Any control method can require ACPI hardware
262 * support, so the hardware MUST be initialized before execution!
263 */
264 if (!(Flags & ACPI_NO_EVENT_INIT))
265 {
266 ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "[Init] Initializing ACPI events\n"));
267
268 Status = AcpiEvInitialize ();
269 if (ACPI_FAILURE (Status))
270 {
271 return_ACPI_STATUS (Status);
272 }
273 }
274
275 /* Install the SCI handler, Global Lock handler, and GPE handlers */
276
277 if (!(Flags & ACPI_NO_HANDLER_INIT))
278 {
279 ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "[Init] Installing SCI/GL/GPE handlers\n"));
280
281 Status = AcpiEvHandlerInitialize ();
282 if (ACPI_FAILURE (Status))
283 {
284 return_ACPI_STATUS (Status);
285 }
286 }
287
288 return_ACPI_STATUS (Status);
289}
290
291/*******************************************************************************
292 *
293 * FUNCTION: AcpiInitializeObjects
294 *
295 * PARAMETERS: Flags - Init/enable Options
296 *
297 * RETURN: Status
298 *
299 * DESCRIPTION: Completes namespace initialization by initializing device
300 * objects and executing AML code for Regions, buffers, etc.
301 *
302 ******************************************************************************/
303
304ACPI_STATUS
305AcpiInitializeObjects (
306 UINT32 Flags)
307{
308 ACPI_STATUS Status = AE_OK;
309
310
311 ACPI_FUNCTION_TRACE ("AcpiInitializeObjects");
312
313
314 /*
315 * Install the default OpRegion handlers. These are installed unless
316 * other handlers have already been installed via the
317 * InstallAddressSpaceHandler interface.
318 *
319 * NOTE: This will cause _REG methods to be run. Any objects accessed
320 * by the _REG methods will be automatically initialized, even if they
321 * contain executable AML (see call to AcpiNsInitializeObjects below).
322 */
323 if (!(Flags & ACPI_NO_ADDRESS_SPACE_INIT))
324 {
325 ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "[Init] Installing default address space handlers\n"));
326
327 Status = AcpiEvInitAddressSpaces ();
328 if (ACPI_FAILURE (Status))
329 {
330 return_ACPI_STATUS (Status);
331 }
332 }
333
334 /*
335 * Initialize the objects that remain uninitialized. This
336 * runs the executable AML that may be part of the declaration of these
337 * objects: OperationRegions, BufferFields, Buffers, and Packages.
338 */
339 if (!(Flags & ACPI_NO_OBJECT_INIT))
340 {
341 ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "[Init] Initializing ACPI Objects\n"));
342
343 Status = AcpiNsInitializeObjects ();
344 if (ACPI_FAILURE (Status))
345 {
346 return_ACPI_STATUS (Status);
347 }
348 }
349
350 /*
351 * Initialize all device objects in the namespace
352 * This runs the _STA and _INI methods.
353 */
354 if (!(Flags & ACPI_NO_DEVICE_INIT))
355 {
356 ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "[Init] Initializing ACPI Devices\n"));
357
358 Status = AcpiNsInitializeDevices ();
359 if (ACPI_FAILURE (Status))
360 {
361 return_ACPI_STATUS (Status);
362 }
363 }
364
365 /*
366 * Empty the caches (delete the cached objects) on the assumption that
367 * the table load filled them up more than they will be at runtime --
368 * thus wasting non-paged memory.
369 */
370 Status = AcpiPurgeCachedObjects ();
371
372 AcpiGbl_StartupFlags |= ACPI_INITIALIZED_OK;
373 return_ACPI_STATUS (Status);
374}
375
376
377/*******************************************************************************
378 *
379 * FUNCTION: AcpiTerminate
380 *
381 * PARAMETERS: None
382 *
383 * RETURN: Status
384 *
385 * DESCRIPTION: Shutdown the ACPI subsystem. Release all resources.
386 *
387 ******************************************************************************/
388
389ACPI_STATUS
390AcpiTerminate (void)
391{
392 ACPI_STATUS Status;
393
394
395 ACPI_FUNCTION_TRACE ("AcpiTerminate");
396
397
398 /* Terminate the AML Debugger if present */
399
400 ACPI_DEBUGGER_EXEC(AcpiGbl_DbTerminateThreads = TRUE);
401
402 /* Shutdown and free all resources */
403
404 AcpiUtSubsystemShutdown ();
405
406
407 /* Free the mutex objects */
408
409 AcpiUtMutexTerminate ();
410
411
412#ifdef ACPI_DEBUGGER
413
414 /* Shut down the debugger */
415
416 AcpiDbTerminate ();
417#endif
418
419 /* Now we can shutdown the OS-dependent layer */
420
421 Status = AcpiOsTerminate ();
422 return_ACPI_STATUS (Status);
423}
424
425
426/*****************************************************************************
427 *
428 * FUNCTION: AcpiSubsystemStatus
429 *
430 * PARAMETERS: None
431 *
432 * RETURN: Status of the ACPI subsystem
433 *
434 * DESCRIPTION: Other drivers that use the ACPI subsystem should call this
435 * before making any other calls, to ensure the subsystem initial-
436 * ized successfully.
437 *
438 ****************************************************************************/
439
440ACPI_STATUS
441AcpiSubsystemStatus (void)
442{
443 if (AcpiGbl_StartupFlags & ACPI_INITIALIZED_OK)
444 {
445 return (AE_OK);
446 }
447 else
448 {
449 return (AE_ERROR);
450 }
451}
452
453
454/******************************************************************************
455 *
456 * FUNCTION: AcpiGetSystemInfo
457 *
458 * PARAMETERS: OutBuffer - a pointer to a buffer to receive the
459 * resources for the device
460 * BufferLength - the number of bytes available in the buffer
461 *
462 * RETURN: Status - the status of the call
463 *
464 * DESCRIPTION: This function is called to get information about the current
465 * state of the ACPI subsystem. It will return system information
466 * in the OutBuffer.
467 *
468 * If the function fails an appropriate status will be returned
469 * and the value of OutBuffer is undefined.
470 *
471 ******************************************************************************/
472
473ACPI_STATUS
474AcpiGetSystemInfo (
475 ACPI_BUFFER *OutBuffer)
476{
477 ACPI_SYSTEM_INFO *InfoPtr;
478 UINT32 i;
479 ACPI_STATUS Status;
480
481
482 ACPI_FUNCTION_TRACE ("AcpiGetSystemInfo");
483
484
485 /* Parameter validation */
486
487 Status = AcpiUtValidateBuffer (OutBuffer);
488 if (ACPI_FAILURE (Status))
489 {
490 return_ACPI_STATUS (Status);
491 }
492
493 /* Validate/Allocate/Clear caller buffer */
494
495 Status = AcpiUtInitializeBuffer (OutBuffer, sizeof (ACPI_SYSTEM_INFO));
496 if (ACPI_FAILURE (Status))
497 {
498 return_ACPI_STATUS (Status);
499 }
500
501 /*
502 * Populate the return buffer
503 */
504 InfoPtr = (ACPI_SYSTEM_INFO *) OutBuffer->Pointer;
505
506 InfoPtr->AcpiCaVersion = ACPI_CA_VERSION;
507
508 /* System flags (ACPI capabilities) */
509
510 InfoPtr->Flags = ACPI_SYS_MODE_ACPI;
511
512 /* Timer resolution - 24 or 32 bits */
513
514 if (!AcpiGbl_FADT)
515 {
516 InfoPtr->TimerResolution = 0;
517 }
518 else if (AcpiGbl_FADT->TmrValExt == 0)
519 {
520 InfoPtr->TimerResolution = 24;
521 }
522 else
523 {
524 InfoPtr->TimerResolution = 32;
525 }
526
527 /* Clear the reserved fields */
528
529 InfoPtr->Reserved1 = 0;
530 InfoPtr->Reserved2 = 0;
531
532 /* Current debug levels */
533
534 InfoPtr->DebugLayer = AcpiDbgLayer;
535 InfoPtr->DebugLevel = AcpiDbgLevel;
536
537 /* Current status of the ACPI tables, per table type */
538
539 InfoPtr->NumTableTypes = NUM_ACPI_TABLE_TYPES;
540 for (i = 0; i < NUM_ACPI_TABLE_TYPES; i++)
541 {
542 InfoPtr->TableInfo[i].Count = AcpiGbl_TableLists[i].Count;
543 }
544
545 return_ACPI_STATUS (AE_OK);
546}
547
548
549/*****************************************************************************
550 *
551 * FUNCTION: AcpiInstallInitializationHandler
552 *
553 * PARAMETERS: Handler - Callback procedure
554 *
555 * RETURN: Status
556 *
557 * DESCRIPTION: Install an initialization handler
558 *
559 * TBD: When a second function is added, must save the Function also.
560 *
561 ****************************************************************************/
562
563ACPI_STATUS
564AcpiInstallInitializationHandler (
565 ACPI_INIT_HANDLER Handler,
566 UINT32 Function)
567{
568
569 if (!Handler)
570 {
571 return (AE_BAD_PARAMETER);
572 }
573
574 if (AcpiGbl_InitHandler)
575 {
576 return (AE_ALREADY_EXISTS);
577 }
578
579 AcpiGbl_InitHandler = Handler;
580 return AE_OK;
581}
582
583
584/*****************************************************************************
585 *
586 * FUNCTION: AcpiPurgeCachedObjects
587 *
588 * PARAMETERS: None
589 *
590 * RETURN: Status
591 *
592 * DESCRIPTION: Empty all caches (delete the cached objects)
593 *
594 ****************************************************************************/
595
596ACPI_STATUS
597AcpiPurgeCachedObjects (void)
598{
599 ACPI_FUNCTION_TRACE ("AcpiPurgeCachedObjects");
600
601
602 AcpiUtDeleteGenericStateCache ();
603 AcpiUtDeleteObjectCache ();
604 AcpiDsDeleteWalkStateCache ();
605 AcpiPsDeleteParseCache ();
606
607 return_ACPI_STATUS (AE_OK);
608}
|