[mirror_edk2.git] / IntelFrameworkModulePkg / Bus / Isa / IsaBusDxe / IsaBus.msa

<?xml version="1.0" encoding="UTF-8"?>\r
<ModuleSurfaceArea xsi:schemaLocation="http://www.TianoCore.org/2006/Edk2.0  http://www.TianoCore.org/2006/Edk2.0/SurfaceArea.xsd" xmlns="http://www.TianoCore.org/2006/Edk2.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">\r
  <MsaHeader>\r
    <ModuleName>IsaBus</ModuleName>\r
    <ModuleType>DXE_DRIVER</ModuleType>\r
    <GuidValue>240612B5-A063-11d4-9A3A-0090273FC14D</GuidValue>\r
    <Version>1.0</Version>\r
    <Abstract>Component description file for IsaBus module.</Abstract>\r
    <Description>Discovers all the ISA Controllers and their resources by using the ISA PnP
      Protocol, produces an instance of the ISA I/O Protocol for every ISA
      Controller found, loads and initializes all ISA Device Drivers, matches ISA
      Device Drivers with their respective ISA Controllers in a deterministic
      manner, and informs a ISA Device Driver when it is to start managing an ISA
      Controller.</Description>\r
    <Copyright>Copyright (c) 2006 - 2007, Intel Corporation.</Copyright>\r
    <License>All rights reserved.
      This software and associated documentation (if any) is furnished
      under a license and may only be used or copied in accordance
      with the terms of the license. Except as permitted by such
      license, no part of this software or documentation may be
      reproduced, stored in a retrieval system, or transmitted in any
      form or by any means without the express written consent of
      Intel Corporation.</License>\r
    <Specification>FRAMEWORK_BUILD_PACKAGING_SPECIFICATION   0x00000052</Specification>\r
  </MsaHeader>\r
  <ModuleDefinitions>\r
    <SupportedArchitectures>IA32 X64 IPF EBC</SupportedArchitectures>\r
    <BinaryModule>false</BinaryModule>\r
    <OutputFileBasename>IsaBus</OutputFileBasename>\r
  </ModuleDefinitions>\r
  <LibraryClassDefinitions>\r
    <LibraryClass Usage="ALWAYS_CONSUMED">\r
      <Keyword>DebugLib</Keyword>\r
    </LibraryClass>\r
    <LibraryClass Usage="ALWAYS_CONSUMED">\r
      <Keyword>UefiDriverModelLib</Keyword>\r
    </LibraryClass>\r
    <LibraryClass Usage="ALWAYS_CONSUMED">\r
      <Keyword>UefiDriverEntryPoint</Keyword>\r
    </LibraryClass>\r
    <LibraryClass Usage="ALWAYS_CONSUMED">\r
      <Keyword>UefiLib</Keyword>\r
    </LibraryClass>\r
    <LibraryClass Usage="ALWAYS_CONSUMED">\r
      <Keyword>DevicePathLib</Keyword>\r
    </LibraryClass>\r
    <LibraryClass Usage="ALWAYS_CONSUMED">\r
      <Keyword>BaseMemoryLib</Keyword>\r
    </LibraryClass>\r
    <LibraryClass Usage="ALWAYS_CONSUMED">\r
      <Keyword>MemoryAllocationLib</Keyword>\r
    </LibraryClass>\r
    <LibraryClass Usage="ALWAYS_CONSUMED">\r
      <Keyword>UefiBootServicesTableLib</Keyword>\r
    </LibraryClass>\r
    <LibraryClass Usage="ALWAYS_CONSUMED">\r
      <Keyword>ReportStatusCodeLib</Keyword>\r
    </LibraryClass>\r
    <LibraryClass Usage="ALWAYS_CONSUMED">\r
      <Keyword>BootScriptLib</Keyword>\r
    </LibraryClass>\r
    <LibraryClass Usage="ALWAYS_CONSUMED">\r
      <Keyword>PcdLib</Keyword>\r
    </LibraryClass>\r
  </LibraryClassDefinitions>\r
  <SourceFiles>\r
    <Filename>ComponentName.h</Filename>\r
    <Filename>IsaAcpi.h</Filename>\r
    <Filename>IsaBus.h</Filename>\r
    <Filename>IsaIo.h</Filename>\r
    <Filename>IsaBus.c</Filename>\r
    <Filename>IsaIo.c</Filename>\r
    <Filename>ComponentName.c</Filename>\r
  </SourceFiles>\r
  <PackageDependencies>\r
    <Package PackageGuid="5e0e9358-46b6-4ae2-8218-4ab8b9bbdcec"/>\r
    <Package PackageGuid="68169ab0-d41b-4009-9060-292c253ac43d"/>\r
    <Package PackageGuid="bea835f9-fd62-464a-81ff-f3a806360c6b"/>\r
  </PackageDependencies>\r
  <Protocols>\r
    <Protocol Usage="TO_START">\r
      <ProtocolCName>gEfiGenericMemTestProtocolGuid</ProtocolCName>\r
    </Protocol>\r
    <Protocol Usage="TO_START">\r
      <ProtocolCName>gEfiDevicePathProtocolGuid</ProtocolCName>\r
    </Protocol>\r
    <Protocol Usage="TO_START">\r
      <ProtocolCName>gEfiPciIoProtocolGuid</ProtocolCName>\r
    </Protocol>\r
    <Protocol Usage="TO_START">\r
      <ProtocolCName>gEfiIsaAcpiProtocolGuid</ProtocolCName>\r
    </Protocol>\r
    <Protocol Usage="BY_START">\r
      <ProtocolCName>gEfiIsaIoProtocolGuid</ProtocolCName>\r
    </Protocol>\r
  </Protocols>\r
  <Guids>\r
    <GuidCNames Usage="ALWAYS_CONSUMED">\r
      <GuidCName>gEfiStatusCodeSpecificDataGuid</GuidCName>\r
    </GuidCNames>\r
  </Guids>\r
  <Externs>\r
    <Specification>EFI_SPECIFICATION_VERSION 0x00020000</Specification>\r
    <Specification>EDK_RELEASE_VERSION 0x00020000</Specification>\r
    <Extern>\r
      <DriverBinding>gIsaBusControllerDriver</DriverBinding>\r
      <ComponentName>gIsaBusComponentName</ComponentName>\r
    </Extern>\r
  </Externs>\r
  <PcdCoded>\r
    <PcdEntry PcdItemType="FEATURE_FLAG" Usage="ALWAYS_CONSUMED">\r
      <C_Name>PcdIsaBusSupportIsaMemory</C_Name>\r
      <TokenSpaceGuidCName>gEfiGenericPlatformTokenSpaceGuid</TokenSpaceGuidCName>\r
      <DefaultValue>TRUE</DefaultValue>\r
      <HelpText>This feature flag is used to enable the implementation for interface 
      _EFI_ISA_IO_PROTOCOL.Mem.Read, _EFI_ISA_IO_PROTOCOL.Mem.Write and _EFI_ISA_IO_PROTOCOL.CopyMem. 
      If it is unset, these interfaces will return EFI_UNSUPPORTED. When it is disabled, 
      it is will save code size if a platform does not have ISA device with ISA memory.</HelpText>\r
    </PcdEntry>\r
    <PcdEntry PcdItemType="FEATURE_FLAG" Usage="ALWAYS_CONSUMED">\r
      <C_Name>PcdIsaBusSupportDma</C_Name>\r
      <TokenSpaceGuidCName>gEfiGenericPlatformTokenSpaceGuid</TokenSpaceGuidCName>\r
      <DefaultValue>TRUE</DefaultValue>\r
      <HelpText>This feature flag is used to enable the implementation for interface 
      _EFI_ISA_IO_PROTOCOL.AllocateBuffer, _EFI_ISA_IO_PROTOCOL.FreeBuffer, _EFI_ISA_IO_PROTOCOL.Map 
      and _EFI_ISA_IO_PROTOCOL.UnMap. If it is unset, these interfaces will return EFI_UNSUPPORTED. 
      It is useful to save code size if a platform does not have ISA device which did DMA transfer.</HelpText>\r
    </PcdEntry>\r
    <PcdEntry PcdItemType="FEATURE_FLAG" Usage="ALWAYS_CONSUMED">\r
      <C_Name>PcdIsaBusOnlySupportSlaveDma</C_Name>\r
      <TokenSpaceGuidCName>gEfiGenericPlatformTokenSpaceGuid</TokenSpaceGuidCName>\r
      <DefaultValue>FALSE</DefaultValue>\r
      <HelpText>This feature flag is used to enable the implementation for interface 
      _EFI_ISA_IO_PROTOCOL.Map and _EFI_ISA_IO_PROTOCOL.UnMap to only support Slave DMA 
      transfers. In addition, unsetting this feature flag also make AllocateBuffer() and 
      FreeBuffer() to return EFI_UNSUPPORTED. It is useful to save code size if a platform have only 
      ISA device to do slave DMA R/W transfer. This flag is only effective when PcdIsaBusSupportDma 
      is set to TRUE. If PcdIsaBusSupportDma is set to FALSE, Map() and UnMap() will simply 
      return EFI_UNSUPPORTED. Please check description for PcdIsaBusSupportDma for details.</HelpText>\r
    </PcdEntry>\r
  </PcdCoded>\r
