Subversion Repositories or1k_old

/*  dbg_rdi.h -- ARMulator RDI interface:  ARM6 Instruction Emulator.

    Copyright (C) 1994 Advanced RISC Machines Ltd.

    This program is free software; you can redistribute it and/or modify

    it under the terms of the GNU General Public License as published by

    the Free Software Foundation; either version 2 of the License, or

    (at your option) any later version.

    This program is distributed in the hope that it will be useful,

    but WITHOUT ANY WARRANTY; without even the implied warranty of

    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License

    along with this program; if not, write to the Free Software

    Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */

#ifndef dbg_rdi__h

#define dbg_rdi__h

/***************************************************************************\

*                              Error Codes                                  *

\***************************************************************************/

#define RDIError_NoError                0

#define RDIError_Reset                  1

#define RDIError_UndefinedInstruction   2

#define RDIError_SoftwareInterrupt      3

#define RDIError_PrefetchAbort          4

#define RDIError_DataAbort              5

#define RDIError_AddressException       6

#define RDIError_IRQ                    7

#define RDIError_FIQ                    8

#define RDIError_Error                  9

#define RDIError_BranchThrough0         10

#define RDIError_NotInitialised         128

#define RDIError_UnableToInitialise     129

#define RDIError_WrongByteSex           130

#define RDIError_UnableToTerminate      131

#define RDIError_BadInstruction         132

#define RDIError_IllegalInstruction     133

#define RDIError_BadCPUStateSetting     134

#define RDIError_UnknownCoPro           135

#define RDIError_UnknownCoProState      136

#define RDIError_BadCoProState          137

#define RDIError_BadPointType           138

#define RDIError_UnimplementedType      139

#define RDIError_BadPointSize           140

#define RDIError_UnimplementedSize      141

#define RDIError_NoMorePoints           142

#define RDIError_BreakpointReached      143

#define RDIError_WatchpointAccessed     144

#define RDIError_NoSuchPoint            145

#define RDIError_ProgramFinishedInStep  146

#define RDIError_UserInterrupt          147

#define RDIError_CantSetPoint           148

#define RDIError_IncompatibleRDILevels  149

#define RDIError_CantLoadConfig         150

#define RDIError_BadConfigData          151

#define RDIError_NoSuchConfig           152

#define RDIError_BufferFull             153

#define RDIError_OutOfStore             154

#define RDIError_NotInDownload          155

#define RDIError_PointInUse             156

#define RDIError_BadImageFormat         157

#define RDIError_TargetRunning          158

#define RDIError_LittleEndian           240

#define RDIError_BigEndian              241

#define RDIError_SoftInitialiseError    242

#define RDIError_InsufficientPrivilege  253

#define RDIError_UnimplementedMessage   254

#define RDIError_UndefinedMessage       255

/***************************************************************************\

*                          RDP Message Numbers                              *

\***************************************************************************/

#define RDP_Start               (unsigned char)0x0

#define RDP_End                 (unsigned char)0x1

#define RDP_Read                (unsigned char)0x2

#define RDP_Write               (unsigned char)0x3

#define RDP_CPUread             (unsigned char)0x4

#define RDP_CPUwrite            (unsigned char)0x5

#define RDP_CPread              (unsigned char)0x6

#define RDP_CPwrite             (unsigned char)0x7

#define RDP_SetBreak            (unsigned char)0xa

#define RDP_ClearBreak          (unsigned char)0xb

#define RDP_SetWatch            (unsigned char)0xc

#define RDP_ClearWatch          (unsigned char)0xd

#define RDP_Execute             (unsigned char)0x10

#define RDP_Step                (unsigned char)0x11

#define RDP_Info                (unsigned char)0x12

#define RDP_OSOpReply           (unsigned char)0x13

#define RDP_AddConfig           (unsigned char)0x14

#define RDP_LoadConfigData      (unsigned char)0x15

#define RDP_SelectConfig        (unsigned char)0x16

#define RDP_LoadAgent           (unsigned char)0x17

#define RDP_Stopped             (unsigned char)0x20

#define RDP_OSOp                (unsigned char)0x21

#define RDP_Fatal               (unsigned char)0x5e

#define RDP_Return              (unsigned char)0x5f

#define RDP_Reset               (unsigned char)0x7f

/***************************************************************************\

*                            Other RDI values                               *

\***************************************************************************/

