rv1126-uboot/doc
Simon Glass 6126c8e886 dm: spi: Add documentation on how to convert over SPI drivers
This README is intended to help maintainers move their SPI drivers over to
driver model. It works through the required steps with an example.

Signed-off-by: Simon Glass <sjg@chromium.org>
Reviewed-by: Jagannadha Sutradharudu Teki <jagannadh.teki@gmail.com>
2014-10-22 10:36:49 -06:00
..
DocBook kbuild: docbook: sync with Linux Kernel v3.15-rc1 2014-04-18 11:43:36 -04:00
SPI doc: SPI: Add qspi test details on AM43xx 2014-02-18 22:41:09 +05:30
SPL
device-tree-bindings dm: spi: Add soft_spi implementation 2014-10-22 10:36:48 -06:00
driver-model dm: spi: Add documentation on how to convert over SPI drivers 2014-10-22 10:36:49 -06:00
uImage.FIT Implement generalised RSA public exponents for verified boot 2014-08-09 11:17:01 -04:00
I2C_Edge_Conditions
README.440-DDR-performance
README.AMCC-eval-boards-cleanup
README.ARC arc: add README for architecture 2014-02-07 08:14:34 -05:00
README.ARM-memory-map
README.AVR32
README.AVR32-port-muxing
README.JFFS2
README.JFFS2_NAND
README.LED
README.LED_display
README.MPC866
README.Modem
README.N1213
README.NDS32
README.NetConsole
README.OFT
README.POST
README.SNTP
README.SPL doc: README.SPL: adjust for Kbuild and Kconfig 2014-08-06 09:02:46 -04:00
README.TPL kbuild: rename TOPDIR to stctree 2014-03-12 17:04:55 -04:00
README.VLAN
README.VSC3316-3308
README.ag102
README.android-fastboot usb/gadget: fastboot: add support for flash command 2014-09-24 18:30:27 -04:00
README.android-fastboot-protocol usb/gadget: add the fastboot gadget 2014-05-08 10:38:30 +02:00
README.arm-caches
README.arm-relocation
README.arm64 arm64: core support 2014-01-09 16:08:44 +01:00
README.at91
README.at91-soc
README.atmel_mci
README.atmel_pmecc arm:at91: enable ROM loadable atmel image 2014-05-27 00:10:49 +02:00
README.autoboot
README.b4860qds board/b4qds:Add support of 2 stage NAND boot-loader 2014-04-22 17:58:51 -07:00
README.bedbug
README.bitbangMII
README.blackfin
README.bootmenu
README.bus_vcxk
README.cfi board/ti/am335x: add support for beaglebone NOR Cape 2014-08-25 10:47:56 -04:00
README.clang README.clang: update FreeBSD instructions 2014-09-24 18:30:29 -04:00
README.commands kbuild: rename TOPDIR to stctree 2014-03-12 17:04:55 -04:00
README.commands.itest
README.commands.spl
README.console powerpc: remove genietv board support 2014-04-18 10:42:29 -04:00
README.davinci
README.davinci.nand_spl
README.displaying-bmps
README.dns
README.drivers.eth
README.enetaddr
README.ext4
README.falcon doc/README.falcon: Clarify steps slightly. 2014-07-07 19:42:34 -04:00
README.fdt-control fdt: Rename the DEV_TREE_BIN Makefile flag to to EXT_DTB 2014-06-19 11:18:56 -04:00
README.fec_mxc
README.fsl-ddr
README.fsl-esdhc esdhc: Add CONFIG_SYS_FSL_ESDHC_LE and CONFIG_SYS_FSL_ESDHC_BE macros 2014-09-08 10:30:33 -07:00
README.fsl-hwconfig
README.fsl_iim
README.fuse
README.generic-board cosmetic: doc: update README.generic-board 2014-07-07 17:22:29 -06:00
README.generic_usb_ohci
README.gpt disk: part_efi: add support for the Backup GPT 2014-05-12 15:20:05 -04:00
README.hwconfig
README.idma2intr
README.imx5
README.imx6
README.imx25
README.imx27
README.imx31
README.imximage README.imximage: Fix the maximum DCD size 2014-09-11 10:14:04 +02:00
README.iomux
README.kconfig README.kconfig: document backward compatibility "make *_config" 2014-08-28 17:18:49 -04:00
README.kwbimage kirkwood: kwbimage: refactor CONFIG_SYS_KWD_CONFIG 2014-03-12 17:04:52 -04:00
README.link-local
README.lynxkdi
README.m68k
README.m54418twr
README.malta malta: correct tcl script path in README.malta 2014-03-04 23:41:54 +01:00
README.marubun-pcmcia
README.memory-test
README.menu
README.mips
README.mpc5xx
README.mpc74xx
README.mpc83xx.ddrecc
README.mpc83xxads
README.mpc85xx
README.mpc85xx-sd-spi-boot
README.mpc85xx-spin-table
README.mpc85xxads
README.mpc85xxcds
README.mxc_hab
README.mxc_ocotp
README.mxs mx28evk: Add documentation on how to boot from SPI NOR 2014-06-17 16:39:10 +02:00
README.mxsimage
README.nand mtd: denali: add Denali controller configs to Kconfig 2014-10-05 14:10:09 +09:00
README.nand-boot-ppc440
README.ne2000
README.nokia_rx51
README.odroid odroid: kconfig: add odroid_defconfig 2014-09-05 13:58:50 +09:00
README.omap-reset-time
README.omap-ulpi-viewport
README.omap3
README.pblimage
README.plan9
README.power-framework doc:power:pmic: Add doc entry for PMIC(v2) framework 2014-04-18 10:42:30 -04:00
README.ppc440
README.pxe
README.qemu-mips
README.ramboot-ppc85xx
README.rmobile
README.s5pc1xx
README.sata
README.sched
README.scrapyard powerpc: mpc5xxx: remove board support for MVBC_P and MVSMR 2014-10-10 09:44:43 -04:00
README.semihosting arm: Add support for semihosting for armv8 fastmodel targets. 2014-07-03 08:35:45 +02:00
README.serial_multi
README.sh
README.sh7752evb
README.sh7753evb
README.sha1
README.silent
README.socfpga
README.spear
README.splashprepare
README.srio-pcie-boot-corenet
README.standalone
README.switch_config
README.trace
README.ubi
README.ublimage
README.unaligned-memory-access.txt arm: Switch to -mno-unaligned-access when supported by the compiler 2014-02-26 21:19:32 +01:00
README.update
README.usb usb: net: update README.usb to list all USB ethernet options 2014-03-12 17:04:35 -04:00
README.vf610
README.video powerpc: remove genietv board support 2014-04-18 10:42:29 -04:00
README.vxworks
README.watchdog
README.zfs
README.zynq doc: Update the zynq u-boot status 2014-01-10 15:18:33 +01:00
feature-removal-schedule.txt Change Andy Fleming's email address 2014-08-06 09:12:30 -04:00
git-mailrc git-mailrc: add me as a maintainer of UniPhier platform 2014-10-05 14:10:09 +09:00
kwboot.1
mkimage.1

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