doc/README.m5475evb

   1 Freescale MCF5475EVB ColdFire Development Board
   2 ================================================
   3
   4 TsiChung Liew(Tsi-Chung.Liew@freescale.com)
   5 Created Jan 08, 2008
   6 ===========================================
   7
   8
   9 Changed files:
  10 ==============
  11
  12 - board/freescale/m547xevb/m547xevb.c   Dram setup, IDE pre init, and PCI init
  13 - board/freescale/m547xevb/mii.c        MII init
  14 - board/freescale/m547xevb/Makefile     Makefile
  15 - board/freescale/m547xevb/config.mk    config make
  16 - board/freescale/m547xevb/u-boot.lds   Linker description
  17
  18 - arch/m68k/cpu/mcf547x_8x/cpu.c                        cpu specific code
  19 - arch/m68k/cpu/mcf547x_8x/cpu_init.c           Flexbus ChipSelect, Mux pins setup, icache and RTC extra regs
  20 - arch/m68k/cpu/mcf547x_8x/interrupts.c         cpu specific interrupt support
  21 - arch/m68k/cpu/mcf547x_8x/slicetimer.c         Timer support
  22 - arch/m68k/cpu/mcf547x_8x/speed.c              system, pci, flexbus, and cpu clock
  23 - arch/m68k/cpu/mcf547x_8x/Makefile             Makefile
  24 - arch/m68k/cpu/mcf547x_8x/config.mk            config make
  25 - arch/m68k/cpu/mcf547x_8x/start.S              start up assembly code
  26
  27 - doc/README.m5475evb                   This readme file
  28
  29 - drivers/dma/MCD_dmaApi.c              DMA API functions
  30 - drivers/dma/MCD_tasks.c               DMA Tasks
  31 - drivers/dma/MCD_tasksInit.c           DMA Tasks Init
  32 - drivers/net/fsl_mcdmafec.c            ColdFire common DMA FEC driver
  33 - drivers/serial/mcfuart.c              ColdFire common UART driver
  34
  35 - include/MCD_dma.h                     DMA header file
  36 - include/MCD_progCheck.h               DMA header file
  37 - include/MCD_tasksInit.h               DMA header file
  38 - include/asm-m68k/bitops.h             Bit operation function export
  39 - include/asm-m68k/byteorder.h          Byte order functions
  40 - include/asm-m68k/errno.h              Error Number definition
  41 - include/asm-m68k/fec.h                FEC structure and definition
  42 - include/asm-m68k/fsl_i2c.h            I2C structure and definition
  43 - include/asm-m68k/fsl_mcddmafec.h      DMA FEC structure and definition
  44 - include/asm-m68k/global_data.h        Global data structure
  45 - include/asm-m68k/immap.h              ColdFire specific header file and driver macros
  46 - include/asm-m68k/immap_547x_8x.h      mcf547x_8x specific header file
  47 - include/asm-m68k/io.h                 io functions
  48 - include/asm-m68k/m547x_8x.h           mcf547x_8x specific header file
  49 - include/asm-m68k/posix_types.h        Posix
  50 - include/asm-m68k/processor.h          header file
  51 - include/asm-m68k/ptrace.h             Exception structure
  52 - include/asm-m68k/rtc.h                Realtime clock header file
  53 - include/asm-m68k/string.h             String function export
  54 - include/asm-m68k/timer.h              Timer structure and definition
  55 - include/asm-m68k/types.h              Data types definition
  56 - include/asm-m68k/uart.h               Uart structure and definition
  57 - include/asm-m68k/u-boot.h             u-boot structure
  58
  59 - include/configs/M5475EVB.h            Board specific configuration file
  60
  61 - arch/m68k/lib/board.c                 board init function
  62 - arch/m68k/lib/cache.c
  63 - arch/m68k/lib/interrupts                      Coldfire common interrupt functions
  64 - arch/m68k/lib/m68k_linux.c
  65 - arch/m68k/lib/traps.c                 Exception init code
  66
  67 1 MCF547x specific Options/Settings
  68 ====================================
  69 1.1 pre-loader is no longer suppoer in thie coldfire family
  70
  71 1.2 Configuration settings for M5475EVB Development Board
  72 CONFIG_MCF547x_8x       -- define for all MCF547x_8x CPUs
  73 CONFIG_M547x            -- define for all Freescale MCF547x CPUs
  74 CONFIG_M5475            -- define for M5475EVB board
  75
  76 CONFIG_MCFUART          -- define to use common CF Uart driver
  77 CONFIG_SYS_UART_PORT            -- define UART port number, start with 0, 1 and 2
  78 CONFIG_BAUDRATE         -- define UART baudrate
  79
  80 CONFIG_FSLDMAFEC        -- define to use common dma FEC driver
  81 CONFIG_MII              -- enable to use MII driver
  82 CONFIG_CF_DOMII         -- enable to use MII feature in cmd_mii.c
  83 CONFIG_SYS_DISCOVER_PHY -- enable PHY discovery
  84 CONFIG_SYS_RX_ETH_BUFFER        -- Set FEC Receive buffer
  85 CONFIG_SYS_FAULT_ECHO_LINK_DOWN--
  86 CONFIG_SYS_FEC0_PINMUX          -- Set FEC0 Pin configuration
  87 CONFIG_SYS_FEC1_PINMUX          -- Set FEC1 Pin configuration
  88 CONFIG_SYS_FEC0_MIIBASE -- Set FEC0 MII base register
  89 CONFIG_SYS_FEC1_MIIBASE -- Set FEC0 MII base register
  90 MCFFEC_TOUT_LOOP        -- set FEC timeout loop
  91 CONFIG_HAS_ETH1         -- define to enable second FEC in u-boot
  92
  93 CONFIG_CMD_USB          -- enable USB commands
  94 CONFIG_USB_OHCI_NEW     -- enable USB OHCI driver
  95 CONFIG_USB_STORAGE      -- enable USB Storage device
  96 CONFIG_DOS_PARTITION    -- enable DOS read/write
  97
  98 CONFIG_SLTTMR           -- define to use SLT timer
  99
 100 CONFIG_FSL_I2C          -- define to use FSL common I2C driver
 101 CONFIG_HARD_I2C         -- define for I2C hardware support
 102 CONFIG_SOFT_I2C         -- define for I2C bit-banged
 103 CONFIG_SYS_I2C_SPEED            -- define for I2C speed
 104 CONFIG_SYS_I2C_SLAVE            -- define for I2C slave address
 105 CONFIG_SYS_I2C_OFFSET           -- define for I2C base address offset
 106 CONFIG_SYS_IMMR         -- define for MBAR offset
 107
 108 CONFIG_PCI              -- define for PCI support
 109 CONFIG_PCI_PNP          -- define for Plug n play support
 110 CONFIG_SKIPPCI_HOSTBRIDGE       -- SKIP PCI Host bridge
 111 CONFIG_SYS_PCI_MEM_BUS          -- PCI memory logical offset
 112 CONFIG_SYS_PCI_MEM_PHYS -- PCI memory physical offset
 113 CONFIG_SYS_PCI_MEM_SIZE -- PCI memory size
 114 CONFIG_SYS_PCI_IO_BUS           -- PCI IO logical offset
 115 CONFIG_SYS_PCI_IO_PHYS          -- PCI IO physical offset
 116 CONFIG_SYS_PCI_IO_SIZE          -- PCI IO size
 117 CONFIG_SYS_PCI_CFG_BUS          -- PCI Configuration logical offset
 118 CONFIG_SYS_PCI_CFG_PHYS -- PCI Configuration physical offset
 119 CONFIG_SYS_PCI_CFG_SIZE -- PCI Configuration size
 120
 121 CONFIG_SYS_MBAR         -- define MBAR offset
 122
 123 CONFIG_MONITOR_IS_IN_RAM -- Not support
 124
 125 CONFIG_SYS_INIT_RAM_ADDR        -- defines the base address of the MCF547x internal SRAM
 126
 127 CONFIG_SYS_CSn_BASE     -- defines the Chip Select Base register
 128 CONFIG_SYS_CSn_MASK     -- defines the Chip Select Mask register
 129 CONFIG_SYS_CSn_CTRL     -- defines the Chip Select Control register
 130
 131 CONFIG_SYS_SDRAM_BASE   -- defines the DRAM Base
 132
 133 2. MEMORY MAP UNDER U-BOOT AND LINUX KERNEL
 134 ===========================================
 135 2.1. System memory map:
 136         Flash:          0xFF800000-0xFFFFFFFF (8MB)
 137         DDR:            0x00000000-0x3FFFFFFF (1024MB)
 138         SRAM:           0xF2000000-0xF2000FFF (4KB)
 139         PCI:            0x70000000-0x8FFFFFFF (512MB)
 140         IP:             0xF0000000-0xFFFFFFFF (256MB)
 141
 142 3. COMPILATION
 143 ==============
 144 3.1     To create U-Boot the gcc-4.x compiler set (ColdFire ELF or uclinux
 145         version) from codesourcery.com was used. Download it from:
 146         http://www.codesourcery.com/gnu_toolchains/coldfire/download.html
 147
 148 3.2 Compilation
 149    export CROSS_COMPILE=cross-compile-prefix
 150    cd u-boot-1.x.x
 151    make distclean
 152    make M5475AFE_config, or     - boot 2MB, RAM 64MB
 153    make M5475BFE_config, or     - boot 2MB, code 16MB, RAM 64MB
 154    make M5475CFE_config, or     - boot 2MB, code 16MB, Video, USB, RAM 64MB
 155    make M5475DFE_config, or     - boot 2MB, USB, RAM 64MB
 156    make M5475EFE_config, or     - boot 2MB, Video, USB, RAM 64MB
 157    make M5475FFE_config, or     - boot 2MB, code 32MB, Video, USB, RAM 128MB
 158    make M5475GFE_config, or     - boot 2MB, RAM 64MB
 159    make
 160
 161 5. SCREEN DUMP
 162 ==============
 163 5.1
 164
 165 U-Boot 1.3.1 (Jan  8 2008 - 12:47:44)
 166
 167 CPU:   Freescale MCF5475
 168        CPU CLK 266 Mhz BUS CLK 133 Mhz
 169 Board: Freescale FireEngine 5475 EVB
 170 I2C:   ready
 171 DRAM:  64 MB
 172 FLASH: 18 MB
 173 In:    serial
 174 Out:   serial
 175 Err:   serial
 176 Net:   FEC0, FEC1
 177 -> pri
 178 bootdelay=1
 179 baudrate=115200
 180 ethaddr=00:e0:0c:bc:e5:60
 181 eth1addr=00:e0:0c:bc:e5:61
 182 ipaddr=192.162.1.2
 183 serverip=192.162.1.1
 184 gatewayip=192.162.1.1
 185 netmask=255.255.255.0
 186 hostname=M547xEVB
 187 netdev=eth0
 188 loadaddr=10000
 189 u-boot=u-boot.bin
 190 load=tftp ${loadaddr) ${u-boot}
 191 upd=run load; run prog
 192 prog=prot off bank 1;era ff800000 ff82ffff;cp.b ${loadaddr} ff800000 ${filesize};save
 193 stdin=serial
 194 stdout=serial
 195 stderr=serial
 196 ethact=FEC0
 197 mem=65024k
 198
 199 Environment size: 433/8188 bytes
 200 -> bdin
 201 memstart    = 0x00000000
 202 memsize     = 0x04000000
 203 flashstart  = 0xFF800000
 204 flashsize   = 0x01200000
 205 flashoffset = 0x00000000
 206 sramstart   = 0xF2000000
 207 sramsize    = 0x00001000
 208 mbar        = 0xF0000000
 209 busfreq     = 133.333 MHz
 210 pcifreq     =      0 MHz
 211 ethaddr     = 00:E0:0C:BC:E5:60
 212 eth1addr    = 00:E0:0C:BC:E5:61
 213 ip_addr     = 192.162.1.2
 214 baudrate    = 115200 bps
 215 -> ?
 216 ?       - alias for 'help'
 217 base    - print or set address offset
 218 bdinfo  - print Board Info structure
 219 boot    - boot default, i.e., run 'bootcmd'
 220 bootd   - boot default, i.e., run 'bootcmd'
 221 bootelf - Boot from an ELF image in memory
 222 bootm   - boot application image from memory
 223 bootp   - boot image via network using BootP/TFTP protocol
 224 bootvx  - Boot vxWorks from an ELF image
 225 cmp     - memory compare
 226 coninfo - print console devices and information
 227 cp      - memory copy
 228 crc32   - checksum calculation
 229 dcache  - enable or disable data cache
 230 echo    - echo args to console
 231 erase   - erase FLASH memory
 232 flinfo  - print FLASH memory information
 233 go      - start application at address 'addr'
 234 help    - print online help
 235 i2c     - I2C sub-system
 236 icache  - enable or disable instruction cache
 237 iminfo  - print header information for application image
 238 imls    - list all images found in flash
 239 itest   - return true/false on integer compare
 240 loadb   - load binary file over serial line (kermit mode)
 241 loads   - load S-Record file over serial line
 242 loady   - load binary file over serial line (ymodem mode)
 243 loop    - infinite loop on address range
 244 md      - memory display
 245 mii     - MII utility commands
 246 mm      - memory modify (auto-incrementing)
 247 mtest   - simple RAM test
 248 mw      - memory write (fill)
 249 nfs     - boot image via network using NFS protocol
 250 nm      - memory modify (constant address)
 251 pci     - list and access PCI Configuration Space
 252 ping    - send ICMP ECHO_REQUEST to network host
 253 printenv- print environment variables
 254 protect - enable or disable FLASH write protection
 255 rarpboot- boot image via network using RARP/TFTP protocol
 256 reset   - Perform RESET of the CPU
 257 run     - run commands in an environment variable
 258 saveenv - save environment variables to persistent storage
 259 setenv  - set environment variables
 260 sleep   - delay execution for some time
 261 source  - run script from memory
 262 tftpboot- boot image via network using TFTP protocol
 263 usb     - USB sub-system
 264 usbboot - boot from USB device
 265 version - print monitor version
 266 -> usb start
 267 (Re)start USB...
 268 USB:   OHCI pci controller (1131, 1561) found @(0:17:0)
 269 OHCI regs address 0x80000000
 270 scanning bus for devices... 2 USB Device(s) found
 271        scanning bus for storage devices... 1 Storage Device(s) found
 272 ->