xstormy16_stub.c

俄罗斯高人Mamaich的Pocket gcc编译器（运行在PocketPC上）的全部源代码。

/****************************************************************************

		THIS SOFTWARE IS NOT COPYRIGHTED

   HP offers the following for use in the public domain.  HP makes no
   warranty with regard to the software or it's performance and the
   user accepts the software "AS IS" with all faults.

   HP DISCLAIMS ANY WARRANTIES, EXPRESS OR IMPLIED, WITH REGARD
   TO THIS SOFTWARE INCLUDING BUT NOT LIMITED TO THE WARRANTIES
   OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.

****************************************************************************/

/****************************************************************************
 *  Header: remcom.c,v 1.34 91/03/09 12:29:49 glenne Exp $
 *
 *  Module name: remcom.c $
 *  Revision: 1.34 $
 *  Date: 91/03/09 12:29:49 $
 *  Contributor:     Lake Stevens Instrument Division$
 *
 *  Description:     low level support for gdb debugger. $
 *
 *  Considerations:  only works on target hardware $
 *
 *  Written by:      Glenn Engel $
 *  ModuleState:     Experimental $
 *
 *  NOTES:           See Below $
 *
 *  Heavily modified for XStormy16 by Mark Salter, Red Hat.
 *  Optimisations and 'X' support by Geoff Keating, Red Hat.
 *
 *  To enable debugger support, two things need to happen.  One, a
 *  call to set_debug_traps() is necessary in order to allow any breakpoints
 *  or error conditions to be properly intercepted and reported to gdb.
 *  Two, a breakpoint needs to be generated to begin communication.  This
 *  is most easily accomplished by a call to breakpoint().  Breakpoint()
 *  simulates a breakpoint by executing a trap #1.
 *
 *  Because gdb will sometimes write to the stack area to execute function
 *  calls, this program cannot rely on using the inferior stack so it uses
 *  it's own stack area.
 *
 *************
 *
 *    The following gdb commands are supported:
 *
 * command          function                               Return value
 *
 *    g             return the value of the CPU registers  hex data or ENN
 *    G             set the value of the CPU registers     OK or ENN
 *
 *    mAA..AA,LLLL  Read LLLL bytes at address AA..AA      hex data or ENN
 *    MAA..AA,LLLL: Write LLLL bytes at address AA.AA      OK or ENN
 *    XAA..AA,LLLL: Write LLLL binary bytes at address     OK or ENN
 *                  AA..AA
 *
 *    c             Resume at current address              SNN   ( signal NN)
 *    cAA..AA       Continue at address AA..AA             SNN
 *
 *    s             Step one instruction                   SNN
 *    sAA..AA       Step one instruction from AA..AA       SNN
 *
 *    k             kill
 *
 *    ?             What was the last sigval ?             SNN   (signal NN)
 *
 * All commands and responses are sent with a packet which includes a
 * checksum.  A packet consists of
 *
 * $<packet info>#<checksum>.
 *
 * where
 * <packet info> :: <characters representing the command or response>
 * <checksum>    :: <two hex digits computed as modulo 256 sum of <packetinfo>>
 *
 * When a packet is received, it is first acknowledged with either '+' or '-'.
 * '+' indicates a successful transfer.  '-' indicates a failed transfer.
 *
 * Example:
 *
 * Host:                  Reply:
 * $m0,10#2a               +$00010203040506070809101112131415#42
 *
 ****************************************************************************/

/* Local functions:
 */
static void putDebugChar(unsigned ch);
static unsigned char getDebugChar(void);
static void putPacket(unsigned char *);
static void putHex (char c, unsigned long mem_arg, int count);
static unsigned char *getpacket(void);
static void hex2mem(unsigned char *, unsigned long, int);
static int valid_addr_range (unsigned long mem, int count);
static int  hexToInt(unsigned char **, long *);
static void prepare_to_step(void);
static void finish_from_step(void);

/* breakpoint opcode */
#define BREAKPOINT_OPCODE 0x0006

/* Error Detection Register */
#define ERR_DETECT_REG  (*(volatile unsigned *)0x7f08)
#define UNDEF_INSN_ENA   0x01
#define UNDEF_INSN_FLAG  0x02
#define ODD_ADDR_ENA     0x04
#define ODD_ADDR_FLAG    0x08
#define BAD_ADDR_ENA     0x10
#define BAD_ADDR_FLAG    0x20
#define SER0_IRQ_ENA     0x1000
#define SER0_IRQ_FLAG    0x2000

