From patchwork Thu Jul 18 07:34:25 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Bin Meng X-Patchwork-Id: 1133617 X-Patchwork-Delegate: trini@ti.com Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=none (mailfrom) smtp.mailfrom=lists.denx.de (client-ip=81.169.180.215; helo=lists.denx.de; envelope-from=u-boot-bounces@lists.denx.de; receiver=) Authentication-Results: ozlabs.org; dmarc=fail (p=none dis=none) header.from=gmail.com Authentication-Results: ozlabs.org; dkim=fail reason="signature verification failed" (2048-bit key; unprotected) header.d=gmail.com header.i=@gmail.com header.b="rcrc+Hkp"; dkim-atps=neutral Received: from lists.denx.de (dione.denx.de [81.169.180.215]) by ozlabs.org (Postfix) with ESMTP id 45q69106XQz9s3l for ; Thu, 18 Jul 2019 18:04:04 +1000 (AEST) Received: by lists.denx.de (Postfix, from userid 105) id 8F99FC22073; Thu, 18 Jul 2019 07:55:08 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on lists.denx.de X-Spam-Level: X-Spam-Status: No, score=-0.0 required=5.0 tests=FREEMAIL_FROM, RCVD_IN_MSPIKE_H3, RCVD_IN_MSPIKE_WL, T_DKIM_INVALID autolearn=unavailable autolearn_force=no version=3.4.0 Received: from lists.denx.de (localhost [IPv6:::1]) by lists.denx.de (Postfix) with ESMTP id 4CC37C22042; Thu, 18 Jul 2019 07:37:53 +0000 (UTC) Received: by lists.denx.de (Postfix, from userid 105) id 4FA00C2203E; Thu, 18 Jul 2019 07:35:36 +0000 (UTC) Received: from mail-pf1-f193.google.com (mail-pf1-f193.google.com [209.85.210.193]) by lists.denx.de (Postfix) with ESMTPS id CFF3EC21F94 for ; Thu, 18 Jul 2019 07:35:31 +0000 (UTC) Received: by mail-pf1-f193.google.com with SMTP id y15so12198146pfn.5 for ; Thu, 18 Jul 2019 00:35:31 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:subject:date:message-id:in-reply-to:references; bh=hB0/E2u4c9/1Q87IyYo92xltkBVgGomHLys+rGj+OvU=; b=rcrc+Hkp7Ap/mTmTQ8pBKpu+nlkV+5svrLSgKK36QCg9gjeBstXZLks8fjYjMrxKad rrSIeY/Ilc+Cf/hgleYSnEGgQOKQbTWUCd+qEQ1Rn63FwBYgHuv+ZW2I/eD3WLYRfOeg LxndbuxeD5iovZynLO7iIw+t1pXCD3wSd1AOEfCmCgROmd2hwnetwy6tfnSowMjjbyh6 c8AHmSAoYT2OaN5q9h8OfrXIXXZ2octNn5Ooi1r3hpRKLnHUwisC1uJVh85oJZTcrTkK 7lNRRmOV8TCL0NRueClGxItoYOAKD6VdhOUsp7o131IRUUF61b3FFNnMjnCgCu98lmir vZMw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:subject:date:message-id:in-reply-to :references; bh=hB0/E2u4c9/1Q87IyYo92xltkBVgGomHLys+rGj+OvU=; b=Whvc+5E5S/IfJlMd4lE6ALwIx+CEk/lHHaOAk2tsbfDRgIoB/UN8+9Vc4yJUhBZI26 MZfugINJmMOwmWaa8F4qROIWnZRg42r6uWniofW68tV5zKrx/SbZPpU6m4jNEDsTdYco CuoDGboPzUzxGoFMkBTgrKcDCKBItDlNvNIVvE7rh1PAhO9aAs+kjforjQjY46b0r3Cx 0Vn2W3I75jkJfKOiTNUtB6zUzs35PRFPRFL58U4wNy5TNGqkWs0XotzqYLjUi9UxqFPL z3bRgsbREeEmRyEHS+IAZYffyvmRzKWbKorFtWdCqQ2HXi9lIIJ6qamqV7/jooeXBfDh HZyA== X-Gm-Message-State: APjAAAUQfQh/0l/c42hEB5SeuW37qH7lFiLemyVkAgcAod1zaX7C3fmo Nrx11k8a/fzLLdO4UEeAX3g= X-Google-Smtp-Source: APXvYqzitV2doHH5UFQnhzgC4sWIrKma9i7tHleL0oWIDKO3UMKs0Vr0uUaJPaXyPfDwePmeDb2/1g== X-Received: by 2002:a63:8f55:: with SMTP id r21mr45538116pgn.318.1563435325759; Thu, 18 Jul 2019 00:35:25 -0700 (PDT) Received: from localhost.localdomain (unknown-224-80.windriver.com. [147.11.224.80]) by smtp.gmail.com with ESMTPSA id q1sm39859821pfn.178.2019.07.18.00.35.24 (version=TLS1 cipher=AES128-SHA bits=128/128); Thu, 18 Jul 2019 00:35:25 -0700 (PDT) From: Bin Meng To: Tom Rini , Simon Glass , Wolfgang Denk , Heinrich Schuchardt , Mario Six , U-Boot Mailing List Date: Thu, 18 Jul 2019 00:34:25 -0700 Message-Id: <1563435275-22326-41-git-send-email-bmeng.cn@gmail.com> X-Mailer: git-send-email 1.7.1 In-Reply-To: <1563435275-22326-1-git-send-email-bmeng.cn@gmail.com> References: <1563435275-22326-1-git-send-email-bmeng.cn@gmail.com> Subject: [U-Boot] [PATCH 40/50] doc: board: Convert README.zynq to reST X-BeenThere: u-boot@lists.denx.de X-Mailman-Version: 2.1.18 Precedence: list List-Id: U-Boot discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , MIME-Version: 1.0 Errors-To: u-boot-bounces@lists.denx.de Sender: "U-Boot" Convert plain text documentation to reStructuredText format and add it to Sphinx TOC tree. No essential content change. Signed-off-by: Bin Meng --- doc/board/index.rst | 1 + doc/{README.zynq => board/xilinx/zynq.rst} | 82 +++++++++++++++++------------- 2 files changed, 48 insertions(+), 35 deletions(-) rename doc/{README.zynq => board/xilinx/zynq.rst} (53%) diff --git a/doc/board/index.rst b/doc/board/index.rst index a7e94cf..00e72f5 100644 --- a/doc/board/index.rst +++ b/doc/board/index.rst @@ -15,3 +15,4 @@ Board-specific doc intel/index renesas/index sifive/index + xilinx/index diff --git a/doc/README.zynq b/doc/board/xilinx/zynq.rst similarity index 53% rename from doc/README.zynq rename to doc/board/xilinx/zynq.rst index da977b2..3f0513e 100644 --- a/doc/README.zynq +++ b/doc/board/xilinx/zynq.rst @@ -1,15 +1,17 @@ -# SPDX-License-Identifier: GPL-2.0+ -# -# Xilinx ZYNQ U-Boot -# -# (C) Copyright 2013 Xilinx, Inc. +.. SPDX-License-Identifier: GPL-2.0+ +.. (C) Copyright 2013 Xilinx, Inc. -1. About this +ZYNQ +==== + +About this +---------- This document describes the information about Xilinx Zynq U-Boot - like supported boards, ML status and TODO list. -2. Zynq boards +Zynq boards +----------- Xilinx Zynq-7000 All Programmable SoCs enable extensive system level differentiation, integration, and flexibility through hardware, software, @@ -20,18 +22,21 @@ and I/O programmability. * 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) + - zc770-xm010 (single qspi, gem0, mmc) + - zc770-xm011 (8 or 16 bit nand) + - zc770-xm012 (nor) + - zc770-xm013 (dual parallel qspi, gem1) + +Building +-------- -3. Building +configure and build for zc702 board:: - ex. configure and build for zc702 board $ make zynq_zc702_config $ make -4. Bootmode +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] @@ -44,40 +49,47 @@ 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 + +.. code-block:: c + + #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 +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/xm011/xm012/xm013 - Added zynq drivers: - serial - drivers/serial/serial_zynq.c - net - drivers/net/zynq_gem.c - mmc - drivers/mmc/zynq_sdhci.c - spi - drivers/spi/zynq_spi.c - qspi - drivers/spi/zynq_qspi.c - i2c - drivers/i2c/zynq_i2c.c - nand - drivers/mtd/nand/raw/zynq_nand.c + + :serial: drivers/serial/serial_zynq.c + :net: drivers/net/zynq_gem.c + :mmc: drivers/mmc/zynq_sdhci.c + :spi: drivers/spi/zynq_spi.c + :qspi: drivers/spi/zynq_qspi.c + :i2c: drivers/i2c/zynq_i2c.c + :nand: drivers/mtd/nand/raw/zynq_nand.c + - Done proper cleanups on board configurations - Added basic FDT support for zynq boards - d-cache support for zynq_gem.c -6. TODO +TODO +---- + +Add FDT support on individual drivers -- 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 -[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 -Sun Dec 15 14:52:41 IST 2013 +.. Jagannadha Sutradharudu Teki +.. Sun Dec 15 14:52:41 IST 2013