[people/ms/u-boot.git] / doc / README.mpc8313erdb

Freescale MPC8313ERDB Board
-----------------------------------------

1.	Board Switches and Jumpers

	S3 is used to set CONFIG_SYS_RESET_SOURCE.

	To boot the image at 0xFE000000 in NOR flash, use these DIP
	switch settings for S3 S4:

	+------+	+------+
	|      |	| **** |
	| **** |	|      |
	+------+ ON	+------+ ON
	  4321		  4321
	(where the '*' indicates the position of the tab of the switch.)

	To boot the image at the beginning of NAND flash, use these
	DIP switch settings for S3 S4:

	+------+	+------+
	| *    |	|  *** |
	|  *** |	| *    |
	+------+ ON	+------+ ON
	  4321		  4321
	(where the '*' indicates the position of the tab of the switch.)

	When booting from NAND, use u-boot-nand.bin, not u-boot.bin.

2.	Memory Map
	The memory map looks like this:

	0x0000_0000	0x07ff_ffff	DDR		 128M
	0x8000_0000	0x8fff_ffff	PCI MEM		 256M
	0x9000_0000	0x9fff_ffff	PCI_MMIO	 256M
	0xe000_0000	0xe00f_ffff	IMMR		 1M
	0xe200_0000	0xe20f_ffff	PCI IO		 16M
	0xe280_0000	0xe280_7fff	NAND FLASH (CS1) 32K
	0xf000_0000	0xf001_ffff	VSC7385 (CS2)	 128K
	0xfa00_0000	0xfa00_7fff	Board Status/	 32K
					LED Control (CS3)
	0xfe00_0000	0xfe7f_ffff	NOR FLASH (CS0)	 8M

	When booting from NAND, NAND flash is CS0 and NOR flash
	is CS1.

3.	Definitions

3.1	Explanation of NEW definitions in:

	include/configs/MPC8313ERDB.h

	CONFIG_MPC83xx		MPC83xx family
	CONFIG_MPC831x		MPC831x specific
	CONFIG_MPC8313ERDB	MPC8313ERDB board specific

4.	Compilation

	Assuming you're using BASH (or similar) as your shell:

	export CROSS_COMPILE=your-cross-compiler-prefix-
	make distclean
	make MPC8313ERDB_XXX_config
	(where XXX is:
	   33 - 33 MHz oscillator, boot from NOR flash
	   66 - 66 MHz oscillator, boot from NOR flash
	   NAND_33 - 33 MHz oscillator, boot from NAND flash
	   NAND_66 - 66 MHz oscillator, boot from NAND flash)
	make

5.	Downloading and Flashing Images

5.1	Reflash U-boot Image using U-boot

	NOR flash:

	=>run tftpflash

	You may want to try
	=>tftpboot $loadaddr $uboot
	first, to make sure that the TFTP load will succeed before it
	goes ahead and wipes out your current firmware.  And of course,
	have an alternate means of programming the flash available
	if the new u-boot doesn't boot.

	NAND flash:

	=>tftpboot $loadaddr <filename>
	=>nand erase 0 0x80000
	=>nand write $loadaddr 0 0x80000

	...where 0x80000 is the filesize rounded up to
	the next 0x20000 increment.

5.2	Downloading and Booting Linux Kernel

	Ensure that all networking-related environment variables are set
	properly (including ipaddr, serverip, gatewayip (if needed),
	netmask, ethaddr, eth1addr, rootpath (if using NFS root),
	fdtfile, and bootfile).

	Then, do one of the following, depending on whether you
	want an NFS root or a ramdisk root:

	=>run nfsboot
	or
	=>run ramboot

6	Notes

	The console baudrate for MPC8313ERDB is 115200bps.
Commit	Line	Data
96b8a054 SW	1	Freescale MPC8313ERDB Board
	2	-----------------------------------------
	3
	4	1. Board Switches and Jumpers
	5
6d0f6bcf	6	S3 is used to set CONFIG_SYS_RESET_SOURCE.
96b8a054 SW	7
96b8a054 SW	8	To boot the image at 0xFE000000 in NOR flash, use these DIP
be5a7190	9	switch settings for S3 S4:
96b8a054 SW	10
	11	+------+ +------+
	12	\| \| \| **** \|
	13	\| **** \| \| \|
	14	+------+ ON +------+ ON
	15	4321 4321
	16	(where the '*' indicates the position of the tab of the switch.)
	17
