SourceLevelDebugPkg: Move to new location

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Guo Mang <mang.guo@intel.com>

4 files changed, 237 insertions, 0 deletions

diff --git a/Core/SourceLevelDebugPkg/DebugAgentDxe/DebugAgentDxe.c b/Core/SourceLevelDebugPkg/DebugAgentDxe/DebugAgentDxe.c
new file mode 100644
index 0000000000..f5ae59fcb4
--- /dev/null
+++ b/Core/SourceLevelDebugPkg/DebugAgentDxe/DebugAgentDxe.c
@@ -0,0 +1,143 @@
+/** @file

+  Initialize Debug Agent in DXE by invoking Debug Agent Library.

+

+Copyright (c) 2013 - 2015, Intel Corporation. All rights reserved.<BR>

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

+

+**/

+

+#include <PiDxe.h>

+#include <Guid/EventGroup.h>

+#include <Library/UefiBootServicesTableLib.h>

+#include <Library/DebugAgentLib.h>

+#include <Library/UefiLib.h>

+

+EFI_EVENT       mExitBootServiceEvent; 

+

+/**

+  One notified function to disable Debug Timer interrupt when gBS->ExitBootServices() called.

+

+  @param[in]  Event              Pointer to this event

+  @param[in]  Context            Event handler private data

+

+**/

+VOID

+EFIAPI

+DisableDebugTimerExitBootService (

+  EFI_EVENT                      Event,

+  VOID                           *Context

+  )

+

+{

+  SaveAndSetDebugTimerInterrupt (FALSE);

+}

+

+/**

+  The Entry Point for Debug Agent Dxe driver.

+

+  It will invoke Debug Agent Library to enable source debugging feature in DXE phase.

+

+  @param[in] ImageHandle    The firmware allocated handle for the EFI image.

+  @param[in] SystemTable    A pointer to the EFI System Table.

+

+  @retval EFI_SUCCESS       The entry point is executed successfully.

+  @retval other             Some error occurs when initialzed Debug Agent.

+

+**/

+EFI_STATUS

+EFIAPI

+DebugAgentDxeInitialize(

+  IN EFI_HANDLE           ImageHandle,

+  IN EFI_SYSTEM_TABLE     *SystemTable

+  )

+{

+  EFI_STATUS      Status;

+

+  if (gST->ConOut != NULL) {

+    Print (L"If the Debug Port is serial port, please make sure this serial port isn't connected by");

+    Print (L" ISA Serial driver\r\n");

+    Print (L"You could do the following steps to disconnect the serial port:\r\n");

+    Print (L"1: Shell> drivers\r\n");

+    Print (L"   ...\r\n");

+    Print (L"   V  VERSION  E G G #D #C DRIVER NAME                         IMAGE NAME\r\n");

+    Print (L"   == ======== = = = == == =================================== ===================\r\n");

+    Print (L"   8F 0000000A B - -  1 14 PCI Bus Driver                      PciBusDxe\r\n");

+    Print (L"   91 00000010 ? - -  -  - ATA Bus Driver                      AtaBusDxe\r\n");

+    Print (L"   ...\r\n");

+    Print (L"   A7 0000000A B - -  1  1 ISA Serial Driver                   IsaSerialDxe\r\n");

+    Print (L"   ...\r\n");

+    Print (L"2: Shell> dh -d A7\r\n");

+    Print (L"   A7: Image(IsaSerialDxe) ImageDevPath (..9FB3-11D4-9A3A-0090273FC14D))DriverBinding");

+    Print (L" ComponentName ComponentName2\r\n");

+    Print (L"        Driver Name    : ISA Serial Driver\r\n");

+    Print (L"        Image Name     : FvFile(93B80003-9FB3-11D4-9A3A-0090273FC14D)\r\n");

+    Print (L"        Driver Version : 0000000A\r\n");

+    Print (L"        Driver Type    : BUS\r\n");

+    Print (L"        Configuration  : NO\r\n");

+    Print (L"        Diagnostics    : NO\r\n");

+    Print (L"        Managing       :\r\n");

+    Print (L"          Ctrl[EA] : PciRoot(0x0)/Pci(0x1F,0x0)/Serial(0x0)\r\n");

+    Print (L"            Child[EB] : PciRoot(0x0)/Pci(0x1F,0x0)/Serial(0x0)/Uart(115200,8,N,1)\r\n");

+    Print (L"3: Shell> disconnect EA\r\n");

+    Print (L"4: Shell> load -nc DebugAgentDxe.efi\r\n\r\n");

+  }

+  Status = EFI_UNSUPPORTED;

+  InitializeDebugAgent (DEBUG_AGENT_INIT_DXE_LOAD, &Status, NULL);

+  if (EFI_ERROR (Status)) {

+    return Status;

+  }

+  if (gST->ConOut != NULL) {

+    Print (L"Debug Agent: Initialized successfully!\r\n\r\n");

+  }

+  //

+  // Create event to disable Debug Timer interrupt when exit boot service.

+  //

+  Status = gBS->CreateEventEx (

+                  EVT_NOTIFY_SIGNAL,

+                  TPL_NOTIFY,

+                  DisableDebugTimerExitBootService,

+                  NULL,

+                  &gEfiEventExitBootServicesGuid,

+                  &mExitBootServiceEvent

+                  );

+  return Status;

+}

