From nobody Sat Sep 21 02:36:58 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 ACCADC05027 for ; Sun, 12 Feb 2023 13:13:47 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229524AbjBLNNd (ORCPT ); Sun, 12 Feb 2023 08:13:33 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:52416 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229449AbjBLNNb (ORCPT ); Sun, 12 Feb 2023 08:13:31 -0500 Received: from mail-ej1-x62e.google.com (mail-ej1-x62e.google.com [IPv6:2a00:1450:4864:20::62e]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id B55A5CC11; Sun, 12 Feb 2023 05:13:26 -0800 (PST) Received: by mail-ej1-x62e.google.com with SMTP id dr8so25888402ejc.12; Sun, 12 Feb 2023 05:13:26 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=XA8l1UNyv+RC0xjr49Zj35slp6HWpLIolNcfko1OuWM=; b=paikrkY2n7o92kwyNvsr8KemY9Cr7a4ASfa41yKpvLy6Il/K3Eq7MiuLjoM0LVnsfU EwR2vCpQT6esW9Au5BrEt8+lYNQ5mQ/TJ5Zraz1dnfQsgyMeYkPg/MaHkLZN2SAEBawY 6K9pNot+nLI27j1BshO1zYcoEINAoqEtlMNtoLKMGdzNecqpSHAUOz529i1zDDDjqiZn Pinj9ujSlMaT0zmd2IZs8IWHZlh7I5E70nIwygKU2V+ucFnqP++2KLMjxdnTOgA5qmxo 6l+O2Uza0miWwBTFpAGoBx+F30kU+atcIES0NbX19SBSER1oRVvXfXuJ4xitTfcrxfTH Q3gw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=XA8l1UNyv+RC0xjr49Zj35slp6HWpLIolNcfko1OuWM=; b=16RXLkaLxr2sDVOJxKa8aCBjp4FVSImL0wc7oVJuJE5HxRKMzafaxE30/pcu2uzpLH 1zCrCYp+ooneSgsYPW7PmSbxn8L8sWX9/WDFWWbbT8ERI+gzP9Lj7O4KsX+5ya86mxhk NUP97qfRj8RnPgPom20xRUlrGigwAVmoCPX3kGDeCsV/BkiIL/GEZVNQzrMPEzMDemPQ dqoAgy+QL0dMlNzJZlOOXuVd3twTpJf1wc7659RTVdH0P/jpmfIdNR05gjpgB4RyNYd0 Zqrk1nHP2ZpE1xOwtFUpIcQOxkQEWe4Sy4NS3n0ccQ45EsF/4oSt8riNY6lbRIzaNOAg 6XTw== X-Gm-Message-State: AO0yUKVLeKpU1NRRgxz245kZoZs6ELbv3sJZN1mGIVsE3darUS3/DYAs bErQzr6nTHM8t63rcHxyNS4= X-Google-Smtp-Source: AK7set9A8ddWDXir4M7hpFzx+8WBWCaIhqs/npzdiCbwJqwSlCWj1tejYJyI1eiuNBMtPBW859lv6w== X-Received: by 2002:a17:907:720b:b0:8b0:26b6:3f2b with SMTP id dr11-20020a170907720b00b008b026b63f2bmr6375987ejc.53.1676207605166; Sun, 12 Feb 2023 05:13:25 -0800 (PST) Received: from arinc9-PC.lan ([37.120.152.236]) by smtp.gmail.com with ESMTPSA id m10-20020a170906580a00b0086f4b8f9e42sm5257880ejq.65.2023.02.12.05.13.23 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 12 Feb 2023 05:13:24 -0800 (PST) From: arinc9.unal@gmail.com X-Google-Original-From: arinc.unal@arinc9.com To: Andrew Lunn , Florian Fainelli , Vladimir Oltean , "David S. Miller" , Eric Dumazet , Jakub Kicinski , Paolo Abeni , Rob Herring , Krzysztof Kozlowski , Matthias Brugger , AngeloGioacchino Del Regno , Landen Chao , DENG Qingfang , Sean Wang Cc: =?UTF-8?q?Ar=C4=B1n=C3=A7=20=C3=9CNAL?= , netdev@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linux-mediatek@lists.infradead.org, erkin.bozoglu@xeront.com Subject: [PATCH] dt-bindings: net: dsa: mediatek,mt7530: improve binding description Date: Sun, 12 Feb 2023 16:12:58 +0300 Message-Id: <20230212131258.47551-1-arinc.unal@arinc9.com> X-Mailer: git-send-email 2.37.2 MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org From: Ar=C4=B1n=C3=A7 =C3=9CNAL Fix inaccurate information about PHY muxing, and merge standalone and multi-chip module MT7530 configuration methods. Signed-off-by: Ar=C4=B1n=C3=A7 =C3=9CNAL Acked-by: Krzysztof Kozlowski --- .../bindings/net/dsa/mediatek,mt7530.yaml | 52 ++++++++----------- 1 file changed, 21 insertions(+), 31 deletions(-) diff --git a/Documentation/devicetree/bindings/net/dsa/mediatek,mt7530.yaml= b/Documentation/devicetree/bindings/net/dsa/mediatek,mt7530.yaml index 08667bff74a5..449ee0735012 100644 --- a/Documentation/devicetree/bindings/net/dsa/mediatek,mt7530.yaml +++ b/Documentation/devicetree/bindings/net/dsa/mediatek,mt7530.yaml @@ -24,56 +24,46 @@ description: | =20 There is only the standalone version of MT7531. =20 - Port 5 on MT7530 has got various ways of configuration. - - For standalone MT7530: + Port 5 on MT7530 has got various ways of configuration: =20 - Port 5 can be used as a CPU port. =20 - - PHY 0 or 4 of the switch can be muxed to connect to the gmac of the = SoC - which port 5 is wired to. Usually used for connecting the wan port - directly to the CPU to achieve 2 Gbps routing in total. + - PHY 0 or 4 of the switch can be muxed to gmac5 of the switch. Theref= ore, + the gmac of the SoC which is wired to port 5 can connect to the PHY. + This is usually used for connecting the wan port directly to the CPU= to + achieve 2 Gbps routing in total. =20 - The driver looks up the reg on the ethernet-phy node which the phy-h= andle - property refers to on the gmac node to mux the specified phy. + The driver looks up the reg on the ethernet-phy node, which the phy-= handle + property on the gmac node refers to, to mux the specified phy. =20 The driver requires the gmac of the SoC to have "mediatek,eth-mac" a= s the - compatible string and the reg must be 1. So, for now, only gmac1 of = an + compatible string and the reg must be 1. So, for now, only gmac1 of a MediaTek SoC can benefit this. Banana Pi BPI-R2 suits this. - Check out example 5 for a similar configuration. - - - Port 5 can be wired to an external phy. Port 5 becomes a DSA slave. - Check out example 7 for a similar configuration. - - For multi-chip module MT7530: - - - Port 5 can be used as a CPU port. - - - PHY 0 or 4 of the switch can be muxed to connect to gmac1 of the SoC. - Usually used for connecting the wan port directly to the CPU to achi= eve 2 - Gbps routing in total. - - The driver looks up the reg on the ethernet-phy node which the phy-h= andle - property refers to on the gmac node to mux the specified phy. =20 For the MT7621 SoCs, rgmii2 group must be claimed with rgmii2 functi= on. + Check out example 5. =20 - - In case of an external phy wired to gmac1 of the SoC, port 5 must no= t be - enabled. + - For the multi-chip module MT7530, in case of an external phy wired to + gmac1 of the SoC, port 5 must not be enabled. =20 In case of muxing PHY 0 or 4, the external phy must not be enabled. =20 For the MT7621 SoCs, rgmii2 group must be claimed with rgmii2 functi= on. + Check out example 6. =20 - - Port 5 can be muxed to an external phy. Port 5 becomes a DSA slave. - The external phy must be wired TX to TX to gmac1 of the SoC for this= to - work. Ubiquiti EdgeRouter X SFP is wired this way. + - Port 5 can be wired to an external phy. Port 5 becomes a DSA slave. + + For the multi-chip module MT7530, the external phy must be wired TX = to TX + to gmac1 of the SoC for this to work. Ubiquiti EdgeRouter X SFP is w= ired + this way. =20 - Muxing PHY 0 or 4 won't work when the external phy is connected TX t= o TX. + For the multi-chip module MT7530, muxing PHY 0 or 4 won't work when = the + external phy is connected TX to TX. =20 For the MT7621 SoCs, rgmii2 group must be claimed with gpio function. + Check out example 7. =20 properties: @@ -601,7 +591,7 @@ examples: label =3D "lan4"; }; =20 - /* Commented out, phy4 is muxed to gmac1. + /* Commented out, phy4 is connected to gmac1. port@4 { reg =3D <4>; label =3D "wan"; --=20 2.37.2