acpixf.h revision 1.1.1.6
1 /****************************************************************************** 2 * 3 * Name: acpixf.h - External interfaces to the ACPI subsystem 4 * 5 *****************************************************************************/ 6 7 /* 8 * Copyright (C) 2000 - 2015, Intel Corp. 9 * All rights reserved. 10 * 11 * Redistribution and use in source and binary forms, with or without 12 * modification, are permitted provided that the following conditions 13 * are met: 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. 25 * 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. 29 * 30 * NO WARRANTY 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. 42 */ 43 44 #ifndef __ACXFACE_H__ 45 #define __ACXFACE_H__ 46 47 /* Current ACPICA subsystem version in YYYYMMDD format */ 48 49 #define ACPI_CA_VERSION 0x20150410 50 51 #include "acconfig.h" 52 #include "actypes.h" 53 #include "actbl.h" 54 #include "acbuffer.h" 55 56 57 /***************************************************************************** 58 * 59 * Macros used for ACPICA globals and configuration 60 * 61 ****************************************************************************/ 62 63 /* 64 * Ensure that global variables are defined and initialized only once. 65 * 66 * The use of these macros allows for a single list of globals (here) 67 * in order to simplify maintenance of the code. 68 */ 69 #ifdef DEFINE_ACPI_GLOBALS 70 #define ACPI_GLOBAL(type,name) \ 71 extern type name; \ 72 type name 73 74 #define ACPI_INIT_GLOBAL(type,name,value) \ 75 type name=value 76 77 #else 78 #ifndef ACPI_GLOBAL 79 #define ACPI_GLOBAL(type,name) \ 80 extern type name 81 #endif 82 83 #ifndef ACPI_INIT_GLOBAL 84 #define ACPI_INIT_GLOBAL(type,name,value) \ 85 extern type name 86 #endif 87 #endif 88 89 /* 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. 93 */ 94 #ifndef ACPI_EXTERNAL_RETURN_STATUS 95 #define ACPI_EXTERNAL_RETURN_STATUS(Prototype) \ 96 Prototype; 97 #endif 98 99 #ifndef ACPI_EXTERNAL_RETURN_OK 100 #define ACPI_EXTERNAL_RETURN_OK(Prototype) \ 101 Prototype; 102 #endif 103 104 #ifndef ACPI_EXTERNAL_RETURN_VOID 105 #define ACPI_EXTERNAL_RETURN_VOID(Prototype) \ 106 Prototype; 107 #endif 108 109 #ifndef ACPI_EXTERNAL_RETURN_UINT32 110 #define ACPI_EXTERNAL_RETURN_UINT32(Prototype) \ 111 Prototype; 112 #endif 113 114 #ifndef ACPI_EXTERNAL_RETURN_PTR 115 #define ACPI_EXTERNAL_RETURN_PTR(Prototype) \ 116 Prototype; 117 #endif 118 119 120 /***************************************************************************** 121 * 122 * Public globals and runtime configuration options 123 * 124 ****************************************************************************/ 125 126 /* 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. 130 * 131 * Currently, these features are enabled by this flag: 132 * 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 139 */ 140 ACPI_INIT_GLOBAL (UINT8, AcpiGbl_EnableInterpreterSlack, FALSE); 141 142 /* 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. 148 */ 149 ACPI_INIT_GLOBAL (UINT8, AcpiGbl_AutoSerializeMethods, TRUE); 150 151 /* 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. 155 */ 156 ACPI_INIT_GLOBAL (UINT8, AcpiGbl_CreateOsiMethod, TRUE); 157 158 /* 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. 161 */ 162 ACPI_INIT_GLOBAL (UINT8, AcpiGbl_UseDefaultRegisterWidths, TRUE); 163 164 /* 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 169 * verification. 170 */ 171 ACPI_INIT_GLOBAL (UINT8, AcpiGbl_VerifyTableChecksum, TRUE); 172 173 /* 174 * Optionally enable output from the AML Debug Object. 175 */ 176 ACPI_INIT_GLOBAL (UINT8, AcpiGbl_EnableAmlDebugObject, FALSE); 177 178 /* 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 182 * the DSDT. 183 */ 184 ACPI_INIT_GLOBAL (UINT8, AcpiGbl_CopyDsdtLocally, FALSE); 185 186 /* 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. 191 */ 192 ACPI_INIT_GLOBAL (UINT8, AcpiGbl_DoNotUseXsdt, FALSE); 193 194 /* 195 * Optionally use 32-bit FADT addresses if and when there is a conflict 196 * (address mismatch) between the 32-bit and 64-bit versions of the 197 * address. Although ACPICA adheres to the ACPI specification which 198 * requires the use of the corresponding 64-bit address if it is non-zero, 199 * some machines have been found to have a corrupted non-zero 64-bit 200 * address. Default is FALSE, do not favor the 32-bit addresses. 201 */ 202 ACPI_INIT_GLOBAL (UINT8, AcpiGbl_Use32BitFadtAddresses, FALSE); 203 204 /* 205 * Optionally truncate I/O addresses to 16 bits. Provides compatibility 206 * with other ACPI implementations. NOTE: During ACPICA initialization, 207 * this value is set to TRUE if any Windows OSI strings have been 208 * requested by the BIOS. 209 */ 210 ACPI_INIT_GLOBAL (UINT8, AcpiGbl_TruncateIoAddresses, FALSE); 211 212 /* 213 * Disable runtime checking and repair of values returned by control methods. 214 * Use only if the repair is causing a problem on a particular machine. 215 */ 216 ACPI_INIT_GLOBAL (UINT8, AcpiGbl_DisableAutoRepair, FALSE); 217 218 /* 219 * Optionally do not install any SSDTs from the RSDT/XSDT during initialization. 220 * This can be useful for debugging ACPI problems on some machines. 221 */ 222 ACPI_INIT_GLOBAL (UINT8, AcpiGbl_DisableSsdtTableInstall, FALSE); 223 224 /* 225 * We keep track of the latest version of Windows that has been requested by 226 * the BIOS. ACPI 5.0. 227 */ 228 ACPI_INIT_GLOBAL (UINT8, AcpiGbl_OsiData, 0); 229 230 /* 231 * ACPI 5.0 introduces the concept of a "reduced hardware platform", meaning 232 * that the ACPI hardware is no longer required. A flag in the FADT indicates 233 * a reduced HW machine, and that flag is duplicated here for convenience. 234 */ 235 ACPI_INIT_GLOBAL (BOOLEAN, AcpiGbl_ReducedHardware, FALSE); 236 237 /* 238 * This mechanism is used to trace a specified AML method. The method is 239 * traced each time it is executed. 240 */ 241 ACPI_INIT_GLOBAL (UINT32, AcpiGbl_TraceFlags, 0); 242 ACPI_INIT_GLOBAL (ACPI_NAME, AcpiGbl_TraceMethodName, 0); 243 244 /* 245 * Runtime configuration of debug output control masks. We want the debug 246 * switches statically initialized so they are already set when the debugger 247 * is entered. 248 */ 249 #ifdef ACPI_DEBUG_OUTPUT 250 ACPI_INIT_GLOBAL (UINT32, AcpiDbgLevel, ACPI_DEBUG_DEFAULT); 251 #else 252 ACPI_INIT_GLOBAL (UINT32, AcpiDbgLevel, ACPI_NORMAL_DEFAULT); 253 #endif 254 ACPI_INIT_GLOBAL (UINT32, AcpiDbgLayer, ACPI_COMPONENT_DEFAULT); 255 256 /* 257 * Other miscellaneous globals 258 */ 259 ACPI_GLOBAL (ACPI_TABLE_FADT, AcpiGbl_FADT); 260 ACPI_GLOBAL (UINT32, AcpiCurrentGpeCount); 261 ACPI_GLOBAL (BOOLEAN, AcpiGbl_SystemAwakeAndRunning); 262 263 264 /***************************************************************************** 265 * 266 * ACPICA public interface configuration. 267 * 268 * Interfaces that are configured out of the ACPICA build are replaced 269 * by inlined stubs by default. 270 * 271 ****************************************************************************/ 272 273 /* 274 * Hardware-reduced prototypes (default: Not hardware reduced). 275 * 276 * All ACPICA hardware-related interfaces that use these macros will be 277 * configured out of the ACPICA build if the ACPI_REDUCED_HARDWARE flag 278 * is set to TRUE. 279 * 280 * Note: This static build option for reduced hardware is intended to 281 * reduce ACPICA code size if desired or necessary. However, even if this 282 * option is not specified, the runtime behavior of ACPICA is dependent 283 * on the actual FADT reduced hardware flag (HW_REDUCED_ACPI). If set, 284 * the flag will enable similar behavior -- ACPICA will not attempt 285 * to access any ACPI-relate hardware (SCI, GPEs, Fixed Events, etc.) 286 */ 287 #if (!ACPI_REDUCED_HARDWARE) 288 #define ACPI_HW_DEPENDENT_RETURN_STATUS(Prototype) \ 289 ACPI_EXTERNAL_RETURN_STATUS(Prototype) 290 291 #define ACPI_HW_DEPENDENT_RETURN_OK(Prototype) \ 292 ACPI_EXTERNAL_RETURN_OK(Prototype) 293 294 #define ACPI_HW_DEPENDENT_RETURN_VOID(Prototype) \ 295 ACPI_EXTERNAL_RETURN_VOID(Prototype) 296 297 #else 298 #define ACPI_HW_DEPENDENT_RETURN_STATUS(Prototype) \ 299 static ACPI_INLINE Prototype {return(AE_NOT_CONFIGURED);} 300 301 #define ACPI_HW_DEPENDENT_RETURN_OK(Prototype) \ 302 static ACPI_INLINE Prototype {return(AE_OK);} 303 304 #define ACPI_HW_DEPENDENT_RETURN_VOID(Prototype) \ 305 static ACPI_INLINE Prototype {return;} 306 307 #endif /* !ACPI_REDUCED_HARDWARE */ 308 309 310 /* 311 * Error message prototypes (default: error messages enabled). 312 * 313 * All interfaces related to error and warning messages 314 * will be configured out of the ACPICA build if the 315 * ACPI_NO_ERROR_MESSAGE flag is defined. 316 */ 317 #ifndef ACPI_NO_ERROR_MESSAGES 318 #define ACPI_MSG_DEPENDENT_RETURN_VOID(Prototype) \ 319 Prototype; 320 321 #else 322 #define ACPI_MSG_DEPENDENT_RETURN_VOID(Prototype) \ 323 static ACPI_INLINE Prototype {return;} 324 325 #endif /* ACPI_NO_ERROR_MESSAGES */ 326 327 328 /* 329 * Debugging output prototypes (default: no debug output). 330 * 331 * All interfaces related to debug output messages 332 * will be configured out of the ACPICA build unless the 333 * ACPI_DEBUG_OUTPUT flag is defined. 334 */ 335 #ifdef ACPI_DEBUG_OUTPUT 336 #define ACPI_DBG_DEPENDENT_RETURN_VOID(Prototype) \ 337 Prototype; 338 339 #else 340 #define ACPI_DBG_DEPENDENT_RETURN_VOID(Prototype) \ 341 static ACPI_INLINE Prototype {return;} 342 343 #endif /* ACPI_DEBUG_OUTPUT */ 344 345 346 /* 347 * Application prototypes 348 * 349 * All interfaces used by application will be configured 350 * out of the ACPICA build unless the ACPI_APPLICATION 351 * flag is defined. 352 */ 353 #ifdef ACPI_APPLICATION 354 #define ACPI_APP_DEPENDENT_RETURN_VOID(Prototype) \ 355 Prototype; 356 357 #else 358 #define ACPI_APP_DEPENDENT_RETURN_VOID(Prototype) \ 359 static ACPI_INLINE Prototype {return;} 360 361 #endif /* ACPI_APPLICATION */ 362 363 364 /***************************************************************************** 365 * 366 * ACPICA public interface prototypes 367 * 368 ****************************************************************************/ 369 370 /* 371 * Initialization 372 */ 373 ACPI_EXTERNAL_RETURN_STATUS ( 374 ACPI_STATUS 375 AcpiInitializeTables ( 376 ACPI_TABLE_DESC *InitialStorage, 377 UINT32 InitialTableCount, 378 BOOLEAN AllowResize)) 379 380 ACPI_EXTERNAL_RETURN_STATUS ( 381 ACPI_STATUS 382 AcpiInitializeSubsystem ( 383 void)) 384 385 ACPI_EXTERNAL_RETURN_STATUS ( 386 ACPI_STATUS 387 AcpiEnableSubsystem ( 388 UINT32 Flags)) 389 390 ACPI_EXTERNAL_RETURN_STATUS ( 391 ACPI_STATUS 392 AcpiInitializeObjects ( 393 UINT32 Flags)) 394 395 ACPI_EXTERNAL_RETURN_STATUS ( 396 ACPI_STATUS 397 AcpiTerminate ( 398 void)) 399 400 401 /* 402 * Miscellaneous global interfaces 403 */ 404 ACPI_HW_DEPENDENT_RETURN_STATUS ( 405 ACPI_STATUS 406 AcpiEnable ( 407 void)) 408 409 ACPI_HW_DEPENDENT_RETURN_STATUS ( 410 ACPI_STATUS 411 AcpiDisable ( 412 void)) 413 414 ACPI_EXTERNAL_RETURN_STATUS ( 415 ACPI_STATUS 416 AcpiSubsystemStatus ( 417 void)) 418 419 ACPI_EXTERNAL_RETURN_STATUS ( 420 ACPI_STATUS 421 AcpiGetSystemInfo ( 422 ACPI_BUFFER *RetBuffer)) 423 424 ACPI_EXTERNAL_RETURN_STATUS ( 425 ACPI_STATUS 426 AcpiGetStatistics ( 427 ACPI_STATISTICS *Stats)) 428 429 ACPI_EXTERNAL_RETURN_PTR ( 430 const char * 431 AcpiFormatException ( 432 ACPI_STATUS Exception)) 433 434 ACPI_EXTERNAL_RETURN_STATUS ( 435 ACPI_STATUS 436 AcpiPurgeCachedObjects ( 437 void)) 438 439 ACPI_EXTERNAL_RETURN_STATUS ( 440 ACPI_STATUS 441 AcpiInstallInterface ( 442 ACPI_STRING InterfaceName)) 443 444 ACPI_EXTERNAL_RETURN_STATUS ( 445 ACPI_STATUS 446 AcpiRemoveInterface ( 447 ACPI_STRING InterfaceName)) 448 449 ACPI_EXTERNAL_RETURN_STATUS ( 450 ACPI_STATUS 451 AcpiUpdateInterfaces ( 452 UINT8 Action)) 453 454 ACPI_EXTERNAL_RETURN_UINT32 ( 455 UINT32 456 AcpiCheckAddressRange ( 457 ACPI_ADR_SPACE_TYPE SpaceId, 458 ACPI_PHYSICAL_ADDRESS Address, 459 ACPI_SIZE Length, 460 BOOLEAN Warn)) 461 462 ACPI_EXTERNAL_RETURN_STATUS ( 463 ACPI_STATUS 464 AcpiDecodePldBuffer ( 465 UINT8 *InBuffer, 466 ACPI_SIZE Length, 467 ACPI_PLD_INFO **ReturnBuffer)) 468 469 470 /* 471 * ACPI table load/unload interfaces 472 */ 473 ACPI_EXTERNAL_RETURN_STATUS ( 474 ACPI_STATUS 475 AcpiInstallTable ( 476 ACPI_PHYSICAL_ADDRESS Address, 477 BOOLEAN Physical)) 478 479 ACPI_EXTERNAL_RETURN_STATUS ( 480 ACPI_STATUS 481 AcpiLoadTable ( 482 ACPI_TABLE_HEADER *Table)) 483 484 ACPI_EXTERNAL_RETURN_STATUS ( 485 ACPI_STATUS 486 AcpiUnloadParentTable ( 487 ACPI_HANDLE Object)) 488 489 ACPI_EXTERNAL_RETURN_STATUS ( 490 ACPI_STATUS 491 AcpiLoadTables ( 492 void)) 493 494 495 /* 496 * ACPI table manipulation interfaces 497 */ 498 ACPI_EXTERNAL_RETURN_STATUS ( 499 ACPI_STATUS 500 AcpiReallocateRootTable ( 501 void)) 502 503 ACPI_EXTERNAL_RETURN_STATUS ( 504 ACPI_STATUS 505 AcpiFindRootPointer ( 506 ACPI_PHYSICAL_ADDRESS *RsdpAddress)) 507 508 ACPI_EXTERNAL_RETURN_STATUS ( 509 ACPI_STATUS 510 AcpiGetTableHeader ( 511 ACPI_STRING Signature, 512 UINT32 Instance, 513 ACPI_TABLE_HEADER *OutTableHeader)) 514 515 ACPI_EXTERNAL_RETURN_STATUS ( 516 ACPI_STATUS 517 AcpiGetTable ( 518 ACPI_STRING Signature, 519 UINT32 Instance, 520 ACPI_TABLE_HEADER **OutTable)) 521 522 ACPI_EXTERNAL_RETURN_STATUS ( 523 ACPI_STATUS 524 AcpiGetTableByIndex ( 525 UINT32 TableIndex, 526 ACPI_TABLE_HEADER **OutTable)) 527 528 ACPI_EXTERNAL_RETURN_STATUS ( 529 ACPI_STATUS 530 AcpiInstallTableHandler ( 531 ACPI_TABLE_HANDLER Handler, 532 void *Context)) 533 534 ACPI_EXTERNAL_RETURN_STATUS ( 535 ACPI_STATUS 536 AcpiRemoveTableHandler ( 537 ACPI_TABLE_HANDLER Handler)) 538 539 540 /* 541 * Namespace and name interfaces 542 */ 543 ACPI_EXTERNAL_RETURN_STATUS ( 544 ACPI_STATUS 545 AcpiWalkNamespace ( 546 ACPI_OBJECT_TYPE Type, 547 ACPI_HANDLE StartObject, 548 UINT32 MaxDepth, 549 ACPI_WALK_CALLBACK DescendingCallback, 550 ACPI_WALK_CALLBACK AscendingCallback, 551 void *Context, 552 void **ReturnValue)) 553 554 ACPI_EXTERNAL_RETURN_STATUS ( 555 ACPI_STATUS 556 AcpiGetDevices ( 557 char *HID, 558 ACPI_WALK_CALLBACK UserFunction, 559 void *Context, 560 void **ReturnValue)) 561 562 ACPI_EXTERNAL_RETURN_STATUS ( 563 ACPI_STATUS 564 AcpiGetName ( 565 ACPI_HANDLE Object, 566 UINT32 NameType, 567 ACPI_BUFFER *RetPathPtr)) 568 569 ACPI_EXTERNAL_RETURN_STATUS ( 570 ACPI_STATUS 571 AcpiGetHandle ( 572 ACPI_HANDLE Parent, 573 ACPI_STRING Pathname, 574 ACPI_HANDLE *RetHandle)) 575 576 ACPI_EXTERNAL_RETURN_STATUS ( 577 ACPI_STATUS 578 AcpiAttachData ( 579 ACPI_HANDLE Object, 580 ACPI_OBJECT_HANDLER Handler, 581 void *Data)) 582 583 ACPI_EXTERNAL_RETURN_STATUS ( 584 ACPI_STATUS 585 AcpiDetachData ( 586 ACPI_HANDLE Object, 587 ACPI_OBJECT_HANDLER Handler)) 588 589 ACPI_EXTERNAL_RETURN_STATUS ( 590 ACPI_STATUS 591 AcpiGetData ( 592 ACPI_HANDLE Object, 593 ACPI_OBJECT_HANDLER Handler, 594 void **Data)) 595 596 ACPI_EXTERNAL_RETURN_STATUS ( 597 ACPI_STATUS 598 AcpiDebugTrace ( 599 char *Name, 600 UINT32 DebugLevel, 601 UINT32 DebugLayer, 602 UINT32 Flags)) 603 604 605 /* 606 * Object manipulation and enumeration 607 */ 608 ACPI_EXTERNAL_RETURN_STATUS ( 609 ACPI_STATUS 610 AcpiEvaluateObject ( 611 ACPI_HANDLE Object, 612 ACPI_STRING Pathname, 613 ACPI_OBJECT_LIST *ParameterObjects, 614 ACPI_BUFFER *ReturnObjectBuffer)) 615 616 ACPI_EXTERNAL_RETURN_STATUS ( 617 ACPI_STATUS 618 AcpiEvaluateObjectTyped ( 619 ACPI_HANDLE Object, 620 ACPI_STRING Pathname, 621 ACPI_OBJECT_LIST *ExternalParams, 622 ACPI_BUFFER *ReturnBuffer, 623 ACPI_OBJECT_TYPE ReturnType)) 624 625 ACPI_EXTERNAL_RETURN_STATUS ( 626 ACPI_STATUS 627 AcpiGetObjectInfo ( 628 ACPI_HANDLE Object, 629 ACPI_DEVICE_INFO **ReturnBuffer)) 630 631 ACPI_EXTERNAL_RETURN_STATUS ( 632 ACPI_STATUS 633 AcpiInstallMethod ( 634 UINT8 *Buffer)) 635 636 ACPI_EXTERNAL_RETURN_STATUS ( 637 ACPI_STATUS 638 AcpiGetNextObject ( 639 ACPI_OBJECT_TYPE Type, 640 ACPI_HANDLE Parent, 641 ACPI_HANDLE Child, 642 ACPI_HANDLE *OutHandle)) 643 644 ACPI_EXTERNAL_RETURN_STATUS ( 645 ACPI_STATUS 646 AcpiGetType ( 647 ACPI_HANDLE Object, 648 ACPI_OBJECT_TYPE *OutType)) 649 650 ACPI_EXTERNAL_RETURN_STATUS ( 651 ACPI_STATUS 652 AcpiGetParent ( 653 ACPI_HANDLE Object, 654 ACPI_HANDLE *OutHandle)) 655 656 657 /* 658 * Handler interfaces 659 */ 660 ACPI_EXTERNAL_RETURN_STATUS ( 661 ACPI_STATUS 662 AcpiInstallInitializationHandler ( 663 ACPI_INIT_HANDLER Handler, 664 UINT32 Function)) 665 666 ACPI_HW_DEPENDENT_RETURN_STATUS ( 667 ACPI_STATUS 668 AcpiInstallSciHandler ( 669 ACPI_SCI_HANDLER Address, 670 void *Context)) 671 672 ACPI_HW_DEPENDENT_RETURN_STATUS ( 673 ACPI_STATUS 674 AcpiRemoveSciHandler ( 675 ACPI_SCI_HANDLER Address)) 676 677 ACPI_HW_DEPENDENT_RETURN_STATUS ( 678 ACPI_STATUS 679 AcpiInstallGlobalEventHandler ( 680 ACPI_GBL_EVENT_HANDLER Handler, 681 void *Context)) 682 683 ACPI_HW_DEPENDENT_RETURN_STATUS ( 684 ACPI_STATUS 685 AcpiInstallFixedEventHandler ( 686 UINT32 AcpiEvent, 687 ACPI_EVENT_HANDLER Handler, 688 void *Context)) 689 690 ACPI_HW_DEPENDENT_RETURN_STATUS ( 691 ACPI_STATUS 692 AcpiRemoveFixedEventHandler ( 693 UINT32 AcpiEvent, 694 ACPI_EVENT_HANDLER Handler)) 695 696 ACPI_HW_DEPENDENT_RETURN_STATUS ( 697 ACPI_STATUS 698 AcpiInstallGpeHandler ( 699 ACPI_HANDLE GpeDevice, 700 UINT32 GpeNumber, 701 UINT32 Type, 702 ACPI_GPE_HANDLER Address, 703 void *Context)) 704 705 ACPI_HW_DEPENDENT_RETURN_STATUS ( 706 ACPI_STATUS 707 AcpiInstallGpeRawHandler ( 708 ACPI_HANDLE GpeDevice, 709 UINT32 GpeNumber, 710 UINT32 Type, 711 ACPI_GPE_HANDLER Address, 712 void *Context)) 713 714 ACPI_HW_DEPENDENT_RETURN_STATUS ( 715 ACPI_STATUS 716 AcpiRemoveGpeHandler ( 717 ACPI_HANDLE GpeDevice, 718 UINT32 GpeNumber, 719 ACPI_GPE_HANDLER Address)) 720 721 ACPI_EXTERNAL_RETURN_STATUS ( 722 ACPI_STATUS 723 AcpiInstallNotifyHandler ( 724 ACPI_HANDLE Device, 725 UINT32 HandlerType, 726 ACPI_NOTIFY_HANDLER Handler, 727 void *Context)) 728 729 ACPI_EXTERNAL_RETURN_STATUS ( 730 ACPI_STATUS 731 AcpiRemoveNotifyHandler ( 732 ACPI_HANDLE Device, 733 UINT32 HandlerType, 734 ACPI_NOTIFY_HANDLER Handler)) 735 736 ACPI_EXTERNAL_RETURN_STATUS ( 737 ACPI_STATUS 738 AcpiInstallAddressSpaceHandler ( 739 ACPI_HANDLE Device, 740 ACPI_ADR_SPACE_TYPE SpaceId, 741 ACPI_ADR_SPACE_HANDLER Handler, 742 ACPI_ADR_SPACE_SETUP Setup, 743 void *Context)) 744 745 ACPI_EXTERNAL_RETURN_STATUS ( 746 ACPI_STATUS 747 AcpiRemoveAddressSpaceHandler ( 748 ACPI_HANDLE Device, 749 ACPI_ADR_SPACE_TYPE SpaceId, 750 ACPI_ADR_SPACE_HANDLER Handler)) 751 752 ACPI_EXTERNAL_RETURN_STATUS ( 753 ACPI_STATUS 754 AcpiInstallExceptionHandler ( 755 ACPI_EXCEPTION_HANDLER Handler)) 756 757 ACPI_EXTERNAL_RETURN_STATUS ( 758 ACPI_STATUS 759 AcpiInstallInterfaceHandler ( 760 ACPI_INTERFACE_HANDLER Handler)) 761 762 763 /* 764 * Global Lock interfaces 765 */ 766 ACPI_HW_DEPENDENT_RETURN_STATUS ( 767 ACPI_STATUS 768 AcpiAcquireGlobalLock ( 769 UINT16 Timeout, 770 UINT32 *Handle)) 771 772 ACPI_HW_DEPENDENT_RETURN_STATUS ( 773 ACPI_STATUS 774 AcpiReleaseGlobalLock ( 775 UINT32 Handle)) 776 777 778 /* 779 * Interfaces to AML mutex objects 780 */ 781 ACPI_EXTERNAL_RETURN_STATUS ( 782 ACPI_STATUS 783 AcpiAcquireMutex ( 784 ACPI_HANDLE Handle, 785 ACPI_STRING Pathname, 786 UINT16 Timeout)) 787 788 ACPI_EXTERNAL_RETURN_STATUS ( 789 ACPI_STATUS 790 AcpiReleaseMutex ( 791 ACPI_HANDLE Handle, 792 ACPI_STRING Pathname)) 793 794 795 /* 796 * Fixed Event interfaces 797 */ 798 ACPI_HW_DEPENDENT_RETURN_STATUS ( 799 ACPI_STATUS 800 AcpiEnableEvent ( 801 UINT32 Event, 802 UINT32 Flags)) 803 804 ACPI_HW_DEPENDENT_RETURN_STATUS ( 805 ACPI_STATUS 806 AcpiDisableEvent ( 807 UINT32 Event, 808 UINT32 Flags)) 809 810 ACPI_HW_DEPENDENT_RETURN_STATUS ( 811 ACPI_STATUS 812 AcpiClearEvent ( 813 UINT32 Event)) 814 815 ACPI_HW_DEPENDENT_RETURN_STATUS ( 816 ACPI_STATUS 817 AcpiGetEventStatus ( 818 UINT32 Event, 819 ACPI_EVENT_STATUS *EventStatus)) 820 821 822 /* 823 * General Purpose Event (GPE) Interfaces 824 */ 825 ACPI_HW_DEPENDENT_RETURN_STATUS ( 826 ACPI_STATUS 827 AcpiUpdateAllGpes ( 828 void)) 829 830 ACPI_HW_DEPENDENT_RETURN_STATUS ( 831 ACPI_STATUS 832 AcpiEnableGpe ( 833 ACPI_HANDLE GpeDevice, 834 UINT32 GpeNumber)) 835 836 ACPI_HW_DEPENDENT_RETURN_STATUS ( 837 ACPI_STATUS 838 AcpiDisableGpe ( 839 ACPI_HANDLE GpeDevice, 840 UINT32 GpeNumber)) 841 842 ACPI_HW_DEPENDENT_RETURN_STATUS ( 843 ACPI_STATUS 844 AcpiClearGpe ( 845 ACPI_HANDLE GpeDevice, 846 UINT32 GpeNumber)) 847 848 ACPI_HW_DEPENDENT_RETURN_STATUS ( 849 ACPI_STATUS 850 AcpiSetGpe ( 851 ACPI_HANDLE GpeDevice, 852 UINT32 GpeNumber, 853 UINT8 Action)) 854 855 ACPI_HW_DEPENDENT_RETURN_STATUS ( 856 ACPI_STATUS 857 AcpiFinishGpe ( 858 ACPI_HANDLE GpeDevice, 859 UINT32 GpeNumber)) 860 861 ACPI_HW_DEPENDENT_RETURN_STATUS ( 862 ACPI_STATUS 863 AcpiMarkGpeForWake ( 864 ACPI_HANDLE GpeDevice, 865 UINT32 GpeNumber)) 866 867 ACPI_HW_DEPENDENT_RETURN_STATUS ( 868 ACPI_STATUS 869 AcpiSetupGpeForWake ( 870 ACPI_HANDLE ParentDevice, 871 ACPI_HANDLE GpeDevice, 872 UINT32 GpeNumber)) 873 874 ACPI_HW_DEPENDENT_RETURN_STATUS ( 875 ACPI_STATUS 876 AcpiSetGpeWakeMask ( 877 ACPI_HANDLE GpeDevice, 878 UINT32 GpeNumber, 879 UINT8 Action)) 880 881 ACPI_HW_DEPENDENT_RETURN_STATUS ( 882 ACPI_STATUS 883 AcpiGetGpeStatus ( 884 ACPI_HANDLE GpeDevice, 885 UINT32 GpeNumber, 886 ACPI_EVENT_STATUS *EventStatus)) 887 888 ACPI_HW_DEPENDENT_RETURN_STATUS ( 889 ACPI_STATUS 890 AcpiDisableAllGpes ( 891 void)) 892 893 ACPI_HW_DEPENDENT_RETURN_STATUS ( 894 ACPI_STATUS 895 AcpiEnableAllRuntimeGpes ( 896 void)) 897 898 ACPI_HW_DEPENDENT_RETURN_STATUS ( 899 ACPI_STATUS 900 AcpiEnableAllWakeupGpes ( 901 void)) 902 903 ACPI_HW_DEPENDENT_RETURN_STATUS ( 904 ACPI_STATUS 905 AcpiGetGpeDevice ( 906 UINT32 GpeIndex, 907 ACPI_HANDLE *GpeDevice)) 908 909 ACPI_HW_DEPENDENT_RETURN_STATUS ( 910 ACPI_STATUS 911 AcpiInstallGpeBlock ( 912 ACPI_HANDLE GpeDevice, 913 ACPI_GENERIC_ADDRESS *GpeBlockAddress, 914 UINT32 RegisterCount, 915 UINT32 InterruptNumber)) 916 917 ACPI_HW_DEPENDENT_RETURN_STATUS ( 918 ACPI_STATUS 919 AcpiRemoveGpeBlock ( 920 ACPI_HANDLE GpeDevice)) 921 922 923 /* 924 * Resource interfaces 925 */ 926 typedef 927 ACPI_STATUS (*ACPI_WALK_RESOURCE_CALLBACK) ( 928 ACPI_RESOURCE *Resource, 929 void *Context); 930 931 ACPI_EXTERNAL_RETURN_STATUS ( 932 ACPI_STATUS 933 AcpiGetVendorResource ( 934 ACPI_HANDLE Device, 935 char *Name, 936 ACPI_VENDOR_UUID *Uuid, 937 ACPI_BUFFER *RetBuffer)) 938 939 ACPI_EXTERNAL_RETURN_STATUS ( 940 ACPI_STATUS 941 AcpiGetCurrentResources ( 942 ACPI_HANDLE Device, 943 ACPI_BUFFER *RetBuffer)) 944 945 ACPI_EXTERNAL_RETURN_STATUS ( 946 ACPI_STATUS 947 AcpiGetPossibleResources ( 948 ACPI_HANDLE Device, 949 ACPI_BUFFER *RetBuffer)) 950 951 ACPI_EXTERNAL_RETURN_STATUS ( 952 ACPI_STATUS 953 AcpiGetEventResources ( 954 ACPI_HANDLE DeviceHandle, 955 ACPI_BUFFER *RetBuffer)) 956 957 ACPI_EXTERNAL_RETURN_STATUS ( 958 ACPI_STATUS 959 AcpiWalkResourceBuffer ( 960 ACPI_BUFFER *Buffer, 961 ACPI_WALK_RESOURCE_CALLBACK UserFunction, 962 void *Context)) 963 964 ACPI_EXTERNAL_RETURN_STATUS ( 965 ACPI_STATUS 966 AcpiWalkResources ( 967 ACPI_HANDLE Device, 968 char *Name, 969 ACPI_WALK_RESOURCE_CALLBACK UserFunction, 970 void *Context)) 971 972 ACPI_EXTERNAL_RETURN_STATUS ( 973 ACPI_STATUS 974 AcpiSetCurrentResources ( 975 ACPI_HANDLE Device, 976 ACPI_BUFFER *InBuffer)) 977 978 ACPI_EXTERNAL_RETURN_STATUS ( 979 ACPI_STATUS 980 AcpiGetIrqRoutingTable ( 981 ACPI_HANDLE Device, 982 ACPI_BUFFER *RetBuffer)) 983 984 ACPI_EXTERNAL_RETURN_STATUS ( 985 ACPI_STATUS 986 AcpiResourceToAddress64 ( 987 ACPI_RESOURCE *Resource, 988 ACPI_RESOURCE_ADDRESS64 *Out)) 989 990 ACPI_EXTERNAL_RETURN_STATUS ( 991 ACPI_STATUS 992 AcpiBufferToResource ( 993 UINT8 *AmlBuffer, 994 UINT16 AmlBufferLength, 995 ACPI_RESOURCE **ResourcePtr)) 996 997 998 /* 999 * Hardware (ACPI device) interfaces 1000 */ 1001 ACPI_EXTERNAL_RETURN_STATUS ( 1002 ACPI_STATUS 1003 AcpiReset ( 1004 void)) 1005 1006 ACPI_EXTERNAL_RETURN_STATUS ( 1007 ACPI_STATUS 1008 AcpiRead ( 1009 UINT64 *Value, 1010 ACPI_GENERIC_ADDRESS *Reg)) 1011 1012 ACPI_EXTERNAL_RETURN_STATUS ( 1013 ACPI_STATUS 1014 AcpiWrite ( 1015 UINT64 Value, 1016 ACPI_GENERIC_ADDRESS *Reg)) 1017 1018 ACPI_HW_DEPENDENT_RETURN_STATUS ( 1019 ACPI_STATUS 1020 AcpiReadBitRegister ( 1021 UINT32 RegisterId, 1022 UINT32 *ReturnValue)) 1023 1024 ACPI_HW_DEPENDENT_RETURN_STATUS ( 1025 ACPI_STATUS 1026 AcpiWriteBitRegister ( 1027 UINT32 RegisterId, 1028 UINT32 Value)) 1029 1030 1031 /* 1032 * Sleep/Wake interfaces 1033 */ 1034 ACPI_EXTERNAL_RETURN_STATUS ( 1035 ACPI_STATUS 1036 AcpiGetSleepTypeData ( 1037 UINT8 SleepState, 1038 UINT8 *Slp_TypA, 1039 UINT8 *Slp_TypB)) 1040 1041 ACPI_EXTERNAL_RETURN_STATUS ( 1042 ACPI_STATUS 1043 AcpiEnterSleepStatePrep ( 1044 UINT8 SleepState)) 1045 1046 ACPI_EXTERNAL_RETURN_STATUS ( 1047 ACPI_STATUS 1048 AcpiEnterSleepState ( 1049 UINT8 SleepState)) 1050 1051 ACPI_HW_DEPENDENT_RETURN_STATUS ( 1052 ACPI_STATUS 1053 AcpiEnterSleepStateS4bios ( 1054 void)) 1055 1056 ACPI_EXTERNAL_RETURN_STATUS ( 1057 ACPI_STATUS 1058 AcpiLeaveSleepStatePrep ( 1059 UINT8 SleepState)) 1060 1061 ACPI_EXTERNAL_RETURN_STATUS ( 1062 ACPI_STATUS 1063 AcpiLeaveSleepState ( 1064 UINT8 SleepState)) 1065 1066 ACPI_HW_DEPENDENT_RETURN_STATUS ( 1067 ACPI_STATUS 1068 AcpiSetFirmwareWakingVector ( 1069 UINT32 PhysicalAddress)) 1070 1071 #if ACPI_MACHINE_WIDTH == 64 1072 ACPI_HW_DEPENDENT_RETURN_STATUS ( 1073 ACPI_STATUS 1074 AcpiSetFirmwareWakingVector64 ( 1075 UINT64 PhysicalAddress)) 1076 #endif 1077 1078 1079 /* 1080 * ACPI Timer interfaces 1081 */ 1082 ACPI_HW_DEPENDENT_RETURN_STATUS ( 1083 ACPI_STATUS 1084 AcpiGetTimerResolution ( 1085 UINT32 *Resolution)) 1086 1087 ACPI_HW_DEPENDENT_RETURN_STATUS ( 1088 ACPI_STATUS 1089 AcpiGetTimer ( 1090 UINT32 *Ticks)) 1091 1092 ACPI_HW_DEPENDENT_RETURN_STATUS ( 1093 ACPI_STATUS 1094 AcpiGetTimerDuration ( 1095 UINT32 StartTicks, 1096 UINT32 EndTicks, 1097 UINT32 *TimeElapsed)) 1098 1099 1100 /* 1101 * Error/Warning output 1102 */ 1103 ACPI_MSG_DEPENDENT_RETURN_VOID ( 1104 ACPI_PRINTF_LIKE(3) 1105 void ACPI_INTERNAL_VAR_XFACE 1106 AcpiError ( 1107 const char *ModuleName, 1108 UINT32 LineNumber, 1109 const char *Format, 1110 ...)) 1111 1112 ACPI_MSG_DEPENDENT_RETURN_VOID ( 1113 ACPI_PRINTF_LIKE(4) 1114 void ACPI_INTERNAL_VAR_XFACE 1115 AcpiException ( 1116 const char *ModuleName, 1117 UINT32 LineNumber, 1118 ACPI_STATUS Status, 1119 const char *Format, 1120 ...)) 1121 1122 ACPI_MSG_DEPENDENT_RETURN_VOID ( 1123 ACPI_PRINTF_LIKE(3) 1124 void ACPI_INTERNAL_VAR_XFACE 1125 AcpiWarning ( 1126 const char *ModuleName, 1127 UINT32 LineNumber, 1128 const char *Format, 1129 ...)) 1130 1131 ACPI_MSG_DEPENDENT_RETURN_VOID ( 1132 ACPI_PRINTF_LIKE(3) 1133 void ACPI_INTERNAL_VAR_XFACE 1134 AcpiInfo ( 1135 const char *ModuleName, 1136 UINT32 LineNumber, 1137 const char *Format, 1138 ...)) 1139 1140 ACPI_MSG_DEPENDENT_RETURN_VOID ( 1141 ACPI_PRINTF_LIKE(3) 1142 void ACPI_INTERNAL_VAR_XFACE 1143 AcpiBiosError ( 1144 const char *ModuleName, 1145 UINT32 LineNumber, 1146 const char *Format, 1147 ...)) 1148 1149 ACPI_MSG_DEPENDENT_RETURN_VOID ( 1150 ACPI_PRINTF_LIKE(3) 1151 void ACPI_INTERNAL_VAR_XFACE 1152 AcpiBiosWarning ( 1153 const char *ModuleName, 1154 UINT32 LineNumber, 1155 const char *Format, 1156 ...)) 1157 1158 1159 /* 1160 * Debug output 1161 */ 1162 ACPI_DBG_DEPENDENT_RETURN_VOID ( 1163 ACPI_PRINTF_LIKE(6) 1164 void ACPI_INTERNAL_VAR_XFACE 1165 AcpiDebugPrint ( 1166 UINT32 RequestedDebugLevel, 1167 UINT32 LineNumber, 1168 const char *FunctionName, 1169 const char *ModuleName, 1170 UINT32 ComponentId, 1171 const char *Format, 1172 ...)) 1173 1174 ACPI_DBG_DEPENDENT_RETURN_VOID ( 1175 ACPI_PRINTF_LIKE(6) 1176 void ACPI_INTERNAL_VAR_XFACE 1177 AcpiDebugPrintRaw ( 1178 UINT32 RequestedDebugLevel, 1179 UINT32 LineNumber, 1180 const char *FunctionName, 1181 const char *ModuleName, 1182 UINT32 ComponentId, 1183 const char *Format, 1184 ...)) 1185 1186 ACPI_APP_DEPENDENT_RETURN_VOID ( 1187 ACPI_PRINTF_LIKE(1) 1188 void ACPI_INTERNAL_VAR_XFACE 1189 AcpiLogError ( 1190 const char *Format, 1191 ...)) 1192 1193 #endif /* __ACXFACE_H__ */ 1194
Indexes created Wed Oct 22 13:09:56 GMT 2025