/*****************************************************************************
 * BUFMAX defines the maximum number of characters in inbound/outbound buffers
 * at least NUMREGBYTES*2 are needed for register packets 
 */
#define BUFMAX 80

static const unsigned char hexchars[]="0123456789abcdef";

#define NUMREGS 17

/* Number of bytes of registers (extra 2 bytes is for 4 byte PC).  */
#define NUMREGBYTES ((NUMREGS * 2) + 2)
enum regnames { R0,  R1,  R2,  R3,  R4,  R5,  R6,   R7,
		R8,  R9,  R10, R11, R12, R13, R14,  R15,
		PC };

#define FP  R13
#define PSW R14
#define SP  R15

struct regs {
    int  r[16];
    long pc;
} registers;

static struct regs orig_registers;

static unsigned char remcomBuffer[BUFMAX];

/* Indicate whether inferior is running. Used to decide whether or not to
   send T packet when stub is entered. */
static char is_running;

static inline unsigned char
get_char(unsigned long addr)
{
  unsigned int msw, lsw;
  unsigned char ret;

  msw = addr >> 16;
  lsw = addr & 0xffff;

  asm("movf.b %0,(%2)\n" 
      : "=e"(ret) : "d"(msw), "r"(lsw) : "memory");

  return ret;
}

static inline void
set_char(unsigned long addr, unsigned int val)
{
  unsigned int msw, lsw;

  msw = addr >> 16;
  lsw = addr & 0xffff;

  asm("movf.b (%1),%2\n" 
      : /* none */ : "d"(msw), "r"(lsw), "e"(val) : "memory" );
}

static inline unsigned int
get_word(unsigned long addr)
{
  unsigned int ret, msw, lsw;

  msw = addr >> 16;
  lsw = addr & 0xffff;

  asm("movf.w %0,(%2)\n" 
      : "=e"(ret) : "d"(msw), "r"(lsw) : "memory" );

  return ret;
}

static inline void
set_word(unsigned long addr, unsigned int val)
{
  unsigned int msw, lsw;

  msw = addr >> 16;
  lsw = addr & 0xffff;

  asm("movf.w (%1),%2\n" 
      : /* none */ : "d"(msw), "r"(lsw), "e"(val) : "memory" );
}

static void
assign_regs (struct regs *dest, const struct regs *src)
{
  int i;
  char *d = (char *)dest, *s = (char *)src;
  for (i = 0; i < sizeof (struct regs); i++)
    *d++ = *s++;
}

/* Write out a register for a 'T' packet.  */

static unsigned char *
putreg (unsigned char *buf, int regnum, void *mem_p, int count)
{
  int i;
  unsigned char ch;
  char *mem = (char *)mem_p;

  *buf++ = hexchars[regnum >> 4];
  *buf++ = hexchars[regnum % 16];
  *buf++ = ':';

  for (i=0;i<count;i++)
    {
      ch = *mem++;
      *buf++ = hexchars[ch >> 4];
      *buf++ = hexchars[ch % 16];
    }
  *buf++ = ';';
  return(buf);
}

/*
 * This function does all command procesing for interfacing to gdb.
 */
