From patchwork Sun Sep 3 12:31:13 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Baruch Siach X-Patchwork-Id: 809269 X-Patchwork-Delegate: davem@davemloft.net Return-Path: X-Original-To: patchwork-incoming@ozlabs.org Delivered-To: patchwork-incoming@ozlabs.org Authentication-Results: ozlabs.org; spf=none (mailfrom) smtp.mailfrom=vger.kernel.org (client-ip=209.132.180.67; helo=vger.kernel.org; envelope-from=netdev-owner@vger.kernel.org; receiver=) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 3xlXRz4TgDz9sP3 for ; Sun, 3 Sep 2017 22:32:31 +1000 (AEST) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753166AbdICMcX (ORCPT ); Sun, 3 Sep 2017 08:32:23 -0400 Received: from guitar.tcltek.co.il ([192.115.133.116]:47270 "EHLO mx.tkos.co.il" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1753148AbdICMcP (ORCPT ); Sun, 3 Sep 2017 08:32:15 -0400 Received: from sapphire.tkos.co.il (unknown [10.0.4.3]) by mx.tkos.co.il (Postfix) with ESMTPA id 66D374407B2; Sun, 3 Sep 2017 15:32:11 +0300 (IDT) From: Baruch Siach To: Rob Herring , Mark Rutland , Andrew Lunn , Florian Fainelli , "David S. Miller" , Russell King Cc: netdev@vger.kernel.org, devicetree@vger.kernel.org, Sergei Shtylyov , Baruch Siach Subject: [PATCH v3 2/3] dt-binding: net: sfp binding documentation Date: Sun, 3 Sep 2017 15:31:13 +0300 Message-Id: <01ae7bc45d68322669d18a4feeaeef733ba888d7.1504441874.git.baruch@tkos.co.il> X-Mailer: git-send-email 2.14.1 In-Reply-To: References: Sender: netdev-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: netdev@vger.kernel.org Add device-tree binding documentation SFP transceivers. Support for SFP transceivers has been recently introduced (drivers/net/phy/sfp.c). Signed-off-by: Baruch Siach --- v3: Mention gpios phandle and specifier Mention the polarity of each gpio Fix example property names v2: Rename -gpio properties to -gpios Rename the rate-select-gpio property to rate-select0-gpios Add the rate-select1-gpios property Add examples --- Documentation/devicetree/bindings/net/sff,sfp.txt | 78 +++++++++++++++++++++++ 1 file changed, 78 insertions(+) create mode 100644 Documentation/devicetree/bindings/net/sff,sfp.txt diff --git a/Documentation/devicetree/bindings/net/sff,sfp.txt b/Documentation/devicetree/bindings/net/sff,sfp.txt new file mode 100644 index 000000000000..b98ee5945265 --- /dev/null +++ b/Documentation/devicetree/bindings/net/sff,sfp.txt @@ -0,0 +1,78 @@ +Small Form Factor (SFF) Committee Small Form-factor Pluggable (SFP) +Transceiver + +Required properties: + +- compatible : must be "sff,sfp" + +Optional Properties: + +- i2c-bus : phandle of an I2C bus controller for the SFP two wire serial + interface + +- moddef0-gpios : GPIO phandle and a single specifier of the MOD-DEF0 (AKA + Mod_ABS) module presence input gpio signal, active (module absent) high + +- los-gpios : GPIO phandle and a single specifier of the Receiver Loss of + Signal Indication input gpio signal, active (signal lost) high + +- tx-fault-gpios : GPIO phandle and a single specifier of the Module + Transmitter Fault input gpio signal, active (fault condition) high + +- tx-disable-gpios : GPIO phandle and a single specifier of the Transmitter + Disable output gpio signal, active (Tx disable) high + +- rate-select0-gpios : GPIO phandle and a single specifier of the Rx Signaling + Rate Select (AKA RS0) output gpio signal, low: low Rx rate, high: high Rx + rate + +- rate-select1-gpios : GPIO phandle and a single specifier of the Tx Signaling + Rate Select (AKA RS1) output gpio signal (SFP+ only), low: low Tx rate, + high: high Tx rate + +Example #1: Direct serdes to SFP connection + +sfp_eth3: sfp-eth3 { + compatible = "sff,sfp"; + i2c-bus = <&sfp_1g_i2c>; + los-gpios = <&cpm_gpio2 22 GPIO_ACTIVE_HIGH>; + moddef0-gpios = <&cpm_gpio2 21 GPIO_ACTIVE_LOW>; + pinctrl-names = "default"; + pinctrl-0 = <&cpm_sfp_1g_pins &cps_sfp_1g_pins>; + tx-disable-gpios = <&cps_gpio1 24 GPIO_ACTIVE_HIGH>; + tx-fault-gpios = <&cpm_gpio2 19 GPIO_ACTIVE_HIGH>; +}; + +&cps_emac3 { + phy-mode = "sgmii"; + phy-names = "comphy"; + phys = <&cps_comphy 5 COMPHY_SGMII2>; + sfp = <&sfp_eth3>; +}; + +Example #2: Serdes to PHY to SFP connection + +sfp_eth0: sfp-eth0 { + compatible = "sff,sfp+"; + i2c-bus = <&sfpp0_i2c>; + los-gpios = <&cps_gpio1 28 GPIO_ACTIVE_HIGH>; + moddef0-gpios = <&cps_gpio1 27 GPIO_ACTIVE_LOW>; + pinctrl-names = "default"; + pinctrl-0 = <&cps_sfpp0_pins>; + tx-disable-gpios = <&cps_gpio1 29 GPIO_ACTIVE_HIGH>; + tx-fault-gpios = <&cps_gpio1 26 GPIO_ACTIVE_HIGH>; +}; + +p0_phy: ethernet-phy@0 { + compatible = "ethernet-phy-ieee802.3-c45"; + pinctrl-names = "default"; + pinctrl-0 = <&cpm_phy0_pins &cps_phy0_pins>; + reg = <0>; + interrupt = <&cpm_gpio2 18 IRQ_TYPE_EDGE_FALLING>; + sfp = <&sfp_eth0>; +}; + +&cpm_eth0 { + phy = <&p0_phy>; + phy-mode = "10gbase-kr"; +};