mirror of
https://gitlab.rtems.org/rtems/rtos/rtems.git
synced 2026-08-28 10:39:29 +08:00
2009-05-05 Michael Walle <michael@walle.cc>
* shared/gdbstub/README, shared/gdbstub/gdb_if.h, shared/gdbstub/lm32-debug.S, shared/gdbstub/lm32-stub.c: New files.
This commit is contained in:
Joel Sherrill
@@ -1,3 +1,8 @@
|
||||
2009-05-05 Michael Walle <michael@walle.cc>
|
||||
|
||||
* shared/gdbstub/README, shared/gdbstub/gdb_if.h,
|
||||
shared/gdbstub/lm32-debug.S, shared/gdbstub/lm32-stub.c: New files.
|
||||
|
||||
2009-04-28 Chris Johns <chrisj@rtems.org>
|
||||
|
||||
* shared/start/start.S: Update for boot_card command line change.
|
||||
|
||||
@@ -0,0 +1,86 @@
|
||||
#
|
||||
# $Id$
|
||||
#
|
||||
|
||||
This is a thread-aware gdb stub for the lm32 architecture. It has to be
|
||||
linked with the application, which should be debugged. The application has
|
||||
to call 'lm32_gdb_stub_install' to setup the stub.
|
||||
The stub remaps _all_ h/w exceptions to an own code (lm32-debug.S), which
|
||||
saves all the registers, calls the gdb stub and restores the registers again.
|
||||
The interrupt exceptions gets handled in a special way. Because we remapped
|
||||
this exception, we need to do
|
||||
- the same as the original one (in cpu_asm.S),
|
||||
- and, as we might use an ISR for breaking into a running application with
|
||||
gdb, we need to save all registers as well. To be backward compatible
|
||||
the missing callee saved registers gets appended to CPU_Interrupt_frame.
|
||||
There is a mapping in 'gdb_handle_break' for that.
|
||||
|
||||
To use this gdb stub, your bsp has to provide the following functions:
|
||||
- void gdb_put_debug_char(char c)
|
||||
Puts the given charater c to the debug console output. The function can
|
||||
block until the character can be written to the output buffer.
|
||||
|
||||
- char gdb_get_debug_char(void)
|
||||
Returns the character in the input buffer of the debug console. If no one
|
||||
is availabe, the function must block.
|
||||
|
||||
- void gdb_console_init()
|
||||
This function can be used to initialize the debug console. Additionally,
|
||||
it should set up the ISR for the debug console to call the function
|
||||
'gdb_handle_break', which is provided by the gdb stub and enable the
|
||||
interrupt for a break symbol on the debug serial port. If no ISR is
|
||||
provided, you won't be able to interrupt a running application.
|
||||
|
||||
- void gdb_ack_irq()
|
||||
If an ISR is used, this function is used to acknowledge the interrupt.
|
||||
|
||||
NOTE: the stub don't skip a hardcoded 'break' in the code. So you have to
|
||||
set the PC an instruction further in the debugger (set $pc += 4).
|
||||
|
||||
NOTE2: make sure you have the following CFLAGS set:
|
||||
-mbarrel-shift-enabled -mmultiply-enabled -mdivide-enabled
|
||||
-msign-extend-enabled
|
||||
Without the hardware support, it is done in software. Unfortunately, the
|
||||
stub also uses some shifts and multiplies. If you step through your code,
|
||||
there will be a chance that a breakpoint is set to one of that functions,
|
||||
which then causes an endless loop.
|
||||
|
||||
|
||||
EXAMPLES
|
||||
|
||||
char gdb_get_debug_char(void)
|
||||
{
|
||||
/* Wait until there is a byte in RXTX */
|
||||
while (!(uartread(LM32_UART_LSR) & LM32_UART_LSR_DR));
|
||||
|
||||
return (char) uartread(LM32_UART_RBR);
|
||||
}
|
||||
|
||||
void gdb_put_debug_char(char c)
|
||||
{
|
||||
/* Wait until RXTX is empty. */
|
||||
while (!(uartread(LM32_UART_LSR) & LM32_UART_LSR_THRE));
|
||||
uartwrite(LM32_UART_RBR, c);
|
||||
}
|
||||
|
||||
extern void gdb_handle_break(
|
||||
rtems_vector_number vector,
|
||||
CPU_Interrupt_frame *frame
|
||||
);
|
||||
void gdb_console_init()
|
||||
{
|
||||
rtems_isr_entry old;
|
||||
|
||||
/* enable interrupts */
|
||||
uartwrite(LM32_UART_IER, 1);
|
||||
|
||||
rtems_interrupt_catch((rtems_isr_entry) gdb_handle_break, DEBUG_UART_IRQ,
|
||||
&old);
|
||||
lm32_interrupt_unmask(1 << DEBUG_UART_IRQ);
|
||||
}
|
||||
|
||||
void gdb_ack_irq()
|
||||
{
|
||||
lm32_interrupt_ack(1 << DEBUG_UART_IRQ);
|
||||
}
|
||||
|
||||
@@ -0,0 +1,112 @@
|
||||
/*
|
||||
* gdb_if.h - definition of the interface between the stub and gdb
|
||||
*
|
||||
* THIS SOFTWARE IS NOT COPYRIGHTED
|
||||
*
|
||||
* The following software is offered for use in the public domain.
|
||||
* There is no warranty with regard to this software or its performance
|
||||
* and the user must accept the software "AS IS" with all faults.
|
||||
*
|
||||
* THE CONTRIBUTORS DISCLAIM ANY WARRANTIES, EXPRESS OR IMPLIED, WITH
|
||||
* REGARD TO THIS SOFTWARE INCLUDING BUT NOT LIMITED TO THE WARRANTIES
|
||||
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
|
||||
*
|
||||
* $Id$
|
||||
*/
|
||||
|
||||
#ifndef _GDB_IF_H
|
||||
#define _GDB_IF_H
|
||||
|
||||
/* Max number of threads in qM response */
|
||||
#define QM_MAX_THREADS (20)
|
||||
|
||||
struct rtems_gdb_stub_thread_info {
|
||||
char display[256];
|
||||
char name[256];
|
||||
char more_display[256];
|
||||
};
|
||||
|
||||
/*
|
||||
* Prototypes
|
||||
*/
|
||||
|
||||
int parse_zbreak(const char *in, int *type, unsigned char **addr, int *len);
|
||||
|
||||
char* mem2hstr(char *buf, const unsigned char *mem, int count);
|
||||
int hstr2mem(unsigned char *mem, const char *buf, int count);
|
||||
void set_mem_err(void);
|
||||
unsigned char get_byte(const unsigned char *ptr);
|
||||
void set_byte(unsigned char *ptr, int val);
|
||||
char* thread2vhstr(char *buf, int thread);
|
||||
char* thread2fhstr(char *buf, int thread);
|
||||
const char* fhstr2thread(const char *buf, int *thread);
|
||||
const char* vhstr2thread(const char *buf, int *thread);
|
||||
char* int2fhstr(char *buf, int val);
|
||||
char* int2vhstr(char *buf, int vali);
|
||||
const char* fhstr2int(const char *buf, int *ival);
|
||||
const char* vhstr2int(const char *buf, int *ival);
|
||||
int hstr2byte(const char *buf, int *bval);
|
||||
int hstr2nibble(const char *buf, int *nibble);
|
||||
|
||||
Thread_Control *rtems_gdb_index_to_stub_id(int);
|
||||
int rtems_gdb_stub_thread_support_ok(void);
|
||||
int rtems_gdb_stub_get_current_thread(void);
|
||||
int rtems_gdb_stub_get_next_thread(int);
|
||||
int rtems_gdb_stub_get_offsets(
|
||||
unsigned char **text_addr,
|
||||
unsigned char **data_addr,
|
||||
unsigned char **bss_addr
|
||||
);
|
||||
int rtems_gdb_stub_get_thread_regs(
|
||||
int thread,
|
||||
unsigned int *registers
|
||||
);
|
||||
int rtems_gdb_stub_set_thread_regs(
|
||||
int thread,
|
||||
unsigned int *registers
|
||||
);
|
||||
void rtems_gdb_process_query(
|
||||
char *inbuffer,
|
||||
char *outbuffer,
|
||||
int do_threads,
|
||||
int thread
|
||||
);
|
||||
|
||||
/* Exception IDs */
|
||||
#define LM32_EXCEPTION_RESET 0x0
|
||||
#define LM32_EXCEPTION_INST_BREAKPOINT 0x1
|
||||
#define LM32_EXCEPTION_INST_BUS_ERROR 0x2
|
||||
#define LM32_EXCEPTION_DATA_BREAKPOINT 0x3
|
||||
#define LM32_EXCEPTION_DATA_BUS_ERROR 0x4
|
||||
#define LM32_EXCEPTION_DIVIDE_BY_ZERO 0x5
|
||||
#define LM32_EXCEPTION_INTERRUPT 0x6
|
||||
#define LM32_EXCEPTION_SYSTEM_CALL 0x7
|
||||
|
||||
/* Breakpoint instruction */
|
||||
#define LM32_BREAK 0xac000002UL
|
||||
|
||||
/* This numbering must be consistant with GDBs numbering in gdb/lm32-tdep.c */
|
||||
enum lm32_regnames {
|
||||
LM32_REG_R0, LM32_REG_R1, LM32_REG_R2, LM32_REG_R3, LM32_REG_R4, LM32_REG_R5,
|
||||
LM32_REG_R6, LM32_REG_R7, LM32_REG_R8, LM32_REG_R9, LM32_REG_R10,
|
||||
LM32_REG_R11, LM32_REG_R12, LM32_REG_R13, LM32_REG_R14, LM32_REG_R15,
|
||||
LM32_REG_R16, LM32_REG_R17, LM32_REG_R18, LM32_REG_R19, LM32_REG_R20,
|
||||
LM32_REG_R21, LM32_REG_R22, LM32_REG_R23, LM32_REG_R24, LM32_REG_R25,
|
||||
LM32_REG_GP, LM32_REG_FP, LM32_REG_SP, LM32_REG_RA, LM32_REG_EA, LM32_REG_BA,
|
||||
LM32_REG_PC, LM32_REG_EID, LM32_REG_EBA, LM32_REG_DEBA, LM32_REG_IE, NUM_REGS
|
||||
};
|
||||
|
||||
/* keep this in sync with the debug isr handler in lm32-debug.S */
|
||||
enum lm32_int_regnames {
|
||||
LM32_INT_REG_R1, LM32_INT_REG_R2, LM32_INT_REG_R3, LM32_INT_REG_R4,
|
||||
LM32_INT_REG_R5, LM32_INT_REG_R6, LM32_INT_REG_R7, LM32_INT_REG_R8,
|
||||
LM32_INT_REG_R9, LM32_INT_REG_R10, LM32_INT_REG_RA, LM32_INT_REG_EA,
|
||||
LM32_INT_REG_BA, LM32_INT_REG_R11, LM32_INT_REG_R12, LM32_INT_REG_R13,
|
||||
LM32_INT_REG_R14, LM32_INT_REG_R15, LM32_INT_REG_R16, LM32_INT_REG_R17,
|
||||
LM32_INT_REG_R18, LM32_INT_REG_R19, LM32_INT_REG_R20, LM32_INT_REG_R21,
|
||||
LM32_INT_REG_R22, LM32_INT_REG_R23, LM32_INT_REG_R24, LM32_INT_REG_R25,
|
||||
LM32_INT_REG_GP, LM32_INT_REG_FP, LM32_INT_REG_SP, LM32_INT_REG_PC,
|
||||
LM32_INT_REG_EID, LM32_INT_REG_EBA, LM32_INT_REG_DEBA, LM32_INT_REG_IE,
|
||||
};
|
||||
|
||||
#endif /* _GDB_IF_H */
|
||||
@@ -0,0 +1,340 @@
|
||||
/*
|
||||
* lm32 debug exception vectors
|
||||
*
|
||||
* Michael Walle <michael@walle.cc>, 2009
|
||||
*
|
||||
* If debugging is enabled the debug exception base address (deba) gets
|
||||
* remapped to this file.
|
||||
*
|
||||
* The license and distribution terms for this file may be
|
||||
* found in the file LICENSE in this distribution or at
|
||||
* http://www.rtems.com/license/LICENSE.
|
||||
*
|
||||
* $Id$
|
||||
*
|
||||
*/
|
||||
|
||||
#include "bspopts.h"
|
||||
|
||||
.section .text
|
||||
/* (D)EBA alignment */
|
||||
.align 256
|
||||
.globl _deba
|
||||
|
||||
_deba:
|
||||
debug_reset_handler:
|
||||
/* Clear r0 */
|
||||
xor r0,r0,r0
|
||||
/* Disable interrupts */
|
||||
wcsr IE, r0
|
||||
/* Mask all interrupts */
|
||||
wcsr IM,r0
|
||||
/* Jump to original crt0 */
|
||||
.extern crt0
|
||||
mvhi r1, hi(crt0)
|
||||
ori r1, r1, lo(crt0)
|
||||
b r1
|
||||
nop
|
||||
nop
|
||||
debug_breakpoint_handler:
|
||||
/* Clear r0 in case it was corrupted */
|
||||
xor r0, r0, r0
|
||||
mvhi r0, hi(registers)
|
||||
ori r0, r0, lo(registers)
|
||||
sw (r0+116), ra
|
||||
sw (r0+128), ba
|
||||
calli save_all
|
||||
calli handle_exception
|
||||
calli b_restore_and_return
|
||||
debug_instruction_bus_error_handler:
|
||||
/* Clear r0 in case it was corrupted */
|
||||
xor r0, r0, r0
|
||||
mvhi r0, hi(registers)
|
||||
ori r0, r0, lo(registers)
|
||||
sw (r0+116), ra
|
||||
sw (r0+128), ea
|
||||
calli save_all
|
||||
calli handle_exception
|
||||
calli e_restore_and_return
|
||||
debug_watchpoint_handler:
|
||||
/* Clear r0 in case it was corrupted */
|
||||
xor r0, r0, r0
|
||||
mvhi r0, hi(registers)
|
||||
ori r0, r0, lo(registers)
|
||||
sw (r0+116), ra
|
||||
sw (r0+128), ba
|
||||
calli save_all
|
||||
calli handle_exception
|
||||
calli b_restore_and_return
|
||||
debug_data_bus_error_handler:
|
||||
/* Clear r0 in case it was corrupted */
|
||||
xor r0, r0, r0
|
||||
mvhi r0, hi(registers)
|
||||
ori r0, r0, lo(registers)
|
||||
sw (r0+116), ra
|
||||
sw (r0+128), ea
|
||||
calli save_all
|
||||
calli handle_exception
|
||||
calli e_restore_and_return
|
||||
debug_divide_by_zero_handler:
|
||||
/* Clear r0 in case it was corrupted */
|
||||
xor r0, r0, r0
|
||||
mvhi r0, hi(registers)
|
||||
ori r0, r0, lo(registers)
|
||||
sw (r0+116), ra
|
||||
sw (r0+128), ea
|
||||
calli save_all
|
||||
calli handle_exception
|
||||
calli e_restore_and_return
|
||||
debug_interrupt_handler:
|
||||
bi debug_isr_handler
|
||||
nop
|
||||
nop
|
||||
nop
|
||||
nop
|
||||
nop
|
||||
nop
|
||||
nop
|
||||
debug_system_call_handler:
|
||||
/* Clear r0 in case it was corrupted */
|
||||
xor r0, r0, r0
|
||||
mvhi r0, hi(registers)
|
||||
ori r0, r0, lo(registers)
|
||||
sw (r0+116), ra
|
||||
sw (r0+128), ea
|
||||
calli save_all
|
||||
calli handle_exception
|
||||
calli e_restore_and_return
|
||||
|
||||
debug_isr_handler:
|
||||
addi sp, sp, -156
|
||||
sw (sp+4), r1
|
||||
sw (sp+8), r2
|
||||
sw (sp+12), r3
|
||||
sw (sp+16), r4
|
||||
sw (sp+20), r5
|
||||
sw (sp+24), r6
|
||||
sw (sp+28), r7
|
||||
sw (sp+32), r8
|
||||
sw (sp+36), r9
|
||||
sw (sp+40), r10
|
||||
sw (sp+44), ra
|
||||
sw (sp+48), ea
|
||||
sw (sp+52), ba
|
||||
sw (sp+56), r11
|
||||
sw (sp+60), r12
|
||||
sw (sp+64), r13
|
||||
sw (sp+68), r14
|
||||
sw (sp+72), r15
|
||||
sw (sp+76), r16
|
||||
sw (sp+80), r17
|
||||
sw (sp+84), r18
|
||||
sw (sp+88), r19
|
||||
sw (sp+92), r20
|
||||
sw (sp+96), r21
|
||||
sw (sp+100), r22
|
||||
sw (sp+104), r23
|
||||
sw (sp+108), r24
|
||||
sw (sp+112), r25
|
||||
sw (sp+116), r26
|
||||
sw (sp+120), r27
|
||||
/* 124 - SP */
|
||||
addi r1, sp, 156
|
||||
sw (sp+124), r1
|
||||
/* 128 - PC */
|
||||
sw (sp+128), ea
|
||||
/* 132 - EID */
|
||||
mvi r1, 6
|
||||
sw (sp+132), r1
|
||||
rcsr r1, EBA
|
||||
sw (sp+136), r1
|
||||
rcsr r1, DEBA
|
||||
sw (sp+140), r1
|
||||
rcsr r1, IE
|
||||
sw (sp+144), r1
|
||||
|
||||
/* This is the same code as in cpu_asm.S */
|
||||
rcsr r2, IP
|
||||
rcsr r3, IM
|
||||
mv r1, r0
|
||||
and r2, r2, r3
|
||||
mvi r3, 1
|
||||
be r2, r0, 3f
|
||||
1:
|
||||
and r4, r2, r3
|
||||
bne r4, r0, 2f
|
||||
sli r3, r3, 1
|
||||
addi r1, r1, 1
|
||||
bi 1b
|
||||
2:
|
||||
addi r2, sp, 4
|
||||
|
||||
.extern __ISR_Handler
|
||||
mvhi r3, hi(__ISR_Handler)
|
||||
ori r3, r3, lo(__ISR_Handler)
|
||||
call r3
|
||||
3:
|
||||
lw r1, (sp+4)
|
||||
lw r2, (sp+8)
|
||||
lw r3, (sp+12)
|
||||
lw r4, (sp+16)
|
||||
lw r5, (sp+20)
|
||||
lw r6, (sp+24)
|
||||
lw r7, (sp+28)
|
||||
lw r8, (sp+32)
|
||||
lw r9, (sp+36)
|
||||
lw r10, (sp+40)
|
||||
lw ra, (sp+44)
|
||||
lw ea, (sp+48)
|
||||
lw ba, (sp+52)
|
||||
lw r11, (sp+56)
|
||||
lw r12, (sp+60)
|
||||
lw r13, (sp+64)
|
||||
lw r14, (sp+68)
|
||||
lw r15, (sp+72)
|
||||
lw r16, (sp+76)
|
||||
lw r17, (sp+80)
|
||||
lw r18, (sp+84)
|
||||
lw r19, (sp+88)
|
||||
lw r20, (sp+92)
|
||||
lw r21, (sp+96)
|
||||
lw r22, (sp+100)
|
||||
lw r23, (sp+104)
|
||||
lw r24, (sp+108)
|
||||
lw r25, (sp+112)
|
||||
lw r26, (sp+116)
|
||||
lw r27, (sp+120)
|
||||
lw ea, (sp+136)
|
||||
wcsr EBA, ea
|
||||
lw ea, (sp+140)
|
||||
wcsr DEBA, ea
|
||||
/* Restore EA from PC */
|
||||
lw ea, (sp+128)
|
||||
/* Stack pointer must be restored last, in case it has been updated */
|
||||
lw sp, (sp+124)
|
||||
eret
|
||||
|
||||
save_all:
|
||||
sw (r0+4), r1
|
||||
sw (r0+8), r2
|
||||
sw (r0+12), r3
|
||||
sw (r0+16), r4
|
||||
sw (r0+20), r5
|
||||
sw (r0+24), r6
|
||||
sw (r0+28), r7
|
||||
sw (r0+32), r8
|
||||
sw (r0+36), r9
|
||||
sw (r0+40), r10
|
||||
sw (r0+44), r11
|
||||
sw (r0+48), r12
|
||||
sw (r0+52), r13
|
||||
sw (r0+56), r14
|
||||
sw (r0+60), r15
|
||||
sw (r0+64), r16
|
||||
sw (r0+68), r17
|
||||
sw (r0+72), r18
|
||||
sw (r0+76), r19
|
||||
sw (r0+80), r20
|
||||
sw (r0+84), r21
|
||||
sw (r0+88), r22
|
||||
sw (r0+92), r23
|
||||
sw (r0+96), r24
|
||||
sw (r0+100), r25
|
||||
sw (r0+104), r26
|
||||
sw (r0+108), r27
|
||||
sw (r0+112), sp
|
||||
/* 116 - RA - saved in handler code above */
|
||||
sw (r0+120), ea
|
||||
sw (r0+124), ba
|
||||
/* 128 - PC - saved in handler code above */
|
||||
/* 132 - EID - saved below */
|
||||
rcsr r1, EBA
|
||||
sw (r0+136), r1
|
||||
rcsr r1, DEBA
|
||||
sw (r0+140), r1
|
||||
rcsr r1, IE
|
||||
sw (r0+144), r1
|
||||
|
||||
/* Work out EID from exception entry point address */
|
||||
andi r1, ra, 0xff
|
||||
srui r1, r1, 5
|
||||
sw (r0+132), r1
|
||||
|
||||
/* Save pointer to registers */
|
||||
mv r1, r0
|
||||
|
||||
/* Restore r0 to 0 */
|
||||
xor r0, r0, r0
|
||||
|
||||
/* Save r0 (hardcoded to 0) */
|
||||
sw (r1+0), r0
|
||||
ret
|
||||
|
||||
|
||||
/* Restore gp registers */
|
||||
restore_gp:
|
||||
lw r1, (r0+4)
|
||||
lw r2, (r0+8)
|
||||
lw r3, (r0+12)
|
||||
lw r4, (r0+16)
|
||||
lw r5, (r0+20)
|
||||
lw r6, (r0+24)
|
||||
lw r7, (r0+28)
|
||||
lw r8, (r0+32)
|
||||
lw r9, (r0+36)
|
||||
lw r10, (r0+40)
|
||||
lw r11, (r0+44)
|
||||
lw r12, (r0+48)
|
||||
lw r13, (r0+52)
|
||||
lw r14, (r0+56)
|
||||
lw r15, (r0+60)
|
||||
lw r16, (r0+64)
|
||||
lw r17, (r0+68)
|
||||
lw r18, (r0+72)
|
||||
lw r19, (r0+76)
|
||||
lw r20, (r0+80)
|
||||
lw r21, (r0+84)
|
||||
lw r22, (r0+88)
|
||||
lw r23, (r0+92)
|
||||
lw r24, (r0+96)
|
||||
lw r25, (r0+100)
|
||||
lw r26, (r0+104)
|
||||
lw r27, (r0+108)
|
||||
ret
|
||||
|
||||
/* Restore registers and return from exception */
|
||||
e_restore_and_return:
|
||||
/* first restore gp registers */
|
||||
mvhi r0, hi(registers)
|
||||
ori r0, r0, lo(registers)
|
||||
calli restore_gp
|
||||
lw sp, (r0+112)
|
||||
lw ra, (r0+116)
|
||||
lw ba, (r0+124)
|
||||
lw ea, (r0+136)
|
||||
wcsr EBA, ea
|
||||
lw ea, (r0+140)
|
||||
wcsr DEBA, ea
|
||||
/* Restore EA from PC */
|
||||
lw ea, (r0+128)
|
||||
xor r0, r0, r0
|
||||
eret
|
||||
|
||||
/* Restore registers and return from breakpoint */
|
||||
b_restore_and_return:
|
||||
/* first restore gp registers */
|
||||
mvhi r0, hi(registers)
|
||||
ori r0, r0, lo(registers)
|
||||
calli restore_gp
|
||||
lw sp, (r0+112)
|
||||
lw ra, (r0+116)
|
||||
lw ea, (r0+120)
|
||||
lw ba, (r0+136)
|
||||
wcsr EBA, ba
|
||||
lw ba, (r0+140)
|
||||
wcsr DEBA, ba
|
||||
/* Restore BA from PC */
|
||||
lw ba, (r0+128)
|
||||
xor r0, r0, r0
|
||||
bret
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
Reference in New Issue
Block a user