4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Debug Agent library implementition for Dxe Core and Dxr modules.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Copyright (c) 2010, Intel Corporation. All rights reserved.<BR>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync This program and the accompanying materials
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync are licensed and made available under the terms and conditions of the BSD License
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync which accompanies this distribution. The full text of the license may be found at
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Constructor allocates the NVS memory to store Mailbox and install configuration table
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync in system table to store its pointer.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param[in] ImageHandle The firmware allocated handle for the EFI image.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param[in] SystemTable A pointer to the EFI System Table.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval RETURN_SUCCESS Allocate the global memory space to store guid and function tables.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval RETURN_OUT_OF_RESOURCES No enough memory to allocated.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync mMailboxPointer = (DEBUG_AGENT_MAILBOX *) (UINTN) Address;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return gBS->InstallConfigurationTable (&gEfiDebugAgentGuid, (VOID *) mMailboxPointer);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Get the pointer to Mailbox from the GUIDed HOB.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param[in] HobStart The starting HOB pointer to search from.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @return Pointer to Mailbox.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync GuidHob = GetNextGuidHob (&gEfiDebugAgentGuid, HobStart);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return (DEBUG_AGENT_MAILBOX *) (GET_GUID_HOB_DATA(GuidHob));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Get Debug Agent Mailbox pointer.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @return Mailbox pointer.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Get debug port handle.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @return Debug port handle.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return (DEBUG_PORT_HANDLE) (UINTN)(mMailboxPointer->DebugPortHandle);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Initialize debug agent.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync This function is used to set up debug enviroment for DXE phase.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync If this function is called by DXE Core, Context must be the pointer
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync to HOB list which will be used to get GUIDed HOB. It will enable
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync interrupt to support break-in feature.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync If this function is called by DXE module, Context must be NULL. It
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync will enable interrupt to support break-in feature.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param[in] InitFlag Init flag is used to decide initialize process.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param[in] Context Context needed according to InitFlag.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param[in] Function Continue function called by debug agent library; it was
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Save and disable original interrupt status
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Try to get Mailbox from GUIDed HOB.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // If it is in S3 path, needn't to install configuration table.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // If Mailbox exists, copy it into one global variable.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync CopyMem (&mMailbox, Mailbox, sizeof (DEBUG_AGENT_MAILBOX));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // If Mailbox not exists, used the local Mailbox.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Get original IDT address and size.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IdtEntryCount = (UINT16) ((Idtr.Limit + 1) / sizeof (IA32_IDT_GATE_DESCRIPTOR));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Idtr.Limit = (UINT16) (sizeof (IA32_IDT_GATE_DESCRIPTOR) * 33 - 1);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Initialize the IDT table entries to support source level debug.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Initialize debug communication port
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync mMailboxPointer->DebugPortHandle = (UINT64) (UINTN)DebugPortInitialize (NULL, NULL);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync InitializeSpinLock (&mDebugMpContext.MpContextSpinLock);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync InitializeSpinLock (&mDebugMpContext.DebugPortSpinLock);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Initialize Debug Timer hardware and enable interrupt.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Disable Debug Timer interrupt in S3 path.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Restore interrupt state.