[mirror_edk2.git] / IntelFrameworkModulePkg / Include / Protocol / IsaAcpi.h

/** @file\r
  EFI ISA ACPI Protocol is used to enumerate and manage all the ISA controllers on\r
  the platform's ISA Bus.\r
\r
  Copyright (c) 2006 - 2009, 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
\r
**/\r
\r
#ifndef __ISA_ACPI_H_\r
#define __ISA_ACPI_H_\r
\r
///\r
/// Global ID for the EFI ISA ACPI Protocol\r
///\r
#define EFI_ISA_ACPI_PROTOCOL_GUID \\r
  { \\r
    0x64a892dc, 0x5561, 0x4536, { 0x92, 0xc7, 0x79, 0x9b, 0xfc, 0x18, 0x33, 0x55 } \\r
  }\r
\r
///\r
/// Forward declaration fo the EFI ISA ACPI Protocol\r
///\r
typedef struct _EFI_ISA_ACPI_PROTOCOL EFI_ISA_ACPI_PROTOCOL;\r
\r
///\r
/// ISA ACPI Protocol interrupt resource attributes\r
///\r
#define EFI_ISA_ACPI_IRQ_TYPE_HIGH_TRUE_EDGE_SENSITIVE   0x01   ///< Edge triggered interrupt on a rising edge\r
#define EFI_ISA_ACPI_IRQ_TYPE_LOW_TRUE_EDGE_SENSITIVE    0x02   ///< Edge triggered interrupt on a falling edge\r
#define EFI_ISA_ACPI_IRQ_TYPE_HIGH_TRUE_LEVEL_SENSITIVE  0x04   ///< Level sensitive interrupt active high\r
#define EFI_ISA_ACPI_IRQ_TYPE_LOW_TRUE_LEVEL_SENSITIVE   0x08   ///< Level sensitive interrupt active low\r
\r
///\r
/// ISA ACPI Protocol DMA resource attributes\r
///\r
#define EFI_ISA_ACPI_DMA_SPEED_TYPE_MASK                 0x03   ///< Bit mask of supported DMA speed attributes\r
#define EFI_ISA_ACPI_DMA_SPEED_TYPE_COMPATIBILITY        0x00   ///< ISA controller supports compatibility mode DMA transfers\r
#define EFI_ISA_ACPI_DMA_SPEED_TYPE_A                    0x01   ///< ISA controller supports type A DMA transfers \r
#define EFI_ISA_ACPI_DMA_SPEED_TYPE_B                    0x02   ///< ISA controller supports type B DMA transfers\r
#define EFI_ISA_ACPI_DMA_SPEED_TYPE_F                    0x03   ///< ISA controller supports type F DMA transfers\r
#define EFI_ISA_ACPI_DMA_COUNT_BY_BYTE                   0x04   ///< ISA controller increments DMA address by bytes (8-bit)\r
#define EFI_ISA_ACPI_DMA_COUNT_BY_WORD                   0x08   ///< ISA controller increments DMA address by words (16-bit)\r
#define EFI_ISA_ACPI_DMA_BUS_MASTER                      0x10   ///< ISA controller is a DMA bus master\r
#define EFI_ISA_ACPI_DMA_TRANSFER_TYPE_8_BIT             0x20   ///< ISA controller only supports 8-bit DMA transfers\r
#define EFI_ISA_ACPI_DMA_TRANSFER_TYPE_8_BIT_AND_16_BIT  0x40   ///< ISA controller both 8-bit and 16-bit DMA transfers\r
#define EFI_ISA_ACPI_DMA_TRANSFER_TYPE_16_BIT            0x80   ///< ISA controller only supports 16-bit DMA transfers\r
\r
///\r
/// ISA ACPI Protocol MMIO resource attributes\r
///\r
#define EFI_ISA_ACPI_MEMORY_WIDTH_MASK                   0x03   ///< Bit mask of supported ISA memory width attributes\r
#define EFI_ISA_ACPI_MEMORY_WIDTH_8_BIT                  0x00   ///< ISA MMIO region only supports 8-bit access\r
#define EFI_ISA_ACPI_MEMORY_WIDTH_16_BIT                 0x01   ///< ISA MMIO region only supports 16-bit access\r
#define EFI_ISA_ACPI_MEMORY_WIDTH_8_BIT_AND_16_BIT       0x02   ///< ISA MMIO region supports both 8-bit and 16-bit access \r
#define EFI_ISA_ACPI_MEMORY_WRITEABLE                    0x04   ///< ISA MMIO region supports write transactions\r
#define EFI_ISA_ACPI_MEMORY_CACHEABLE                    0x08   ///< ISA MMIO region supports being cached\r
#define EFI_ISA_ACPI_MEMORY_SHADOWABLE                   0x10   ///< ISA MMIO region may be shadowed\r
#define EFI_ISA_ACPI_MEMORY_EXPANSION_ROM                0x20   ///< ISA MMIO region is an expansion ROM\r
\r
///\r
/// ISA ACPI Protocol I/O resource attributes\r
///\r
#define EFI_ISA_ACPI_IO_DECODE_10_BITS                   0x01    ///< ISA controllers uses a 10-bit address decoder for I/O cycles\r
#define EFI_ISA_ACPI_IO_DECODE_16_BITS                   0x02    ///< ISA controllers uses a 16-bit address decoder for I/O cycles\r
\r
///\r
/// EFI ISA ACPI resource type \r
///\r
typedef enum {\r
  EfiIsaAcpiResourceEndOfList,    ///< Marks the end if a resource list\r
  EfiIsaAcpiResourceIo,           ///< ISA I/O port resource range\r
  EfiIsaAcpiResourceMemory,       ///< ISA MMIO resource range \r
  EfiIsaAcpiResourceDma,          ///< ISA DMA resource \r
  EfiIsaAcpiResourceInterrupt     ///< ISA interrupt resource\r
} EFI_ISA_ACPI_RESOURCE_TYPE;\r
\r
///\r
/// EFI ISA ACPI generic resource structure\r
///\r
typedef struct {\r
  EFI_ISA_ACPI_RESOURCE_TYPE  Type;         ///< The type of resource (I/O, MMIO, DMA, Interrupt)\r
  UINT32                      Attribute;    ///< Bit mask of attributes associated with this resource.  See EFI_ISA_ACPI_xxx macros for valid combinations.\r
  UINT32                      StartRange;   ///< The start of the resource range\r
  UINT32                      EndRange;     ///< The end of the resource range\r
} EFI_ISA_ACPI_RESOURCE;\r
\r
///\r
/// EFI ISA ACPI resource device identifier\r
///\r
typedef struct {\r
  UINT32  HID;   ///< The ACPI Hardware Identifier value associated with an ISA controller.  Matchs ACPI DSDT contents.\r
  UINT32  UID;   ///< The ACPI Unique Identifier value associated with an ISA controller.  Matches ACPI DSDT contents.\r
} EFI_ISA_ACPI_DEVICE_ID;\r
\r
///\r
/// EFI ISA ACPI resource list\r
///\r
typedef struct {\r
  EFI_ISA_ACPI_DEVICE_ID  Device;          ///< The ACPI HID/UID associated with an ISA controller\r
  EFI_ISA_ACPI_RESOURCE   *ResourceItem;   ///< Pointer to the list of resources associated with an ISA controller\r
} EFI_ISA_ACPI_RESOURCE_LIST;\r
\r
/**\r
  Enumerates the ISA controllers on an ISA bus.\r
\r
  This service allows all the ISA controllers on an ISA bus to be enumerated.  If\r
  Device is a pointer to a NULL value, then the first ISA controller on the ISA\r
  bus is returned in Device and EFI_SUCCESS is returned.  If Device is a pointer \r
  to a value that was returned on a prior call to DeviceEnumerate(), then the next \r
  ISA controller on the ISA bus is returned in Device and EFI_SUCCESS is returned.\r
  If Device is a pointer to the last ISA controller on the ISA bus, then \r
  EFI_NOT_FOUND is returned.\r
\r
  @param[in]  This     Pointer to the EFI_ISA_ACPI_PROTOCOL instance.\r
  @param[out] Device   Pointer to an ISA controller named by ACPI HID/UID.\r
\r
  @retval EFI_SUCCESS    The next ISA controller on the ISA bus was returned.\r
  @retval EFI_NOT_FOUND  No device found.\r
\r
**/\r
typedef\r
EFI_STATUS\r
(EFIAPI *EFI_ISA_ACPI_DEVICE_ENUMERATE)(\r
  IN  EFI_ISA_ACPI_PROTOCOL   *This,\r
  OUT EFI_ISA_ACPI_DEVICE_ID  **Device\r
  );\r