5cdade07 SW	18	To boot the image at the beginning of NAND flash, use these
	19	DIP switch settings for S3 S4:
	20
	21	+------+ +------+
	22	\| * \| \| *** \|
	23	\| *** \| \| * \|
	24	+------+ ON +------+ ON
	25	4321 4321
	26	(where the '*' indicates the position of the tab of the switch.)
	27
	28	When booting from NAND, use u-boot-nand.bin, not u-boot.bin.
	29
96b8a054 SW	30	2. Memory Map
	31	The memory map looks like this:
	32
	33	0x0000_0000 0x07ff_ffff DDR 128M
	34	0x8000_0000 0x8fff_ffff PCI MEM 256M
	35	0x9000_0000 0x9fff_ffff PCI_MMIO 256M
	36	0xe000_0000 0xe00f_ffff IMMR 1M
53677ef1	37	0xe200_0000 0xe20f_ffff PCI IO 16M
96b8a054 SW	38	0xe280_0000 0xe280_7fff NAND FLASH (CS1) 32K
	39	0xf000_0000 0xf001_ffff VSC7385 (CS2) 128K
	40	0xfa00_0000 0xfa00_7fff Board Status/ 32K
	41	LED Control (CS3)
	42	0xfe00_0000 0xfe7f_ffff NOR FLASH (CS0) 8M
	43
5cdade07 SW	44	When booting from NAND, NAND flash is CS0 and NOR flash
	45	is CS1.
	46
96b8a054 SW	47	3. Definitions
	48
	49	3.1 Explanation of NEW definitions in:
	50
	51	include/configs/MPC8313ERDB.h
	52
	53	CONFIG_MPC83xx MPC83xx family
	54	CONFIG_MPC831x MPC831x specific
	55	CONFIG_MPC8313ERDB MPC8313ERDB board specific
	56
	57	4. Compilation
	58
	59	Assuming you're using BASH (or similar) as your shell:
	60
	61	export CROSS_COMPILE=your-cross-compiler-prefix-
	62	make distclean
5cdade07 SW	63	make MPC8313ERDB_XXX_config
	64	(where XXX is:
	65	33 - 33 MHz oscillator, boot from NOR flash
	66	66 - 66 MHz oscillator, boot from NOR flash
	67	NAND_33 - 33 MHz oscillator, boot from NAND flash
	68	NAND_66 - 66 MHz oscillator, boot from NAND flash)
96b8a054 SW	69	make
	70
	71	5. Downloading and Flashing Images
	72
	73	5.1 Reflash U-boot Image using U-boot
	74
5cdade07 SW	75	NOR flash:
5cdade07 SW	76
96b8a054 SW	77	=>run tftpflash
	78
	79	You may want to try
	80	=>tftpboot $loadaddr $uboot
	81	first, to make sure that the TFTP load will succeed before it
	82	goes ahead and wipes out your current firmware. And of course,
	83	have an alternate means of programming the flash available
	84	if the new u-boot doesn't boot.
	85
5cdade07 SW	86	NAND flash:
	87
	88	=>tftpboot $loadaddr <filename>
	89	=>nand erase 0 0x80000
	90	=>nand write $loadaddr 0 0x80000
	91
	92	...where 0x80000 is the filesize rounded up to
	93	the next 0x20000 increment.
	94
96b8a054 SW	95	5.2 Downloading and Booting Linux Kernel
	96
	97	Ensure that all networking-related environment variables are set
	98	properly (including ipaddr, serverip, gatewayip (if needed),
	99	netmask, ethaddr, eth1addr, rootpath (if using NFS root),
	100	fdtfile, and bootfile).
	101
	102	Then, do one of the following, depending on whether you
	103	want an NFS root or a ramdisk root:
	104
	105	=>run nfsboot
	106	or
	107	=>run ramboot
	108
	109	6 Notes
	110
96b8a054	111	The console baudrate for MPC8313ERDB is 115200bps.