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

#
# Xilinx ZYNQ U-Boot
#
# (C) Copyright 2013 Xilinx, Inc.
#
# SPDX-License-Identifier:	GPL-2.0+
#

1. About this

This document describes the information about Xilinx Zynq U-Boot -
like supported boards, ML status and TODO list.

2. Zynq boards

Xilinx Zynq-7000 All Programmable SoCs enable extensive system level
differentiation, integration, and flexibility through hardware, software,
and I/O programmability.

* zc702 (single qspi, gem0, mmc) [1]
* zc706 (dual parallel qspi, gem0, mmc) [2]
* zed (single qspi, gem0, mmc) [3]
* microzed (single qspi, gem0, mmc) [4]
* zc770
  - zc770-xm010 (single qspi, gem0, mmc)
  - zc770-xm011 (8 or 16 bit nand)
  - zc770-xm012 (nor)
  - zc770-xm013 (dual parallel qspi, gem1)

3. Building

 ex. configure and build for zc702 board
   $ make zynq_zc702_config
   $ make

4. Bootmode

Zynq has a facility to read the bootmode from the slcr bootmode register
once user is setting through jumpers on the board - see page no:1546 on [5]

All possible bootmode values are defined in Table 6-2:Boot_Mode MIO Pins
on [5].

board_late_init() will read the bootmode values using slcr bootmode register
at runtime and assign the modeboot variable to specific bootmode string which
is intern used in autoboot.

SLCR bootmode register Bit[3:0] values
#define ZYNQ_BM_NOR		0x02
#define ZYNQ_BM_SD		0x05
#define ZYNQ_BM_JTAG		0x0

"modeboot" variable can assign any of "norboot", "sdboot" or "jtagboot"
bootmode strings at runtime.

5. Mainline status

- Added basic board configurations support.
- Added zynq u-boot bsp code - arch/arm/cpu/armv7/zynq
- Added zynq boards named - zc70x, zed, microzed, zc770_xm010/xm011/xm012/xm013
- Added zynq drivers:
  serial - drivers/serial/serial_zynq.c
  net - drivers/net/zynq_gem.c
  mmc - drivers/mmc/zynq_sdhci.c
  spi - drivers/spi/zynq_spi.c
  qspi - drivers/spi/zynq_qspi.c
  i2c - drivers/i2c/zynq_i2c.c
  nand - drivers/mtd/nand/zynq_nand.c
- Done proper cleanups on board configurations
- Added basic FDT support for zynq boards
- d-cache support for zynq_gem.c

6. TODO

- Add FDT support on individual drivers

[1] http://www.xilinx.com/products/boards-and-kits/EK-Z7-ZC702-G.htm
[2] http://www.xilinx.com/products/boards-and-kits/EK-Z7-ZC706-G.htm
[3] http://zedboard.org/product/zedboard
[4] http://zedboard.org/product/microzed
[5] http://www.xilinx.com/support/documentation/user_guides/ug585-Zynq-7000-TRM.pdf

--
Jagannadha Sutradharudu Teki <jaganna@xilinx.com>
Sun Dec 15 14:52:41 IST 2013
Commit	Line	Data
ba45a072 JT	1	#
	2	# Xilinx ZYNQ U-Boot
	3	#
	4	# (C) Copyright 2013 Xilinx, Inc.
	5	#
	6	# SPDX-License-Identifier: GPL-2.0+
	7	#
	8
	9	1. About this
	10
	11	This document describes the information about Xilinx Zynq U-Boot -
	12	like supported boards, ML status and TODO list.
	13
	14	2. Zynq boards
	15
	16	Xilinx Zynq-7000 All Programmable SoCs enable extensive system level
	17	differentiation, integration, and flexibility through hardware, software,
	18	and I/O programmability.
	19
9bd53b62 MY	20	* zc702 (single qspi, gem0, mmc) [1]
9bd53b62 MY	21	* zc706 (dual parallel qspi, gem0, mmc) [2]
ba45a072 JT	22	* zed (single qspi, gem0, mmc) [3]
	23	* microzed (single qspi, gem0, mmc) [4]
	24	* zc770
	25	- zc770-xm010 (single qspi, gem0, mmc)
	26	- zc770-xm011 (8 or 16 bit nand)
	27	- zc770-xm012 (nor)
	28	- zc770-xm013 (dual parallel qspi, gem1)
	29
10a147bc JT	30	3. Building
10a147bc JT	31
9bd53b62 MY	32	ex. configure and build for zc702 board
9bd53b62 MY	33	$ make zynq_zc702_config
10a147bc JT	34	$ make
10a147bc JT	35
10a147bc	36	4. Bootmode
b3de9249 JT	37
	38	Zynq has a facility to read the bootmode from the slcr bootmode register
	39	once user is setting through jumpers on the board - see page no:1546 on [5]
	40
	41	All possible bootmode values are defined in Table 6-2:Boot_Mode MIO Pins
	42	on [5].
	43
	44	board_late_init() will read the bootmode values using slcr bootmode register
	45	at runtime and assign the modeboot variable to specific bootmode string which
	46	is intern used in autoboot.
	47
	48	SLCR bootmode register Bit[3:0] values
	49	#define ZYNQ_BM_NOR 0x02
	50	#define ZYNQ_BM_SD 0x05
	51	#define ZYNQ_BM_JTAG 0x0
	52
	53	"modeboot" variable can assign any of "norboot", "sdboot" or "jtagboot"
	54	bootmode strings at runtime.
	55
10a147bc	56	5. Mainline status
ba45a072 JT	57
	58	- Added basic board configurations support.
	59	- Added zynq u-boot bsp code - arch/arm/cpu/armv7/zynq
546a496f	60	- Added zynq boards named - zc70x, zed, microzed, zc770_xm010/xm011/xm012/xm013
ba45a072 JT	61	- Added zynq drivers:
	62	serial - drivers/serial/serial_zynq.c
	63	net - drivers/net/zynq_gem.c
	64	mmc - drivers/mmc/zynq_sdhci.c
fe3dfb23 EG	65	spi - drivers/spi/zynq_spi.c
fe3dfb23 EG	66	qspi - drivers/spi/zynq_qspi.c
ba45a072	67	i2c - drivers/i2c/zynq_i2c.c
fe3dfb23	68	nand - drivers/mtd/nand/zynq_nand.c
10a147bc JT	69	- Done proper cleanups on board configurations
	70	- Added basic FDT support for zynq boards
	71	- d-cache support for zynq_gem.c
ba45a072	72
10a147bc	73	6. TODO
ba45a072	74
10a147bc	75	- Add FDT support on individual drivers
ba45a072 JT	76
	77	[1] http://www.xilinx.com/products/boards-and-kits/EK-Z7-ZC702-G.htm
	78	[2] http://www.xilinx.com/products/boards-and-kits/EK-Z7-ZC706-G.htm
	79	[3] http://zedboard.org/product/zedboard
	80	[4] http://zedboard.org/product/microzed
b3de9249	81	[5] http://www.xilinx.com/support/documentation/user_guides/ug585-Zynq-7000-TRM.pdf
ba45a072 JT	82
	83	--
	84	Jagannadha Sutradharudu Teki <jaganna@xilinx.com>
	85	Sun Dec 15 14:52:41 IST 2013