xref: /openbmc/u-boot/doc/README.bedbug (revision a562e1bd)
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 IBM405 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./cpu/ppc4xx/Makefile
22	Added bedbug_405.c to the Makefile.
23
24./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./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/cmd_confdefs.h
35	Added definition of CFG_CMD_BEDBUG.
36
37./include/config_WALNUT405.h
38	Added CFG_CMD_BEDBUG to the CONFIG_COMMANDS for the WALNUT.
39
40./include/ppc_asm.tmpl
41	Added code to handle critical exceptions
42
43#################
44### New Stuff ###
45#################
46
47./include/bedbug/ppc.h
48./include/bedbug/regs.h
49./include/bedbug/bedbug.h
50./include/bedbug/elf.h		[obsoleted by new include/elf.h]
51./include/bedbug/tables.h
52./include/cmd_bedbug.h
53./common/cmd_bedbug.c
54./common/bedbug.c
55	Bedbug library includes code for assembling and disassembling
56	PowerPC instructions to/from memory as well as handling
57	hardware breakpoints and stepping through code.  These
58	routines are common to all PowerPC processors.
59
60./cpu/ppc4xx/bedbug_405.c
61	IBM PPC405 specific debugger routines.
62
63
64Bedbug support for the MPC860
65-----------------------------
66
67Changes:
68
69	common/cmd_bedbug.c
70		Added call to initialize 860 debugger.
71
72	cpu/mpc8xx/Makefile
73		Added new file "bedbug_860.c" to the makefile
74
75	cpu/mpc8xx/start.S
76		Added handler for InstructionBreakpoint (0xfd00)
77
78	cpu/mpc8xx/traps.c
79		Added new routine DebugException()
80
81	include/config_MBX.h
82		Added CFG_CMD_BEDBUG to CONFIG_COMMANDS define
83
84
85New Files:
86
87	cpu/mpc8xx/bedbug_860.c
88		CPU-specific routines for 860 debug registers.
89