+

+/**

+  This is the unload handle for Debug Agent Dxe driver.

+

+  It will invoke Debug Agent Library to disable source debugging feature.

+

+  @param[in]  ImageHandle       The drivers' driver image.

+

+  @retval EFI_SUCCESS           The image is unloaded.

+  @retval Others                Failed to unload the image.

+

+**/

+EFI_STATUS

+EFIAPI

+DebugAgentDxeUnload (

+  IN EFI_HANDLE           ImageHandle

+  )

+{

+  EFI_STATUS          Status;

+

+  Status = EFI_UNSUPPORTED;

+  InitializeDebugAgent (DEBUG_AGENT_INIT_DXE_UNLOAD, &Status, NULL);

+  switch (Status) {

+  case EFI_ACCESS_DENIED:

+    Print (L"Debug Agent: Host is still connected, please de-attach TARGET firstly!\r\n");

+    break;

+  case EFI_NOT_STARTED:

+    Print (L"Debug Agent: It hasn't been initialized, cannot unload it!\r\n");

+    break;

+  }

+

+  return Status;

+}

diff --git a/Core/SourceLevelDebugPkg/DebugAgentDxe/DebugAgentDxe.inf b/Core/SourceLevelDebugPkg/DebugAgentDxe/DebugAgentDxe.inf
new file mode 100644
index 0000000000..7cd7a87126
--- /dev/null
+++ b/Core/SourceLevelDebugPkg/DebugAgentDxe/DebugAgentDxe.inf
@@ -0,0 +1,52 @@
+## @file

+#  Initialized Debug Agent in one separated DXE driver.

+#

+#  This DXE driver will invoke Debug Agent Library to initialize the debug agent.

+#

+# Copyright (c) 2013 - 2014, Intel Corporation. All rights reserved.<BR>

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

+#

+##

+

+[Defines]

+  INF_VERSION                    = 0x00010005

+  BASE_NAME                      = DebugAgentDxe

+  MODULE_UNI_FILE                = DebugAgentDxe.uni

+  FILE_GUID                      = 9727502C-034E-472b-8E1B-67BB28C6CFDB

+  MODULE_TYPE                    = DXE_DRIVER

+  VERSION_STRING                 = 1.0  

+  ENTRY_POINT                    = DebugAgentDxeInitialize

+  UNLOAD_IMAGE                   = DebugAgentDxeUnload

+

+#

+# The following information is for reference only and not required by the build tools.

+#

+#  VALID_ARCHITECTURES           = IA32 X64

+#

+

+[Sources]

+  DebugAgentDxe.c

+  

+[Packages]

+  MdePkg/MdePkg.dec

+  MdeModulePkg/MdeModulePkg.dec

+

+[LibraryClasses]

+  UefiDriverEntryPoint

+  UefiBootServicesTableLib

+  DebugAgentLib  

+

+[Guids]

+  gEfiEventExitBootServicesGuid                 ## SOMETIMES_CONSUMES ## Event

+

+[Depex]

+  TRUE

+

+[UserExtensions.TianoCore."ExtraFiles"]

+  DebugAgentDxeExtra.uni

diff --git a/Core/SourceLevelDebugPkg/DebugAgentDxe/DebugAgentDxe.uni b/Core/SourceLevelDebugPkg/DebugAgentDxe/DebugAgentDxe.uni
new file mode 100644
index 0000000000..35621a5f43
--- /dev/null
+++ b/Core/SourceLevelDebugPkg/DebugAgentDxe/DebugAgentDxe.uni
@@ -0,0 +1,22 @@
+// /** @file

+// Initialized Debug Agent in one separated DXE driver.

+//

+// This DXE driver will invoke Debug Agent Library to initialize the debug agent.

+//

+// Copyright (c) 2013 - 2014, Intel Corporation. All rights reserved.<BR>

+//

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

+//

+// **/

+

+

+#string STR_MODULE_ABSTRACT             #language en-US "Initialized Debug Agent in one separated DXE driver"

+

+#string STR_MODULE_DESCRIPTION          #language en-US "This DXE driver will invoke Debug Agent Library to initialize the debug agent."

+

diff --git a/Core/SourceLevelDebugPkg/DebugAgentDxe/DebugAgentDxeExtra.uni b/Core/SourceLevelDebugPkg/DebugAgentDxe/DebugAgentDxeExtra.uni
new file mode 100644
index 0000000000..2329b1d2c5
--- /dev/null
+++ b/Core/SourceLevelDebugPkg/DebugAgentDxe/DebugAgentDxeExtra.uni
@@ -0,0 +1,20 @@
+// /** @file

+// DebugAgentDxe Localized Strings and Content

+//

+// Copyright (c) 2013 - 2014, Intel Corporation. All rights reserved.<BR>

+//

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

+//

+// **/

+

+#string STR_PROPERTIES_MODULE_NAME 

+#language en-US 

+"Debug Agent DXE Driver"

+

+