1 /* Target-dependent code for FT32.
3 Copyright (C) 2009-2019 Free Software Foundation, Inc.
5 This file is part of GDB.
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 3 of the License, or
10 (at your option) any later version.
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.
17 You should have received a copy of the GNU General Public License
18 along with this program. If not, see <http://www.gnu.org/licenses/>. */
22 /* Standard C++ includes. */
25 /* Local non-gdb includes. */
26 #include "arch-utils.h"
28 #include "frame-base.h"
29 #include "frame-unwind.h"
31 #include "ft32-tdep.h"
32 #include "gdb/sim-ft32.h"
39 #include "opcode/ft32.h"
45 #include "trad-frame.h"
48 #define RAM_BIAS 0x800000 /* Bias added to RAM addresses. */
50 /* Use an invalid address -1 as 'not available' marker. */
51 enum { REG_UNAVAIL
= (CORE_ADDR
) (-1) };
53 struct ft32_frame_cache
55 /* Base address of the frame */
57 /* Function this frame belongs to */
59 /* Total size of this frame */
61 /* Saved registers in this frame */
62 CORE_ADDR saved_regs
[FT32_NUM_REGS
];
63 /* Saved SP in this frame */
65 /* Has the new frame been LINKed. */
66 bfd_boolean established
;
69 /* Implement the "frame_align" gdbarch method. */
72 ft32_frame_align (struct gdbarch
*gdbarch
, CORE_ADDR sp
)
74 /* Align to the size of an instruction (so that they can safely be
75 pushed onto the stack. */
80 constexpr gdb_byte ft32_break_insn
[] = { 0x02, 0x00, 0x34, 0x00 };
82 typedef BP_MANIPULATION (ft32_break_insn
) ft32_breakpoint
;
84 /* FT32 register names. */
86 static const char *const ft32_register_names
[] =
89 "r0", "r1", "r2", "r3", "r4", "r5", "r6", "r7",
90 "r8", "r9", "r10", "r11", "r12", "r13", "r14", "r15",
91 "r16", "r17", "r18", "r19", "r20", "r21", "r22", "r23",
92 "r24", "r25", "r26", "r27", "r28", "cc",
96 /* Implement the "register_name" gdbarch method. */
99 ft32_register_name (struct gdbarch
*gdbarch
, int reg_nr
)
103 if (reg_nr
>= FT32_NUM_REGS
)
105 return ft32_register_names
[reg_nr
];
108 /* Implement the "register_type" gdbarch method. */
111 ft32_register_type (struct gdbarch
*gdbarch
, int reg_nr
)
113 if (reg_nr
== FT32_PC_REGNUM
)
114 return gdbarch_tdep (gdbarch
)->pc_type
;
115 else if (reg_nr
== FT32_SP_REGNUM
|| reg_nr
== FT32_FP_REGNUM
)
116 return builtin_type (gdbarch
)->builtin_data_ptr
;
118 return builtin_type (gdbarch
)->builtin_int32
;
121 /* Write into appropriate registers a function return value
122 of type TYPE, given in virtual format. */
125 ft32_store_return_value (struct type
*type
, struct regcache
*regcache
,
126 const gdb_byte
*valbuf
)
128 struct gdbarch
*gdbarch
= regcache
->arch ();
129 enum bfd_endian byte_order
= gdbarch_byte_order (gdbarch
);
131 int len
= TYPE_LENGTH (type
);
133 /* Things always get returned in RET1_REGNUM, RET2_REGNUM. */
134 regval
= extract_unsigned_integer (valbuf
, len
> 4 ? 4 : len
, byte_order
);
135 regcache_cooked_write_unsigned (regcache
, FT32_R0_REGNUM
, regval
);
138 regval
= extract_unsigned_integer (valbuf
+ 4,
139 len
- 4, byte_order
);
140 regcache_cooked_write_unsigned (regcache
, FT32_R1_REGNUM
, regval
);
144 /* Fetch a single 32-bit instruction from address a. If memory contains
145 a compressed instruction pair, return the expanded instruction. */
148 ft32_fetch_instruction (CORE_ADDR a
, int *isize
,
149 enum bfd_endian byte_order
)
154 CORE_ADDR a4
= a
& ~3;
155 inst
= read_code_unsigned_integer (a4
, 4, byte_order
);
156 *isize
= ft32_decode_shortcode (a4
, inst
, sc
) ? 2 : 4;
158 return sc
[1 & (a
>> 1)];
163 /* Decode the instructions within the given address range. Decide
164 when we must have reached the end of the function prologue. If a
165 frame_info pointer is provided, fill in its saved_regs etc.
167 Returns the address of the first instruction after the prologue. */
170 ft32_analyze_prologue (CORE_ADDR start_addr
, CORE_ADDR end_addr
,
171 struct ft32_frame_cache
*cache
,
172 struct gdbarch
*gdbarch
)
174 enum bfd_endian byte_order
= gdbarch_byte_order (gdbarch
);
179 struct bound_minimal_symbol msymbol
;
180 const int first_saved_reg
= 13; /* The first saved register. */
181 /* PROLOGS are addresses of the subroutine prologs, PROLOGS[n]
182 is the address of __prolog_$rN.
183 __prolog_$rN pushes registers from 13 through n inclusive.
184 So for example CALL __prolog_$r15 is equivalent to:
188 Note that PROLOGS[0] through PROLOGS[12] are unused. */
189 CORE_ADDR prologs
[32];
191 cache
->saved_regs
[FT32_PC_REGNUM
] = 0;
192 cache
->framesize
= 0;
194 for (regnum
= first_saved_reg
; regnum
< 32; regnum
++)
196 char prolog_symbol
[32];
198 snprintf (prolog_symbol
, sizeof (prolog_symbol
), "__prolog_$r%02d",
200 msymbol
= lookup_minimal_symbol (prolog_symbol
, NULL
, NULL
);
202 prologs
[regnum
] = BMSYMBOL_VALUE_ADDRESS (msymbol
);
207 if (start_addr
>= end_addr
)
210 cache
->established
= 0;
211 for (next_addr
= start_addr
; next_addr
< end_addr
; next_addr
+= isize
)
213 inst
= ft32_fetch_instruction (next_addr
, &isize
, byte_order
);
215 if (FT32_IS_PUSH (inst
))
217 pushreg
= FT32_PUSH_REG (inst
);
218 cache
->framesize
+= 4;
219 cache
->saved_regs
[FT32_R0_REGNUM
+ pushreg
] = cache
->framesize
;
221 else if (FT32_IS_CALL (inst
))
223 for (regnum
= first_saved_reg
; regnum
< 32; regnum
++)
225 if ((4 * (inst
& 0x3ffff)) == prologs
[regnum
])
227 for (pushreg
= first_saved_reg
; pushreg
<= regnum
;
230 cache
->framesize
+= 4;
231 cache
->saved_regs
[FT32_R0_REGNUM
+ pushreg
] =
241 for (regnum
= FT32_R0_REGNUM
; regnum
< FT32_PC_REGNUM
; regnum
++)
243 if (cache
->saved_regs
[regnum
] != REG_UNAVAIL
)
244 cache
->saved_regs
[regnum
] =
245 cache
->framesize
- cache
->saved_regs
[regnum
];
247 cache
->saved_regs
[FT32_PC_REGNUM
] = cache
->framesize
;
250 if (next_addr
< end_addr
)
252 inst
= ft32_fetch_instruction (next_addr
, &isize
, byte_order
);
253 if (FT32_IS_LINK (inst
))
255 cache
->established
= 1;
256 for (regnum
= FT32_R0_REGNUM
; regnum
< FT32_PC_REGNUM
; regnum
++)
258 if (cache
->saved_regs
[regnum
] != REG_UNAVAIL
)
259 cache
->saved_regs
[regnum
] += 4;
261 cache
->saved_regs
[FT32_PC_REGNUM
] = cache
->framesize
+ 4;
262 cache
->saved_regs
[FT32_FP_REGNUM
] = 0;
263 cache
->framesize
+= FT32_LINK_SIZE (inst
);
271 /* Find the end of function prologue. */
274 ft32_skip_prologue (struct gdbarch
*gdbarch
, CORE_ADDR pc
)
276 CORE_ADDR func_addr
= 0, func_end
= 0;
277 const char *func_name
;
279 /* See if we can determine the end of the prologue via the symbol table.
280 If so, then return either PC, or the PC after the prologue, whichever
282 if (find_pc_partial_function (pc
, &func_name
, &func_addr
, &func_end
))
284 CORE_ADDR post_prologue_pc
285 = skip_prologue_using_sal (gdbarch
, func_addr
);
286 if (post_prologue_pc
!= 0)
287 return std::max (pc
, post_prologue_pc
);
290 /* Can't determine prologue from the symbol table, need to examine
292 struct symtab_and_line sal
;
294 struct ft32_frame_cache cache
;
297 memset (&cache
, 0, sizeof cache
);
299 plg_end
= ft32_analyze_prologue (func_addr
,
300 func_end
, &cache
, gdbarch
);
301 /* Found a function. */
302 sym
= lookup_symbol (func_name
, NULL
, VAR_DOMAIN
, NULL
).symbol
;
303 /* Don't use line number debug info for assembly source files. */
304 if ((sym
!= NULL
) && SYMBOL_LANGUAGE (sym
) != language_asm
)
306 sal
= find_pc_line (func_addr
, 0);
307 if (sal
.end
&& sal
.end
< func_end
)
309 /* Found a line number, use it as end of prologue. */
313 /* No useable line symbol. Use result of prologue parsing method. */
318 /* No function symbol -- just return the PC. */
322 /* Implementation of `pointer_to_address' gdbarch method.
324 On FT32 address space zero is RAM, address space 1 is flash.
325 RAM appears at address RAM_BIAS, flash at address 0. */
328 ft32_pointer_to_address (struct gdbarch
*gdbarch
,
329 struct type
*type
, const gdb_byte
*buf
)
331 enum bfd_endian byte_order
= gdbarch_byte_order (gdbarch
);
333 = extract_unsigned_integer (buf
, TYPE_LENGTH (type
), byte_order
);
335 if (TYPE_ADDRESS_CLASS_1 (type
))
338 return addr
| RAM_BIAS
;
341 /* Implementation of `address_class_type_flags' gdbarch method.
343 This method maps DW_AT_address_class attributes to a
344 type_instance_flag_value. */
347 ft32_address_class_type_flags (int byte_size
, int dwarf2_addr_class
)
349 /* The value 1 of the DW_AT_address_class attribute corresponds to the
350 __flash__ qualifier, meaning pointer to data in FT32 program memory.
352 if (dwarf2_addr_class
== 1)
353 return TYPE_INSTANCE_FLAG_ADDRESS_CLASS_1
;
357 /* Implementation of `address_class_type_flags_to_name' gdbarch method.
359 Convert a type_instance_flag_value to an address space qualifier. */
362 ft32_address_class_type_flags_to_name (struct gdbarch
*gdbarch
, int type_flags
)
364 if (type_flags
& TYPE_INSTANCE_FLAG_ADDRESS_CLASS_1
)
370 /* Implementation of `address_class_name_to_type_flags' gdbarch method.
372 Convert an address space qualifier to a type_instance_flag_value. */
375 ft32_address_class_name_to_type_flags (struct gdbarch
*gdbarch
,
379 if (strcmp (name
, "flash") == 0)
381 *type_flags_ptr
= TYPE_INSTANCE_FLAG_ADDRESS_CLASS_1
;
388 /* Given a return value in `regbuf' with a type `valtype',
389 extract and copy its value into `valbuf'. */
392 ft32_extract_return_value (struct type
*type
, struct regcache
*regcache
,
395 struct gdbarch
*gdbarch
= regcache
->arch ();
396 enum bfd_endian byte_order
= gdbarch_byte_order (gdbarch
);
397 bfd_byte
*valbuf
= dst
;
398 int len
= TYPE_LENGTH (type
);
401 /* By using store_unsigned_integer we avoid having to do
402 anything special for small big-endian values. */
403 regcache_cooked_read_unsigned (regcache
, FT32_R0_REGNUM
, &tmp
);
404 store_unsigned_integer (valbuf
, (len
> 4 ? len
- 4 : len
), byte_order
, tmp
);
406 /* Ignore return values more than 8 bytes in size because the ft32
407 returns anything more than 8 bytes in the stack. */
410 regcache_cooked_read_unsigned (regcache
, FT32_R1_REGNUM
, &tmp
);
411 store_unsigned_integer (valbuf
+ len
- 4, 4, byte_order
, tmp
);
415 /* Implement the "return_value" gdbarch method. */
417 static enum return_value_convention
418 ft32_return_value (struct gdbarch
*gdbarch
, struct value
*function
,
419 struct type
*valtype
, struct regcache
*regcache
,
420 gdb_byte
*readbuf
, const gdb_byte
*writebuf
)
422 if (TYPE_LENGTH (valtype
) > 8)
423 return RETURN_VALUE_STRUCT_CONVENTION
;
427 ft32_extract_return_value (valtype
, regcache
, readbuf
);
428 if (writebuf
!= NULL
)
429 ft32_store_return_value (valtype
, regcache
, writebuf
);
430 return RETURN_VALUE_REGISTER_CONVENTION
;
434 /* Allocate and initialize a ft32_frame_cache object. */
436 static struct ft32_frame_cache
*
437 ft32_alloc_frame_cache (void)
439 struct ft32_frame_cache
*cache
;
442 cache
= FRAME_OBSTACK_ZALLOC (struct ft32_frame_cache
);
444 for (i
= 0; i
< FT32_NUM_REGS
; ++i
)
445 cache
->saved_regs
[i
] = REG_UNAVAIL
;
450 /* Populate a ft32_frame_cache object for this_frame. */
452 static struct ft32_frame_cache
*
453 ft32_frame_cache (struct frame_info
*this_frame
, void **this_cache
)
455 struct ft32_frame_cache
*cache
;
456 CORE_ADDR current_pc
;
460 return (struct ft32_frame_cache
*) *this_cache
;
462 cache
= ft32_alloc_frame_cache ();
465 cache
->base
= get_frame_register_unsigned (this_frame
, FT32_FP_REGNUM
);
466 if (cache
->base
== 0)
469 cache
->pc
= get_frame_func (this_frame
);
470 current_pc
= get_frame_pc (this_frame
);
473 struct gdbarch
*gdbarch
= get_frame_arch (this_frame
);
475 ft32_analyze_prologue (cache
->pc
, current_pc
, cache
, gdbarch
);
476 if (!cache
->established
)
477 cache
->base
= get_frame_register_unsigned (this_frame
, FT32_SP_REGNUM
);
480 cache
->saved_sp
= cache
->base
- 4;
482 for (i
= 0; i
< FT32_NUM_REGS
; ++i
)
483 if (cache
->saved_regs
[i
] != REG_UNAVAIL
)
484 cache
->saved_regs
[i
] = cache
->base
+ cache
->saved_regs
[i
];
489 /* Given a GDB frame, determine the address of the calling function's
490 frame. This will be used to create a new GDB frame struct. */
493 ft32_frame_this_id (struct frame_info
*this_frame
,
494 void **this_prologue_cache
, struct frame_id
*this_id
)
496 struct ft32_frame_cache
*cache
= ft32_frame_cache (this_frame
,
497 this_prologue_cache
);
499 /* This marks the outermost frame. */
500 if (cache
->base
== 0)
503 *this_id
= frame_id_build (cache
->saved_sp
, cache
->pc
);
506 /* Get the value of register regnum in the previous stack frame. */
508 static struct value
*
509 ft32_frame_prev_register (struct frame_info
*this_frame
,
510 void **this_prologue_cache
, int regnum
)
512 struct ft32_frame_cache
*cache
= ft32_frame_cache (this_frame
,
513 this_prologue_cache
);
515 gdb_assert (regnum
>= 0);
517 if (regnum
== FT32_SP_REGNUM
&& cache
->saved_sp
)
518 return frame_unwind_got_constant (this_frame
, regnum
, cache
->saved_sp
);
520 if (regnum
< FT32_NUM_REGS
&& cache
->saved_regs
[regnum
] != REG_UNAVAIL
)
521 return frame_unwind_got_memory (this_frame
, regnum
,
522 RAM_BIAS
| cache
->saved_regs
[regnum
]);
524 return frame_unwind_got_register (this_frame
, regnum
, regnum
);
527 static const struct frame_unwind ft32_frame_unwind
=
530 default_frame_unwind_stop_reason
,
532 ft32_frame_prev_register
,
534 default_frame_sniffer
537 /* Return the base address of this_frame. */
540 ft32_frame_base_address (struct frame_info
*this_frame
, void **this_cache
)
542 struct ft32_frame_cache
*cache
= ft32_frame_cache (this_frame
,
548 static const struct frame_base ft32_frame_base
=
551 ft32_frame_base_address
,
552 ft32_frame_base_address
,
553 ft32_frame_base_address
556 /* Allocate and initialize the ft32 gdbarch object. */
558 static struct gdbarch
*
559 ft32_gdbarch_init (struct gdbarch_info info
, struct gdbarch_list
*arches
)
561 struct gdbarch
*gdbarch
;
562 struct gdbarch_tdep
*tdep
;
563 struct type
*void_type
;
564 struct type
*func_void_type
;
566 /* If there is already a candidate, use it. */
567 arches
= gdbarch_list_lookup_by_info (arches
, &info
);
569 return arches
->gdbarch
;
571 /* Allocate space for the new architecture. */
572 tdep
= XCNEW (struct gdbarch_tdep
);
573 gdbarch
= gdbarch_alloc (&info
, tdep
);
575 /* Create a type for PC. We can't use builtin types here, as they may not
577 void_type
= arch_type (gdbarch
, TYPE_CODE_VOID
, TARGET_CHAR_BIT
, "void");
578 func_void_type
= make_function_type (void_type
, NULL
);
579 tdep
->pc_type
= arch_pointer_type (gdbarch
, 4 * TARGET_CHAR_BIT
, NULL
,
581 TYPE_INSTANCE_FLAGS (tdep
->pc_type
) |= TYPE_INSTANCE_FLAG_ADDRESS_CLASS_1
;
583 set_gdbarch_num_regs (gdbarch
, FT32_NUM_REGS
);
584 set_gdbarch_sp_regnum (gdbarch
, FT32_SP_REGNUM
);
585 set_gdbarch_pc_regnum (gdbarch
, FT32_PC_REGNUM
);
586 set_gdbarch_register_name (gdbarch
, ft32_register_name
);
587 set_gdbarch_register_type (gdbarch
, ft32_register_type
);
589 set_gdbarch_return_value (gdbarch
, ft32_return_value
);
591 set_gdbarch_pointer_to_address (gdbarch
, ft32_pointer_to_address
);
593 set_gdbarch_skip_prologue (gdbarch
, ft32_skip_prologue
);
594 set_gdbarch_inner_than (gdbarch
, core_addr_lessthan
);
595 set_gdbarch_breakpoint_kind_from_pc (gdbarch
, ft32_breakpoint::kind_from_pc
);
596 set_gdbarch_sw_breakpoint_from_kind (gdbarch
, ft32_breakpoint::bp_from_kind
);
597 set_gdbarch_frame_align (gdbarch
, ft32_frame_align
);
599 frame_base_set_default (gdbarch
, &ft32_frame_base
);
601 /* Hook in ABI-specific overrides, if they have been registered. */
602 gdbarch_init_osabi (info
, gdbarch
);
604 /* Hook in the default unwinders. */
605 frame_unwind_append_unwinder (gdbarch
, &ft32_frame_unwind
);
607 /* Support simple overlay manager. */
608 set_gdbarch_overlay_update (gdbarch
, simple_overlay_update
);
610 set_gdbarch_address_class_type_flags (gdbarch
, ft32_address_class_type_flags
);
611 set_gdbarch_address_class_name_to_type_flags
612 (gdbarch
, ft32_address_class_name_to_type_flags
);
613 set_gdbarch_address_class_type_flags_to_name
614 (gdbarch
, ft32_address_class_type_flags_to_name
);
619 /* Register this machine's init routine. */
622 _initialize_ft32_tdep (void)
624 register_gdbarch_init (bfd_arch_ft32
, ft32_gdbarch_init
);