From patchwork Wed May 10 08:53:23 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stefan Wahren X-Patchwork-Id: 760500 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 3wN9Dk0QsJz9s2Q for ; Wed, 10 May 2017 19:00:22 +1000 (AEST) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752889AbdEJI6C (ORCPT ); Wed, 10 May 2017 04:58:02 -0400 Received: from mout.kundenserver.de ([212.227.17.24]:51896 "EHLO mout.kundenserver.de" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752687AbdEJIxv (ORCPT ); Wed, 10 May 2017 04:53:51 -0400 Received: from duckbill-v2-sdk.fritz.box ([109.104.47.221]) by mrelayeu.kundenserver.de (mreue101 [212.227.15.183]) with ESMTPSA (Nemesis) id 0LpwXf-1ddqFF2TXr-00fgQh; Wed, 10 May 2017 10:53:34 +0200 From: Stefan Wahren To: Rob Herring , "David S. Miller" Cc: Mark Rutland , Greg Kroah-Hartman , Jiri Slaby , linux-serial@vger.kernel.org, linux-kernel@vger.kernel.org, netdev@vger.kernel.org, devicetree@vger.kernel.org, Stefan Wahren Subject: [PATCH v5 12/17] dt-bindings: qca7000-spi: Rework binding Date: Wed, 10 May 2017 10:53:23 +0200 Message-Id: <1494406408-31760-13-git-send-email-stefan.wahren@i2se.com> X-Mailer: git-send-email 2.1.4 In-Reply-To: <1494406408-31760-1-git-send-email-stefan.wahren@i2se.com> References: <1494406408-31760-1-git-send-email-stefan.wahren@i2se.com> X-Provags-ID: V03:K0:jahQXt1pHlUG7F7Bmqo1j7iURO1zKWrycoIWYPQo7XVbVt9AhE2 ukdGy8w3y9M8kZzp+H4IqHKq55m6Wi0KfCWgCZhod66tog2WMEQSRf6tZ/qO06IPYshuvmu yNq7w9d++WBGmfk7VTnPMVKoov0XHfQLPkOXdfFlXoRpNeIVQy1EdFfMnhagFOZt0S/+CBM NMRGy3uxrWbUot7nCY0Kg== X-UI-Out-Filterresults: notjunk:1; V01:K0:s9tEoK6jX8c=:+CGQAsrXGH4kZ36DIrSRjR EyvgX2CzhEAxOkilB0J0+sxZs+fnj7xeSxka581bKH8G8S3pNe6BQ/PxNv2Q3l6EaMHOfc2j0 8w92BnpvTZYwlGAb9RUktpYVfeztxO3hm9Pm0RmutnD857UUF/nJIGfbBHPoP6zdMooPWE0q1 El35vdY7aZd0gDKBSWWWcr1XmgiZ7mcDRVQHFUN4vtqah+kVVX+bS/+ISrJQxiVTqJUVZyMqR DkIrnfD27a4a227CxzVeF9ArC5M1+rt+wrktc3biq4wI1vJjbeQGLxPG12+Mni51IV4wXPGUi QDGcguA6KPG0XgYN2AkYxkBzUU7zB/T6b4L4Uc4zX2Zg2v2b+QmFEEzGwU0f8AeUx2TqYmiaF UDN5EHGvIOiPYioxW9lyvBfHLBgoY5wkbTVx/cRFEQjKSVMQihiOwux2kp2rop+8ImShkEQaB rUCEhE8sj/j5rivRlUp0m7Xm3U8x1PAhwVHxlif7ojAGe1/2KblzPByUDzQE612HBEKdlhYyb +WTPiB8WrQ7teDBWIkgp4RxT+qJRK0HtE8KVIC/Qf4o5SYOn9g66fZU0rjgcnRWTYPScR0n0Z CxFxsvl5aoBq2Wdloee+onsqRXYotqTCHvdyQb6FlJKn4wYF/qv8TumC77xjysIWHxpTX85kE LFHmCXdEWYwINWF07hyCEmmT5W6PlbucdaTu3613QF/QnaG+FhGJ95uMMJ0/c4+1R/cE= 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 {