Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20;
From:   Colin Foster <colin.foster@in-advantage.com>
To:     linux-gpio@vger.kernel.org, linux-kernel@vger.kernel.org,
        devicetree@vger.kernel.org, netdev@vger.kernel.org
Cc:     Russell King <linux@armlinux.org.uk>,
        Linus Walleij <linus.walleij@linaro.org>,
        UNGLinuxDriver@microchip.com,
        Alexandre Belloni <alexandre.belloni@bootlin.com>,
        Claudiu Manoil <claudiu.manoil@nxp.com>,
        Lee Jones <lee@kernel.org>,
        Krzysztof Kozlowski <krzysztof.kozlowski+dt@linaro.org>,
        Rob Herring <robh+dt@kernel.org>,
        Paolo Abeni <pabeni@redhat.com>,
        Jakub Kicinski <kuba@kernel.org>,
        Eric Dumazet <edumazet@google.com>,
        "David S. Miller" <davem@davemloft.net>,
        Vladimir Oltean <olteanv@gmail.com>,
        Florian Fainelli <f.fainelli@gmail.com>,
        Vivien Didelot <vivien.didelot@gmail.com>,
        Andrew Lunn <andrew@lunn.ch>
Subject: [PATCH v3 net-next 12/14] dt-bindings: net: dsa: ocelot: add ocelot-ext documentation
Date:   Sun, 25 Sep 2022 17:29:26 -0700
Message-Id: <20220926002928.2744638-13-colin.foster@in-advantage.com>
In-Reply-To: <20220926002928.2744638-1-colin.foster@in-advantage.com>
References: <20220926002928.2744638-1-colin.foster@in-advantage.com>
Content-Transfer-Encoding: 8bit
Content-Type: text/plain
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?XxjcFSVxfhPaG450/mQHGrhG3E5V41j4yqmp9cNhHXQDmn9IqUSfq52L5VK/?=
 =?us-ascii?Q?MKSgxKMzRB8Fj7krGOUApEJb4XD3kSbUKw7mzXSPC3Agyii+L69BKsvuLJNP?=
 =?us-ascii?Q?0viLvUokvww82OQbnsgH/GoGbKLpiRVg3jEbJtzR+1iCfywzAHnJimkuzMCo?=
 =?us-ascii?Q?5jFAvkt1VyJm1DF37uNg0Axe3lNfFeYLoIPYDaGFMcVcb8zu4BBFDg3wwwTk?=
 =?us-ascii?Q?HUgP1iikhzDY5KmWLIubeiyRSUITJ7okWlK/1eEEsB0kIoTOwRZ84sf+CzTF?=
 =?us-ascii?Q?bBPdYLhvfApOe9IHnkvO2hu0JC1zhMTFNT7LyOuasehKbhg37NZIpCiK76LP?=
 =?us-ascii?Q?SF94U9vvvaD/Gjgc6CySuz3cFGRC3/HgU+ZJFsd7d/PP7D72N6pc3vpVhDer?=
 =?us-ascii?Q?NJrXpE4LWn51R9lbpw6935GzbAyVrua4Qg+ogR/6WFMicjNpo9n03F3TMI0Y?=
 =?us-ascii?Q?Bd3PyivCYFBYl3fVP1xnehuU3LsTWKaKwzPK94YzxUar8OjV96YlOrqOeNSZ?=
 =?us-ascii?Q?VOzRP+9TlSmFp5nd8eam7cQQIL6U0Vszkod1mQmvxLTBoh2V8UYxsI1HM7OX?=
 =?us-ascii?Q?I8g3cgRFyPpomPDz+/Mc7QTipxmGNhR1wnkvEDKSoaljkPhKXTwqnwRZA8e6?=
 =?us-ascii?Q?YWcjIxDXWOUKW2qK+0U4rVcoyEif7Cwyp9cLq8eL/EiyOIi5rlAkChWP9kjx?=
 =?us-ascii?Q?al0lWPYD4K9YzCQGLxYLh9nC8cWosWF6L335UCH8BkwEC/0qwF6u9WIA9hKZ?=
 =?us-ascii?Q?IPdWP4fGNpeK7H1E+PbNAtTIyrepz2zIItGiVBCm2tPzW0L1Gy/YjjKIj2Ku?=
 =?us-ascii?Q?TfjNL0+te2Tawhx9HGYv51kgsFxEjKtvxGRaUO4zFGoPc1xQ191THfwTZl+s?=
 =?us-ascii?Q?42maHqMdnjjcFfnZTbdiF782mHXTwh+tpISKD0y567/wm0bYV9keLx/gR3jZ?=
 =?us-ascii?Q?sggLG8u2BUklcS71M/7HAjQoBdTsQjXDXH9PHfgLZmzQ116bfkVqVrEUej71?=
 =?us-ascii?Q?3DqFVCncI4yHApyZvsqVYxkoRpwxLPoJgU8ThCunqp0S1sxqJXtY7CbFLUy2?=
 =?us-ascii?Q?QmV7e7g0KHpF1Ju/xjNsTA0u13kvmrTBEm7eS0c3ETEvIX7EHLMfIYMmKWEY?=
 =?us-ascii?Q?M80T1NnbcDGkgj0PYrirJpWZAxrt/NU/q/YHoTCuMuc/nSiRIX8QhPxtkQ3B?=
 =?us-ascii?Q?9QXjUNIuIX+tyWfrJHM+Evq1gNHRXv/mYaHsdC8AFxwQTukcA8eyy1gDifWO?=
 =?us-ascii?Q?R4tonA089GtsRp8Yw1gHWcUKnRGMRDLK7poYvcXAnf7LHBoLCVwbP41NPb3a?=
 =?us-ascii?Q?OvEvBU8e2khvgqC1RBxGS9M7sQGas23h+ynKA0sjXfdnmVdd6X1KxlZ6655H?=
 =?us-ascii?Q?is9EWFSTzozG4JneoV9vQRne5kStLI+0rSiLmMmjdKsxtC1lVlHGNBiIAXoO?=
 =?us-ascii?Q?MfbELctiwSiEIoDcIuVZiJC34P3rTLb7pngz99uB4h0WLldbdr9bqu3HF9LX?=
 =?us-ascii?Q?9m3374USQhBxZK2G88xt8YoQsD1HUYw06uJMlJm1v7VFL2jJ6PZ2CZpCRwHN?=
 =?us-ascii?Q?MjTJVWeETXbnKLwblIi+T56h/rSXtLnn7TNnRxJdQ2aoH0Y8Ok8E8Zpfj89m?=
 =?us-ascii?Q?CXMculRVnS8Etvq0UdqLaZs=3D?=
