Adding support for BeagleBoard.

ArmPkg - Supoprt for ARM specific things that can change as the architecture changes. Plus semihosting JTAG drivers.
EmbeddedPkg - Generic support for an embeddded platform. Including a light weight command line shell.
BeagleBoardPkg - Platform specifics for BeagleBoard. SD Card works, but USB has issues. Looks like a bug in the open source USB stack (Our internal stack works fine).


git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@9518 6f19259b-4bc3-4df7-8a09-765794883524

1 files changed, 151 insertions, 0 deletions

diff --git a/EmbeddedPkg/Include/Protocol/HardwareInterrupt.h b/EmbeddedPkg/Include/Protocol/HardwareInterrupt.h
new file mode 100644
index 0000000000..a4825832c4
--- /dev/null
+++ b/EmbeddedPkg/Include/Protocol/HardwareInterrupt.h
@@ -0,0 +1,151 @@
+/** @file

+  Abstraction for hardware based interrupt routine

+  

+  On non IA-32 systems it is common to have a single hardware interrupt vector

+  and a 2nd layer of software that routes the interrupt handlers based on the

+  interrupt source. This protocol enables this routing. The driver implementing 

+  this protocol is responsible for clearing the pending interrupt in the 

+  interrupt routing hardware. The HARDWARE_INTERRUPT_HANDLER is responsible 

+  for clearing interrupt sources from individual devices.

+

+

+  Copyright (c) 2008-2009 Apple Inc. All rights reserved.<BR>

+

+  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.

+

+**/

+

+#ifndef __HARDWARE_INTERRUPT_H__

+#define __HARDWARE_INTERRUPT_H__

+

+#include <Protocol/DebugSupport.h>

+

+

+//

+// Protocol GUID

+//

+// EAB39028-3D05-4316-AD0C-D64808DA3FF1

+

+#define EFI_HARDWARE_INTERRUPT_PROTOCOL_GGUID \

+  { 0x2890B3EA, 0x053D, 0x1643, { 0xAD, 0x0C, 0xD6, 0x48, 0x08, 0xDA, 0x3F, 0xF1 } }

+

+

+typedef struct _EFI_HARDWARE_INTERRUPT_PROTOCOL EFI_HARDWARE_INTERRUPT_PROTOCOL;

+

+

+typedef UINTN HARDWARE_INTERRUPT_SOURCE;

+

+

+/**

+  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

+                        what source means.

+  @param SystemContext  Pointer to system register context. Mostly used by debuggers and will

+                        update the system context after the return from the interrupt if 

+                        modified. Don't change these values unless you know what you are doing

+

+**/

+typedef

+VOID

+(EFIAPI *HARDWARE_INTERRUPT_HANDLER) (

+  IN  HARDWARE_INTERRUPT_SOURCE   Source,

+  IN  EFI_SYSTEM_CONTEXT          SystemContext     

+  );

+

+

+/**

+  Register Handler for the specified interrupt source.

+

+  @param This     Instance pointer for this protocol

+  @param Source   Hardware source of the interrupt

+  @param Handler  Callback for interrupt. NULL to unregister

+

+  @retval EFI_SUCCESS Source was updated to support Handler.

+  @retval EFI_DEVICE_ERROR  Hardware could not be programmed.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *HARDWARE_INTERRUPT_REGISTER) (

+  IN EFI_HARDWARE_INTERRUPT_PROTOCOL    *This,

+  IN HARDWARE_INTERRUPT_SOURCE          Source,

+  IN HARDWARE_INTERRUPT_HANDLER         Handler

+  );

+

+

+/**

+  Enable interrupt source Source.

+

+  @param This     Instance pointer for this protocol

+  @param Source   Hardware source of the interrupt

+

+  @retval EFI_SUCCESS       Source interrupt enabled.

+  @retval EFI_DEVICE_ERROR  Hardware could not be programmed.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *HARDWARE_INTERRUPT_ENABLE) (

+  IN EFI_HARDWARE_INTERRUPT_PROTOCOL    *This,

+  IN HARDWARE_INTERRUPT_SOURCE          Source

+  );

+

+

+

+/**

+  Disable interrupt source Source.

+

+  @param This     Instance pointer for this protocol

+  @param Source   Hardware source of the interrupt

+

+  @retval EFI_SUCCESS       Source interrupt disabled.

+  @retval EFI_DEVICE_ERROR  Hardware could not be programmed.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *HARDWARE_INTERRUPT_DISABLE) (

+  IN EFI_HARDWARE_INTERRUPT_PROTOCOL    *This,

+  IN HARDWARE_INTERRUPT_SOURCE          Source

+  );

+

+

+/**

+  Return current state of interrupt source Source.

+

+  @param This     Instance pointer for this protocol

+  @param Source   Hardware source of the interrupt

+  @param InterruptState  TRUE: source enabled, FALSE: source disabled.

+

+  @retval EFI_SUCCESS       InterruptState is valid

+  @retval EFI_DEVICE_ERROR  InterruptState is not valid

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *HARDWARE_INTERRUPT_INTERRUPT_STATE) (

+  IN EFI_HARDWARE_INTERRUPT_PROTOCOL    *This,

+  IN HARDWARE_INTERRUPT_SOURCE          Source,

+  IN BOOLEAN                            *InterruptState

+  );

+

+

+struct _EFI_HARDWARE_INTERRUPT_PROTOCOL {

+  HARDWARE_INTERRUPT_REGISTER         RegisterInterruptSource;

+  HARDWARE_INTERRUPT_ENABLE           EnableInterruptSource;

+  HARDWARE_INTERRUPT_DISABLE          DisableInterruptSource;

+  HARDWARE_INTERRUPT_INTERRUPT_STATE  GetInterruptSourceState;

+};

+

+extern EFI_GUID gHardwareInterruptProtocolGuid;

+

+#endif

+

+