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: 9222829 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 CE23F60772 for ; Mon, 11 Jul 2016 02:38:40 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id BE01926929 for ; Mon, 11 Jul 2016 02:38:40 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id B02742793B; Mon, 11 Jul 2016 02:38:40 +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=-4.2 required=2.0 tests=BAYES_00, RCVD_IN_DNSWL_MED autolearn=ham version=3.3.1 Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.9]) (using TLSv1.2 with cipher AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by mail.wl.linuxfoundation.org (Postfix) with ESMTPS id 3D9EC26929 for ; Mon, 11 Jul 2016 02:38:40 +0000 (UTC) Received: from localhost ([127.0.0.1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.85_2 #1 (Red Hat Linux)) id 1bMR5i-0000l6-2A; Mon, 11 Jul 2016 02:37:02 +0000 Received: from mailout1.samsung.com ([203.254.224.24]) by bombadil.infradead.org with esmtps (Exim 4.85_2 #1 (Red Hat Linux)) id 1bMR5f-0000hs-7V for linux-arm-kernel@lists.infradead.org; Mon, 11 Jul 2016 02:37:00 +0000 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> for linux-arm-kernel@lists.infradead.org; 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 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 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20160710_193659_419002_2B04F25A X-CRM114-Status: GOOD ( 11.48 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.20 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: devicetree@vger.kernel.org, linux-samsung-soc@vger.kernel.org, Andi Shyti , linux-spi@vger.kernel.org, Jaehoon Chung , Chanwoo Choi , Andi Shyti , linux-clk@vger.kernel.org, linux-arm-kernel@lists.infradead.org MIME-Version: 1.0 Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+patchwork-linux-arm=patchwork.kernel.org@lists.infradead.org X-Virus-Scanned: ClamAV using ClamSMTP 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.