DebugAgent.h

Go to the documentation of this file.

 
#ifndef _DEBUG_AGENT_H_
#define _DEBUG_AGENT_H_
 
#include <Register/LocalApic.h>
#include <Guid/DebugAgentGuid.h>
#include <Guid/VectorHandoffTable.h>
#include <Ppi/VectorHandoffInfo.h>
#include <Library/BaseLib.h>
#include <Library/BaseMemoryLib.h>
#include <Library/ResetSystemLib.h>
#include <Library/IoLib.h>
#include <Library/HobLib.h>
#include <Library/DebugCommunicationLib.h>
#include <Library/DebugAgentLib.h>
#include <Library/PcdLib.h>
#include <Library/SynchronizationLib.h>
#include <Library/LocalApicLib.h>
#include <Library/DebugLib.h>
#include <Library/TimerLib.h>
#include <Library/PrintLib.h>
#include <Library/PeCoffGetEntryPointLib.h>
#include <Library/PeCoffExtraActionLib.h>
#include <Register/ArchitecturalMsr.h>
 
#include <TransferProtocol.h>
#include <ImageDebugSupport.h>
 
#include "DebugMp.h"
#include "DebugTimer.h"
#include "ArchDebugSupport.h"
#include "DebugException.h"
 
//
// These macros may be already defined in DebugAgentLib.h
//
#define DEBUG_AGENT_INIT_PEI                  9
#define DEBUG_AGENT_INIT_DXE_LOAD             10
#define DEBUG_AGENT_INIT_DXE_UNLOAD           11
#define DEBUG_AGENT_INIT_THUNK_PEI_IA32TOX64  12
 
#define DEBUG_INT1_VECTOR     DEBUG_EXCEPT_DEBUG
#define DEBUG_INT3_VECTOR     DEBUG_EXCEPT_BREAKPOINT
#define DEBUG_TIMER_VECTOR    32
#define DEBUG_MAILBOX_VECTOR  33
 
//
//  Timeout value for reading packet (unit is microsecond)
//
#define READ_PACKET_TIMEOUT   (500 * 1000)
#define DEBUG_TIMER_INTERVAL  (100 * 1000)
 
#define SOFT_INTERRUPT_SIGNATURE  SIGNATURE_32('S','O','F','T')
#define SYSTEM_RESET_SIGNATURE    SIGNATURE_32('S','Y','S','R')
#define MEMORY_READY_SIGNATURE    SIGNATURE_32('M','E','M','R')
 
extern UINTN                    Exception0Handle;
extern UINTN                    TimerInterruptHandle;
extern UINT32                   ExceptionStubHeaderSize;
extern BOOLEAN                  mSkipBreakpoint;
extern EFI_VECTOR_HANDOFF_INFO  mVectorHandoffInfoDebugAgent[];
extern UINTN                    mVectorHandoffInfoCount;
 
//
// CPU exception information issued by debug agent
//
typedef struct {
  //
  // This field is used to save CPU content before executing HOST command
  //
  BASE_LIBRARY_JUMP_BUFFER             JumpBuffer;
  //
  // This field returns the exception information issued by the HOST command
  //
  DEBUG_DATA_RESPONSE_GET_EXCEPTION    ExceptionContent;
} DEBUG_AGENT_EXCEPTION_BUFFER;
 
#define DEBUG_AGENT_FLAG_HOST_ATTACHED         BIT0
#define DEBUG_AGENT_FLAG_AGENT_IN_PROGRESS     BIT1
#define DEBUG_AGENT_FLAG_MEMORY_READY          BIT2
#define DEBUG_AGENT_FLAG_STEPPING              BIT3
#define DEBUG_AGENT_FLAG_CHECK_MAILBOX_IN_HOB  BIT4
#define DEBUG_AGENT_FLAG_INIT_ARCH             BIT5|BIT6
#define DEBUG_AGENT_FLAG_INTERRUPT_FLAG        BIT7
#define DEBUG_AGENT_FLAG_BREAK_ON_NEXT_SMI     BIT32
#define DEBUG_AGENT_FLAG_PRINT_ERROR_LEVEL     (BIT33|BIT34|BIT35|BIT36)
#define DEBUG_AGENT_FLAG_BREAK_BOOT_SCRIPT     BIT37
 
#define DEBUG_MAILBOX_DEBUG_FLAG_INDEX                1
#define DEBUG_MAILBOX_DEBUG_PORT_HANDLE_INDEX         2
#define DEBUG_MAILBOX_EXCEPTION_BUFFER_POINTER_INDEX  3
#define DEBUG_MAILBOX_LAST_ACK                        4
#define DEBUG_MAILBOX_SEQUENCE_NO_INDEX               5
#define DEBUG_MAILBOX_HOST_SEQUENCE_NO_INDEX          6
#define DEBUG_MAILBOX_DEBUG_TIMER_FREQUENCY           7
 
