mirror of
https://github.com/acidanthera/audk.git
synced 2025-07-23 21:54:27 +02:00
Updated Hardware Interrupt protocol to add an EOI member. Added ARM Data/Instruction syncronization barrier support to the ARM lib.
git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@10063 6f19259b-4bc3-4df7-8a09-765794883524
This commit is contained in:
parent
14e00c13be
commit
026c3d34ee
@ -309,5 +309,23 @@ EFIAPI
|
|||||||
ArmDisableBranchPrediction (
|
ArmDisableBranchPrediction (
|
||||||
VOID
|
VOID
|
||||||
);
|
);
|
||||||
|
|
||||||
|
VOID
|
||||||
|
EFIAPI
|
||||||
|
ArmDataMemoryBarrier (
|
||||||
|
VOID
|
||||||
|
);
|
||||||
|
|
||||||
|
VOID
|
||||||
|
EFIAPI
|
||||||
|
ArmDataSyncronizationBarrier (
|
||||||
|
VOID
|
||||||
|
);
|
||||||
|
|
||||||
|
VOID
|
||||||
|
EFIAPI
|
||||||
|
ArmInstructionSynchronizationBarrier (
|
||||||
|
VOID
|
||||||
|
);
|
||||||
|
|
||||||
#endif // __ARM_LIB__
|
#endif // __ARM_LIB__
|
||||||
|
@ -116,3 +116,34 @@ ArmConfigureMmu (
|
|||||||
ArmEnableDataCache();
|
ArmEnableDataCache();
|
||||||
ArmEnableMmu();
|
ArmEnableMmu();
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
|
VOID
|
||||||
|
EFIAPI
|
||||||
|
ArmDataMemoryBarrier (
|
||||||
|
VOID
|
||||||
|
)
|
||||||
|
{
|
||||||
|
// Should move to assembly with the
|
||||||
|
}
|
||||||
|
|
||||||
|
VOID
|
||||||
|
EFIAPI
|
||||||
|
ArmDataSyncronizationBarrier (
|
||||||
|
VOID
|
||||||
|
)
|
||||||
|
{
|
||||||
|
// MOV R0, #0
|
||||||
|
// MCR P15, #0, R0, C7, C10, #4}
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
VOID
|
||||||
|
EFIAPI
|
||||||
|
ArmInstructionSynchronizationBarrier (
|
||||||
|
VOID
|
||||||
|
)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
@ -30,6 +30,10 @@
|
|||||||
.globl ASM_PFX(ArmDisableInstructionCache)
|
.globl ASM_PFX(ArmDisableInstructionCache)
|
||||||
.globl ASM_PFX(ArmEnableBranchPrediction)
|
.globl ASM_PFX(ArmEnableBranchPrediction)
|
||||||
.globl ASM_PFX(ArmDisableBranchPrediction)
|
.globl ASM_PFX(ArmDisableBranchPrediction)
|
||||||
|
.globl ASM_PFX(ArmDataMemoryBarrier)
|
||||||
|
.globl ASM_PFX(ArmDataSyncronizationBarrier)
|
||||||
|
.globl ASM_PFX(ArmInstructionSynchronizationBarrier)
|
||||||
|
|
||||||
|
|
||||||
.set DC_ON, (0x1<<2)
|
.set DC_ON, (0x1<<2)
|
||||||
.set IC_ON, (0x1<<12)
|
.set IC_ON, (0x1<<12)
|
||||||
@ -132,4 +136,20 @@ ASM_PFX(ArmDisableBranchPrediction):
|
|||||||
mcr p15, 0, r0, c1, c0, 0
|
mcr p15, 0, r0, c1, c0, 0
|
||||||
bx LR
|
bx LR
|
||||||
|
|
||||||
|
ASM_PFX(ArmDataMemoryBarrier):
|
||||||
|
mov R0, #0
|
||||||
|
mcr P15, #0, R0, C7, C10, #5
|
||||||
|
bx LR
|
||||||
|
|
||||||
|
ASM_PFX(ArmDataSyncronizationBarrier):
|
||||||
|
mov R0, #0
|
||||||
|
mcr P15, #0, R0, C7, C10, #4
|
||||||
|
bx LR
|
||||||
|
|
||||||
|
ASM_PFX(ArmInstructionSynchronizationBarrier):
|
||||||
|
mov R0, #0
|
||||||
|
mcr P15, #0, R0, C7, C5, #4
|
||||||
|
bx LR
|
||||||
|
|
||||||
|
|
||||||
ASM_FUNCTION_REMOVE_IF_UNREFERENCED
|
ASM_FUNCTION_REMOVE_IF_UNREFERENCED
|
||||||
|
@ -28,6 +28,9 @@
|
|||||||
EXPORT ArmDisableInstructionCache
|
EXPORT ArmDisableInstructionCache
|
||||||
EXPORT ArmEnableBranchPrediction
|
EXPORT ArmEnableBranchPrediction
|
||||||
EXPORT ArmDisableBranchPrediction
|
EXPORT ArmDisableBranchPrediction
|
||||||
|
EXPORT ArmDataMemoryBarrier
|
||||||
|
EXPORT ArmDataSyncronizationBarrier
|
||||||
|
EXPORT ArmInstructionSynchronizationBarrier
|
||||||
|
|
||||||
|
|
||||||
DC_ON EQU ( 0x1:SHL:2 )
|
DC_ON EQU ( 0x1:SHL:2 )
|
||||||
@ -136,4 +139,19 @@ ArmDisableBranchPrediction
|
|||||||
mcr p15, 0, r0, c1, c0, 0
|
mcr p15, 0, r0, c1, c0, 0
|
||||||
bx LR
|
bx LR
|
||||||
|
|
||||||
|
ASM_PFX(ArmDataMemoryBarrier):
|
||||||
|
mov R0, #0
|
||||||
|
mcr P15, #0, R0, C7, C10, #5
|
||||||
|
bx LR
|
||||||
|
|
||||||
|
ASM_PFX(ArmDataSyncronizationBarrier):
|
||||||
|
mov R0, #0
|
||||||
|
mcr P15, #0, R0, C7, C10, #4
|
||||||
|
bx LR
|
||||||
|
|
||||||
|
ASM_PFX(ArmInstructionSynchronizationBarrier):
|
||||||
|
MOV R0, #0
|
||||||
|
MCR P15, #0, R0, C7, C5, #4
|
||||||
|
bx LR
|
||||||
|
|
||||||
END
|
END
|
||||||
|
@ -116,3 +116,30 @@ ArmConfigureMmu (
|
|||||||
ArmEnableDataCache();
|
ArmEnableDataCache();
|
||||||
ArmEnableMmu();
|
ArmEnableMmu();
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
|
VOID
|
||||||
|
EFIAPI
|
||||||
|
ArmDataMemoryBarrier (
|
||||||
|
VOID
|
||||||
|
)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
VOID
|
||||||
|
EFIAPI
|
||||||
|
ArmDataSyncronizationBarrier (
|
||||||
|
VOID
|
||||||
|
)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
VOID
|
||||||
|
EFIAPI
|
||||||
|
ArmInstructionSynchronizationBarrier (
|
||||||
|
VOID
|
||||||
|
)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
@ -34,6 +34,10 @@
|
|||||||
.globl ASM_PFX(ArmEnableBranchPrediction)
|
.globl ASM_PFX(ArmEnableBranchPrediction)
|
||||||
.globl ASM_PFX(ArmDisableBranchPrediction)
|
.globl ASM_PFX(ArmDisableBranchPrediction)
|
||||||
.globl ASM_PFX(ArmV7AllDataCachesOperation)
|
.globl ASM_PFX(ArmV7AllDataCachesOperation)
|
||||||
|
.globl ASM_PFX(ArmDataMemoryBarrier)
|
||||||
|
.globl ASM_PFX(ArmDataSyncronizationBarrier)
|
||||||
|
.globl ASM_PFX(ArmInstructionSynchronizationBarrier)
|
||||||
|
|
||||||
|
|
||||||
.set DC_ON, (0x1<<2)
|
.set DC_ON, (0x1<<2)
|
||||||
.set IC_ON, (0x1<<12)
|
.set IC_ON, (0x1<<12)
|
||||||
@ -222,5 +226,17 @@ L_Finished:
|
|||||||
ldmfd SP!, {r4-r12, lr}
|
ldmfd SP!, {r4-r12, lr}
|
||||||
bx LR
|
bx LR
|
||||||
|
|
||||||
|
ASM_PFX(ArmDataMemoryBarrier):
|
||||||
|
dmb
|
||||||
|
bx LR
|
||||||
|
|
||||||
|
ASM_PFX(ArmDataSyncronizationBarrier):
|
||||||
|
dsb
|
||||||
|
bx LR
|
||||||
|
|
||||||
|
ASM_PFX(ArmInstructionSynchronizationBarrier):
|
||||||
|
isb
|
||||||
|
bx LR
|
||||||
|
|
||||||
|
|
||||||
ASM_FUNCTION_REMOVE_IF_UNREFERENCED
|
ASM_FUNCTION_REMOVE_IF_UNREFERENCED
|
||||||
|
@ -30,6 +30,10 @@
|
|||||||
EXPORT ArmEnableBranchPrediction
|
EXPORT ArmEnableBranchPrediction
|
||||||
EXPORT ArmDisableBranchPrediction
|
EXPORT ArmDisableBranchPrediction
|
||||||
EXPORT ArmV7AllDataCachesOperation
|
EXPORT ArmV7AllDataCachesOperation
|
||||||
|
EXPORT ArmDataMemoryBarrier
|
||||||
|
EXPORT ArmDataSyncronizationBarrier
|
||||||
|
EXPORT ArmInstructionSynchronizationBarrier
|
||||||
|
|
||||||
|
|
||||||
DC_ON EQU ( 0x1:SHL:2 )
|
DC_ON EQU ( 0x1:SHL:2 )
|
||||||
IC_ON EQU ( 0x1:SHL:12 )
|
IC_ON EQU ( 0x1:SHL:12 )
|
||||||
@ -217,4 +221,17 @@ Finished
|
|||||||
LDMFD SP!, {r4-r12, lr}
|
LDMFD SP!, {r4-r12, lr}
|
||||||
BX LR
|
BX LR
|
||||||
|
|
||||||
|
|
||||||
|
ArmDataMemoryBarrier
|
||||||
|
DMB
|
||||||
|
BX LR
|
||||||
|
|
||||||
|
ArmDataSyncronizationBarrier
|
||||||
|
DSB
|
||||||
|
BX LR
|
||||||
|
|
||||||
|
ArmInstructionSynchronizationBarrier
|
||||||
|
ISB
|
||||||
|
BX LR
|
||||||
|
|
||||||
END
|
END
|
||||||
|
@ -1,7 +1,7 @@
|
|||||||
/** @file
|
/** @file
|
||||||
Template for Metronome Architecture Protocol driver of the ARM flavor
|
Handle OMAP35xx interrupt controller
|
||||||
|
|
||||||
Copyright (c) 2008-2009, Apple Inc. All rights reserved.
|
Copyright (c) 2008-2010, Apple Inc. All rights reserved.
|
||||||
|
|
||||||
All rights reserved. This program and the accompanying materials
|
All rights reserved. This program and the accompanying materials
|
||||||
are licensed and made available under the terms and conditions of the BSD License
|
are licensed and made available under the terms and conditions of the BSD License
|
||||||
@ -21,6 +21,7 @@
|
|||||||
#include <Library/UefiLib.h>
|
#include <Library/UefiLib.h>
|
||||||
#include <Library/PcdLib.h>
|
#include <Library/PcdLib.h>
|
||||||
#include <Library/IoLib.h>
|
#include <Library/IoLib.h>
|
||||||
|
#include <Library/ArmLib.h>
|
||||||
|
|
||||||
#include <Protocol/Cpu.h>
|
#include <Protocol/Cpu.h>
|
||||||
#include <Protocol/HardwareInterrupt.h>
|
#include <Protocol/HardwareInterrupt.h>
|
||||||
@ -143,7 +144,7 @@ EnableInterruptSource (
|
|||||||
**/
|
**/
|
||||||
EFI_STATUS
|
EFI_STATUS
|
||||||
EFIAPI
|
EFIAPI
|
||||||
DisableInterruptSource(
|
DisableInterruptSource (
|
||||||
IN EFI_HARDWARE_INTERRUPT_PROTOCOL *This,
|
IN EFI_HARDWARE_INTERRUPT_PROTOCOL *This,
|
||||||
IN HARDWARE_INTERRUPT_SOURCE Source
|
IN HARDWARE_INTERRUPT_SOURCE Source
|
||||||
)
|
)
|
||||||
@ -209,6 +210,28 @@ GetInterruptSourceState (
|
|||||||
return EFI_SUCCESS;
|
return EFI_SUCCESS;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
Signal to the hardware that the End Of Intrrupt state
|
||||||
|
has been reached.
|
||||||
|
|
||||||
|
@param This Instance pointer for this protocol
|
||||||
|
@param Source Hardware source of the interrupt
|
||||||
|
|
||||||
|
@retval EFI_SUCCESS Source interrupt EOI'ed.
|
||||||
|
@retval EFI_DEVICE_ERROR Hardware could not be programmed.
|
||||||
|
|
||||||
|
**/
|
||||||
|
EFI_STATUS
|
||||||
|
EFIAPI
|
||||||
|
EndOfInterrupt (
|
||||||
|
IN EFI_HARDWARE_INTERRUPT_PROTOCOL *This,
|
||||||
|
IN HARDWARE_INTERRUPT_SOURCE Source
|
||||||
|
)
|
||||||
|
{
|
||||||
|
MmioWrite32 (INTCPS_CONTROL, INTCPS_CONTROL_NEWIRQAGR);
|
||||||
|
ArmDataSyncronizationBarrier ();
|
||||||
|
return EFI_SUCCESS;
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@ -232,19 +255,21 @@ IrqInterruptHandler (
|
|||||||
UINT32 Vector;
|
UINT32 Vector;
|
||||||
HARDWARE_INTERRUPT_HANDLER InterruptHandler;
|
HARDWARE_INTERRUPT_HANDLER InterruptHandler;
|
||||||
|
|
||||||
Vector = MmioRead32(INTCPS_SIR_IRQ) & INTCPS_SIR_IRQ_MASK;
|
Vector = MmioRead32 (INTCPS_SIR_IRQ) & INTCPS_SIR_IRQ_MASK;
|
||||||
|
|
||||||
// Needed to prevent infinite nesting when Time Driver lowers TPL
|
// Needed to prevent infinite nesting when Time Driver lowers TPL
|
||||||
MmioWrite32 (INTCPS_CONTROL, INTCPS_CONTROL_NEWIRQAGR);
|
MmioWrite32 (INTCPS_CONTROL, INTCPS_CONTROL_NEWIRQAGR);
|
||||||
|
ArmDataSyncronizationBarrier ();
|
||||||
|
|
||||||
InterruptHandler = gRegisteredInterruptHandlers[Vector];
|
InterruptHandler = gRegisteredInterruptHandlers[Vector];
|
||||||
if (InterruptHandler != NULL) {
|
if (InterruptHandler != NULL) {
|
||||||
// Call the registered interrupt handler.
|
// Call the registered interrupt handler.
|
||||||
InterruptHandler(Vector, SystemContext);
|
InterruptHandler (Vector, SystemContext);
|
||||||
}
|
}
|
||||||
|
|
||||||
// Needed to clear after running the handler
|
// Needed to clear after running the handler
|
||||||
MmioWrite32 (INTCPS_CONTROL, INTCPS_CONTROL_NEWIRQAGR);
|
MmioWrite32 (INTCPS_CONTROL, INTCPS_CONTROL_NEWIRQAGR);
|
||||||
|
ArmDataSyncronizationBarrier ();
|
||||||
}
|
}
|
||||||
|
|
||||||
//
|
//
|
||||||
@ -259,7 +284,8 @@ EFI_HARDWARE_INTERRUPT_PROTOCOL gHardwareInterruptProtocol = {
|
|||||||
RegisterInterruptSource,
|
RegisterInterruptSource,
|
||||||
EnableInterruptSource,
|
EnableInterruptSource,
|
||||||
DisableInterruptSource,
|
DisableInterruptSource,
|
||||||
GetInterruptSourceState
|
GetInterruptSourceState,
|
||||||
|
EndOfInterrupt
|
||||||
};
|
};
|
||||||
|
|
||||||
//
|
//
|
||||||
@ -277,19 +303,19 @@ CpuProtocolInstalledNotification (
|
|||||||
//
|
//
|
||||||
// Get the cpu protocol that this driver requires.
|
// Get the cpu protocol that this driver requires.
|
||||||
//
|
//
|
||||||
Status = gBS->LocateProtocol(&gEfiCpuArchProtocolGuid, NULL, (VOID **)&Cpu);
|
Status = gBS->LocateProtocol (&gEfiCpuArchProtocolGuid, NULL, (VOID **)&Cpu);
|
||||||
ASSERT_EFI_ERROR(Status);
|
ASSERT_EFI_ERROR(Status);
|
||||||
|
|
||||||
//
|
//
|
||||||
// Unregister the default exception handler.
|
// Unregister the default exception handler.
|
||||||
//
|
//
|
||||||
Status = Cpu->RegisterInterruptHandler(Cpu, EXCEPT_ARM_IRQ, NULL);
|
Status = Cpu->RegisterInterruptHandler (Cpu, EXCEPT_ARM_IRQ, NULL);
|
||||||
ASSERT_EFI_ERROR(Status);
|
ASSERT_EFI_ERROR(Status);
|
||||||
|
|
||||||
//
|
//
|
||||||
// Register to receive interrupts
|
// Register to receive interrupts
|
||||||
//
|
//
|
||||||
Status = Cpu->RegisterInterruptHandler(Cpu, EXCEPT_ARM_IRQ, IrqInterruptHandler);
|
Status = Cpu->RegisterInterruptHandler (Cpu, EXCEPT_ARM_IRQ, IrqInterruptHandler);
|
||||||
ASSERT_EFI_ERROR(Status);
|
ASSERT_EFI_ERROR(Status);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
@ -41,6 +41,7 @@
|
|||||||
|
|
||||||
|
|
||||||
[Packages]
|
[Packages]
|
||||||
|
ArmPkg/ArmPkg.dec
|
||||||
Omap35xxPkg/Omap35xxPkg.dec
|
Omap35xxPkg/Omap35xxPkg.dec
|
||||||
MdePkg/MdePkg.dec
|
MdePkg/MdePkg.dec
|
||||||
EmbeddedPkg/EmbeddedPkg.dec
|
EmbeddedPkg/EmbeddedPkg.dec
|
||||||
@ -53,6 +54,7 @@
|
|||||||
PrintLib
|
PrintLib
|
||||||
UefiDriverEntryPoint
|
UefiDriverEntryPoint
|
||||||
IoLib
|
IoLib
|
||||||
|
ArmLib
|
||||||
|
|
||||||
[Guids]
|
[Guids]
|
||||||
|
|
||||||
|
@ -59,19 +59,13 @@ volatile UINTN gVector;
|
|||||||
C Interrupt Handler calledin the interrupt context when Source interrupt is active.
|
C Interrupt Handler calledin the interrupt context when Source interrupt is active.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
@param Source Source of the interrupt. Hardware routing off a specific platform defines
|
@param Source Source of the interrupt. Hardware routing off a specific platform defines
|
||||||
|
|
||||||
what source means.
|
what source means.
|
||||||
|
|
||||||
@param SystemContext Pointer to system register context. Mostly used by debuggers and will
|
@param SystemContext Pointer to system register context. Mostly used by debuggers and will
|
||||||
|
|
||||||
update the system context after the return from the interrupt if
|
update the system context after the return from the interrupt if
|
||||||
|
|
||||||
modified. Don't change these values unless you know what you are doing
|
modified. Don't change these values unless you know what you are doing
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
**/
|
**/
|
||||||
VOID
|
VOID
|
||||||
EFIAPI
|
EFIAPI
|
||||||
@ -85,15 +79,10 @@ TimerInterruptHandler (
|
|||||||
|
|
||||||
|
|
||||||
//
|
//
|
||||||
|
|
||||||
// DXE core uses this callback for the EFI timer tick. The DXE core uses locks
|
// DXE core uses this callback for the EFI timer tick. The DXE core uses locks
|
||||||
|
|
||||||
// that raise to TPL_HIGH and then restore back to current level. Thus we need
|
// that raise to TPL_HIGH and then restore back to current level. Thus we need
|
||||||
|
|
||||||
// to make sure TPL level is set to TPL_HIGH while we are handling the timer tick.
|
// to make sure TPL level is set to TPL_HIGH while we are handling the timer tick.
|
||||||
|
|
||||||
//
|
//
|
||||||
|
|
||||||
OriginalTPL = gBS->RaiseTPL (TPL_HIGH_LEVEL);
|
OriginalTPL = gBS->RaiseTPL (TPL_HIGH_LEVEL);
|
||||||
|
|
||||||
|
|
||||||
@ -115,63 +104,33 @@ TimerInterruptHandler (
|
|||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
|
||||||
This function registers the handler NotifyFunction so it is called every time
|
This function registers the handler NotifyFunction so it is called every time
|
||||||
|
|
||||||
the timer interrupt fires. It also passes the amount of time since the last
|
the timer interrupt fires. It also passes the amount of time since the last
|
||||||
|
|
||||||
handler call to the NotifyFunction. If NotifyFunction is NULL, then the
|
handler call to the NotifyFunction. If NotifyFunction is NULL, then the
|
||||||
|
|
||||||
handler is unregistered. If the handler is registered, then EFI_SUCCESS is
|
handler is unregistered. If the handler is registered, then EFI_SUCCESS is
|
||||||
|
|
||||||
returned. If the CPU does not support registering a timer interrupt handler,
|
returned. If the CPU does not support registering a timer interrupt handler,
|
||||||
|
|
||||||
then EFI_UNSUPPORTED is returned. If an attempt is made to register a handler
|
then EFI_UNSUPPORTED is returned. If an attempt is made to register a handler
|
||||||
|
|
||||||
when a handler is already registered, then EFI_ALREADY_STARTED is returned.
|
when a handler is already registered, then EFI_ALREADY_STARTED is returned.
|
||||||
|
|
||||||
If an attempt is made to unregister a handler when a handler is not registered,
|
If an attempt is made to unregister a handler when a handler is not registered,
|
||||||
|
|
||||||
then EFI_INVALID_PARAMETER is returned. If an error occurs attempting to
|
then EFI_INVALID_PARAMETER is returned. If an error occurs attempting to
|
||||||
|
|
||||||
register the NotifyFunction with the timer interrupt, then EFI_DEVICE_ERROR
|
register the NotifyFunction with the timer interrupt, then EFI_DEVICE_ERROR
|
||||||
|
|
||||||
is returned.
|
is returned.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
@param This The EFI_TIMER_ARCH_PROTOCOL instance.
|
@param This The EFI_TIMER_ARCH_PROTOCOL instance.
|
||||||
|
|
||||||
@param NotifyFunction The function to call when a timer interrupt fires. This
|
@param NotifyFunction The function to call when a timer interrupt fires. This
|
||||||
|
|
||||||
function executes at TPL_HIGH_LEVEL. The DXE Core will
|
function executes at TPL_HIGH_LEVEL. The DXE Core will
|
||||||
|
|
||||||
register a handler for the timer interrupt, so it can know
|
register a handler for the timer interrupt, so it can know
|
||||||
|
|
||||||
how much time has passed. This information is used to
|
how much time has passed. This information is used to
|
||||||
|
|
||||||
signal timer based events. NULL will unregister the handler.
|
signal timer based events. NULL will unregister the handler.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
@retval EFI_SUCCESS The timer handler was registered.
|
@retval EFI_SUCCESS The timer handler was registered.
|
||||||
|
|
||||||
@retval EFI_UNSUPPORTED The platform does not support timer interrupts.
|
@retval EFI_UNSUPPORTED The platform does not support timer interrupts.
|
||||||
|
|
||||||
@retval EFI_ALREADY_STARTED NotifyFunction is not NULL, and a handler is already
|
@retval EFI_ALREADY_STARTED NotifyFunction is not NULL, and a handler is already
|
||||||
|
|
||||||
registered.
|
registered.
|
||||||
|
|
||||||
@retval EFI_INVALID_PARAMETER NotifyFunction is NULL, and a handler was not
|
@retval EFI_INVALID_PARAMETER NotifyFunction is NULL, and a handler was not
|
||||||
|
|
||||||
previously registered.
|
previously registered.
|
||||||
|
|
||||||
@retval EFI_DEVICE_ERROR The timer handler could not be registered.
|
@retval EFI_DEVICE_ERROR The timer handler could not be registered.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
**/
|
**/
|
||||||
|
|
||||||
EFI_STATUS
|
EFI_STATUS
|
||||||
EFIAPI
|
EFIAPI
|
||||||
TimerDriverRegisterHandler (
|
TimerDriverRegisterHandler (
|
||||||
@ -195,53 +154,30 @@ TimerDriverRegisterHandler (
|
|||||||
/**
|
/**
|
||||||
|
|
||||||
This function adjusts the period of timer interrupts to the value specified
|
This function adjusts the period of timer interrupts to the value specified
|
||||||
|
|
||||||
by TimerPeriod. If the timer period is updated, then the selected timer
|
by TimerPeriod. If the timer period is updated, then the selected timer
|
||||||
|
|
||||||
period is stored in EFI_TIMER.TimerPeriod, and EFI_SUCCESS is returned. If
|
period is stored in EFI_TIMER.TimerPeriod, and EFI_SUCCESS is returned. If
|
||||||
|
|
||||||
the timer hardware is not programmable, then EFI_UNSUPPORTED is returned.
|
the timer hardware is not programmable, then EFI_UNSUPPORTED is returned.
|
||||||
|
|
||||||
If an error occurs while attempting to update the timer period, then the
|
If an error occurs while attempting to update the timer period, then the
|
||||||
|
|
||||||
timer hardware will be put back in its state prior to this call, and
|
timer hardware will be put back in its state prior to this call, and
|
||||||
|
|
||||||
EFI_DEVICE_ERROR is returned. If TimerPeriod is 0, then the timer interrupt
|
EFI_DEVICE_ERROR is returned. If TimerPeriod is 0, then the timer interrupt
|
||||||
|
|
||||||
is disabled. This is not the same as disabling the CPU's interrupts.
|
is disabled. This is not the same as disabling the CPU's interrupts.
|
||||||
|
|
||||||
Instead, it must either turn off the timer hardware, or it must adjust the
|
Instead, it must either turn off the timer hardware, or it must adjust the
|
||||||
|
|
||||||
interrupt controller so that a CPU interrupt is not generated when the timer
|
interrupt controller so that a CPU interrupt is not generated when the timer
|
||||||
|
|
||||||
interrupt fires.
|
interrupt fires.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
@param This The EFI_TIMER_ARCH_PROTOCOL instance.
|
@param This The EFI_TIMER_ARCH_PROTOCOL instance.
|
||||||
|
|
||||||
@param TimerPeriod The rate to program the timer interrupt in 100 nS units. If
|
@param TimerPeriod The rate to program the timer interrupt in 100 nS units. If
|
||||||
|
|
||||||
the timer hardware is not programmable, then EFI_UNSUPPORTED is
|
the timer hardware is not programmable, then EFI_UNSUPPORTED is
|
||||||
|
|
||||||
returned. If the timer is programmable, then the timer period
|
returned. If the timer is programmable, then the timer period
|
||||||
|
|
||||||
will be rounded up to the nearest timer period that is supported
|
will be rounded up to the nearest timer period that is supported
|
||||||
|
|
||||||
by the timer hardware. If TimerPeriod is set to 0, then the
|
by the timer hardware. If TimerPeriod is set to 0, then the
|
||||||
|
|
||||||
timer interrupts will be disabled.
|
timer interrupts will be disabled.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
@retval EFI_SUCCESS The timer period was changed.
|
@retval EFI_SUCCESS The timer period was changed.
|
||||||
|
|
||||||
@retval EFI_UNSUPPORTED The platform cannot change the period of the timer interrupt.
|
@retval EFI_UNSUPPORTED The platform cannot change the period of the timer interrupt.
|
||||||
|
|
||||||
@retval EFI_DEVICE_ERROR The timer period could not be changed due to a device error.
|
@retval EFI_DEVICE_ERROR The timer period could not be changed due to a device error.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
**/
|
**/
|
||||||
EFI_STATUS
|
EFI_STATUS
|
||||||
EFIAPI
|
EFIAPI
|
||||||
@ -286,31 +222,19 @@ TimerDriverSetTimerPeriod (
|
|||||||
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
|
||||||
This function retrieves the period of timer interrupts in 100 ns units,
|
This function retrieves the period of timer interrupts in 100 ns units,
|
||||||
|
|
||||||
returns that value in TimerPeriod, and returns EFI_SUCCESS. If TimerPeriod
|
returns that value in TimerPeriod, and returns EFI_SUCCESS. If TimerPeriod
|
||||||
|
|
||||||
is NULL, then EFI_INVALID_PARAMETER is returned. If a TimerPeriod of 0 is
|
is NULL, then EFI_INVALID_PARAMETER is returned. If a TimerPeriod of 0 is
|
||||||
|
|
||||||
returned, then the timer is currently disabled.
|
returned, then the timer is currently disabled.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
@param This The EFI_TIMER_ARCH_PROTOCOL instance.
|
@param This The EFI_TIMER_ARCH_PROTOCOL instance.
|
||||||
|
|
||||||
@param TimerPeriod A pointer to the timer period to retrieve in 100 ns units. If
|
@param TimerPeriod A pointer to the timer period to retrieve in 100 ns units. If
|
||||||
|
|
||||||
0 is returned, then the timer is currently disabled.
|
0 is returned, then the timer is currently disabled.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
@retval EFI_SUCCESS The timer period was returned in TimerPeriod.
|
@retval EFI_SUCCESS The timer period was returned in TimerPeriod.
|
||||||
|
|
||||||
@retval EFI_INVALID_PARAMETER TimerPeriod is NULL.
|
@retval EFI_INVALID_PARAMETER TimerPeriod is NULL.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
**/
|
**/
|
||||||
EFI_STATUS
|
EFI_STATUS
|
||||||
EFIAPI
|
EFIAPI
|
||||||
@ -328,33 +252,19 @@ TimerDriverGetTimerPeriod (
|
|||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
|
||||||
This function generates a soft timer interrupt. If the platform does not support soft
|
This function generates a soft timer interrupt. If the platform does not support soft
|
||||||
|
|
||||||
timer interrupts, then EFI_UNSUPPORTED is returned. Otherwise, EFI_SUCCESS is returned.
|
timer interrupts, then EFI_UNSUPPORTED is returned. Otherwise, EFI_SUCCESS is returned.
|
||||||
|
|
||||||
If a handler has been registered through the EFI_TIMER_ARCH_PROTOCOL.RegisterHandler()
|
If a handler has been registered through the EFI_TIMER_ARCH_PROTOCOL.RegisterHandler()
|
||||||
|
|
||||||
service, then a soft timer interrupt will be generated. If the timer interrupt is
|
service, then a soft timer interrupt will be generated. If the timer interrupt is
|
||||||
|
|
||||||
enabled when this service is called, then the registered handler will be invoked. The
|
enabled when this service is called, then the registered handler will be invoked. The
|
||||||
|
|
||||||
registered handler should not be able to distinguish a hardware-generated timer
|
registered handler should not be able to distinguish a hardware-generated timer
|
||||||
|
|
||||||
interrupt from a software-generated timer interrupt.
|
interrupt from a software-generated timer interrupt.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
@param This The EFI_TIMER_ARCH_PROTOCOL instance.
|
@param This The EFI_TIMER_ARCH_PROTOCOL instance.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
@retval EFI_SUCCESS The soft timer interrupt was generated.
|
@retval EFI_SUCCESS The soft timer interrupt was generated.
|
||||||
|
|
||||||
@retval EFI_UNSUPPORTED The platform does not support the generation of soft timer interrupts.
|
@retval EFI_UNSUPPORTED The platform does not support the generation of soft timer interrupts.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
**/
|
**/
|
||||||
EFI_STATUS
|
EFI_STATUS
|
||||||
EFIAPI
|
EFIAPI
|
||||||
@ -388,71 +298,38 @@ TimerDriverRegisterPeriodicCallback (
|
|||||||
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
|
||||||
Interface stucture for the Timer Architectural Protocol.
|
Interface stucture for the Timer Architectural Protocol.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
@par Protocol Description:
|
@par Protocol Description:
|
||||||
|
|
||||||
This protocol provides the services to initialize a periodic timer
|
This protocol provides the services to initialize a periodic timer
|
||||||
|
|
||||||
interrupt, and to register a handler that is called each time the timer
|
interrupt, and to register a handler that is called each time the timer
|
||||||
|
|
||||||
interrupt fires. It may also provide a service to adjust the rate of the
|
interrupt fires. It may also provide a service to adjust the rate of the
|
||||||
|
|
||||||
periodic timer interrupt. When a timer interrupt occurs, the handler is
|
periodic timer interrupt. When a timer interrupt occurs, the handler is
|
||||||
|
|
||||||
passed the amount of time that has passed since the previous timer
|
passed the amount of time that has passed since the previous timer
|
||||||
|
|
||||||
interrupt.
|
interrupt.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
@param RegisterHandler
|
@param RegisterHandler
|
||||||
|
|
||||||
Registers a handler that will be called each time the
|
Registers a handler that will be called each time the
|
||||||
|
|
||||||
timer interrupt fires. TimerPeriod defines the minimum
|
timer interrupt fires. TimerPeriod defines the minimum
|
||||||
|
|
||||||
time between timer interrupts, so TimerPeriod will also
|
time between timer interrupts, so TimerPeriod will also
|
||||||
|
|
||||||
be the minimum time between calls to the registered
|
be the minimum time between calls to the registered
|
||||||
|
|
||||||
handler.
|
handler.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
@param SetTimerPeriod
|
@param SetTimerPeriod
|
||||||
|
|
||||||
Sets the period of the timer interrupt in 100 nS units.
|
Sets the period of the timer interrupt in 100 nS units.
|
||||||
|
|
||||||
This function is optional, and may return EFI_UNSUPPORTED.
|
This function is optional, and may return EFI_UNSUPPORTED.
|
||||||
|
|
||||||
If this function is supported, then the timer period will
|
If this function is supported, then the timer period will
|
||||||
|
|
||||||
be rounded up to the nearest supported timer period.
|
be rounded up to the nearest supported timer period.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
@param GetTimerPeriod
|
@param GetTimerPeriod
|
||||||
|
|
||||||
Retrieves the period of the timer interrupt in 100 nS units.
|
Retrieves the period of the timer interrupt in 100 nS units.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
@param GenerateSoftInterrupt
|
@param GenerateSoftInterrupt
|
||||||
|
|
||||||
Generates a soft timer interrupt that simulates the firing of
|
Generates a soft timer interrupt that simulates the firing of
|
||||||
|
the timer interrupt. This service can be used to invoke the registered handler if the timer interrupt has been masked for
|
||||||
the timer interrupt. This service can be used to invoke the
|
|
||||||
|
|
||||||
registered handler if the timer interrupt has been masked for
|
|
||||||
|
|
||||||
a period of time.
|
a period of time.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
**/
|
**/
|
||||||
EFI_TIMER_ARCH_PROTOCOL gTimer = {
|
EFI_TIMER_ARCH_PROTOCOL gTimer = {
|
||||||
TimerDriverRegisterHandler,
|
TimerDriverRegisterHandler,
|
||||||
@ -467,29 +344,17 @@ TIMER_DEBUG_SUPPORT_PROTOCOL gTimerDebugSupport = {
|
|||||||
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
|
||||||
Initialize the state information for the Timer Architectural Protocol and
|
Initialize the state information for the Timer Architectural Protocol and
|
||||||
|
|
||||||
the Timer Debug support protocol that allows the debugger to break into a
|
the Timer Debug support protocol that allows the debugger to break into a
|
||||||
|
|
||||||
running program.
|
running program.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
@param ImageHandle of the loaded driver
|
@param ImageHandle of the loaded driver
|
||||||
|
|
||||||
@param SystemTable Pointer to the System Table
|
@param SystemTable Pointer to the System Table
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
@retval EFI_SUCCESS Protocol registered
|
@retval EFI_SUCCESS Protocol registered
|
||||||
|
|
||||||
@retval EFI_OUT_OF_RESOURCES Cannot allocate protocol data structure
|
@retval EFI_OUT_OF_RESOURCES Cannot allocate protocol data structure
|
||||||
|
|
||||||
@retval EFI_DEVICE_ERROR Hardware problems
|
@retval EFI_DEVICE_ERROR Hardware problems
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
**/
|
**/
|
||||||
EFI_STATUS
|
EFI_STATUS
|
||||||
EFIAPI
|
EFIAPI
|
||||||
|
Loading…
x
Reference in New Issue
Block a user