]> git.proxmox.com Git - mirror_edk2.git/blobdiff - MdePkg/Include/IndustryStandard/Acpi10.h
Update the copyright notice format
[mirror_edk2.git] / MdePkg / Include / IndustryStandard / Acpi10.h
index bd05553e048922f14665dae1ecb43a09df5a59de..7bb9d411c22bd87f295172ac0b211b3588856451 100644 (file)
@@ -1,14 +1,14 @@
 /** @file   \r
-       ACPI 1.0b definitions from the ACPI Specification, revision 1.0b\r
-\r
-  Copyright (c) 2006 - 2008, Intel Corporation\r
-  All rights reserved. This program and the accompanying materials                          \r
-  are licensed and made available under the terms and conditions of the BSD License         \r
-  which accompanies this distribution.  The full text of the license may be found at        \r
-  http://opensource.org/licenses/bsd-license.php                                            \r
-\r
-  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     \r
-  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             \r
+  ACPI 1.0b definitions from the ACPI Specification, revision 1.0b\r
+\r
+Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved.<BR>\r
+This program and the accompanying materials are licensed and made available under \r
+the terms and conditions of the BSD License that accompanies this distribution.  \r
+The full text of the license may be found at\r
+http://opensource.org/licenses/bsd-license.php.                                          \r
+    \r
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     \r
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             \r
 **/\r
 \r
 #ifndef _ACPI_1_0_H_\r
 \r
 ///\r
 /// Common table header, this prefaces all ACPI tables, including FACS, but\r
-/// excluding the RSD PTR structure\r
+/// excluding the RSD PTR structure.\r
 ///\r
 typedef struct {\r
   UINT32  Signature;\r
   UINT32  Length;\r
 } EFI_ACPI_COMMON_HEADER;\r
 \r
-//\r
-// Common ACPI description table header.  This structure prefaces most ACPI tables.\r
-//\r
 #pragma pack(1)\r
