doc/README.bedbug

   1 BEDBUG Support for U-Boot
   2 --------------------------
   3
   4 These changes implement the bedbug (emBEDded deBUGger) debugger in U-Boot.
   5 A specific implementation is made for the AMCC 405 processor but other flavors
   6 can 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
  58 Bedbug support for the MPC860
  59 -----------------------------
  60
  61 Changes:
  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
  75 New Files:
  76
  77         arch/powerpc/cpu/mpc8xx/bedbug_860.c
  78                 CPU-specific routines for 860 debug registers.