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 IBM405 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/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
  64 Bedbug support for the MPC860
  65 -----------------------------
  66
  67 Changes:
  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
  85 New Files:
  86
  87         cpu/mpc8xx/bedbug_860.c
  88                 CPU-specific routines for 860 debug registers.