#define RDISex_Little           0       /* the byte sex of the debuggee */

#define RDISex_Big              1

#define RDISex_DontCare         2

#define RDIPoint_EQ             0       /* the different types of break/watchpoints */

#define RDIPoint_GT             1

#define RDIPoint_GE             2

#define RDIPoint_LT             3

#define RDIPoint_LE             4

#define RDIPoint_IN             5

#define RDIPoint_OUT            6

#define RDIPoint_MASK           7

#define RDIPoint_Inquiry        64      /* ORRed with point type in extended RDP */

#define RDIPoint_Handle         128     /* messages                              */

#define RDIWatch_ByteRead       1       /* types of data accesses to watch for */

#define RDIWatch_HalfRead       2

#define RDIWatch_WordRead       4

#define RDIWatch_ByteWrite      8

#define RDIWatch_HalfWrite      16

#define RDIWatch_WordWrite      32

#define RDIReg_R15              (1L << 15)      /* mask values for CPU */

#define RDIReg_PC               (1L << 16)

#define RDIReg_CPSR             (1L << 17)

#define RDIReg_SPSR             (1L << 18)

#define RDINumCPURegs           19

#define RDINumCPRegs            10      /* current maximum */

#define RDIMode_Curr            255

/* Bits set in return value from RDIInfo_Target */

#define RDITarget_LogSpeed              0x0f

#define RDITarget_HW                    0x10    /* else emulator */

#define RDITarget_AgentMaxLevel         0xe0

#define RDITarget_AgentLevelShift       5

#define RDITarget_DebuggerMinLevel      0x700

#define RDITarget_DebuggerLevelShift    8

#define RDITarget_CanReloadAgent        0x800

#define RDITarget_CanInquireLoadSize    0x1000

/* Bits set in return value from RDIInfo_Step */

#define RDIStep_Multiple                1

#define RDIStep_PCChange                2

#define RDIStep_Single                  4

/* Bits set in return value from RDIInfo_Points */

#define RDIPointCapability_Comparison   1

#define RDIPointCapability_Range        2

/* 4 to 128 are RDIWatch_xx{Read,Write} left-shifted by two */

#define RDIPointCapability_Mask         256

#define RDIPointCapability_Status       512     /* Point status enquiries available */

/* RDI_Info subcodes */

#define RDIInfo_Target          0

#define RDIInfo_Points          1

#define RDIInfo_Step            2

#define RDIInfo_MMU             3

#define RDIInfo_DownLoad        4       /* Inquires whether configuration download

                                           and selection is available.

                                         */

#define RDIInfo_SemiHosting     5       /* Inquires whether RDISemiHosting_* RDI_Info

                                           calls are available.

                                         */

#define RDIInfo_CoPro           6       /* Inquires whether CoPro RDI_Info calls are

                                           available.

                                         */

#define RDIInfo_Icebreaker      7

/* The next two are only to be used if the value returned by RDIInfo_Points */

/* has RDIPointCapability_Status set.                                       */

#define RDIPointStatus_Watch    0x80

#define RDIPointStatus_Break    0x81

#define RDISignal_Stop          0x100

#define RDIVector_Catch         0x180

/* The next four are only to be used if RDIInfo_Semihosting returned no error */

#define RDISemiHosting_SetState 0x181

#define RDISemiHosting_GetState 0x182

#define RDISemiHosting_SetVector 0x183

#define RDISemiHosting_GetVector 0x184

/* The next two are only to be used if RDIInfo_Icebreaker returned no error */

#define RDIIcebreaker_GetLocks  0x185

#define RDIIcebreaker_SetLocks  0x186

/* Only if RDIInfo_Target returned RDITarget_CanInquireLoadSize */

#define RDIInfo_GetLoadSize     0x187

#define RDICycles               0x200

#define RDICycles_Size          48

#define RDIErrorP               0x201

#define RDISet_Cmdline          0x300

#define RDISet_RDILevel         0x301

#define RDISet_Thread           0x302

/* The next two are only to be used if RDIInfo_CoPro returned no error */

#define RDIInfo_DescribeCoPro   0x400

#define RDIInfo_RequestCoProDesc 0x401

#define RDIInfo_Log             0x800

#define RDIInfo_SetLog          0x801

typedef unsigned long PointHandle;

typedef unsigned long ThreadHandle;

#define RDINoPointHandle        ((PointHandle)-1L)

