* infcmd.c (step_1), infrun.c (wait_for_inferior): Add comments
[binutils-gdb.git] / gdb / config / h8500 / tm-h8500.h
1 /* Parameters for execution on a H8/500 series machine.
2 Copyright (C) 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., 675 Mass Ave, Cambridge, MA 02139, USA. */
19
20 /* Contributed by Steve Chamberlain sac@cygnus.com */
21
22 #define GDB_TARGET_IS_H8500
23
24 #define IEEE_FLOAT 1
25
26 /* Define the bit, byte, and word ordering of the machine. */
27
28 #define TARGET_BYTE_ORDER BIG_ENDIAN
29
30 #undef TARGET_INT_BIT
31 #define TARGET_INT_BIT 16
32
33 #undef TARGET_PTR_BIT
34 #define TARGET_PTR_BIT (minimum_mode ? 16 : 32)
35
36
37 /* Offset from address of function to start of its code.
38 Zero on most machines. */
39
40 #define FUNCTION_START_OFFSET 0
41
42 /* Advance PC across any function entry prologue instructions
43 to reach some "real" code. */
44
45 #define SKIP_PROLOGUE(ip) {(ip) = h8500_skip_prologue(ip);}
46 extern CORE_ADDR h8500_skip_prologue ();
47
48
49 /* Immediately after a function call, return the saved pc.
50 Can't always go through the frames for this because on some machines
51 the new frame is not set up until the new function executes
52 some instructions. */
53
54 #define SAVED_PC_AFTER_CALL(frame) saved_pc_after_call(frame)
55
56
57 /* Stack grows downward. */
58
59 #define INNER_THAN <
60
61 /* Illegal instruction - used by the simulator for breakpoint
62 detection */
63 #define BREAKPOINT {0x0b}
64
65
66 /* If your kernel resets the pc after the trap happens you may need to
67 define this before including this file. */
68
69 #define DECR_PC_AFTER_BREAK 0
70
71
72 /* Nonzero if instruction at PC is a return instruction. */
73
74 #define ABOUT_TO_RETURN(pc) about_to_return(pc)
75
76 /* Return 1 if P points to an invalid floating point value. */
77
78 #define INVALID_FLOAT(p, len) 0 /* Just a first guess; not checked */
79
80 /* Say how long registers are. */
81
82 #define REGISTER_TYPE unsigned long
83
84 /* Say how much memory is needed to store a copy of the register set */
85
86 #define REGISTER_BYTES (24)
87
88 /* Index within `registers' of the first byte of the space for
89 register N. */
90
91 #define REGISTER_BYTE(N) (regoff[N])
92
93 /* Number of bytes of storage in the actual machine representation
94 for register N. */
95
96 #define REGISTER_RAW_SIZE(N) h8500_register_size(N)
97 int h8500_register_size PARAMS ((int regno));
98
99 #define REGISTER_VIRTUAL_SIZE(N) h8500_register_size(N)
100
101 /* Largest value REGISTER_RAW_SIZE can have. */
102
103 #define MAX_REGISTER_RAW_SIZE 4
104
105 /* Largest value REGISTER_VIRTUAL_SIZE can have. */
106
107 #define MAX_REGISTER_VIRTUAL_SIZE 4
108
109 /* Nonzero if register N requires conversion
110 from raw format to virtual format. */
111
112 #define REGISTER_CONVERTIBLE(N) (0)
113
114 /* Convert data from raw format for register REGNUM
115 to virtual format for register REGNUM. */
116
117 #define REGISTER_CONVERT_TO_VIRTUAL(REGNUM,FROM,TO) \
118 { memcpy ((TO), (FROM), 4); }
119
120 /* Convert data from virtual format for register REGNUM
121 to raw format for register REGNUM. */
122
123 #define REGISTER_CONVERT_TO_RAW(REGNUM,FROM,TO) \
124 { memcpy ((TO), (FROM), 4); }
125
126 /* Return the GDB type object for the "standard" data type
127 of data in register N. */
128
129 #define REGISTER_VIRTUAL_TYPE(N) h8500_register_virtual_type(N)
130 struct type *h8500_register_virtual_type PARAMS ((int regno));
131
132 /* Initializer for an array of names of registers.
133 Entries beyond the first NUM_REGS are ignored. */
134
135 #define REGISTER_NAMES \
136 {"r0", "r1", "r2", "r3", "r4", "r5", "r6", "r7", \
137 "ccr","pc", \
138 "cp","dp","ep","tp" }
139
140 /* Register numbers of various important registers.
141 Note that some of these values are "real" register numbers,
142 and correspond to the general registers of the machine,
143 and some are "phony" register numbers which are too large
144 to be actual register numbers as far as the user is concerned
145 but do serve to get the desired values when passed to read_register. */
146
147
148 #define R0_REGNUM 0
149 #define R1_REGNUM 1
150 #define R2_REGNUM 2
151 #define R3_REGNUM 3
152 #define R4_REGNUM 4
153 #define R5_REGNUM 5
154 #define R6_REGNUM 6
155 #define R7_REGNUM 7
156
157 #define SP_REGNUM R7_REGNUM /* Contains address of top of stack */
158 #define FP_REGNUM R6_REGNUM /* Contains address of executing stack frame */
159
160 #define CCR_REGNUM 8 /* Contains processor status */
161 #define PC_REGNUM 9 /* Contains program counter */
162
163 #define SEG_C_REGNUM 10 /* Segment registers */
164 #define SEG_D_REGNUM 11
165 #define SEG_E_REGNUM 12
166 #define SEG_T_REGNUM 13
167
168 #define NUM_REGS 14
169
170 #define PTR_SIZE (minimum_mode ? 2: 4)
171 #define PTR_MASK (minimum_mode ? 0x0000ffff : 0x00ffffff)
172
173 /* Store the address of the place in which to copy the structure the
174 subroutine will return. This is called from call_function. */
175
176 /*#define STORE_STRUCT_RETURN(ADDR, SP) \
177 { write_register (0, (ADDR)); abort(); }*/
178
179 /* Extract from an array REGBUF containing the (raw) register state
180 a function return value of type TYPE, and copy that, in virtual format,
181 into VALBUF. */
182
183 #define EXTRACT_RETURN_VALUE(TYPE,REGBUF,VALBUF) \
184 memcpy (VALBUF, (char *)(REGBUF), TYPE_LENGTH(TYPE))
185
186
187 /* Write into appropriate registers a function return value
188 of type TYPE, given in virtual format. Assumes floats are passed
189 in d0/d1. */
190
191
192 #define STORE_RETURN_VALUE(TYPE,VALBUF) \
193 write_register_bytes (0, VALBUF, TYPE_LENGTH (TYPE))
194
195
196 /* Extract from an array REGBUF containing the (raw) register state
197 the address in which a function should return its structure value,
198 as a CORE_ADDR (or an expression that can be used as one). */
199
200 #define EXTRACT_STRUCT_VALUE_ADDRESS(REGBUF) (*(CORE_ADDR *)(REGBUF))
201 \f
202
203 /* Define other aspects of the stack frame. */
204
205 /* A macro that tells us whether the function invocation represented
206 by FI does not have a frame on the stack associated with it. If it
207 does not, FRAMELESS is set to 1, else 0. */
208 #define FRAMELESS_FUNCTION_INVOCATION(FI, FRAMELESS) \
209 (FRAMELESS) = frameless_look_for_prologue(FI)
210
211 /* Any function with a frame looks like this
212 SECOND ARG
213 FIRST ARG
214 RET PC
215 SAVED R2
216 SAVED R3
217 SAVED FP <-FP POINTS HERE
218 LOCALS0
219 LOCALS1 <-SP POINTS HERE
220
221 */
222
223 CORE_ADDR h8500_frame_chain (/* FRAME thisframe */);
224
225 #define INIT_EXTRA_FRAME_INFO(fromleaf, fci) \
226 (fci)->frame |= read_register(SEG_T_REGNUM) << 16;
227
228 #define FRAME_CHAIN(FRAME) h8500_frame_chain(FRAME)
229
230 #define FRAME_SAVED_PC(FRAME) frame_saved_pc(FRAME)
231
232 #define FRAME_ARGS_ADDRESS(fi) frame_args_address(fi)
233
234 #define FRAME_LOCALS_ADDRESS(fi) frame_locals_address(fi);
235
236 /* Set VAL to the number of args passed to frame described by FI.
237 Can set VAL to -1, meaning no way to tell. */
238
239 /* We can't tell how many args there are
240 now that the C compiler delays popping them. */
241
242 #define FRAME_NUM_ARGS(val,fi) (val = -1)
243
244 /* Return number of bytes at start of arglist that are not really args. */
245
246 #define FRAME_ARGS_SKIP 0
247
248 /* Put here the code to store, into a struct frame_saved_regs,
249 the addresses of the saved registers of frame described by FRAME_INFO.
250 This includes special registers such as pc and fp saved in special
251 ways in the stack frame. sp is even more special:
252 the address we return for it IS the sp for the next frame. */
253
254 #define FRAME_FIND_SAVED_REGS(frame_info, frame_saved_regs) \
255 frame_find_saved_regs(frame_info, &(frame_saved_regs))
256 \f
257
258 /* Push an empty stack frame, to record the current PC, etc. */
259
260 /*#define PUSH_DUMMY_FRAME { h8300_push_dummy_frame (); }*/
261
262 /* Discard from the stack the innermost frame, restoring all registers. */
263
264 #define POP_FRAME { h8300_pop_frame (); }
265
266 #define SHORT_INT_MAX 32767
267 #define SHORT_INT_MIN -32768
268
269
270
271 #define BEFORE_MAIN_LOOP_HOOK \
272 hms_before_main_loop();
273
274
275 #define NAMES_HAVE_UNDERSCORE
276
277 typedef unsigned short INSN_WORD;
278
279 #define ADDR_BITS_REMOVE(addr) ((addr) & 0xffffff)
280
281 #define read_memory_short(x) (read_memory_integer(x,2) & 0xffff)
282 #define DONT_USE_REMOTE
283
284
285 #define PRINT_REGISTER_HOOK(regno) print_register_hook(regno)
286
287 int minimum_mode;
288
289 #define CALL_DUMMY_LENGTH 10
290
291 /* Fake variables to make it easy to use 24 bit register pointers */
292
293 int h8500_is_trapped_internalvar PARAMS ((char *name));
294 #define IS_TRAPPED_INTERNALVAR h8500_is_trapped_internalvar
295
296 struct value * h8500_value_of_trapped_internalvar (/* struct internalvar *var */);
297 #define VALUE_OF_TRAPPED_INTERNALVAR h8500_value_of_trapped_internalvar
298
299 void h8500_set_trapped_internalvar (/* struct internalvar *var, value newval, int bitpos, int bitsize, int offset */);
300 #define SET_TRAPPED_INTERNALVAR h8500_set_trapped_internalvar
301
302
303
304 int regoff[NUM_REGS];
305
306 CORE_ADDR target_read_sp();
307 void target_write_sp PARAMS ((CORE_ADDR ));
308
309 CORE_ADDR target_read_fp();
310 void target_write_fp PARAMS ((CORE_ADDR ));
311
312 CORE_ADDR target_read_pc();
313 void target_write_pc PARAMS ((CORE_ADDR ));
314
315
316 #define TARGET_READ_SP() target_read_sp()
317 #define TARGET_WRITE_SP(x) target_write_sp(x)
318 #define TARGET_READ_PC() target_read_pc()
319 #define TARGET_WRITE_PC(x) target_write_pc(x)
320
321 #define TARGET_READ_FP() target_read_fp()
322 #define TARGET_WRITE_FP(x) target_write_fp(x)