From patchwork Wed Sep 21 02:35:56 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Chin Liang See X-Patchwork-Id: 672642 X-Patchwork-Delegate: marek.vasut@gmail.com Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from theia.denx.de (theia.denx.de [85.214.87.163]) by ozlabs.org (Postfix) with ESMTP id 3sfBts2JjHz9s4x for ; Wed, 21 Sep 2016 18:02:45 +1000 (AEST) Authentication-Results: ozlabs.org; dkim=fail reason="signature verification failed" (1024-bit key; unprotected) header.d=altera.onmicrosoft.com header.i=@altera.onmicrosoft.com header.b=MIputFdi; dkim-atps=neutral Received: from localhost (localhost [127.0.0.1]) by theia.denx.de (Postfix) with ESMTP id 8ED4EA7593; Wed, 21 Sep 2016 10:02:43 +0200 (CEST) Received: from theia.denx.de ([127.0.0.1]) by localhost (theia.denx.de [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 19bdMJOI6g_1; Wed, 21 Sep 2016 10:02:43 +0200 (CEST) Received: from theia.denx.de (localhost [127.0.0.1]) by theia.denx.de (Postfix) with ESMTP id 3A1E4A757A; Wed, 21 Sep 2016 10:02:43 +0200 (CEST) Received: from localhost (localhost [127.0.0.1]) by theia.denx.de (Postfix) with ESMTP id BE6D5A757A for ; Wed, 21 Sep 2016 10:02:37 +0200 (CEST) Received: from theia.denx.de ([127.0.0.1]) by localhost (theia.denx.de [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 0T2KqwOh9xAJ for ; Wed, 21 Sep 2016 10:02:37 +0200 (CEST) X-policyd-weight: NOT_IN_SBL_XBL_SPAMHAUS=-1.5 NOT_IN_SPAMCOP=-1.5 NOT_IN_BL_NJABL=-1.5 (only DNSBL check requested) Received: from NAM02-CY1-obe.outbound.protection.outlook.com (mail-cys01nam02on0044.outbound.protection.outlook.com [104.47.37.44]) by theia.denx.de (Postfix) with ESMTPS id 1B6AFA7577 for ; Wed, 21 Sep 2016 10:02:33 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=altera.onmicrosoft.com; s=selector1-altera-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version; bh=PcT2JFahZcyq+76Ok4nBZZKgMBA3cdaQKOSJw7rhYdA=; b=MIputFdiHHTcTOlbxuR6hJZ5nmCKdcxIemlGRjX4yU/xHC6NmBL28J2GdIdpPD2K0FzAHrXL5z6hK4LcHwfpm8uqB/YI8CckFlsYFC8CORTtqkJiJY/MK9POseJz64MJmp8YZmXDSQS9jcuti/fbzg4xbAlxmS0rWnrhDyk4Fe8= Received: from DM2PR03CA0024.namprd03.prod.outlook.com (10.141.96.23) by SN1PR0301MB2095.namprd03.prod.outlook.com (10.163.227.158) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.639.5; Wed, 21 Sep 2016 08:02:31 +0000 Received: from BL2FFO11FD044.protection.gbl (2a01:111:f400:7c09::178) by DM2PR03CA0024.outlook.office365.com (2a01:111:e400:2428::23) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.639.5 via Frontend Transport; Wed, 21 Sep 2016 08:02:31 +0000 Authentication-Results: spf=softfail (sender IP is 66.35.236.227) smtp.mailfrom=altera.com; lists.denx.de; dkim=none (message not signed) header.d=none; lists.denx.de; dmarc=none action=none header.from=altera.com; Received-SPF: SoftFail (protection.outlook.com: domain of transitioning altera.com discourages use of 66.35.236.227 as permitted sender) Received: from sj-itexedge03.altera.priv.altera.com (66.35.236.227) by BL2FFO11FD044.mail.protection.outlook.com (10.173.161.140) with Microsoft SMTP Server (version=TLS1_0, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA_P384) id 15.1.629.5 via Frontend Transport; Wed, 21 Sep 2016 08:02:30 +0000 Received: from sj-mail01.altera.com (137.57.1.6) by webmail.altera.com (66.35.236.227) with Microsoft SMTP Server (TLS) id 14.3.174.1; Wed, 21 Sep 2016 01:01:27 -0700 Received: from ubuntu.localdomain (pg-clsee-450.altera.priv.altera.com [137.57.103.36]) by sj-mail01.altera.com (8.13.7+Sun/8.13.7) with ESMTP id u8L829To001443; Wed, 21 Sep 2016 01:02:16 -0700 (PDT) From: Chin Liang See To: Date: Wed, 21 Sep 2016 10:35:56 +0800 Message-ID: <1474425356-3652-1-git-send-email-clsee@altera.com> X-Mailer: git-send-email 2.5.0 MIME-Version: 1.0 X-EOPAttributedMessage: 0 X-MS-Office365-Filtering-HT: Tenant X-Forefront-Antispam-Report: CIP:66.35.236.227; IPV:NLI; CTRY:US; EFV:NLI; SFV:NSPM; SFS:(10009020)(6009001)(7916002)(2980300002)(199003)(189002)(68736007)(305945005)(47776003)(356003)(7846002)(229853001)(8936002)(586003)(106466001)(19580405001)(105596002)(81166006)(81156014)(107886002)(8676002)(19580395003)(92566002)(189998001)(5003940100001)(626004)(2351001)(50986999)(15650500001)(2906002)(15974865002)(97736004)(33646002)(5660300001)(50466002)(11100500001)(575784001)(50226002)(86362001)(87936001)(48376002)(4326007)(110136003)(36756003)(16796002)(4001430100002)(7099028); DIR:OUT; SFP:1101; SCL:1; SRVR:SN1PR0301MB2095; H:sj-itexedge03.altera.priv.altera.com; FPR:; SPF:SoftFail; PTR:InfoDomainNonexistent; A:1; MX:1; LANG:en; X-Microsoft-Exchange-Diagnostics: 1; BL2FFO11FD044; 1:pDfp03JBTuCK4tJrKNcZBzY8sBAwt+rjn5p6iPYC2xHZeEQhlhBpuqkyl06RTLB/Kv3upnenulNYgaKNMPezk8/fiEGKRLhgNni1oMSRRR/xJglq0d3RFnOvgwzkTv+m97WgI7trcoBdEGQFZrzY0eFj+cT1VlQNfWSLIiFT4lAkGD8Jb3gb8Y82N3A+yaL7LHH9Q3HwpsQcgNNiD0QG+JUHg6iq9WYu+mWJc1SugJ7KOpvfYaeDKsH48LFIlLD/KUWnWABl0/d8L05BMKrlWzGI/T/2lD5FIQ/KPDO2FlauE9Tr87HmIBWA5AEAbpnyGxgsbpLg031Fpen2dhIX3SIsLzsDYia4eOGNxwoPesQQA+BTfhLov50Dg/gAOdeDsavyX+HqFuwXxPws1Q+6zLRDr7uNS6nMTrPQ7w/JmMjTxiWi2Ntka8zWubO23kpEzRDhOiBTMLzrqGsIKd3y+RJrzqlFGXycRbAu5Ne82pLkuPz9nSvAMRUyavQ6n+DbYXY6cGURwiLthXZS6iCDfGiCvtkVfH3WHeobH8+208c= X-MS-Office365-Filtering-Correlation-Id: 71d6650f-e6ae-427e-4571-08d3e1f5a2ee X-Microsoft-Exchange-Diagnostics: 1; SN1PR0301MB2095; 2:rIqB+O4F7cnWxGS40NPL49Pzg91cQXlkCDuzP998lUBCNg0pdA5lEjvlk38pdJw1V70wQ7LFhfO6nAnbSl05COHOvn+mvBRYGVTL2nEtyvceZX8uJwBKcU7AOXsCMd/jW5PJCFYMZs17hFtNKG1wls6xjTnpQm4Ka1O7RQ4OTnfv2xV42TqqrJpXCob6vUn4; 3:7OKz2XyKf4tc1zEKBqGsl4ISfJQz6hcNGazqvclJn2xmus0XsMPUjzfUZycYR7GYA2pTbfMb9PcFh52z+XiTtNVn+rAKUdHeNIaVHEAdIjB/JiQShiUHaYnTJZxwATUPK7V1VHtKtAnEaXW8J4eUkBHIlFpH77qk/wIAOlz6wqvPiznKK/ArnEJPEGuGroaP5hDD9DtChBwME4yBZqAlyDbld+GGRGdxJ52mNDug6P8=; 25:+FcFV/aBMi0KFhNQ8yrURaaWdUPaylHG/eD95CoAqCbyzXTuLq5lzPaZs7IGq8NRVp3hI34q3KiQ8li5nZqiNZLIYRZvk8vbaFRHIdxGzLZOvHhdb6J9E0TY0a08WLRyLKUySpKN60o/kCCGeZLtIhpXGlUxJoXMUP5ppDJDgGQ+9QbseYEQieukxOoPft3O7kkDYo91lQhxs2EMq949/bJPcnsQgm0klhXt2cNNRQWMcN0xP79bM8MK0dzqXVvmQSvCPwUkzjuzL0hkZD1xUrFrlgo0lAMvqCMlA6eAJ6NKhYz3BmxfQO1NSaVOKfYmM+6SiQbvPogE15e5F+nDT5iPso93Ityg+TWcVHo5SO06xMoWWd8+JlYY63VdNczGQcnEzZJ/0GmchWfi1MTLQ1btL20k6pZHhXdDKoQMDKw= X-Microsoft-Antispam: UriScan:;BCL:0;PCL:0;RULEID:;SRVR:SN1PR0301MB2095; X-LD-Processed: fbd72e03-d4a5-4110-adce-614d51f2077a,ExtAddr X-Microsoft-Exchange-Diagnostics: 1; SN1PR0301MB2095; 31:puyRo9wADkaelqfoKai0inxNHRbRug1Esxjl0UIvz4gCzDSZzndNjcOBoFmmUwx9HFdfLM89DiDpAMn/YQ7NF8zhM7lrzIs7Z+8A5bl+jb1VT62QNderrkjrVGe01+rbHHbu0KbDSQnVJNSG88s5ZQqhJJnyvHh+u6YCgb3ubG4FNOiKvG8wSIat8q+wT5cvgMeWHGK5uBNmJ2kDHA8f/+6stNO8otlVK4H04y88bXg=; 20:U9VPsl79qUeulOCIc40rYtQ32YFFE9NHQOaI99/6PX2f4l1JqWMQHVkkDx9mImf/WUkMcK7bm/pyVl2Ti8B/S6b68Hay36c1ODBkZXFSUcdnH5S2dfSssBpheainIdco1R9u4rAsY+aQarGfeRc5W/BQrVz7tmq5JaVBp2SnLYw=; 4:/8krlZtDYpjsv5NoypSaQvVbF56QtE0dHhF1lNhWClMK04C8V0xSLqs+zu45MDiNW4m2ZEQD+UB7afwXN3fBu2zxIVdlKZqcgRxtnmY5CMNoFALn2U/ps6tg+MPN2B31z1ChBAMXUQS88N6NDkCVCzr13NjhggfooFVhxLLqPU655IzC+l3JtOiC6n7OyzbXO/cYiVR7HIluObPV5TBZMEW7YOpKV0CjFc8TIZqRC6d0IqqUt23pcb3XARfmSKeN2XnanDwohXuviSeHB3lnPAyd6NZS16OwOV91vnlEZLpg79y369Y+V9X/XHmIvKz5RQlUx74AfYlj5hLPGA2uuRo3AtICu4VdG1O9Hii2cbuOnHbp7ZF+brAOEBVviN4IibSDojeSaL8C9KHtleoG3JFH/k6J/WeKgTWn87a3J1uG9O73Lo9IM5c1WZX+rJOzWyLNjdvpke31QGxQy9naSgdgz6VDi/+YMo2pw9Q0UkrFtesuGix18nJ2c0NF1e+FYdth6xvxItIzsqFsL/QqMkRFJO8LOMA9RHVwwL/3MCk= X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(80048183373757); X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(6040176)(601004)(2401047)(13015025)(13017025)(13023025)(13024025)(13018025)(8121501046)(5005006)(3002001)(10201501046)(6055026); SRVR:SN1PR0301MB2095; BCL:0; PCL:0; RULEID:; SRVR:SN1PR0301MB2095; X-Forefront-PRVS: 007271867D X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; SN1PR0301MB2095; 23:G02M33zRiqLHD87uymoXNDev1Okkj48Aj8wdHbO?= =?us-ascii?Q?WObnB2wGmEI2LCGFXYnTcR+4WRStH8gkg6jMJBf2NA4Sn1T4hfdq++CTaWjr?= =?us-ascii?Q?Zf3Vn61ikqACa3vHwP+pc4RBYgHq9qRuDPkM8ma9DV5rBkADuXFsaGbV799/?= =?us-ascii?Q?wY3yvi/fc6zIP9MjCsiGdyaM9ZhG2W1DQQuLBZ6qRtFAFPlxPwj622hIFhaQ?= =?us-ascii?Q?KVs2t6TOKPjtPaD6ceYxLw+/I5yeMiI40WCywsKfzNgd0cgh0kqvml1v9IMD?= =?us-ascii?Q?TkWUJ+UF7tNYDvNh1ai4AQYTuO8FW3tnyQ927Q8lju6qXMIc//wOiCpHmljy?= =?us-ascii?Q?yRC8avNrbrhPY68Vc4E1Sw/4EIxHUyNUUvBRHRqYHRhbZJ/0yUn+/AJvUst1?= =?us-ascii?Q?OQrHMHBDEa/y4M+6K4ZbSBN3Z6isMDkahalNP3ZXLD+EVqqmyIVpBe3N8uR8?= =?us-ascii?Q?AyhJZrw5IjocBmhM1lFv6NiYCIrSbA5ijAwD4IbFGHrbl8M4WzzyksOhMj9V?= =?us-ascii?Q?Cz39Z4Fl/9U1A6zKSgkO2C/0pC+Pp0LSUXE7sZS7RbInXW2rnAkWV5x/yrSU?= =?us-ascii?Q?rT2a8x7TmLVWSRAjRcfv79kFb3pEIzSUD9UY050OoVpDWBIrRAMyibSaRwXH?= =?us-ascii?Q?zvCuZGv5B5z5AQD+G5RH4qMTG3CG8nwXl86laT11LYBGzwKc8VtJf8AsvFfe?= =?us-ascii?Q?gB63FM7H+fLOkYbcYDMRdlEXKdGk5kjRQr1IcCACaA4Gv2khWLznVODmXy0H?= =?us-ascii?Q?HRH41SpdfSogGHJ3rjVxHjnfK6BdeQSmffyAQB9VyIYEg7EncubDFeaJFMzJ?= =?us-ascii?Q?2GhfVRPrE/HZZRgA6FW/wf1pFm/vNhpatCXeoHbrw2PbMxctni9b8HGyaNtM?= =?us-ascii?Q?bQDzlg5tboanHV8RmNB2zM9hC5N227CIk/1C5GwMfdMtlmJ5X2aQK8hma4fX?= =?us-ascii?Q?LGo5SnuVexSYsWQbRWSEJMWIIVzZ6zM6dkqxn9Yx0wqxafc5VqXItUQ5A8ct?= =?us-ascii?Q?pLwsS+Cqx5Q5YxQAoOsMR+eAwEDa6slj2A06zFGp/ufl3MmUfGdX+hRbKzxm?= =?us-ascii?Q?4hHd6xwD4IsXxHp+yLdnwqx8oZxEeGLzyjYM4gR6KoM8U2vqrjfOnGijfaD8?= =?us-ascii?Q?F8iIG6cIDxr7d+VbCpQYtxluSdF95OSnD?= X-Microsoft-Exchange-Diagnostics: 1; SN1PR0301MB2095; 6:Y92W4/vCCZw0dH3TYUg71qzxEmpvskyLTuZmxzXnhkMwEXBDCggtuNhKYDwetQDOHGYhYMo8TnL27n9PtMck+LC5WX1eRXRSDFHhJszJVyfS5FHsJ6zUPOY8lE7oW3eJDOYPfw+4Vu+DHyc3nRsmpChEYKD7PpiRAX8MB5JO/ITzQYPdC8kVzszlNMx1/mDJ0hMMOhAQpish11PD9HLwZp+hyNb7XzTCXzmHgzo6f7ltjtrq1d6QlLzdEs2y/UpxsSvVS5CUM7W9ZBkyFsMOAHCdHJZb8O6X1MMudb8sEw6tlkZpv+S5dyzRhLq9lKiHeLk246zUQeEAdj2vn4G6CQ==; 5:lZIckAOLh7278HThyacr+3XqxIupkGhcs13ht4deepvqmldPb7BqHVaO/SgYhU2gj5Vl0g0bfRp0oOHDWkTm7IoVSQvKGTyLEyVDJdj5p0fN/eNt2iWr1gxq6K0O2AWc9qJ5x7QxiIQfEGTmmRr8XQ==; 24:shLsDQuujqssGK6VEYMWIe/49DcCPbhtGoT0A3JwRuth/KYpcsTsp3DUPZEC9aF7gG6xY/zh9HMESQbDoYu7vW7AYv7pxCRnS4n5DSIwewQ=; 7:aNUhwk6uG9lMUfb53qkXfjgndgvhrY3/ez/wotkvZSyFhqRuZS0IX+r6L0EfzNUIFrZG5OJd8Xa9W/5TnmmfkbJ9wygtKIk6DbHRaVX/xYUrH02cIQ9AgpRAbMmD9uj1XQr9osSI7hXRbEQ6oyaC++dk+u9+rVuUJbhKRBPO5Mj7elsYYdFq94CDpcTfSPipgV0AcWhvtJnJD1QJpxwzbmWcEPlDHk7VoqX7H50s0mSA1258quyh2gBjJ7ROyuC8gQ0z1n4aw3VhPoZ9Y1owh8lz7Xu/GEGKpwxAOxJDiGP+xGW66A23899rBw3r55QP SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-OriginatorOrg: altera.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 21 Sep 2016 08:02:30.1297 (UTC) X-MS-Exchange-CrossTenant-Id: fbd72e03-d4a5-4110-adce-614d51f2077a X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=fbd72e03-d4a5-4110-adce-614d51f2077a; Ip=[66.35.236.227]; Helo=[sj-itexedge03.altera.priv.altera.com] X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: SN1PR0301MB2095 Cc: Marek Vasut , Chin Liang See Subject: [U-Boot] [PATCH] doc: socfpga: Update README.socfpga for Preloader development flow X-BeenThere: u-boot@lists.denx.de X-Mailman-Version: 2.1.15 Precedence: list List-Id: U-Boot discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: u-boot-bounces@lists.denx.de Sender: "U-Boot" Update documentation to include the Cyclone V SoC Preloader development flow. This include the update of Preloader handoff through qts-filter.sh script. At same time, removed the SDMMC documentation as its using DM now. Signed-off-by: Chin Liang See Cc: Marek Vasut Cc: Dinh Nguyen --- doc/README.socfpga | 69 +++++++++++++++++++++++------------------------------- 1 file changed, 29 insertions(+), 40 deletions(-) diff --git a/doc/README.socfpga b/doc/README.socfpga index cfcbbfe..04c5c0e 100644 --- a/doc/README.socfpga +++ b/doc/README.socfpga @@ -9,45 +9,34 @@ www.altera.com. -------------------------------------------- -socfpga_dw_mmc +Working with Cyclone V SoC Preloader -------------------------------------------- -Here are macro and detailed configuration required to enable DesignWare SDMMC -controller support within SOCFPGA -#define CONFIG_MMC --> To enable the SD MMC framework support - -#define CONFIG_SDMMC_BASE (SOCFPGA_SDMMC_ADDRESS) --> The base address of CSR register for DesignWare SDMMC controller - -#define CONFIG_GENERIC_MMC --> Enable the generic MMC driver - -#define CONFIG_SYS_MMC_MAX_BLK_COUNT 256 --> Using smaller max blk cnt to avoid flooding the limited stack in OCRAM - -#define CONFIG_DWMMC --> Enable the common DesignWare SDMMC controller framework - -#define CONFIG_SOCFPGA_DWMMC --> Enable the SOCFPGA specific driver for DesignWare SDMMC controller - -#define CONFIG_SOCFPGA_DWMMC_FIFO_DEPTH 1024 --> The FIFO depth for SOCFPGA DesignWare SDMMC controller - -#define CONFIG_SOCFPGA_DWMMC_DRVSEL 3 --> Phase-shifted clock of sdmmc_clk for controller to drive command and data to -the card to meet hold time requirements. SD clock is running at 50MHz and -drvsel is set to shift 135 degrees (3 * 45 degrees). With that, the hold time -is 135 / 360 * 20ns = 7.5ns. - -#define CONFIG_SOCFPGA_DWMMC_SMPSEL 0 --> Phase-shifted clock of sdmmc_clk used to sample the command and data from -the card - -#define CONFIG_SOCFPGA_DWMMC_BUS_WIDTH 4 --> Bus width of data line which either 1, 4 or 8 and based on board routing. - -#define CONFIG_SOCFPGA_DWMMC_BUS_HZ 50000000 --> The clock rate to controller. Do note the controller have a wrapper which -divide the clock from PLL by 4. +1. Please refer to SOCEDS documentation on generating handoff for Preloader + Upon successful generation, there will be a folder "software/preloader" at + the directory of your Qsys project. + +2. Then, you need to invoke qts-filter.sh at arch/arm/mach-socfpga folder to + process the generated handoff files into Preloader source code. + $ sh arch/arm/mach-socfpga/qts-filter.sh \ + /software/preloader> + + Example: + + $ cd + $ sh arch/arm/mach-socfpga/qts-filter.sh cyclone5 \ + /hardware/cv_soc_devkit_ghrd/ \ + /hardware/cv_soc_devkit_ghrd/software/preloader/ \ + board/altera/cyclone5-socdk/qts/ + + $ cd + $ sh arch/arm/mach-socfpga/qts-filter.sh arria5 \ + /hardware/av_soc_devkit_ghrd/ \ + /hardware/av_soc_devkit_ghrd/software/preloader/ + board/altera/arria5-socdk/qts/ + +3. Build the Preloader + U-Boot + $ export CROSS_COMPILE=arm-altera-eabi- + $ make mrproper + $ make socfpga_cyclone5_defconfig + $ make