#define RDINoHandle             ((ThreadHandle)-1L)

struct Dbg_ConfigBlock;

struct Dbg_HostosInterface;

struct Dbg_MCState;

typedef int rdi_open_proc (unsigned type,

                           struct Dbg_ConfigBlock const *config,

                           struct Dbg_HostosInterface const *i,

                           struct Dbg_MCState *dbg_state);

typedef int rdi_close_proc (void);

typedef int rdi_read_proc (ARMword source, void *dest, unsigned *nbytes);

typedef int rdi_write_proc (const void *source, ARMword dest,

                            unsigned *nbytes);

typedef int rdi_CPUread_proc (unsigned mode, unsigned long mask,

                              ARMword * state);

typedef int rdi_CPUwrite_proc (unsigned mode, unsigned long mask,

                               ARMword const *state);

typedef int rdi_CPread_proc (unsigned CPnum, unsigned long mask,

                             ARMword * state);

typedef int rdi_CPwrite_proc (unsigned CPnum, unsigned long mask,

                              ARMword const *state);

typedef int rdi_setbreak_proc (ARMword address, unsigned type, ARMword bound,

                               PointHandle * handle);

typedef int rdi_clearbreak_proc (PointHandle handle);

typedef int rdi_setwatch_proc (ARMword address, unsigned type,

                               unsigned datatype, ARMword bound,

                               PointHandle * handle);

typedef int rdi_clearwatch_proc (PointHandle handle);

typedef int rdi_execute_proc (PointHandle * handle);

typedef int rdi_step_proc (unsigned ninstr, PointHandle * handle);

typedef int rdi_info_proc (unsigned type, ARMword * arg1, ARMword * arg2);

typedef int rdi_pointinq_proc (ARMword * address, unsigned type,

                               unsigned datatype, ARMword * bound);

typedef enum

{

  RDI_ConfigCPU,

  RDI_ConfigSystem

}

RDI_ConfigAspect;

typedef enum

{

  RDI_MatchAny,

  RDI_MatchExactly,

  RDI_MatchNoEarlier

}

RDI_ConfigMatchType;

typedef int rdi_addconfig_proc (unsigned long nbytes);

typedef int rdi_loadconfigdata_proc (unsigned long nbytes, char const *data);

typedef int rdi_selectconfig_proc (RDI_ConfigAspect aspect, char const *name,

                                   RDI_ConfigMatchType matchtype,

                                   unsigned versionreq, unsigned *versionp);

typedef char *getbufferproc (void *getbarg, unsigned long *sizep);

typedef int rdi_loadagentproc (ARMword dest, unsigned long size,

                               getbufferproc * getb, void *getbarg);

typedef struct

{

  int itemmax;

  char const *const *names;

}

RDI_NameList;

typedef RDI_NameList const *rdi_namelistproc (void);

typedef int rdi_errmessproc (char *buf, int buflen, int errno);

struct RDIProcVec

{

  char rditypename[12];

  rdi_open_proc *open;

  rdi_close_proc *close;

  rdi_read_proc *read;

  rdi_write_proc *write;

  rdi_CPUread_proc *CPUread;

  rdi_CPUwrite_proc *CPUwrite;

  rdi_CPread_proc *CPread;

  rdi_CPwrite_proc *CPwrite;

  rdi_setbreak_proc *setbreak;

  rdi_clearbreak_proc *clearbreak;

  rdi_setwatch_proc *setwatch;

  rdi_clearwatch_proc *clearwatch;

  rdi_execute_proc *execute;

  rdi_step_proc *step;

  rdi_info_proc *info;

  /* V2 RDI */

  rdi_pointinq_proc *pointinquiry;

  /* These three useable only if RDIInfo_DownLoad returns no error */

  rdi_addconfig_proc *addconfig;

  rdi_loadconfigdata_proc *loadconfigdata;

  rdi_selectconfig_proc *selectconfig;

  rdi_namelistproc *drivernames;

  rdi_namelistproc *cpunames;

  rdi_errmessproc *errmess;

  /* Only if RDIInfo_Target returns a value with RDITarget_LoadAgent set */

  rdi_loadagentproc *loadagent;

};

#endif

extern unsigned int swi_mask;

#define SWI_MASK_DEMON          (1 << 0)

#define SWI_MASK_ANGEL          (1 << 1)

#define SWI_MASK_REDBOOT        (1 << 2)