audk/EdkCompatibilityPkg/Foundation/Library/Dxe/Include/Ipf/SalDriverLib.h

1455 lines
23 KiB
C

/*++
Copyright (c) 2004, Intel Corporation
All rights reserved. This program and the accompanying materials
are licensed and made available under the terms and conditions of the BSD License
which accompanies this distribution. The full text of the license may be found at
http://opensource.org/licenses/bsd-license.php
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
Module Name:
SalDriverLib.h
Abstract:
SAL Driver Lib
Revision History
--*/
#ifndef _SAL_DRIVER_LIB_H_
#define _SAL_DRIVER_LIB_H_
#include "Tiano.h"
#include "EfiDriverLib.h"
#include "SalApi.h"
#include EFI_PROTOCOL_DEFINITION (ExtendedSalBootService)
#include EFI_PROTOCOL_DEFINITION (ExtendedSalGuid)
//
// Assembly Functions
//
SAL_RETURN_REGS
LibGetEsalPhyData (
VOID
)
/*++
Routine Description:
Get Esal global data in physical mode.
Arguments:
None
Returns:
Output regs
--*/
;
SAL_RETURN_REGS
LibGetEsalVirtData (
VOID
)
/*++
Routine Description:
Get Esal global data in virtual mode.
Arguments:
None
Returns:
Output regs
--*/
;
SAL_RETURN_REGS
LibSetEsalPhyData (
IN VOID *Ptr,
IN UINT64 GP
)
/*++
Routine Description:
Set Esal global data in physical mode.
Arguments:
Ptr - Pointer to the data
GP - Global pointer
Returns:
Output regs
--*/
;
SAL_RETURN_REGS
LibSetEsalVirtData (
IN VOID *Ptr,
IN UINT64 GP
)
/*++
Routine Description:
Set Esal global data in virtual mode.
Arguments:
Ptr - Pointer to the data
GP - Global pointer
Returns:
Output regs
--*/
;
SAL_RETURN_REGS
LibGetGlobalPhyData (
VOID
)
/*++
Routine Description:
Get Esal global data in physical mode.
Arguments:
None
Returns:
Output regs
--*/
;
SAL_RETURN_REGS
LibGetGlobalVirtData (
VOID
)
/*++
Routine Description:
Get Esal global data in virtual mode.
Arguments:
None
Returns:
Output regs
--*/
;
SAL_RETURN_REGS
LibSetGlobalPhyData (
IN VOID *Ptr,
IN UINT64 GP
)
/*++
Routine Description:
Set Esal global data in physical mode.
Arguments:
Ptr - Pointer to the data
GP - Global pointer
Returns:
Output regs
--*/
;
SAL_RETURN_REGS
LibSetGlobalVirtData (
IN VOID *Ptr,
IN UINT64 GP
)
/*++
Routine Description:
Set Esal global data in virtual mode.
Arguments:
Ptr - Pointer to the data
GP - Global pointer
Returns:
Output regs
--*/
;
SAL_RETURN_REGS
GetIrrData (
VOID
)
/*++
Routine Description:
Get interrupt request register.
Arguments:
None
Returns:
Output regs
--*/
;
VOID
PrepareApsForHandOverToOS (
VOID
)
/*++
Routine Description:
Prepare AP info for hand over to OS.
Arguments:
None
Returns:
None
--*/
;
VOID
HandOverApsToOS (
IN UINT64 a1,
IN UINT64 a2,
IN UINT64 a3
)
/*++
Routine Description:
Hand over AP info to OS.
Arguments:
a1 - Address to call into
a2 - GP
a3 - Undefined
Returns:
None
--*/
;
SAL_RETURN_REGS
GetPsrData (
VOID
)
/*++
Routine Description:
Get PSR register.
Arguments:
None
Returns:
Output regs.
--*/
;
SAL_RETURN_REGS
GetProcIdData (
VOID
)
/*++
Routine Description:
Get LID
Arguments:
None
Returns:
Output regs
--*/
;
VOID
SwitchCpuStack (
IN UINT64 NewBsp,
IN UINT64 OldBsp
)
/*++
Routine Description:
Switch BSP
Arguments:
NewBsp - New BSP index
OldBsp - Old BSP index
Returns:
None
--*/
;
//
// SAL Reset Class
//
VOID
SalResetSystem (
IN EFI_RESET_TYPE ResetType,
IN EFI_STATUS ResetStatus,
IN UINTN DataSize,
IN CHAR16 *ResetData
)
/*++
Routine Description:
Reset system
Arguments:
ResetType - Reset type
ResetStatus - Reset status
DataSize - Size of ResetData
ResetData - Description string
Returns:
None
--*/
;
//
// PAL PROC Class
//
SAL_RETURN_REGS
SalPalProc (
IN UINT64 Arg1,
IN UINT64 Arg2,
IN UINT64 Arg3,
IN UINT64 Arg4
)
/*++
Routine Description:
Call pal proc.
Arguments:
Arg1 - Pal call index
Arg2 - First arg
Arg3 - Second arg
Arg4 - Third arg
Returns:
Output regs
--*/
;
SAL_RETURN_REGS
SalRegisterNewPalEntry (
IN BOOLEAN PhysicalPalAddress,
IN EFI_PHYSICAL_ADDRESS NewPalAddress
)
/*++
Routine Description:
Register Pal entry.
Arguments:
PhysicalPalAddress - The address is physical or virtual
NewPalAddress - New Pal entry address
Returns:
Output regs
--*/
;
SAL_RETURN_REGS
SalGetPalEntryPointer (
IN BOOLEAN PhysicalPalAddress
)
/*++
Routine Description:
Get Pal entry.
Arguments:
PhysicalPalAddress - The address is physical or virtual
Returns:
Output regs
--*/
;
//
// SAL MTC Class
//
EFI_STATUS
SalGetNextHighMonotonicCount (
OUT UINT32 *HighCount
)
/*++
Routine Description:
Get next high 32 bits of monotonic count.
Arguments:
HighCount - High 32 bits of monotonic count.
Returns:
Status code
--*/
;
//
// SAL BASE Class
//
SAL_RETURN_REGS
SalProcSetVectors (
IN UINT64 SalVectorType,
IN UINT64 PhyAddr1,
IN UINT64 Gp1,
IN UINT64 LengthCs1,
IN UINT64 PhyAddr2,
IN UINT64 Gp2,
IN UINT64 LengthCs2
)
/*++
Routine Description:
Set vectors.
Arguments:
SalVectorType - Vector type
PhyAddr1 - OS MCA entry point
Gp1 - GP for OS MCA entry
LengthCs1 - Length of OS MCA
PhyAddr2 - OS INIT entry point
Gp2 - GP for OS Init entry
LengthCs2 - Length of OS INIT
Returns:
Output regs
--*/
;
SAL_RETURN_REGS
SalProcMcRendez (
VOID
)
/*++
Routine Description:
Mc rendezvous function.
Arguments:
None
Returns:
Output regs
--*/
;
SAL_RETURN_REGS
SalProcMcSetParams (
IN UINT64 ParamType,
IN UINT64 IntOrMem,
IN UINT64 IntOrMemVal,
IN UINT64 Timeout,
IN UINT64 McaOpt
)
/*++
Routine Description:
Set MCA parameters.
Arguments:
ParamType - Parameter type
IntOrMem - Interrupt or memory address
IntOrMemVal - Interrupt number or memory address value
Timeout - Time out value
McaOpt - Option for MCA
Returns:
Output regs
--*/
;
SAL_RETURN_REGS
EsalProcGetVectors (
IN UINT64 VectorType
)
/*++
Routine Description:
Get OS MCA vector.
Arguments:
VectorType - Vector type
Returns:
Output regs
--*/
;
SAL_RETURN_REGS
EsalProcMcGetParams (
IN UINT64 ParamInfoType
)
/*++
Routine Description:
Get MCA parameter.
Arguments:
ParamInfoType - Parameter info type
Returns:
Output regs
--*/
;
SAL_RETURN_REGS
EsalProcMcGetMcParams (
VOID
)
/*++
Routine Description:
Get MCA parameter.
Arguments:
Returns:
Output regs
--*/
;
SAL_RETURN_REGS
EsalProcGetMcCheckinFlags (
IN UINT64 ProcessorUnit
)
/*++
Routine Description:
Get process status.
Arguments:
ProcessorUnit - Processor Index
Returns:
Output regs
--*/
;
//
// Sal Base Class enums
//
typedef enum {
McaVector,
BspInitVector,
BootRendezVector,
ApInitVector
} ESAL_GET_VECTOR_TYPE;
//
// Sal RTC Class
//
EFI_STATUS
SalGetTime (
OUT EFI_TIME *Time,
OUT EFI_TIME_CAPABILITIES *Capabilities
)
/*++
Routine Description:
Returns the current time and date information, and the time-keeping
capabilities of the hardware platform.
Arguments:
Time - A pointer to storage to receive a snapshot of the current time.
Capabilities - An optional pointer to a buffer to receive the real time clock device's
capabilities.
Returns:
Status code
--*/
;
EFI_STATUS
SalSetTime (
OUT EFI_TIME *Time
)
/*++
Routine Description:
Sets the current local time and date information.
Arguments:
Time - A pointer to the current time.
Returns:
Status code
--*/
;
EFI_STATUS
SalGetWakeupTime (
OUT BOOLEAN *Enabled,
OUT BOOLEAN *Pending,
OUT EFI_TIME *Time
)
/*++
Routine Description:
Returns the current wakeup alarm clock setting.
Arguments:
Enabled - Indicates if the alarm is currently enabled or disabled.
Pending - Indicates if the alarm signal is pending and requires acknowledgement.
Time - The current alarm setting.
Returns:
Status code
--*/
;
EFI_STATUS
SalSetWakeupTime (
IN BOOLEAN Enable,
IN EFI_TIME *Time
)
/*++
Routine Description:
Sets the system wakeup alarm clock time.
Arguments:
Enable - Enable or disable the wakeup alarm.
Time - If Enable is TRUE, the time to set the wakeup alarm for.
If Enable is FALSE, then this parameter is optional, and may be NULL.
Returns:
Status code
--*/
;
SAL_RETURN_REGS
SalInitializeThreshold (
IN VOID *ThresholdStruct,
IN UINT64 Count,
IN UINT64 Duration
)
/*++
Routine Description:
Init threshold structure.
Arguments:
ThresholdStruct - Threshold structure
Count - Threshold count
Duration - Duration
Returns:
Output regs
--*/
;
SAL_RETURN_REGS
SalBumpThresholdCount (
IN VOID *ThresholdStruct,
IN UINT64 Count,
IN UINT64 Duration
)
/*++
Routine Description:
Bump threshold count.
Arguments:
ThresholdStruct - Threshold structure
Count - Threshold count
Duration - Duration
Returns:
Output regs
--*/
;
SAL_RETURN_REGS
SalGetThresholdCount (
IN VOID *ThresholdStruct,
IN UINT64 Count,
IN UINT64 Duration
)
/*++
Routine Description:
Get threshold structure.
Arguments:
ThresholdStruct - Threshold structure
Count - Threshold count
Duration - Duration
Returns:
Output regs
--*/
;
//
// Common Lib Function
//
EFI_STATUS
RegisterEsalFunction (
IN UINT64 FunctionId,
IN EFI_GUID *ClassGuid,
IN SAL_INTERNAL_EXTENDED_SAL_PROC Function,
IN VOID *ModuleGlobal
)
/*++
Routine Description:
Register ESAL Class Function and it's asociated global.
This function is boot service only!
Arguments:
FunctionId - ID of function to register
ClassGuid - GUID of function class
Function - Function to register under ClassGuid/FunctionId pair
ModuleGlobal - Module global for Function.
Returns:
EFI_SUCCESS - If ClassGuid/FunctionId Function was registered.
--*/
;
EFI_STATUS
EfiInitializeSalDriverLib (
IN BOOLEAN Runtime
)
/*++
Routine Description:
Initialize Sal driver lib.
Arguments:
Runtime - At runtime or not?
Returns:
Status code
--*/
;
//
// MCA PMI INIT Registeration Functions.
//
EFI_STATUS
LibRegisterMcaFunction (
IN EFI_SAL_MCA_HANDLER McaHandler,
IN VOID *ModuleGlobal,
IN BOOLEAN MakeFirst,
IN BOOLEAN MakeLast
)
/*++
Routine Description:
Register MCA handler.
Arguments:
McaHandler - MCA handler
ModuleGlobal - Module global for function
MakeFirst - Make it as first?
MakeLast - Make it as last?
Returns:
Status code
--*/
;
EFI_STATUS
LibRegisterPmiFunction (
IN EFI_SAL_PMI_HANDLER PmiHandler,
IN VOID *ModuleGlobal,
IN BOOLEAN MakeFirst,
IN BOOLEAN MakeLast
)
/*++
Routine Description:
Register PMI handler.
Arguments:
PmiHandler - PMI handler
ModuleGlobal - Module global for function
MakeFirst - Make it as first?
MakeLast - Make it as last?
Returns:
Status code
--*/
;
EFI_STATUS
LibRegisterInitFunction (
IN EFI_SAL_INIT_HANDLER InitHandler,
IN VOID *ModuleGlobal,
IN BOOLEAN MakeFirst,
IN BOOLEAN MakeLast
)
/*++
Routine Description:
Register INIT handler.
Arguments:
InitHandler - INIT handler
ModuleGlobal - Module global for function
MakeFirst - Make it as first?
MakeLast - Make it as last?
Returns:
Status code
--*/
;
//
// Base IO Class Functions
//
EFI_STATUS
ESalIoRead (
IN EFI_CPU_IO_PROTOCOL_WIDTH Width,
IN UINT64 Address,
IN UINTN Count,
IN OUT VOID *Buffer
)
/*++
Routine Description:
Io read operation.
Arguments:
Width - Width of read operation
Address - Start IO address to read
Count - Read count
Buffer - Buffer to store result
Returns:
Status code
--*/
;
EFI_STATUS
ESalIoWrite (
IN EFI_CPU_IO_PROTOCOL_WIDTH Width,
IN UINT64 Address,
IN UINTN Count,
IN OUT VOID *Buffer
)
/*++
Routine Description:
Io write operation.
Arguments:
Width - Width of write operation
Address - Start IO address to write
Count - Write count
Buffer - Buffer to write to the address
Returns:
Status code
--*/
;
EFI_STATUS
ESalMemRead (
IN EFI_CPU_IO_PROTOCOL_WIDTH Width,
IN UINT64 Address,
IN UINTN Count,
IN OUT VOID *Buffer
)
/*++
Routine Description:
Perform a Memory mapped IO read into Buffer.
Arguments:
Width - Width of each read transaction.
Address - Memory mapped IO address to read
Count - Number of Width quanta to read
Buffer - Buffer to read data into. size is Width * Count
Returns:
Status code
--*/
;
EFI_STATUS
ESalMemWrite (
IN EFI_CPU_IO_PROTOCOL_WIDTH Width,
IN UINT64 Address,
IN UINTN Count,
IN OUT VOID *Buffer
)
/*++
Routine Description:
Perform a memory mapped IO write into Buffer.
Arguments:
Width - Width of write transaction, and repeat operation to use
Address - IO address to write
Count - Number of times to write the IO address.
Buffer - Buffer to write data from. size is Width * Count
Returns:
Status code
--*/
;
//
// PCI Class Functions
//
SAL_RETURN_REGS
SalPCIConfigRead (
IN UINT64 Address,
IN UINT64 Size
)
/*++
Routine Description:
Pci config space read.
Arguments:
Address - PCI address to read
Size - Size to read
Returns:
Output regs
--*/
;
SAL_RETURN_REGS
SalPCIConfigWrite (
IN UINT64 Address,
IN UINT64 Size,
IN UINT64 Value
)
/*++
Routine Description:
Pci config space write.
Arguments:
Address - PCI address to write
Size - Size to write
Value - Value to write
Returns:
Output regs
--*/
;
//
// MP Class Functions
//
SAL_RETURN_REGS
LibMPAddCpuData (
IN UINT64 CpuGlobalId,
IN BOOLEAN Enabled,
IN UINT64 PalCompatability
)
/*++
Routine Description:
Add CPU data.
Arguments:
CpuGlobalId - CPU ID
Enabled - Enabled or not
PalCompatability - Pal compatability
Returns:
Output regs
--*/
;
SAL_RETURN_REGS
LibMPRemoveCpuData (
IN UINT64 CpuGlobalId
)
/*++
Routine Description:
Remove CPU data.
Arguments:
CpuGlobalId - CPU ID
Returns:
Output regs
--*/
;
SAL_RETURN_REGS
LibMPModifyCpuData (
IN UINT64 CpuGlobalId,
IN BOOLEAN Enabled,
IN UINT64 PalCompatability
)
/*++
Routine Description:
Modify CPU data.
Arguments:
CpuGlobalId - CPU ID
Enabled - Enabled or not
PalCompatability - Pal compatability
Returns:
Output regs
--*/
;
SAL_RETURN_REGS
LibMPGetCpuDataByID (
IN UINT64 CpuGlobalId,
IN BOOLEAN IndexByEnabledCpu
)
/*++
Routine Description:
Get CPU data.
Arguments:
CpuGlobalId - CPU ID
IndexByEnabledCpu - Whether indexed by enabled CPU
Returns:
Output regs
--*/
;
SAL_RETURN_REGS
LibMPGetCpuDataByIndex (
IN UINT64 Index,
IN BOOLEAN IndexByEnabledCpu
)
/*++
Routine Description:
Get CPU data.
Arguments:
Index - CPU index
IndexByEnabledCpu - Whether indexed by enabled CPU
Returns:
Output regs
--*/
;
SAL_RETURN_REGS
LibMPSendIpi (
IN UINT64 ProcessorNumber,
IN UINT64 VectorNumber,
IN EFI_DELIVERY_MODE DeliveryMode,
IN BOOLEAN IRFlag
)
/*++
Routine Description:
Send IPI.
Arguments:
ProcessorNumber - Processor number
VectorNumber - Vector number
DeliveryMode - Delivery mode
IRFlag - Interrupt Redirection flag
Returns:
Output regs
--*/
;
SAL_RETURN_REGS
LibMpCurrentProcessor (
IN BOOLEAN IndexByEnabledCpu
)
/*++
Routine Description:
Get current processor index.
Arguments:
IndexByEnabledCpu - Whether indexed by enabled CPU
Returns:
Output regs
--*/
;
SAL_RETURN_REGS
LibGetNumProcessors (
VOID
)
/*++
Routine Description:
Get number of processors.
Arguments:
None
Returns:
Output regs
--*/
;
SAL_RETURN_REGS
LibMpSaveMinStatePointer (
IN UINT64 CpuGlobalId,
IN EFI_PHYSICAL_ADDRESS MinStatePointer
)
/*++
Routine Description:
Register pointer to save min state.
Arguments:
CpuGlobalId - CPU global ID
MinStatePointer - Pointer to save min state
Returns:
Output regs
--*/
;
SAL_RETURN_REGS
LibMpRestoreMinStatePointer (
IN UINT64 CpuGlobalId
)
/*++
Routine Description:
Restore pointer to save min state.
Arguments:
CpuGlobalId - CPU global ID
Returns:
Output regs
--*/
;
//
// MCA Class Functions
//
EFI_STATUS
LibMcaGetStateInfo (
IN UINT64 CpuId,
OUT EFI_PHYSICAL_ADDRESS *StateBufferPointer,
OUT UINT64 *RequiredStateBufferSize
)
/*++
Routine Description:
MCA get state info.
Arguments:
CpuId - CPU ID
StateBufferPointer - Pointer of state buffer
RequiredStateBufferSize - Size of required state buffer
Returns:
Status code
--*/
;
EFI_STATUS
LibMcaRegisterCpu (
IN UINT64 CpuId,
IN EFI_PHYSICAL_ADDRESS StateBufferAddress
)
/*++
Routine Description:
MCA register CPU state info.
Arguments:
CpuId - CPU ID
StateBufferAddress - Pointer of state buffer
Returns:
Status code
--*/
;
//
// SAL ELOG Functions
//
EFI_STATUS
LibSalGetStateInfo (
IN UINT64 McaType,
IN UINT8 *McaBuffer,
OUT UINTN *Size
)
/*++
Routine Description:
Get state info.
Arguments:
McaType - MCA type
McaBuffer - Info buffer provided by caller
Size - Size of info
Returns:
Status code
--*/
;
EFI_STATUS
LibSalGetStateInfoSize (
IN UINT64 McaType,
OUT UINTN *Size
)
/*++
Routine Description:
Get state info size.
Arguments:
McaType - MCA type
Size - Size required
Returns:
Status code
--*/
;
EFI_STATUS
LibSalClearStateInfo (
IN UINT64 McaType
)
/*++
Routine Description:
Clear state info.
Arguments:
McaType - MCA type
Returns:
Status code
--*/
;
EFI_STATUS
LibEsalGetStateBuffer (
IN UINT64 McaType,
OUT UINT8 **McaBuffer,
OUT UINTN *Index
)
/*++
Routine Description:
Get state buffer.
Arguments:
McaType - MCA type
McaBuffer - MCA buffer
Index - CPU index
Returns:
Status code
--*/
;
EFI_STATUS
LibEsalSaveStateBuffer (
IN UINT64 McaType
)
/*++
Routine Description:
Save state buffer.
Arguments:
McaType - MCA type
Returns:
Status code
--*/
;
#endif