From nobody Sat May 4 21:25:43 2024 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id CF654C04A95 for ; Wed, 28 Sep 2022 16:21:46 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S234303AbiI1QVo (ORCPT ); Wed, 28 Sep 2022 12:21:44 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:50666 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S234324AbiI1QVi (ORCPT ); Wed, 28 Sep 2022 12:21:38 -0400 Received: from esa.microchip.iphmx.com (esa.microchip.iphmx.com [68.232.153.233]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 07CC5E21C5; Wed, 28 Sep 2022 09:21:31 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=microchip.com; i=@microchip.com; q=dns/txt; s=mchp; t=1664382092; x=1695918092; h=from:to:subject:date:message-id:mime-version: content-transfer-encoding; bh=VFLlzbowANTEuTplVjxC4dIg9DEzjoClVyh1LPKwaoA=; b=al0WrVlMYggAJMWUhnU8VCe65KKM6X5juciE44z3vYtpdO0TPj9xenMx deRXyBXtW7uu2LQJt2PiKvNINVEJ7Z3APTiEzPDH+XpnXhkSX1tyQhlwQ DMJ0pzlCZAReCbyf2O8GahOfvMPqe6K96FWiOCLzKcnAc8R0lItmaRT7n bQV3aFowvQYlrvjy5B5Hlzpb3V4kypAIbMlNc7+Cya1dLOk4n4kDxBif2 FT+7fpuF/BJbv5tmEKjLfq4Lg2lsZL4MoaZwXM/JIl/fWqbA7CzxAEbtG xdSxuONqlqI2Fkqxax+MlV2UDsqPGuQOytndIJCbPYC+gMMmfz95jP7Bj g==; X-IronPort-AV: E=Sophos;i="5.93,352,1654585200"; d="scan'208";a="182355220" Received: from unknown (HELO email.microchip.com) ([170.129.1.10]) by esa5.microchip.iphmx.com with ESMTP/TLS/AES256-SHA256; 28 Sep 2022 09:21:30 -0700 Received: from chn-vm-ex03.mchp-main.com (10.10.85.151) by chn-vm-ex04.mchp-main.com (10.10.85.152) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.12; Wed, 28 Sep 2022 09:21:29 -0700 Received: from ATX-DK-C33025.microchip.com (10.10.115.15) by chn-vm-ex03.mchp-main.com (10.10.85.151) with Microsoft SMTP Server id 15.1.2507.12 via Frontend Transport; Wed, 28 Sep 2022 09:21:28 -0700 From: Jerry Ray To: Andrew Lunn , Vivien Didelot , Florian Fainelli , Vladimir Oltean , "David S. Miller" , Eric Dumazet , Jakub Kicinski , Paolo Abeni , "Rob Herring" , Krzysztof Kozlowski , , , , , Jerry Ray Subject: [net-next][PATCH v3] dt-bindings: dsa: lan9303: Add lan9303 yaml Date: Wed, 28 Sep 2022 11:21:28 -0500 Message-ID: <20220928162128.802-1-jerry.ray@microchip.com> X-Mailer: git-send-email 2.25.1 MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" Adding the dt binding yaml for the lan9303 3-port ethernet switch. The microchip lan9354 3-port ethernet switch will also use the same binding. Signed-off-by: Jerry Ray --- v2->v3: - removed cpu labels - now patching against latest net-next v1->v2: - fixed dt_binding_check warning - added max-speed setting on the switches 10/100 ports. --- .../devicetree/bindings/net/dsa/lan9303.txt | 99 +------------- .../bindings/net/dsa/microchip,lan9303.yaml | 129 ++++++++++++++++++ MAINTAINERS | 8 ++ 3 files changed, 139 insertions(+), 97 deletions(-) create mode 100644 Documentation/devicetree/bindings/net/dsa/microchip,lan= 9303.yaml diff --git a/Documentation/devicetree/bindings/net/dsa/lan9303.txt b/Docume= ntation/devicetree/bindings/net/dsa/lan9303.txt index 46a732087f5c..8c8fedd1f00e 100644 --- a/Documentation/devicetree/bindings/net/dsa/lan9303.txt +++ b/Documentation/devicetree/bindings/net/dsa/lan9303.txt @@ -1,100 +1,5 @@ SMSC/MicroChip LAN9303 three port ethernet switch ------------------------------------------------- =20 -Required properties: - -- compatible: should be - - "smsc,lan9303-i2c" for I2C managed mode - or - - "smsc,lan9303-mdio" for mdio managed mode - -Optional properties: - -- reset-gpios: GPIO to be used to reset the whole device -- reset-duration: reset duration in milliseconds, defaults to 200 ms - -Subnodes: - -The integrated switch subnode should be specified according to the binding -described in dsa/dsa.txt. The CPU port of this switch is always port 0. - -Note: always use 'reg =3D <0/1/2>;' for the three DSA ports, even if the d= evice is -configured to use 1/2/3 instead. This hardware configuration will be -auto-detected and mapped accordingly. - -Example: - -I2C managed mode: - - master: masterdevice@X { - - fixed-link { /* RMII fixed link to LAN9303 */ - speed =3D <100>; - full-duplex; - }; - }; - - switch: switch@a { - compatible =3D "smsc,lan9303-i2c"; - reg =3D <0xa>; - reset-gpios =3D <&gpio7 6 GPIO_ACTIVE_LOW>; - reset-duration =3D <200>; - - ports { - #address-cells =3D <1>; - #size-cells =3D <0>; - - port@0 { /* RMII fixed link to master */ - reg =3D <0>; - ethernet =3D <&master>; - }; - - port@1 { /* external port 1 */ - reg =3D <1>; - label =3D "lan1"; - }; - - port@2 { /* external port 2 */ - reg =3D <2>; - label =3D "lan2"; - }; - }; - }; - -MDIO managed mode: - - master: masterdevice@X { - phy-handle =3D <&switch>; - - mdio { - #address-cells =3D <1>; - #size-cells =3D <0>; - - switch: switch-phy@0 { - compatible =3D "smsc,lan9303-mdio"; - reg =3D <0>; - reset-gpios =3D <&gpio7 6 GPIO_ACTIVE_LOW>; - reset-duration =3D <100>; - - ports { - #address-cells =3D <1>; - #size-cells =3D <0>; - - port@0 { - reg =3D <0>; - ethernet =3D <&master>; - }; - - port@1 { /* external port 1 */ - reg =3D <1>; - label =3D "lan1"; - }; - - port@2 { /* external port 2 */ - reg =3D <2>; - label =3D "lan2"; - }; - }; - }; - }; - }; +See Documentation/devicetree/bindings/net/dsa/microchip,lan9303.yaml for t= he +device tree documentation covering the LAN9303 and LAN9354 devices. diff --git a/Documentation/devicetree/bindings/net/dsa/microchip,lan9303.ya= ml b/Documentation/devicetree/bindings/net/dsa/microchip,lan9303.yaml new file mode 100644 index 000000000000..818770092a2c --- /dev/null +++ b/Documentation/devicetree/bindings/net/dsa/microchip,lan9303.yaml @@ -0,0 +1,129 @@ +# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/net/dsa/microchip,lan9303.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: LAN9303 Ethernet Switch Series Tree Bindings + +allOf: + - $ref: "dsa.yaml#" + +maintainers: + - UNGLinuxDriver@microchip.com + +properties: + compatible: + oneOf: + - enum: + - smsc,lan9303-mdio + - microchip,lan9354-mdio + - enum: + - smsc,lan9303-i2c + + reg: + maxItems: 1 + + reset-gpios: + description: Optional gpio specifier for a reset line + maxItems: 1 + + reset-duration: + description: Reset duration in milliseconds, defaults to 200 ms + +required: + - compatible + - reg + +unevaluatedProperties: false + +examples: + - | + #include + + //Ethernet switch connected via mdio to the host + ethernet0 { + #address-cells =3D <1>; + #size-cells =3D <0>; + phy-handle =3D <&lan9303switch>; + phy-mode =3D "rmii"; + fixed-link { + speed =3D <100>; + full-duplex; + }; + mdio { + #address-cells =3D <1>; + #size-cells =3D <0>; + lan9303switch: switch@0 { + compatible =3D "smsc,lan9303-mdio"; + dsa,member =3D <0 0>; + reg =3D <0>; + ethernet-ports { + #address-cells =3D <1>; + #size-cells =3D <0>; + port@0 { + reg =3D <0>; + phy-mode =3D "rmii"; + ethernet =3D <ðernet>; + fixed-link { + speed =3D <100>; + full-duplex; + }; + }; + port@1 { + reg =3D <1>; + max-speed =3D <100>; + label =3D "lan1"; + }; + port@2 { + reg =3D <2>; + max-speed =3D <100>; + label =3D "lan2"; + }; + }; + }; + }; + }; + + //Ethernet switch connected via i2c to the host + ethernet1 { + #address-cells =3D <1>; + #size-cells =3D <0>; + phy-mode =3D "rmii"; + fixed-link { + speed =3D <100>; + full-duplex; + }; + }; + + i2c { + #address-cells =3D <1>; + #size-cells =3D <0>; + lan9303: switch@1a { + compatible =3D "smsc,lan9303-i2c"; + reg =3D <0x1a>; + ethernet-ports { + #address-cells =3D <1>; + #size-cells =3D <0>; + port@0 { + reg =3D <0>; + phy-mode =3D "rmii"; + ethernet =3D <ðernet1>; + fixed-link { + speed =3D <100>; + full-duplex; + }; + }; + port@1 { + reg =3D <1>; + max-speed =3D <100>; + label =3D "lan1"; + }; + port@2 { + reg =3D <2>; + max-speed =3D <100>; + label =3D "lan2"; + }; + }; + }; + }; diff --git a/MAINTAINERS b/MAINTAINERS index 5d58b55c5ae5..89055ff2838a 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -13386,6 +13386,14 @@ L: netdev@vger.kernel.org S: Maintained F: drivers/net/ethernet/microchip/lan743x_* =20 +MICROCHIP LAN9303/LAN9354 ETHERNET SWITCH DRIVER +M: Jerry Ray +M: UNGLinuxDriver@microchip.com +L: netdev@vger.kernel.org +S: Maintained +F: Documentation/devicetree/bindings/net/dsa/microchip,lan9303.yaml +F: drivers/net/dsa/lan9303* + MICROCHIP LAN966X ETHERNET DRIVER M: Horatiu Vultur M: UNGLinuxDriver@microchip.com --=20 2.25.1