X-OriginatorOrg: in-advantage.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 5d281862-959b-4bef-d8ad-08da9f564e94
X-MS-Exchange-CrossTenant-AuthSource: MWHPR1001MB2351.namprd10.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 26 Sep 2022 00:30:26.2602
 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: 48e842ca-fbd8-4633-a79d-0c955a7d3aae
X-MS-Exchange-CrossTenant-MailboxType: HOSTED
X-MS-Exchange-CrossTenant-UserPrincipalName: nP18DnPNR2sr3MILuGtIMSGGoecgH0m+Puqh0pyq06lbjS4+K7z8UIVHBzpwksDdkVQvXPL3MQi7YrQVcmJ6P0vI5EF+UNSc4kASaH+Yfzo=
X-MS-Exchange-Transport-CrossTenantHeadersStamped: BLAPR10MB4849
X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,DKIM_SIGNED,
        DKIM_VALID,RCVD_IN_DNSWL_NONE,RCVD_IN_MSPIKE_H2,SPF_HELO_PASS,SPF_PASS
        autolearn=ham autolearn_force=no version=3.4.6
X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on
        lindbergh.monkeyblade.net
Precedence: bulk
List-ID: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org

The ocelot-ext driver is another sub-device of the Ocelot / Felix driver
system, which currently supports the four internal copper phys.

Signed-off-by: Colin Foster <colin.foster@in-advantage.com>
---

v3
    * Remove "currently supported" verbage
        The Seville and Felix 9959 all list their supported modes following
        the sentence "The following PHY interface types are supported".
        During V2, I had used "currently supported" to suggest more interface
        modes are around the corner, though this had raised questions.

        The suggestion was to drop the entire sentence. I did leave the
        modified sentence there because it exactly matches the other two
        supported products.

v2
    * New patch

---
 .../bindings/net/dsa/mscc,ocelot.yaml         | 59 +++++++++++++++++++
 1 file changed, 59 insertions(+)

diff --git a/Documentation/devicetree/bindings/net/dsa/mscc,ocelot.yaml b/Documentation/devicetree/bindings/net/dsa/mscc,ocelot.yaml
index 8d93ed9c172c..49450a04e589 100644
--- a/Documentation/devicetree/bindings/net/dsa/mscc,ocelot.yaml
+++ b/Documentation/devicetree/bindings/net/dsa/mscc,ocelot.yaml
@@ -54,9 +54,22 @@ description: |
       - phy-mode = "1000base-x": on ports 0, 1, 2, 3
       - phy-mode = "2500base-x": on ports 0, 1, 2, 3
 
+  VSC7412 (Ocelot-Ext):
+
+    The Ocelot family consists of four devices, the VSC7511, VSC7512, VSC7513,
+    and the VSC7514. The VSC7513 and VSC7514 both have an internal MIPS
+    processor that natively support Linux. Additionally, all four devices
+    support control over external interfaces, SPI and PCIe. The Ocelot-Ext
+    driver is for the external control portion.
+
+    The following PHY interface types are supported:
+
+      - phy-mode = "internal": on ports 0, 1, 2, 3
+
 properties:
   compatible:
     enum:
+      - mscc,vsc7512-switch
       - mscc,vsc9953-switch
       - pci1957,eef0
 
@@ -258,3 +271,49 @@ examples:
             };
         };
     };
+  # Ocelot-ext VSC7512
+  - |
+    spi {
+        soc@0 {
+            compatible = "mscc,vsc7512";
+            #address-cells = <1>;
+            #size-cells = <1>;
+
+            ethernet-switch@0 {
+                compatible = "mscc,vsc7512-switch";
+                reg = <0 0>;
+
+                ethernet-ports {
+                    #address-cells = <1>;
+                    #size-cells = <0>;
+
+                    port@0 {
+                        reg = <0>;
+                        label = "cpu";
+                        ethernet = <&mac_sw>;
+                        phy-handle = <&phy0>;
+                        phy-mode = "internal";
+                    };
+
+                    port@1 {
+                        reg = <1>;
+                        label = "swp1";
+                        phy-mode = "internal";
+                        phy-handle = <&phy1>;
+                    };
+
+                    port@2 {
+                        reg = <2>;
+                        phy-mode = "internal";
+                        phy-handle = <&phy2>;
+                    };
+
+                    port@3 {
+                        reg = <3>;
+                        phy-mode = "internal";
+                        phy-handle = <&phy3>;
+                    };
+                };
+            };
+        };
+    };
-- 
2.25.1