From patchwork Tue May 23 13:12:49 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stefan Wahren X-Patchwork-Id: 765949 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 3wXGFt6kc4z9sPD for ; Tue, 23 May 2017 23:14:26 +1000 (AEST) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S967422AbdEWNOO (ORCPT ); Tue, 23 May 2017 09:14:14 -0400 Received: from mout.kundenserver.de ([212.227.17.13]:62714 "EHLO mout.kundenserver.de" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1764060AbdEWNNh (ORCPT ); Tue, 23 May 2017 09:13:37 -0400 Received: from duckbill-v2-sdk.fritz.box ([109.104.44.37]) by mrelayeu.kundenserver.de (mreue101 [212.227.15.183]) with ESMTPSA (Nemesis) id 0M8QjK-1e95lI25Ba-00vyd8; Tue, 23 May 2017 15:13:22 +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 v6 net-next 13/17] dt-bindings: qca7000-spi: Rework binding Date: Tue, 23 May 2017 15:12:49 +0200 Message-Id: <1495545173-22150-14-git-send-email-stefan.wahren@i2se.com> X-Mailer: git-send-email 2.1.4 In-Reply-To: <1495545173-22150-1-git-send-email-stefan.wahren@i2se.com> References: <1495545173-22150-1-git-send-email-stefan.wahren@i2se.com> X-Provags-ID: V03:K0:g6qVsaxqWdcQK6Yfv2lt99h45G3RwWg4SMp1sVS7c/w5Sk16GlN SuHUwjVevI5uRXS3YAxUnIUPnNlmWTDK+zOBnf9sIcdredcbmwe87jqoYx+W/8XXWamR/5o 115I2FvHN88MCbXhg4ujHoErYQjGZ5M3nlqQRQ+/XKk2P8V5I052SntwcJ+dkc03vn2oU6R r9J2nplkOHQTAebMB+ceQ== X-UI-Out-Filterresults: notjunk:1; V01:K0:dhr51KP3iIA=:atEYSXmx+cRjckIpR0Pwqa 0bPR4njDnBsdP4wdnv8+BgToms7/ICaRTqP3BmPn86ttKk1IUMt1Z+qFT+0gaEGiDGOHRPGKG rvViId6VtOz32bccq2gH+wsV3kR/gx34bUCmtnA3iHeRCprYV8ibCnSxyqLlep6uPUlUSZ89A NFT7lvgLILbBjoRrAHCgKG5xBMIoGtmJtvjr4nkJNDUIlDWKdjkyF9+Mdd7GGxLntgVwEYml1 +TW9Ojk+TTO1bzMf5NZBvWeT+0FhMAHhdeMJTJZyDVWOq8vZFPNtpURl+7IbyZpNeS6DZWfwx SWIuPZSgNwXnggAVTkUYOM5eTLX8rJ0qj/EuoJDJ97nQrF6mKXmIdhpXjP2Q4EzOi0d21q78j xmmDYlbmVN/iTtqZkhN3AIBqtuwb3konXE3l+Ynhj3TCxQwd/40fuHqmIRSlRUKCvwW3HLShf nLjRZ504eii0B/Ey2R3N6Jh4HgQGoW92NapWtdAduTmnJGW8n28OccgJatAIwz/qwvE2ro+38 hO/7QL7PPesXSY0mu3fLYROgYYIt2AJ5o7qBchw35D5ArDPuhAvgfs8eUyEwpna1oUUYmjbXv bQ1vC3h5/GbQh+BkeUqxRq3WLkwdqtJ51f+0qC6zMJb7UcfI5gzUtXizIjChHqV9fo9mPChgq ePmtHcb+jcS03Au5GOdOxw30u4v4wcqoEhxicQEIvusbH2+EP38O0F2dTwMGOZ6tBSrU= 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 {