]> git.ipfire.org Git - people/ms/u-boot.git/blame - doc/README.m54455evb
rename CFG_ macros to CONFIG_SYS
[people/ms/u-boot.git] / doc / README.m54455evb
CommitLineData
8ae158cd
TL
1Freescale MCF54455EVB ColdFire Development Board
2================================================
3
4TsiChung Liew(Tsi-Chung.Liew@freescale.com)
5Created 4/08/07
6===========================================
7
8
9Changed files:
10==============
11
12- board/freescale/m54455evb/m54455evb.c Dram setup, IDE pre init, and PCI init
13- board/freescale/m54455evb/flash.c Atmel and INTEL flash support
14- board/freescale/m54455evb/Makefile Makefile
15- board/freescale/m54455evb/config.mk config make
16- board/freescale/m54455evb/u-boot.lds Linker description
17
18- common/cmd_bdinfo.c Clock frequencies output
19- common/cmd_mii.c mii support
20
21- cpu/mcf5445x/cpu.c cpu specific code
22- cpu/mcf5445x/cpu_init.c Flexbus ChipSelect, Mux pins setup, icache and RTC extra regs
23- cpu/mcf5445x/interrupts.c cpu specific interrupt support
24- cpu/mcf5445x/speed.c system, pci, flexbus, and cpu clock
25- cpu/mcf5445x/Makefile Makefile
26- cpu/mcf5445x/config.mk config make
27- cpu/mcf5445x/start.S start up assembly code
28
29- doc/README.m54455evb This readme file
30
31- drivers/net/mcffec.c ColdFire common FEC driver
32- drivers/serial/mcfuart.c ColdFire common UART driver
33
34- include/asm-m68k/bitops.h Bit operation function export
35- include/asm-m68k/byteorder.h Byte order functions
36- include/asm-m68k/fec.h FEC structure and definition
37- include/asm-m68k/fsl_i2c.h I2C structure and definition
38- include/asm-m68k/global_data.h Global data structure
39- include/asm-m68k/immap.h ColdFire specific header file and driver macros
40- include/asm-m68k/immap_5445x.h mcf5445x specific header file
41- include/asm-m68k/io.h io functions
42- include/asm-m68k/m5445x.h mcf5445x specific header file
43- include/asm-m68k/posix_types.h Posix
44- include/asm-m68k/processor.h header file
45- include/asm-m68k/ptrace.h Exception structure
46- include/asm-m68k/rtc.h Realtime clock header file
47- include/asm-m68k/string.h String function export
48- include/asm-m68k/timer.h Timer structure and definition
49- include/asm-m68k/types.h Data types definition
50- include/asm-m68k/uart.h Uart structure and definition
51- include/asm-m68k/u-boot.h u-boot structure
52
53- include/configs/M54455EVB.h Board specific configuration file
54
55- lib_m68k/board.c board init function
56- lib_m68k/cache.c
57- lib_m68k/interrupts Coldfire common interrupt functions
58- lib_m68k/m68k_linux.c
59- lib_m68k/time.c Timer functions (Dma timer and PIT)
60- lib_m68k/traps.c Exception init code
61
62- rtc/mcfrtc.c Realtime clock Driver
63
641 MCF5445x specific Options/Settings
65====================================
661.1 pre-loader is no longer suppoer in thie coldfire family
67
681.2 Configuration settings for M54455EVB Development Board
69CONFIG_MCF5445x -- define for all MCF5445x CPUs
70CONFIG_M54455 -- define for all Freescale MCF54455 CPUs
71CONFIG_M54455EVB -- define for M54455EVB board
72
73CONFIG_MCFUART -- define to use common CF Uart driver
6d0f6bcf 74CONFIG_SYS_UART_PORT -- define UART port number, start with 0, 1 and 2
8ae158cd
TL
75CONFIG_BAUDRATE -- define UART baudrate
76
77CONFIG_MCFRTC -- define to use common CF RTC driver
6d0f6bcf
JCPV
78CONFIG_SYS_MCFRTC_BASE -- provide base address for RTC in immap.h
79CONFIG_SYS_RTC_OSCILLATOR -- define RTC clock frequency
8ae158cd 80RTC_DEBUG -- define to show RTC debug message
26667b7f 81CONFIG_CMD_DATE -- enable to use date feature in u-boot
8ae158cd
TL
82
83CONFIG_MCFFEC -- define to use common CF FEC driver
84CONFIG_NET_MULTI -- define to use multi FEC in u-boot
85CONFIG_MII -- enable to use MII driver
53677ef1 86CONFIG_CF_DOMII -- enable to use MII feature in cmd_mii.c
6d0f6bcf
JCPV
87CONFIG_SYS_DISCOVER_PHY -- enable PHY discovery
88CONFIG_SYS_RX_ETH_BUFFER -- Set FEC Receive buffer
89CONFIG_SYS_FAULT_ECHO_LINK_DOWN--
90CONFIG_SYS_FEC0_PINMUX -- Set FEC0 Pin configuration
91CONFIG_SYS_FEC1_PINMUX -- Set FEC1 Pin configuration
92CONFIG_SYS_FEC0_MIIBASE -- Set FEC0 MII base register
93CONFIG_SYS_FEC1_MIIBASE -- Set FEC0 MII base register
8ae158cd
TL
94MCFFEC_TOUT_LOOP -- set FEC timeout loop
95CONFIG_HAS_ETH1 -- define to enable second FEC in u-boot
96
97CONFIG_ISO_PARTITION -- enable ISO read/write
98CONFIG_DOS_PARTITION -- enable DOS read/write
99CONFIG_IDE_RESET -- define ide_reset()
100CONFIG_IDE_PREINIT -- define ide_preinit()
101CONFIG_ATAPI -- define ATAPI support
102CONFIG_LBA48 -- define LBA48 (larger than 120GB) support
6d0f6bcf
JCPV
103CONFIG_SYS_IDE_MAXBUS -- define max channel
104CONFIG_SYS_IDE_MAXDEVICE -- define max devices per channel
105CONFIG_SYS_ATA_BASE_ADDR -- define ATA base address
106CONFIG_SYS_ATA_IDE0_OFFSET -- define ATA IDE0 offset
107CONFIG_SYS_ATA_DATA_OFFSET -- define ATA data IO
108CONFIG_SYS_ATA_REG_OFFSET -- define for normal register accesses
109CONFIG_SYS_ATA_ALT_OFFSET -- define for alternate registers
110CONFIG_SYS_ATA_STRIDE -- define for Interval between registers
8ae158cd
TL
111_IO_BASE -- define for IO base address
112
113CONFIG_MCFTMR -- define to use DMA timer
114CONFIG_MCFPIT -- define to use PIT timer
115
116CONFIG_FSL_I2C -- define to use FSL common I2C driver
117CONFIG_HARD_I2C -- define for I2C hardware support
118CONFIG_SOFT_I2C -- define for I2C bit-banged
6d0f6bcf
JCPV
119CONFIG_SYS_I2C_SPEED -- define for I2C speed
120CONFIG_SYS_I2C_SLAVE -- define for I2C slave address
121CONFIG_SYS_I2C_OFFSET -- define for I2C base address offset
122CONFIG_SYS_IMMR -- define for MBAR offset
8ae158cd
TL
123
124CONFIG_PCI -- define for PCI support
125CONFIG_PCI_PNP -- define for Plug n play support
6d0f6bcf
JCPV
126CONFIG_SYS_PCI_MEM_BUS -- PCI memory logical offset
127CONFIG_SYS_PCI_MEM_PHYS -- PCI memory physical offset
128CONFIG_SYS_PCI_MEM_SIZE -- PCI memory size
129CONFIG_SYS_PCI_IO_BUS -- PCI IO logical offset
130CONFIG_SYS_PCI_IO_PHYS -- PCI IO physical offset
131CONFIG_SYS_PCI_IO_SIZE -- PCI IO size
132CONFIG_SYS_PCI_CFG_BUS -- PCI Configuration logical offset
133CONFIG_SYS_PCI_CFG_PHYS -- PCI Configuration physical offset
134CONFIG_SYS_PCI_CFG_SIZE -- PCI Configuration size
8ae158cd
TL
135
136CONFIG_EXTRA_CLOCK -- Enable extra clock such as vco, flexbus, pci, etc
137
6d0f6bcf 138CONFIG_SYS_MBAR -- define MBAR offset
8ae158cd 139
6d0f6bcf 140CONFIG_SYS_ATMEL_BOOT -- To determine the u-boot is booted from Atmel or Intel
8ae158cd
TL
141
142CONFIG_MONITOR_IS_IN_RAM -- Not support
143
6d0f6bcf 144CONFIG_SYS_INIT_RAM_ADDR -- defines the base address of the MCF54455 internal SRAM
8ae158cd 145
6d0f6bcf
JCPV
146CONFIG_SYS_CSn_BASE -- defines the Chip Select Base register
147CONFIG_SYS_CSn_MASK -- defines the Chip Select Mask register
148CONFIG_SYS_CSn_CTRL -- defines the Chip Select Control register
8ae158cd 149
6d0f6bcf
JCPV
150CONFIG_SYS_ATMEL_BASE -- defines the Atmel Flash base
151CONFIG_SYS_INTEL_BASE -- defines the Intel Flash base
8ae158cd 152
6d0f6bcf
JCPV
153CONFIG_SYS_SDRAM_BASE -- defines the DRAM Base
154CONFIG_SYS_SDRAM_BASE1 -- defines the DRAM Base 1
8ae158cd
TL
155
1562. MEMORY MAP UNDER U-BOOT AND LINUX KERNEL
157===========================================
1582.1. System memory map:
159 Flash: 0x00000000-0x3FFFFFFF (1024MB)
160 DDR: 0x40000000-0x7FFFFFFF (1024MB)
161 SRAM: 0x80000000-0x8FFFFFFF (256MB)
162 ATA: 0x90000000-0x9FFFFFFF (256MB)
163 PCI: 0xA0000000-0xBFFFFFFF (512MB)
164 FlexBus: 0xC0000000-0xDFFFFFFF (512MB)
165 IP: 0xF0000000-0xFFFFFFFF (256MB)
166
1672.2. For the initial bringup, we adopted a consistent memory scheme between u-boot and
168 linux kernel, you can customize it based on your system requirements:
169 Atmel boot:
170 Flash0: 0x00000000-0x0007FFFF (512KB)
171 Flash1: 0x04000000-0x05FFFFFF (32MB)
172 Intel boot:
173 Flash0: 0x00000000-0x01FFFFFF (32MB)
174 Flash1: 0x04000000-0x0407FFFF (512KB)
175
176 CPLD: 0x08000000-0x08FFFFFF (16MB)
177 FPGA: 0x09000000-0x09FFFFFF (16MB)
178 DDR: 0x40000000-0x4FFFFFFF (256MB)
179 SRAM: 0x80000000-0x80007FFF (32KB)
180 IP: 0xFC000000-0xFC0FFFFF (64KB)
181
1823. SWITCH SETTINGS
183==================
1843.1 SW1 Pin3: 0 - Boot from Atmel or 1 - INTEL
185 SW1 Pin4: 0 - ULPI chip not in reset state or 1 - ULPI chip in reset state
186 SW1 Pin5: 0 - Full ATA Bus enabled, FEC Phy1 powered down
187 1 - Upper 8 bits ATA data bus disabled, FEC PHY1 active
188 SW1 Pin6: 0 - FEC Phy0 active or 1 - FEC Phy0 powered down
189 SW1 Pin3: 0 - Boot from Atmel or 1 - INTEL
190
1914. COMPILATION
192==============
1934.1 To create U-Boot the gcc-4.1-32 compiler set (ColdFire ELF version)
194from codesourcery.com was used. Download it from:
195http://www.codesourcery.com/gnu_toolchains/coldfire/download.html
196
1974.2 Compilation
198 export CROSS_COMPILE=cross-compile-prefix
199 cd u-boot-1.x.x
200 make distclean
201 make M54455EVB_config, or - default to atmel 33Mhz input clock
202 make M54455EVB_atmel_config, or - default to atmel 33Mhz input clock
203 make M54455EVB_a33_config, or - default to atmel 33Mhz input clock
204 make M54455EVB_a66_config, or - default to atmel 66Mhz input clock
205 make M54455EVB_intel_config, or - default to intel 33Mhz input clock
206 make M54455EVB_i33_config, or - default to intel 33Mhz input clock
207 make M54455EVB_i66_config, or - default to intel 66Mhz input clock
208 make
209
2105. SCREEN DUMP
211==============
2125.1 M54455EVB Development board
213 Boot from Atmel (NOTE: May not show exactly the same)
214
215U-Boot 1.2.0-g98c80b46-dirty (Jul 26 2007 - 12:44:08)
216
217CPU: Freescale MCF54455 (Mask:48 Version:1)
218 CPU CLK 266 Mhz BUS CLK 133 Mhz FLB CLK 66 Mhz
219 PCI CLK 33 Mhz INP CLK 33 Mhz VCO CLK 533 Mhz
220Board: Freescale M54455 EVB
221I2C: ready
222DRAM: 256 MB
223FLASH: 16.5 MB
224In: serial
225Out: serial
226Err: serial
227Net: FEC0, FEC1
228IDE: Bus 0: not available
229-> print
230bootargs=root=/dev/ram rw
231bootdelay=1
232baudrate=115200
233ethaddr=00:e0:0c:bc:e5:60
234eth1addr=00:e0:0c:bc:e5:61
235hostname=M54455EVB
236netdev=eth0
237inpclk=33333333
238loadaddr=40010000
239load=tftp ${loadaddr) ${u-boot}
240upd=run load; run prog
241prog=prot off 0 2ffff;era 0 2ffff;cp.b ${loadaddr} 0 ${filesize};save
242ethact=FEC0
243mtdids=nor0=M54455EVB-1
244mtdparts=M54455EVB-1:16m(user)
245u-boot=u-boot54455.bin
246filesize=292b4
247fileaddr=40010000
248gatewayip=192.168.1.1
249netmask=255.255.255.0
250ipaddr=192.168.1.3
251serverip=192.168.1.2
252stdin=serial
253stdout=serial
254stderr=serial
255mem=261632k
256
257Environment size: 563/8188 bytes
258-> bdinfo
259memstart = 0x40000000
260memsize = 0x10000000
261flashstart = 0x00000000
262flashsize = 0x01080000
263flashoffset = 0x00000000
264sramstart = 0x80000000
265sramsize = 0x00008000
266mbar = 0xFC000000
267busfreq = 133.333 MHz
268pcifreq = 33.333 MHz
269flbfreq = 66.666 MHz
270inpfreq = 33.333 MHz
271vcofreq = 533.333 MHz
272ethaddr = 00:E0:0C:BC:E5:60
273eth1addr = 00:E0:0C:BC:E5:61
274ip_addr = 192.168.1.3
275baudrate = 115200 bps
276->
277-> help
278? - alias for 'help'
279autoscr - run script from memory
280base - print or set address offset
281bdinfo - print Board Info structure
282boot - boot default, i.e., run 'bootcmd'
283bootd - boot default, i.e., run 'bootcmd'
284bootelf - Boot from an ELF image in memory
285bootm - boot application image from memory
286bootp - boot image via network using BootP/TFTP protocol
287bootvx - Boot vxWorks from an ELF image
288cmp - memory compare
289coninfo - print console devices and information
290cp - memory copy
291crc32 - checksum calculation
292date - get/set/reset date & time
293dcache - enable or disable data cache
294diskboot- boot from IDE device
295echo - echo args to console
296erase - erase FLASH memory
297ext2load- load binary file from a Ext2 filesystem
298ext2ls - list files in a directory (default /)
299fatinfo - print information about filesystem
300fatload - load binary file from a dos filesystem
301fatls - list files in a directory (default /)
302flinfo - print FLASH memory information
303fsinfo - print information about filesystems
304fsload - load binary file from a filesystem image
305go - start application at address 'addr'
306help - print online help
307icache - enable or disable instruction cache
308icrc32 - checksum calculation
309ide - IDE sub-system
310iloop - infinite loop on address range
311imd - i2c memory display
312iminfo - print header information for application image
313imls - list all images found in flash
314imm - i2c memory modify (auto-incrementing)
315imw - memory write (fill)
316inm - memory modify (constant address)
317iprobe - probe to discover valid I2C chip addresses
318itest - return true/false on integer compare
319loadb - load binary file over serial line (kermit mode)
320loads - load S-Record file over serial line
321loady - load binary file over serial line (ymodem mode)
322loop - infinite loop on address range
323ls - list files in a directory (default /)
324md - memory display
325mii - MII utility commands
326mm - memory modify (auto-incrementing)
327mtest - simple RAM test
328mw - memory write (fill)
329nfs - boot image via network using NFS protocol
330nm - memory modify (constant address)
331pci - list and access PCI Configuration Space
332ping - send ICMP ECHO_REQUEST to network host
333printenv- print environment variables
334protect - enable or disable FLASH write protection
335rarpboot- boot image via network using RARP/TFTP protocol
336reset - Perform RESET of the CPU
337run - run commands in an environment variable
338saveenv - save environment variables to persistent storage
339setenv - set environment variables
340sleep - delay execution for some time
341tftpboot- boot image via network using TFTP protocol
342version - print monitor version
343->bootm 4000000
344
345## Booting image at 04000000 ...
346 Image Name: Linux Kernel Image
347 Created: 2007-08-14 15:13:00 UTC
348 Image Type: M68K Linux Kernel Image (uncompressed)
349 Data Size: 2301952 Bytes = 2.2 MB
350 Load Address: 40020000
351 Entry Point: 40020000
352 Verifying Checksum ... OK
353OK
354Linux version 2.6.20-gfe5136d6-dirty (mattw@kea) (gcc version 4.2.0 20070318 (pr
355erelease) (Sourcery G++ Lite 4.2-20)) #108 Mon Aug 13 13:00:13 MDT 2007
356starting up linux startmem 0xc0254000, endmem 0xcfffffff, size 253MB
357Built 1 zonelists. Total pages: 32624
358Kernel command line: root=/dev/mtdblock1 rw rootfstype=jffs2 ip=none mtdparts=ph
359ysmap-flash.0:5M(kernel)ro,-(jffs2)
360PID hash table entries: 1024 (order: 10, 4096 bytes)
361Console: colour dummy device 80x25
362Dentry cache hash table entries: 32768 (order: 4, 131072 bytes)
363Inode-cache hash table entries: 16384 (order: 3, 65536 bytes)
364Memory: 257496k/262136k available (1864k kernel code, 2440k data, 88k init)
365Mount-cache hash table entries: 1024
366NET: Registered protocol family 16
367SCSI subsystem initialized
368NET: Registered protocol family 2
369IP route cache hash table entries: 2048 (order: 0, 8192 bytes)
370TCP established hash table entries: 8192 (order: 2, 32768 bytes)
371TCP bind hash table entries: 4096 (order: 1, 16384 bytes)
372TCP: Hash tables configured (established 8192 bind 4096)
373TCP reno registered
374JFFS2 version 2.2. (NAND) (C) 2001-2006 Red Hat, Inc.
375io scheduler noop registered
376io scheduler anticipatory registered
377io scheduler deadline registered
378io scheduler cfq registered (default)
379ColdFire internal UART serial driver version 1.00
380ttyS0 at 0xfc060000 (irq = 90) is a builtin ColdFire UART
381ttyS1 at 0xfc064000 (irq = 91) is a builtin ColdFire UART
382ttyS2 at 0xfc068000 (irq = 92) is a builtin ColdFire UART
383RAMDISK driver initialized: 16 RAM disks of 64000K size 1024 blocksize
384loop: loaded (max 8 devices)
385FEC ENET Version 0.2
386fec: PHY @ 0x0, ID 0x20005ca2 -- DP83849
387eth0: ethernet 00:08:ee:00:e4:19
388physmap platform flash device: 01000000 at 04000000
389physmap-flash.0: Found 1 x16 devices at 0x0 in 8-bit bank
390 Intel/Sharp Extended Query Table at 0x0031
391Using buffer write method
392cfi_cmdset_0001: Erase suspend on write enabled
3932 cmdlinepart partitions found on MTD device physmap-flash.0
394Creating 2 MTD partitions on "physmap-flash.0":
3950x00000000-0x00500000 : "kernel"
396mtd: Giving out device 0 to kernel
3970x00500000-0x01000000 : "jffs2"
398mtd: Giving out device 1 to jffs2
399mice: PS/2 mouse device common for all mice
400i2c /dev entries driver
401TCP cubic registered
402NET: Registered protocol family 1
403NET: Registered protocol family 17
404NET: Registered protocol family 15
405VFS: Mounted root (jffs2 filesystem).
406Setting the hostname to freescale
407Mounting filesystems
408mount: Mounting usbfs on /proc/bus/usb failed: No such file or directory
409Starting syslogd and klogd
410Setting up networking on loopback device:
411Setting up networking on eth0:
412eth0: config: auto-negotiation on, 100FDX, 100HDX, 10FDX, 10HDX.
413Adding static route for default gateway to 172.27.255.254:
414Setting nameserver to 172.27.0.1 in /etc/resolv.conf:
415Starting inetd:
416/ #