From patchwork Mon May 29 11:57:21 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stefan Wahren X-Patchwork-Id: 768163 X-Patchwork-Delegate: davem@davemloft.net Return-Path: X-Original-To: patchwork-incoming@ozlabs.org Delivered-To: patchwork-incoming@ozlabs.org Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 3wbwN51CHlz9s0m for ; Mon, 29 May 2017 22:02:29 +1000 (AEST) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751479AbdE2MCF (ORCPT ); Mon, 29 May 2017 08:02:05 -0400 Received: from mout.kundenserver.de ([212.227.126.131]:51789 "EHLO mout.kundenserver.de" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751086AbdE2L5w (ORCPT ); Mon, 29 May 2017 07:57:52 -0400 Received: from duckbill-v2-sdk.fritz.box ([109.104.48.59]) by mrelayeu.kundenserver.de (mreue005 [212.227.15.167]) with ESMTPSA (Nemesis) id 0MYJFd-1dSuEF28tF-00VBD2; Mon, 29 May 2017 13:57:38 +0200 From: Stefan Wahren To: Rob Herring , Mark Rutland , "David S. Miller" Cc: Greg Kroah-Hartman , Jiri Slaby , Lino Sanfilippo , Jakub Kicinski , devicetree@vger.kernel.org, netdev@vger.kernel.org, linux-serial@vger.kernel.org, linux-kernel@vger.kernel.org, Stefan Wahren Subject: [PATCH v8 net-next 13/17] dt-bindings: qca7000-spi: Rework binding Date: Mon, 29 May 2017 13:57:21 +0200 Message-Id: <1496059045-13572-14-git-send-email-stefan.wahren@i2se.com> X-Mailer: git-send-email 2.1.4 In-Reply-To: <1496059045-13572-1-git-send-email-stefan.wahren@i2se.com> References: <1496059045-13572-1-git-send-email-stefan.wahren@i2se.com> X-Provags-ID: V03:K0:cYJ50kf3Q5OeUruhpU68XeDU8Rirjsu0N+qsC/sL4hHgO4EX60X tw3zSeV1Cy0ZtU7fopdgLx/0G8VBW7fglYaLK2LwaWRtQlMIeDfYfQi+EKKzx/ToLvsBYRe 7QFvH3mD0E5Ihk1C8pKIPEfjleFaUWawd/KYVKojTZ+vsWFqjHly+hxsV1KKpYULgn0SCup lgubqmFXJdqBluS2u28iQ== X-UI-Out-Filterresults: notjunk:1; V01:K0:xAv2Qgptbok=:WNK7QhYJPiDcp2cKtf7KSr f/+12kt7St5cYp4hTYIE65IqiypyytMb2K67Vr+0B6WsTSi2FrwEijKl56+MTuR4wC9RyBAs0 PNgKeRlE0P5GE0Y1GnPmFiJwPzPXmOn+MiEfTZdi9ONUGIv0L9YwQIqsSOPKhYl1FtCSo+1E+ oJtQR/g/vcJJ3lzg+fOm/Bt5WsX5n+XbFZQj6eScEduh/S3r6F2A07cp6Gq3mZ1q5x3nelm2s BtFZE4gwR9hbXSIhPvFXeoO976DXsKQjQ0325wFo6IROa6Re7CHYHTSad2i9PkypWQEO8vn7d 8SyFxgv7wYPTvDxmP/pluoKt5XFde990vDLCRK2bHaoS9t8VcqHCf2QFLNCxJ86mc5/D5Pjq8 oAhxSYujbhKvSnEAy0AxsNr97Am2aT6hcmRMcRQAfIGWjMnt0ZXEEbKIoW3U8+CHfVcznaR84 DA65xd2BbEwomDYtstB6XE29YdlGSafOdwAnAHiJv22ior8gRrgR9HCvSO5fQZ262Q9gvPXoF U3NQ40g6rK9K44t0pKyrehjd+gSr4idqb5M5CHuQOloqSSR1wcq3ch0UuVNmfMNrdt3XLn3Ti TdnGpxiWYffm781sGzGrnJqUjQbu2MMPaIyJnc9kSQHKOGFHfDG+pV7mJUzA0NcKAoS4bgsGm XvKg2rim16pgIOM7gHw2ySWM4TbKtNCiAQmQzl9Ty+8NYUFSK7gIJTeLM2gxSnBn2BJA= Sender: netdev-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: netdev@vger.kernel.org In preparation for the QCA7000 UART binding rework the binding document. Signed-off-by: Stefan Wahren --- .../devicetree/bindings/net/qca-qca7000-spi.txt | 49 +++++++++++++--------- 1 file changed, 29 insertions(+), 20 deletions(-) diff --git a/Documentation/devicetree/bindings/net/qca-qca7000-spi.txt b/Documentation/devicetree/bindings/net/qca-qca7000-spi.txt index c74989c..a37f656 100644 --- a/Documentation/devicetree/bindings/net/qca-qca7000-spi.txt +++ b/Documentation/devicetree/bindings/net/qca-qca7000-spi.txt @@ -1,29 +1,38 @@ -* Qualcomm QCA7000 (Ethernet over SPI protocol) +* Qualcomm QCA7000 -Note: The QCA7000 is useable as a SPI device. In this case it must be defined -as a child of a SPI master in the device tree. +The QCA7000 is a serial-to-powerline bridge with a host interface which could +be configured either as SPI or UART slave. This configuration is done by +the QCA7000 firmware. + +(a) Ethernet over SPI + +In order to use the QCA7000 as SPI device it must be defined as a child of a +SPI master in the device tree. Required properties: -- compatible : Should be "qca,qca7000" -- reg : Should specify the SPI chip select -- interrupts : The first cell should specify the index of the source interrupt - and the second cell should specify the trigger type as rising edge -- spi-cpha : Must be set -- spi-cpol: Must be set +- compatible : Should be "qca,qca7000" +- reg : Should specify the SPI chip select +- interrupts : The first cell should specify the index of the source + interrupt and the second cell should specify the trigger + type as rising edge +- spi-cpha : Must be set +- spi-cpol : Must be set Optional properties: -- interrupt-parent : Specify the pHandle of the source interrupt +- interrupt-parent : Specify the pHandle of the source interrupt - spi-max-frequency : Maximum frequency of the SPI bus the chip can operate at. - Numbers smaller than 1000000 or greater than 16000000 are invalid. Missing - the property will set the SPI frequency to 8000000 Hertz. -- local-mac-address: 6 bytes, MAC address -- qca,legacy-mode : Set the SPI data transfer of the QCA7000 to legacy mode. - In this mode the SPI master must toggle the chip select between each data - word. In burst mode these gaps aren't necessary, which is faster. - This setting depends on how the QCA7000 is setup via GPIO pin strapping. - If the property is missing the driver defaults to burst mode. - -Example: + Numbers smaller than 1000000 or greater than 16000000 + are invalid. Missing the property will set the SPI + frequency to 8000000 Hertz. +- local-mac-address : see ./ethernet.txt +- qca,legacy-mode : Set the SPI data transfer of the QCA7000 to legacy mode. + In this mode the SPI master must toggle the chip select + between each data word. In burst mode these gaps aren't + necessary, which is faster. This setting depends on how + the QCA7000 is setup via GPIO pin strapping. If the + property is missing the driver defaults to burst mode. + +SPI Example: /* Freescale i.MX28 SPI master*/ ssp2: spi@80014000 {