doc/README.m54418twr

   1 Freescale MCF54418TWR ColdFire Development Board
   2 ================================================
   3
   4 TsiChung Liew(Tsi-Chung.Liew@freescale.com)
   5 Created Mar 22, 2012
   6 ===========================================
   7
   8
   9 Changed files:
  10 ==============
  11
  12 - board/freescale/m54418twr/m54418twr.c Dram setup
  13 - board/freescale/m54418twr/Makefile    Makefile
  14 - board/freescale/m54418twr/config.mk   config make
  15 - board/freescale/m54418twr/u-boot.lds  Linker description
  16 - board/freescale/m54418twr/sbf_dram_init.S
  17                                         DDR/SDRAM initialization
  18
  19 - arch/m68k/cpu/mcf5445x/cpu.c          cpu specific code
  20 - arch/m68k/cpu/mcf5445x/cpu_init.c     Flexbus ChipSelect, Mux pins setup, icache and RTC extra regs
  21 - arch/m68k/cpu/mcf5445x/interrupts.c   cpu specific interrupt support
  22 - arch/m68k/cpu/mcf5445x/speed.c        system, pci, flexbus, and cpu clock
  23 - arch/m68k/cpu/mcf5445x/Makefile       Makefile
  24 - arch/m68k/cpu/mcf5445x/config.mk      config make
  25 - arch/m68k/cpu/mcf5445x/start.S        start up assembly code
  26
  27 - doc/README.m54418twr                  This readme file
  28
  29 - drivers/net/mcffec.c                  ColdFire common FEC driver
  30 - drivers/net/mcfmii.c                  ColdFire common MII driver
  31 - drivers/serial/mcfuart.c              ColdFire common UART driver
  32
  33 - arch/m68k/include/asm/bitops.h        Bit operation function export
  34 - arch/m68k/include/asm/byteorder.h     Byte order functions
  35 - arch/m68k/include/asm/fec.h           FEC structure and definition
  36 - arch/m68k/include/asm/global_data.h   Global data structure
  37 - arch/m68k/include/asm/immap.h         ColdFire specific header file and driver macros
  38 - arch/m68k/include/asm/immap_5441x.h   mcf5441x specific header file
  39 - arch/m68k/include/asm/io.h            io functions
  40 - arch/m68k/include/asm/m5441x.h        mcf5441x specific header file
  41 - arch/m68k/include/asm/posix_types.h   Posix
  42 - arch/m68k/include/asm/processor.h     header file
  43 - arch/m68k/include/asm/ptrace.h        Exception structure
  44 - arch/m68k/include/asm/rtc.h           Realtime clock header file
  45 - arch/m68k/include/asm/string.h        String function export
  46 - arch/m68k/include/asm/timer.h         Timer structure and definition
  47 - arch/m68k/include/asm/types.h         Data types definition
  48 - arch/m68k/include/asm/uart.h          Uart structure and definition
  49 - arch/m68k/include/asm/u-boot.h        u-boot structure
  50
  51 - include/configs/M54418TWR.h           Board specific configuration file
  52
  53 - arch/m68k/lib/board.c                 board init function
  54 - arch/m68k/lib/cache.c
  55 - arch/m68k/lib/interrupts.c            Coldfire common interrupt functions
  56 - arch/m68k/lib/time.c                  Timer functions (Dma timer and PIT)
  57 - arch/m68k/lib/traps.c                 Exception init code
  58
  59 1 MCF5441x specific Options/Settings
  60 ====================================
  61 1.1 pre-loader is no longer suppoer in thie coldfire family
  62
  63 1.2 Configuration settings for M54418TWR Development Board
  64 CONFIG_MCF5441x                 -- define for all MCF5441x CPUs
  65 CONFIG_M54418                   -- define for all Freescale MCF54418 CPUs
  66 CONFIG_M54418TWR                -- define for M54418TWR board
  67
  68 CONFIG_MCFUART                  -- define to use common CF Uart driver
  69 CONFIG_SYS_UART_PORT            -- define UART port number, start with 0, 1 and 2
  70 CONFIG_BAUDRATE                 -- define UART baudrate
  71
  72 CONFIG_MCFFEC                   -- define to use common CF FEC driver
  73 CONFIG_MII                      -- enable to use MII driver
  74 CONFIG_SYS_DISCOVER_PHY         -- enable PHY discovery
  75 CONFIG_SYS_RX_ETH_BUFFER        -- Set FEC Receive buffer
  76 CONFIG_SYS_FAULT_ECHO_LINK_DOWN --
  77 CONFIG_SYS_FEC0_PINMUX          -- Set FEC0 Pin configuration
  78 CONFIG_SYS_FEC1_PINMUX          -- Set FEC1 Pin configuration
  79 CONFIG_SYS_FEC0_MIIBASE         -- Set FEC0 MII base register
  80 CONFIG_SYS_FEC1_MIIBASE         -- Set FEC0 MII base register
  81 MCFFEC_TOUT_LOOP                -- set FEC timeout loop
  82 CONFIG_HAS_ETH1                 -- define to enable second FEC in u-boot
  83
  84 CONFIG_MCFTMR                   -- define to use DMA timer
  85
  86 CONFIG_SYS_IMMR                 -- define for MBAR offset
  87
  88 CONFIG_EXTRA_CLOCK              -- Enable extra clock such as vco, flexbus, pci, etc
  89
  90 CONFIG_SYS_MBAR                 -- define MBAR offset
  91
  92 CONFIG_MONITOR_IS_IN_RAM        -- Not support
  93
  94 CONFIG_SYS_INIT_RAM_ADDR        -- defines the base address of the MCF54455 internal SRAM
  95
  96 CONFIG_SYS_CSn_BASE             -- defines the Chip Select Base register
  97 CONFIG_SYS_CSn_MASK             -- defines the Chip Select Mask register
  98 CONFIG_SYS_CSn_CTRL             -- defines the Chip Select Control register
  99
 100 CONFIG_SYS_SDRAM_BASE           -- defines the DRAM Base
 101
 102 2. MEMORY MAP UNDER U-BOOT AND LINUX KERNEL
 103 ===========================================
 104 2.1. System memory map:
 105         MRAM:           0x00000000-0x0003FFFF (256KB)
 106         DDR:            0x40000000-0x47FFFFFF (128MB)
 107         SRAM:           0x80000000-0x8000FFFF (64KB)
 108         IP:             0xE0000000-0xFFFFFFFF (512MB)
 109
 110 3. COMPILATION
 111 ==============
 112 3.1     To create U-Boot the gcc-4.x compiler set (ColdFire ELF version)
 113 from codesourcery.com was used. Download it from:
 114 http://www.codesourcery.com/gnu_toolchains/coldfire/download.html
 115
 116 3.2 Compilation
 117    export CROSS_COMPILE=cross-compile-prefix
 118    cd u-boot
 119    make distclean
 120    make M54418TWR_config, or                    - default to spi serial flash boot, 50Mhz input clock
 121    make M54418TWR_nand_mii_config, or           - default to nand flash boot, mii mode, 25Mhz input clock
 122    make M54418TWR_nand_rmii_config, or          - default to nand flash boot, rmii mode, 50Mhz input clock
 123    make M54418TWR_nand_rmii_lowfreq_config, or  - default to nand flash boot, rmii mode, 50Mhz input clock
 124    make M54418TWR_serial_mii_config, or         - default to spi serial flash boot, 25Mhz input clock
 125    make M54418TWR_serial_rmii_config, or        - default to spi serial flash boot, 50Mhz input clock
 126    make
 127
 128 4. SCREEN DUMP
 129 ==============
 130 4.1 M54418TWR Development board
 131     Boot from NAND flash (NOTE: May not show exactly the same)
 132
 133 U-Boot 2012.10-00209-g12ae1d8-dirty (Oct 18 2012 - 15:54:54)
 134
 135 CPU:   Freescale MCF54418 (Mask:a3 Version:1)
 136        CPU CLK 250 MHz BUS CLK 125 MHz FLB CLK 125 MHz
 137        INP CLK 50 MHz VCO CLK 500 MHz
 138 Board: Freescale MCF54418 Tower System
 139 SPI:   ready
 140 DRAM:  128 MiB
 141 NAND:  256 MiB
 142 In:    serial
 143 Out:   serial
 144 Err:   serial
 145 Net:   FEC0, FEC1
 146 -> pri
 147 baudrate=115200
 148 bootargs=root=/dev/mtdblock2 rw rootfstype=jffs2 mtdparts=NAND:1M(u-boot)ro,7M(k
 149 ernel)ro,-(jffs2) console=ttyS0,115200
 150 bootdelay=2
 151 eth1addr=00:e0:0c:bc:e5:61
 152 ethact=FEC0
 153 ethaddr=00:e0:0c:bc:e5:60
 154 fileaddr=40010000
 155 filesize=27354
 156 gatewayip=192.168.1.1
 157 hostname=M54418TWR
 158 inpclk=50000000
 159 ipaddr=192.168.1.2
 160 load=tftp ${loadaddr} ${u-boot};
 161 loadaddr=0x40010000
 162 mem=129024k
 163 netdev=eth0
 164 netmask=255.255.255.0
 165 prog=nand device 0;nand erase 0 40000;nb_update ${loadaddr} ${filesize};save
 166 serverip=192.168.1.1
 167 stderr=serial
 168 stdin=serial
 169 stdout=serial
 170 u-boot=u-boot.bin
 171 upd=run load; run prog
 172
 173 Environment size: 653/131068 bytes
 174 -> bdinfo
 175 memstart    = 0x40000000
 176 memsize     = 0x08000000
 177 flashstart  = 0x00000000
 178 flashsize   = 0x00000000
 179 flashoffset = 0x00000000
 180 sramstart   = 0x80000000
 181 sramsize    = 0x00010000
 182 mbar        = 0xFC000000
 183 cpufreq     =    250 MHz
 184 busfreq     =    125 MHz
 185 flbfreq     =    125 MHz
 186 inpfreq     =     50 MHz
 187 vcofreq     =    500 MHz
 188 ethaddr     = 00:e0:0c:bc:e5:60
 189 eth1addr    = 00:e0:0c:bc:e5:61
 190 ip_addr     = 192.168.1.2
 191 baudrate    = 115200 bps
 192 -> help
 193 ?       - alias for 'help'
 194 base    - print or set address offset
 195 bdinfo  - print Board Info structure
 196 boot    - boot default, i.e., run 'bootcmd'
 197 bootd   - boot default, i.e., run 'bootcmd'
 198 bootelf - Boot from an ELF image in memory
 199 bootm   - boot application image from memory
 200 bootp   - boot image via network using BOOTP/TFTP protocol
 201 bootvx  - Boot vxWorks from an ELF image
 202 cmp     - memory compare
 203 coninfo - print console devices and information
 204 cp      - memory copy
 205 crc32   - checksum calculation
 206 dcache  - enable or disable data cache
 207 dhcp    - boot image via network using DHCP/TFTP protocol
 208 echo    - echo args to console
 209 editenv - edit environment variable
 210 env     - environment handling commands
 211 exit    - exit script
 212 false   - do nothing, unsuccessfully
 213 go      - start application at address 'addr'
 214 help    - print command description/usage
 215 icache  - enable or disable instruction cache
 216 iminfo  - print header information for application image
 217 imxtract- extract a part of a multi-image
 218 itest   - return true/false on integer compare
 219 loop    - infinite loop on address range
 220 md      - memory display
 221 mdio    - MDIO utility commands
 222 mii     - MII utility commands
 223 mm      - memory modify (auto-incrementing address)
 224 mtest   - simple RAM read/write test
 225 mw      - memory write (fill)
 226 nand    - NAND sub-system
 227 nb_update- Nand boot update  program
 228 nboot   - boot from NAND device
 229 nfs     - boot image via network using NFS protocol
 230 nm      - memory modify (constant address)
 231 ping    - send ICMP ECHO_REQUEST to network host
 232 printenv- print environment variables
 233 reginfo - print register information
 234 reset   - Perform RESET of the CPU
 235 run     - run commands in an environment variable
 236 saveenv - save environment variables to persistent storage
 237 setenv  - set environment variables
 238 sf      - SPI flash sub-system
 239 showvar - print local hushshell variables
 240 sleep   - delay execution for some time
 241 source  - run script from memory
 242 sspi    - SPI utility command
 243 test    - minimal test like /bin/sh
 244 tftpboot- boot image via network using TFTP protocol
 245 true    - do nothing, successfully
 246 version - print monitor, compiler and linker version