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