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