arm_gdbstub_break.c File Reference

#include <stdlib.h>
#include <stdio.h>
#include <string.h>
#include <stdint.h>
#include <ctype.h>
#include <unistd.h>
#include "dbg_msg.h"
#include "jt_arm.h"
#include "jt_cortex.h"
#include "jt_flash.h"
#include "jt_mmu.h"
#include "arm_gdbstub.h"
#include "arm_memory_mmap.h"
#include "arm_gdbstub_break.h"

Functions

int InsertBreakpoint (uint32_t addr, int len, int watchORbreak)
int RemoveBreakpoint (uint32_t addr, int len, int watchORbreak)
int RemoveAllBreakpoints (void)
int isBreakpointListEmpty (void)
int isAddrOnBreakpointList (uint32_t addr)
int gdbSetupJtagTarget_Breakpoint (void)
int gdbWriteSoftwareBreakToRAM (void)
int checkActionNext (void)
void preparePossibleActionNext (uint32_t return_addr, uint32_t undo_addr, enum HaveBlUndoAddr undo_is_valid)
void cancelActionNext (void)
void undoAfterBlStep (struct reg_set *raw_regs)

Variables

struct breakpointContainer breakpointList

Detailed Description

Function Documentation

int InsertBreakpoint	(	uint32_t	addr,
		int	len,
		int	watchORbreak
	)

 support function to insert a new Addr to the Breakpoint List

 Since ICE-RT supports only two watchpoints
 we can have one of the three solutions:
              2 HWBkpt and nither SWBkpt nor Watch
 alternative	2 Watch and nither HWBkpt nor SWBkpt
 alternative  unlimited SWBkpt and either one HWBkpt or one SWBkpt

Parameters:

	watchORbreak	tells us if it is a watchpoint (=1) or a breakpoint (=0)
	len	tells us if it is an ARM (=4) or a Thumb (=2) instruction to break on
	addr	is the addess to break on

Return values:

	0	on success
	1	on Failure
	-1	if requeset not supported

Referenced by checkActionNext(), and gdb_handle_exception().

int RemoveBreakpoint	(	uint32_t	addr,
		int	len,
		int	watchORbreak
	)

 support function to remove a watch or breakpoint if it is on its List
 If a SW Break will be removed, its original instruction will be also restored back to RAM

Parameters:

	watchORbreak	tells us if it is a watchpoint (=1) or a breakpoint (=0)
	len	tells ARM (=4) or Thumb (=2) - still ignored
	addr	is the addess of the watch or break

Returns:: 0 on success or -1 if nothig happened

Referenced by gdb_handle_exception(), gdb_main_loop(), and gdb_monitor_Rcmd().

int RemoveAllBreakpoints ( void )

remove all breakpoints from (global) breakpointList

Returns:: 0

Referenced by gdb_main_loop().

int isBreakpointListEmpty ( void )

check if (global) breakpointList is empty

Return values:

	1	if empty
	0	if not empty

References DONT_HAVE_BL_RETURN, breakpointContainer::have_possible_bl_return_address, breakpointContainer::numberOfHWBkptEntrys, breakpointContainer::numberOfSWBkptEntrys, and breakpointContainer::numberOfWatchEntrys.

Referenced by gdb_handle_exception().

int isAddrOnBreakpointList ( uint32_t addr )

check if a given (virtual) address if already at the (global) breakpointList

Parameters:

addr

(virtual) address

Return values:

	1	yes addr is at breakpointList
	0	no addr not found

References breakpointContainer::bl_return_address, breakpointContainer::firstHWBkptEntry, breakpointContainer::firstSWBkptEntry, breakpointContainer::have_possible_bl_return_address, breakpointEntry::len, breakpointEntry::nextBkptEntry, breakpointContainer::numberOfHWBkptEntrys, breakpointContainer::numberOfSWBkptEntrys, VALID_BL_RETURN, and breakpointEntry::virt_addr.

Referenced by gdb_action_continue(), gdb_action_step(), and gdb_main_loop().

int gdbSetupJtagTarget_Breakpoint ( void )

write HW breakpoints and/or SW break-pattern into ICE_RT or FPB/DWT (via JTAG)

Parameters:

-

Returns:: 0

References breakpointEntry::access, DBG_LEVEL_GDB_ARM_WARN, dbgPrintf(), breakpointContainer::firstHWBkptEntry, breakpointContainer::firstWatchEntry, jtag_arm_IceRT_PutHWBreakPoint0(), jtag_arm_IceRT_PutHWBreakPoint1(), jtag_arm_IceRT_PutSWBreakPoint0(), jtag_arm_IceRT_PutSWBreakPoint1(), jtag_arm_IceRT_PutWatchPoint0(), jtag_arm_IceRT_PutWatchPoint1(), jtag_cortex_dwt_PutWatchPoint(), jtag_cortex_fpb_PutHWBreakPoint(), breakpointEntry::len, breakpointEntry::nextBkptEntry, breakpointContainer::numberOfHWBkptEntrys, breakpointContainer::numberOfSWBkptEntrys, breakpointContainer::numberOfWatchEntrys, and breakpointEntry::virt_addr.

Referenced by gdb_action_continue().

int gdbWriteSoftwareBreakToRAM ( void )

write SW break pattern of any SW-breakpoint into RAM

Parameters:

-

Returns:: 0

References breakpointContainer::firstSWBkptEntry, gdb_write_mem(), gdb_writeback_Ram(), breakpointEntry::len, breakpointEntry::nextBkptEntry, breakpointContainer::numberOfHWBkptEntrys, breakpointContainer::numberOfSWBkptEntrys, and breakpointEntry::phys_addr.

Referenced by gdb_action_continue().

int checkActionNext ( void )

support function to check if we have seen a special breakpoint of the GDB "next" instruction. If so, and if we are still having free breakpoint resources; Insert this breakpoint, now. If there are not enouth resources; Return True, to emulte this by doing a lot of Step intruction.

Parameters:

-

Return values:

	1	try emulateing NEXT by doing autoStep
	0	do not emulate NEXT

References allocateGdbSprintfBuf(), breakpointContainer::bl_return_address, breakpointContainer::bl_return_len, BUFMAX, CB_ACTION_NON, DBG_LEVEL_GDB_ARM_INFO, dbgPrintf(), DONT_HAVE_BL_RETURN, DONT_HAVE_BL_UNDO, gdbPrintf(), breakpointContainer::have_bl_undo_address, breakpointContainer::have_possible_bl_return_address, InsertBreakpoint(), jtag_cortex_fpb_get_maxBreakpoints(), breakpointContainer::numberOfHWBkptEntrys, breakpointContainer::numberOfSWBkptEntrys, breakpointContainer::numberOfWatchEntrys, and VALID_BL_RETURN.

Referenced by gdb_action_continue().

void preparePossibleActionNext	(	uint32_t	return_addr,
		uint32_t	undo_addr,
		enum HaveBlUndoAddr	undo_is_valid
	)

 if we have seen a valid ARM (or Thumb) branch and link instruction
 add it (for a possible GDB "next") 
 if this "next" will be issued after a "step"
 add the address of the bl itself, too (so we can do an undo if setting breakpoints fails)
 also we keep the Mode of the "step" in mind, as
 undo_is_valid == 1 was ARM
 undo_is_valid == 2 was THUMB

Parameters: