packages/hal/arm/integrator/v2_0/src/Notes_GDB_stub

   1 ===========================================================================
   2 #####ECOSGPLCOPYRIGHTBEGIN####
   3 ## -------------------------------------------
   4 ## This file is part of eCos, the Embedded Configurable Operating System.
   5 ## Copyright (C) 1998, 1999, 2000, 2001, 2002 Red Hat, Inc.
   6 ##
   7 ## eCos is free software; you can redistribute it and/or modify it under
   8 ## the terms of the GNU General Public License as published by the Free
   9 ## Software Foundation; either version 2 or (at your option) any later version.
  10 ##
  11 ## eCos is distributed in the hope that it will be useful, but WITHOUT ANY
  12 ## WARRANTY; without even the implied warranty of MERCHANTABILITY or
  13 ## FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  14 ## for more details.
  15 ##
  16 ## You should have received a copy of the GNU General Public License along
  17 ## with eCos; if not, write to the Free Software Foundation, Inc.,
  18 ## 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
  19 ##
  20 ## As a special exception, if other files instantiate templates or use macros
  21 ## or inline functions from this file, or you compile this file and link it
  22 ## with other works to produce a work based on this file, this file does not
  23 ## by itself cause the resulting work to be covered by the GNU General Public
  24 ## License. However the source code for this file must still be made available
  25 ## in accordance with section (3) of the GNU General Public License.
  26 ##
  27 ## This exception does not invalidate any other reasons why a work based on
  28 ## this file might be covered by the GNU General Public License.
  29 ##
  30 ## Alternative licenses for eCos may be arranged by contacting Red Hat, Inc.
  31 ## at http://sources.redhat.com/ecos/ecos-license/
  32 ## -------------------------------------------
  33 #####ECOSGPLCOPYRIGHTEND####
  34 ===========================================================================
  35
  36 How to build and install the GDB module on ARM Integrator
  37
  38 Make GDB module
  39 ~~~~~~~~~~~~~~~
  40 Configure and build using the 'stubs' template for the PID
  41 target. These are the necessary CLI instructions. It can also be done
  42 from the Configtool by selecting the appropriate templates.
  43
  44  % cd /tmp
  45  % mkdir stubs
  46  % cd stubs
  47  % ecosconfig new integrator stubs
  48  % ecosconfig tree
  49  % make
  50
  51 This will install some files in ./install/bin:
  52
  53  gdb_module.elf:   The built stubs image
  54  gdb_module.bin:   The image converted to binary (suitable for burning to ROM)
  55  gdb_module.img:   The relocated ELF image (suitable for FLASH writing, see below)
  56
  57
  58 Prepare board for eCos
  59 ~~~~~~~~~~~~~~~~~~~~~~
  60
  61 Program FLASH
  62 ~~~~~~~~~~~~~
  63 The GDB module can be programmed into the begining of the user flash using an ARM debugger
  64 connected to the board either via Angel or Multi-ICE.
  65