Merge branch '2019-07-24-doc-html-cleanup'
[pandora-u-boot.git] / doc / board / xilinx / zynq.rst
1 .. SPDX-License-Identifier: GPL-2.0+
2 ..  (C) Copyright 2013 Xilinx, Inc.
3
4 ZYNQ
5 ====
6
7 About this
8 ----------
9
10 This document describes the information about Xilinx Zynq U-Boot -
11 like supported boards, ML status and TODO list.
12
13 Zynq boards
14 -----------
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 * zc702 (single qspi, gem0, mmc) [1]
21 * zc706 (dual parallel qspi, gem0, mmc) [2]
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
30 Building
31 --------
32
33 configure and build for zc702 board::
34
35    $ make zynq_zc702_config
36    $ make
37
38 Bootmode
39 --------
40
41 Zynq has a facility to read the bootmode from the slcr bootmode register
42 once user is setting through jumpers on the board - see page no:1546 on [5]
43
44 All possible bootmode values are defined in Table 6-2:Boot_Mode MIO Pins
45 on [5].
46
47 board_late_init() will read the bootmode values using slcr bootmode register
48 at runtime and assign the modeboot variable to specific bootmode string which
49 is intern used in autoboot.
50
51 SLCR bootmode register Bit[3:0] values
52
53 .. code-block:: c
54
55    #define ZYNQ_BM_NOR          0x02
56    #define ZYNQ_BM_SD           0x05
57    #define ZYNQ_BM_JTAG         0x0
58
59 "modeboot" variable can assign any of "norboot", "sdboot" or "jtagboot"
60 bootmode strings at runtime.
61
62 Mainline status
63 ---------------
64
65 - Added basic board configurations support.
66 - Added zynq u-boot bsp code - arch/arm/cpu/armv7/zynq
67 - Added zynq boards named - zc70x, zed, microzed, zc770_xm010/xm011/xm012/xm013
68 - Added zynq drivers:
69
70   :serial: drivers/serial/serial_zynq.c
71   :net: drivers/net/zynq_gem.c
72   :mmc: drivers/mmc/zynq_sdhci.c
73   :spi: drivers/spi/zynq_spi.c
74   :qspi: drivers/spi/zynq_qspi.c
75   :i2c: drivers/i2c/zynq_i2c.c
76   :nand: drivers/mtd/nand/raw/zynq_nand.c
77
78 - Done proper cleanups on board configurations
79 - Added basic FDT support for zynq boards
80 - d-cache support for zynq_gem.c
81
82 TODO
83 ----
84
85 Add FDT support on individual drivers
86
87 * [1] http://www.xilinx.com/products/boards-and-kits/EK-Z7-ZC702-G.htm
88 * [2] http://www.xilinx.com/products/boards-and-kits/EK-Z7-ZC706-G.htm
89 * [3] http://zedboard.org/product/zedboard
90 * [4] http://zedboard.org/product/microzed
91 * [5] http://www.xilinx.com/support/documentation/user_guides/ug585-Zynq-7000-TRM.pdf
92
93
94 .. Jagannadha Sutradharudu Teki <jaganna@xilinx.com>
95 .. Sun Dec 15 14:52:41 IST 2013