\r
/**\r
  Sets the power state of an ISA controller.\r
\r
  This services sets the power state of the ISA controller specified by Device to \r
  the power state specified by OnOff.  TRUE denotes on, FALSE denotes off. \r
  If the power state is sucessfully set on the ISA Controller, then\r
  EFI_SUCCESS is returned.\r
\r
  @param[in] This     Pointer to the EFI_ISA_ACPI_PROTOCOL instance.\r
  @param[in] Device   Pointer to an ISA controller named by ACPI HID/UID.\r
  @param[in] OnOff    TRUE denotes on, FALSE denotes off.\r
\r
  @retval EFI_SUCCESS   Successfully set the power state of the ISA controller.\r
  @retval Other         The ISA controller cound not be placed in the requested power state.\r
\r
**/\r
typedef\r
EFI_STATUS\r
(EFIAPI *EFI_ISA_ACPI_SET_DEVICE_POWER)(\r
  IN EFI_ISA_ACPI_PROTOCOL   *This,\r
  IN EFI_ISA_ACPI_DEVICE_ID  *Device,\r
  IN BOOLEAN                 OnOff\r
  );\r
  \r
/**\r
  Retrieves the current set of resources associated with an ISA controller.\r
\r
  Retrieves the set of I/O, MMIO, DMA, and interrupt resources currently \r
  assigned to the ISA controller specified by Device.  These resources\r
  are returned in ResourceList.\r
\r
  @param[in]  This          Pointer to the EFI_ISA_ACPI_PROTOCOL instance.\r
  @param[in]  Device        Pointer to an ISA controller named by ACPI HID/UID.\r
  @param[out] ResourceList  Pointer to the current resource list for Device.\r
\r
  @retval EFI_SUCCESS    Successfully retrieved the current resource list.\r
  @retval EFI_NOT_FOUND  The resource list could not be retrieved.\r
\r
**/\r
typedef\r
EFI_STATUS\r
(EFIAPI *EFI_ISA_ACPI_GET_CUR_RESOURCE)(\r
  IN  EFI_ISA_ACPI_PROTOCOL       *This,\r
  IN  EFI_ISA_ACPI_DEVICE_ID      *Device,\r
  OUT EFI_ISA_ACPI_RESOURCE_LIST  **ResourceList\r
  );\r
