xref: /openbmc/u-boot/doc/README.bedbug (revision 9d62f20d0861ef87460d073dc189c851715b46ae)
1e2211743SwdenkBEDBUG Support for U-Boot
2e2211743Swdenk--------------------------
3e2211743Swdenk
4e2211743SwdenkThese changes implement the bedbug (emBEDded deBUGger) debugger in U-Boot.
50c8721a4SWolfgang DenkA specific implementation is made for the AMCC 405 processor but other flavors
6e2211743Swdenkcan be easily implemented.
7e2211743Swdenk
8e2211743Swdenk#####################
9e2211743Swdenk### Modifications ###
10e2211743Swdenk#####################
11e2211743Swdenk
12e2211743Swdenk./common/Makefile
13e2211743Swdenk	Included cmd_bedbug.c and bedbug.c in the Makefile.
14e2211743Swdenk
15e2211743Swdenk./common/command.c
16e2211743Swdenk	Added bedbug commands to command table.
17e2211743Swdenk
18e2211743Swdenk./common/board.c
19e2211743Swdenk	Added call to initialize debugger on startup.
20e2211743Swdenk
21*a47a12beSStefan Roese./arch/powerpc/cpu/ppc4xx/Makefile
22e2211743Swdenk	Added bedbug_405.c to the Makefile.
23e2211743Swdenk
24*a47a12beSStefan Roese./arch/powerpc/cpu/ppc4xx/start.S
25e2211743Swdenk	Added code to handle the debug exception (0x2000) on the 405.
26e2211743Swdenk	Also added code to handle critical exceptions since the debug
27e2211743Swdenk	is treated as critical on the 405.
28e2211743Swdenk
29*a47a12beSStefan Roese./arch/powerpc/cpu/ppc4xx/traps.c
30e2211743Swdenk	Added more detailed output for the program exception to tell
31e2211743Swdenk	if it is an illegal instruction, privileged instruction or
32e2211743Swdenk	a trap. Also added debug trap handler.
33e2211743Swdenk
34e2211743Swdenk./include/ppc_asm.tmpl
35e2211743Swdenk	Added code to handle critical exceptions
36e2211743Swdenk
37e2211743Swdenk#################
38e2211743Swdenk### New Stuff ###
39e2211743Swdenk#################
40e2211743Swdenk
41e2211743Swdenk./include/bedbug/ppc.h
42e2211743Swdenk./include/bedbug/regs.h
43e2211743Swdenk./include/bedbug/bedbug.h
44e2211743Swdenk./include/bedbug/elf.h		[obsoleted by new include/elf.h]
45e2211743Swdenk./include/bedbug/tables.h
46e2211743Swdenk./include/cmd_bedbug.h
47e2211743Swdenk./common/cmd_bedbug.c
48e2211743Swdenk./common/bedbug.c
49e2211743Swdenk	Bedbug library includes code for assembling and disassembling
50e2211743Swdenk	PowerPC instructions to/from memory as well as handling
51e2211743Swdenk	hardware breakpoints and stepping through code.  These
52e2211743Swdenk	routines are common to all PowerPC processors.
53e2211743Swdenk
54*a47a12beSStefan Roese./arch/powerpc/cpu/ppc4xx/bedbug_405.c
550c8721a4SWolfgang Denk	AMCC  PPC405 specific debugger routines.
56e2211743Swdenk
57e2211743Swdenk
58e2211743SwdenkBedbug support for the MPC860
59e2211743Swdenk-----------------------------
60e2211743Swdenk
61e2211743SwdenkChanges:
62e2211743Swdenk
63e2211743Swdenk	common/cmd_bedbug.c
64e2211743Swdenk		Added call to initialize 860 debugger.
65e2211743Swdenk
66*a47a12beSStefan Roese	arch/powerpc/cpu/mpc8xx/Makefile
67e2211743Swdenk		Added new file "bedbug_860.c" to the makefile
68e2211743Swdenk
69*a47a12beSStefan Roese	arch/powerpc/cpu/mpc8xx/start.S
70e2211743Swdenk		Added handler for InstructionBreakpoint (0xfd00)
71e2211743Swdenk
72*a47a12beSStefan Roese	arch/powerpc/cpu/mpc8xx/traps.c
73e2211743Swdenk		Added new routine DebugException()
74e2211743Swdenk
75e2211743SwdenkNew Files:
76e2211743Swdenk
77*a47a12beSStefan Roese	arch/powerpc/cpu/mpc8xx/bedbug_860.c
78e2211743Swdenk		CPU-specific routines for 860 debug registers.
79