#pragma pack(1)
typedef union {
  struct {
    //
    // Lower 32 bits to store the status of DebugAgent
    //
    UINT32    HostAttached      : 1; // 1: HOST is attached
    UINT32    AgentInProgress   : 1; // 1: Debug Agent is communicating with HOST
    UINT32    MemoryReady       : 1; // 1: Memory is ready
    UINT32    SteppingFlag      : 1; // 1: Agent is running stepping command
    UINT32    CheckMailboxInHob : 1; // 1: Need to check mailbox saved in HOB
    UINT32    InitArch          : 2; // value of DEBUG_DATA_RESPONSE_ARCH_MODE
    UINT32    InterruptFlag     : 1; // 1: EFLAGS.IF is set
    UINT32    Reserved1         : 24;
    //
    // Higher 32bits to control the behavior of DebugAgent
    //
    UINT32    BreakOnNextSmi    : 1; // 1: Break on next SMI
    UINT32    PrintErrorLevel   : 4; // Bitmask of print error level for debug message
    UINT32    BreakOnBootScript : 1; // 1: Break before executing boot script
    UINT32    Reserved2         : 26;
  } Bits;
  UINT64    Uint64;
} DEBUG_AGENT_FLAG;
 
typedef struct {
  DEBUG_AGENT_FLAG    DebugFlag;
  UINT64              DebugPortHandle;
  //
  // Pointer to DEBUG_AGENT_EXCEPTION_BUFFER
  //
  UINT64              ExceptionBufferPointer;
  UINT8               LastAck;             // The last ack packet type
  UINT8               SequenceNo;
  UINT8               HostSequenceNo;
  UINT32              DebugTimerFrequency;
  UINT8               CheckSum;            // Mailbox checksum
  UINT8               ToBeCheckSum;        // To be Mailbox checksum at the next
} DEBUG_AGENT_MAILBOX;
#pragma pack()
 
typedef union {
  struct {
    UINT32    OffsetLow  : 16; 
    UINT32    Selector   : 16; 
    UINT32    Reserved_0 : 8;  
    UINT32    GateType   : 8;  
    UINT32    OffsetHigh : 16; 
  } Bits;
  UINT64    Uint64;
} IA32_IDT_ENTRY;
 
typedef union {
  struct {
    UINT32    LimitLow    : 16;
    UINT32    BaseLow     : 16;
    UINT32    BaseMid     : 8;
    UINT32    Type        : 4;
    UINT32    System      : 1;
    UINT32    Dpl         : 2;
    UINT32    Present     : 1;
    UINT32    LimitHigh   : 4;
    UINT32    Software    : 1;
    UINT32    Reserved    : 1;
    UINT32    DefaultSize : 1;
    UINT32    Granularity : 1;
    UINT32    BaseHigh    : 8;
  } Bits;
  UINT64    Uint64;
} IA32_GDT;
 
VOID
InitializeDebugIdt (
  VOID
  );
 
UINT8 *
ArchReadRegisterBuffer (
  IN DEBUG_CPU_CONTEXT  *CpuContext,
  IN UINT8              Index,
  IN UINT8              *Width
  );
 
RETURN_STATUS
SendDataResponsePacket (
  IN UINT8                    *Data,
  IN UINT16                   DataSize,
  IN OUT DEBUG_PACKET_HEADER  *DebugHeader
  );
 
BOOLEAN
IsHostAttached (
  VOID
  );
 
DEBUG_AGENT_MAILBOX *
GetMailboxPointer (
  VOID
  );
 
DEBUG_PORT_HANDLE
GetDebugPortHandle (
  VOID
  );
 
EFI_STATUS
DebugReadBreakSymbol (
  IN  DEBUG_PORT_HANDLE  Handle,
  OUT UINT8              *BreakSymbol
  );
 
VOID
EFIAPI
DebugAgentMsgPrint (
  IN UINT8  ErrorLevel,
  IN CHAR8  *Format,
  ...
  );
 
VOID
TriggerSoftInterrupt (
  IN UINT32  Signature
  );
 
BOOLEAN
MultiProcessorDebugSupport (
  VOID
  );
 
VOID
FindAndReportModuleImageInfo (
  IN UINTN  AlignSize
  );
 
BOOLEAN
IsDebugAgentInitialzed (
  VOID
  );
 
VOID
UpdateMailboxChecksum (
  IN DEBUG_AGENT_MAILBOX  *Mailbox
  );
 
VOID
VerifyMailboxChecksum (
  IN DEBUG_AGENT_MAILBOX  *Mailbox
  );
 
VOID
SetDebugFlag (
  IN UINT64  FlagMask,
  IN UINT32  FlagValue
  );
 
UINT32
GetDebugFlag (
  IN UINT64  FlagMask
  );
 
VOID
UpdateMailboxContent (
  IN DEBUG_AGENT_MAILBOX  *Mailbox,
  IN UINTN                Index,
  IN UINT64               Value
  );
 
VOID *
GetExceptionHandlerInIdtEntry (
  IN UINTN  ExceptionNum
  );
 
VOID
SetExceptionHandlerInIdtEntry (
  IN UINTN  ExceptionNum,
  IN VOID   *ExceptionHandler
  );
 
VOID
EFIAPI
DebugAgentDataMsgPrint (
  IN UINT8    ErrorLevel,
  IN BOOLEAN  IsSend,
  IN UINT8    *Data,
  IN UINT8    Length
  );
 
EFI_STATUS
ReadRemainingBreakPacket (
  IN     DEBUG_PORT_HANDLE    Handle,
  IN OUT DEBUG_PACKET_HEADER  *DebugHeader
  );
 
UINTN
DebugAgentReadBuffer (
  IN     DEBUG_PORT_HANDLE  Handle,
  IN OUT UINT8              *Buffer,
  IN     UINTN              NumberOfBytes,
  IN     UINTN              Timeout
  );
 
#endif