board/cobra5272/README

   1 File:           README.COBRA5272
   2 Author:         Florian Schlote for Sentec elektronik (linux@sentec-elektronik.de)
   3 Contents:       This is the README of u-boot (Universal bootloader) for our
   4                 COBRA5272 board.
   5 Version:        v01.00
   6 Date:           Tue Mar 30 00:28:33 CEST 2004
   7 License:        This document is published under the GNU GPL
   8 ______________________________________________________________________
   9
  10 CHANGES
  11 040330   v01.00 Creation
  12
  13 ______________________________________________________________________
  14
  15
  16 CONFIGURING
  17 -----------
  18
  19 1. Modify include/configs/cobra5272.h acc. to your prefs
  20
  21 2. If necessary, modify board/cobra5272/config.mk (see below)
  22
  23 3.
  24
  25 > make cobra5272_config
  26
  27 > make
  28
  29
  30 Please refer to u-boot README (general info, u-boot-x-x-x/README),
  31 to u-boot-x-x-x/board/cobra5272/README and
  32 to the comments in u-boot-x-x-x/include/configs/cobra5272.h
  33
  34 Configuring u-boot is done by commenting/uncommenting preprocessor defines.
  35
  36 Default configuration is
  37
  38         FLASH version (for further info see subsection below)
  39         link address 0xffe00000
  40
  41         16 MB RAM
  42
  43         network enabled
  44         no default IP address for target, host set, no MACaddress set
  45
  46         bootdelay for autoboot 5 sec.
  47         autoboot disabled
  48
  49
  50 #-----------------------------------
  51 # u-boot FLASH version & RAM version
  52 #-----------------------------------
  53
  54 The u-boot bootloader for Coldfire processors can be configured
  55
  56         1. as a standalone bootloader residing in flash & relocating itself to RAM on
  57         startup automatically => "FLASH version"
  58
  59         2. as a RAM version which will not load from flash automatically as it needs a
  60         prestage bootloader ("chainloading") & is running only from the RAM address it
  61         is linked to => "RAM version"
  62
  63         This version may be very helpful when installing u-boot for the first time
  64         since it can be used to make available s. th. like a "bootstrap
  65         mechanism".
  66
  67
  68 How to build the different images:
  69
  70 ------------------------------
  71 Flash version
  72 ------------------------------
  73
  74 Compile u-boot
  75
  76 in dir ./u-boot-x-x-x/
  77
  78 please first check:
  79
  80         in ./configs/cobra5272_defconfig
  81
  82                 CONFIG_MONITOR_IS_IN_RAM has to be not present in the file
  83
  84         => u-boot as single bootloader starting from flash
  85
  86
  87         in configs/cobra5272_defconfig CONFIG_TEXT_BASE should be
  88
  89                 CONFIG_TEXT_BASE=0xffe00000
  90
  91         => linking address for u-boot as single bootloader stored in flash
  92
  93 then:
  94
  95         host> make cobra5272_config
  96                 rm -f include/config.h include/config.mk
  97                 Configuring for cobra5272 board...
  98         host> make
  99                 [...]
 100
 101         host> cp u-boot.bin /tftpboot/u-boot_flash.bin
 102
 103
 104 ------------------------------
 105 RAM version
 106 ------------------------------
 107
 108 in dir ./u-boot-x-x-x/
 109
 110         host> make distclean
 111
 112 please modify the settings:
 113         in ./configs/cobra5272_defconfig
 114
 115                 CONFIG_MONITOR_IS_IN_RAM now has to be enabled, e. g. as follows:
 116
 117                 CONFIG_MONITOR_IS_IN_RAM=y
 118
 119         => u-boot as RAM version, chainloaded by another bootloader or using bdm cable
 120
 121
 122         in configs/cobra5272_defconfig CONFIG_TEXT_BASE should be
 123
 124                 CONFIG_TEXT_BASE=0x00020000
 125
 126         => target linking address for RAM
 127
 128
 129 then:
 130
 131         host> make cobra5272_config
 132                 rm -f include/config.h include/config.mk
 133                 Configuring for cobra5272 board...
 134         host> make
 135                 [...]
 136
 137         host> cp u-boot.bin /tftpboot/u-boot_ram.bin
 138
 139
 140 ----
 141 HINT
 142 ----
 143
 144 If the m68k-elf-toolchain & the m68k-bdm-gdb is installed you can run the RAM
 145 version by typing (in dir ./u-boot-x-x-x/)
 146 "board/cobra5272/bdm/load-cobra_uboot" ,
 147 in ./u-boot-x-x-x/ the RAM version u-boot (elf format) has to be available.