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/doc/README.COBRA5272 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 ./include/configs/cobra5272.h
  81
  82                 CONFIG_MONITOR_IS_IN_RAM has to be undefined, e. g. as follows:
  83
  84                 #if 0
  85                         #define CONFIG_MONITOR_IS_IN_RAM
  86                         /* define if monitor is started from a pre-loader */
  87                 #endif
  88
  89         => u-boot as single bootloader starting from flash
  90
  91
  92         in board/cobra5272/config.mk CONFIG_SYS_TEXT_BASE should be
  93
  94                 CONFIG_SYS_TEXT_BASE = 0xffe00000
  95
  96         => linking address for u-boot as single bootloader stored in flash
  97
  98 then:
  99
 100         host> make cobra5272_config
 101                 rm -f include/config.h include/config.mk
 102                 Configuring for cobra5272 board...
 103         host> make
 104                 [...]
 105
 106         host> cp u-boot.bin /tftpboot/u-boot_flash.bin
 107
 108
 109 ------------------------------
 110 RAM version
 111 ------------------------------
 112
 113 in dir ./u-boot-x-x-x/
 114
 115         host> make distclean
 116
 117 please modify the settings:
 118
 119         in ./include/configs/cobra5272.h
 120
 121                 CONFIG_MONITOR_IS_IN_RAM now has to be defined, e. g. as follows:
 122
 123                 #if 1
 124                         #define CONFIG_MONITOR_IS_IN_RAM
 125                         /*define if monitor is started from a pre-loader */
 126                 #endif
 127
 128         => u-boot as RAM version, chainloaded by another bootloader or using bdm cable
 129
 130
 131         in board/cobra5272/config.mk CONFIG_SYS_TEXT_BASE should be
 132
 133                 CONFIG_SYS_TEXT_BASE = 0x00020000
 134
 135         => target linking address for RAM
 136
 137
 138 then:
 139
 140         host> make cobra5272_config
 141                 rm -f include/config.h include/config.mk
 142                 Configuring for cobra5272 board...
 143         host> make
 144                 [...]
 145
 146         host> cp u-boot.bin /tftpboot/u-boot_ram.bin
 147
 148
 149 ----
 150 HINT
 151 ----
 152
 153 If the m68k-elf-toolchain & the m68k-bdm-gdb is installed you can run the RAM
 154 version by typing (in dir ./u-boot-x-x-x/)
 155 "board/cobra5272/bdm/load-cobra_uboot" ,
 156 in ./u-boot-x-x-x/ the RAM version u-boot (elf format) has to be available.