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 0x20160318
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 use 32-bit FADT addresses if and when there is a conflict
201 * (address mismatch) between the 32-bit and 64-bit versions of the
202 * address. Although ACPICA adheres to the ACPI specification which
203 * requires the use of the corresponding 64-bit address if it is non-zero,
204 * some machines have been found to have a corrupted non-zero 64-bit
205 * address. Default is FALSE, do not favor the 32-bit addresses.
207 ACPI_INIT_GLOBAL (UINT8
, AcpiGbl_Use32BitFadtAddresses
, FALSE
);
210 * Optionally use 32-bit FACS table addresses.
211 * It is reported that some platforms fail to resume from system suspending
212 * if 64-bit FACS table address is selected:
213 * https://bugzilla.kernel.org/show_bug.cgi?id=74021
214 * Default is TRUE, favor the 32-bit addresses.
216 ACPI_INIT_GLOBAL (UINT8
, AcpiGbl_Use32BitFacsAddresses
, TRUE
);
219 * Optionally truncate I/O addresses to 16 bits. Provides compatibility
220 * with other ACPI implementations. NOTE: During ACPICA initialization,
221 * this value is set to TRUE if any Windows OSI strings have been
222 * requested by the BIOS.
224 ACPI_INIT_GLOBAL (UINT8
, AcpiGbl_TruncateIoAddresses
, FALSE
);
227 * Disable runtime checking and repair of values returned by control methods.
228 * Use only if the repair is causing a problem on a particular machine.
230 ACPI_INIT_GLOBAL (UINT8
, AcpiGbl_DisableAutoRepair
, FALSE
);
233 * Optionally do not install any SSDTs from the RSDT/XSDT during initialization.
234 * This can be useful for debugging ACPI problems on some machines.
236 ACPI_INIT_GLOBAL (UINT8
, AcpiGbl_DisableSsdtTableInstall
, FALSE
);
239 * Optionally enable runtime namespace override.
241 ACPI_INIT_GLOBAL (UINT8
, AcpiGbl_RuntimeNamespaceOverride
, TRUE
);
244 * We keep track of the latest version of Windows that has been requested by
245 * the BIOS. ACPI 5.0.
247 ACPI_INIT_GLOBAL (UINT8
, AcpiGbl_OsiData
, 0);
250 * ACPI 5.0 introduces the concept of a "reduced hardware platform", meaning
251 * that the ACPI hardware is no longer required. A flag in the FADT indicates
252 * a reduced HW machine, and that flag is duplicated here for convenience.
254 ACPI_INIT_GLOBAL (BOOLEAN
, AcpiGbl_ReducedHardware
, FALSE
);
257 * This mechanism is used to trace a specified AML method. The method is
258 * traced each time it is executed.
260 ACPI_INIT_GLOBAL (UINT32
, AcpiGbl_TraceFlags
, 0);
261 ACPI_INIT_GLOBAL (const char *, AcpiGbl_TraceMethodName
, NULL
);
262 ACPI_INIT_GLOBAL (UINT32
, AcpiGbl_TraceDbgLevel
, ACPI_TRACE_LEVEL_DEFAULT
);
263 ACPI_INIT_GLOBAL (UINT32
, AcpiGbl_TraceDbgLayer
, ACPI_TRACE_LAYER_DEFAULT
);
266 * Runtime configuration of debug output control masks. We want the debug
267 * switches statically initialized so they are already set when the debugger
270 #ifdef ACPI_DEBUG_OUTPUT
271 ACPI_INIT_GLOBAL (UINT32
, AcpiDbgLevel
, ACPI_DEBUG_DEFAULT
);
273 ACPI_INIT_GLOBAL (UINT32
, AcpiDbgLevel
, ACPI_NORMAL_DEFAULT
);
275 ACPI_INIT_GLOBAL (UINT32
, AcpiDbgLayer
, ACPI_COMPONENT_DEFAULT
);
277 /* Optionally enable timer output with Debug Object output */
279 ACPI_INIT_GLOBAL (UINT8
, AcpiGbl_DisplayDebugTimer
, FALSE
);
282 * Other miscellaneous globals
284 ACPI_GLOBAL (ACPI_TABLE_FADT
, AcpiGbl_FADT
);
285 ACPI_GLOBAL (UINT32
, AcpiCurrentGpeCount
);
286 ACPI_GLOBAL (BOOLEAN
, AcpiGbl_SystemAwakeAndRunning
);
289 /*****************************************************************************
291 * ACPICA public interface configuration.
293 * Interfaces that are configured out of the ACPICA build are replaced
294 * by inlined stubs by default.
296 ****************************************************************************/
299 * Hardware-reduced prototypes (default: Not hardware reduced).
301 * All ACPICA hardware-related interfaces that use these macros will be
302 * configured out of the ACPICA build if the ACPI_REDUCED_HARDWARE flag
305 * Note: This static build option for reduced hardware is intended to
306 * reduce ACPICA code size if desired or necessary. However, even if this
307 * option is not specified, the runtime behavior of ACPICA is dependent
308 * on the actual FADT reduced hardware flag (HW_REDUCED_ACPI). If set,
309 * the flag will enable similar behavior -- ACPICA will not attempt
310 * to access any ACPI-relate hardware (SCI, GPEs, Fixed Events, etc.)
312 #if (!ACPI_REDUCED_HARDWARE)
313 #define ACPI_HW_DEPENDENT_RETURN_STATUS(Prototype) \
314 ACPI_EXTERNAL_RETURN_STATUS(Prototype)
316 #define ACPI_HW_DEPENDENT_RETURN_OK(Prototype) \
317 ACPI_EXTERNAL_RETURN_OK(Prototype)
319 #define ACPI_HW_DEPENDENT_RETURN_VOID(Prototype) \
320 ACPI_EXTERNAL_RETURN_VOID(Prototype)
323 #define ACPI_HW_DEPENDENT_RETURN_STATUS(Prototype) \
324 static ACPI_INLINE Prototype {return(AE_NOT_CONFIGURED);}
326 #define ACPI_HW_DEPENDENT_RETURN_OK(Prototype) \
327 static ACPI_INLINE Prototype {return(AE_OK);}
329 #define ACPI_HW_DEPENDENT_RETURN_VOID(Prototype) \
330 static ACPI_INLINE Prototype {return;}
332 #endif /* !ACPI_REDUCED_HARDWARE */
336 * Error message prototypes (default: error messages enabled).
338 * All interfaces related to error and warning messages
339 * will be configured out of the ACPICA build if the
340 * ACPI_NO_ERROR_MESSAGE flag is defined.
342 #ifndef ACPI_NO_ERROR_MESSAGES
343 #define ACPI_MSG_DEPENDENT_RETURN_VOID(Prototype) \
347 #define ACPI_MSG_DEPENDENT_RETURN_VOID(Prototype) \
348 static ACPI_INLINE Prototype {return;}
350 #endif /* ACPI_NO_ERROR_MESSAGES */
354 * Debugging output prototypes (default: no debug output).
356 * All interfaces related to debug output messages
357 * will be configured out of the ACPICA build unless the
358 * ACPI_DEBUG_OUTPUT flag is defined.
360 #ifdef ACPI_DEBUG_OUTPUT
361 #define ACPI_DBG_DEPENDENT_RETURN_VOID(Prototype) \
365 #define ACPI_DBG_DEPENDENT_RETURN_VOID(Prototype) \
366 static ACPI_INLINE Prototype {return;}
368 #endif /* ACPI_DEBUG_OUTPUT */
372 * Application prototypes
374 * All interfaces used by application will be configured
375 * out of the ACPICA build unless the ACPI_APPLICATION
378 #ifdef ACPI_APPLICATION
379 #define ACPI_APP_DEPENDENT_RETURN_VOID(Prototype) \
383 #define ACPI_APP_DEPENDENT_RETURN_VOID(Prototype) \
384 static ACPI_INLINE Prototype {return;}
386 #endif /* ACPI_APPLICATION */
390 * Debugger prototypes
392 * All interfaces used by debugger will be configured
393 * out of the ACPICA build unless the ACPI_DEBUGGER
397 #define ACPI_DBR_DEPENDENT_RETURN_OK(Prototype) \
398 ACPI_EXTERNAL_RETURN_OK(Prototype)
400 #define ACPI_DBR_DEPENDENT_RETURN_VOID(Prototype) \
401 ACPI_EXTERNAL_RETURN_VOID(Prototype)
404 #define ACPI_DBR_DEPENDENT_RETURN_OK(Prototype) \
405 static ACPI_INLINE Prototype {return(AE_OK);}
407 #define ACPI_DBR_DEPENDENT_RETURN_VOID(Prototype) \
408 static ACPI_INLINE Prototype {return;}
410 #endif /* ACPI_DEBUGGER */
413 /*****************************************************************************
415 * ACPICA public interface prototypes
417 ****************************************************************************/
422 ACPI_EXTERNAL_RETURN_STATUS (
424 AcpiInitializeTables (
425 ACPI_TABLE_DESC
*InitialStorage
,
426 UINT32 InitialTableCount
,
427 BOOLEAN AllowResize
))
429 ACPI_EXTERNAL_RETURN_STATUS (
431 AcpiInitializeSubsystem (
434 ACPI_EXTERNAL_RETURN_STATUS (
436 AcpiEnableSubsystem (
439 ACPI_EXTERNAL_RETURN_STATUS (
441 AcpiInitializeObjects (
444 ACPI_EXTERNAL_RETURN_STATUS (
451 * Miscellaneous global interfaces
453 ACPI_HW_DEPENDENT_RETURN_STATUS (
458 ACPI_HW_DEPENDENT_RETURN_STATUS (
463 ACPI_EXTERNAL_RETURN_STATUS (
465 AcpiSubsystemStatus (
468 ACPI_EXTERNAL_RETURN_STATUS (
471 ACPI_BUFFER
*RetBuffer
))
473 ACPI_EXTERNAL_RETURN_STATUS (
476 ACPI_STATISTICS
*Stats
))
478 ACPI_EXTERNAL_RETURN_PTR (
480 AcpiFormatException (
481 ACPI_STATUS Exception
))
483 ACPI_EXTERNAL_RETURN_STATUS (
485 AcpiPurgeCachedObjects (
488 ACPI_EXTERNAL_RETURN_STATUS (
490 AcpiInstallInterface (
491 ACPI_STRING InterfaceName
))
493 ACPI_EXTERNAL_RETURN_STATUS (
495 AcpiRemoveInterface (
496 ACPI_STRING InterfaceName
))
498 ACPI_EXTERNAL_RETURN_STATUS (
500 AcpiUpdateInterfaces (
503 ACPI_EXTERNAL_RETURN_UINT32 (
505 AcpiCheckAddressRange (
506 ACPI_ADR_SPACE_TYPE SpaceId
,
507 ACPI_PHYSICAL_ADDRESS Address
,
511 ACPI_EXTERNAL_RETURN_STATUS (
513 AcpiDecodePldBuffer (
516 ACPI_PLD_INFO
**ReturnBuffer
))
520 * ACPI table load/unload interfaces
522 ACPI_EXTERNAL_RETURN_STATUS (
525 ACPI_PHYSICAL_ADDRESS Address
,
528 ACPI_EXTERNAL_RETURN_STATUS (
531 ACPI_TABLE_HEADER
*Table
))
533 ACPI_EXTERNAL_RETURN_STATUS (
535 AcpiUnloadParentTable (
538 ACPI_EXTERNAL_RETURN_STATUS (
545 * ACPI table manipulation interfaces
547 ACPI_EXTERNAL_RETURN_STATUS (
549 AcpiReallocateRootTable (
552 ACPI_EXTERNAL_RETURN_STATUS (
554 AcpiFindRootPointer (
555 ACPI_PHYSICAL_ADDRESS
*RsdpAddress
))
557 ACPI_EXTERNAL_RETURN_STATUS (
560 ACPI_STRING Signature
,
562 ACPI_TABLE_HEADER
*OutTableHeader
))
564 ACPI_EXTERNAL_RETURN_STATUS (
567 ACPI_STRING Signature
,
569 ACPI_TABLE_HEADER
**OutTable
))
571 ACPI_EXTERNAL_RETURN_STATUS (
573 AcpiGetTableByIndex (
575 ACPI_TABLE_HEADER
**OutTable
))
577 ACPI_EXTERNAL_RETURN_STATUS (
579 AcpiInstallTableHandler (
580 ACPI_TABLE_HANDLER Handler
,
583 ACPI_EXTERNAL_RETURN_STATUS (
585 AcpiRemoveTableHandler (
586 ACPI_TABLE_HANDLER Handler
))
590 * Namespace and name interfaces
592 ACPI_EXTERNAL_RETURN_STATUS (
595 ACPI_OBJECT_TYPE Type
,
596 ACPI_HANDLE StartObject
,
598 ACPI_WALK_CALLBACK DescendingCallback
,
599 ACPI_WALK_CALLBACK AscendingCallback
,
603 ACPI_EXTERNAL_RETURN_STATUS (
607 ACPI_WALK_CALLBACK UserFunction
,
611 ACPI_EXTERNAL_RETURN_STATUS (
616 ACPI_BUFFER
*RetPathPtr
))
618 ACPI_EXTERNAL_RETURN_STATUS (
622 ACPI_STRING Pathname
,
623 ACPI_HANDLE
*RetHandle
))
625 ACPI_EXTERNAL_RETURN_STATUS (
629 ACPI_OBJECT_HANDLER Handler
,
632 ACPI_EXTERNAL_RETURN_STATUS (
636 ACPI_OBJECT_HANDLER Handler
))
638 ACPI_EXTERNAL_RETURN_STATUS (
642 ACPI_OBJECT_HANDLER Handler
,
645 ACPI_EXTERNAL_RETURN_STATUS (
655 * Object manipulation and enumeration
657 ACPI_EXTERNAL_RETURN_STATUS (
661 ACPI_STRING Pathname
,
662 ACPI_OBJECT_LIST
*ParameterObjects
,
663 ACPI_BUFFER
*ReturnObjectBuffer
))
665 ACPI_EXTERNAL_RETURN_STATUS (
667 AcpiEvaluateObjectTyped (
669 ACPI_STRING Pathname
,
670 ACPI_OBJECT_LIST
*ExternalParams
,
671 ACPI_BUFFER
*ReturnBuffer
,
672 ACPI_OBJECT_TYPE ReturnType
))
674 ACPI_EXTERNAL_RETURN_STATUS (
678 ACPI_DEVICE_INFO
**ReturnBuffer
))
680 ACPI_EXTERNAL_RETURN_STATUS (
685 ACPI_EXTERNAL_RETURN_STATUS (
688 ACPI_OBJECT_TYPE Type
,
691 ACPI_HANDLE
*OutHandle
))
693 ACPI_EXTERNAL_RETURN_STATUS (
697 ACPI_OBJECT_TYPE
*OutType
))
699 ACPI_EXTERNAL_RETURN_STATUS (
703 ACPI_HANDLE
*OutHandle
))
709 ACPI_EXTERNAL_RETURN_STATUS (
711 AcpiInstallInitializationHandler (
712 ACPI_INIT_HANDLER Handler
,
715 ACPI_HW_DEPENDENT_RETURN_STATUS (
717 AcpiInstallSciHandler (
718 ACPI_SCI_HANDLER Address
,
721 ACPI_HW_DEPENDENT_RETURN_STATUS (
723 AcpiRemoveSciHandler (
724 ACPI_SCI_HANDLER Address
))
726 ACPI_HW_DEPENDENT_RETURN_STATUS (
728 AcpiInstallGlobalEventHandler (
729 ACPI_GBL_EVENT_HANDLER Handler
,
732 ACPI_HW_DEPENDENT_RETURN_STATUS (
734 AcpiInstallFixedEventHandler (
736 ACPI_EVENT_HANDLER Handler
,
739 ACPI_HW_DEPENDENT_RETURN_STATUS (
741 AcpiRemoveFixedEventHandler (
743 ACPI_EVENT_HANDLER Handler
))
745 ACPI_HW_DEPENDENT_RETURN_STATUS (
747 AcpiInstallGpeHandler (
748 ACPI_HANDLE GpeDevice
,
751 ACPI_GPE_HANDLER Address
,
754 ACPI_HW_DEPENDENT_RETURN_STATUS (
756 AcpiInstallGpeRawHandler (
757 ACPI_HANDLE GpeDevice
,
760 ACPI_GPE_HANDLER Address
,
763 ACPI_HW_DEPENDENT_RETURN_STATUS (
765 AcpiRemoveGpeHandler (
766 ACPI_HANDLE GpeDevice
,
768 ACPI_GPE_HANDLER Address
))
770 ACPI_EXTERNAL_RETURN_STATUS (
772 AcpiInstallNotifyHandler (
775 ACPI_NOTIFY_HANDLER Handler
,
778 ACPI_EXTERNAL_RETURN_STATUS (
780 AcpiRemoveNotifyHandler (
783 ACPI_NOTIFY_HANDLER Handler
))
785 ACPI_EXTERNAL_RETURN_STATUS (
787 AcpiInstallAddressSpaceHandler (
789 ACPI_ADR_SPACE_TYPE SpaceId
,
790 ACPI_ADR_SPACE_HANDLER Handler
,
791 ACPI_ADR_SPACE_SETUP Setup
,
794 ACPI_EXTERNAL_RETURN_STATUS (
796 AcpiRemoveAddressSpaceHandler (
798 ACPI_ADR_SPACE_TYPE SpaceId
,
799 ACPI_ADR_SPACE_HANDLER Handler
))
801 ACPI_EXTERNAL_RETURN_STATUS (
803 AcpiInstallExceptionHandler (
804 ACPI_EXCEPTION_HANDLER Handler
))
806 ACPI_EXTERNAL_RETURN_STATUS (
808 AcpiInstallInterfaceHandler (
809 ACPI_INTERFACE_HANDLER Handler
))
813 * Global Lock interfaces
815 ACPI_HW_DEPENDENT_RETURN_STATUS (
817 AcpiAcquireGlobalLock (
821 ACPI_HW_DEPENDENT_RETURN_STATUS (
823 AcpiReleaseGlobalLock (
828 * Interfaces to AML mutex objects
830 ACPI_EXTERNAL_RETURN_STATUS (
834 ACPI_STRING Pathname
,
837 ACPI_EXTERNAL_RETURN_STATUS (
841 ACPI_STRING Pathname
))
845 * Fixed Event interfaces
847 ACPI_HW_DEPENDENT_RETURN_STATUS (
853 ACPI_HW_DEPENDENT_RETURN_STATUS (
859 ACPI_HW_DEPENDENT_RETURN_STATUS (
864 ACPI_HW_DEPENDENT_RETURN_STATUS (
868 ACPI_EVENT_STATUS
*EventStatus
))
872 * General Purpose Event (GPE) Interfaces
874 ACPI_HW_DEPENDENT_RETURN_STATUS (
879 ACPI_HW_DEPENDENT_RETURN_STATUS (
882 ACPI_HANDLE GpeDevice
,
885 ACPI_HW_DEPENDENT_RETURN_STATUS (
888 ACPI_HANDLE GpeDevice
,
891 ACPI_HW_DEPENDENT_RETURN_STATUS (
894 ACPI_HANDLE GpeDevice
,
897 ACPI_HW_DEPENDENT_RETURN_STATUS (
900 ACPI_HANDLE GpeDevice
,
904 ACPI_HW_DEPENDENT_RETURN_STATUS (
907 ACPI_HANDLE GpeDevice
,
910 ACPI_HW_DEPENDENT_RETURN_STATUS (
913 ACPI_HANDLE GpeDevice
,
916 ACPI_HW_DEPENDENT_RETURN_STATUS (
918 AcpiSetupGpeForWake (
919 ACPI_HANDLE ParentDevice
,
920 ACPI_HANDLE GpeDevice
,
923 ACPI_HW_DEPENDENT_RETURN_STATUS (
926 ACPI_HANDLE GpeDevice
,
930 ACPI_HW_DEPENDENT_RETURN_STATUS (
933 ACPI_HANDLE GpeDevice
,
935 ACPI_EVENT_STATUS
*EventStatus
))
937 ACPI_HW_DEPENDENT_RETURN_STATUS (
942 ACPI_HW_DEPENDENT_RETURN_STATUS (
944 AcpiEnableAllRuntimeGpes (
947 ACPI_HW_DEPENDENT_RETURN_STATUS (
949 AcpiEnableAllWakeupGpes (
952 ACPI_HW_DEPENDENT_RETURN_STATUS (
956 ACPI_HANDLE
*GpeDevice
))
958 ACPI_HW_DEPENDENT_RETURN_STATUS (
960 AcpiInstallGpeBlock (
961 ACPI_HANDLE GpeDevice
,
962 ACPI_GENERIC_ADDRESS
*GpeBlockAddress
,
963 UINT32 RegisterCount
,
964 UINT32 InterruptNumber
))
966 ACPI_HW_DEPENDENT_RETURN_STATUS (
969 ACPI_HANDLE GpeDevice
))
973 * Resource interfaces
976 ACPI_STATUS (*ACPI_WALK_RESOURCE_CALLBACK
) (
977 ACPI_RESOURCE
*Resource
,
980 ACPI_EXTERNAL_RETURN_STATUS (
982 AcpiGetVendorResource (
985 ACPI_VENDOR_UUID
*Uuid
,
986 ACPI_BUFFER
*RetBuffer
))
988 ACPI_EXTERNAL_RETURN_STATUS (
990 AcpiGetCurrentResources (
992 ACPI_BUFFER
*RetBuffer
))
994 ACPI_EXTERNAL_RETURN_STATUS (
996 AcpiGetPossibleResources (
998 ACPI_BUFFER
*RetBuffer
))
1000 ACPI_EXTERNAL_RETURN_STATUS (
1002 AcpiGetEventResources (
1003 ACPI_HANDLE DeviceHandle
,
1004 ACPI_BUFFER
*RetBuffer
))
1006 ACPI_EXTERNAL_RETURN_STATUS (
1008 AcpiWalkResourceBuffer (
1009 ACPI_BUFFER
*Buffer
,
1010 ACPI_WALK_RESOURCE_CALLBACK UserFunction
,
1013 ACPI_EXTERNAL_RETURN_STATUS (
1018 ACPI_WALK_RESOURCE_CALLBACK UserFunction
,
1021 ACPI_EXTERNAL_RETURN_STATUS (
1023 AcpiSetCurrentResources (
1025 ACPI_BUFFER
*InBuffer
))
1027 ACPI_EXTERNAL_RETURN_STATUS (
1029 AcpiGetIrqRoutingTable (
1031 ACPI_BUFFER
*RetBuffer
))
1033 ACPI_EXTERNAL_RETURN_STATUS (
1035 AcpiResourceToAddress64 (
1036 ACPI_RESOURCE
*Resource
,
1037 ACPI_RESOURCE_ADDRESS64
*Out
))
1039 ACPI_EXTERNAL_RETURN_STATUS (
1041 AcpiBufferToResource (
1043 UINT16 AmlBufferLength
,
1044 ACPI_RESOURCE
**ResourcePtr
))
1048 * Hardware (ACPI device) interfaces
1050 ACPI_EXTERNAL_RETURN_STATUS (
1055 ACPI_EXTERNAL_RETURN_STATUS (
1059 ACPI_GENERIC_ADDRESS
*Reg
))
1061 ACPI_EXTERNAL_RETURN_STATUS (
1065 ACPI_GENERIC_ADDRESS
*Reg
))
1067 ACPI_HW_DEPENDENT_RETURN_STATUS (
1069 AcpiReadBitRegister (
1071 UINT32
*ReturnValue
))
1073 ACPI_HW_DEPENDENT_RETURN_STATUS (
1075 AcpiWriteBitRegister (
1081 * Sleep/Wake interfaces
1083 ACPI_EXTERNAL_RETURN_STATUS (
1085 AcpiGetSleepTypeData (
1090 ACPI_EXTERNAL_RETURN_STATUS (
1092 AcpiEnterSleepStatePrep (
1095 ACPI_EXTERNAL_RETURN_STATUS (
1097 AcpiEnterSleepState (
1100 ACPI_HW_DEPENDENT_RETURN_STATUS (
1102 AcpiEnterSleepStateS4bios (
1105 ACPI_EXTERNAL_RETURN_STATUS (
1107 AcpiLeaveSleepStatePrep (
1110 ACPI_EXTERNAL_RETURN_STATUS (
1112 AcpiLeaveSleepState (
1115 ACPI_HW_DEPENDENT_RETURN_STATUS (
1117 AcpiSetFirmwareWakingVector (
1118 ACPI_PHYSICAL_ADDRESS PhysicalAddress
,
1119 ACPI_PHYSICAL_ADDRESS PhysicalAddress64
))
1123 * ACPI Timer interfaces
1125 ACPI_HW_DEPENDENT_RETURN_STATUS (
1127 AcpiGetTimerResolution (
1128 UINT32
*Resolution
))
1130 ACPI_HW_DEPENDENT_RETURN_STATUS (
1135 ACPI_HW_DEPENDENT_RETURN_STATUS (
1137 AcpiGetTimerDuration (
1140 UINT32
*TimeElapsed
))
1144 * Error/Warning output
1146 ACPI_MSG_DEPENDENT_RETURN_VOID (
1148 void ACPI_INTERNAL_VAR_XFACE
1150 const char *ModuleName
,
1155 ACPI_MSG_DEPENDENT_RETURN_VOID (
1157 void ACPI_INTERNAL_VAR_XFACE
1159 const char *ModuleName
,
1165 ACPI_MSG_DEPENDENT_RETURN_VOID (
1167 void ACPI_INTERNAL_VAR_XFACE
1169 const char *ModuleName
,
1174 ACPI_MSG_DEPENDENT_RETURN_VOID (
1176 void ACPI_INTERNAL_VAR_XFACE
1181 ACPI_MSG_DEPENDENT_RETURN_VOID (
1183 void ACPI_INTERNAL_VAR_XFACE
1185 const char *ModuleName
,
1190 ACPI_MSG_DEPENDENT_RETURN_VOID (
1192 void ACPI_INTERNAL_VAR_XFACE
1194 const char *ModuleName
,
1203 ACPI_DBG_DEPENDENT_RETURN_VOID (
1205 void ACPI_INTERNAL_VAR_XFACE
1207 UINT32 RequestedDebugLevel
,
1209 const char *FunctionName
,
1210 const char *ModuleName
,
1215 ACPI_DBG_DEPENDENT_RETURN_VOID (
1217 void ACPI_INTERNAL_VAR_XFACE
1219 UINT32 RequestedDebugLevel
,
1221 const char *FunctionName
,
1222 const char *ModuleName
,
1227 ACPI_DBG_DEPENDENT_RETURN_VOID (
1230 ACPI_TRACE_EVENT_TYPE Type
,
1235 ACPI_APP_DEPENDENT_RETURN_VOID (
1237 void ACPI_INTERNAL_VAR_XFACE
1243 AcpiInitializeDebugger (
1247 AcpiTerminateDebugger (
1251 AcpiSetDebuggerThreadId (
1252 ACPI_THREAD_ID ThreadId
);
1254 #endif /* __ACXFACE_H__ */