void 
handle_exception(void)
{
  char sigval;
  unsigned char *ptr;
  long addr, length;

  /* reply to host that an exception has occurred */
  sigval = 5; /* SIGTRAP is default */
  if (ERR_DETECT_REG & UNDEF_INSN_FLAG)
    {
      ERR_DETECT_REG &= ~UNDEF_INSN_FLAG;
      registers.pc -= 2;
      if (get_word(registers.pc) != BREAKPOINT_OPCODE)
	sigval = 4; /* SIGILL */
    }
  if (ERR_DETECT_REG & BAD_ADDR_FLAG)
    {
      ERR_DETECT_REG &= ~BAD_ADDR_FLAG;
      sigval = 11; /* SIGSEGV */
    }
  if (ERR_DETECT_REG & SER0_IRQ_FLAG)
    {
      unsigned char ch;
      
      ch = getDebugChar();
      ERR_DETECT_REG &= ~SER0_IRQ_FLAG;
      if (ch != 0x03)
	return;
      sigval = 2; /* SIGINT */
    }

  finish_from_step();

  /* save original context so it can be restored as a result of
     a kill packet. */
  if (orig_registers.pc == 0L)
    assign_regs (&orig_registers, &registers);

  if (is_running)
    {
      ptr = remcomBuffer;
 
      *ptr++ = 'T';         /* notify gdb with signo, PC, FP and SP */
      *ptr++ = hexchars[sigval >> 4];
      *ptr++ = hexchars[sigval & 0xf];
 
      ptr = putreg (ptr, PC, &registers.pc, 4);
      ptr = putreg (ptr, FP, &registers.r[FP], 2);
      ptr = putreg (ptr, SP, &registers.r[SP], 2);

      *ptr++ = 0;
 
      putPacket(remcomBuffer);
    }

  while (1) {
    char kind;
    
    ptr = getpacket();
    kind = *ptr++;
    if (kind == 'M' || kind == 'X')
      {
	/* MAA..AA,LLLL: Write LLLL bytes at address AA.AA return OK */
        /* TRY TO READ '%x,%x:'.  IF SUCCEED, SET PTR = 0 */
	if (hexToInt(&ptr,&addr)
	    && *(ptr++) == ','
	    && hexToInt(&ptr,&length)
	    && *(ptr++) == ':')
	  {
	    if (valid_addr_range (addr, length))
	      {
		if (kind == 'M')
		  hex2mem(ptr, addr, length);
		else
		  {
		    int i;
		    for (i = 0; i < length; i++)
		      if (*ptr++ == 0x7d)
			set_char (addr++, *ptr++ ^ 0x20);
		      else
			set_char (addr++, ptr[-1]);
		    
		  }
		putPacket ("OK");
	      }
	    else
	      putPacket ("E03");
	  }
	else
	  putPacket ("E02");
      }
    else if (kind == 'm')
      {
	/* mAA..AA,LLLL  Read LLLL bytes at address AA..AA */
	/* TRY TO READ %x,%x.  IF SUCCEED, SET PTR = 0 */
        if (hexToInt(&ptr,&addr)
	    && *(ptr++) == ','
	    && hexToInt (&ptr,&length))
	  {
	    if (valid_addr_range (addr, length))
	      putHex (0, addr, length);
	    else
	      putPacket ("E03");
	  }
	else
	  putPacket ("E02");
      }
    else if (kind == 'R')
      {
	if (hexToInt (&ptr, &addr))
	  registers.pc = addr;
	putPacket ("OK");
      }
    else if (kind == '!')
      putPacket ("OK");
    else if (kind == '?')
      putHex ('S', (unsigned long)(unsigned int)&sigval, 1);
    else if (kind == 'g')
      putHex (0, (unsigned long)(unsigned int)&registers, NUMREGBYTES);
    else if (kind == 'P')
      {
	/* set the value of a single CPU register - return OK */
	unsigned long regno;
	
	if (hexToInt (&ptr, &regno) 
	    && *ptr++ == '='
	    && regno < NUMREGS)
	  {
	    hex2mem (ptr, (unsigned long)(unsigned int)(registers.r + regno),
		     regno == PC ? 4 : 2);
	    putPacket ("OK");
	  }
	else
	  putPacket ("E01");
      }
    else if (kind == 'G')
      {
	/* set the value of the CPU registers - return OK */
	hex2mem(ptr, (unsigned long)(unsigned int)&registers, NUMREGBYTES);
	putPacket ("OK");
      }
    else if (kind == 's' || kind == 'c')
      {
	/* sAA..AA	Step one instruction from AA..AA(optional) */
	/* cAA..AA	Continue from address AA..AA(optional) */
	/* try to read optional parameter, pc unchanged if no parm */

	is_running = 1;
	
	if (hexToInt(&ptr,&addr))
	  registers.pc = addr;
	
	if (kind == 's')	/* single-stepping */
	  prepare_to_step();
	return;
      }
    else if (kind == 'k')
      {
	/* kill the program */
	assign_regs (&registers, &orig_registers);
	is_running = 0;
	putPacket ("");
      }
    else
      /* Unknown code.  Return an empty reply message. */
      putPacket ("");
  }
}

static int 
hex (int ch)
{
  if ((ch >= '0') && (ch <= '9')) return (ch-'0');
  if ((ch >= 'a') && (ch <= 'f')) return (ch-'a'+10);
  if ((ch >= 'A') && (ch <= 'F')) return (ch-'A'+10);
  return (-1);
}

/* scan for the sequence $<data>#<checksum>     */

static unsigned char *
getpacket (void)