acpixf.h revision 1.38 1 /******************************************************************************
2 *
3 * Name: acpixf.h - External interfaces to the ACPI subsystem
4 *
5 *****************************************************************************/
6
7 /******************************************************************************
8 *
9 * 1. Copyright Notice
10 *
11 * Some or all of this work - Copyright (c) 1999 - 2025, Intel Corp.
12 * All rights reserved.
13 *
14 * 2. License
15 *
16 * 2.1. This is your license from Intel Corp. under its intellectual property
17 * rights. You may have additional license terms from the party that provided
18 * you this software, covering your right to use that party's intellectual
19 * property rights.
20 *
21 * 2.2. Intel grants, free of charge, to any person ("Licensee") obtaining a
22 * copy of the source code appearing in this file ("Covered Code") an
23 * irrevocable, perpetual, worldwide license under Intel's copyrights in the
24 * base code distributed originally by Intel ("Original Intel Code") to copy,
25 * make derivatives, distribute, use and display any portion of the Covered
26 * Code in any form, with the right to sublicense such rights; and
27 *
28 * 2.3. Intel grants Licensee a non-exclusive and non-transferable patent
29 * license (with the right to sublicense), under only those claims of Intel
30 * patents that are infringed by the Original Intel Code, to make, use, sell,
31 * offer to sell, and import the Covered Code and derivative works thereof
32 * solely to the minimum extent necessary to exercise the above copyright
33 * license, and in no event shall the patent license extend to any additions
34 * to or modifications of the Original Intel Code. No other license or right
35 * is granted directly or by implication, estoppel or otherwise;
36 *
37 * The above copyright and patent license is granted only if the following
38 * conditions are met:
39 *
40 * 3. Conditions
41 *
42 * 3.1. Redistribution of Source with Rights to Further Distribute Source.
43 * Redistribution of source code of any substantial portion of the Covered
44 * Code or modification with rights to further distribute source must include
45 * the above Copyright Notice, the above License, this list of Conditions,
46 * and the following Disclaimer and Export Compliance provision. In addition,
47 * Licensee must cause all Covered Code to which Licensee contributes to
48 * contain a file documenting the changes Licensee made to create that Covered
49 * Code and the date of any change. Licensee must include in that file the
50 * documentation of any changes made by any predecessor Licensee. Licensee
51 * must include a prominent statement that the modification is derived,
52 * directly or indirectly, from Original Intel Code.
53 *
54 * 3.2. Redistribution of Source with no Rights to Further Distribute Source.
55 * Redistribution of source code of any substantial portion of the Covered
56 * Code or modification without rights to further distribute source must
57 * include the following Disclaimer and Export Compliance provision in the
58 * documentation and/or other materials provided with distribution. In
59 * addition, Licensee may not authorize further sublicense of source of any
60 * portion of the Covered Code, and must include terms to the effect that the
61 * license from Licensee to its licensee is limited to the intellectual
62 * property embodied in the software Licensee provides to its licensee, and
63 * not to intellectual property embodied in modifications its licensee may
64 * make.
65 *
66 * 3.3. Redistribution of Executable. Redistribution in executable form of any
67 * substantial portion of the Covered Code or modification must reproduce the
68 * above Copyright Notice, and the following Disclaimer and Export Compliance
69 * provision in the documentation and/or other materials provided with the
70 * distribution.
71 *
72 * 3.4. Intel retains all right, title, and interest in and to the Original
73 * Intel Code.
74 *
75 * 3.5. Neither the name Intel nor any other trademark owned or controlled by
76 * Intel shall be used in advertising or otherwise to promote the sale, use or
77 * other dealings in products derived from or relating to the Covered Code
78 * without prior written authorization from Intel.
79 *
80 * 4. Disclaimer and Export Compliance
81 *
82 * 4.1. INTEL MAKES NO WARRANTY OF ANY KIND REGARDING ANY SOFTWARE PROVIDED
83 * HERE. ANY SOFTWARE ORIGINATING FROM INTEL OR DERIVED FROM INTEL SOFTWARE
84 * IS PROVIDED "AS IS," AND INTEL WILL NOT PROVIDE ANY SUPPORT, ASSISTANCE,
85 * INSTALLATION, TRAINING OR OTHER SERVICES. INTEL WILL NOT PROVIDE ANY
86 * UPDATES, ENHANCEMENTS OR EXTENSIONS. INTEL SPECIFICALLY DISCLAIMS ANY
87 * IMPLIED WARRANTIES OF MERCHANTABILITY, NONINFRINGEMENT AND FITNESS FOR A
88 * PARTICULAR PURPOSE.
89 *
90 * 4.2. IN NO EVENT SHALL INTEL HAVE ANY LIABILITY TO LICENSEE, ITS LICENSEES
91 * OR ANY OTHER THIRD PARTY, FOR ANY LOST PROFITS, LOST DATA, LOSS OF USE OR
92 * COSTS OF PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES, OR FOR ANY INDIRECT,
93 * SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THIS AGREEMENT, UNDER ANY
94 * CAUSE OF ACTION OR THEORY OF LIABILITY, AND IRRESPECTIVE OF WHETHER INTEL
95 * HAS ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES. THESE LIMITATIONS
96 * SHALL APPLY NOTWITHSTANDING THE FAILURE OF THE ESSENTIAL PURPOSE OF ANY
97 * LIMITED REMEDY.
98 *
99 * 4.3. Licensee shall not export, either directly or indirectly, any of this
100 * software or system incorporating such software without first obtaining any
101 * required license or other approval from the U. S. Department of Commerce or
102 * any other agency or department of the United States Government. In the
103 * event Licensee exports any such software from the United States or
104 * re-exports any such software from a foreign destination, Licensee shall
105 * ensure that the distribution and export/re-export of the software is in
106 * compliance with all laws, regulations, orders, or other restrictions of the
107 * U.S. Export Administration Regulations. Licensee agrees that neither it nor
108 * any of its subsidiaries will export/re-export any technical data, process,
109 * software, or service, directly or indirectly, to any country for which the
110 * United States government or any agency thereof requires an export license,
111 * other governmental approval, or letter of assurance, without first obtaining
112 * such license, approval or letter.
113 *
114 *****************************************************************************
115 *
116 * Alternatively, you may choose to be licensed under the terms of the
117 * following license:
118 *
119 * Redistribution and use in source and binary forms, with or without
120 * modification, are permitted provided that the following conditions
121 * are met:
122 * 1. Redistributions of source code must retain the above copyright
123 * notice, this list of conditions, and the following disclaimer,
124 * without modification.
125 * 2. Redistributions in binary form must reproduce at minimum a disclaimer
126 * substantially similar to the "NO WARRANTY" disclaimer below
127 * ("Disclaimer") and any redistribution must be conditioned upon
128 * including a substantially similar Disclaimer requirement for further
129 * binary redistribution.
130 * 3. Neither the names of the above-listed copyright holders nor the names
131 * of any contributors may be used to endorse or promote products derived
132 * from this software without specific prior written permission.
133 *
134 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
135 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
136 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
137 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
138 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
139 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
140 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
141 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
142 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
143 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
144 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
145 *
146 * Alternatively, you may choose to be licensed under the terms of the
147 * GNU General Public License ("GPL") version 2 as published by the Free
148 * Software Foundation.
149 *
150 *****************************************************************************/
151
152 #ifndef __ACXFACE_H__
153 #define __ACXFACE_H__
154
155 /* Current ACPICA subsystem version in YYYYMMDD format */
156
157 #define ACPI_CA_VERSION 0x20250807
158
159 #include "acconfig.h"
160 #include "actypes.h"
161 #include "actbl.h"
162 #include "acbuffer.h"
163
164
165 /*****************************************************************************
166 *
167 * Macros used for ACPICA globals and configuration
168 *
169 ****************************************************************************/
170
171 /*
172 * Ensure that global variables are defined and initialized only once.
173 *
174 * The use of these macros allows for a single list of globals (here)
175 * in order to simplify maintenance of the code.
176 */
177 #ifdef DEFINE_ACPI_GLOBALS
178 #define ACPI_GLOBAL(type,name) \
179 extern type name; \
180 type name
181
182 #define ACPI_INIT_GLOBAL(type,name,value) \
183 type name=value
184
185 #else
186 #ifndef ACPI_GLOBAL
187 #define ACPI_GLOBAL(type,name) \
188 extern type name
189 #endif
190
191 #ifndef ACPI_INIT_GLOBAL
192 #define ACPI_INIT_GLOBAL(type,name,value) \
193 extern type name
194 #endif
195 #endif
196
197 /*
198 * These macros configure the various ACPICA interfaces. They are
199 * useful for generating stub inline functions for features that are
200 * configured out of the current kernel or ACPICA application.
201 */
202 #ifndef ACPI_EXTERNAL_RETURN_STATUS
203 #define ACPI_EXTERNAL_RETURN_STATUS(Prototype) \
204 Prototype;
205 #endif
206
207 #ifndef ACPI_EXTERNAL_RETURN_OK
208 #define ACPI_EXTERNAL_RETURN_OK(Prototype) \
209 Prototype;
210 #endif
211
212 #ifndef ACPI_EXTERNAL_RETURN_VOID
213 #define ACPI_EXTERNAL_RETURN_VOID(Prototype) \
214 Prototype;
215 #endif
216
217 #ifndef ACPI_EXTERNAL_RETURN_UINT32
218 #define ACPI_EXTERNAL_RETURN_UINT32(Prototype) \
219 Prototype;
220 #endif
221
222 #ifndef ACPI_EXTERNAL_RETURN_PTR
223 #define ACPI_EXTERNAL_RETURN_PTR(Prototype) \
224 Prototype;
225 #endif
226
227
228 /*****************************************************************************
229 *
230 * Public globals and runtime configuration options
231 *
232 ****************************************************************************/
233
234 /*
235 * Enable "slack mode" of the AML interpreter? Default is FALSE, and the
236 * interpreter strictly follows the ACPI specification. Setting to TRUE
237 * allows the interpreter to ignore certain errors and/or bad AML constructs.
238 *
239 * Currently, these features are enabled by this flag:
240 *
241 * 1) Allow "implicit return" of last value in a control method
242 * 2) Allow access beyond the end of an operation region
243 * 3) Allow access to uninitialized locals/args (auto-init to integer 0)
244 * 4) Allow ANY object type to be a source operand for the Store() operator
245 * 5) Allow unresolved references (invalid target name) in package objects
246 * 6) Enable warning messages for behavior that is not ACPI spec compliant
247 */
248 ACPI_INIT_GLOBAL (UINT8, AcpiGbl_EnableInterpreterSlack, FALSE);
249
250 /*
251 * Automatically serialize all methods that create named objects? Default
252 * is TRUE, meaning that all NonSerialized methods are scanned once at
253 * table load time to determine those that create named objects. Methods
254 * that create named objects are marked Serialized in order to prevent
255 * possible run-time problems if they are entered by more than one thread.
256 */
257 ACPI_INIT_GLOBAL (UINT8, AcpiGbl_AutoSerializeMethods, TRUE);
258
259 /*
260 * Create the predefined _OSI method in the namespace? Default is TRUE
261 * because ACPICA is fully compatible with other ACPI implementations.
262 * Changing this will revert ACPICA (and machine ASL) to pre-OSI behavior.
263 */
264 ACPI_INIT_GLOBAL (UINT8, AcpiGbl_CreateOsiMethod, TRUE);
265
266 /*
267 * Optionally use default values for the ACPI register widths. Set this to
268 * TRUE to use the defaults, if an FADT contains incorrect widths/lengths.
269 */
270 ACPI_INIT_GLOBAL (UINT8, AcpiGbl_UseDefaultRegisterWidths, TRUE);
271
272 /*
273 * Whether or not to validate (map) an entire table to verify
274 * checksum/duplication in early stage before install. Set this to TRUE to
275 * allow early table validation before install it to the table manager.
276 * Note that enabling this option causes errors to happen in some OSPMs
277 * during early initialization stages. Default behavior is to allow such
278 * validation.
279 */
280 ACPI_INIT_GLOBAL (UINT8, AcpiGbl_EnableTableValidation, TRUE);
281
282 /*
283 * Optionally enable output from the AML Debug Object.
284 */
285 ACPI_INIT_GLOBAL (_Bool, AcpiGbl_EnableAmlDebugObject, FALSE);
286
287 /*
288 * Optionally copy the entire DSDT to local memory (instead of simply
289 * mapping it.) There are some BIOSs that corrupt or replace the original
290 * DSDT, creating the need for this option. Default is FALSE, do not copy
291 * the DSDT.
292 */
293 ACPI_INIT_GLOBAL (UINT8, AcpiGbl_CopyDsdtLocally, FALSE);
294
295 /*
296 * Optionally ignore an XSDT if present and use the RSDT instead.
297 * Although the ACPI specification requires that an XSDT be used instead
298 * of the RSDT, the XSDT has been found to be corrupt or ill-formed on
299 * some machines. Default behavior is to use the XSDT if present.
300 */
301 ACPI_INIT_GLOBAL (UINT8, AcpiGbl_DoNotUseXsdt, FALSE);
302
303 /*
304 * Optionally use 32-bit FADT addresses if and when there is a conflict
305 * (address mismatch) between the 32-bit and 64-bit versions of the
306 * address. Although ACPICA adheres to the ACPI specification which
307 * requires the use of the corresponding 64-bit address if it is non-zero,
308 * some machines have been found to have a corrupted non-zero 64-bit
309 * address. Default is FALSE, do not favor the 32-bit addresses.
310 */
311 ACPI_INIT_GLOBAL (UINT8, AcpiGbl_Use32BitFadtAddresses, FALSE);
312
313 /*
314 * Optionally use 32-bit FACS table addresses.
315 * It is reported that some platforms fail to resume from system suspending
316 * if 64-bit FACS table address is selected:
317 * https://bugzilla.kernel.org/show_bug.cgi?id=74021
318 * Default is TRUE, favor the 32-bit addresses.
319 */
320 ACPI_INIT_GLOBAL (UINT8, AcpiGbl_Use32BitFacsAddresses, TRUE);
321
322 /*
323 * Optionally truncate I/O addresses to 16 bits. Provides compatibility
324 * with other ACPI implementations. NOTE: During ACPICA initialization,
325 * this value is set to TRUE if any Windows OSI strings have been
326 * requested by the BIOS.
327 */
328 ACPI_INIT_GLOBAL (UINT8, AcpiGbl_TruncateIoAddresses, FALSE);
329
330 /*
331 * Disable runtime checking and repair of values returned by control methods.
332 * Use only if the repair is causing a problem on a particular machine.
333 */
334 ACPI_INIT_GLOBAL (UINT8, AcpiGbl_DisableAutoRepair, FALSE);
335
336 /*
337 * Optionally do not install any SSDTs from the RSDT/XSDT during initialization.
338 * This can be useful for debugging ACPI problems on some machines.
339 */
340 ACPI_INIT_GLOBAL (UINT8, AcpiGbl_DisableSsdtTableInstall, FALSE);
341
342 /*
343 * Optionally enable runtime namespace override.
344 */
345 ACPI_INIT_GLOBAL (UINT8, AcpiGbl_RuntimeNamespaceOverride, TRUE);
346
347 /*
348 * We keep track of the latest version of Windows that has been requested by
349 * the BIOS. ACPI 5.0.
350 */
351 ACPI_INIT_GLOBAL (UINT8, AcpiGbl_OsiData, 0);
352
353 /*
354 * ACPI 5.0 introduces the concept of a "reduced hardware platform", meaning
355 * that the ACPI hardware is no longer required. A flag in the FADT indicates
356 * a reduced HW machine, and that flag is duplicated here for convenience.
357 */
358 ACPI_INIT_GLOBAL (BOOLEAN, AcpiGbl_ReducedHardware, FALSE);
359
360 /*
361 * ACPI Global Lock is mainly used for systems with SMM, so no-SMM systems
362 * (such as LoongArch) may not have and not use Global Lock.
363 */
364 ACPI_INIT_GLOBAL (BOOLEAN, AcpiGbl_UseGlobalLock, TRUE);
365
366 /*
367 * Maximum timeout for While() loop iterations before forced method abort.
368 * This mechanism is intended to prevent infinite loops during interpreter
369 * execution within a host kernel.
370 */
371 ACPI_INIT_GLOBAL (UINT32, AcpiGbl_MaxLoopIterations, ACPI_MAX_LOOP_TIMEOUT);
372
373 /*
374 * Optionally ignore AE_NOT_FOUND errors from named reference package elements
375 * during DSDT/SSDT table loading. This reduces error "noise" in platforms
376 * whose firmware is carrying around a bunch of unused package objects that
377 * refer to non-existent named objects. However, If the AML actually tries to
378 * use such a package, the unresolved element(s) will be replaced with NULL
379 * elements.
380 */
381 ACPI_INIT_GLOBAL (BOOLEAN, AcpiGbl_IgnorePackageResolutionErrors, FALSE);
382
383 /*
384 * This mechanism is used to trace a specified AML method. The method is
385 * traced each time it is executed.
386 */
387 ACPI_INIT_GLOBAL (UINT32, AcpiGbl_TraceFlags, 0);
388 ACPI_INIT_GLOBAL (const char *, AcpiGbl_TraceMethodName, NULL);
389 ACPI_INIT_GLOBAL (UINT32, AcpiGbl_TraceDbgLevel, ACPI_TRACE_LEVEL_DEFAULT);
390 ACPI_INIT_GLOBAL (UINT32, AcpiGbl_TraceDbgLayer, ACPI_TRACE_LAYER_DEFAULT);
391
392 /*
393 * Runtime configuration of debug output control masks. We want the debug
394 * switches statically initialized so they are already set when the debugger
395 * is entered.
396 */
397 #if defined(ACPI_DEBUG_OUTPUT) && defined(ACPI_DEBUG_TRACE)
398 ACPI_INIT_GLOBAL (UINT32, AcpiDbgLevel, ACPI_DEBUG_DEFAULT);
399 #else
400 ACPI_INIT_GLOBAL (UINT32, AcpiDbgLevel, ACPI_NORMAL_DEFAULT);
401 #endif
402 ACPI_INIT_GLOBAL (UINT32, AcpiDbgLayer, ACPI_COMPONENT_DEFAULT);
403
404 /* Optionally enable timer output with Debug Object output */
405
406 ACPI_INIT_GLOBAL (UINT8, AcpiGbl_DisplayDebugTimer, FALSE);
407
408 /*
409 * Debugger command handshake globals. Host OSes need to access these
410 * variables to implement their own command handshake mechanism.
411 */
412 #ifdef ACPI_DEBUGGER
413 ACPI_INIT_GLOBAL (BOOLEAN, AcpiGbl_MethodExecuting, FALSE);
414 ACPI_GLOBAL (char, AcpiGbl_DbLineBuf[ACPI_DB_LINE_BUFFER_SIZE]);
415 #endif
416
417 /*
418 * Other miscellaneous globals
419 */
420 ACPI_GLOBAL (ACPI_TABLE_FADT, AcpiGbl_FADT);
421 ACPI_GLOBAL (UINT32, AcpiCurrentGpeCount);
422 ACPI_GLOBAL (BOOLEAN, AcpiGbl_SystemAwakeAndRunning);
423
424
425 /*****************************************************************************
426 *
427 * ACPICA public interface configuration.
428 *
429 * Interfaces that are configured out of the ACPICA build are replaced
430 * by inlined stubs by default.
431 *
432 ****************************************************************************/
433
434 /*
435 * Hardware-reduced prototypes (default: Not hardware reduced).
436 *
437 * All ACPICA hardware-related interfaces that use these macros will be
438 * configured out of the ACPICA build if the ACPI_REDUCED_HARDWARE flag
439 * is set to TRUE.
440 *
441 * Note: This static build option for reduced hardware is intended to
442 * reduce ACPICA code size if desired or necessary. However, even if this
443 * option is not specified, the runtime behavior of ACPICA is dependent
444 * on the actual FADT reduced hardware flag (HW_REDUCED_ACPI). If set,
445 * the flag will enable similar behavior -- ACPICA will not attempt
446 * to access any ACPI-relate hardware (SCI, GPEs, Fixed Events, etc.)
447 */
448 #if (!ACPI_REDUCED_HARDWARE)
449 #define ACPI_HW_DEPENDENT_RETURN_STATUS(Prototype) \
450 ACPI_EXTERNAL_RETURN_STATUS(Prototype)
451
452 #define ACPI_HW_DEPENDENT_RETURN_OK(Prototype) \
453 ACPI_EXTERNAL_RETURN_OK(Prototype)
454
455 #define ACPI_HW_DEPENDENT_RETURN_UINT32(prototype) \
456 ACPI_EXTERNAL_RETURN_UINT32(prototype)
457
458 #define ACPI_HW_DEPENDENT_RETURN_VOID(Prototype) \
459 ACPI_EXTERNAL_RETURN_VOID(Prototype)
460
461 #else
462 #define ACPI_HW_DEPENDENT_RETURN_STATUS(Prototype) \
463 static ACPI_INLINE Prototype {return(AE_NOT_CONFIGURED);}
464
465 #define ACPI_HW_DEPENDENT_RETURN_OK(Prototype) \
466 static ACPI_INLINE Prototype {return(AE_OK);}
467
468 #define ACPI_HW_DEPENDENT_RETURN_UINT32(prototype) \
469 static ACPI_INLINE prototype {return(0);}
470
471 #define ACPI_HW_DEPENDENT_RETURN_VOID(Prototype) \
472 static ACPI_INLINE Prototype {return;}
473
474 #endif /* !ACPI_REDUCED_HARDWARE */
475
476
477 /*
478 * Error message prototypes (default: error messages enabled).
479 *
480 * All interfaces related to error and warning messages
481 * will be configured out of the ACPICA build if the
482 * ACPI_NO_ERROR_MESSAGE flag is defined.
483 */
484 #ifndef ACPI_NO_ERROR_MESSAGES
485 #define ACPI_MSG_DEPENDENT_RETURN_VOID(Prototype) \
486 Prototype;
487
488 #else
489 #define ACPI_MSG_DEPENDENT_RETURN_VOID(Prototype) \
490 static ACPI_INLINE Prototype {return;}
491
492 #endif /* ACPI_NO_ERROR_MESSAGES */
493
494
495 /*
496 * Debugging output prototypes (default: no debug output).
497 *
498 * All interfaces related to debug output messages
499 * will be configured out of the ACPICA build unless the
500 * ACPI_DEBUG_OUTPUT flag is defined.
501 */
502 #ifdef ACPI_DEBUG_OUTPUT
503 #define ACPI_DBG_DEPENDENT_RETURN_VOID(Prototype) \
504 Prototype;
505
506 #else
507 #define ACPI_DBG_DEPENDENT_RETURN_VOID(Prototype) \
508 static ACPI_INLINE Prototype {return;}
509
510 #endif /* ACPI_DEBUG_OUTPUT */
511
512
513 /*
514 * Application prototypes
515 *
516 * All interfaces used by application will be configured
517 * out of the ACPICA build unless the ACPI_APPLICATION
518 * flag is defined.
519 */
520 #ifdef ACPI_APPLICATION
521 #define ACPI_APP_DEPENDENT_RETURN_VOID(Prototype) \
522 Prototype;
523
524 #else
525 #define ACPI_APP_DEPENDENT_RETURN_VOID(Prototype) \
526 static ACPI_INLINE Prototype {return;}
527
528 #endif /* ACPI_APPLICATION */
529
530
531 /*
532 * Debugger prototypes
533 *
534 * All interfaces used by debugger will be configured
535 * out of the ACPICA build unless the ACPI_DEBUGGER
536 * flag is defined.
537 */
538 #ifdef ACPI_DEBUGGER
539 #define ACPI_DBR_DEPENDENT_RETURN_OK(Prototype) \
540 ACPI_EXTERNAL_RETURN_OK(Prototype)
541
542 #define ACPI_DBR_DEPENDENT_RETURN_VOID(Prototype) \
543 ACPI_EXTERNAL_RETURN_VOID(Prototype)
544
545 #else
546 #define ACPI_DBR_DEPENDENT_RETURN_OK(Prototype) \
547 static ACPI_INLINE Prototype {return(AE_OK);}
548
549 #define ACPI_DBR_DEPENDENT_RETURN_VOID(Prototype) \
550 static ACPI_INLINE Prototype {return;}
551
552 #endif /* ACPI_DEBUGGER */
553
554
555 /*****************************************************************************
556 *
557 * ACPICA public interface prototypes
558 *
559 ****************************************************************************/
560
561 /*
562 * Initialization
563 */
564 ACPI_EXTERNAL_RETURN_STATUS (
565 ACPI_STATUS ACPI_INIT_FUNCTION
566 AcpiInitializeTables (
567 ACPI_TABLE_DESC *InitialStorage,
568 UINT32 InitialTableCount,
569 BOOLEAN AllowResize))
570
571 ACPI_EXTERNAL_RETURN_STATUS (
572 ACPI_STATUS ACPI_INIT_FUNCTION
573 AcpiInitializeSubsystem (
574 void))
575
576 ACPI_EXTERNAL_RETURN_STATUS (
577 ACPI_STATUS ACPI_INIT_FUNCTION
578 AcpiEnableSubsystem (
579 UINT32 Flags))
580
581 ACPI_EXTERNAL_RETURN_STATUS (
582 ACPI_STATUS ACPI_INIT_FUNCTION
583 AcpiInitializeObjects (
584 UINT32 Flags))
585
586 ACPI_EXTERNAL_RETURN_STATUS (
587 ACPI_STATUS ACPI_INIT_FUNCTION
588 AcpiTerminate (
589 void))
590
591
592 /*
593 * Miscellaneous global interfaces
594 */
595 ACPI_HW_DEPENDENT_RETURN_STATUS (
596 ACPI_STATUS
597 AcpiEnable (
598 void))
599
600 ACPI_HW_DEPENDENT_RETURN_STATUS (
601 ACPI_STATUS
602 AcpiDisable (
603 void))
604
605 ACPI_EXTERNAL_RETURN_STATUS (
606 ACPI_STATUS
607 AcpiSubsystemStatus (
608 void))
609
610 ACPI_EXTERNAL_RETURN_STATUS (
611 ACPI_STATUS
612 AcpiGetSystemInfo (
613 ACPI_BUFFER *RetBuffer))
614
615 ACPI_EXTERNAL_RETURN_STATUS (
616 ACPI_STATUS
617 AcpiGetStatistics (
618 ACPI_STATISTICS *Stats))
619
620 ACPI_EXTERNAL_RETURN_PTR (
621 const char *
622 AcpiFormatException (
623 ACPI_STATUS Exception))
624
625 ACPI_EXTERNAL_RETURN_STATUS (
626 ACPI_STATUS
627 AcpiPurgeCachedObjects (
628 void))
629
630 ACPI_EXTERNAL_RETURN_STATUS (
631 ACPI_STATUS
632 AcpiInstallInterface (
633 ACPI_STRING InterfaceName))
634
635 ACPI_EXTERNAL_RETURN_STATUS (
636 ACPI_STATUS
637 AcpiRemoveInterface (
638 ACPI_STRING InterfaceName))
639
640 ACPI_EXTERNAL_RETURN_STATUS (
641 ACPI_STATUS
642 AcpiUpdateInterfaces (
643 UINT8 Action))
644
645 ACPI_EXTERNAL_RETURN_UINT32 (
646 UINT32
647 AcpiCheckAddressRange (
648 ACPI_ADR_SPACE_TYPE SpaceId,
649 ACPI_PHYSICAL_ADDRESS Address,
650 ACPI_SIZE Length,
651 BOOLEAN Warn))
652
653 ACPI_EXTERNAL_RETURN_STATUS (
654 ACPI_STATUS
655 AcpiDecodePldBuffer (
656 UINT8 *InBuffer,
657 ACPI_SIZE Length,
658 ACPI_PLD_INFO **ReturnBuffer))
659
660
661 /*
662 * ACPI table load/unload interfaces
663 */
664 ACPI_EXTERNAL_RETURN_STATUS (
665 ACPI_STATUS ACPI_INIT_FUNCTION
666 AcpiInstallTable (
667 ACPI_TABLE_HEADER *Table))
668
669 ACPI_EXTERNAL_RETURN_STATUS (
670 ACPI_STATUS ACPI_INIT_FUNCTION
671 AcpiInstallPhysicalTable (
672 ACPI_PHYSICAL_ADDRESS Address))
673
674 ACPI_EXTERNAL_RETURN_STATUS (
675 ACPI_STATUS
676 AcpiLoadTable (
677 ACPI_TABLE_HEADER *Table,
678 UINT32 *TableIdx))
679
680 ACPI_EXTERNAL_RETURN_STATUS (
681 ACPI_STATUS
682 AcpiUnloadTable (
683 UINT32 TableIndex))
684
685 ACPI_EXTERNAL_RETURN_STATUS (
686 ACPI_STATUS
687 AcpiUnloadParentTable (
688 ACPI_HANDLE Object))
689
690 ACPI_EXTERNAL_RETURN_STATUS (
691 ACPI_STATUS ACPI_INIT_FUNCTION
692 AcpiLoadTables (
693 void))
694
695
696 /*
697 * ACPI table manipulation interfaces
698 */
699 ACPI_EXTERNAL_RETURN_STATUS (
700 ACPI_STATUS ACPI_INIT_FUNCTION
701 AcpiReallocateRootTable (
702 void))
703
704 ACPI_EXTERNAL_RETURN_STATUS (
705 ACPI_STATUS ACPI_INIT_FUNCTION
706 AcpiFindRootPointer (
707 ACPI_PHYSICAL_ADDRESS *RsdpAddress))
708
709 ACPI_EXTERNAL_RETURN_STATUS (
710 ACPI_STATUS
711 AcpiGetTableHeader (
712 ACPI_CONST_STRING Signature,
713 UINT32 Instance,
714 ACPI_TABLE_HEADER *OutTableHeader))
715
716 ACPI_EXTERNAL_RETURN_STATUS (
717 ACPI_STATUS
718 AcpiGetTable (
719 ACPI_CONST_STRING Signature,
720 UINT32 Instance,
721 ACPI_TABLE_HEADER **OutTable))
722
723 ACPI_EXTERNAL_RETURN_VOID (
724 void
725 AcpiPutTable (
726 ACPI_TABLE_HEADER *Table))
727
728 ACPI_EXTERNAL_RETURN_STATUS (
729 ACPI_STATUS
730 AcpiGetTableByIndex (
731 UINT32 TableIndex,
732 ACPI_TABLE_HEADER **OutTable))
733
734 ACPI_EXTERNAL_RETURN_STATUS (
735 ACPI_STATUS
736 AcpiInstallTableHandler (
737 ACPI_TABLE_HANDLER Handler,
738 void *Context))
739
740 ACPI_EXTERNAL_RETURN_STATUS (
741 ACPI_STATUS
742 AcpiRemoveTableHandler (
743 ACPI_TABLE_HANDLER Handler))
744
745
746 /*
747 * Namespace and name interfaces
748 */
749 ACPI_EXTERNAL_RETURN_STATUS (
750 ACPI_STATUS
751 AcpiWalkNamespace (
752 ACPI_OBJECT_TYPE Type,
753 ACPI_HANDLE StartObject,
754 UINT32 MaxDepth,
755 ACPI_WALK_CALLBACK DescendingCallback,
756 ACPI_WALK_CALLBACK AscendingCallback,
757 void *Context,
758 void **ReturnValue))
759
760 ACPI_EXTERNAL_RETURN_STATUS (
761 ACPI_STATUS
762 AcpiGetDevices (
763 char *HID,
764 ACPI_WALK_CALLBACK UserFunction,
765 void *Context,
766 void **ReturnValue))
767
768 ACPI_EXTERNAL_RETURN_STATUS (
769 ACPI_STATUS
770 AcpiGetName (
771 ACPI_HANDLE Object,
772 UINT32 NameType,
773 ACPI_BUFFER *RetPathPtr))
774
775 ACPI_EXTERNAL_RETURN_STATUS (
776 ACPI_STATUS
777 AcpiGetHandle (
778 ACPI_HANDLE Parent,
779 const char *Pathname,
780 ACPI_HANDLE *RetHandle))
781
782 ACPI_EXTERNAL_RETURN_STATUS (
783 ACPI_STATUS
784 AcpiAttachData (
785 ACPI_HANDLE Object,
786 ACPI_OBJECT_HANDLER Handler,
787 void *Data))
788
789 ACPI_EXTERNAL_RETURN_STATUS (
790 ACPI_STATUS
791 AcpiDetachData (
792 ACPI_HANDLE Object,
793 ACPI_OBJECT_HANDLER Handler))
794
795 ACPI_EXTERNAL_RETURN_STATUS (
796 ACPI_STATUS
797 AcpiGetData (
798 ACPI_HANDLE Object,
799 ACPI_OBJECT_HANDLER Handler,
800 void **Data))
801
802 ACPI_EXTERNAL_RETURN_STATUS (
803 ACPI_STATUS
804 AcpiDebugTrace (
805 const char *Name,
806 UINT32 DebugLevel,
807 UINT32 DebugLayer,
808 UINT32 Flags))
809
810
811 /*
812 * Object manipulation and enumeration
813 */
814 ACPI_EXTERNAL_RETURN_STATUS (
815 ACPI_STATUS
816 AcpiEvaluateObject (
817 ACPI_HANDLE Object,
818 ACPI_CONST_STRING Pathname,
819 ACPI_OBJECT_LIST *ParameterObjects,
820 ACPI_BUFFER *ReturnObjectBuffer))
821
822 ACPI_EXTERNAL_RETURN_STATUS (
823 ACPI_STATUS
824 AcpiEvaluateObjectTyped (
825 ACPI_HANDLE Object,
826 ACPI_CONST_STRING Pathname,
827 ACPI_OBJECT_LIST *ExternalParams,
828 ACPI_BUFFER *ReturnBuffer,
829 ACPI_OBJECT_TYPE ReturnType))
830
831 ACPI_EXTERNAL_RETURN_STATUS (
832 ACPI_STATUS
833 AcpiGetObjectInfo (
834 ACPI_HANDLE Object,
835 ACPI_DEVICE_INFO **ReturnBuffer))
836
837 ACPI_EXTERNAL_RETURN_STATUS (
838 ACPI_STATUS
839 AcpiInstallMethod (
840 UINT8 *Buffer))
841
842 ACPI_EXTERNAL_RETURN_STATUS (
843 ACPI_STATUS
844 AcpiGetNextObject (
845 ACPI_OBJECT_TYPE Type,
846 ACPI_HANDLE Parent,
847 ACPI_HANDLE Child,
848 ACPI_HANDLE *OutHandle))
849
850 ACPI_EXTERNAL_RETURN_STATUS (
851 ACPI_STATUS
852 AcpiGetType (
853 ACPI_HANDLE Object,
854 ACPI_OBJECT_TYPE *OutType))
855
856 ACPI_EXTERNAL_RETURN_STATUS (
857 ACPI_STATUS
858 AcpiGetParent (
859 ACPI_HANDLE Object,
860 ACPI_HANDLE *OutHandle))
861
862
863 /*
864 * Handler interfaces
865 */
866 ACPI_EXTERNAL_RETURN_STATUS (
867 ACPI_STATUS
868 AcpiInstallInitializationHandler (
869 ACPI_INIT_HANDLER Handler,
870 UINT32 Function))
871
872 ACPI_HW_DEPENDENT_RETURN_STATUS (
873 ACPI_STATUS
874 AcpiInstallSciHandler (
875 ACPI_SCI_HANDLER Address,
876 void *Context))
877
878 ACPI_HW_DEPENDENT_RETURN_STATUS (
879 ACPI_STATUS
880 AcpiRemoveSciHandler (
881 ACPI_SCI_HANDLER Address))
882
883 ACPI_HW_DEPENDENT_RETURN_STATUS (
884 ACPI_STATUS
885 AcpiInstallGlobalEventHandler (
886 ACPI_GBL_EVENT_HANDLER Handler,
887 void *Context))
888
889 ACPI_HW_DEPENDENT_RETURN_STATUS (
890 ACPI_STATUS
891 AcpiInstallFixedEventHandler (
892 UINT32 AcpiEvent,
893 ACPI_EVENT_HANDLER Handler,
894 void *Context))
895
896 ACPI_HW_DEPENDENT_RETURN_STATUS (
897 ACPI_STATUS
898 AcpiRemoveFixedEventHandler (
899 UINT32 AcpiEvent,
900 ACPI_EVENT_HANDLER Handler))
901
902 ACPI_HW_DEPENDENT_RETURN_STATUS (
903 ACPI_STATUS
904 AcpiInstallGpeHandler (
905 ACPI_HANDLE GpeDevice,
906 UINT32 GpeNumber,
907 UINT32 Type,
908 ACPI_GPE_HANDLER Address,
909 void *Context))
910
911 ACPI_HW_DEPENDENT_RETURN_STATUS (
912 ACPI_STATUS
913 AcpiInstallGpeRawHandler (
914 ACPI_HANDLE GpeDevice,
915 UINT32 GpeNumber,
916 UINT32 Type,
917 ACPI_GPE_HANDLER Address,
918 void *Context))
919
920 ACPI_HW_DEPENDENT_RETURN_STATUS (
921 ACPI_STATUS
922 AcpiRemoveGpeHandler (
923 ACPI_HANDLE GpeDevice,
924 UINT32 GpeNumber,
925 ACPI_GPE_HANDLER Address))
926
927 ACPI_EXTERNAL_RETURN_STATUS (
928 ACPI_STATUS
929 AcpiInstallNotifyHandler (
930 ACPI_HANDLE Device,
931 UINT32 HandlerType,
932 ACPI_NOTIFY_HANDLER Handler,
933 void *Context))
934
935 ACPI_EXTERNAL_RETURN_STATUS (
936 ACPI_STATUS
937 AcpiRemoveNotifyHandler (
938 ACPI_HANDLE Device,
939 UINT32 HandlerType,
940 ACPI_NOTIFY_HANDLER Handler))
941
942 ACPI_EXTERNAL_RETURN_STATUS (
943 ACPI_STATUS
944 AcpiInstallAddressSpaceHandler (
945 ACPI_HANDLE Device,
946 ACPI_ADR_SPACE_TYPE SpaceId,
947 ACPI_ADR_SPACE_HANDLER Handler,
948 ACPI_ADR_SPACE_SETUP Setup,
949 void *Context))
950
951 ACPI_EXTERNAL_RETURN_STATUS (
952 ACPI_STATUS
953 AcpiInstallAddressSpaceHandlerNo_Reg(
954 ACPI_HANDLE Device,
955 ACPI_ADR_SPACE_TYPE SpaceId,
956 ACPI_ADR_SPACE_HANDLER Handler,
957 ACPI_ADR_SPACE_SETUP Setup,
958 void *Context))
959
960 ACPI_EXTERNAL_RETURN_STATUS (
961 ACPI_STATUS
962 AcpiExecuteRegMethods (
963 ACPI_HANDLE Device,
964 ACPI_ADR_SPACE_TYPE SpaceId))
965
966 ACPI_EXTERNAL_RETURN_STATUS (
967 ACPI_STATUS
968 AcpiRemoveAddressSpaceHandler (
969 ACPI_HANDLE Device,
970 ACPI_ADR_SPACE_TYPE SpaceId,
971 ACPI_ADR_SPACE_HANDLER Handler))
972
973 ACPI_EXTERNAL_RETURN_STATUS (
974 ACPI_STATUS
975 AcpiInstallExceptionHandler (
976 ACPI_EXCEPTION_HANDLER Handler))
977
978 ACPI_EXTERNAL_RETURN_STATUS (
979 ACPI_STATUS
980 AcpiInstallInterfaceHandler (
981 ACPI_INTERFACE_HANDLER Handler))
982
983
984 /*
985 * Global Lock interfaces
986 */
987 ACPI_HW_DEPENDENT_RETURN_STATUS (
988 ACPI_STATUS
989 AcpiAcquireGlobalLock (
990 UINT16 Timeout,
991 UINT32 *Handle))
992
993 ACPI_HW_DEPENDENT_RETURN_STATUS (
994 ACPI_STATUS
995 AcpiReleaseGlobalLock (
996 UINT32 Handle))
997
998
999 /*
1000 * Interfaces to AML mutex objects
1001 */
1002 ACPI_EXTERNAL_RETURN_STATUS (
1003 ACPI_STATUS
1004 AcpiAcquireMutex (
1005 ACPI_HANDLE Handle,
1006 ACPI_STRING Pathname,
1007 UINT16 Timeout))
1008
1009 ACPI_EXTERNAL_RETURN_STATUS (
1010 ACPI_STATUS
1011 AcpiReleaseMutex (
1012 ACPI_HANDLE Handle,
1013 ACPI_STRING Pathname))
1014
1015
1016 /*
1017 * Fixed Event interfaces
1018 */
1019 ACPI_HW_DEPENDENT_RETURN_STATUS (
1020 ACPI_STATUS
1021 AcpiEnableEvent (
1022 UINT32 Event,
1023 UINT32 Flags))
1024
1025 ACPI_HW_DEPENDENT_RETURN_STATUS (
1026 ACPI_STATUS
1027 AcpiDisableEvent (
1028 UINT32 Event,
1029 UINT32 Flags))
1030
1031 ACPI_HW_DEPENDENT_RETURN_STATUS (
1032 ACPI_STATUS
1033 AcpiClearEvent (
1034 UINT32 Event))
1035
1036 ACPI_HW_DEPENDENT_RETURN_STATUS (
1037 ACPI_STATUS
1038 AcpiGetEventStatus (
1039 UINT32 Event,
1040 ACPI_EVENT_STATUS *EventStatus))
1041
1042
1043 /*
1044 * General Purpose Event (GPE) Interfaces
1045 */
1046 ACPI_HW_DEPENDENT_RETURN_STATUS (
1047 ACPI_STATUS
1048 AcpiUpdateAllGpes (
1049 void))
1050
1051 ACPI_HW_DEPENDENT_RETURN_STATUS (
1052 ACPI_STATUS
1053 AcpiEnableGpe (
1054 ACPI_HANDLE GpeDevice,
1055 UINT32 GpeNumber))
1056
1057 ACPI_HW_DEPENDENT_RETURN_STATUS (
1058 ACPI_STATUS
1059 AcpiDisableGpe (
1060 ACPI_HANDLE GpeDevice,
1061 UINT32 GpeNumber))
1062
1063 ACPI_HW_DEPENDENT_RETURN_STATUS (
1064 ACPI_STATUS
1065 AcpiClearGpe (
1066 ACPI_HANDLE GpeDevice,
1067 UINT32 GpeNumber))
1068
1069 ACPI_HW_DEPENDENT_RETURN_STATUS (
1070 ACPI_STATUS
1071 AcpiSetGpe (
1072 ACPI_HANDLE GpeDevice,
1073 UINT32 GpeNumber,
1074 UINT8 Action))
1075
1076 ACPI_HW_DEPENDENT_RETURN_STATUS (
1077 ACPI_STATUS
1078 AcpiFinishGpe (
1079 ACPI_HANDLE GpeDevice,
1080 UINT32 GpeNumber))
1081
1082 ACPI_HW_DEPENDENT_RETURN_STATUS (
1083 ACPI_STATUS
1084 AcpiMaskGpe (
1085 ACPI_HANDLE GpeDevice,
1086 UINT32 GpeNumber,
1087 BOOLEAN IsMasked))
1088
1089 ACPI_HW_DEPENDENT_RETURN_STATUS (
1090 ACPI_STATUS
1091 AcpiMarkGpeForWake (
1092 ACPI_HANDLE GpeDevice,
1093 UINT32 GpeNumber))
1094
1095 ACPI_HW_DEPENDENT_RETURN_STATUS (
1096 ACPI_STATUS
1097 AcpiSetupGpeForWake (
1098 ACPI_HANDLE ParentDevice,
1099 ACPI_HANDLE GpeDevice,
1100 UINT32 GpeNumber))
1101
1102 ACPI_HW_DEPENDENT_RETURN_STATUS (
1103 ACPI_STATUS
1104 AcpiSetGpeWakeMask (
1105 ACPI_HANDLE GpeDevice,
1106 UINT32 GpeNumber,
1107 UINT8 Action))
1108
1109 ACPI_HW_DEPENDENT_RETURN_STATUS (
1110 ACPI_STATUS
1111 AcpiGetGpeStatus (
1112 ACPI_HANDLE GpeDevice,
1113 UINT32 GpeNumber,
1114 ACPI_EVENT_STATUS *EventStatus))
1115
1116 ACPI_HW_DEPENDENT_RETURN_UINT32 (
1117 UINT32
1118 AcpiDispatchGpe (
1119 ACPI_HANDLE GpeDevice,
1120 UINT32 GpeNumber))
1121
1122 ACPI_HW_DEPENDENT_RETURN_STATUS (
1123 ACPI_STATUS
1124 AcpiDisableAllGpes (
1125 void))
1126
1127 ACPI_HW_DEPENDENT_RETURN_STATUS (
1128 ACPI_STATUS
1129 AcpiEnableAllRuntimeGpes (
1130 void))
1131
1132 ACPI_HW_DEPENDENT_RETURN_STATUS (
1133 ACPI_STATUS
1134 AcpiEnableAllWakeupGpes (
1135 void))
1136
1137 ACPI_HW_DEPENDENT_RETURN_UINT32 (
1138 UINT32 AcpiAnyGpeStatusSet (
1139 void))
1140
1141 ACPI_HW_DEPENDENT_RETURN_STATUS (
1142 ACPI_STATUS
1143 AcpiGetGpeDevice (
1144 UINT32 GpeIndex,
1145 ACPI_HANDLE *GpeDevice))
1146
1147 ACPI_HW_DEPENDENT_RETURN_STATUS (
1148 ACPI_STATUS
1149 AcpiInstallGpeBlock (
1150 ACPI_HANDLE GpeDevice,
1151 ACPI_GENERIC_ADDRESS *GpeBlockAddress,
1152 UINT32 RegisterCount,
1153 UINT32 InterruptNumber))
1154
1155 ACPI_HW_DEPENDENT_RETURN_STATUS (
1156 ACPI_STATUS
1157 AcpiRemoveGpeBlock (
1158 ACPI_HANDLE GpeDevice))
1159
1160
1161 /*
1162 * Resource interfaces
1163 */
1164 typedef
1165 ACPI_STATUS (*ACPI_WALK_RESOURCE_CALLBACK) (
1166 ACPI_RESOURCE *Resource,
1167 void *Context);
1168
1169 ACPI_EXTERNAL_RETURN_STATUS (
1170 ACPI_STATUS
1171 AcpiGetVendorResource (
1172 ACPI_HANDLE Device,
1173 char *Name,
1174 ACPI_VENDOR_UUID *Uuid,
1175 ACPI_BUFFER *RetBuffer))
1176
1177 ACPI_EXTERNAL_RETURN_STATUS (
1178 ACPI_STATUS
1179 AcpiGetCurrentResources (
1180 ACPI_HANDLE Device,
1181 ACPI_BUFFER *RetBuffer))
1182
1183 ACPI_EXTERNAL_RETURN_STATUS (
1184 ACPI_STATUS
1185 AcpiGetPossibleResources (
1186 ACPI_HANDLE Device,
1187 ACPI_BUFFER *RetBuffer))
1188
1189 ACPI_EXTERNAL_RETURN_STATUS (
1190 ACPI_STATUS
1191 AcpiGetEventResources (
1192 ACPI_HANDLE DeviceHandle,
1193 ACPI_BUFFER *RetBuffer))
1194
1195 ACPI_EXTERNAL_RETURN_STATUS (
1196 ACPI_STATUS
1197 AcpiWalkResourceBuffer (
1198 ACPI_BUFFER *Buffer,
1199 ACPI_WALK_RESOURCE_CALLBACK UserFunction,
1200 void *Context))
1201
1202 ACPI_EXTERNAL_RETURN_STATUS (
1203 ACPI_STATUS
1204 AcpiWalkResources (
1205 ACPI_HANDLE Device,
1206 const char *Name,
1207 ACPI_WALK_RESOURCE_CALLBACK UserFunction,
1208 void *Context))
1209
1210 ACPI_EXTERNAL_RETURN_STATUS (
1211 ACPI_STATUS
1212 AcpiSetCurrentResources (
1213 ACPI_HANDLE Device,
1214 ACPI_BUFFER *InBuffer))
1215
1216 ACPI_EXTERNAL_RETURN_STATUS (
1217 ACPI_STATUS
1218 AcpiGetIrqRoutingTable (
1219 ACPI_HANDLE Device,
1220 ACPI_BUFFER *RetBuffer))
1221
1222 ACPI_EXTERNAL_RETURN_STATUS (
1223 ACPI_STATUS
1224 AcpiResourceToAddress64 (
1225 ACPI_RESOURCE *Resource,
1226 ACPI_RESOURCE_ADDRESS64 *Out))
1227
1228 ACPI_EXTERNAL_RETURN_STATUS (
1229 ACPI_STATUS
1230 AcpiBufferToResource (
1231 UINT8 *AmlBuffer,
1232 UINT16 AmlBufferLength,
1233 ACPI_RESOURCE **ResourcePtr))
1234
1235
1236 /*
1237 * Hardware (ACPI device) interfaces
1238 */
1239 ACPI_EXTERNAL_RETURN_STATUS (
1240 ACPI_STATUS
1241 AcpiReset (
1242 void))
1243
1244 ACPI_EXTERNAL_RETURN_STATUS (
1245 ACPI_STATUS
1246 AcpiRead (
1247 UINT64 *Value,
1248 ACPI_GENERIC_ADDRESS *Reg))
1249
1250 ACPI_EXTERNAL_RETURN_STATUS (
1251 ACPI_STATUS
1252 AcpiWrite (
1253 UINT64 Value,
1254 ACPI_GENERIC_ADDRESS *Reg))
1255
1256 ACPI_HW_DEPENDENT_RETURN_STATUS (
1257 ACPI_STATUS
1258 AcpiReadBitRegister (
1259 UINT32 RegisterId,
1260 UINT32 *ReturnValue))
1261
1262 ACPI_HW_DEPENDENT_RETURN_STATUS (
1263 ACPI_STATUS
1264 AcpiWriteBitRegister (
1265 UINT32 RegisterId,
1266 UINT32 Value))
1267
1268
1269 /*
1270 * Sleep/Wake interfaces
1271 */
1272 ACPI_EXTERNAL_RETURN_STATUS (
1273 ACPI_STATUS
1274 AcpiGetSleepTypeData (
1275 UINT8 SleepState,
1276 UINT8 *Slp_TypA,
1277 UINT8 *Slp_TypB))
1278
1279 ACPI_EXTERNAL_RETURN_STATUS (
1280 ACPI_STATUS
1281 AcpiEnterSleepStatePrep (
1282 UINT8 SleepState))
1283
1284 ACPI_EXTERNAL_RETURN_STATUS (
1285 ACPI_STATUS
1286 AcpiEnterSleepState (
1287 UINT8 SleepState))
1288
1289 ACPI_HW_DEPENDENT_RETURN_STATUS (
1290 ACPI_STATUS
1291 AcpiEnterSleepStateS4bios (
1292 void))
1293
1294 ACPI_EXTERNAL_RETURN_STATUS (
1295 ACPI_STATUS
1296 AcpiLeaveSleepStatePrep (
1297 UINT8 SleepState))
1298
1299 ACPI_EXTERNAL_RETURN_STATUS (
1300 ACPI_STATUS
1301 AcpiLeaveSleepState (
1302 UINT8 SleepState))
1303
1304 ACPI_EXTERNAL_RETURN_STATUS (
1305 ACPI_STATUS
1306 AcpiSetFirmwareWakingVector (
1307 ACPI_PHYSICAL_ADDRESS PhysicalAddress,
1308 ACPI_PHYSICAL_ADDRESS PhysicalAddress64))
1309
1310
1311 /*
1312 * ACPI Timer interfaces
1313 */
1314 ACPI_HW_DEPENDENT_RETURN_STATUS (
1315 ACPI_STATUS
1316 AcpiGetTimerResolution (
1317 UINT32 *Resolution))
1318
1319 ACPI_HW_DEPENDENT_RETURN_STATUS (
1320 ACPI_STATUS
1321 AcpiGetTimer (
1322 UINT32 *Ticks))
1323
1324 ACPI_HW_DEPENDENT_RETURN_STATUS (
1325 ACPI_STATUS
1326 AcpiGetTimerDuration (
1327 UINT32 StartTicks,
1328 UINT32 EndTicks,
1329 UINT32 *TimeElapsed))
1330
1331
1332 /*
1333 * Error/Warning output
1334 */
1335 ACPI_MSG_DEPENDENT_RETURN_VOID (
1336 ACPI_PRINTF_LIKE(3)
1337 void ACPI_INTERNAL_VAR_XFACE
1338 AcpiError (
1339 const char *ModuleName,
1340 UINT32 LineNumber,
1341 const char *Format,
1342 ...))
1343
1344 ACPI_MSG_DEPENDENT_RETURN_VOID (
1345 ACPI_PRINTF_LIKE(4)
1346 void ACPI_INTERNAL_VAR_XFACE
1347 AcpiException (
1348 const char *ModuleName,
1349 UINT32 LineNumber,
1350 ACPI_STATUS Status,
1351 const char *Format,
1352 ...))
1353
1354 ACPI_MSG_DEPENDENT_RETURN_VOID (
1355 ACPI_PRINTF_LIKE(3)
1356 void ACPI_INTERNAL_VAR_XFACE
1357 AcpiWarning (
1358 const char *ModuleName,
1359 UINT32 LineNumber,
1360 const char *Format,
1361 ...))
1362
1363 ACPI_MSG_DEPENDENT_RETURN_VOID (
1364 ACPI_PRINTF_LIKE(1)
1365 void ACPI_INTERNAL_VAR_XFACE
1366 AcpiInfo (
1367 const char *Format,
1368 ...))
1369
1370 ACPI_MSG_DEPENDENT_RETURN_VOID (
1371 ACPI_PRINTF_LIKE(3)
1372 void ACPI_INTERNAL_VAR_XFACE
1373 AcpiBiosError (
1374 const char *ModuleName,
1375 UINT32 LineNumber,
1376 const char *Format,
1377 ...))
1378
1379 ACPI_MSG_DEPENDENT_RETURN_VOID (
1380 ACPI_PRINTF_LIKE(4)
1381 void ACPI_INTERNAL_VAR_XFACE
1382 AcpiBiosException (
1383 const char *ModuleName,
1384 UINT32 LineNumber,
1385 ACPI_STATUS Status,
1386 const char *Format,
1387 ...))
1388
1389 ACPI_MSG_DEPENDENT_RETURN_VOID (
1390 ACPI_PRINTF_LIKE(3)
1391 void ACPI_INTERNAL_VAR_XFACE
1392 AcpiBiosWarning (
1393 const char *ModuleName,
1394 UINT32 LineNumber,
1395 const char *Format,
1396 ...))
1397
1398
1399 /*
1400 * Debug output
1401 */
1402 ACPI_DBG_DEPENDENT_RETURN_VOID (
1403 ACPI_PRINTF_LIKE(6)
1404 void ACPI_INTERNAL_VAR_XFACE
1405 AcpiDebugPrint (
1406 UINT32 RequestedDebugLevel,
1407 UINT32 LineNumber,
1408 const char *FunctionName,
1409 const char *ModuleName,
1410 UINT32 ComponentId,
1411 const char *Format,
1412 ...))
1413
1414 ACPI_DBG_DEPENDENT_RETURN_VOID (
1415 ACPI_PRINTF_LIKE(6)
1416 void ACPI_INTERNAL_VAR_XFACE
1417 AcpiDebugPrintRaw (
1418 UINT32 RequestedDebugLevel,
1419 UINT32 LineNumber,
1420 const char *FunctionName,
1421 const char *ModuleName,
1422 UINT32 ComponentId,
1423 const char *Format,
1424 ...))
1425
1426 ACPI_DBG_DEPENDENT_RETURN_VOID (
1427 void
1428 AcpiTracePoint (
1429 ACPI_TRACE_EVENT_TYPE Type,
1430 BOOLEAN Begin,
1431 UINT8 *Aml,
1432 char *Pathname))
1433
1434 ACPI_STATUS
1435 AcpiInitializeDebugger (
1436 void);
1437
1438 void
1439 AcpiTerminateDebugger (
1440 void);
1441
1442 void
1443 AcpiRunDebugger (
1444 char *BatchBuffer);
1445
1446 void
1447 AcpiSetDebuggerThreadId (
1448 ACPI_THREAD_ID ThreadId);
1449
1450 #endif /* __ACXFACE_H__ */
1451