xref: /openbmc/u-boot/board/freescale/m547xevb/README (revision 62e92077)
1Freescale MCF5475EVB ColdFire Development Board
2================================================
3
4TsiChung Liew(Tsi-Chung.Liew@freescale.com)
5Created Jan 08, 2008
6===========================================
7
8
9Changed 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
671 MCF547x specific Options/Settings
68====================================
691.1 pre-loader is no longer suppoer in thie coldfire family
70
711.2 Configuration settings for M5475EVB Development Board
72CONFIG_MCF547x_8x	-- define for all MCF547x_8x CPUs
73CONFIG_M547x		-- define for all Freescale MCF547x CPUs
74CONFIG_M5475		-- define for M5475EVB board
75
76CONFIG_MCFUART		-- define to use common CF Uart driver
77CONFIG_SYS_UART_PORT		-- define UART port number, start with 0, 1 and 2
78CONFIG_BAUDRATE		-- define UART baudrate
79
80CONFIG_FSLDMAFEC	-- define to use common dma FEC driver
81CONFIG_MII		-- enable to use MII driver
82CONFIG_CF_DOMII		-- enable to use MII feature in cmd_mii.c
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_FEC1_PINMUX		-- Set FEC1 Pin configuration
88CONFIG_SYS_FEC0_MIIBASE	-- Set FEC0 MII base register
89CONFIG_SYS_FEC1_MIIBASE	-- Set FEC0 MII base register
90MCFFEC_TOUT_LOOP	-- set FEC timeout loop
91CONFIG_HAS_ETH1		-- define to enable second FEC in u-boot
92
93CONFIG_CMD_USB		-- enable USB commands
94CONFIG_USB_OHCI_NEW	-- enable USB OHCI driver
95CONFIG_USB_STORAGE	-- enable USB Storage device
96CONFIG_DOS_PARTITION	-- enable DOS read/write
97
98CONFIG_SLTTMR		-- define to use SLT timer
99
100CONFIG_SYS_I2C_FSL	-- define to use FSL common I2C driver
101CONFIG_HARD_I2C		-- define for I2C hardware support
102CONFIG_SYS_I2C_SOFT	-- define for I2C bit-banged
103CONFIG_SYS_I2C_SPEED		-- define for I2C speed
104CONFIG_SYS_I2C_SLAVE		-- define for I2C slave address
105CONFIG_SYS_I2C_OFFSET		-- define for I2C base address offset
106CONFIG_SYS_IMMR		-- define for MBAR offset
107
108CONFIG_PCI		-- define for PCI support
109CONFIG_PCI_PNP		-- define for Plug n play support
110CONFIG_SKIPPCI_HOSTBRIDGE	-- SKIP PCI Host bridge
111CONFIG_SYS_PCI_MEM_BUS		-- PCI memory logical offset
112CONFIG_SYS_PCI_MEM_PHYS	-- PCI memory physical offset
113CONFIG_SYS_PCI_MEM_SIZE	-- PCI memory size
114CONFIG_SYS_PCI_IO_BUS		-- PCI IO logical offset
115CONFIG_SYS_PCI_IO_PHYS		-- PCI IO physical offset
116CONFIG_SYS_PCI_IO_SIZE		-- PCI IO size
117CONFIG_SYS_PCI_CFG_BUS		-- PCI Configuration logical offset
118CONFIG_SYS_PCI_CFG_PHYS	-- PCI Configuration physical offset
119CONFIG_SYS_PCI_CFG_SIZE	-- PCI Configuration size
120
121CONFIG_SYS_MBAR		-- define MBAR offset
122
123CONFIG_MONITOR_IS_IN_RAM -- Not support
124
125CONFIG_SYS_INIT_RAM_ADDR	-- defines the base address of the MCF547x internal SRAM
126
127CONFIG_SYS_CSn_BASE	-- defines the Chip Select Base register
128CONFIG_SYS_CSn_MASK	-- defines the Chip Select Mask register
129CONFIG_SYS_CSn_CTRL	-- defines the Chip Select Control register
130
131CONFIG_SYS_SDRAM_BASE	-- defines the DRAM Base
132
1332. MEMORY MAP UNDER U-BOOT AND LINUX KERNEL
134===========================================
1352.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
1423. COMPILATION
143==============
1443.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
1483.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
1615. SCREEN DUMP
162==============
1635.1
164
165U-Boot 1.3.1 (Jan  8 2008 - 12:47:44)
166
167CPU:   Freescale MCF5475
168       CPU CLK 266 Mhz BUS CLK 133 Mhz
169Board: Freescale FireEngine 5475 EVB
170I2C:   ready
171DRAM:  64 MB
172FLASH: 18 MB
173In:    serial
174Out:   serial
175Err:   serial
176Net:   FEC0, FEC1
177-> pri
178bootdelay=1
179baudrate=115200
180ethaddr=00:e0:0c:bc:e5:60
181eth1addr=00:e0:0c:bc:e5:61
182ipaddr=192.162.1.2
183serverip=192.162.1.1
184gatewayip=192.162.1.1
185netmask=255.255.255.0
186hostname=M547xEVB
187netdev=eth0
188loadaddr=10000
189u-boot=u-boot.bin
190load=tftp ${loadaddr) ${u-boot}
191upd=run load; run prog
192prog=prot off bank 1;era ff800000 ff82ffff;cp.b ${loadaddr} ff800000 ${filesize};save
193stdin=serial
194stdout=serial
195stderr=serial
196ethact=FEC0
197mem=65024k
198
199Environment size: 433/8188 bytes
200-> bdin
201memstart    = 0x00000000
202memsize     = 0x04000000
203flashstart  = 0xFF800000
204flashsize   = 0x01200000
205flashoffset = 0x00000000
206sramstart   = 0xF2000000
207sramsize    = 0x00001000
208mbar	    = 0xF0000000
209busfreq     = 133.333 MHz
210pcifreq     =	   0 MHz
211ethaddr     = 00:E0:0C:BC:E5:60
212eth1addr    = 00:E0:0C:BC:E5:61
213ip_addr     = 192.162.1.2
214baudrate    = 115200 bps
215-> ?
216?	- alias for 'help'
217base	- print or set address offset
218bdinfo	- print Board Info structure
219boot	- boot default, i.e., run 'bootcmd'
220bootd	- boot default, i.e., run 'bootcmd'
221bootelf - Boot from an ELF image in memory
222bootm	- boot application image from memory
223bootp	- boot image via network using BootP/TFTP protocol
224bootvx	- Boot vxWorks from an ELF image
225cmp	- memory compare
226coninfo - print console devices and information
227cp	- memory copy
228crc32	- checksum calculation
229dcache	- enable or disable data cache
230echo	- echo args to console
231erase	- erase FLASH memory
232flinfo	- print FLASH memory information
233go	- start application at address 'addr'
234help	- print online help
235i2c	- I2C sub-system
236icache	- enable or disable instruction cache
237iminfo	- print header information for application image
238imls	- list all images found in flash
239itest	- return true/false on integer compare
240loadb	- load binary file over serial line (kermit mode)
241loads	- load S-Record file over serial line
242loady	- load binary file over serial line (ymodem mode)
243loop	- infinite loop on address range
244md	- memory display
245mii	- MII utility commands
246mm	- memory modify (auto-incrementing)
247mtest	- simple RAM test
248mw	- memory write (fill)
249nfs	- boot image via network using NFS protocol
250nm	- memory modify (constant address)
251pci	- list and access PCI Configuration Space
252ping	- send ICMP ECHO_REQUEST to network host
253printenv- print environment variables
254protect - enable or disable FLASH write protection
255rarpboot- boot image via network using RARP/TFTP protocol
256reset	- Perform RESET of the CPU
257run	- run commands in an environment variable
258saveenv - save environment variables to persistent storage
259setenv	- set environment variables
260sleep	- delay execution for some time
261source	- run script from memory
262tftpboot- boot image via network using TFTP protocol
263usb	- USB sub-system
264usbboot - boot from USB device
265version - print monitor version
266-> usb start
267(Re)start USB...
268USB:   OHCI pci controller (1131, 1561) found @(0:17:0)
269OHCI regs address 0x80000000
270scanning bus for devices... 2 USB Device(s) found
271       scanning bus for storage devices... 1 Storage Device(s) found
272->
273