1 /******************************************************************************
3 * Name: acpixf.h - External interfaces to the ACPI subsystem
5 *****************************************************************************/
8 * Copyright (C) 2000 - 2016, Intel Corp.
11 * Redistribution and use in source and binary forms, with or without
12 * modification, are permitted provided that the following conditions
14 * 1. Redistributions of source code must retain the above copyright
15 * notice, this list of conditions, and the following disclaimer,
16 * without modification.
17 * 2. Redistributions in binary form must reproduce at minimum a disclaimer
18 * substantially similar to the "NO WARRANTY" disclaimer below
19 * ("Disclaimer") and any redistribution must be conditioned upon
20 * including a substantially similar Disclaimer requirement for further
21 * binary redistribution.
22 * 3. Neither the names of the above-listed copyright holders nor the names
23 * of any contributors may be used to endorse or promote products derived
24 * from this software without specific prior written permission.
26 * Alternatively, this software may be distributed under the terms of the
27 * GNU General Public License ("GPL") version 2 as published by the Free
28 * Software Foundation.
31 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
32 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
33 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
34 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
35 * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
36 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
37 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
38 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
39 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
40 * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
41 * POSSIBILITY OF SUCH DAMAGES.
47 /* Current ACPICA subsystem version in YYYYMMDD format */
49 #define ACPI_CA_VERSION 0x20160930
57 /*****************************************************************************
59 * Macros used for ACPICA globals and configuration
61 ****************************************************************************/
64 * Ensure that global variables are defined and initialized only once.
66 * The use of these macros allows for a single list of globals (here)
67 * in order to simplify maintenance of the code.
69 #ifdef DEFINE_ACPI_GLOBALS
70 #define ACPI_GLOBAL(type,name) \
74 #define ACPI_INIT_GLOBAL(type,name,value) \
79 #define ACPI_GLOBAL(type,name) \
83 #ifndef ACPI_INIT_GLOBAL
84 #define ACPI_INIT_GLOBAL(type,name,value) \
90 * These macros configure the various ACPICA interfaces. They are
91 * useful for generating stub inline functions for features that are
92 * configured out of the current kernel or ACPICA application.
94 #ifndef ACPI_EXTERNAL_RETURN_STATUS
95 #define ACPI_EXTERNAL_RETURN_STATUS(Prototype) \
99 #ifndef ACPI_EXTERNAL_RETURN_OK
100 #define ACPI_EXTERNAL_RETURN_OK(Prototype) \
104 #ifndef ACPI_EXTERNAL_RETURN_VOID
105 #define ACPI_EXTERNAL_RETURN_VOID(Prototype) \
109 #ifndef ACPI_EXTERNAL_RETURN_UINT32
110 #define ACPI_EXTERNAL_RETURN_UINT32(Prototype) \
114 #ifndef ACPI_EXTERNAL_RETURN_PTR
115 #define ACPI_EXTERNAL_RETURN_PTR(Prototype) \
120 /*****************************************************************************
122 * Public globals and runtime configuration options
124 ****************************************************************************/
127 * Enable "slack mode" of the AML interpreter? Default is FALSE, and the
128 * interpreter strictly follows the ACPI specification. Setting to TRUE
129 * allows the interpreter to ignore certain errors and/or bad AML constructs.
131 * Currently, these features are enabled by this flag:
133 * 1) Allow "implicit return" of last value in a control method
134 * 2) Allow access beyond the end of an operation region
135 * 3) Allow access to uninitialized locals/args (auto-init to integer 0)
136 * 4) Allow ANY object type to be a source operand for the Store() operator
137 * 5) Allow unresolved references (invalid target name) in package objects
138 * 6) Enable warning messages for behavior that is not ACPI spec compliant
140 ACPI_INIT_GLOBAL (UINT8, AcpiGbl_EnableInterpreterSlack, FALSE);
143 * Automatically serialize all methods that create named objects? Default
144 * is TRUE, meaning that all NonSerialized methods are scanned once at
145 * table load time to determine those that create named objects. Methods
146 * that create named objects are marked Serialized in order to prevent
147 * possible run-time problems if they are entered by more than one thread.
149 ACPI_INIT_GLOBAL (UINT8, AcpiGbl_AutoSerializeMethods, TRUE);
152 * Create the predefined _OSI method in the namespace? Default is TRUE
153 * because ACPICA is fully compatible with other ACPI implementations.
154 * Changing this will revert ACPICA (and machine ASL) to pre-OSI behavior.
156 ACPI_INIT_GLOBAL (UINT8, AcpiGbl_CreateOsiMethod, TRUE);
159 * Optionally use default values for the ACPI register widths. Set this to
160 * TRUE to use the defaults, if an FADT contains incorrect widths/lengths.
162 ACPI_INIT_GLOBAL (UINT8, AcpiGbl_UseDefaultRegisterWidths, TRUE);
165 * Whether or not to verify the table checksum before installation. Set
166 * this to TRUE to verify the table checksum before install it to the table
167 * manager. Note that enabling this option causes errors to happen in some
168 * OSPMs during early initialization stages. Default behavior is to do such
171 ACPI_INIT_GLOBAL (UINT8, AcpiGbl_VerifyTableChecksum, TRUE);
174 * Optionally enable output from the AML Debug Object.
176 ACPI_INIT_GLOBAL (UINT8, AcpiGbl_EnableAmlDebugObject, FALSE);
179 * Optionally copy the entire DSDT to local memory (instead of simply
180 * mapping it.) There are some BIOSs that corrupt or replace the original
181 * DSDT, creating the need for this option. Default is FALSE, do not copy
184 ACPI_INIT_GLOBAL (UINT8, AcpiGbl_CopyDsdtLocally, FALSE);
187 * Optionally ignore an XSDT if present and use the RSDT instead.
188 * Although the ACPI specification requires that an XSDT be used instead
189 * of the RSDT, the XSDT has been found to be corrupt or ill-formed on
190 * some machines. Default behavior is to use the XSDT if present.
192 ACPI_INIT_GLOBAL (UINT8, AcpiGbl_DoNotUseXsdt, FALSE);
195 * Optionally support group module level code.
197 ACPI_INIT_GLOBAL (UINT8, AcpiGbl_GroupModuleLevelCode, FALSE);
200 * Optionally support module level code by parsing the entire table as
201 * a TermList. Default is FALSE, do not execute entire table until some
202 * lock order issues are fixed.
204 ACPI_INIT_GLOBAL (UINT8, AcpiGbl_ParseTableAsTermList, FALSE);
207 * Optionally use 32-bit FADT addresses if and when there is a conflict
208 * (address mismatch) between the 32-bit and 64-bit versions of the
209 * address. Although ACPICA adheres to the ACPI specification which
210 * requires the use of the corresponding 64-bit address if it is non-zero,
211 * some machines have been found to have a corrupted non-zero 64-bit
212 * address. Default is FALSE, do not favor the 32-bit addresses.
214 ACPI_INIT_GLOBAL (UINT8, AcpiGbl_Use32BitFadtAddresses, FALSE);
217 * Optionally use 32-bit FACS table addresses.
218 * It is reported that some platforms fail to resume from system suspending
219 * if 64-bit FACS table address is selected:
220 * https://bugzilla.kernel.org/show_bug.cgi?id=74021
221 * Default is TRUE, favor the 32-bit addresses.
223 ACPI_INIT_GLOBAL (UINT8, AcpiGbl_Use32BitFacsAddresses, TRUE);
226 * Optionally truncate I/O addresses to 16 bits. Provides compatibility
227 * with other ACPI implementations. NOTE: During ACPICA initialization,
228 * this value is set to TRUE if any Windows OSI strings have been
229 * requested by the BIOS.
231 ACPI_INIT_GLOBAL (UINT8, AcpiGbl_TruncateIoAddresses, FALSE);
234 * Disable runtime checking and repair of values returned by control methods.
235 * Use only if the repair is causing a problem on a particular machine.
237 ACPI_INIT_GLOBAL (UINT8, AcpiGbl_DisableAutoRepair, FALSE);
240 * Optionally do not install any SSDTs from the RSDT/XSDT during initialization.
241 * This can be useful for debugging ACPI problems on some machines.
243 ACPI_INIT_GLOBAL (UINT8, AcpiGbl_DisableSsdtTableInstall, FALSE);
246 * Optionally enable runtime namespace override.
248 ACPI_INIT_GLOBAL (UINT8, AcpiGbl_RuntimeNamespaceOverride, TRUE);
251 * We keep track of the latest version of Windows that has been requested by
252 * the BIOS. ACPI 5.0.
254 ACPI_INIT_GLOBAL (UINT8, AcpiGbl_OsiData, 0);
257 * ACPI 5.0 introduces the concept of a "reduced hardware platform", meaning
258 * that the ACPI hardware is no longer required. A flag in the FADT indicates
259 * a reduced HW machine, and that flag is duplicated here for convenience.
261 ACPI_INIT_GLOBAL (BOOLEAN, AcpiGbl_ReducedHardware, FALSE);
264 * Maximum number of While() loop iterations before forced method abort.
265 * This mechanism is intended to prevent infinite loops during interpreter
266 * execution within a host kernel.
268 ACPI_INIT_GLOBAL (UINT32, AcpiGbl_MaxLoopIterations, ACPI_MAX_LOOP_COUNT);
271 * This mechanism is used to trace a specified AML method. The method is
272 * traced each time it is executed.
274 ACPI_INIT_GLOBAL (UINT32, AcpiGbl_TraceFlags, 0);
275 ACPI_INIT_GLOBAL (const char *, AcpiGbl_TraceMethodName, NULL);
276 ACPI_INIT_GLOBAL (UINT32, AcpiGbl_TraceDbgLevel, ACPI_TRACE_LEVEL_DEFAULT);
277 ACPI_INIT_GLOBAL (UINT32, AcpiGbl_TraceDbgLayer, ACPI_TRACE_LAYER_DEFAULT);
280 * Runtime configuration of debug output control masks. We want the debug
281 * switches statically initialized so they are already set when the debugger
284 #ifdef ACPI_DEBUG_OUTPUT
285 ACPI_INIT_GLOBAL (UINT32, AcpiDbgLevel, ACPI_DEBUG_DEFAULT);
287 ACPI_INIT_GLOBAL (UINT32, AcpiDbgLevel, ACPI_NORMAL_DEFAULT);
289 ACPI_INIT_GLOBAL (UINT32, AcpiDbgLayer, ACPI_COMPONENT_DEFAULT);
291 /* Optionally enable timer output with Debug Object output */
293 ACPI_INIT_GLOBAL (UINT8, AcpiGbl_DisplayDebugTimer, FALSE);
296 * Other miscellaneous globals
298 ACPI_GLOBAL (ACPI_TABLE_FADT, AcpiGbl_FADT);
299 ACPI_GLOBAL (UINT32, AcpiCurrentGpeCount);
300 ACPI_GLOBAL (BOOLEAN, AcpiGbl_SystemAwakeAndRunning);
303 /*****************************************************************************
305 * ACPICA public interface configuration.
307 * Interfaces that are configured out of the ACPICA build are replaced
308 * by inlined stubs by default.
310 ****************************************************************************/
313 * Hardware-reduced prototypes (default: Not hardware reduced).
315 * All ACPICA hardware-related interfaces that use these macros will be
316 * configured out of the ACPICA build if the ACPI_REDUCED_HARDWARE flag
319 * Note: This static build option for reduced hardware is intended to
320 * reduce ACPICA code size if desired or necessary. However, even if this
321 * option is not specified, the runtime behavior of ACPICA is dependent
322 * on the actual FADT reduced hardware flag (HW_REDUCED_ACPI). If set,
323 * the flag will enable similar behavior -- ACPICA will not attempt
324 * to access any ACPI-relate hardware (SCI, GPEs, Fixed Events, etc.)
326 #if (!ACPI_REDUCED_HARDWARE)
327 #define ACPI_HW_DEPENDENT_RETURN_STATUS(Prototype) \
328 ACPI_EXTERNAL_RETURN_STATUS(Prototype)
330 #define ACPI_HW_DEPENDENT_RETURN_OK(Prototype) \
331 ACPI_EXTERNAL_RETURN_OK(Prototype)
333 #define ACPI_HW_DEPENDENT_RETURN_VOID(Prototype) \
334 ACPI_EXTERNAL_RETURN_VOID(Prototype)
337 #define ACPI_HW_DEPENDENT_RETURN_STATUS(Prototype) \
338 static ACPI_INLINE Prototype {return(AE_NOT_CONFIGURED);}
340 #define ACPI_HW_DEPENDENT_RETURN_OK(Prototype) \
341 static ACPI_INLINE Prototype {return(AE_OK);}
343 #define ACPI_HW_DEPENDENT_RETURN_VOID(Prototype) \
344 static ACPI_INLINE Prototype {return;}
346 #endif /* !ACPI_REDUCED_HARDWARE */
350 * Error message prototypes (default: error messages enabled).
352 * All interfaces related to error and warning messages
353 * will be configured out of the ACPICA build if the
354 * ACPI_NO_ERROR_MESSAGE flag is defined.
356 #ifndef ACPI_NO_ERROR_MESSAGES
357 #define ACPI_MSG_DEPENDENT_RETURN_VOID(Prototype) \
361 #define ACPI_MSG_DEPENDENT_RETURN_VOID(Prototype) \
362 static ACPI_INLINE Prototype {return;}
364 #endif /* ACPI_NO_ERROR_MESSAGES */
368 * Debugging output prototypes (default: no debug output).
370 * All interfaces related to debug output messages
371 * will be configured out of the ACPICA build unless the
372 * ACPI_DEBUG_OUTPUT flag is defined.
374 #ifdef ACPI_DEBUG_OUTPUT
375 #define ACPI_DBG_DEPENDENT_RETURN_VOID(Prototype) \
379 #define ACPI_DBG_DEPENDENT_RETURN_VOID(Prototype) \
380 static ACPI_INLINE Prototype {return;}
382 #endif /* ACPI_DEBUG_OUTPUT */
386 * Application prototypes
388 * All interfaces used by application will be configured
389 * out of the ACPICA build unless the ACPI_APPLICATION
392 #ifdef ACPI_APPLICATION
393 #define ACPI_APP_DEPENDENT_RETURN_VOID(Prototype) \
397 #define ACPI_APP_DEPENDENT_RETURN_VOID(Prototype) \
398 static ACPI_INLINE Prototype {return;}
400 #endif /* ACPI_APPLICATION */
404 * Debugger prototypes
406 * All interfaces used by debugger will be configured
407 * out of the ACPICA build unless the ACPI_DEBUGGER
411 #define ACPI_DBR_DEPENDENT_RETURN_OK(Prototype) \
412 ACPI_EXTERNAL_RETURN_OK(Prototype)
414 #define ACPI_DBR_DEPENDENT_RETURN_VOID(Prototype) \
415 ACPI_EXTERNAL_RETURN_VOID(Prototype)
418 #define ACPI_DBR_DEPENDENT_RETURN_OK(Prototype) \
419 static ACPI_INLINE Prototype {return(AE_OK);}
421 #define ACPI_DBR_DEPENDENT_RETURN_VOID(Prototype) \
422 static ACPI_INLINE Prototype {return;}
424 #endif /* ACPI_DEBUGGER */
427 /*****************************************************************************
429 * ACPICA public interface prototypes
431 ****************************************************************************/
436 ACPI_EXTERNAL_RETURN_STATUS (
437 ACPI_STATUS ACPI_INIT_FUNCTION
438 AcpiInitializeTables (
439 ACPI_TABLE_DESC *InitialStorage,
440 UINT32 InitialTableCount,
441 BOOLEAN AllowResize))
443 ACPI_EXTERNAL_RETURN_STATUS (
444 ACPI_STATUS ACPI_INIT_FUNCTION
445 AcpiInitializeSubsystem (
448 ACPI_EXTERNAL_RETURN_STATUS (
449 ACPI_STATUS ACPI_INIT_FUNCTION
450 AcpiEnableSubsystem (
453 ACPI_EXTERNAL_RETURN_STATUS (
454 ACPI_STATUS ACPI_INIT_FUNCTION
455 AcpiInitializeObjects (
458 ACPI_EXTERNAL_RETURN_STATUS (
459 ACPI_STATUS ACPI_INIT_FUNCTION
465 * Miscellaneous global interfaces
467 ACPI_HW_DEPENDENT_RETURN_STATUS (
472 ACPI_HW_DEPENDENT_RETURN_STATUS (
477 ACPI_EXTERNAL_RETURN_STATUS (
479 AcpiSubsystemStatus (
482 ACPI_EXTERNAL_RETURN_STATUS (
485 ACPI_BUFFER *RetBuffer))
487 ACPI_EXTERNAL_RETURN_STATUS (
490 ACPI_STATISTICS *Stats))
492 ACPI_EXTERNAL_RETURN_PTR (
494 AcpiFormatException (
495 ACPI_STATUS Exception))
497 ACPI_EXTERNAL_RETURN_STATUS (
499 AcpiPurgeCachedObjects (
502 ACPI_EXTERNAL_RETURN_STATUS (
504 AcpiInstallInterface (
505 ACPI_STRING InterfaceName))
507 ACPI_EXTERNAL_RETURN_STATUS (
509 AcpiRemoveInterface (
510 ACPI_STRING InterfaceName))
512 ACPI_EXTERNAL_RETURN_STATUS (
514 AcpiUpdateInterfaces (
517 ACPI_EXTERNAL_RETURN_UINT32 (
519 AcpiCheckAddressRange (
520 ACPI_ADR_SPACE_TYPE SpaceId,
521 ACPI_PHYSICAL_ADDRESS Address,
525 ACPI_EXTERNAL_RETURN_STATUS (
527 AcpiDecodePldBuffer (
530 ACPI_PLD_INFO **ReturnBuffer))
534 * ACPI table load/unload interfaces
536 ACPI_EXTERNAL_RETURN_STATUS (
537 ACPI_STATUS ACPI_INIT_FUNCTION
539 ACPI_PHYSICAL_ADDRESS Address,
542 ACPI_EXTERNAL_RETURN_STATUS (
545 ACPI_TABLE_HEADER *Table))
547 ACPI_EXTERNAL_RETURN_STATUS (
549 AcpiUnloadParentTable (
552 ACPI_EXTERNAL_RETURN_STATUS (
553 ACPI_STATUS ACPI_INIT_FUNCTION
559 * ACPI table manipulation interfaces
561 ACPI_EXTERNAL_RETURN_STATUS (
562 ACPI_STATUS ACPI_INIT_FUNCTION
563 AcpiReallocateRootTable (
566 ACPI_EXTERNAL_RETURN_STATUS (
567 ACPI_STATUS ACPI_INIT_FUNCTION
568 AcpiFindRootPointer (
569 ACPI_PHYSICAL_ADDRESS *RsdpAddress))
571 ACPI_EXTERNAL_RETURN_STATUS (
574 ACPI_STRING Signature,
576 ACPI_TABLE_HEADER *OutTableHeader))
578 ACPI_EXTERNAL_RETURN_STATUS (
581 ACPI_STRING Signature,
583 ACPI_TABLE_HEADER **OutTable))
585 ACPI_EXTERNAL_RETURN_STATUS (
587 AcpiGetTableByIndex (
589 ACPI_TABLE_HEADER **OutTable))
591 ACPI_EXTERNAL_RETURN_STATUS (
593 AcpiInstallTableHandler (
594 ACPI_TABLE_HANDLER Handler,
597 ACPI_EXTERNAL_RETURN_STATUS (
599 AcpiRemoveTableHandler (
600 ACPI_TABLE_HANDLER Handler))
604 * Namespace and name interfaces
606 ACPI_EXTERNAL_RETURN_STATUS (
609 ACPI_OBJECT_TYPE Type,
610 ACPI_HANDLE StartObject,
612 ACPI_WALK_CALLBACK DescendingCallback,
613 ACPI_WALK_CALLBACK AscendingCallback,
617 ACPI_EXTERNAL_RETURN_STATUS (
621 ACPI_WALK_CALLBACK UserFunction,
625 ACPI_EXTERNAL_RETURN_STATUS (
630 ACPI_BUFFER *RetPathPtr))
632 ACPI_EXTERNAL_RETURN_STATUS (
636 ACPI_STRING Pathname,
637 ACPI_HANDLE *RetHandle))
639 ACPI_EXTERNAL_RETURN_STATUS (
643 ACPI_OBJECT_HANDLER Handler,
646 ACPI_EXTERNAL_RETURN_STATUS (
650 ACPI_OBJECT_HANDLER Handler))
652 ACPI_EXTERNAL_RETURN_STATUS (
656 ACPI_OBJECT_HANDLER Handler,
659 ACPI_EXTERNAL_RETURN_STATUS (
669 * Object manipulation and enumeration
671 ACPI_EXTERNAL_RETURN_STATUS (
675 ACPI_STRING Pathname,
676 ACPI_OBJECT_LIST *ParameterObjects,
677 ACPI_BUFFER *ReturnObjectBuffer))
679 ACPI_EXTERNAL_RETURN_STATUS (
681 AcpiEvaluateObjectTyped (
683 ACPI_STRING Pathname,
684 ACPI_OBJECT_LIST *ExternalParams,
685 ACPI_BUFFER *ReturnBuffer,
686 ACPI_OBJECT_TYPE ReturnType))
688 ACPI_EXTERNAL_RETURN_STATUS (
692 ACPI_DEVICE_INFO **ReturnBuffer))
694 ACPI_EXTERNAL_RETURN_STATUS (
699 ACPI_EXTERNAL_RETURN_STATUS (
702 ACPI_OBJECT_TYPE Type,
705 ACPI_HANDLE *OutHandle))
707 ACPI_EXTERNAL_RETURN_STATUS (
711 ACPI_OBJECT_TYPE *OutType))
713 ACPI_EXTERNAL_RETURN_STATUS (
717 ACPI_HANDLE *OutHandle))
723 ACPI_EXTERNAL_RETURN_STATUS (
725 AcpiInstallInitializationHandler (
726 ACPI_INIT_HANDLER Handler,
729 ACPI_HW_DEPENDENT_RETURN_STATUS (
731 AcpiInstallSciHandler (
732 ACPI_SCI_HANDLER Address,
735 ACPI_HW_DEPENDENT_RETURN_STATUS (
737 AcpiRemoveSciHandler (
738 ACPI_SCI_HANDLER Address))
740 ACPI_HW_DEPENDENT_RETURN_STATUS (
742 AcpiInstallGlobalEventHandler (
743 ACPI_GBL_EVENT_HANDLER Handler,
746 ACPI_HW_DEPENDENT_RETURN_STATUS (
748 AcpiInstallFixedEventHandler (
750 ACPI_EVENT_HANDLER Handler,
753 ACPI_HW_DEPENDENT_RETURN_STATUS (
755 AcpiRemoveFixedEventHandler (
757 ACPI_EVENT_HANDLER Handler))
759 ACPI_HW_DEPENDENT_RETURN_STATUS (
761 AcpiInstallGpeHandler (
762 ACPI_HANDLE GpeDevice,
765 ACPI_GPE_HANDLER Address,
768 ACPI_HW_DEPENDENT_RETURN_STATUS (
770 AcpiInstallGpeRawHandler (
771 ACPI_HANDLE GpeDevice,
774 ACPI_GPE_HANDLER Address,
777 ACPI_HW_DEPENDENT_RETURN_STATUS (
779 AcpiRemoveGpeHandler (
780 ACPI_HANDLE GpeDevice,
782 ACPI_GPE_HANDLER Address))
784 ACPI_EXTERNAL_RETURN_STATUS (
786 AcpiInstallNotifyHandler (
789 ACPI_NOTIFY_HANDLER Handler,
792 ACPI_EXTERNAL_RETURN_STATUS (
794 AcpiRemoveNotifyHandler (
797 ACPI_NOTIFY_HANDLER Handler))
799 ACPI_EXTERNAL_RETURN_STATUS (
801 AcpiInstallAddressSpaceHandler (
803 ACPI_ADR_SPACE_TYPE SpaceId,
804 ACPI_ADR_SPACE_HANDLER Handler,
805 ACPI_ADR_SPACE_SETUP Setup,
808 ACPI_EXTERNAL_RETURN_STATUS (
810 AcpiRemoveAddressSpaceHandler (
812 ACPI_ADR_SPACE_TYPE SpaceId,
813 ACPI_ADR_SPACE_HANDLER Handler))
815 ACPI_EXTERNAL_RETURN_STATUS (
817 AcpiInstallExceptionHandler (
818 ACPI_EXCEPTION_HANDLER Handler))
820 ACPI_EXTERNAL_RETURN_STATUS (
822 AcpiInstallInterfaceHandler (
823 ACPI_INTERFACE_HANDLER Handler))
827 * Global Lock interfaces
829 ACPI_HW_DEPENDENT_RETURN_STATUS (
831 AcpiAcquireGlobalLock (
835 ACPI_HW_DEPENDENT_RETURN_STATUS (
837 AcpiReleaseGlobalLock (
842 * Interfaces to AML mutex objects
844 ACPI_EXTERNAL_RETURN_STATUS (
848 ACPI_STRING Pathname,
851 ACPI_EXTERNAL_RETURN_STATUS (
855 ACPI_STRING Pathname))
859 * Fixed Event interfaces
861 ACPI_HW_DEPENDENT_RETURN_STATUS (
867 ACPI_HW_DEPENDENT_RETURN_STATUS (
873 ACPI_HW_DEPENDENT_RETURN_STATUS (
878 ACPI_HW_DEPENDENT_RETURN_STATUS (
882 ACPI_EVENT_STATUS *EventStatus))
886 * General Purpose Event (GPE) Interfaces
888 ACPI_HW_DEPENDENT_RETURN_STATUS (
893 ACPI_HW_DEPENDENT_RETURN_STATUS (
896 ACPI_HANDLE GpeDevice,
899 ACPI_HW_DEPENDENT_RETURN_STATUS (
902 ACPI_HANDLE GpeDevice,
905 ACPI_HW_DEPENDENT_RETURN_STATUS (
908 ACPI_HANDLE GpeDevice,
911 ACPI_HW_DEPENDENT_RETURN_STATUS (
914 ACPI_HANDLE GpeDevice,
918 ACPI_HW_DEPENDENT_RETURN_STATUS (
921 ACPI_HANDLE GpeDevice,
924 ACPI_HW_DEPENDENT_RETURN_STATUS (
927 ACPI_HANDLE GpeDevice,
931 ACPI_HW_DEPENDENT_RETURN_STATUS (
934 ACPI_HANDLE GpeDevice,
937 ACPI_HW_DEPENDENT_RETURN_STATUS (
939 AcpiSetupGpeForWake (
940 ACPI_HANDLE ParentDevice,
941 ACPI_HANDLE GpeDevice,
944 ACPI_HW_DEPENDENT_RETURN_STATUS (
947 ACPI_HANDLE GpeDevice,
951 ACPI_HW_DEPENDENT_RETURN_STATUS (
954 ACPI_HANDLE GpeDevice,
956 ACPI_EVENT_STATUS *EventStatus))
958 ACPI_HW_DEPENDENT_RETURN_STATUS (
963 ACPI_HW_DEPENDENT_RETURN_STATUS (
965 AcpiEnableAllRuntimeGpes (
968 ACPI_HW_DEPENDENT_RETURN_STATUS (
970 AcpiEnableAllWakeupGpes (
973 ACPI_HW_DEPENDENT_RETURN_STATUS (
977 ACPI_HANDLE *GpeDevice))
979 ACPI_HW_DEPENDENT_RETURN_STATUS (
981 AcpiInstallGpeBlock (
982 ACPI_HANDLE GpeDevice,
983 ACPI_GENERIC_ADDRESS *GpeBlockAddress,
984 UINT32 RegisterCount,
985 UINT32 InterruptNumber))
987 ACPI_HW_DEPENDENT_RETURN_STATUS (
990 ACPI_HANDLE GpeDevice))
994 * Resource interfaces
997 ACPI_STATUS (*ACPI_WALK_RESOURCE_CALLBACK) (
998 ACPI_RESOURCE *Resource,
1001 ACPI_EXTERNAL_RETURN_STATUS (
1003 AcpiGetVendorResource (
1006 ACPI_VENDOR_UUID *Uuid,
1007 ACPI_BUFFER *RetBuffer))
1009 ACPI_EXTERNAL_RETURN_STATUS (
1011 AcpiGetCurrentResources (
1013 ACPI_BUFFER *RetBuffer))
1015 ACPI_EXTERNAL_RETURN_STATUS (
1017 AcpiGetPossibleResources (
1019 ACPI_BUFFER *RetBuffer))
1021 ACPI_EXTERNAL_RETURN_STATUS (
1023 AcpiGetEventResources (
1024 ACPI_HANDLE DeviceHandle,
1025 ACPI_BUFFER *RetBuffer))
1027 ACPI_EXTERNAL_RETURN_STATUS (
1029 AcpiWalkResourceBuffer (
1030 ACPI_BUFFER *Buffer,
1031 ACPI_WALK_RESOURCE_CALLBACK UserFunction,
1034 ACPI_EXTERNAL_RETURN_STATUS (
1039 ACPI_WALK_RESOURCE_CALLBACK UserFunction,
1042 ACPI_EXTERNAL_RETURN_STATUS (
1044 AcpiSetCurrentResources (
1046 ACPI_BUFFER *InBuffer))
1048 ACPI_EXTERNAL_RETURN_STATUS (
1050 AcpiGetIrqRoutingTable (
1052 ACPI_BUFFER *RetBuffer))
1054 ACPI_EXTERNAL_RETURN_STATUS (
1056 AcpiResourceToAddress64 (
1057 ACPI_RESOURCE *Resource,
1058 ACPI_RESOURCE_ADDRESS64 *Out))
1060 ACPI_EXTERNAL_RETURN_STATUS (
1062 AcpiBufferToResource (
1064 UINT16 AmlBufferLength,
1065 ACPI_RESOURCE **ResourcePtr))
1069 * Hardware (ACPI device) interfaces
1071 ACPI_EXTERNAL_RETURN_STATUS (
1076 ACPI_EXTERNAL_RETURN_STATUS (
1080 ACPI_GENERIC_ADDRESS *Reg))
1082 ACPI_EXTERNAL_RETURN_STATUS (
1086 ACPI_GENERIC_ADDRESS *Reg))
1088 ACPI_HW_DEPENDENT_RETURN_STATUS (
1090 AcpiReadBitRegister (
1092 UINT32 *ReturnValue))
1094 ACPI_HW_DEPENDENT_RETURN_STATUS (
1096 AcpiWriteBitRegister (
1102 * Sleep/Wake interfaces
1104 ACPI_EXTERNAL_RETURN_STATUS (
1106 AcpiGetSleepTypeData (
1111 ACPI_EXTERNAL_RETURN_STATUS (
1113 AcpiEnterSleepStatePrep (
1116 ACPI_EXTERNAL_RETURN_STATUS (
1118 AcpiEnterSleepState (
1121 ACPI_HW_DEPENDENT_RETURN_STATUS (
1123 AcpiEnterSleepStateS4bios (
1126 ACPI_EXTERNAL_RETURN_STATUS (
1128 AcpiLeaveSleepStatePrep (
1131 ACPI_EXTERNAL_RETURN_STATUS (
1133 AcpiLeaveSleepState (
1136 ACPI_HW_DEPENDENT_RETURN_STATUS (
1138 AcpiSetFirmwareWakingVector (
1139 ACPI_PHYSICAL_ADDRESS PhysicalAddress,
1140 ACPI_PHYSICAL_ADDRESS PhysicalAddress64))
1144 * ACPI Timer interfaces
1146 ACPI_HW_DEPENDENT_RETURN_STATUS (
1148 AcpiGetTimerResolution (
1149 UINT32 *Resolution))
1151 ACPI_HW_DEPENDENT_RETURN_STATUS (
1156 ACPI_HW_DEPENDENT_RETURN_STATUS (
1158 AcpiGetTimerDuration (
1161 UINT32 *TimeElapsed))
1165 * Error/Warning output
1167 ACPI_MSG_DEPENDENT_RETURN_VOID (
1169 void ACPI_INTERNAL_VAR_XFACE
1171 const char *ModuleName,
1176 ACPI_MSG_DEPENDENT_RETURN_VOID (
1178 void ACPI_INTERNAL_VAR_XFACE
1180 const char *ModuleName,
1186 ACPI_MSG_DEPENDENT_RETURN_VOID (
1188 void ACPI_INTERNAL_VAR_XFACE
1190 const char *ModuleName,
1195 ACPI_MSG_DEPENDENT_RETURN_VOID (
1197 void ACPI_INTERNAL_VAR_XFACE
1202 ACPI_MSG_DEPENDENT_RETURN_VOID (
1204 void ACPI_INTERNAL_VAR_XFACE
1206 const char *ModuleName,
1211 ACPI_MSG_DEPENDENT_RETURN_VOID (
1213 void ACPI_INTERNAL_VAR_XFACE
1215 const char *ModuleName,
1224 ACPI_DBG_DEPENDENT_RETURN_VOID (
1226 void ACPI_INTERNAL_VAR_XFACE
1228 UINT32 RequestedDebugLevel,
1230 const char *FunctionName,
1231 const char *ModuleName,
1236 ACPI_DBG_DEPENDENT_RETURN_VOID (
1238 void ACPI_INTERNAL_VAR_XFACE
1240 UINT32 RequestedDebugLevel,
1242 const char *FunctionName,
1243 const char *ModuleName,
1248 ACPI_DBG_DEPENDENT_RETURN_VOID (
1251 ACPI_TRACE_EVENT_TYPE Type,
1257 AcpiInitializeDebugger (
1261 AcpiTerminateDebugger (
1265 AcpiSetDebuggerThreadId (
1266 ACPI_THREAD_ID ThreadId);
1268 #endif /* __ACXFACE_H__ */