From patchwork Wed Nov 15 19:52:32 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Trent Piepho X-Patchwork-Id: 10060125 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id 7FFC26023A for ; Wed, 15 Nov 2017 19:53:12 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 6783F2A2B4 for ; Wed, 15 Nov 2017 19:53:12 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 5C4242A2B8; Wed, 15 Nov 2017 19:53:12 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-6.8 required=2.0 tests=BAYES_00,DKIM_SIGNED, RCVD_IN_DNSWL_HI,T_DKIM_INVALID autolearn=ham version=3.3.1 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 9D0182A2B4 for ; Wed, 15 Nov 2017 19:53:11 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1755666AbdKOTxL (ORCPT ); Wed, 15 Nov 2017 14:53:11 -0500 Received: from mail-co1nam03on0094.outbound.protection.outlook.com ([104.47.40.94]:64320 "EHLO NAM03-CO1-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1759266AbdKOTwv (ORCPT ); Wed, 15 Nov 2017 14:52:51 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=impinj.onmicrosoft.com; s=selector1-impinj-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version; bh=CWdhO+fl7Bf+bQ/EnOSFeiE9nFkb0xvUTBMlLXjnsEw=; b=l5wJ1otyoxEDSzWXmWhNwthhs3q5x5hlRoW8E6w67NscG8fckHzZllKb+KbyU4m6qrQXUZWWWoc7xfSqtyoDpz7nPDvaISkH55Jxo9DbXe7kASogAC2bqH7UVGJok+E4gtCpRskL62PDAYFqO0tyVlJRfONWT0ER2o48StkqlCc= Received: from impinj.com (216.243.31.162) by BN6PR06MB2804.namprd06.prod.outlook.com (10.175.127.22) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P256) id 15.20.239.5; Wed, 15 Nov 2017 19:52:48 +0000 From: Trent Piepho To: linux-spi@vger.kernel.org Cc: Trent Piepho , Mark Brown , Shawn Guo , Sascha Hauer , Fabio Estevam , Oleksij Rempel Subject: [PATCH 1/1] spi: imx: Update device tree binding documentation Date: Wed, 15 Nov 2017 11:52:32 -0800 Message-Id: <20171115195232.10354-1-tpiepho@impinj.com> X-Mailer: git-send-email 2.14.3 MIME-Version: 1.0 X-Originating-IP: [216.243.31.162] X-ClientProxiedBy: MWHPR08CA0007.namprd08.prod.outlook.com (10.174.103.148) To BN6PR06MB2804.namprd06.prod.outlook.com (10.175.127.22) X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 8a157491-03d0-4ef6-54c9-08d52c627352 X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001)(4534020)(4602075)(4627115)(201703031133081)(201702281549075)(2017052603258); SRVR:BN6PR06MB2804; X-Microsoft-Exchange-Diagnostics: 1; BN6PR06MB2804; 3:GpVHrlPdubBWx/hxNfR4jEyDxnAT/U7QSTf4uUUV5O+pRl5T3Pf8S+KNTmw+qJsqfhmU4H8zaSr6eVtcV2nQSJIWOrQbc+HkogDVFnovZidW+JiIBK3Pvet1Lh2w163Z2GfosoQEmQ4GuJ2ZPrM5GDrWCLkAmxzSFnOJZ8G7a4vG+Id4cfd2IeZoBJR41xDCSroMh/xc0uiPAJfJJV6C/l9daNHqjCK1kKnH/6/2UIp2WjK2pKIXV/8YM7iszDM0; 25:KDm2423OH+t194ScwlGtKlxBJrlODdG822Nmr525iSJO3QSRxW5HXB71jj7PKCFQb2KJx+AxeO8VBE20Q2T26L4M9Rpk5DbqNHxU1TMctdkXEXfKO4CcVNeJ4ep9KQMHMh30kDMQZcDRmaPHcQ+pQdL3pXE2o/noxD1JTl+Z2FbqRUBUR3OCc3LAp/zrvtvsaG6nxNcUSDpa2jge0C2LXJXXeYVCZPTudh0O/0eSCPl41NHIl/FWIMAJj3kgxrIEhE8VpIpouQMq+aQPb9NIsuKCJtg2vkdxHBiqNF5FEgerXcDiW7hfG8FkS4aLEH1ildF6acmcb/QF0fTdYfJoqA==; 31:ISY8GKwm8i5cuQe55N7CgeRuBq8kH/8M3ZYUI2sK7rhVM0d3GUxMd/7KAQUs4ril8M8iohxxlOHd2I0vlYC3mIp0niYqUY7kqlC3vCWkEl3hT5sfazhD/nb9hasp2y6AuPeGbfG4+/FLzmhnB6rFosBOrbOl2hpLR4jet0YOgrjqchgMUM+SA7O0yS8ofWUuIU/XXaplU5Pe+mFHw5LoE6+KPQNIvX5Gkt57MNqZ7Fk= X-MS-TrafficTypeDiagnostic: BN6PR06MB2804: X-Microsoft-Exchange-Diagnostics: 1; BN6PR06MB2804; 20:GqaR9/oYCVVPDvLYgPRPMdkAnfEV+U6qTqsrBEX7mYAK/EOkUQWIt5PkcyCyY7QYshlZSJ7SLARMbTfpqQb6YogOoO0UzprOQe7ABTFL+7iIeUh3Ei2qeelrlbB72EzKUdiJEA+7nKs8ATbDwTDaJGC8Vx0iuZULl73tLawT1FCQeHAH+G0ERXgZ2nATF5XpHIMJEwjqvVRquVl0ZTup97Yk7vNO5pOWKw7Sqb55COy5KdjzmQV7TPKiFgll7YlHPVy7dDiPFHV9m7j8ukeEjRxjdfdxJRyhGG/BqmDnK9S7YjzyBdU1D/fHEoRPgV7bpFJQW/szqONCDqMrtBijKWEUp6afD6BpEWptuZANFRFj+ZIekR1YTFAt4vmS39TPSJ+PHUcuS0QBvpjJ5635W6pjcSItGMYwM+zKFoj37X3yQcObR5cwSsYSoMlrPZIkLp0m7MfuQBDPT/2tsOoJTgGPozq2J1n5WxPZI3o/q3X+VX8nW5Vukkp3Qse9ITsc; 4:A5aKp/DLwbSS62u71g1j4Xza8NBOdY3vjYHO3gDMmRqolch8Gu403W5wC0ai2V0nFU5Slns89O8sVp6UsR9md0NNMZVPal7yKNM9EghMgs4BOPO+FiKhItsAumfXcjCWtLRsglMISHloXaPLe8upKX+sdnepKzM1YdRzj/5Qhk+gueiDRDqwtvxzh7EaYr62bfwdA9VglqKjx5i02b7rideFptGUvUj0tCWz1yyN7xjVD4JaoT7vU7Jrnk81Lj/5iRW4PsG49kvwA2m0j5wMmtkzy5Tyw59/YumMDvy7TYMNyNg81/zxFGwWAcE9bDaK X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(185117386973197); X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(100000700101)(100105000095)(100000701101)(100105300095)(100000702101)(100105100095)(6040450)(2401047)(5005006)(8121501046)(100000703101)(100105400095)(93006095)(93001095)(10201501046)(3002001)(3231022)(6041248)(20161123558100)(20161123555025)(20161123562025)(20161123560025)(201703131423075)(201702281528075)(201703061421075)(201703061406153)(20161123564025)(6072148)(201708071742011)(100000704101)(100105200095)(100000705101)(100105500095); SRVR:BN6PR06MB2804; BCL:0; PCL:0; RULEID:(100000800101)(100110000095)(100000801101)(100110300095)(100000802101)(100110100095)(100000803101)(100110400095)(100000804101)(100110200095)(100000805101)(100110500095); SRVR:BN6PR06MB2804; X-Forefront-PRVS: 0492FD61DD X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10019020)(6009001)(346002)(39830400002)(376002)(189002)(199003)(8936002)(86362001)(97736004)(105586002)(2361001)(316002)(16586007)(2906002)(15650500001)(2351001)(16526018)(54906003)(4326008)(47776003)(53936002)(66066001)(106356001)(55016002)(7736002)(478600001)(25786009)(305945005)(551934003)(8676002)(81166006)(69596002)(36756003)(8656006)(81156014)(6116002)(101416001)(50466002)(50226002)(3846002)(21086003)(6916009)(5003940100001)(48376002)(189998001)(33646002)(1076002)(68736007)(5660300001)(50986999)(6666003); DIR:OUT; SFP:1102; SCL:1; SRVR:BN6PR06MB2804; H:impinj.com; FPR:; SPF:None; PTR:InfoNoRecords; MX:1; A:1; LANG:en; Received-SPF: None (protection.outlook.com: impinj.com does not designate permitted sender hosts) Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=tpiepho@impinj.com; X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; BN6PR06MB2804; 23:0UfLFZ6eaqAg8RJPMifSCUiphuGjnWlqEuDNgpVMW?= =?us-ascii?Q?6BucZ17wxQUdZs7tTLWS/jr9uovCuLs2/LvuTFCe4Oxx0UOh669F5gQiZAiC?= =?us-ascii?Q?GGEOnFZ+ekSqB72O7JgrDi/64U+VdZaU449HtD7D9a1U+LbA53wUTbaluw7n?= =?us-ascii?Q?SBjN/t5JZUufMUv1smQ8vUHCN2gd8qqBLiiBMYBauNdeRy6ztIgZAxJOVL0R?= =?us-ascii?Q?eA+cEF4SY4yqdy82m3g76zz7Q6gApNS5uhWu8O7K/eP0ygpK5Xhx466JaRir?= =?us-ascii?Q?D8qs+F7PW3fkAmw+ts9OsLxhRU3LdAxx+ggcQsfAEpmjWX0EArrr3zcfyvic?= =?us-ascii?Q?3oo4pF18qvwDjVG9U4xvEcKFx6chMw0BRrGjODOlCvcmGmSPpF8v/WmcDHEd?= =?us-ascii?Q?7QqbTF/moFtgfUNPIpsknccyJbExyAcxpbCw2SEprxdQW0YUnU6oLns7adke?= =?us-ascii?Q?Ai9sp6hFpiDGQs78aYczs9iGH/mbeCIDTGL1Bb4fVG1QoYIY/fGAgeInHKuC?= =?us-ascii?Q?5f2qgBJw+bDrDC2lW/o76NrEzPoAUkHBGYrYaP08Sl+4dLnGcHP1pqB9cftW?= =?us-ascii?Q?uF9QTfYtXcwDMf0kbLfjsDOapshYfd/jk52o+PAgQQq+CbvHtxK8ukpa/9mj?= =?us-ascii?Q?DpTTNqsTFgt4MIFL3nZ/FC0Sw/FqQoEtrJqxyNhSLp1MAOx+Laj7Z49yOf0Z?= =?us-ascii?Q?gCJz7Nrls6Ek0Mifo7pBA3AONB/SCZ/cT3kfsjR41Ku/kWqRFSv9qtAPppj3?= =?us-ascii?Q?OjLiJTRw5NvHFQiPcUU64yiiAVtt+NkUKpuG8TL7d6e+YM/ZrAC+lrw884yj?= =?us-ascii?Q?xXZrylhFkzc7LcnE86/D+IXbW5yaLG3zzwUjlWk2EhU0bYOJ2E16o2O9pLja?= =?us-ascii?Q?V/CoVGU8xqmTTByTHH/oju0XJkzjrOMwTcM2RuXeaqQ8RoTNGZVSabg/f40z?= =?us-ascii?Q?h77O8apf6mlysFw1FwWdjnKWJH3sfgkwU+I8Eqc3P/24h4nWOJc6zU47HCvZ?= =?us-ascii?Q?21wwH2uz398IzNm6qIZAtAiLkI2KyFYxyY2PB/J/1AVNEbj/lAUOFG478F7r?= =?us-ascii?Q?nzyVyUMiilU7FGv4i75WPBj8poyShYxBchM3Jr5dL2TObvmGRPyyfKv2eVJJ?= =?us-ascii?Q?h7XX7qoCQnVYAy4g5zWC/b3KBInDoPF9jKY6KTJ2YvTG8Qgg1vebgt5k9uzk?= =?us-ascii?Q?pTwfgrJc7oJZMuV6fjak5wgfXhX8ZFmIXYb?= X-Microsoft-Exchange-Diagnostics: 1; BN6PR06MB2804; 6:6nZL9Z1X/TYObTJkNM7gDFuu45cNbDzrQd94c3UAF02ewLpgavlj98n+VvPUkxiw3TgX8W27/Ko/NETtSxE8b4w8JGjAVK7wE4kXfDzTsIxap2xPMinp4gL3cI3PoaFT6riB0PqpbRIzDZrq3cu6cZiNkkXFfF4CPcuFy2IZq2vboxZL2WvnSezwHmBIdca+yf2Op7gnoA+c6eEbByGHQ9tmhm64ukMWH899fpEtmdBUVLu6JJpA84HN7uADiuQ44rLCd5CueJpD8dEAFavuLpjGZua8/1snaqdm06XK/XyzM51ghHHa1nCeyLWFzqiFNtVl8rcJXueHraPKbEt7Gx2ynXEWrzHtWnKWd21lKqU=; 5:lSxWXoaHggUhHwqK/dswWPHntj/XDip8PjJ89F0SWrM89n9xUImiLl/yIhY0tsJA2Yke7slYoZAW/EWVDad2ZpSZibM4CTNN55nokuvKNmSouArEpaVrQl0ajGqngGO/5nDlearztEKInMgu5bXVh9AQbz2CjL4seDgzaFm9QH8=; 24:+gfBsXNXj97T5tfQYmaEWKFieHfqVt0OGWza/QYGDrF6sdONqCA4VeC2f2cmysx/CkivHYQbLz0zMavEQMf4rbeBkP4XU/AmwB15eD07MdQ=; 7:trg2mXebeoiU4M5sVx5xLj+goh9ohDyuuaHYUryFcP9k4imiUKjkC7geTe/uxPTpVcTj1cp6XN/dZSLquRG+Aamdg3Ps1cKFebfxNex4hHoeSPgxB3omqcIo8sGL5VgqGsSK0ewoFval2IVrMvlVxJN7q2E0ZomtsGzuf2sY43LHyaEoYU4lD2Frtj4pzlBo5MOlFTlD0Ph1PrZakOme3wW3JP0Mp5qC0qGzIHJLt2TxWCHolsscvMCqZ6brmaKa SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-OriginatorOrg: impinj.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 15 Nov 2017 19:52:48.8329 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 8a157491-03d0-4ef6-54c9-08d52c627352 X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 6de70f0f-7357-4529-a415-d8cbb7e93e5e X-MS-Exchange-Transport-CrossTenantHeadersStamped: BN6PR06MB2804 Sender: linux-spi-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-spi@vger.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP Update documentation for gpio-cs and num-cs to reflect the standard SPI bindings. The dma properties are optional. Include a warning that native CS do not work in a commonly useful manner with this hardware/driver, and therefor most users probably should use GPIO based CS lines rather than native. CC: Mark Brown CC: Shawn Guo CC: Sascha Hauer CC: Fabio Estevam CC: Oleksij Rempel Signed-off-by: Trent Piepho --- Documentation/devicetree/bindings/spi/fsl-imx-cspi.txt | 18 ++++++++++++------ 1 file changed, 12 insertions(+), 6 deletions(-) diff --git a/Documentation/devicetree/bindings/spi/fsl-imx-cspi.txt b/Documentation/devicetree/bindings/spi/fsl-imx-cspi.txt index 5bf13960f7f4..e3c48b20b1a6 100644 --- a/Documentation/devicetree/bindings/spi/fsl-imx-cspi.txt +++ b/Documentation/devicetree/bindings/spi/fsl-imx-cspi.txt @@ -12,24 +12,30 @@ Required properties: - "fsl,imx53-ecspi" for SPI compatible with the one integrated on i.MX53 and later Soc - reg : Offset and length of the register set for the device - interrupts : Should contain CSPI/eCSPI interrupt -- cs-gpios : Specifies the gpio pins to be used for chipselects. - clocks : Clock specifiers for both ipg and per clocks. - clock-names : Clock names should include both "ipg" and "per" See the clock consumer binding, Documentation/devicetree/bindings/clock/clock-bindings.txt -- dmas: DMA specifiers for tx and rx dma. See the DMA client binding, - Documentation/devicetree/bindings/dma/dma.txt -- dma-names: DMA request names should include "tx" and "rx" if present. -Obsolete properties: -- fsl,spi-num-chipselects : Contains the number of the chipselect +Recommended properties: +- cs-gpios : GPIOs to use as chip selects, see spi-bus.txt. While the native chip +select lines can be used, they appear to always generate a pulse between each +word of a transfer. Most use cases will require GPIO based chip selects to +generate a valid transaction. Optional properties: +- num-cs : Number of total chip selects, see spi-bus.txt. +- dmas: DMA specifiers for tx and rx dma. See the DMA client binding, +Documentation/devicetree/bindings/dma/dma.txt. +- dma-names: DMA request names, if present, should include "tx" and "rx". - fsl,spi-rdy-drctl: Integer, representing the value of DRCTL, the register controlling the SPI_READY handling. Note that to enable the DRCTL consideration, the SPI_READY mode-flag needs to be set too. Valid values are: 0 (disabled), 1 (edge-triggered burst) and 2 (level-triggered burst). +Obsolete properties: +- fsl,spi-num-chipselects : Contains the number of the chipselect + Example: ecspi@70010000 {