From c6ff7c547bfc71da9d5e71a73984b9d3a4ea0809 Mon Sep 17 00:00:00 2001 From: Guo Mang Date: Thu, 27 Apr 2017 11:21:47 +0800 Subject: SourceLevelDebugPkg: Move to new location Contributed-under: TianoCore Contribution Agreement 1.0 Signed-off-by: Guo Mang --- .../DebugAgentDxe/DebugAgentDxe.c | 143 +++++++++++++++++++++ .../DebugAgentDxe/DebugAgentDxe.inf | 52 ++++++++ .../DebugAgentDxe/DebugAgentDxe.uni | 22 ++++ .../DebugAgentDxe/DebugAgentDxeExtra.uni | 20 +++ 4 files changed, 237 insertions(+) create mode 100644 Core/SourceLevelDebugPkg/DebugAgentDxe/DebugAgentDxe.c create mode 100644 Core/SourceLevelDebugPkg/DebugAgentDxe/DebugAgentDxe.inf create mode 100644 Core/SourceLevelDebugPkg/DebugAgentDxe/DebugAgentDxe.uni create mode 100644 Core/SourceLevelDebugPkg/DebugAgentDxe/DebugAgentDxeExtra.uni (limited to 'Core/SourceLevelDebugPkg/DebugAgentDxe') 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.
+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 +#include +#include +#include +#include + +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.
+# 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.
+// +// 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.
+// +// 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" + + -- cgit v1.2.3