m68k: Drop CONFIG_MCFPIT support
[oweals/u-boot.git] / board / freescale / m5373evb / README
1 Freescale MCF5373EVB ColdFire Development Board
2 ================================================
3
4 TsiChung Liew(Tsi-Chung.Liew@freescale.com)
5 Created 11/08/07
6 ===========================================
7
8
9 Changed 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
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
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
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
59
60 1 MCF5373 specific Options/Settings
61 ====================================
62 1.1 pre-loader is no longer suppoer in thie coldfire family
63
64 1.2 Configuration settings for M5373EVB Development Board
65 CONFIG_MCF532x          -- define for all MCF532x CPUs
66 CONFIG_M5373            -- define for all Freescale MCF5373 CPUs
67 CONFIG_M5373EVB         -- define for M5373EVB board
68
69 CONFIG_MCFUART          -- define to use common CF Uart driver
70 CONFIG_SYS_UART_PORT            -- define UART port number, start with 0, 1 and 2
71 CONFIG_BAUDRATE         -- define UART baudrate
72
73 CONFIG_MCFRTC           -- define to use common CF RTC driver
74 CONFIG_SYS_MCFRTC_BASE          -- provide base address for RTC in immap.h
75 CONFIG_SYS_RTC_OSCILLATOR       -- define RTC clock frequency
76 RTC_DEBUG               -- define to show RTC debug message
77 CONFIG_CMD_DATE         -- enable to use date feature in U-Boot
78
79 CONFIG_MCFFEC           -- define to use common CF FEC driver
80 CONFIG_MII              -- enable to use MII driver
81 CONFIG_CF_DOMII         -- enable to use MII feature in cmd_mii.c
82 CONFIG_SYS_DISCOVER_PHY -- enable PHY discovery
83 CONFIG_SYS_RX_ETH_BUFFER        -- Set FEC Receive buffer
84 CONFIG_SYS_FAULT_ECHO_LINK_DOWN--
85 CONFIG_SYS_FEC0_PINMUX          -- Set FEC0 Pin configuration
86 CONFIG_SYS_FEC0_MIIBASE -- Set FEC0 MII base register
87 MCFFEC_TOUT_LOOP        -- set FEC timeout loop
88
89 CONFIG_MCFTMR           -- define to use DMA timer
90
91 CONFIG_SYS_I2C_FSL      -- define to use FSL common I2C driver
92 CONFIG_SYS_I2C_SOFT     -- define for I2C bit-banged
93 CONFIG_SYS_I2C_SPEED            -- define for I2C speed
94 CONFIG_SYS_I2C_SLAVE            -- define for I2C slave address
95 CONFIG_SYS_I2C_OFFSET           -- define for I2C base address offset
96 CONFIG_SYS_IMMR         -- define for MBAR offset
97
98 CONFIG_SYS_MBAR         -- define MBAR offset
99
100 CONFIG_MONITOR_IS_IN_RAM -- Not support
101
102 CONFIG_SYS_INIT_RAM_ADDR        -- defines the base address of the MCF5373 internal SRAM
103
104 CONFIG_SYS_CSn_BASE     -- defines the Chip Select Base register
105 CONFIG_SYS_CSn_MASK     -- defines the Chip Select Mask register
106 CONFIG_SYS_CSn_CTRL     -- defines the Chip Select Control register
107
108 CONFIG_SYS_SDRAM_BASE   -- defines the DRAM Base
109
110 2. MEMORY MAP UNDER U-BOOT AND LINUX KERNEL
111 ===========================================
112 2.1. System memory map:
113         Flash:          0x00000000-0x3FFFFFFF (1024MB)
114         DDR:            0x40000000-0x7FFFFFFF (1024MB)
115         SRAM:           0x80000000-0x8FFFFFFF (256MB)
116         IP:             0xF0000000-0xFFFFFFFF (256MB)
117
118 2.2. For the initial bringup, we adopted a consistent memory scheme between U-Boot and
119         linux kernel, you can customize it based on your system requirements:
120         Flash0:         0x00000000-0x00FFFFFF (16MB)
121
122         DDR:            0x40000000-0x4FFFFFFF (256MB)
123         SRAM:           0x80000000-0x80007FFF (32KB)
124         IP:             0xFC000000-0xFC0FFFFF (64KB)
125
126 3. COMPILATION
127 ==============
128 3.1     To create U-Boot the gcc-4.1-xx compiler set (ColdFire ELF or
129 uClinux version) from codesourcery.com was used. Download it from:
130 http://www.codesourcery.com/gnu_toolchains/coldfire/download.html
131
132 3.2 Compilation
133    export CROSS_COMPILE=cross-compile-prefix
134    cd u-boot-1.x.x
135    make distclean
136    make M5373EVB_config
137    make
138
139 4. SCREEN DUMP
140 ==============
141 4.1 M5373EVB Development board
142     (NOTE: May not show exactly the same)
143
144 U-Boot 1.3.0 (Nov 8 2007 - 12:44:08)
145
146 CPU:   Freescale MCF5373 (Mask:65 Version:1)
147        CPU CLK 240 Mhz BUS CLK 80 Mhz
148 Board: Freescale FireEngine 5373 EVB
149 I2C:   ready
150 DRAM:  32 MB
151 FLASH: 2 MB
152 In:    serial
153 Out:   serial
154 Err:   serial
155 NAND:  16 MiB
156 Net:   FEC0
157 -> print
158 bootdelay=1
159 baudrate=115200
160 ethaddr=00:e0:0c:bc:e5:60
161 hostname=M5373EVB
162 netdev=eth0
163 loadaddr=40010000
164 load=tftp ${loadaddr) ${u-boot}
165 upd=run load; run prog
166 prog=prot off 0 2ffff;era 0 2ffff;cp.b ${loadaddr} 0 ${filesize};save
167 ethact=FEC0
168 u-boot=u-boot.bin
169 gatewayip=192.168.1.1
170 netmask=255.255.255.0
171 ipaddr=192.168.1.3
172 serverip=192.168.1.2
173 stdin=serial
174 stdout=serial
175 stderr=serial
176 mem=261632k
177
178 Environment size: 401/8188 bytes
179 -> bdinfo
180 memstart    = 0x40000000
181 memsize     = 0x02000000
182 flashstart  = 0x00000000
183 flashsize   = 0x00200000
184 flashoffset = 0x00000000
185 sramstart   = 0x80000000
186 sramsize    = 0x00008000
187 mbar        = 0xFC000000
188 busfreq     =     80 MHz
189 ethaddr     = 00:E0:0C:BC:E5:60
190 ip_addr     = 192.168.1.3
191 baudrate    = 115200 bps
192 ->
193 -> help
194 ?       - alias for 'help'
195 base    - print or set address offset
196 bdinfo  - print Board Info structure
197 boot    - boot default, i.e., run 'bootcmd'
198 bootd   - boot default, i.e., run 'bootcmd'
199 bootelf - Boot from an ELF image in memory
200 bootm   - boot application image from memory
201 bootp   - boot image via network using BootP/TFTP protocol
202 bootvx  - Boot vxWorks from an ELF image
203 cmp     - memory compare
204 coninfo - print console devices and information
205 cp      - memory copy
206 crc32   - checksum calculation
207 date    - get/set/reset date & time
208 dcache  - enable or disable data cache
209 echo    - echo args to console
210 erase   - erase FLASH memory
211 flinfo  - print FLASH memory information
212 go      - start application at address 'addr'
213 help    - print online help
214 i2c     - I2C sub-system
215 icache  - enable or disable instruction cache
216 iminfo  - print header information for application image
217 imls    - list all images found in flash
218 itest   - return true/false on integer compare
219 loadb   - load binary file over serial line (kermit mode)
220 loads   - load S-Record file over serial line
221 loady   - load binary file over serial line (ymodem mode)
222 loop    - infinite loop on address range
223 ls      - list files in a directory (default /)
224 md      - memory display
225 mii     - MII utility commands
226 mm      - memory modify (auto-incrementing)
227 mtest   - simple RAM test
228 mw      - memory write (fill)
229 nand    - NAND sub-system
230 nboot   - boot from NAND device
231 nfs     - boot image via network using NFS protocol
232 nm      - memory modify (constant address)
233 ping    - send ICMP ECHO_REQUEST to network host
234 printenv- print environment variables
235 protect - enable or disable FLASH write protection
236 rarpboot- boot image via network using RARP/TFTP protocol
237 reset   - Perform RESET of the CPU
238 run     - run commands in an environment variable
239 saveenv - save environment variables to persistent storage
240 setenv  - set environment variables
241 sleep   - delay execution for some time
242 source  - run script from memory
243 tftpboot- boot image via network using TFTP protocol
244 version - print monitor version
245 -> tftp 0x40800000 uImage
246 Using FEC0 device
247 TFTP from server 192.168.1.3; our IP address is 192.168.1.3 Filename 'uImage'.
248 Load address: 0x40800000
249 Loading: #################################################################
250           #################################################################
251           ##########
252 done
253 Bytes transferred = 2053270 (1f5496 hex)
254 -> bootm 0x40800000
255 ## Booting image at 40800000 ...
256     Image Name:   Linux Kernel Image
257     Created:      2007-11-07  20:33:08 UTC
258     Image Type:   M68K Linux Kernel Image (gzip compressed)
259     Data Size:    2053206 Bytes =  2 MB
260     Load Address: 40020000
261     Entry Point:  40020000
262     Verifying Checksum ... OK
263     Uncompressing Kernel Image ... OK
264 Linux version 2.6.22-uc1 (mattw@loa) (gcc version 4.2.1 (Sourcery G++ Lite 4.2-7
265
266
267 uClinux/COLDFIRE(m537x)
268 COLDFIRE 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
269 NET: Registered protocol family 16
270 USB-MCF537x: (HOST module) EHCI device is registered
271 USB-MCF537x: (OTG module) EHCI device is registered
272 USB-MCF537x: (OTG module) UDC device is registered
273 usbcore: registered new interface driver usbfs
274 usbcore: registered new interface driver hub
275 usbcore: registered new device driver usb
276 NET: Registered protocol family 2
277 IP 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)
278 TCP: Hash tables configured (established 1024 bind 1024) TCP reno registered
279 JFFS2 version 2.2. (NAND) © 2001-2006 Red Hat, Inc.
280 io scheduler noop registered
281 io scheduler cfq registered (default)
282 ColdFire internal UART serial driver version 1.00 ttyS0 at 0xfc060000 (irq = 90) is a builtin ColdFire UART
283 ttyS1 at 0xfc064000 (irq = 91) is a builtin ColdFire UART
284 ttyS2 at 0xfc068000 (irq = 92) is a builtin ColdFire UART RAMDISK driver initialized: 16 RAM disks of 4096K size 1024 blocksize
285 loop: module loaded
286 nbd: registered device at major 43
287 usbcore: registered new interface driver ub FEC ENET Version 0.2
288 fec: PHY @ 0x1, ID 0x20005c90 -- DP83848
289 eth0: ethernet 00:e0:0c:bc:e5:60
290 uclinux[mtd]: RAM probe address=0x4021c22c size=0x22b000 Creating 1 MTD partitions on "RAM":
291 0x00000000-0x0022b000 : "ROMfs"
292 uclinux[mtd]: set ROMfs to be root filesystem NAND device: Manufacturer ID: 0x20, Chip ID: 0x73 (ST Micro NAND 16MiB 3,3V 8-b) Scanning device for bad blocks Creating 1 MTD partitions on "NAND 16MiB 3,3V 8-bit":
293 0x00000000-0x01000000 : "M53xx flash partition 1"
294 QSPI: spi->max_speed_hz 300000
295 QSPI: Baud set to 255
296 SPI: Coldfire master initialized
297 M537x - Disable UART1 when using Audio
298 udc: Freescale MCF53xx UDC driver version 27 October 2006 init
299 udc: MCF53xx USB Device is found. ID=0x5 Rev=0x41 i2c /dev entries driver
300 usbcore: registered new interface driver usbhid
301 drivers/hid/usbhid/hid-core.c: v2.6:USB HID core driver TCP cubic registered
302 NET: Registered protocol family 1
303 NET: Registered protocol family 17
304 VFS: Mounted root (romfs filesystem) readonly.
305 Freeing unused kernel memory: 64k freed (0x401f5000 - 0x40204000) init started:  BusyBox v1.00 (2007.11.07-19:57+0000) multi-call binary?Setting e Mounting filesystems
306 mount: Mounting devpts on /dev/pts failed: No such device
307 mount: Mounting usbfs on /proc/bus/usb failed: No such file or directory Starting syslogd and klogd Setting up networking on loopback device:
308 Setting up networking on eth0:
309 info, udhcpc (v0.9.9-pre) started
310 eth0: config: auto-negotiation on, 100FDX, 100HDX, 10FDX, 10HDX.
311 debug, Sending discover...
312 debug, Sending discover...
313 debug, Sending select for 172.27.0.130...
314 info, Lease of 172.27.0.130 obtained, lease time 43200 deleting routers
315 route: SIOC[ADD|DEL]RT: No such process
316 adding dns 172.27.0.1
317 Starting the boa webserver:
318 Setting time from ntp server: ntp.cs.strath.ac.uk
319 ntp.cs.strath.ac.uk: Unknown host
320
321
322 BusyBox v1.00 (2007.11.07-19:57+0000) Built-in shell (msh) Enter 'help' for a list of built-in commands.
323
324 #