diff options
Diffstat (limited to 'Core/CSPLib/CspLibGeneric.C')
| -rw-r--r-- | Core/CSPLib/CspLibGeneric.C | 399 |
1 files changed, 399 insertions, 0 deletions
diff --git a/Core/CSPLib/CspLibGeneric.C b/Core/CSPLib/CspLibGeneric.C new file mode 100644 index 0000000..6b96877 --- /dev/null +++ b/Core/CSPLib/CspLibGeneric.C @@ -0,0 +1,399 @@ +//************************************************************************* +//************************************************************************* +//** ** +//** (C)Copyright 1985-2008, American Megatrends, Inc. ** +//** ** +//** All Rights Reserved. ** +//** ** +//** 5555 Oakbrook Parkway, Suite 200, Norcross, GA 30093 ** +//** ** +//** Phone: (770)-246-8600 ** +//** ** +//************************************************************************* +//************************************************************************* + +//********************************************************************** +// +// $Header: /Alaska/BIN/Chipset/Template/CSPLibrary/CspLibGeneric.C 7 11/12/11 6:39p Artems $ +// +// $Revision: 7 $ +// +// $Date: 11/12/11 6:39p $ +// +//***************************************************************************** +// Revision History +// ---------------- +// $Log: /Alaska/BIN/Chipset/Template/CSPLibrary/CspLibGeneric.C $ +// +// 7 11/12/11 6:39p Artems +// Added functions for TopSwap functionality +// +// 6 2/22/11 3:33p Artems +// EIP 51548 - Added AMI copyright headers, replaced TABs with spaces +// +// 5 3/31/10 11:31a Artems +// Updated function help header +// +// 4 3/29/10 3:58p Artems +// Fixed OemRuntimeShadowRamWrite function help header +// +// 3 3/25/10 3:07p Artems +// EIP 33953: Added eLink infrastructure to support runtime shadow ram +// writing +// +// 2 6/11/09 5:43p Robert +// Comment updates for CHM and coding standard +// +// 1 10/13/07 11:27p Michaela +// Initial Checkin +// +// 1 10/05/07 7:02a Michaela +// Initial checkin. +// +//***************************************************************************** + + +//<AMI_FHDR_START> +//---------------------------------------------------------------------------- +// +// Name: CspLibGeneric.c +// +// Description: This file contains generic code to add functionality that can +// be used by any module. +// +//---------------------------------------------------------------------------- +//<AMI_FHDR_END> + +#include <Token.h> +#include "CspLibGeneric.h" + + +//<AMI_PHDR_START> +//---------------------------------------------------------------------------- +// Procedure: LocateMultiplePpi +// +// Description: +// This function wraps the initialization and error checking of LocatePpi() +// in a table, in order to reduce code size in functions that use several PPI. +// +// Input: +// EFI_PEI_SERVICES **PeiServices - Instance of a pointer to the PeiServices pointer +// UINT32 PpiTableSize - Size of argument table +// PPI_LOCATE_STRUCT *Ppi - Table of arguments for LocatePpi() +// +// Output: +// Pointers in PPI_LOCATE_STRUCT are updated +// Status is returned with values defined by the LocatePpi function +// +// Note: +// This function will use a Guid pointer or a Guid value defined locally +// in the PPI_LOCATE_STRUCT of the caller. +// +//---------------------------------------------------------------------------- +//<AMI_PHDR_END> + +EFI_STATUS LocateMultiplePpi ( + EFI_PEI_SERVICES **PeiServices, + UINT32 PpiTableSize, + PPI_LOCATE_STRUCT *Ppi +) +{ + EFI_STATUS Status; + UINT32 i; + EFI_PEI_LOCATE_PPI Locate = (*PeiServices)->LocatePpi; + + for (i = 0; i < PpiTableSize; i++) { + //------------------------------------------- + // locate the PPI (or) break on error + Status = Locate( PeiServices, + (Ppi[i].Guid.Data1 == 0) + ? Ppi[i].GuidPtr : &Ppi[i].Guid, + Ppi[i].Instance, + Ppi[i].Descriptor, + Ppi[i].Ptr ); + if (EFI_ERROR(Status)){ + break; + } + } + + return Status; +} + +//<AMI_PHDR_START> +//---------------------------------------------------------------------------- +// Procedure: LocateMultipleProtocol +// +// Description: +// This function wraps the initialization and error checking of +// LocateProtocol() in a table, in order to reduce code size in functions +// that use several Protocol. +// +// Input: +// EFI_BOOT_SERVICES *pBS - Instance of a pointer to the Boot Services Table +// UINT32 ProtocolTableSize - Number of Protocols in the table +// PROTOCOL_LOCATE_STRUCT *Protocol - Table of Parameters for LocateProtocol +// +// Output: +// Pointers in PROTOCOL_LOCATE_STRUCT are updated +// Status is returned with values defined by the LocateProtocol function +// +// Note: +// This function will use a Guid pointer or a Guid value defined locally in +// the PROTOCOL_LOCATE_STRUCT of the caller. +// +//---------------------------------------------------------------------------- +//<AMI_PHDR_END> + +EFI_STATUS LocateMultipleProtocol ( + EFI_BOOT_SERVICES *pBS, + UINT32 ProtocolTableSize, + PROTOCOL_LOCATE_STRUCT *Protocol +) +{ + EFI_STATUS Status; + UINT32 i; + EFI_LOCATE_PROTOCOL Locate = pBS->LocateProtocol; + + for (i = 0; i < ProtocolTableSize; i++) { + //------------------------------------------- + // locate the PPI (or) break on error + Status = Locate((Protocol[i].Guid.Data1 == 0) + ? Protocol[i].GuidPtr + : &Protocol[i].Guid, + Protocol[i].Registration, + Protocol[i].Interface ); + if (EFI_ERROR(Status)){ + break; + } + } + + return Status; +} + + +//<AMI_PHDR_START> +//---------------------------------------------------------------------------- +// Procedure: PeiWritePci +// +// Description: +// This function writes a value to a PCI register using a PCI_CONTROL +// structure to simplify the call. +// +// Input: +// PEI_PCI_ARGS *Pci - control structure +// +// Output: +// Status is returned with values defined in the PCI PPI Write function +// +//---------------------------------------------------------------------------- +//<AMI_PHDR_END> + +EFI_STATUS PeiWritePci ( + PEI_PCI_ARGS *Pci +) +{ + EFI_STATUS Status; + Status = Pci->Cfg->Write( Pci->PeiServices, + Pci->Cfg, + Pci->Width, + Pci->Address, + Pci->Value ); + return Status; +} + +//<AMI_PHDR_START> +//---------------------------------------------------------------------------- +// Procedure: PeiReadPci +// +// Description: +// This function reads the value in a PCI Register using a PCI_CONTROL +// structure to simplify the call. +// +// Input: +// PEI_PCI_ARGS *Pci - control structure +// +// Output: +// Pci->Value is updated with the value read from the PCI device +// Status is returned with values defined in the PCI PPI Read function +// +//---------------------------------------------------------------------------- +//<AMI_PHDR_END> + +EFI_STATUS PeiReadPci ( + PEI_PCI_ARGS *Pci +) +{ + EFI_STATUS Status; + Status = Pci->Cfg->Read( Pci->PeiServices, + Pci->Cfg, + Pci->Width, + Pci->Address, + Pci->Value ); + return Status; +} + +//<AMI_PHDR_START> +//---------------------------------------------------------------------------- +// Procedure: RbReadPci +// +// Description: +// This function reads the value(s) in a PCI Register using a RTBRG_PCI_ARGS +// structure to simplify the call. +// +// Input: +// RTBRG_PCI_ARGS *Arg - pointer to an instance of RTBRG_PCI_ARGS that contains parameters to the RootBrg PCI Read Function +// +// Output: +// Arg->Buffer is filled with the data read from the PCI device +// Return the status returned by the PCI Read funcntion of the Root Bridge protocol +// +//---------------------------------------------------------------------------- +//<AMI_PHDR_END> + +EFI_STATUS RbReadPci ( + RTBRG_PCI_ARGS *Arg +) +{ + EFI_STATUS Status = + Arg->RtBrdg->Pci.Read( Arg->RtBrdg, + Arg->Width, + Arg->Address, + Arg->Count, + Arg->Buffer); + return Status; +} + +//<AMI_PHDR_START> +//---------------------------------------------------------------------------- +// Procedure: RbWritePci +// +// Description: +// This function writes the value(s) in a PCI Register using a RTBRG_PCI_ARGS +// structure to simplify the call. +// +// Input: +// RTBRG_PCI_ARGS *Arg - pointer to an instance of RTBRG_PCI_ARGS that contains parameters to the RootBrg PCI Read Function +// +// Output: +// Return the status +// +//---------------------------------------------------------------------------- +//<AMI_PHDR_END> + +EFI_STATUS RbWritePci ( + RTBRG_PCI_ARGS *Arg +) +{ + EFI_STATUS Status = + Arg->RtBrdg->Pci.Write( Arg->RtBrdg, + Arg->Width, + Arg->Address, + Arg->Count, + Arg->Buffer); + return Status; +} + +//************** Runtime Shadow Ram access support **************************** +typedef VOID (RUNTIME_SHADOW_RAM_WRITE)( + IN BOOLEAN Enable +); + +extern RUNTIME_SHADOW_RAM_WRITE RUNTIME_SHADOW_RAM_WRITE_LIST EndOfList; +RUNTIME_SHADOW_RAM_WRITE* RuntimeShadowRamWriteList[] = {RUNTIME_SHADOW_RAM_WRITE_LIST NULL}; + +//<AMI_PHDR_START> +//---------------------------------------------------------------------------- +// Procedure: OemRuntimeShadowRamWrite +// +// Description: This function enables or disables runtime writing to shadow RAM +// (E000-F000 segment) +// +// +// Input: +// IN BOOLEAN Enable - if TRUE - enable writing to shadow region +// if FALSE - disable writing to shadow region +// +// Output: VOID +// +//---------------------------------------------------------------------------- +//<AMI_PHDR_END> +VOID OemRuntimeShadowRamWrite( + IN BOOLEAN Enable +) +{ + UINTN i; + + for (i = 0; RuntimeShadowRamWriteList[i]; i++) + RuntimeShadowRamWriteList[i](Enable); +} + +//<AMI_PHDR_START> +//---------------------------------------------------------------------------- +// Procedure: IsTopSwapOn +// +// Description: This function checks if TopSwap (A16 address line inversion) +// is on +// +// +// Input: +// None +// +// Output: +// TRUE - TopSwap is ON +// FALSE - TopSwap is OFF +// +//---------------------------------------------------------------------------- +//<AMI_PHDR_END> +BOOLEAN IsTopSwapOn( + VOID +) +{ + volatile UINT8* Address8; + + Address8 = (UINT8 *)(SB_RCBA + SB_BACKED_UP_CONTROL_REGISTER); + + return ((*Address8) & 1) ? TRUE : FALSE; +} + +//<AMI_PHDR_START> +//---------------------------------------------------------------------------- +// Procedure: SetTopSwap +// +// Description: This function sets TopSwap (A16 address line inversion) ON or OFF +// +// Input: +// BOOLEAN On - if TRUE, set TopSwap to ON, if FALSE - set to OFF +// +// Output: +// None +// +//---------------------------------------------------------------------------- +//<AMI_PHDR_END> +VOID SetTopSwap( + IN BOOLEAN On +) +{ + volatile UINT8* Address8; + + Address8 = (UINT8 *)(SB_RCBA + SB_BACKED_UP_CONTROL_REGISTER); + + if (On) { + *Address8 |= 1; + } else { + *Address8 &= 0xFE; + } +} + +//************************************************************************* +//************************************************************************* +//** ** +//** (C)Copyright 1985-2008, American Megatrends, Inc. ** +//** ** +//** All Rights Reserved. ** +//** ** +//** 5555 Oakbrook Parkway, Suite 200, Norcross, GA 30093 ** +//** ** +//** Phone: (770)-246-8600 ** +//** ** +//************************************************************************* +//************************************************************************* |