[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.

* zc70x
  - 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

 # Configure for zc70x board
   $ make zynq_zc70x_config
     Configuring for zynq_zc70x board...

 # Building default dts for zc702 board
   $ make

 # Building specified dts for zc706 board
   $ make DEVICE_TREE=zynq-zc706

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, zc770_xm012, zc770_xm013
- Added zynq drivers:
  serial - drivers/serial/serial_zynq.c
  net - drivers/net/zynq_gem.c
  mmc - drivers/mmc/zynq_sdhci.c
  mmc - drivers/mmc/zynq_sdhci.c
  spi-  drivers/spi/zynq_spi.c
  i2c - drivers/i2c/zynq_i2c.c
- Done proper cleanups on board configurations
- Added basic FDT support for zynq boards
- d-cache support for zynq_gem.c

6. TODO

- Add zynq boards support - zc770_xm011
- Add zynq qspi controller driver
- Add zynq nand controller driver
- 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
	20	* zc70x
	21	- zc702 (single qspi, gem0, mmc) [1]
	22	- zc706 (dual parallel qspi, gem0, mmc) [2]
	23	* zed (single qspi, gem0, mmc) [3]
	24	* microzed (single qspi, gem0, mmc) [4]
	25	* zc770
	26	- zc770-xm010 (single qspi, gem0, mmc)
	27	- zc770-xm011 (8 or 16 bit nand)
	28	- zc770-xm012 (nor)
	29	- zc770-xm013 (dual parallel qspi, gem1)
	30
10a147bc JT	31	3. Building
	32
	33	# Configure for zc70x board
	34	$ make zynq_zc70x_config
	35	Configuring for zynq_zc70x board...
	36
	37	# Building default dts for zc702 board
	38	$ make
	39
	40	# Building specified dts for zc706 board
	41	$ make DEVICE_TREE=zynq-zc706
	42
	43	4. Bootmode
b3de9249 JT	44
	45	Zynq has a facility to read the bootmode from the slcr bootmode register
	46	once user is setting through jumpers on the board - see page no:1546 on [5]
	47
	48	All possible bootmode values are defined in Table 6-2:Boot_Mode MIO Pins
	49	on [5].
	50
	51	board_late_init() will read the bootmode values using slcr bootmode register
	52	at runtime and assign the modeboot variable to specific bootmode string which
	53	is intern used in autoboot.
	54
	55	SLCR bootmode register Bit[3:0] values
	56	#define ZYNQ_BM_NOR 0x02
	57	#define ZYNQ_BM_SD 0x05
	58	#define ZYNQ_BM_JTAG 0x0
	59
	60	"modeboot" variable can assign any of "norboot", "sdboot" or "jtagboot"
	61	bootmode strings at runtime.
	62
10a147bc	63	5. Mainline status
ba45a072 JT	64
	65	- Added basic board configurations support.
	66	- Added zynq u-boot bsp code - arch/arm/cpu/armv7/zynq
10a147bc	67	- Added zynq boards named - zc70x, zed, microzed, zc770_xm010, zc770_xm012, zc770_xm013
ba45a072 JT	68	- Added zynq drivers:
	69	serial - drivers/serial/serial_zynq.c
	70	net - drivers/net/zynq_gem.c
	71	mmc - drivers/mmc/zynq_sdhci.c
	72	mmc - drivers/mmc/zynq_sdhci.c
	73	spi- drivers/spi/zynq_spi.c
	74	i2c - drivers/i2c/zynq_i2c.c
10a147bc JT	75	- Done proper cleanups on board configurations
	76	- Added basic FDT support for zynq boards
	77	- d-cache support for zynq_gem.c
ba45a072	78
10a147bc	79	6. TODO
ba45a072	80
10a147bc	81	- Add zynq boards support - zc770_xm011
ba45a072 JT	82	- Add zynq qspi controller driver
ba45a072 JT	83	- Add zynq nand controller driver
10a147bc	84	- Add FDT support on individual drivers
ba45a072 JT	85
	86	[1] http://www.xilinx.com/products/boards-and-kits/EK-Z7-ZC702-G.htm
	87	[2] http://www.xilinx.com/products/boards-and-kits/EK-Z7-ZC706-G.htm
	88	[3] http://zedboard.org/product/zedboard
	89	[4] http://zedboard.org/product/microzed
b3de9249	90	[5] http://www.xilinx.com/support/documentation/user_guides/ug585-Zynq-7000-TRM.pdf
ba45a072 JT	91
	92	--
	93	Jagannadha Sutradharudu Teki <jaganna@xilinx.com>
	94	Sun Dec 15 14:52:41 IST 2013