uboot/doc
Przemyslaw Marczak 5decbf5300 dm: adc: add simple ADC uclass implementation
This commit adds:
- new uclass id: UCLASS_ADC
- new uclass driver: drivers/adc/adc-uclass.c

The new uclass's API allows for ADC operation on:
* single-channel with channel selection by a number
* multti-channel with channel selection by bit mask

ADC uclass's functions:
* single-channel:
  - adc_start_channel()        - start channel conversion
  - adc_channel_data()         - get conversion data
  - adc_channel_single_shot()  - start/get conversion data
* multi-channel:
  - adc_start_channels()       - start selected channels conversion
  - adc_channels_data()        - get conversion data
  - adc_channels_single_shot() - start/get conversion data for channels
                                 selected by bit mask
* general:
  - adc_stop()      - stop the conversion
  - adc_vdd_value() - positive reference Voltage value with polarity [uV]
  - adc_vss_value() - negative reference Voltage value with polarity [uV]
  - adc_data_mask() - conversion data bit mask

The device tree can provide below constraints/properties:
- vdd-polarity-negative: if true: Vdd = vdd-microvolts * (-1)
- vss-polarity-negative: if true: Vss = vss-microvolts * (-1)
- vdd-supply:            phandle to Vdd regulator's node
- vss-supply:            phandle to Vss regulator's node
And optional, checked only if the above corresponding, doesn't exist:
  - vdd-microvolts:      positive reference Voltage [uV]
  - vss-microvolts:      negative reference Voltage [uV]

Signed-off-by: Przemyslaw Marczak <p.marczak@samsung.com>
Cc: Simon Glass <sjg@chromium.org>
Signed-off-by: Minkyu Kang <mk7.kang@samsung.com>
2015-11-02 10:38:00 +09:00
..
DocBook
SPI
SPL
device-tree-bindings dm: adc: add simple ADC uclass implementation 2015-11-02 10:38:00 +09:00
driver-model dm: Rename dev_get_parentdata() to dev_get_parent_priv() 2015-10-23 09:42:28 -06:00
uImage.FIT
I2C_Edge_Conditions
README.440-DDR-performance
README.AMCC-eval-boards-cleanup
README.ARC
README.ARM-memory-map
README.AVR32
README.AVR32-port-muxing
README.Heterogeneous-SoCs
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
README.TPL
README.VLAN
README.VSC3316-3308
README.ag101p NDS32: Generic Board Support and Unsupport 2015-08-28 11:46:35 -04:00
README.android-fastboot
README.android-fastboot-protocol
README.arm-caches
README.arm-relocation
README.arm64
README.at91
README.at91-soc
README.atmel_mci
README.atmel_pmecc
README.autoboot
README.b4860qds
README.bedbug
README.bitbangMII
README.blackfin
README.bootmenu
README.bus_vcxk
README.cfi
README.clang
README.commands
README.commands.itest
README.commands.spl
README.console
README.davinci
README.davinci.nand_spl
README.dfutftp doc: dfu: tftp: README entry for TFTP extension of DFU 2015-09-07 13:41:04 +02:00
README.displaying-bmps
README.distro
README.dns
README.drivers.eth
README.efi efi: Update README.efi to clarify build and test instructions 2015-08-26 07:54:09 -07:00
README.enetaddr
README.esbc_validate
README.ext4
README.falcon
README.fdt-control env: export fdt_blob to the environment variable 2015-10-23 09:42:28 -06:00
README.fec_mxc imx: fec: add MAC reading from eFuses to README 2015-09-02 15:34:11 +02:00
README.fsl-clk common/board_f.c: change the macro name and remove it for PPC platforms 2015-10-29 10:33:58 -07:00
README.fsl-ddr
README.fsl-dpaa armv8/ls1043a: Add Fman support 2015-10-29 10:34:01 -07:00
README.fsl-esdhc
README.fsl-hwconfig
README.fsl-trustzone-components
README.fsl_iim
README.fuse
README.generic-board
README.generic_usb_ohci
README.gpt
README.hwconfig
README.i2c
README.idma2intr
README.imx5 imx: fec: add MAC reading from eFuses to README 2015-09-02 15:34:11 +02:00
README.imx6
README.imx25
README.imx27
README.imx31
README.imximage
README.iomux
README.kconfig
README.kwbimage
README.link-local
README.lynxkdi
README.m68k
README.m54418twr
README.malta
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
README.mxsimage
README.nand
README.nand-boot-ppc440
README.ne2000
README.nios2 nios2: add README.nios2 2015-10-23 14:55:48 +08:00
README.nokia_rx51
README.odroid
README.omap-reset-time
README.omap-ulpi-viewport
README.omap3 arm: Remove omap3_mvblx board 2015-09-11 14:56:51 -04:00
README.pblimage
README.plan9
README.power-framework
README.ppc440
README.pxe doc: document the fdtdir PXE command 2015-09-03 16:59:07 -04:00
README.qemu-mips
README.ramboot-ppc85xx
README.rmobile
README.rockchip rockchip: Put README image creation commands on one line 2015-09-02 21:28:25 -06:00
README.s5pc1xx
README.sata
README.sched
README.scrapyard README.scrapyard: Populate recent ppc4xx removals 2015-10-30 07:53:56 -04:00
README.semihosting
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.t1040-l2switch
README.trace
README.ubi
README.ublimage
README.unaligned-memory-access.txt
README.uniphier ARM: uniphier: fix address mapping in README.uniphier 2015-10-15 08:42:30 -04:00
README.update doc: dfu: tftp: README entry for TFTP extension of DFU 2015-09-07 13:41:04 +02:00
README.usb
README.vf610
README.video sunxi: display: Add overscan correction 2015-08-14 08:37:36 +02:00
README.vxworks doc: Complement document about booting VxWorks 2015-10-21 07:46:26 -06:00
README.watchdog arm: Remove vision2 board 2015-09-11 16:05:03 -04:00
README.x86 x86: Enable mrc cache for bayleybay and minnowmax 2015-10-21 07:46:27 -06:00
README.zfs
README.zynq
feature-removal-schedule.txt
git-mailrc git-mailrc: add Alexey as ARC maintainer 2015-09-11 14:05:33 -04: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.

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