3 Copyright (c) 2008-2009, Apple Inc. All rights reserved.
5 All rights reserved. This program and the accompanying materials
6 are licensed and made available under the terms and conditions of the BSD License
7 which accompanies this distribution. The full text of the license may be found at
8 http://opensource.org/licenses/bsd-license.php
10 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
11 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
19 ExceptionHandlersStart (
24 ExceptionHandlersEnd (
29 CommonExceptionEntry (
34 AsmCommonExceptionEntry (
39 EFI_EXCEPTION_CALLBACK gExceptionHandlers
[MAX_ARM_EXCEPTION
+ 1];
40 EFI_EXCEPTION_CALLBACK gDebuggerExceptionHandlers
[MAX_ARM_EXCEPTION
+ 1];
45 This function registers and enables the handler specified by InterruptHandler for a processor
46 interrupt or exception type specified by InterruptType. If InterruptHandler is NULL, then the
47 handler for the processor interrupt or exception type specified by InterruptType is uninstalled.
48 The installed handler is called once for each processor interrupt or exception.
50 @param InterruptType A pointer to the processor's current interrupt state. Set to TRUE if interrupts
51 are enabled and FALSE if interrupts are disabled.
52 @param InterruptHandler A pointer to a function of type EFI_CPU_INTERRUPT_HANDLER that is called
53 when a processor interrupt occurs. If this parameter is NULL, then the handler
56 @retval EFI_SUCCESS The handler for the processor interrupt was successfully installed or uninstalled.
57 @retval EFI_ALREADY_STARTED InterruptHandler is not NULL, and a handler for InterruptType was
59 @retval EFI_INVALID_PARAMETER InterruptHandler is NULL, and a handler for InterruptType was not
61 @retval EFI_UNSUPPORTED The interrupt specified by InterruptType is not supported.
65 RegisterInterruptHandler (
66 IN EFI_EXCEPTION_TYPE InterruptType
,
67 IN EFI_CPU_INTERRUPT_HANDLER InterruptHandler
70 if (InterruptType
> MAX_ARM_EXCEPTION
) {
71 return EFI_UNSUPPORTED
;
74 if ((InterruptHandler
!= NULL
) && (gExceptionHandlers
[InterruptType
] != NULL
)) {
75 return EFI_ALREADY_STARTED
;
78 gExceptionHandlers
[InterruptType
] = InterruptHandler
;
85 This function registers and enables the handler specified by InterruptHandler for a processor
86 interrupt or exception type specified by InterruptType. If InterruptHandler is NULL, then the
87 handler for the processor interrupt or exception type specified by InterruptType is uninstalled.
88 The installed handler is called once for each processor interrupt or exception.
90 @param InterruptType A pointer to the processor's current interrupt state. Set to TRUE if interrupts
91 are enabled and FALSE if interrupts are disabled.
92 @param InterruptHandler A pointer to a function of type EFI_CPU_INTERRUPT_HANDLER that is called
93 when a processor interrupt occurs. If this parameter is NULL, then the handler
96 @retval EFI_SUCCESS The handler for the processor interrupt was successfully installed or uninstalled.
97 @retval EFI_ALREADY_STARTED InterruptHandler is not NULL, and a handler for InterruptType was
99 @retval EFI_INVALID_PARAMETER InterruptHandler is NULL, and a handler for InterruptType was not
100 previously installed.
101 @retval EFI_UNSUPPORTED The interrupt specified by InterruptType is not supported.
105 RegisterDebuggerInterruptHandler (
106 IN EFI_EXCEPTION_TYPE InterruptType
,
107 IN EFI_CPU_INTERRUPT_HANDLER InterruptHandler
110 if (InterruptType
> MAX_ARM_EXCEPTION
) {
111 return EFI_UNSUPPORTED
;
114 if ((InterruptHandler
!= NULL
) && (gDebuggerExceptionHandlers
[InterruptType
] != NULL
)) {
115 return EFI_ALREADY_STARTED
;
118 gDebuggerExceptionHandlers
[InterruptType
] = InterruptHandler
;
127 CommonCExceptionHandler (
128 IN EFI_EXCEPTION_TYPE ExceptionType
,
129 IN OUT EFI_SYSTEM_CONTEXT SystemContext
132 BOOLEAN Dispatched
= FALSE
;
135 if (ExceptionType
<= MAX_ARM_EXCEPTION
) {
136 if (gDebuggerExceptionHandlers
[ExceptionType
]) {
138 // If DebugSupport hooked the interrupt call the handler. This does not disable
139 // the normal handler.
141 gDebuggerExceptionHandlers
[ExceptionType
] (ExceptionType
, SystemContext
);
144 if (gExceptionHandlers
[ExceptionType
]) {
145 gExceptionHandlers
[ExceptionType
] (ExceptionType
, SystemContext
);
149 DEBUG ((EFI_D_ERROR
, "Unknown exception type %d from %08x\n", ExceptionType
, SystemContext
.SystemContextArm
->PC
));
155 // We did work so this was an expected ExceptionType
160 if (ExceptionType
== EXCEPT_ARM_SOFTWARE_INTERRUPT
) {
162 // ARM JTAG debuggers some times use this vector, so it is not an error to get one
167 DefaultExceptionHandler (ExceptionType
, SystemContext
);
173 InitializeExceptions (
174 IN EFI_CPU_ARCH_PROTOCOL
*Cpu
182 EFI_PHYSICAL_ADDRESS Base
;
185 // Disable interrupts
187 Cpu
->GetInterruptState (Cpu
, &Enabled
);
188 Cpu
->DisableInterrupt (Cpu
);
191 // Initialize the C entry points for interrupts
193 for (Index
= 0; Index
<= MAX_ARM_EXCEPTION
; Index
++) {
194 Status
= RegisterInterruptHandler (Index
, NULL
);
195 ASSERT_EFI_ERROR (Status
);
197 Status
= RegisterDebuggerInterruptHandler (Index
, NULL
);
198 ASSERT_EFI_ERROR (Status
);
202 // Copy an implementation of the ARM exception vectors to PcdCpuVectorBaseAddress.
204 Length
= (UINTN
)ExceptionHandlersEnd
- (UINTN
)ExceptionHandlersStart
;
207 // Reserve space for the exception handlers
209 Base
= (EFI_PHYSICAL_ADDRESS
)PcdGet32 (PcdCpuVectorBaseAddress
);
210 Status
= gBS
->AllocatePages (AllocateAddress
, EfiBootServicesCode
, EFI_SIZE_TO_PAGES (Length
), &Base
);
211 // If the request was for memory that's not in the memory map (which is often the case for 0x00000000
212 // on embedded systems, for example, we don't want to hang up. So we'll check here for a status of
213 // EFI_NOT_FOUND, and continue in that case.
214 if (EFI_ERROR(Status
) && (Status
!= EFI_NOT_FOUND
)) {
215 ASSERT_EFI_ERROR (Status
);
218 CopyMem ((VOID
*)(UINTN
)PcdGet32 (PcdCpuVectorBaseAddress
), (VOID
*)ExceptionHandlersStart
, Length
);
221 // Patch in the common Assembly exception handler
223 Offset
= (UINTN
)CommonExceptionEntry
- (UINTN
)ExceptionHandlersStart
;
224 *(UINTN
*) ((UINT8
*)(UINTN
)PcdGet32 (PcdCpuVectorBaseAddress
) + Offset
) = (UINTN
)AsmCommonExceptionEntry
;
226 // Flush Caches since we updated executable stuff
227 InvalidateInstructionCacheRange ((VOID
*)PcdGet32(PcdCpuVectorBaseAddress
), Length
);
231 // Restore interrupt state
233 Status
= Cpu
->EnableInterrupt (Cpu
);