</ModuleSurfaceArea>
Commit	Line	Data
c3902377	1	<?xml version="1.0" encoding="UTF-8"?>\r
	2	<ModuleSurfaceArea xsi:schemaLocation="http://www.TianoCore.org/2006/Edk2.0 http://www.TianoCore.org/2006/Edk2.0/SurfaceArea.xsd" xmlns="http://www.TianoCore.org/2006/Edk2.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">\r
	3	<MsaHeader>\r
	4	<ModuleName>IsaBus</ModuleName>\r
	5	<ModuleType>DXE_DRIVER</ModuleType>\r
	6	<GuidValue>240612B5-A063-11d4-9A3A-0090273FC14D</GuidValue>\r
	7	<Version>1.0</Version>\r
	8	<Abstract>Component description file for IsaBus module.</Abstract>\r
	9	<Description>Discovers all the ISA Controllers and their resources by using the ISA PnP
	10	Protocol, produces an instance of the ISA I/O Protocol for every ISA
	11	Controller found, loads and initializes all ISA Device Drivers, matches ISA
	12	Device Drivers with their respective ISA Controllers in a deterministic
	13	manner, and informs a ISA Device Driver when it is to start managing an ISA
	14	Controller.</Description>\r
	15	<Copyright>Copyright (c) 2006 - 2007, Intel Corporation.</Copyright>\r
	16	<License>All rights reserved.
	17	This software and associated documentation (if any) is furnished
	18	under a license and may only be used or copied in accordance
	19	with the terms of the license. Except as permitted by such
	20	license, no part of this software or documentation may be
	21	reproduced, stored in a retrieval system, or transmitted in any
	22	form or by any means without the express written consent of
	23	Intel Corporation.</License>\r
	24	<Specification>FRAMEWORK_BUILD_PACKAGING_SPECIFICATION 0x00000052</Specification>\r
	25	</MsaHeader>\r
	26	<ModuleDefinitions>\r
	27	<SupportedArchitectures>IA32 X64 IPF EBC</SupportedArchitectures>\r
	28	<BinaryModule>false</BinaryModule>\r
	29	<OutputFileBasename>IsaBus</OutputFileBasename>\r
	30	</ModuleDefinitions>\r
	31	<LibraryClassDefinitions>\r
	32	<LibraryClass Usage="ALWAYS_CONSUMED">\r
	33	<Keyword>DebugLib</Keyword>\r
	34	</LibraryClass>\r
	35	<LibraryClass Usage="ALWAYS_CONSUMED">\r
	36	<Keyword>UefiDriverModelLib</Keyword>\r
	37	</LibraryClass>\r
	38	<LibraryClass Usage="ALWAYS_CONSUMED">\r
	39	<Keyword>UefiDriverEntryPoint</Keyword>\r
	40	</LibraryClass>\r
	41	<LibraryClass Usage="ALWAYS_CONSUMED">\r
	42	<Keyword>UefiLib</Keyword>\r
	43	</LibraryClass>\r
	44	<LibraryClass Usage="ALWAYS_CONSUMED">\r
	45	<Keyword>DevicePathLib</Keyword>\r
	46	</LibraryClass>\r
	47	<LibraryClass Usage="ALWAYS_CONSUMED">\r
	48	<Keyword>BaseMemoryLib</Keyword>\r
	49	</LibraryClass>\r
	50	<LibraryClass Usage="ALWAYS_CONSUMED">\r
	51	<Keyword>MemoryAllocationLib</Keyword>\r
	52	</LibraryClass>\r
	53	<LibraryClass Usage="ALWAYS_CONSUMED">\r
	54	<Keyword>UefiBootServicesTableLib</Keyword>\r
	55	</LibraryClass>\r
	56	<LibraryClass Usage="ALWAYS_CONSUMED">\r
	57	<Keyword>ReportStatusCodeLib</Keyword>\r
	58	</LibraryClass>\r
	59	<LibraryClass Usage="ALWAYS_CONSUMED">\r
	60	<Keyword>BootScriptLib</Keyword>\r
	61	</LibraryClass>\r
	62	<LibraryClass Usage="ALWAYS_CONSUMED">\r
	63	<Keyword>PcdLib</Keyword>\r
	64	</LibraryClass>\r