\r
/**\r
  Retrieves the set of possible resources that may be assigned to an ISA controller\r
  with SetResource().\r
\r
  Retrieves the possible sets of I/O, MMIO, DMA, and interrupt resources for the\r
  ISA controller specified by Device.  The sets are returned in ResourceList.\r
\r
  @param[in]  This           Pointer to the EFI_ISA_ACPI_PROTOCOL instance.\r
  @param[in]  Device         Pointer to an ISA controller named by ACPI HID/UID.\r
  @param[out] ResourceList   Pointer to the returned list of resource lists.\r
\r
  @retval EFI_UNSUPPORTED  This service is not supported.\r
\r
**/\r
typedef\r
EFI_STATUS\r
(EFIAPI *EFI_ISA_ACPI_GET_POS_RESOURCE)(\r
  IN EFI_ISA_ACPI_PROTOCOL        *This,\r
  IN EFI_ISA_ACPI_DEVICE_ID       *Device,\r
  OUT EFI_ISA_ACPI_RESOURCE_LIST  **ResourceList\r
  );\r
\r
/**\r
  Assigns resources to an ISA controller.\r
\r
  Assigns the I/O, MMIO, DMA, and interrupt resources specified by ResourceList\r
  to the ISA controller specified by Device.  ResourceList must match a resource list returned by GetPosResource() for the same ISA controller.\r
\r
  @param[in] This           Pointer to the EFI_ISA_ACPI_PROTOCOL instance.\r
  @param[in] Device         Pointer to an ISA controller named by ACPI HID/UID.\r
  @param[in] ResourceList   Pointer to a resources list that must be one of the \r
                            resource lists returned by GetPosResource() for the\r
                            ISA controller specified by Device.\r
\r
  @retval EFI_SUCCESS  Successfully set resources on the ISA controller.\r
  @retval Other        The resources could not be set for the ISA controller.\r
\r
**/\r
typedef\r
EFI_STATUS\r
(EFIAPI *EFI_ISA_ACPI_SET_RESOURCE)(\r
  IN EFI_ISA_ACPI_PROTOCOL       *This,\r
  IN EFI_ISA_ACPI_DEVICE_ID      *Device,\r
  IN EFI_ISA_ACPI_RESOURCE_LIST  *ResourceList\r
  );    \r