-\r
+///\r
+/// The common ACPI description table header.  This structure prefaces most ACPI tables.\r
+///\r
 typedef struct {\r
   UINT32  Signature;\r
   UINT32  Length;\r
@@ -39,8 +38,8 @@ typedef struct {
   UINT32  CreatorId;\r
   UINT32  CreatorRevision;\r
 } EFI_ACPI_DESCRIPTION_HEADER;\r
-\r
 #pragma pack()\r
+\r
 //\r
 // Define for Desriptor\r
 //\r
@@ -55,7 +54,7 @@ typedef struct {
 #define ACPI_ADDRESS_SPACE_TYPE_BUS   0x02\r
 \r
 ///\r
-/// Power Management Timer frequency is fixed at 3.579545MHz\r
+/// Power Management Timer frequency is fixed at 3.579545MHz.\r
 ///\r
 #define ACPI_TIMER_FREQUENCY       3579545\r
 \r
@@ -63,11 +62,12 @@ typedef struct {
 // Ensure proper structure formats\r
 //\r
 #pragma pack(1)\r
-//\r
-// The commond definition of QWORD, DWORD, and WORD\r
-// Address Space Descriptors\r
-//\r
-typedef struct {\r
+\r
+///\r
+/// The commond definition of QWORD, DWORD, and WORD\r
+/// Address Space Descriptors.\r
+///\r
+typedef PACKED struct {\r
   UINT8   Desc;\r
   UINT16  Len;\r
   UINT8   ResType;\r
@@ -82,6 +82,9 @@ typedef struct {
 \r
 #pragma pack()\r
 \r
+///\r
+/// The End tag identifies an end of resource data.\r
+///\r
 typedef struct {\r
   UINT8 Desc;\r
   UINT8 Checksum;\r
@@ -132,7 +135,7 @@ typedef struct {
 //\r
 \r
 ///\r
-/// Root System Description Pointer Structure\r
+/// Root System Description Pointer Structure.\r
 ///\r
 typedef struct {\r
   UINT64  Signature;\r
@@ -149,12 +152,12 @@ typedef struct {
 //\r
 \r
 ///\r
-/// RSDT Revision (as defined in ACPI 1.0b spec.)\r
+/// RSDT Revision (as defined in ACPI 1.0b specification).\r
 ///\r
 #define EFI_ACPI_1_0_ROOT_SYSTEM_DESCRIPTION_TABLE_REVISION 0x01\r
 \r
 ///\r
-/// Fixed ACPI Description Table Structure (FADT)\r
+/// Fixed ACPI Description Table Structure (FADT).\r
 ///\r
 typedef struct {\r
   EFI_ACPI_DESCRIPTION_HEADER Header;\r
@@ -200,7 +203,7 @@ typedef struct {
 } EFI_ACPI_1_0_FIXED_ACPI_DESCRIPTION_TABLE;\r
 \r
 ///\r
-/// FADT Version (as defined in ACPI 1.0b spec.)\r
+/// FADT Version (as defined in ACPI 1.0b specification).\r
 ///\r
 #define EFI_ACPI_1_0_FIXED_ACPI_DESCRIPTION_TABLE_REVISION  0x01\r
 \r
@@ -208,19 +211,19 @@ typedef struct {
 // Fixed ACPI Description Table Fixed Feature Flags\r
 // All other bits are reserved and must be set to 0.\r
 //\r
-#define EFI_ACPI_1_0_WBINVD       (1 << 0)\r
-#define EFI_ACPI_1_0_WBINVD_FLUSH (1 << 1)\r
-#define EFI_ACPI_1_0_PROC_C1      (1 << 2)\r
-#define EFI_ACPI_1_0_P_LVL2_UP    (1 << 3)\r
-#define EFI_ACPI_1_0_PWR_BUTTON   (1 << 4)\r
-#define EFI_ACPI_1_0_SLP_BUTTON   (1 << 5)\r
-#define EFI_ACPI_1_0_FIX_RTC      (1 << 6)\r
-#define EFI_ACPI_1_0_RTC_S4       (1 << 7)\r
-#define EFI_ACPI_1_0_TMR_VAL_EXT  (1 << 8)\r
-#define EFI_ACPI_1_0_DCK_CAP      (1 << 9)\r
+#define EFI_ACPI_1_0_WBINVD               BIT0\r
+#define EFI_ACPI_1_0_WBINVD_FLUSH         BIT1\r
+#define EFI_ACPI_1_0_PROC_C1              BIT2\r
+#define EFI_ACPI_1_0_P_LVL2_UP            BIT3\r
+#define EFI_ACPI_1_0_PWR_BUTTON           BIT4\r
+#define EFI_ACPI_1_0_SLP_BUTTON           BIT5\r
+#define EFI_ACPI_1_0_FIX_RTC              BIT6\r
+#define EFI_ACPI_1_0_RTC_S4               BIT7\r
+#define EFI_ACPI_1_0_TMR_VAL_EXT          BIT8\r
+#define EFI_ACPI_1_0_DCK_CAP              BIT9\r
 \r
 ///\r
-/// Firmware ACPI Control Structure\r
+/// Firmware ACPI Control Structure.\r
 ///\r
 typedef struct {\r
   UINT32  Signature;\r
@@ -233,14 +236,14 @@ typedef struct {
 } EFI_ACPI_1_0_FIRMWARE_ACPI_CONTROL_STRUCTURE;\r
 \r
 ///\r
-/// Firmware Control Structure Feature Flags\r
+/// Firmware Control Structure Feature Flags.\r
 /// All other bits are reserved and must be set to 0.\r
 ///\r
-#define EFI_ACPI_1_0_S4BIOS_F (1 << 0)\r
+#define EFI_ACPI_1_0_S4BIOS_F             BIT0\r
 \r
 ///\r
 /// Multiple APIC Description Table header definition.  The rest of the table\r
-/// must be defined in a platform specific manner.\r
+/// must be defined in a platform-specific manner.\r
 ///\r
 typedef struct {\r
   EFI_ACPI_DESCRIPTION_HEADER Header;\r
@@ -249,7 +252,7 @@ typedef struct {
 } EFI_ACPI_1_0_MULTIPLE_APIC_DESCRIPTION_TABLE_HEADER;\r
 \r
 ///\r
-/// MADT Revision (as defined in ACPI 1.0b spec.)\r
+/// MADT Revision (as defined in ACPI 1.0b specification).\r
 ///\r
 #define EFI_ACPI_1_0_MULTIPLE_APIC_DESCRIPTION_TABLE_REVISION 0x01\r
 \r
@@ -257,7 +260,7 @@ typedef struct {
 /// Multiple APIC Flags\r
 /// All other bits are reserved and must be set to 0.\r
 ///\r
-#define EFI_ACPI_1_0_PCAT_COMPAT  (1 << 0)\r
+#define EFI_ACPI_1_0_PCAT_COMPAT           BIT0\r
 \r
 //\r
 // Multiple APIC Description Table APIC structure types\r
@@ -275,7 +278,7 @@ typedef struct {
 //\r
 \r
 ///\r
-/// Processor Local APIC Structure Definition\r
+/// Processor Local APIC Structure Definition.\r
 ///\r
 typedef struct {\r
   UINT8   Type;\r
@@ -288,10 +291,10 @@ typedef struct {
 ///\r
 /// Local APIC Flags.  All other bits are reserved and must be 0.\r
 ///\r
-#define EFI_ACPI_1_0_LOCAL_APIC_ENABLED (1 << 0)\r
+#define EFI_ACPI_1_0_LOCAL_APIC_ENABLED      BIT0\r
 \r
 ///\r
-/// IO APIC Structure\r
+/// IO APIC Structure.\r
 ///\r
 typedef struct {\r
   UINT8   Type;\r
@@ -303,7 +306,7 @@ typedef struct {
 } EFI_ACPI_1_0_IO_APIC_STRUCTURE;\r
 \r
 ///\r
-/// Interrupt Source Override Structure\r
+/// Interrupt Source Override Structure.\r
 ///\r
 typedef struct {\r
   UINT8   Type;\r
@@ -315,7 +318,7 @@ typedef struct {
 } EFI_ACPI_1_0_INTERRUPT_SOURCE_OVERRIDE_STRUCTURE;\r
 \r
 ///\r
-/// Non-Maskable Interrupt Source Structure\r
+/// Non-Maskable Interrupt Source Structure.\r
 ///\r
 typedef struct {\r
   UINT8   Type;\r
@@ -325,7 +328,7 @@ typedef struct {
 } EFI_ACPI_1_0_NON_MASKABLE_INTERRUPT_SOURCE_STRUCTURE;\r
 \r
 ///\r
-/// Local APIC NMI Structure\r
+/// Local APIC NMI Structure.\r
 ///\r
 typedef struct {\r
   UINT8   Type;\r
@@ -350,47 +353,47 @@ typedef struct {
 //\r
 \r
 ///\r
-/// "RSD PTR " Root System Description Pointer\r
+/// "RSD PTR " Root System Description Pointer.\r
 ///\r
 #define EFI_ACPI_1_0_ROOT_SYSTEM_DESCRIPTION_POINTER_SIGNATURE  SIGNATURE_64('R', 'S', 'D', ' ', 'P', 'T', 'R', ' ')\r
 \r
 ///\r
-/// "APIC" Multiple APIC Description Table\r
+/// "APIC" Multiple APIC Description Table.\r
 ///\r
 #define EFI_ACPI_1_0_APIC_SIGNATURE  SIGNATURE_32('A', 'P', 'I', 'C')\r
 \r
 ///\r
-/// "DSDT" Differentiated System Description Table\r
+/// "DSDT" Differentiated System Description Table.\r
 ///\r
 #define EFI_ACPI_1_0_DIFFERENTIATED_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('D', 'S', 'D', 'T')\r
 \r
 ///\r
-/// "FACS" Firmware ACPI Control Structure\r
+/// "FACS" Firmware ACPI Control Structure.\r
 ///\r
 #define EFI_ACPI_1_0_FIRMWARE_ACPI_CONTROL_STRUCTURE_SIGNATURE  SIGNATURE_32('F', 'A', 'C', 'S')\r
 \r
 ///\r
-/// "FACP" Fixed ACPI Description Table\r
+/// "FACP" Fixed ACPI Description Table.\r
 ///\r
 #define EFI_ACPI_1_0_FIXED_ACPI_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('F', 'A', 'C', 'P')\r
 \r
 ///\r
-/// "PSDT" Persistent System Description Table\r
+/// "PSDT" Persistent System Description Table.\r
 ///\r
 #define EFI_ACPI_1_0_PERSISTENT_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('P', 'S', 'D', 'T')\r
 \r
 ///\r
-/// "RSDT" Root System Description Table\r
+/// "RSDT" Root System Description Table.\r
 ///\r
 #define EFI_ACPI_1_0_ROOT_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('R', 'S', 'D', 'T')\r
 \r
 ///\r
-/// "SBST" Smart Battery Specification Table\r
+/// "SBST" Smart Battery Specification Table.\r
 ///\r
 #define EFI_ACPI_1_0_SMART_BATTERY_SPECIFICATION_TABLE_SIGNATURE  SIGNATURE_32('S', 'B', 'S', 'T')\r
 \r
 ///\r
-/// "SSDT" Secondary System Description Table\r
+/// "SSDT" Secondary System Description Table.\r
 ///\r
 #define EFI_ACPI_1_0_SECONDARY_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('S', 'S', 'D', 'T')\r
 \r