/* * ARM debugger toolbox : dbg_rdi.h * Copyright (C) 1992 Advanced Risc Machines Ltd. All rights reserved. */ /* * RCS $Revision: 1.36.2.3 $ * Checkin $Date: 1995/05/18 13:35:04 $ * Revising $Author: plg $ */ #ifndef dbg_rdi__h #define dbg_rdi__h #include "dbg_stat.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_DeviceWouldNotOpen 159 #define RDIError_NoSuchHandle 160 #define RDIError_ConflictingPoint 161 #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 * \***************************************************************************/ /********* host -> agent *********/ #define RDP_Start (unsigned char)0x0 /* byte type, word memorysize {, byte speed (if (type & 2)) } */ /* returns byte status */ #define RDP_End (unsigned char)0x1 /* no argument */ /* returns byte status */ #define RDP_Read (unsigned char)0x2 /* word address, word nbytes */ /* returns bytes data, byte status {, word count } */ /* The count value is returned only if status != 0, and is the number */ /* of bytes successfully read */ #define RDP_Write (unsigned char)0x3 /* word address, word nbytes, bytes data */ /* returns byte status {, word count } */ /* The count value is returned only if status != 0, and is the number */ /* of bytes successfully written */ #define RDP_CPUread (unsigned char)0x4 /* byte mode, word mask */ /* returns words data, byte status */ #define RDP_CPUwrite (unsigned char)0x5 /* byte mode, word mask, words data */ /* returns byte status */ #define RDP_CPread (unsigned char)0x6 /* byte cpnum, word mask */ /* returns words data, byte status */ #define RDP_CPwrite (unsigned char)0x7 /* byte cpnum, word mask, words data */ /* returns byte status */ #define RDP_SetBreak (unsigned char)0xa /* word address, byte type {, word bound } */ /* if !(type & RDIPoint_Inquiry) */ /* returns {word pointhandle, } byte status */ /* if (type & RDIPoint_Inquiry) */ /* returns word address {, word bound }, byte status */ /* pointhandle is present if type & RDIPoint_Handle */ /* bound arguments and replies are present if */ /* (type & 7) == RDIPoint_IN, RDIPoint_OUT or RDIPoint_MASK */ #define RDP_ClearBreak (unsigned char)0xb /* word pointhandle */ /* returns byte status */ #define RDP_SetWatch (unsigned char)0xc /* word address, byte type, byte datatype {, word bound } */ /* if !(type & RDIPoint_Inquiry) */ /* returns {word pointhandle, } byte status */ /* if (type & RDIPoint_Inquiry) */ /* returns word address {, word bound }, byte status */ /* pointhandle is present if type & RDIPoint_Handle */ /* bound arguments and replies are present if */ /* (type & 7) == RDIPoint_IN or RDIPoint_OUT */ #define RDP_ClearWatch (unsigned char)0xd /* word pointhandle */ /* returns byte status */ #define RDP_Execute (unsigned char)0x10 /* byte type */ /* returns {word pointhandle, } byte status */ /* pointhandle is returned if (type & RDIPoint_Handle); type also has: */ # define RDIExecute_Async 1 #define RDP_Step (unsigned char)0x11 /* byte type, word stepcount */ /* returns {word pointhandle, } byte status */ /* (type as for RDP_Execute) */ #define RDP_Info (unsigned char)0x12 /* argument and return type different for each operation: see below */ #define RDP_OSOpReply (unsigned char)0x13 #define RDP_AddConfig (unsigned char)0x14 /* word nbytes */ /* returns byte status */ #define RDP_LoadConfigData (unsigned char)0x15 /* word nbytes, nbytes * bytes data */ /* returns byte status */ #define RDP_SelectConfig (unsigned char)0x16 /* byte aspect, byte namelen, byte matchtype, word version, */ /* namelen * bytes name */ /* returns word version selected, byte status */ #define RDP_LoadAgent (unsigned char)0x17 /* word loadaddress, word size */ /* followed by a number of messages: */ /* byte = RDP_LoadConfigData, word size, size * bytes data */ /* returns byte status */ #define RDP_Interrupt (unsigned char)0x18 #define RDP_CCToHostReply (unsigned char)0x19 #define RDP_CCFromHostReply (unsigned char)0x1a /********* agent -> host *********/ #define RDP_Stopped (unsigned char)0x20 /* reply to step or execute with RDIExecute_Async */ #define RDP_OSOp (unsigned char)0x21 #define RDP_CCToHost (unsigned char)0x22 #define RDP_CCFromHost (unsigned char)0x23 #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_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-12 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 */ /* 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 */ #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 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 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, 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 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 */ 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 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