Merge branch 'master' of git://git.denx.de/u-boot-arm
[platform/kernel/u-boot.git] / 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_NET_MULTI        -- define to use multi FEC in u-boot
82 CONFIG_MII              -- enable to use MII driver
83 CONFIG_CF_DOMII         -- enable to use MII feature in cmd_mii.c
84 CONFIG_SYS_DISCOVER_PHY -- enable PHY discovery
85 CONFIG_SYS_RX_ETH_BUFFER        -- Set FEC Receive buffer
86 CONFIG_SYS_FAULT_ECHO_LINK_DOWN--
87 CONFIG_SYS_FEC0_PINMUX          -- Set FEC0 Pin configuration
88 CONFIG_SYS_FEC1_PINMUX          -- Set FEC1 Pin configuration
89 CONFIG_SYS_FEC0_MIIBASE -- Set FEC0 MII base register
90 CONFIG_SYS_FEC1_MIIBASE -- Set FEC0 MII base register
91 MCFFEC_TOUT_LOOP        -- set FEC timeout loop
92 CONFIG_HAS_ETH1         -- define to enable second FEC in u-boot
93
94 CONFIG_CMD_USB          -- enable USB commands
95 CONFIG_USB_OHCI_NEW     -- enable USB OHCI driver
96 CONFIG_USB_STORAGE      -- enable USB Storage device
97 CONFIG_DOS_PARTITION    -- enable DOS read/write
98
99 CONFIG_SLTTMR           -- define to use SLT timer
100
101 CONFIG_FSL_I2C          -- define to use FSL common I2C driver
102 CONFIG_HARD_I2C         -- define for I2C hardware support
103 CONFIG_SOFT_I2C         -- define for I2C bit-banged
104 CONFIG_SYS_I2C_SPEED            -- define for I2C speed
105 CONFIG_SYS_I2C_SLAVE            -- define for I2C slave address
106 CONFIG_SYS_I2C_OFFSET           -- define for I2C base address offset
107 CONFIG_SYS_IMMR         -- define for MBAR offset
108
109 CONFIG_PCI              -- define for PCI support
110 CONFIG_PCI_PNP          -- define for Plug n play support
111 CONFIG_SKIPPCI_HOSTBRIDGE       -- SKIP PCI Host bridge
112 CONFIG_SYS_PCI_MEM_BUS          -- PCI memory logical offset
113 CONFIG_SYS_PCI_MEM_PHYS -- PCI memory physical offset
114 CONFIG_SYS_PCI_MEM_SIZE -- PCI memory size
115 CONFIG_SYS_PCI_IO_BUS           -- PCI IO logical offset
116 CONFIG_SYS_PCI_IO_PHYS          -- PCI IO physical offset
117 CONFIG_SYS_PCI_IO_SIZE          -- PCI IO size
118 CONFIG_SYS_PCI_CFG_BUS          -- PCI Configuration logical offset
119 CONFIG_SYS_PCI_CFG_PHYS -- PCI Configuration physical offset
120 CONFIG_SYS_PCI_CFG_SIZE -- PCI Configuration size
121
122 CONFIG_SYS_MBAR         -- define MBAR offset
123
124 CONFIG_MONITOR_IS_IN_RAM -- Not support
125
126 CONFIG_SYS_INIT_RAM_ADDR        -- defines the base address of the MCF547x internal SRAM
127
128 CONFIG_SYS_CSn_BASE     -- defines the Chip Select Base register
129 CONFIG_SYS_CSn_MASK     -- defines the Chip Select Mask register
130 CONFIG_SYS_CSn_CTRL     -- defines the Chip Select Control register
131
132 CONFIG_SYS_SDRAM_BASE   -- defines the DRAM Base
133
134 2. MEMORY MAP UNDER U-BOOT AND LINUX KERNEL
135 ===========================================
136 2.1. System memory map:
137         Flash:          0xFF800000-0xFFFFFFFF (8MB)
138         DDR:            0x00000000-0x3FFFFFFF (1024MB)
139         SRAM:           0xF2000000-0xF2000FFF (4KB)
140         PCI:            0x70000000-0x8FFFFFFF (512MB)
141         IP:             0xF0000000-0xFFFFFFFF (256MB)
142
143 3. COMPILATION
144 ==============
145 3.1     To create U-Boot the gcc-4.x compiler set (ColdFire ELF or uclinux
146         version) from codesourcery.com was used. Download it from:
147         http://www.codesourcery.com/gnu_toolchains/coldfire/download.html
148
149 3.2 Compilation
150    export CROSS_COMPILE=cross-compile-prefix
151    cd u-boot-1.x.x
152    make distclean
153    make M5475AFE_config, or     - boot 2MB, RAM 64MB
154    make M5475BFE_config, or     - boot 2MB, code 16MB, RAM 64MB
155    make M5475CFE_config, or     - boot 2MB, code 16MB, Video, USB, RAM 64MB
156    make M5475DFE_config, or     - boot 2MB, USB, RAM 64MB
157    make M5475EFE_config, or     - boot 2MB, Video, USB, RAM 64MB
158    make M5475FFE_config, or     - boot 2MB, code 32MB, Video, USB, RAM 128MB
159    make M5475GFE_config, or     - boot 2MB, RAM 64MB
160    make
161
162 5. SCREEN DUMP
163 ==============
164 5.1
165
166 U-Boot 1.3.1 (Jan  8 2008 - 12:47:44)
167
168 CPU:   Freescale MCF5475
169        CPU CLK 266 Mhz BUS CLK 133 Mhz
170 Board: Freescale FireEngine 5475 EVB
171 I2C:   ready
172 DRAM:  64 MB
173 FLASH: 18 MB
174 In:    serial
175 Out:   serial
176 Err:   serial
177 Net:   FEC0, FEC1
178 -> pri
179 bootdelay=1
180 baudrate=115200
181 ethaddr=00:e0:0c:bc:e5:60
182 eth1addr=00:e0:0c:bc:e5:61
183 ipaddr=192.162.1.2
184 serverip=192.162.1.1
185 gatewayip=192.162.1.1
186 netmask=255.255.255.0
187 hostname=M547xEVB
188 netdev=eth0
189 loadaddr=10000
190 u-boot=u-boot.bin
191 load=tftp ${loadaddr) ${u-boot}
192 upd=run load; run prog
193 prog=prot off bank 1;era ff800000 ff82ffff;cp.b ${loadaddr} ff800000 ${filesize};save
194 stdin=serial
195 stdout=serial
196 stderr=serial
197 ethact=FEC0
198 mem=65024k
199
200 Environment size: 433/8188 bytes
201 -> bdin
202 memstart    = 0x00000000
203 memsize     = 0x04000000
204 flashstart  = 0xFF800000
205 flashsize   = 0x01200000
206 flashoffset = 0x00000000
207 sramstart   = 0xF2000000
208 sramsize    = 0x00001000
209 mbar        = 0xF0000000
210 busfreq     = 133.333 MHz
211 pcifreq     =      0 MHz
212 ethaddr     = 00:E0:0C:BC:E5:60
213 eth1addr    = 00:E0:0C:BC:E5:61
214 ip_addr     = 192.162.1.2
215 baudrate    = 115200 bps
216 -> ?
217 ?       - alias for 'help'
218 base    - print or set address offset
219 bdinfo  - print Board Info structure
220 boot    - boot default, i.e., run 'bootcmd'
221 bootd   - boot default, i.e., run 'bootcmd'
222 bootelf - Boot from an ELF image in memory
223 bootm   - boot application image from memory
224 bootp   - boot image via network using BootP/TFTP protocol
225 bootvx  - Boot vxWorks from an ELF image
226 cmp     - memory compare
227 coninfo - print console devices and information
228 cp      - memory copy
229 crc32   - checksum calculation
230 dcache  - enable or disable data cache
231 echo    - echo args to console
232 erase   - erase FLASH memory
233 flinfo  - print FLASH memory information
234 go      - start application at address 'addr'
235 help    - print online help
236 i2c     - I2C sub-system
237 icache  - enable or disable instruction cache
238 iminfo  - print header information for application image
239 imls    - list all images found in flash
240 itest   - return true/false on integer compare
241 loadb   - load binary file over serial line (kermit mode)
242 loads   - load S-Record file over serial line
243 loady   - load binary file over serial line (ymodem mode)
244 loop    - infinite loop on address range
245 md      - memory display
246 mii     - MII utility commands
247 mm      - memory modify (auto-incrementing)
248 mtest   - simple RAM test
249 mw      - memory write (fill)
250 nfs     - boot image via network using NFS protocol
251 nm      - memory modify (constant address)
252 pci     - list and access PCI Configuration Space
253 ping    - send ICMP ECHO_REQUEST to network host
254 printenv- print environment variables
255 protect - enable or disable FLASH write protection
256 rarpboot- boot image via network using RARP/TFTP protocol
257 reset   - Perform RESET of the CPU
258 run     - run commands in an environment variable
259 saveenv - save environment variables to persistent storage
260 setenv  - set environment variables
261 sleep   - delay execution for some time
262 source  - run script from memory
263 tftpboot- boot image via network using TFTP protocol
264 usb     - USB sub-system
265 usbboot - boot from USB device
266 version - print monitor version
267 -> usb start
268 (Re)start USB...
269 USB:   OHCI pci controller (1131, 1561) found @(0:17:0)
270 OHCI regs address 0x80000000
271 scanning bus for devices... 2 USB Device(s) found
272        scanning bus for storage devices... 1 Storage Device(s) found
273 ->