gdb/config/h8300/tm-h8300.h

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