\r
/**\r
  Enables or disables an ISA controller.\r
\r
  @param[in] This     Pointer to the EFI_ISA_ACPI_PROTOCOL instance.\r
  @param[in] Device   Pointer to the ISA controller to enable/disable.\r
  @param[in] Enable   TRUE to enable the ISA controller.  FALSE to disable the\r
                      ISA controller.\r
\r
  @retval EFI_SUCCESS   Successfully enabled/disabled the ISA controller.\r
  @retval Other         The ISA controller cound not be placed in the requested state.\r
\r
**/\r
typedef\r
EFI_STATUS\r
(EFIAPI *EFI_ISA_ACPI_ENABLE_DEVICE)(\r
  IN EFI_ISA_ACPI_PROTOCOL   *This,\r
  IN EFI_ISA_ACPI_DEVICE_ID  *Device,\r
  IN BOOLEAN                 Enable\r
  );    \r
\r
/**\r
  Initializes an ISA controller, so that it can be used.  This service must be called\r
  before SetResource(), EnableDevice(), or SetPower() will behave as expected.\r
\r
  @param[in] This     Pointer to the EFI_ISA_ACPI_PROTOCOL instance.\r
  @param[in] Device   Pointer to an ISA controller named by ACPI HID/UID.\r
\r
  @retval EFI_SUCCESS   Successfully initialized an ISA controller.\r
  @retval Other         The ISA controller could not be initialized.\r
\r
**/\r
typedef\r
EFI_STATUS\r
(EFIAPI *EFI_ISA_ACPI_INIT_DEVICE)(\r
  IN EFI_ISA_ACPI_PROTOCOL   *This,\r
  IN EFI_ISA_ACPI_DEVICE_ID  *Device\r
  );  \r
\r
/**\r
  Initializes all the HW states required for the ISA controllers on the ISA bus \r
  to be enumerated and managed by the rest of the services in this prorotol.\r
  This service must be called before any of the other services in this\r
  protocol will function as expected.\r
 \r
  @param[in] This  Pointer to the EFI_ISA_ACPI_PROTOCOL instance.\r
\r
  @retval EFI_SUCCESS   Successfully initialized all required hardware states.\r
  @retval Other         The ISA interface could not be initialized.\r
\r
**/\r
typedef\r
EFI_STATUS\r
(EFIAPI *EFI_ISA_ACPI_INTERFACE_INIT)(\r
  IN EFI_ISA_ACPI_PROTOCOL  *This\r
  );\r
\r
///\r
/// The EFI_ISA_ACPI_PROTOCOL provides the services to enumerate and manage\r
/// ISA controllers on an ISA bus.  These services include the ability to initialize, \r
/// enable, disable, and manage the power state of ISA controllers.  It also \r
/// includes services to query current resources, query possible resources, \r
/// and assign resources to an ISA controller.\r
///\r
struct _EFI_ISA_ACPI_PROTOCOL {\r
  EFI_ISA_ACPI_DEVICE_ENUMERATE  DeviceEnumerate;\r
  EFI_ISA_ACPI_SET_DEVICE_POWER  SetPower;\r
  EFI_ISA_ACPI_GET_CUR_RESOURCE  GetCurResource;\r
  EFI_ISA_ACPI_GET_POS_RESOURCE  GetPosResource;\r
  EFI_ISA_ACPI_SET_RESOURCE      SetResource;\r
  EFI_ISA_ACPI_ENABLE_DEVICE     EnableDevice;\r
  EFI_ISA_ACPI_INIT_DEVICE       InitDevice;\r
  EFI_ISA_ACPI_INTERFACE_INIT    InterfaceInit;\r
};\r
\r
extern EFI_GUID gEfiIsaAcpiProtocolGuid;\r
  \r
