diff options
Diffstat (limited to 'gdb/rdi-share/dbg_rdi.h')
| -rw-r--r-- | gdb/rdi-share/dbg_rdi.h | 511 |
1 files changed, 511 insertions, 0 deletions
diff --git a/gdb/rdi-share/dbg_rdi.h b/gdb/rdi-share/dbg_rdi.h new file mode 100644 index 00000000000..efda7bd8800 --- /dev/null +++ b/gdb/rdi-share/dbg_rdi.h @@ -0,0 +1,511 @@ +/* + * Copyright (C) 1995 Advanced RISC Machines Limited. All rights reserved. + * + * This software may be freely used, copied, modified, and distributed + * provided that the above copyright notice is preserved in all copies of the + * software. + */ + +/* + * ARM debugger toolbox : dbg_rdi.h + */ + +/* + * RCS $Revision$ + * Checkin $Date$ + */ + +#ifndef dbg_rdi__h +#define dbg_rdi__h + +/***************************************************************************\ +* 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_16Bit 16 /* 16-bit breakpoint */ +#define RDIPoint_Conditional 32 + +/* ORRed with point type in extended RDP break and watch messages */ +#define RDIPoint_Inquiry 64 +#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 + +/* RDI_Info subcodes */ +/* rdp in parameters are all preceded by */ +/* in byte = RDP_Info, word = info subcode */ +/* out parameters are all preceded by */ +/* out byte = RDP_Return */ + +#define RDIInfo_Target 0 +/* rdi: out ARMword *targetflags, out ARMword *processor id */ +/* rdp: in none, out word targetflags, word processorid, byte status */ +/* the following bits are defined in targetflags */ +# 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 +# define RDITarget_UnderstandsRDPInterrupt 0x2000 +# define RDITarget_CanProfile 0x4000 +# define RDITarget_Code16 0x8000 +# define RDITarget_HasCommsChannel 0x10000 + +#define RDIInfo_Points 1 +/* rdi: out ARMword *pointcapabilities */ +/* rdp: in none, out word pointcapabilities, byte status */ +/* the following bits are defined in pointcapabilities */ +# define RDIPointCapability_Comparison 1 +# define RDIPointCapability_Range 2 +/* 4 to 128 are RDIWatch_xx{Read,Write} left-shifted by two */ +# define RDIPointCapability_Mask 0x100 +# define RDIPointCapability_ThreadBreak 0x200 +# define RDIPointCapability_ThreadWatch 0x400 +# define RDIPointCapability_CondBreak 0x800 +# define RDIPointCapability_Status 0x1000 /* status enquiries available */ + +#define RDIInfo_Step 2 +/* rdi: out ARMword *stepcapabilities */ +/* rdp: in none, out word stepcapabilities, byte status */ +/* the following bits are defined in stepcapabilities */ +# define RDIStep_Multiple 1 +# define RDIStep_PCChange 2 +# define RDIStep_Single 4 + +#define RDIInfo_MMU 3 +/* rdi: out ARMword *mmuidentity */ +/* rdp: in none, out word mmuidentity, byte status */ + +#define RDIInfo_DownLoad 4 +/* Inquires whether configuration download and selection is available. */ +/* rdp: in none, out byte status */ +/* No argument, no return value. status == ok if available */ + +#define RDIInfo_SemiHosting 5 +/* Inquires whether RDISemiHosting_* RDI_Info calls are available. */ +/* rdp: in none, out byte status */ +/* No argument, no return value. status == ok if available */ + +#define RDIInfo_CoPro 6 +/* Inquires whether CoPro RDI_Info calls are available. */ +/* rdp: in none, out byte status */ +/* No argument, no return value. status == ok if available */ + +#define RDIInfo_Icebreaker 7 +/* Inquires whether debuggee controlled by IceBreaker. */ +/* rdp: in none, out byte status */ +/* No argument, no return value. status == ok if available */ + +#define RDIMemory_Access 8 +/* rdi: out RDI_MemAccessStats *p, in ARMword *handle */ +/* rdp: in word handle */ +/* out word nreads, word nwrites, word sreads, word swrites, */ +/* word ns, word s, byte status */ + +/* Get memory access information for memory block with specified handle */ + +#define RDIMemory_Map 9 +/* rdi: in RDI_MemDescr md[n], in ARMword *n */ +/* rdp: in word n, n * { */ +/* word handle, word start, word limit, */ +/* byte width, byte access */ +/* word Nread_ns, word Nwrite_ns, */ +/* word Sread_ns, word Swrite_ns} */ +/* out byte status */ +/* Sets memory characteristics. */ + +#define RDISet_CPUSpeed 10 +/* rdi: in ARMword *speed */ +/* rdp: in word speed, out byte status */ +/* Sets CPU speed (in ns) */ + +#define RDIRead_Clock 12 +/* rdi: out ARMword *ns, out ARMword *s */ +/* rdp: in none, out word ns, word s, byte status */ +/* Reads simulated time */ + +#define RDIInfo_Memory_Stats 13 +/* Inquires whether RDI_Info codes 8-10 are available */ +/* rdp: in none, out byte status */ +/* No argument, no return value. status == ok if available */ + +/* The next two are only to be used if RDIInfo_DownLoad returned no */ +/* error */ +#define RDIConfig_Count 14 +/* rdi: out ARMword *count */ +/* rdp: out byte status, word count (if status == OK) */ + +/* In addition, the next one is only to be used if RDIConfig_Count */ +/* returned no error */ +typedef struct { unsigned32 version; char name[32]; } RDI_ConfigDesc; +#define RDIConfig_Nth 15 +/* rdi: in ARMword *n, out RDI_ConfigDesc * */ +/* rdp: in word n */ +/* out word version, byte namelen, bytes * bytelen name, */ +/* byte status */ + +/* Set a front-end polling function to be used from within driver poll */ +/* loops */ +typedef void RDI_PollProc(void *); +typedef struct { RDI_PollProc *p; void *arg; } RDI_PollDesc; +#define RDISet_PollProc 16 +/* rdi: in RDI_PollDesc const *from, RDI_PollDesc *to */ +/* if from non-NULL, sets the polling function from it */ +/* if to non-NULL, returns the previous polling function to it */ +/* No corresponding RDP operation */ + +/* Called on debugger startup to see if the target is ready to execute */ +#define RDIInfo_CanTargetExecute 20 +/* rdi: in void + * out byte status (RDIError_NoError => Yes, Otherwise No) + */ + +/* Called to set the top of target memory in an ICEman2 system + * This is then used by ICEman to tell the C Library via the INFOHEAP + * SWI where the stack should start. + * Note that only ICEman2 supports this call. Other systems eg. + * Demon, Angel, will simply return an error, which means that setting + * the top of memory in this fashion is not supported. + */ +#define RDIInfo_SetTopMem 21 +/* rdi: in word mem_top + * out byte status (RDIError_NoError => Done, Other => Not supported + */ + +/* Called before performing a loadagent to determine the endianess of + * the debug agent, so that images of the wrong bytesex can be + * complained about + */ +#define RDIInfo_AgentEndianess 22 +/* rdi: in void + * out byte status + * status should be RDIError_LittleEndian or RDIError_BigEndian + * any other value indicates the target does not support this + * request, so the debugger will have to make a best guess, which + * probably means only allow little endian loadagenting. + */ + +/* 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 +/* rdi: inout ARMword * (in handle, out hwresource), out ARMword *type */ +/* rdp: in word handle, out word hwresource, word type, byte status */ + +#define RDISignal_Stop 0x100 +/* Requests that the debuggee stop */ +/* No arguments, no return value */ +/* rdp: no reply (when the debuggee stops, there will be a reply to the */ +/* step or execute request which started it) */ + +#define RDIVector_Catch 0x180 +/* rdi: in ARMword *bitmap */ +/* rdp: int word bitmap, out byte status */ +/* bit i in bitmap set to cause vector i to cause entry to debugger */ + +/* The next four are only to be used if RDIInfo_Semihosting returned */ +/* no error */ +#define RDISemiHosting_SetState 0x181 +/* rdi: in ARMword *semihostingstate */ +/* rdp: in word semihostingstate, out byte status */ +#define RDISemiHosting_GetState 0x182 +/* rdi: out ARMword *semihostingstate */ +/* rdp: in none, out word semihostingstate, byte status */ +#define RDISemiHosting_SetVector 0x183 +/* rdi: in ARMword *semihostingvector */ +/* rdp: in word semihostingvector, out byte status */ +#define RDISemiHosting_GetVector 0x184 +/* rdi: out ARMword *semihostingvector */ +/* rdp: in none, out word semihostingvector, byte status */ + +/* The next two are only to be used if RDIInfo_Icebreaker returned */ +/* no error */ +#define RDIIcebreaker_GetLocks 0x185 +/* rdi: out ARMword *lockedstate */ +/* rdp: in none, out word lockedstate, byte status */ + +#define RDIIcebreaker_SetLocks 0x186 +/* rdi: in ARMword *lockedstate */ +/* rdp: in word lockedstate, out byte status */ + +/* lockedstate is a bitmap of the icebreaker registers locked against */ +/* use by IceMan (because explicitly written by the user) */ + +#define RDIInfo_GetLoadSize 0x187 +/* rdi: out ARMword *maxloadsize */ +/* rdp: in none, out word maxloadsize, byte status */ +/* Inquires the maximum length of data transfer the agent is prepared */ +/* to receive */ +/* Only usable if RDIInfo_Target returned RDITarget_CanInquireLoadSize */ +/* rdi: out ARMword *size */ + +/* Only to be used if the value returned by RDIInfo_Target had */ +/* RDITarget_HasCommsChannel set */ +typedef void RDICCProc_ToHost(void *arg, ARMword data); +typedef void RDICCProc_FromHost(void *arg, ARMword *data, int *valid); + +#define RDICommsChannel_ToHost 0x188 +/* rdi: in RDICCProc_ToHost *, in void *arg */ +/* rdp: in byte connect, out byte status */ +#define RDICommsChannel_FromHost 0x189 +/* rdi: in RDICCProc_FromHost *, in void *arg */ +/* rdp: in byte connect, out byte status */ + +/* These 4 are only to be used if RDIInfo_Semihosting returns no error */ +#define RDISemiHosting_SetARMSWI 0x190 +/* rdi: in ARMword ARM_SWI_number */ +/* rdp: in ARMword ARM_SWI_number, out byte status */ + +#define RDISemiHosting_GetARMSWI 0x191 +/* rdi: out ARMword ARM_SWI_number */ +/* rdp: out ARMword ARM_SWI_number, byte status */ + +#define RDISemiHosting_SetThumbSWI 0x192 +/* rdi: in ARMword Thumb_SWI_number */ +/* rdp: in ARMword Thumb_SWI_number, out byte status */ + +#define RDISemiHosting_GetThumbSWI 0x193 +/* rdi: out ARMword ARM_Thumb_number */ +/* rdp: out ARMword ARM_Thumb_number, byte status */ + + +#define RDICycles 0x200 +/* rdi: out ARMword cycles[12] */ +/* rdp: in none, out 6 words cycles, byte status */ +/* the rdi result represents 6 big-endian doublewords; the rdp results */ +/* return values for the ls halves of these */ +# define RDICycles_Size 48 + +#define RDIErrorP 0x201 +/* rdi: out ARMaddress *errorp */ +/* rdp: in none, out word errorp, byte status */ +/* Returns the error pointer associated with the last return from step */ +/* or execute with status RDIError_Error. */ + +#define RDISet_Cmdline 0x300 +/* rdi: in char *commandline (a null-terminated string) */ +/* No corresponding RDP operation (cmdline is sent to the agent in */ +/* response to SWI_GetEnv) */ + +#define RDISet_RDILevel 0x301 +/* rdi: in ARMword *level */ +/* rdp: in word level, out byte status */ +/* Sets the RDI/RDP protocol level to be used (must lie between the */ +/* limits returned by RDIInfo_Target). */ + +#define RDISet_Thread 0x302 +/* rdi: in ARMword *threadhandle */ +/* rdp: in word threadhandle, out byte status */ +/* Sets the thread context for subsequent thread-sensitive operations */ +/* (null value sets no thread) */ + +/* The next two are only to be used if RDI_read or RDI_write returned */ +/* RDIError_LittleEndian or RDIError_BigEndian, to signify that the */ +/* debugger has noticed. */ +#define RDIInfo_AckByteSex 0x303 +/* rdi: in ARMword *sex (RDISex_Little or RDISex_Big) */ + +/* The next two are only to be used if RDIInfo_CoPro returned no error */ +#define RDIInfo_DescribeCoPro 0x400 +/* rdi: in int *cpno, Dbg_CoProDesc *cpd */ +/* rdp: in byte cpno, */ +/* cpd->entries * { */ +/* byte rmin, byte rmax, byte nbytes, byte access, */ +/* byte cprt_r_b0, cprt_r_b1, cprt_w_b0, cprt_w_b1} */ +/* byte = 255 */ +/* out byte status */ + +#define RDIInfo_RequestCoProDesc 0x401 +/* rdi: in int *cpno, out Dbg_CoProDesc *cpd */ +/* rpd: in byte cpno */ +/* out nentries * { */ +/* byte rmin, byte rmax, byte nbytes, byte access, */ +/* } */ +/* byte = 255, byte status */ + +#define RDIInfo_Log 0x800 +/* rdi: out ARMword *logsetting */ +/* No corresponding RDP operation */ +#define RDIInfo_SetLog 0x801 +/* rdi: in ARMword *logsetting */ +/* No corresponding RDP operation */ + +#define RDIProfile_Stop 0x500 +/* No arguments, no return value */ +/* rdp: in none, out byte status */ +/* Requests that pc sampling stop */ + +#define RDIProfile_Start 0x501 +/* rdi: in ARMword *interval */ +/* rdp: in word interval, out byte status */ +/* Requests that pc sampling start, with period <interval> usec */ + +#define RDIProfile_WriteMap 0x502 +/* rdi: in ARMword map[] */ +/* map[0] is the length of the array, subsequent elements are sorted */ +/* and are the base of ranges for pc sampling (so if the sampled pc */ +/* lies between map[i] and map[i+1], count[i] is incremented). */ +/* rdp: a number of messages, each of form: */ +/* in word len, word size, word offset, <size> words map data */ +/* out status */ +/* len, size and offset are all word counts. */ + +#define RDIProfile_ReadMap 0x503 +/* rdi: in ARMword *len, out ARMword counts[len] */ +/* Requests that the counts array be set to the accumulated pc sample */ +/* counts */ +/* rdp: a number of messages, each of form: */ +/* in word offset, word size */ +/* out <size> words, status */ +/* len, size and offset are all word counts. */ + +#define RDIProfile_ClearCounts 0x504 +/* No arguments, no return value */ +/* rdp: in none, out byte status */ +/* Requests that pc sample counts be set to zero */ + +#define RDIInfo_RequestReset 0x900 +/* Request reset of the target environment */ +/* No arguments, no return value */ +/* No RDP equivalent, sends an RDP reset */ + +#define RDIInfo_CapabilityRequest 0x8000 +/* Request whether the interface supports the named capability. The */ +/* capability is specified by or'ing the RDIInfo number with this, and */ +/* sending that request */ +/* rdi: in none */ +/* rdp: in none, out byte status */ + +typedef struct { + ARMword len; + ARMword map[1]; +} RDI_ProfileMap; + +typedef unsigned32 PointHandle; +typedef unsigned32 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, unsigned32 mask, ARMword *state); +typedef int rdi_CPUwrite_proc(unsigned mode, unsigned32 mask, ARMword const *state); +typedef int rdi_CPread_proc(unsigned CPnum, unsigned32 mask, ARMword *state); +typedef int rdi_CPwrite_proc(unsigned CPnum, unsigned32 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(unsigned32 nbytes); +typedef int rdi_loadconfigdata_proc(unsigned32 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, unsigned32 *sizep); +typedef int rdi_loadagentproc(ARMword dest, unsigned32 size, getbufferproc *getb, void *getbarg); +typedef int rdi_targetisdead(void); + +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 errnum); + +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; + rdi_targetisdead *targetisdead; +}; + +#endif |