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    $ export DEVICE_TREE=zynq-zc702
  36    $ make xilinx_zynq_virt_defconfig
  37    $ make
  38
  39 Bootmode
  40 --------
  41
  42 Zynq has a facility to read the bootmode from the slcr bootmode register
  43 once user is setting through jumpers on the board - see page no:1546 on [5]
  44
  45 All possible bootmode values are defined in Table 6-2:Boot_Mode MIO Pins
  46 on [5].
  47
  48 board_late_init() will read the bootmode values using slcr bootmode register
  49 at runtime and assign the modeboot variable to specific bootmode string which
  50 is intern used in autoboot.
  51
  52 SLCR bootmode register Bit[3:0] values
  53
  54 .. code-block:: c
  55
  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
  63 Flashing
  64 --------
  65
  66 SD Card
  67 ^^^^^^^
  68
  69 To write an image that boots from a SD card first create a FAT32 partition
  70 and a FAT32 filesystem on the SD card::
  71
  72         sudo fdisk /dev/sdx
  73         sudo mkfs.vfat -F 32 /dev/sdx1
  74
  75 Mount the SD card and copy the SPL and U-Boot to the root directory of the
  76 SD card::
  77
  78         sudo mount -t vfat /dev/sdx1 /mnt
  79         sudo cp spl/boot.bin /mnt
  80         sudo cp u-boot.img /mnt
  81
  82 Mainline status
  83 ---------------
  84
  85 - Added basic board configurations support.
  86 - Added zynq u-boot bsp code - arch/arm/cpu/armv7/zynq
  87 - Added zynq boards named - zc70x, zed, microzed, zc770_xm010/xm011/xm012/xm013
  88 - Added zynq drivers:
  89
  90   :serial: drivers/serial/serial_zynq.c
  91   :net: drivers/net/zynq_gem.c
  92   :mmc: drivers/mmc/zynq_sdhci.c
  93   :spi: drivers/spi/zynq_spi.c
  94   :qspi: drivers/spi/zynq_qspi.c
  95   :i2c: drivers/i2c/zynq_i2c.c
  96   :nand: drivers/mtd/nand/raw/zynq_nand.c
  97
  98 - Done proper cleanups on board configurations
  99 - Added basic FDT support for zynq boards
 100 - d-cache support for zynq_gem.c
 101
 102 TODO
 103 ----
 104
 105 Add FDT support on individual drivers
 106
 107 * [1] http://www.xilinx.com/products/boards-and-kits/EK-Z7-ZC702-G.htm
 108 * [2] http://www.xilinx.com/products/boards-and-kits/EK-Z7-ZC706-G.htm
 109 * [3] http://zedboard.org/product/zedboard
 110 * [4] http://zedboard.org/product/microzed
 111 * [5] http://www.xilinx.com/support/documentation/user_guides/ug585-Zynq-7000-TRM.pdf
 112
 113
 114 .. Jagannadha Sutradharudu Teki <jaganna@xilinx.com>
 115 .. Sun Dec 15 14:52:41 IST 2013