From patchwork Mon Jul 11 02:36:21 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Andi Shyti X-Patchwork-Id: 646799 Return-Path: X-Original-To: incoming-dt@patchwork.ozlabs.org Delivered-To: patchwork-incoming-dt@bilbo.ozlabs.org Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 3rnq3s2sB6z9sdQ for ; Mon, 11 Jul 2016 12:36:41 +1000 (AEST) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1757468AbcGKCgj (ORCPT ); Sun, 10 Jul 2016 22:36:39 -0400 Received: from mailout1.samsung.com ([203.254.224.24]:40733 "EHLO mailout1.samsung.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1757302AbcGKCgi (ORCPT ); Sun, 10 Jul 2016 22:36:38 -0400 Received: from epcpsbgr3.samsung.com (u143.gpu120.samsung.co.kr [203.254.230.143]) by mailout1.samsung.com (Oracle Communications Messaging Server 7.0.5.31.0 64bit (built May 5 2014)) with ESMTP id <0OA4017RUPWZJU80@mailout1.samsung.com>; Mon, 11 Jul 2016 11:36:35 +0900 (KST) Received: from epcpsbgm2new.samsung.com ( [172.20.52.113]) by epcpsbgr3.samsung.com (EPCPMTA) with SMTP id E7.8B.05161.23603875; Mon, 11 Jul 2016 11:36:35 +0900 (KST) X-AuditID: cbfee68f-f79476d000001429-ce-578306321a45 Received: from epmmp2 ( [203.254.227.17]) by epcpsbgm2new.samsung.com (EPCPMTA) with SMTP id 60.94.04429.23603875; Sun, 10 Jul 2016 19:36:34 -0700 (MST) Received: from samsunx.samsung ([10.113.63.54]) by mmp2.samsung.com (Oracle Communications Messaging Server 7.0.5.31.0 64bit (built May 5 2014)) with ESMTPA id <0OA4007WDPWVVS10@mmp2.samsung.com>; Mon, 11 Jul 2016 11:36:34 +0900 (KST) From: Andi Shyti To: Rob Herring , Mark Rutland , Kukjin Kim , Krzysztof Kozlowski , Mark Brown , Sylwester Nawrocki , Tomasz Figa , Michael Turquette , Stephen Boyd Cc: Chanwoo Choi , Jaehoon Chung , linux-clk@vger.kernel.org, devicetree@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linux-samsung-soc@vger.kernel.org, linux-spi@vger.kernel.org, Andi Shyti , Andi Shyti Subject: [PATCH v3] bindings: spi-samsung: document the clocks and the clock-name property Date: Mon, 11 Jul 2016 11:36:21 +0900 Message-id: <1468204581-16873-1-git-send-email-andi.shyti@samsung.com> X-Mailer: git-send-email 2.8.1 In-reply-to: <20160708203207.GB25980@kozik-lap> References: <20160708203207.GB25980@kozik-lap> X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFlrKIsWRmVeSWpSXmKPExsWyRsSkUNeYrTncYOkuJovtR56xWiz+8ZzJ YurDJ2wW1788Z7WYf+Qcq8WNX22sFq9fGFr0P37NbLHp8TVWi48991gtZpzfx2TR+PEmu8XS 6xeZLC6ecrVo3XuE3eLwm3ZWix9nulksVu36w+gg5LFm3hpGj/c3Wtk9Lvf1MnlcX/KJ2WPn rLvsHptWdbJ5bF5S79G3ZRWjx+dNcgGcUVw2Kak5mWWpRfp2CVwZr269YC/o5KuYMU25gfEO dxcjJ4eEgInEtQnNbBC2mMSFe+uBbC4OIYEVjBK/b11nhSm6sekdC0RiFqPEnu3tUFUfGSXe /FvEDlLFJqAp0XT7B1hCROAZk8SHhteMIA6zwHYmiWNP14LNEhaIkVj/9z4TiM0ioCpxuakT LM4r4Cbx8v5xRoh9chKXpz8AO4pTQF+i499JsBohAT2JpeevgQ2VEOjkkHh84gI7xCABiW+T DwEdyAGUkJXYdIAZYo6kxMEVN1gmMAovYGRYxSiaWpBcUJyUXmSsV5yYW1yal66XnJ+7iREY e6f/PevfwXj3gPUhRgEORiUe3h9bmsKFWBPLiitzDzGaAm2YyCwlmpwPjPC8knhDYzMjC1MT U2Mjc0szJXHehVI/g4UE0hNLUrNTUwtSi+KLSnNSiw8xMnFwSjUw+ind+H0r8bCj2gPTSR0C RX8kZn3d4VZhai206MKeBXem90hOa+Kfk5Gs3mk0+2y6tgdP4vcOs4C87XulrjrMFPeXe3Km ZumbUos85RfbZp5d/0dX6HzpV+lDNw+vPLNCM/O3//zojhvKNj3n+i4a39yamfLqmZFDXcUS //um3ad4MjdvOCqcpsRSnJFoqMVcVJwIAG9fBFu4AgAA X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFvrEIsWRmVeSWpSXmKPExsVy+t9jQV0jtuZwg1nTLCy2H3nGarH4x3Mm i6kPn7BZXP/ynNVi/pFzrBY3frWxWrx+YWjR//g1s8Wmx9dYLT723GO1mHF+H5NF48eb7BZL r19ksrh4ytWide8RdovDb9pZLX6c6WaxWLXrD6ODkMeaeWsYPd7faGX3uNzXy+RxfcknZo+d s+6ye2xa1cnmsXlJvUffllWMHp83yQVwRjUw2mSkJqakFimk5iXnp2TmpdsqeQfHO8ebmhkY 6hpaWpgrKeQl5qbaKrn4BOi6ZeYA/aOkUJaYUwoUCkgsLlbSt8M0ITTETdcCpjFC1zckCK7H yAANJKxhzHh16wV7QSdfxYxpyg2Md7i7GDk5JARMJG5sescCYYtJXLi3nq2LkYtDSGAWo8Se 7e1QzkdGiTf/FrGDVLEJaEo03f4BlhAReMYk8aHhNSOIwyywnUni2NO1rCBVwgIxEuv/3mcC sVkEVCUuN3WCxXkF3CRe3j/OCLFPTuLy9AdsIDangL5Ex7+TYDVCAnoSS89fY5zAyLuAkWEV o0RqQXJBcVJ6rlFearlecWJucWleul5yfu4mRnB8P5PewXh4l/shRgEORiUe3oDtTeFCrIll xZW5hxglOJiVRHhP/AMK8aYkVlalFuXHF5XmpBYfYjQFOmwis5Rocj4w9eSVxBsam5gZWRqZ G1oYGZsrifM+/r8uTEggPbEkNTs1tSC1CKaPiYNTqoGRO+6zsersb8o+ciU1vkwN9bYfzWef Xcun+eBdwcHufW9Ksu7tvrHOdtuMhTym67l3rtE3fbjxk3P14i3zpzp8DDjU9V1V4+1P6+Cr yv6PV15U2znre/Ey+5XHMr7dus25eSrz3wfHryRdSJokXQJ00UEbvc6X2W+qnUNYuQy5vuq7 rK1YfO6tEktxRqKhFnNRcSIA4H5cxQUDAAA= DLP-Filter: Pass X-MTR: 20000000000000000@CPGS X-CFilter-Loop: Reflected Sender: devicetree-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org These two properties were not documented but used in the spi dts. Add the related documentation. Suggested-by: Krzysztof Kozlowski Signed-off-by: Andi Shyti Reviewed-by: Michael Turquette Reviewed-by: Krzysztof Kozlowski --- Hi, Changelog related only to this patch: V1 -> V2: [new] added the clocks and clock-name documentation in the bindings V2 -> V3: reworded the 'clock-names' as suggested by Krzysztof, added Mike's and Krzysztof's review and Krzysztof's suggested-by. Thanks, Andi Documentation/devicetree/bindings/spi/spi-samsung.txt | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/Documentation/devicetree/bindings/spi/spi-samsung.txt b/Documentation/devicetree/bindings/spi/spi-samsung.txt index 57d5539..f45c6eb 100644 --- a/Documentation/devicetree/bindings/spi/spi-samsung.txt +++ b/Documentation/devicetree/bindings/spi/spi-samsung.txt @@ -24,6 +24,15 @@ Required SoC Specific Properties: - dma-names: Names for the dma channels. There must be at least one channel named "tx" for transmit and named "rx" for receive. +- clocks: specifies the clock IDs provided to the SPI controller; they are + required for interacting with the controller itself, for synchronizing the bus + and as I/O clock (the latter is required by exynos5433 and exynos7). + +- clock-names: string names of the clocks in the 'clocks' property; for all the + the devices the names must be "spi", "spi_busclkN" (where N is determined by + "samsung,spi-src-clk"), while Exynos5433 should specify a third clock + "spi_ioclk" for the I/O clock. + Required Board Specific Properties: - #address-cells: should be 1.