#endif\r
Commit	Line	Data
	1	/** @file\r
	2	EFI ISA ACPI Protocol is used to enumerate and manage all the ISA controllers on\r
	3	the platform's ISA Bus.\r
	4	\r
	5	Copyright (c) 2006 - 2009, Intel Corporation\r
	6	All rights reserved. This program and the accompanying materials\r
	7	are licensed and made available under the terms and conditions of the BSD License\r
	8	which accompanies this distribution. The full text of the license may be found at\r
	9	http://opensource.org/licenses/bsd-license.php\r
	10	\r
	11	THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
	12	WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
	13	\r
	14	**/\r
	15	\r
	16	#ifndef __ISA_ACPI_H_\r
	17	#define __ISA_ACPI_H_\r
	18	\r
	19	///\r
	20	/// Global ID for the EFI ISA ACPI Protocol\r
	21	///\r
	22	#define EFI_ISA_ACPI_PROTOCOL_GUID \\r
	23	{ \\r
	24	0x64a892dc, 0x5561, 0x4536, { 0x92, 0xc7, 0x79, 0x9b, 0xfc, 0x18, 0x33, 0x55 } \\r
	25	}\r
	26	\r
	27	///\r
	28	/// Forward declaration fo the EFI ISA ACPI Protocol\r
	29	///\r
	30	typedef struct _EFI_ISA_ACPI_PROTOCOL EFI_ISA_ACPI_PROTOCOL;\r
	31	\r
	32	///\r
	33	/// ISA ACPI Protocol interrupt resource attributes\r
	34	///\r
	35	#define EFI_ISA_ACPI_IRQ_TYPE_HIGH_TRUE_EDGE_SENSITIVE 0x01 ///< Edge triggered interrupt on a rising edge\r
	36	#define EFI_ISA_ACPI_IRQ_TYPE_LOW_TRUE_EDGE_SENSITIVE 0x02 ///< Edge triggered interrupt on a falling edge\r
	37	#define EFI_ISA_ACPI_IRQ_TYPE_HIGH_TRUE_LEVEL_SENSITIVE 0x04 ///< Level sensitive interrupt active high\r
	38	#define EFI_ISA_ACPI_IRQ_TYPE_LOW_TRUE_LEVEL_SENSITIVE 0x08 ///< Level sensitive interrupt active low\r
	39	\r
	40	///\r
	41	/// ISA ACPI Protocol DMA resource attributes\r
	42	///\r
	43	#define EFI_ISA_ACPI_DMA_SPEED_TYPE_MASK 0x03 ///< Bit mask of supported DMA speed attributes\r
	44	#define EFI_ISA_ACPI_DMA_SPEED_TYPE_COMPATIBILITY 0x00 ///< ISA controller supports compatibility mode DMA transfers\r
	45	#define EFI_ISA_ACPI_DMA_SPEED_TYPE_A 0x01 ///< ISA controller supports type A DMA transfers \r
	46	#define EFI_ISA_ACPI_DMA_SPEED_TYPE_B 0x02 ///< ISA controller supports type B DMA transfers\r
	47	#define EFI_ISA_ACPI_DMA_SPEED_TYPE_F 0x03 ///< ISA controller supports type F DMA transfers\r
	48	#define EFI_ISA_ACPI_DMA_COUNT_BY_BYTE 0x04 ///< ISA controller increments DMA address by bytes (8-bit)\r
	49	#define EFI_ISA_ACPI_DMA_COUNT_BY_WORD 0x08 ///< ISA controller increments DMA address by words (16-bit)\r
	50	#define EFI_ISA_ACPI_DMA_BUS_MASTER 0x10 ///< ISA controller is a DMA bus master\r
	51	#define EFI_ISA_ACPI_DMA_TRANSFER_TYPE_8_BIT 0x20 ///< ISA controller only supports 8-bit DMA transfers\r
	52	#define EFI_ISA_ACPI_DMA_TRANSFER_TYPE_8_BIT_AND_16_BIT 0x40 ///< ISA controller both 8-bit and 16-bit DMA transfers\r
	53	#define EFI_ISA_ACPI_DMA_TRANSFER_TYPE_16_BIT 0x80 ///< ISA controller only supports 16-bit DMA transfers\r
	54	\r
	55	///\r
	56	/// ISA ACPI Protocol MMIO resource attributes\r
	57	///\r
	58	#define EFI_ISA_ACPI_MEMORY_WIDTH_MASK 0x03 ///< Bit mask of supported ISA memory width attributes\r
	59	#define EFI_ISA_ACPI_MEMORY_WIDTH_8_BIT 0x00 ///< ISA MMIO region only supports 8-bit access\r
	60	#define EFI_ISA_ACPI_MEMORY_WIDTH_16_BIT 0x01 ///< ISA MMIO region only supports 16-bit access\r
	61	#define EFI_ISA_ACPI_MEMORY_WIDTH_8_BIT_AND_16_BIT 0x02 ///< ISA MMIO region supports both 8-bit and 16-bit access \r
	62	#define EFI_ISA_ACPI_MEMORY_WRITEABLE 0x04 ///< ISA MMIO region supports write transactions\r
	63	#define EFI_ISA_ACPI_MEMORY_CACHEABLE 0x08 ///< ISA MMIO region supports being cached\r
	64	#define EFI_ISA_ACPI_MEMORY_SHADOWABLE 0x10 ///< ISA MMIO region may be shadowed\r
	65	#define EFI_ISA_ACPI_MEMORY_EXPANSION_ROM 0x20 ///< ISA MMIO region is an expansion ROM\r
	66	\r
	67	///\r
	68	/// ISA ACPI Protocol I/O resource attributes\r
	69	///\r
	70	#define EFI_ISA_ACPI_IO_DECODE_10_BITS 0x01 ///< ISA controllers uses a 10-bit address decoder for I/O cycles\r
	71	#define EFI_ISA_ACPI_IO_DECODE_16_BITS 0x02 ///< ISA controllers uses a 16-bit address decoder for I/O cycles\r
	72	\r
	73	///\r
	74	/// EFI ISA ACPI resource type \r
	75	///\r
	76	typedef enum {\r
	77	EfiIsaAcpiResourceEndOfList, ///< Marks the end if a resource list\r
	78	EfiIsaAcpiResourceIo, ///< ISA I/O port resource range\r
	79	EfiIsaAcpiResourceMemory, ///< ISA MMIO resource range \r
	80	EfiIsaAcpiResourceDma, ///< ISA DMA resource \r
	81	EfiIsaAcpiResourceInterrupt ///< ISA interrupt resource\r
	82	} EFI_ISA_ACPI_RESOURCE_TYPE;\r
	83	\r
	84	///\r
	85	/// EFI ISA ACPI generic resource structure\r
	86	///\r
	87	typedef struct {\r
	88	EFI_ISA_ACPI_RESOURCE_TYPE Type; ///< The type of resource (I/O, MMIO, DMA, Interrupt)\r
	89	UINT32 Attribute; ///< Bit mask of attributes associated with this resource. See EFI_ISA_ACPI_xxx macros for valid combinations.\r
	90	UINT32 StartRange; ///< The start of the resource range\r
	91	UINT32 EndRange; ///< The end of the resource range\r
	92	} EFI_ISA_ACPI_RESOURCE;\r
	93	\r
	94	///\r
	95	/// EFI ISA ACPI resource device identifier\r
	96	///\r
	97	typedef struct {\r
	98	UINT32 HID; ///< The ACPI Hardware Identifier value associated with an ISA controller. Matchs ACPI DSDT contents.\r
	99	UINT32 UID; ///< The ACPI Unique Identifier value associated with an ISA controller. Matches ACPI DSDT contents.\r
	100	} EFI_ISA_ACPI_DEVICE_ID;\r
	101	\r
	102	///\r
	103	/// EFI ISA ACPI resource list\r
	104	///\r
	105	typedef struct {\r
	106	EFI_ISA_ACPI_DEVICE_ID Device; ///< The ACPI HID/UID associated with an ISA controller\r
	107	EFI_ISA_ACPI_RESOURCE *ResourceItem; ///< Pointer to the list of resources associated with an ISA controller\r
	108	} EFI_ISA_ACPI_RESOURCE_LIST;\r
	109	\r
	110	/**\r
	111	Enumerates the ISA controllers on an ISA bus.\r
	112	\r
	113	This service allows all the ISA controllers on an ISA bus to be enumerated. If\r
	114	Device is a pointer to a NULL value, then the first ISA controller on the ISA\r
	115	bus is returned in Device and EFI_SUCCESS is returned. If Device is a pointer \r
	116	to a value that was returned on a prior call to DeviceEnumerate(), then the next \r
	117	ISA controller on the ISA bus is returned in Device and EFI_SUCCESS is returned.\r
	118	If Device is a pointer to the last ISA controller on the ISA bus, then \r
	119	EFI_NOT_FOUND is returned.\r
	120	\r
	121	@param[in] This Pointer to the EFI_ISA_ACPI_PROTOCOL instance.\r
	122	@param[out] Device Pointer to an ISA controller named by ACPI HID/UID.\r
	123	\r
	124	@retval EFI_SUCCESS The next ISA controller on the ISA bus was returned.\r
	125	@retval EFI_NOT_FOUND No device found.\r
	126	\r
	127	**/\r
	128	typedef\r
	129	EFI_STATUS\r
	130	(EFIAPI *EFI_ISA_ACPI_DEVICE_ENUMERATE)(\r
	131	IN EFI_ISA_ACPI_PROTOCOL *This,\r
	132	OUT EFI_ISA_ACPI_DEVICE_ID **Device\r
	133	);\r
	134	\r
	135	/**\r
	136	Sets the power state of an ISA controller.\r
	137	\r
	138	This services sets the power state of the ISA controller specified by Device to \r
	139	the power state specified by OnOff. TRUE denotes on, FALSE denotes off. \r
	140	If the power state is sucessfully set on the ISA Controller, then\r
	141	EFI_SUCCESS is returned.\r
	142	\r
	143	@param[in] This Pointer to the EFI_ISA_ACPI_PROTOCOL instance.\r
	144	@param[in] Device Pointer to an ISA controller named by ACPI HID/UID.\r
	145	@param[in] OnOff TRUE denotes on, FALSE denotes off.\r
	146	\r
	147	@retval EFI_SUCCESS Successfully set the power state of the ISA controller.\r
	148	@retval Other The ISA controller cound not be placed in the requested power state.\r
	149	\r
	150	**/\r
	151	typedef\r
	152	EFI_STATUS\r
	153	(EFIAPI *EFI_ISA_ACPI_SET_DEVICE_POWER)(\r
	154	IN EFI_ISA_ACPI_PROTOCOL *This,\r
	155	IN EFI_ISA_ACPI_DEVICE_ID *Device,\r
	156	IN BOOLEAN OnOff\r
	157	);\r
	158	\r
	159	/**\r
	160	Retrieves the current set of resources associated with an ISA controller.\r
	161	\r
	162	Retrieves the set of I/O, MMIO, DMA, and interrupt resources currently \r
	163	assigned to the ISA controller specified by Device. These resources\r
	164	are returned in ResourceList.\r
	165	\r
	166	@param[in] This Pointer to the EFI_ISA_ACPI_PROTOCOL instance.\r
	167	@param[in] Device Pointer to an ISA controller named by ACPI HID/UID.\r
	168	@param[out] ResourceList Pointer to the current resource list for Device.\r
	169	\r
	170	@retval EFI_SUCCESS Successfully retrieved the current resource list.\r
	171	@retval EFI_NOT_FOUND The resource list could not be retrieved.\r
	172	\r
	173	**/\r
	174	typedef\r
	175	EFI_STATUS\r
	176	(EFIAPI *EFI_ISA_ACPI_GET_CUR_RESOURCE)(\r
	177	IN EFI_ISA_ACPI_PROTOCOL *This,\r
	178	IN EFI_ISA_ACPI_DEVICE_ID *Device,\r
	179	OUT EFI_ISA_ACPI_RESOURCE_LIST **ResourceList\r
	180	);\r
	181	\r
	182	/**\r
	183	Retrieves the set of possible resources that may be assigned to an ISA controller\r
	184	with SetResource().\r
	185	\r
	186	Retrieves the possible sets of I/O, MMIO, DMA, and interrupt resources for the\r
	187	ISA controller specified by Device. The sets are returned in ResourceList.\r
	188	\r
	189	@param[in] This Pointer to the EFI_ISA_ACPI_PROTOCOL instance.\r
	190	@param[in] Device Pointer to an ISA controller named by ACPI HID/UID.\r
	191	@param[out] ResourceList Pointer to the returned list of resource lists.\r
	192	\r
	193	@retval EFI_UNSUPPORTED This service is not supported.\r
	194	\r
	195	**/\r
	196	typedef\r
	197	EFI_STATUS\r
	198	(EFIAPI *EFI_ISA_ACPI_GET_POS_RESOURCE)(\r
	199	IN EFI_ISA_ACPI_PROTOCOL *This,\r
	200	IN EFI_ISA_ACPI_DEVICE_ID *Device,\r
	201	OUT EFI_ISA_ACPI_RESOURCE_LIST **ResourceList\r
	202	);\r
	203	\r
	204	/**\r
	205	Assigns resources to an ISA controller.\r
	206	\r
	207	Assigns the I/O, MMIO, DMA, and interrupt resources specified by ResourceList\r
	208	to the ISA controller specified by Device. ResourceList must match a resource list returned by GetPosResource() for the same ISA controller.\r
	209	\r
	210	@param[in] This Pointer to the EFI_ISA_ACPI_PROTOCOL instance.\r
	211	@param[in] Device Pointer to an ISA controller named by ACPI HID/UID.\r
	212	@param[in] ResourceList Pointer to a resources list that must be one of the \r
	213	resource lists returned by GetPosResource() for the\r
	214	ISA controller specified by Device.\r
	215	\r
	216	@retval EFI_SUCCESS Successfully set resources on the ISA controller.\r
	217	@retval Other The resources could not be set for the ISA controller.\r
	218	\r
	219	**/\r
	220	typedef\r
	221	EFI_STATUS\r
	222	(EFIAPI *EFI_ISA_ACPI_SET_RESOURCE)(\r
	223	IN EFI_ISA_ACPI_PROTOCOL *This,\r
	224	IN EFI_ISA_ACPI_DEVICE_ID *Device,\r
	225	IN EFI_ISA_ACPI_RESOURCE_LIST *ResourceList\r
	226	); \r
	227	\r
	228	/**\r
	229	Enables or disables an ISA controller.\r
	230	\r
	231	@param[in] This Pointer to the EFI_ISA_ACPI_PROTOCOL instance.\r
	232	@param[in] Device Pointer to the ISA controller to enable/disable.\r
	233	@param[in] Enable TRUE to enable the ISA controller. FALSE to disable the\r
	234	ISA controller.\r
	235	\r
	236	@retval EFI_SUCCESS Successfully enabled/disabled the ISA controller.\r
	237	@retval Other The ISA controller cound not be placed in the requested state.\r
	238	\r
	239	**/\r
	240	typedef\r
	241	EFI_STATUS\r
	242	(EFIAPI *EFI_ISA_ACPI_ENABLE_DEVICE)(\r
	243	IN EFI_ISA_ACPI_PROTOCOL *This,\r
	244	IN EFI_ISA_ACPI_DEVICE_ID *Device,\r
	245	IN BOOLEAN Enable\r
	246	); \r
	247	\r
	248	/**\r
	249	Initializes an ISA controller, so that it can be used. This service must be called\r
	250	before SetResource(), EnableDevice(), or SetPower() will behave as expected.\r
	251	\r
	252	@param[in] This Pointer to the EFI_ISA_ACPI_PROTOCOL instance.\r
	253	@param[in] Device Pointer to an ISA controller named by ACPI HID/UID.\r
	254	\r
	255	@retval EFI_SUCCESS Successfully initialized an ISA controller.\r
	256	@retval Other The ISA controller could not be initialized.\r
	257	\r
	258	**/\r
	259	typedef\r
	260	EFI_STATUS\r
	261	(EFIAPI *EFI_ISA_ACPI_INIT_DEVICE)(\r
	262	IN EFI_ISA_ACPI_PROTOCOL *This,\r
	263	IN EFI_ISA_ACPI_DEVICE_ID *Device\r
	264	); \r
	265	\r
	266	/**\r
	267	Initializes all the HW states required for the ISA controllers on the ISA bus \r
	268	to be enumerated and managed by the rest of the services in this prorotol.\r
	269	This service must be called before any of the other services in this\r
	270	protocol will function as expected.\r
	271	\r
	272	@param[in] This Pointer to the EFI_ISA_ACPI_PROTOCOL instance.\r
	273	\r
	274	@retval EFI_SUCCESS Successfully initialized all required hardware states.\r
	275	@retval Other The ISA interface could not be initialized.\r
	276	\r
	277	**/\r
	278	typedef\r
	279	EFI_STATUS\r
	280	(EFIAPI *EFI_ISA_ACPI_INTERFACE_INIT)(\r
	281	IN EFI_ISA_ACPI_PROTOCOL *This\r
	282	);\r
	283	\r
	284	///\r
	285	/// The EFI_ISA_ACPI_PROTOCOL provides the services to enumerate and manage\r
	286	/// ISA controllers on an ISA bus. These services include the ability to initialize, \r
	287	/// enable, disable, and manage the power state of ISA controllers. It also \r
	288	/// includes services to query current resources, query possible resources, \r
	289	/// and assign resources to an ISA controller.\r
	290	///\r
	291	struct _EFI_ISA_ACPI_PROTOCOL {\r
	292	EFI_ISA_ACPI_DEVICE_ENUMERATE DeviceEnumerate;\r
	293	EFI_ISA_ACPI_SET_DEVICE_POWER SetPower;\r
	294	EFI_ISA_ACPI_GET_CUR_RESOURCE GetCurResource;\r
	295	EFI_ISA_ACPI_GET_POS_RESOURCE GetPosResource;\r
	296	EFI_ISA_ACPI_SET_RESOURCE SetResource;\r
	297	EFI_ISA_ACPI_ENABLE_DEVICE EnableDevice;\r
	298	EFI_ISA_ACPI_INIT_DEVICE InitDevice;\r
	299	EFI_ISA_ACPI_INTERFACE_INIT InterfaceInit;\r
	300	};\r
	301	\r
	302	extern EFI_GUID gEfiIsaAcpiProtocolGuid;\r
	303	\r
	304	#endif\r