65	</LibraryClassDefinitions>\r
66	<SourceFiles>\r
67	<Filename>ComponentName.h</Filename>\r
68	<Filename>IsaAcpi.h</Filename>\r
69	<Filename>IsaBus.h</Filename>\r
70	<Filename>IsaIo.h</Filename>\r
71	<Filename>IsaBus.c</Filename>\r
72	<Filename>IsaIo.c</Filename>\r
73	<Filename>ComponentName.c</Filename>\r
74	</SourceFiles>\r
75	<PackageDependencies>\r
76	<Package PackageGuid="5e0e9358-46b6-4ae2-8218-4ab8b9bbdcec"/>\r
77	<Package PackageGuid="68169ab0-d41b-4009-9060-292c253ac43d"/>\r
78	<Package PackageGuid="bea835f9-fd62-464a-81ff-f3a806360c6b"/>\r
79	</PackageDependencies>\r
80	<Protocols>\r
81	<Protocol Usage="TO_START">\r
82	<ProtocolCName>gEfiGenericMemTestProtocolGuid</ProtocolCName>\r
83	</Protocol>\r
84	<Protocol Usage="TO_START">\r
85	<ProtocolCName>gEfiDevicePathProtocolGuid</ProtocolCName>\r
86	</Protocol>\r
87	<Protocol Usage="TO_START">\r
88	<ProtocolCName>gEfiPciIoProtocolGuid</ProtocolCName>\r
89	</Protocol>\r
90	<Protocol Usage="TO_START">\r
91	<ProtocolCName>gEfiIsaAcpiProtocolGuid</ProtocolCName>\r
92	</Protocol>\r
93	<Protocol Usage="BY_START">\r
94	<ProtocolCName>gEfiIsaIoProtocolGuid</ProtocolCName>\r
95	</Protocol>\r
96	</Protocols>\r
97	<Guids>\r
98	<GuidCNames Usage="ALWAYS_CONSUMED">\r
99	<GuidCName>gEfiStatusCodeSpecificDataGuid</GuidCName>\r
100	</GuidCNames>\r
101	</Guids>\r
102	<Externs>\r
103	<Specification>EFI_SPECIFICATION_VERSION 0x00020000</Specification>\r
104	<Specification>EDK_RELEASE_VERSION 0x00020000</Specification>\r
105	<Extern>\r
106	<DriverBinding>gIsaBusControllerDriver</DriverBinding>\r
107	<ComponentName>gIsaBusComponentName</ComponentName>\r
108	</Extern>\r
109	</Externs>\r
110	<PcdCoded>\r
111	<PcdEntry PcdItemType="FEATURE_FLAG" Usage="ALWAYS_CONSUMED">\r
112	<C_Name>PcdIsaBusSupportIsaMemory</C_Name>\r
113	<TokenSpaceGuidCName>gEfiGenericPlatformTokenSpaceGuid</TokenSpaceGuidCName>\r
114	<DefaultValue>TRUE</DefaultValue>\r
115	<HelpText>This feature flag is used to enable the implementation for interface
116	_EFI_ISA_IO_PROTOCOL.Mem.Read, _EFI_ISA_IO_PROTOCOL.Mem.Write and _EFI_ISA_IO_PROTOCOL.CopyMem.
117	If it is unset, these interfaces will return EFI_UNSUPPORTED. When it is disabled,
118	it is will save code size if a platform does not have ISA device with ISA memory.</HelpText>\r
119	</PcdEntry>\r
120	<PcdEntry PcdItemType="FEATURE_FLAG" Usage="ALWAYS_CONSUMED">\r
121	<C_Name>PcdIsaBusSupportDma</C_Name>\r
122	<TokenSpaceGuidCName>gEfiGenericPlatformTokenSpaceGuid</TokenSpaceGuidCName>\r
123	<DefaultValue>TRUE</DefaultValue>\r
124	<HelpText>This feature flag is used to enable the implementation for interface
125	_EFI_ISA_IO_PROTOCOL.AllocateBuffer, _EFI_ISA_IO_PROTOCOL.FreeBuffer, _EFI_ISA_IO_PROTOCOL.Map
126	and _EFI_ISA_IO_PROTOCOL.UnMap. If it is unset, these interfaces will return EFI_UNSUPPORTED.
127	It is useful to save code size if a platform does not have ISA device which did DMA transfer.</HelpText>\r
128	</PcdEntry>\r
129	<PcdEntry PcdItemType="FEATURE_FLAG" Usage="ALWAYS_CONSUMED">\r
130	<C_Name>PcdIsaBusOnlySupportSlaveDma</C_Name>\r
131	<TokenSpaceGuidCName>gEfiGenericPlatformTokenSpaceGuid</TokenSpaceGuidCName>\r
132	<DefaultValue>FALSE</DefaultValue>\r
133	<HelpText>This feature flag is used to enable the implementation for interface
134	_EFI_ISA_IO_PROTOCOL.Map and _EFI_ISA_IO_PROTOCOL.UnMap to only support Slave DMA
135	transfers. In addition, unsetting this feature flag also make AllocateBuffer() and
136	FreeBuffer() to return EFI_UNSUPPORTED. It is useful to save code size if a platform have only
137	ISA device to do slave DMA R/W transfer. This flag is only effective when PcdIsaBusSupportDma
138	is set to TRUE. If PcdIsaBusSupportDma is set to FALSE, Map() and UnMap() will simply
139	return EFI_UNSUPPORTED. Please check description for PcdIsaBusSupportDma for details.</HelpText>\r
140	</PcdEntry>\r
141	</PcdCoded>\r
142	</ModuleSurfaceArea>