]> git.ipfire.org Git - people/ms/u-boot.git/blame - doc/README.m5373evb
Fix compile warning in uli526x driver
[people/ms/u-boot.git] / doc / README.m5373evb
CommitLineData
aa5f1f9d
TL
1Freescale MCF5373EVB ColdFire Development Board
2================================================
3
4TsiChung Liew(Tsi-Chung.Liew@freescale.com)
5Created 11/08/07
6===========================================
7
8
9Changed files:
10==============
11
12- board/freescale/m5373evb/m5373evb.c Dram setup
13- board/freescale/m5373evb/mii.c Mii access
14- board/freescale/m5373evb/Makefile Makefile
15- board/freescale/m5373evb/config.mk config make
16- board/freescale/m5373evb/u-boot.lds Linker description
17
a4145534
PT
18- arch/m68k/cpu/mcf532x/cpu.c cpu specific code
19- arch/m68k/cpu/mcf532x/cpu_init.c FBCS, Mux pins, icache and RTC extra regs
20- arch/m68k/cpu/mcf532x/interrupts.c cpu specific interrupt support
21- arch/m68k/cpu/mcf532x/speed.c system, pci, flexbus, and cpu clock
22- arch/m68k/cpu/mcf532x/Makefile Makefile
23- arch/m68k/cpu/mcf532x/config.mk config make
24- arch/m68k/cpu/mcf532x/start.S start up assembly code
aa5f1f9d
TL
25
26- doc/README.m5373evb This readme file
27
28- drivers/net/mcffec.c ColdFire common FEC driver
29- drivers/serial/mcfuart.c ColdFire common UART driver
30- drivers/rtc/mcfrtc.c Realtime clock Driver
31
32- include/asm-m68k/bitops.h Bit operation function export
33- include/asm-m68k/byteorder.h Byte order functions
34- include/asm-m68k/fec.h FEC structure and definition
35- include/asm-m68k/fsl_i2c.h I2C structure and definition
36- include/asm-m68k/global_data.h Global data structure
37- include/asm-m68k/immap.h ColdFire specific header file and driver macros
38- include/asm-m68k/immap_532x.h mcf532x specific header file
39- include/asm-m68k/io.h io functions
40- include/asm-m68k/m532x.h mcf532x specific header file
41- include/asm-m68k/posix_types.h Posix
42- include/asm-m68k/processor.h header file
43- include/asm-m68k/ptrace.h Exception structure
44- include/asm-m68k/rtc.h Realtime clock header file
45- include/asm-m68k/string.h String function export
46- include/asm-m68k/timer.h Timer structure and definition
47- include/asm-m68k/types.h Data types definition
48- include/asm-m68k/uart.h Uart structure and definition
49- include/asm-m68k/u-boot.h u-boot structure
50
51- include/configs/M5373EVB.h Board specific configuration file
52
ea0364f1
PT
53- arch/m68k/lib/board.c board init function
54- arch/m68k/lib/cache.c
55- arch/m68k/lib/interrupts Coldfire common interrupt functions
56- arch/m68k/lib/m68k_linux.c
57- arch/m68k/lib/time.c Timer functions (Dma timer and PIT)
58- arch/m68k/lib/traps.c Exception init code
aa5f1f9d
TL
59
601 MCF5373 specific Options/Settings
61====================================
621.1 pre-loader is no longer suppoer in thie coldfire family
63
641.2 Configuration settings for M5373EVB Development Board
65CONFIG_MCF532x -- define for all MCF532x CPUs
66CONFIG_M5373 -- define for all Freescale MCF5373 CPUs
67CONFIG_M5373EVB -- define for M5373EVB board
68
69CONFIG_MCFUART -- define to use common CF Uart driver
6d0f6bcf 70CONFIG_SYS_UART_PORT -- define UART port number, start with 0, 1 and 2
aa5f1f9d
TL
71CONFIG_BAUDRATE -- define UART baudrate
72
73CONFIG_MCFRTC -- define to use common CF RTC driver
6d0f6bcf
JCPV
74CONFIG_SYS_MCFRTC_BASE -- provide base address for RTC in immap.h
75CONFIG_SYS_RTC_OSCILLATOR -- define RTC clock frequency
aa5f1f9d
TL
76RTC_DEBUG -- define to show RTC debug message
77CONFIG_CMD_DATE -- enable to use date feature in u-boot
78
79CONFIG_MCFFEC -- define to use common CF FEC driver
80CONFIG_NET_MULTI -- define to use multi FEC in u-boot
81CONFIG_MII -- enable to use MII driver
82CONFIG_CF_DOMII -- enable to use MII feature in cmd_mii.c
6d0f6bcf
JCPV
83CONFIG_SYS_DISCOVER_PHY -- enable PHY discovery
84CONFIG_SYS_RX_ETH_BUFFER -- Set FEC Receive buffer
85CONFIG_SYS_FAULT_ECHO_LINK_DOWN--
86CONFIG_SYS_FEC0_PINMUX -- Set FEC0 Pin configuration
87CONFIG_SYS_FEC0_MIIBASE -- Set FEC0 MII base register
aa5f1f9d
TL
88MCFFEC_TOUT_LOOP -- set FEC timeout loop
89
90CONFIG_MCFTMR -- define to use DMA timer
91CONFIG_MCFPIT -- define to use PIT timer
92
93CONFIG_FSL_I2C -- define to use FSL common I2C driver
94CONFIG_HARD_I2C -- define for I2C hardware support
95CONFIG_SOFT_I2C -- define for I2C bit-banged
6d0f6bcf
JCPV
96CONFIG_SYS_I2C_SPEED -- define for I2C speed
97CONFIG_SYS_I2C_SLAVE -- define for I2C slave address
98CONFIG_SYS_I2C_OFFSET -- define for I2C base address offset
99CONFIG_SYS_IMMR -- define for MBAR offset
aa5f1f9d 100
6d0f6bcf 101CONFIG_SYS_MBAR -- define MBAR offset
aa5f1f9d
TL
102
103CONFIG_MONITOR_IS_IN_RAM -- Not support
104
6d0f6bcf 105CONFIG_SYS_INIT_RAM_ADDR -- defines the base address of the MCF5373 internal SRAM
aa5f1f9d 106
6d0f6bcf
JCPV
107CONFIG_SYS_CSn_BASE -- defines the Chip Select Base register
108CONFIG_SYS_CSn_MASK -- defines the Chip Select Mask register
109CONFIG_SYS_CSn_CTRL -- defines the Chip Select Control register
aa5f1f9d 110
6d0f6bcf 111CONFIG_SYS_SDRAM_BASE -- defines the DRAM Base
aa5f1f9d
TL
112
1132. MEMORY MAP UNDER U-BOOT AND LINUX KERNEL
114===========================================
1152.1. System memory map:
116 Flash: 0x00000000-0x3FFFFFFF (1024MB)
117 DDR: 0x40000000-0x7FFFFFFF (1024MB)
118 SRAM: 0x80000000-0x8FFFFFFF (256MB)
119 IP: 0xF0000000-0xFFFFFFFF (256MB)
120
1212.2. For the initial bringup, we adopted a consistent memory scheme between u-boot and
122 linux kernel, you can customize it based on your system requirements:
123 Flash0: 0x00000000-0x00FFFFFF (16MB)
124
125 DDR: 0x40000000-0x4FFFFFFF (256MB)
126 SRAM: 0x80000000-0x80007FFF (32KB)
127 IP: 0xFC000000-0xFC0FFFFF (64KB)
128
1293. COMPILATION
130==============
1313.1 To create U-Boot the gcc-4.1-xx compiler set (ColdFire ELF or
132uClinux version) from codesourcery.com was used. Download it from:
133http://www.codesourcery.com/gnu_toolchains/coldfire/download.html
134
1353.2 Compilation
136 export CROSS_COMPILE=cross-compile-prefix
137 cd u-boot-1.x.x
138 make distclean
139 make M5373EVB_config
140 make
141
1424. SCREEN DUMP
143==============
1444.1 M5373EVB Development board
145 (NOTE: May not show exactly the same)
146
147U-Boot 1.3.0 (Nov 8 2007 - 12:44:08)
148
149CPU: Freescale MCF5373 (Mask:65 Version:1)
150 CPU CLK 240 Mhz BUS CLK 80 Mhz
151Board: Freescale FireEngine 5373 EVB
152I2C: ready
153DRAM: 32 MB
154FLASH: 2 MB
155In: serial
156Out: serial
157Err: serial
158NAND: 16 MiB
159Net: FEC0
160-> print
161bootdelay=1
162baudrate=115200
163ethaddr=00:e0:0c:bc:e5:60
164hostname=M5373EVB
165netdev=eth0
166loadaddr=40010000
167load=tftp ${loadaddr) ${u-boot}
168upd=run load; run prog
169prog=prot off 0 2ffff;era 0 2ffff;cp.b ${loadaddr} 0 ${filesize};save
170ethact=FEC0
171u-boot=u-boot.bin
172gatewayip=192.168.1.1
173netmask=255.255.255.0
174ipaddr=192.168.1.3
175serverip=192.168.1.2
176stdin=serial
177stdout=serial
178stderr=serial
179mem=261632k
180
181Environment size: 401/8188 bytes
182-> bdinfo
183memstart = 0x40000000
184memsize = 0x02000000
185flashstart = 0x00000000
186flashsize = 0x00200000
187flashoffset = 0x00000000
188sramstart = 0x80000000
189sramsize = 0x00008000
865f0f97
WD
190mbar = 0xFC000000
191busfreq = 80 MHz
aa5f1f9d
TL
192ethaddr = 00:E0:0C:BC:E5:60
193ip_addr = 192.168.1.3
194baudrate = 115200 bps
195->
196-> help
865f0f97 197? - alias for 'help'
865f0f97
WD
198base - print or set address offset
199bdinfo - print Board Info structure
200boot - boot default, i.e., run 'bootcmd'
201bootd - boot default, i.e., run 'bootcmd'
aa5f1f9d 202bootelf - Boot from an ELF image in memory
865f0f97 203bootm - boot application image from memory
aa5f1f9d 204bootp - boot image via network using BootP/TFTP protocol
865f0f97
WD
205bootvx - Boot vxWorks from an ELF image
206cmp - memory compare
aa5f1f9d 207coninfo - print console devices and information
865f0f97
WD
208cp - memory copy
209crc32 - checksum calculation
210date - get/set/reset date & time
211dcache - enable or disable data cache
212echo - echo args to console
213erase - erase FLASH memory
214flinfo - print FLASH memory information
215go - start application at address 'addr'
216help - print online help
0f89c54b 217i2c - I2C sub-system
865f0f97 218icache - enable or disable instruction cache
865f0f97
WD
219iminfo - print header information for application image
220imls - list all images found in flash
aa5f1f9d 221itest - return true/false on integer compare
865f0f97
WD
222loadb - load binary file over serial line (kermit mode)
223loads - load S-Record file over serial line
224loady - load binary file over serial line (ymodem mode)
225loop - infinite loop on address range
aa5f1f9d 226ls - list files in a directory (default /)
865f0f97
WD
227md - memory display
228mii - MII utility commands
229mm - memory modify (auto-incrementing)
230mtest - simple RAM test
231mw - memory write (fill)
aa5f1f9d
TL
232nand - NAND sub-system
233nboot - boot from NAND device
234nfs - boot image via network using NFS protocol
865f0f97 235nm - memory modify (constant address)
aa5f1f9d
TL
236ping - send ICMP ECHO_REQUEST to network host
237printenv- print environment variables
238protect - enable or disable FLASH write protection
239rarpboot- boot image via network using RARP/TFTP protocol
865f0f97
WD
240reset - Perform RESET of the CPU
241run - run commands in an environment variable
aa5f1f9d 242saveenv - save environment variables to persistent storage
865f0f97
WD
243setenv - set environment variables
244sleep - delay execution for some time
3202d331 245source - run script from memory
aa5f1f9d
TL
246tftpboot- boot image via network using TFTP protocol
247version - print monitor version
248-> tftp 0x40800000 uImage
249Using FEC0 device
250TFTP from server 192.168.1.3; our IP address is 192.168.1.3 Filename 'uImage'.
251Load address: 0x40800000
252Loading: #################################################################
865f0f97
WD
253 #################################################################
254 ##########
aa5f1f9d
TL
255done
256Bytes transferred = 2053270 (1f5496 hex)
257-> bootm 0x40800000
258## Booting image at 40800000 ...
259 Image Name: Linux Kernel Image
865f0f97 260 Created: 2007-11-07 20:33:08 UTC
aa5f1f9d 261 Image Type: M68K Linux Kernel Image (gzip compressed)
865f0f97 262 Data Size: 2053206 Bytes = 2 MB
aa5f1f9d
TL
263 Load Address: 40020000
264 Entry Point: 40020000
265 Verifying Checksum ... OK
266 Uncompressing Kernel Image ... OK
267Linux version 2.6.22-uc1 (mattw@loa) (gcc version 4.2.1 (Sourcery G++ Lite 4.2-7
268
269
270uClinux/COLDFIRE(m537x)
271COLDFIRE port done by Greg Ungerer, gerg@snapgear.com Flat model support (C) 1998,1999 Kenneth Albanowski, D. Jeff Dionne Built 1 zonelists. Total pages: 8128 Kernel command line: rootfstype=romfs PID hash table entries: 128 (order: 7, 512 bytes) Dentry cache hash table entries: 4096 (order: 2, 16384 bytes) Inode-cache hash table entries: 2048 (order: 1, 8192 bytes) Memory available: 28092k/32768k RAM, (1788k kernel code, 244k data) Mount-cache hash table entries: 512
272NET: Registered protocol family 16
273USB-MCF537x: (HOST module) EHCI device is registered
274USB-MCF537x: (OTG module) EHCI device is registered
275USB-MCF537x: (OTG module) UDC device is registered
276usbcore: registered new interface driver usbfs
277usbcore: registered new interface driver hub
278usbcore: registered new device driver usb
279NET: Registered protocol family 2
280IP route cache hash table entries: 1024 (order: 0, 4096 bytes) TCP established hash table entries: 1024 (order: 1, 8192 bytes) TCP bind hash table entries: 1024 (order: 0, 4096 bytes)
281TCP: Hash tables configured (established 1024 bind 1024) TCP reno registered
282