gdb/config/h8300/tm-h8300.h

   1 /* Parameters for execution on a H8/300 series machine.
   2    Copyright 1992, 1993, 1994, 1996, 1998, 1999, 2000
   3    Free Software Foundation, Inc.
   4
   5    This file is part of GDB.
   6
   7    This program is free software; you can redistribute it and/or modify
   8    it under the terms of the GNU General Public License as published by
   9    the Free Software Foundation; either version 2 of the License, or
  10    (at your option) any later version.
  11
  12    This program is distributed in the hope that it will be useful,
  13    but WITHOUT ANY WARRANTY; without even the implied warranty of
  14    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15    GNU General Public License for more details.
  16
  17    You should have received a copy of the GNU General Public License
  18    along with this program; if not, write to the Free Software
  19    Foundation, Inc., 59 Temple Place - Suite 330,
  20    Boston, MA 02111-1307, USA.  */
  21
  22 #include "regcache.h"
  23
  24 /* Contributed by Steve Chamberlain sac@cygnus.com */
  25
  26 struct frame_info;
  27 struct frame_saved_regs;
  28 struct value;
  29 struct type;
  30
  31 /* 1 if debugging H8/300H application */
  32
  33 /* NOTE: ezannoni 2000-07-18: these variables are part of sim, defined
  34    in sim/h8300/compile.c.  They really should not be used this
  35    way. Because of this we cannot get rid of the macro
  36    GDB_TARGET_IS_H8300 in remote-e7000.c */
  37 extern int h8300hmode;
  38 extern int h8300smode;
  39
  40 /* Number of bytes in a word */
  41
  42 #define BINWORD (h8300hmode?4:2)
  43
  44 #define EXTRA_FRAME_INFO        \
  45         struct frame_saved_regs *fsr;   \
  46         CORE_ADDR from_pc; \
  47         CORE_ADDR args_pointer;\
  48         CORE_ADDR locals_pointer ;
  49
  50 /* Zero the frame_saved_regs pointer when the frame is initialized,
  51    so that FRAME_FIND_SAVED_REGS () will know to allocate and
  52    initialize a frame_saved_regs struct the first time it is called.
  53    Set the arg_pointer to -1, which is not valid; 0 and other values
  54    indicate real, cached values.  */
  55
  56 #define INIT_EXTRA_FRAME_INFO(fromleaf, fi) \
  57         h8300_init_extra_frame_info (fromleaf, fi)
  58
  59 extern void h8300_init_extra_frame_info ();
  60
  61 #undef TARGET_INT_BIT
  62 #define TARGET_INT_BIT  16
  63 #undef TARGET_LONG_BIT
  64 #define TARGET_LONG_BIT  32
  65 #undef TARGET_PTR_BIT
  66 #define TARGET_PTR_BIT  (h8300hmode ? 32:16)
  67
  68 /* Offset from address of function to start of its code.
  69    Zero on most machines.  */
  70
  71 #define FUNCTION_START_OFFSET 0
  72
  73 /* Advance PC across any function entry prologue instructions
  74    to reach some "real" code.  */
  75
  76 #define SKIP_PROLOGUE(ip)   (h8300_skip_prologue(ip))
  77 extern CORE_ADDR h8300_skip_prologue ();
  78
  79 /* Immediately after a function call, return the saved pc.
  80    Can't always go through the frames for this because on some machines
  81    the new frame is not set up until the new function executes
  82    some instructions.  */
  83
  84 #define SAVED_PC_AFTER_CALL(frame) \
  85   read_memory_unsigned_integer (read_register (SP_REGNUM), BINWORD)
  86
  87 /* Stack grows downward.  */
  88
  89 #define INNER_THAN(lhs,rhs) ((lhs) < (rhs))
  90
  91 /*#define BREAKPOINT {0x7A, 0xFF} */
  92 #define BREAKPOINT {0x01, 0x80} /* Sleep */
  93 #define REMOTE_BREAKPOINT { 0x57, 0x30}         /* trapa #3 */
  94 /* If your kernel resets the pc after the trap happens you may need to
  95    define this before including this file.    */
  96
  97 #define DECR_PC_AFTER_BREAK 0
  98
  99 /* Say how long registers are.  */
 100
 101 #define REGISTER_SIZE 4
 102
 103 #define NUM_REGS 14
 104
 105 #define REGISTER_BYTES (NUM_REGS * 4)
 106
 107 /* Index within `registers' of the first byte of the space for
 108    register N.  */
 109
 110 #define REGISTER_BYTE(N)  ((N) * 4)
 111
 112 /* Number of bytes of storage in the actual machine representation
 113    for register N.  On the H8/300, all regs are 2 bytes.  */
 114
 115 #define REGISTER_RAW_SIZE(N) (h8300hmode ? 4 : 2)
 116
 117 /* Number of bytes of storage in the program's representation
 118    for register N.  */
 119
 120 #define REGISTER_VIRTUAL_SIZE(N) (h8300hmode ? 4 : 2)
 121
 122 /* Largest value REGISTER_RAW_SIZE can have.  */
 123
 124 #define MAX_REGISTER_RAW_SIZE 4
 125
 126 /* Largest value REGISTER_VIRTUAL_SIZE can have.  */
 127
 128 #define MAX_REGISTER_VIRTUAL_SIZE 4
 129
 130 /* Return the GDB type object for the "standard" data type
 131    of data in register N.  */
 132
 133 #define REGISTER_VIRTUAL_TYPE(N) \
 134 (h8300hmode ? builtin_type_unsigned_long : builtin_type_unsigned_short)
 135
 136 /* Initializer for an array of names of registers.
 137    Entries beyond the first NUM_REGS are ignored.  */
 138
 139 #define REGISTER_NAMES \
 140   {"r0", "r1", "r2", "r3", "r4", "r5", "r6", "sp", "ccr","pc","cycles","tick","inst",""}
 141
 142 /* An array of names of registers. */
 143
 144 extern char **h8300_register_names;
 145 #define REGISTER_NAME(i) h8300_register_names[i]
 146
 147 /* Register numbers of various important registers.
 148    Note that some of these values are "real" register numbers,
 149    and correspond to the general registers of the machine,
 150    and some are "phony" register numbers which are too large
 151    to be actual register numbers as far as the user is concerned
 152    but do serve to get the desired values when passed to read_register.  */
 153
 154 #define ARG0_REGNUM    0        /* first reg in which an arg may be passed */
 155 #define ARGLAST_REGNUM 2        /* last  reg in which an arg may be passed */
 156 #define FP_REGNUM      6        /* Contain saddress of executing stack frame */
 157 #define SP_REGNUM      7        /* Contains address of top of stack */
 158 #define CCR_REGNUM     8        /* Contains processor status */
 159 #define PC_REGNUM      9        /* Contains program counter */
 160 #define EXR_REGNUM     11       /* Contains processor status */
 161
 162 /* Extract from an array REGBUF containing the (raw) register state
 163    a function return value of type TYPE, and copy that, in virtual format,
 164    into VALBUF.  */
 165
 166 /* FIXME: Won't work with both h8/300's.  */
 167
 168 extern void h8300_extract_return_value (struct type *, char *, char *);
 169 #define DEPRECATED_EXTRACT_RETURN_VALUE(TYPE,REGBUF,VALBUF) \
 170     h8300_extract_return_value (TYPE, (char *)(REGBUF), (char *)(VALBUF))
 171
 172 /* Write into appropriate registers a function return value
 173    of type TYPE, given in virtual format.  Assumes floats are passed
 174    in d0/d1.  */
 175 /* FIXME: Won't work with both h8/300's.  */
 176
 177 extern void h8300_store_return_value (struct type *, char *);
 178 #define STORE_RETURN_VALUE(TYPE,VALBUF) \
 179     h8300_store_return_value(TYPE, (char *) (VALBUF))
 180
 181 /* struct passing and returning stuff */
 182 #define STORE_STRUCT_RETURN(STRUCT_ADDR, SP)    \
 183         write_register (0, STRUCT_ADDR)
 184
 185 #define USE_STRUCT_CONVENTION(gcc_p, type)      (1)
 186
 187 /* Extract from an array REGBUF containing the (raw) register state
 188    the address in which a function should return its structure value,
 189    as a CORE_ADDR (or an expression that can be used as one).  */
 190
 191 #define DEPRECATED_EXTRACT_STRUCT_VALUE_ADDRESS(REGBUF) \
 192      extract_address (REGBUF + REGISTER_BYTE (0), \
 193                       REGISTER_RAW_SIZE (0))
 194
 195 /* Describe the pointer in each stack frame to the previous stack frame
 196    (its caller).  */
 197
 198 /* FRAME_CHAIN takes a frame's nominal address
 199    and produces the frame's chain-pointer.
 200
 201    However, if FRAME_CHAIN_VALID returns zero,
 202    it means the given frame is the outermost one and has no caller.  */
 203
 204 #define FRAME_CHAIN(FRAME) h8300_frame_chain(FRAME)
 205 CORE_ADDR h8300_frame_chain (struct frame_info *);
 206
 207 /* In the case of the H8/300, the frame's nominal address
 208    is the address of a 2-byte word containing the calling frame's address.  */
 209
 210 /* Use the alternate method of avoiding running up off the end of
 211    the frame chain or following frames back into the startup code.
 212    See the comments in objfile.h */
 213
 214 #define FRAME_CHAIN_VALID(fp,fi) func_frame_chain_valid (fp, fi)
 215
 216 /* Define other aspects of the stack frame.  */
 217
 218 /* A macro that tells us whether the function invocation represented
 219    by FI does not have a frame on the stack associated with it.  If it
 220    does not, FRAMELESS is set to 1, else 0.  */
 221 #define FRAMELESS_FUNCTION_INVOCATION(FI) \
 222   (frameless_look_for_prologue (FI))
 223
 224 /* Any function with a frame looks like this
 225    SECOND ARG
 226    FIRST ARG
 227    RET PC
 228    SAVED R2
 229    SAVED R3
 230    SAVED FP   <-FP POINTS HERE
 231    LOCALS0
 232    LOCALS1    <-SP POINTS HERE
 233  */
 234
 235 #define FRAME_SAVED_PC(FRAME) h8300_frame_saved_pc(FRAME)
 236 extern CORE_ADDR h8300_frame_saved_pc (struct frame_info *);
 237
 238 #define FRAME_ARGS_ADDRESS(fi) h8300_frame_args_address(fi)
 239 extern CORE_ADDR h8300_frame_args_address (struct frame_info *);
 240
 241 #define FRAME_LOCALS_ADDRESS(fi) h8300_frame_locals_address(fi)
 242 extern CORE_ADDR h8300_frame_locals_address (struct frame_info *);
 243
 244 /* Set VAL to the number of args passed to frame described by FI.
 245    Can set VAL to -1, meaning no way to tell.  */
 246
 247 /* We can't tell how many args there are
 248    now that the C compiler delays popping them.  */
 249
 250 #define FRAME_NUM_ARGS(fi) (-1)
 251
 252 /* Return number of bytes at start of arglist that are not really args.  */
 253
 254 #define FRAME_ARGS_SKIP 0
 255
 256 /* Put here the code to store, into a struct frame_saved_regs,
 257    the addresses of the saved registers of frame described by FRAME_INFO.
 258    This includes special registers such as pc and fp saved in special
 259    ways in the stack frame.  sp is even more special:
 260    the address we return for it IS the sp for the next frame.  */
 261
 262 #define FRAME_FIND_SAVED_REGS(frame_info, frame_saved_regs)         \
 263    h8300_frame_find_saved_regs(frame_info, &(frame_saved_regs))
 264 extern void h8300_frame_find_saved_regs (struct frame_info *,
 265                                          struct frame_saved_regs *);
 266 \f
 267
 268 typedef unsigned short INSN_WORD;
 269
 270
 271 #define PRINT_REGISTER_HOOK(regno) h8300_print_register_hook(regno)
 272 extern void h8300_print_register_hook (int);
 273
 274 #define GDB_TARGET_IS_H8300
 275
 276 #define NUM_REALREGS (h8300smode?11:10)
 277 #define NOP { 0x01, 0x80}       /* A sleep insn */
 278
 279 #define BELIEVE_PCC_PROMOTION 1
 280
 281 /*
 282  * CALL_DUMMY stuff:
 283  */
 284
 285 #define USE_GENERIC_DUMMY_FRAMES 1
 286 #define CALL_DUMMY                      {0}
 287 #define CALL_DUMMY_LENGTH               (0)
 288 #define CALL_DUMMY_ADDRESS()            entry_point_address ()
 289 #define CALL_DUMMY_LOCATION             AT_ENTRY_POINT
 290 #define CALL_DUMMY_START_OFFSET         (0)
 291 #define CALL_DUMMY_BREAKPOINT_OFFSET    (0)
 292
 293 extern CORE_ADDR h8300_push_arguments (int nargs,
 294                                        struct value **args,
 295                                        CORE_ADDR sp,
 296                                        unsigned char struct_return,
 297                                        CORE_ADDR struct_addr);
 298 extern CORE_ADDR h8300_push_return_address (CORE_ADDR, CORE_ADDR);
 299 extern void h8300_pop_frame (void);
 300
 301 #define PC_IN_CALL_DUMMY(PC, SP, FP)    generic_pc_in_call_dummy (PC, SP, FP)
 302 #define FIX_CALL_DUMMY(DUMMY, START_SP, FUNADDR, NARGS, ARGS, TYPE, GCCP)
 303 #define PUSH_ARGUMENTS(NARGS, ARGS, SP, STRUCT_RETURN, STRUCT_ADDR) \
 304   (h8300_push_arguments (NARGS, ARGS, SP, STRUCT_RETURN, STRUCT_ADDR))
 305 /* Push an empty stack frame, to record the current PC, etc.  */
 306 #define PUSH_DUMMY_FRAME        generic_push_dummy_frame ()
 307 /* Discard from the stack the innermost frame, restoring all registers.  */
 308 #define POP_FRAME               h8300_pop_frame ()
 309 #define PUSH_RETURN_ADDRESS(PC, SP)     h8300_push_return_address (PC, SP)
 310
 311 /* override the standard get_saved_register function with
 312    one that takes account of generic CALL_DUMMY frames */
 313 #define GET_SAVED_REGISTER(raw_buffer, optimized, addrp, frame, regnum, lval) \
 314      generic_unwind_get_saved_register (raw_buffer, optimized, addrp, frame, regnum, lval)