using System; using System.Collections.Generic; using System.Linq; using System.Text; using Cosmos.Compiler.Debug; using System.IO; using System.Threading; using System.Windows.Forms; namespace Cosmos.Debug.Common { public abstract class DebugConnector: IDisposable { public Action ConnectionLost; public Action CmdTrace; public Action CmdMethodContext; public Action CmdText; public Action CmdStarted; public Action OnDebugMsg; public Action CmdRegisters; public Action CmdFrame; public Action CmdStack; protected byte mCurrentMsgType; public abstract void WaitConnect(); protected AutoResetEvent mCmdWait = new AutoResetEvent(false); // private StreamWriter mDebugWriter = new StreamWriter(@"c:\dsdebug.txt", false) { AutoFlush = true }; protected void DoDebugMsg(string aMsg) { // mDebugWriter.WriteLine(aMsg); System.Diagnostics.Debug.WriteLine(aMsg); if (OnDebugMsg != null) { OnDebugMsg(aMsg); } } public abstract bool Connected { get; } protected void SendCommandData(byte aCmd, byte[] aData, bool aWait) { //System.Windows.Forms.MessageBox.Show(xSB.ToString()); // If not connected, we dont send anything. Things like BPs etc can be set before connected. // The debugger must resend these after the start command hits. // We dont queue them, as it would end up with a lot of overlapping ops, ie set and then remove. // We also dont check connected at caller, becuase its a lot of extra code. // So we just ignore any commands sent before ready, and its part of the contract // that the caller (Debugger) knows when the Start msg is received that it must // send over initializing information such as breakpoints. if (Connected) { lock (mSendCmdLock) { //var xSB = new StringBuilder(); //foreach(byte x in aBytes) { // xSB.AppendLine(x.ToString("X2")); //} //System.Windows.Forms.MessageBox.Show(xSB.ToString()); DoDebugMsg("DC Send: " + aCmd.ToString()); if (aCmd == DsCommand.Noop) { // Noops dont have any data. // This is becuase Noops are used to clear out the // channel and are often not received. Sending noop + data // usually causes the data to be interpreted as a command // as its often the first byte received. SendRawData(new byte[1] { DsCommand.Noop }); } else { var xData = new byte[aData.Length + 2]; // See comments about flow control in the DebugStub class // to see why we limit to 16. if (aData.Length > 16) { throw new Exception("Command is too large. 16 bytes max."); } xData[0] = (byte)aCmd; aData.CopyTo(xData, 2); if (mCommandID == 255) { mCommandID = 0; } else { mCommandID++; } xData[1] = mCommandID; mCurrCmdID = mCommandID; SendRawData(xData); if (aWait) { mCmdWait.WaitOne(); } } } } } protected abstract void SendRawData(byte[] aBytes); protected abstract void Next(int aPacketSize, Action aCompleted); protected byte mCommandID = 0; protected byte mCurrCmdID; // Prevent more than one command from happening at once. // The debugger is user driven so should not happen, but maybe could // happen while a previous command is waiting on a reply msg. protected object mSendCmdLock = new object(); public void SendCommand(byte aCmd) { SendCommandData(aCmd, new byte[0], true); } public void SendRegisters() { SendCommand(DsCommand.SendRegisters); } public void SendFrame() { SendCommand(DsCommand.SendFrame); } public void SendStack() { SendCommand(DsCommand.SendStack); } public void SetBreakpoint(int aID, uint aAddress) { // Not needed as SendCommand will do it, but it saves // some execution, but more importantly stops it from // logging messages to debug output for events that // dont happen. if (!Connected) { return; } if (aAddress == 0) { DoDebugMsg("DS Cmd: BP " + aID + " deleted"); } else { DoDebugMsg("DS Cmd: BP " + aID + " @ " + aAddress.ToString("X8").ToUpper()); } var xData = new byte[5]; Array.Copy(BitConverter.GetBytes(aAddress), 0, xData, 0, 4); xData[4] = (byte)aID; SendCommandData(DsCommand.BreakOnAddress, xData, true); } public byte[] GetMemoryData(uint address, uint size, int dataElementSize = 1) { // from debugstub: //// sends a stack value //// Serial Params: //// 1: x32 - offset relative to EBP //// 2: x32 - size of data to send if (!Connected) { return null; } if (size == 0) { // no point in retrieving 0 bytes, better not request at all. also, debugstub "crashes" then throw new NotSupportedException("Requested memory data of size = 0"); } if (size > 512) { // for now refuse to retrieve large amounts of data: throw new NotSupportedException("Too large amount of data requested"); } var xData = new byte[8]; mDataSize = (int)size; Array.Copy(BitConverter.GetBytes(address), 0, xData, 0, 4); Array.Copy(BitConverter.GetBytes(size), 0, xData, 4, 4); SendCommandData(DsCommand.SendMemory, xData, true); var xResult = mData; mData = null; if (xResult.Length != size) { throw new Exception("Retrieved a different size than requested!"); } return xResult; } public byte[] GetStackData(int offsetToEBP, uint size) { // from debugstub: //// sends a stack value //// Serial Params: //// 1: x32 - offset relative to EBP //// 2: x32 - size of data to send if (!Connected) { return null; } var xData = new byte[8]; mDataSize = (int)size; ////TODO find out wherefrom this discrepancy //offsetToEBP --; // EBP is first //offsetToEBP += 4; Array.Copy(BitConverter.GetBytes(offsetToEBP), 0, xData, 0, 4); Array.Copy(BitConverter.GetBytes(size), 0, xData, 4, 4); SendCommandData(DsCommand.SendMethodContext, xData, true); // todo: make "crossplatform". this code assumes stack space of 32bit per "item" byte[] xResult; xResult = mData; mData = null; return xResult; } private int mDataSize; private byte[] mData; public void DeleteBreakpoint(int aID) { SetBreakpoint(aID, 0); } protected UInt32 GetUInt32(byte[] aBytes, int aOffset) { return (UInt32)((aBytes[aOffset + 3] << 24) | (aBytes[aOffset + 2] << 16) | (aBytes[aOffset + 1] << 8) | aBytes[aOffset + 0]); } protected UInt16 GetUInt16(byte[] aBytes, int aOffset) { return (UInt16)((aBytes[aOffset + 1] << 8) | aBytes[aOffset + 0]); } protected void PacketMsg(byte[] aPacket) { mCurrentMsgType = aPacket[0]; // Could change to an array, but really not much benefit switch (mCurrentMsgType) { case DsMsgType.TracePoint: case DsMsgType.BreakPoint: DoDebugMsg("DC Recv: TracePoint / BreakPoint"); Next(4, PacketTracePoint); break; case DsMsgType.Message: DoDebugMsg("DC Recv: Message"); Next(2, PacketTextSize); break; case DsMsgType.Started: DoDebugMsg("DC Recv: Started"); // Call WaitForMessage first, else it blocks becuase started triggers // other commands which need responses. WaitForMessage(); // Guests never get the first byte sent. So we send a noop. // This dummy byte seems to clear out the serial channel. // Its never received, but if it ever is, its a noop anyways. SendCommand(DsCommand.Noop); // Send signature var xData = new byte[4]; Array.Copy(BitConverter.GetBytes(Cosmos.Compiler.Debug.Consts.SerialSignature), 0, xData, 0, 4); SendRawData(xData); CmdStarted(); break; case DsMsgType.Noop: DoDebugMsg("DC Recv: Noop"); // MtW: When implementing Serial support for debugging on real hardware, it appears // that when booting a machine, in the bios it emits zero's to the serial port. // Kudzu: Made a Noop command to handle this WaitForMessage(); break; case DsMsgType.CmdCompleted: DoDebugMsg("DC Recv: CmdCompleted"); Next(1, PacketCmdCompleted); break; case DsMsgType.MethodContext: DoDebugMsg("DC Recv: MethodContext"); Next(mDataSize, PacketMethodContext); break; case DsMsgType.MemoryData: DoDebugMsg("DC Recv: MemoryData"); Next(mDataSize, PacketMemoryData); break; case DsMsgType.Registers: DoDebugMsg("DC Recv: Registers"); Next(40, PacketRegisters); break; case DsMsgType.Frame: DoDebugMsg("DC Recv: Frame"); Next(-1, PacketFrame); break; case DsMsgType.Stack: DoDebugMsg("DC Recv: Stack"); Next(-1, PacketStack); break; default: // Exceptions crash VS so use MsgBox instead MessageBox.Show("Unknown debug command: " + mCurrentMsgType); // Despite it being unkonwn, we try again. Normally this will // just cause more unknowns, but can be useful for debugging. WaitForMessage(); break; } } public virtual void Dispose() { //if (mDebugWriter != null) //{ // mDebugWriter.Dispose(); // mDebugWriter = null; // //} GC.SuppressFinalize(this); } // Signature is sent after garbage emitted during init of serial port. // For more info see note in DebugStub where signature is transmitted. protected byte[] mSigCheck = new byte[4] { 0, 0, 0, 0} ; protected void WaitForSignature(byte[] aPacket) { mSigCheck[0] = mSigCheck[1]; mSigCheck[1] = mSigCheck[2]; mSigCheck[2] = mSigCheck[3]; mSigCheck[3] = aPacket[0]; var xSig = GetUInt32(mSigCheck, 0); DoDebugMsg("DC: Sig Byte " + aPacket[0].ToString("X2").ToUpper() + " : " + xSig.ToString("X8").ToUpper()); if (xSig == Cosmos.Compiler.Debug.Consts.SerialSignature) { // Sig found, wait for messages WaitForMessage(); } else { // Sig not found, keep looking Next(1, WaitForSignature); } } protected void WaitForMessage() { Next(1, PacketMsg); } protected void PacketTextSize(byte[] aPacket) { Next(GetUInt16(aPacket, 0), PacketText); } protected void PacketMethodContext(byte[] aPacket) { mData = aPacket.ToArray(); WaitForMessage(); } protected void PacketMemoryData(byte[] aPacket) { mData = aPacket.ToArray(); WaitForMessage(); } protected void PacketRegisters(byte[] aPacket) { mData = aPacket.ToArray(); if (CmdRegisters != null) { CmdRegisters(mData); } WaitForMessage(); } protected void PacketFrame(byte[] aPacket) { mData = aPacket.ToArray(); if (CmdFrame != null) { CmdFrame(mData); } WaitForMessage(); } protected void PacketStack(byte[] aPacket) { mData = aPacket; if (CmdStack != null) { CmdStack(mData); } WaitForMessage(); } protected void PacketCmdCompleted(byte[] aPacket) { byte xCmdID = aPacket[0]; DoDebugMsg("DS Msg: Cmd " + xCmdID + " Complete"); if (mCurrCmdID != xCmdID) { System.Windows.Forms.MessageBox.Show("DS Cmd Completed Mismatch. Expected " + mCurrCmdID + ", received " + xCmdID + "."); } // Release command mCmdWait.Set(); WaitForMessage(); } protected void PacketTracePoint(byte[] aPacket) { WaitForMessage(); CmdTrace(mCurrentMsgType, GetUInt32(aPacket, 0)); } protected void PacketText(byte[] aPacket) { WaitForMessage(); CmdText(ASCIIEncoding.ASCII.GetString(aPacket)); } } }