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