From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-12.8 required=3.0 tests=BAYES_00,DKIM_INVALID, DKIM_SIGNED,HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_PATCH,MAILING_LIST_MULTI, SIGNED_OFF_BY,SPF_HELO_NONE,SPF_PASS,URIBL_BLOCKED,USER_AGENT_GIT autolearn=unavailable autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id A9886C433E8 for ; Tue, 21 Jul 2020 10:04:48 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id 86D4220729 for ; Tue, 21 Jul 2020 10:04:48 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=fail reason="signature verification failed" (2048-bit key) header.d=microchip.com header.i=@microchip.com header.b="EDTaFGVE" Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1729192AbgGUKEr (ORCPT ); Tue, 21 Jul 2020 06:04:47 -0400 Received: from esa4.microchip.iphmx.com ([68.232.154.123]:30678 "EHLO esa4.microchip.iphmx.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726919AbgGUKEq (ORCPT ); Tue, 21 Jul 2020 06:04:46 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=microchip.com; i=@microchip.com; q=dns/txt; s=mchp; t=1595325885; x=1626861885; h=from:to:cc:subject:date:message-id:in-reply-to: references:mime-version:content-transfer-encoding; bh=LOmnsw9iC3qsLnhUejBW18I+VfFv6IlLy/JZ85tkXDA=; b=EDTaFGVEDgrugcOifNLihts2ri4uvwIj6/JueLgcpcBf6Ay+oOWEdTHf roQO0oFXmspxs098et9uB6QhCTYBFra3Gar/O9cM2Tg46kX6H8DU4hu0y M4rimjNvc10zDMbhik9P855dIhAa9VIAFl9S8Xm9fEm+XIPsCRYw3Lymz 7AW244oejjK2zYi/DLwIb+zYx5zmA+x/KnHtXSjlfRxA+6bKukzRLFnCq ClDRamKtCFernY40yDNlgAQqQDCcxH4NJWrQjmQPvL6CfhufoFoYNtnUs CoC/EvDi0pW3v5OBDNlJNZDgLzOQRct+jSdJ5IBdziv4AApWQv1/rWBNZ w==; IronPort-SDR: zZyoZ/SxVwtSNGzApPWj4oo2HX57s/YMElnbCXevHIAwb0mOZ7KGvZM+NcXWJYCBv3tYndj691 UJuNKSpiHSrNSNx3pJvZlLaJ2XtOI08XI1gMZlTjcZ9k4w8c7k3Qm9Il1e0wvbyykEdONMCh4I +VQDdP3gDJrH/4BFjhueZhVjoQteMFH2EiHC2PWwUSYWRuoQfdAsF7Nv/ipWrodkqVRm9EqnE7 TsEUfX93/yfqq0XgbsTzHlzAtTNsc6INp68WJMMPKLVzYArDPHX4UUEKmHwZfewe+GYWcNpCjY HAo= X-IronPort-AV: E=Sophos;i="5.75,378,1589266800"; d="scan'208";a="80694890" Received: from smtpout.microchip.com (HELO email.microchip.com) ([198.175.253.82]) by esa4.microchip.iphmx.com with ESMTP/TLS/AES256-SHA256; 21 Jul 2020 03:04:45 -0700 Received: from chn-vm-ex02.mchp-main.com (10.10.85.144) by chn-vm-ex01.mchp-main.com (10.10.85.143) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.1979.3; Tue, 21 Jul 2020 03:04:06 -0700 Received: from rob-ult-m19940.microchip.com (10.10.115.15) by chn-vm-ex02.mchp-main.com (10.10.85.144) with Microsoft SMTP Server id 15.1.1979.3 via Frontend Transport; Tue, 21 Jul 2020 03:03:40 -0700 From: Codrin Ciubotariu To: , , , CC: , , , , , , , , , "Codrin Ciubotariu" Subject: [PATCH net-next 2/7] macb: bindings doc: use an MDIO node as a container for PHY nodes Date: Tue, 21 Jul 2020 13:02:29 +0300 Message-ID: <20200721100234.1302910-3-codrin.ciubotariu@microchip.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20200721100234.1302910-1-codrin.ciubotariu@microchip.com> References: <20200721100234.1302910-1-codrin.ciubotariu@microchip.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Content-Type: text/plain Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org The MACB driver embeds an MDIO bus controller and for this reason there was no need for an MDIO sub-node present to contain the PHY nodes. Adding MDIO devies directly under an Ethernet node is deprecated, so an MDIO node is included to contain of the PHY nodes (and other MDIO devices' nodes). Signed-off-by: Codrin Ciubotariu --- Documentation/devicetree/bindings/net/macb.txt | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) diff --git a/Documentation/devicetree/bindings/net/macb.txt b/Documentation/devicetree/bindings/net/macb.txt index 0b61a90f1592..88d5199c2279 100644 --- a/Documentation/devicetree/bindings/net/macb.txt +++ b/Documentation/devicetree/bindings/net/macb.txt @@ -32,6 +32,11 @@ Required properties: The MAC address will be determined using the optional properties defined in ethernet.txt. +Optional subnodes: +- mdio : specifies the MDIO bus in the MACB, used as a container for PHY nodes or other + nodes of devices present on the MDIO bus. Please see ethernet-phy.yaml in the same + directory for more details. + Optional properties for PHY child node: - reset-gpios : Should specify the gpio for phy reset - magic-packet : If present, indicates that the hardware supports waking @@ -48,8 +53,12 @@ Examples: local-mac-address = [3a 0e 03 04 05 06]; clock-names = "pclk", "hclk", "tx_clk"; clocks = <&clkc 30>, <&clkc 30>, <&clkc 13>; - ethernet-phy@1 { - reg = <0x1>; - reset-gpios = <&pioE 6 1>; + mdio { + #address-cells = <1>; + #size-cells = <0>; + ethernet-phy@1 { + reg = <0x1>; + reset-gpios = <&pioE 6 1>; + }; }; }; -- 2.25.1 From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-13.0 required=3.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_PATCH, MAILING_LIST_MULTI,SIGNED_OFF_BY,SPF_HELO_NONE,SPF_PASS,URIBL_BLOCKED, USER_AGENT_GIT autolearn=unavailable autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 7524BC433E0 for ; Tue, 21 Jul 2020 10:05:53 +0000 (UTC) Received: from merlin.infradead.org (merlin.infradead.org [205.233.59.134]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id 416F620771 for ; Tue, 21 Jul 2020 10:05:53 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (2048-bit key) header.d=lists.infradead.org header.i=@lists.infradead.org header.b="FSb1yE/A"; dkim=fail reason="signature verification failed" (2048-bit key) header.d=microchip.com header.i=@microchip.com header.b="KcaaP+RK" DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 416F620771 Authentication-Results: mail.kernel.org; dmarc=fail (p=quarantine dis=none) header.from=microchip.com Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=merlin.20170209; h=Sender:Content-Transfer-Encoding: Content-Type:Cc:List-Subscribe:List-Help:List-Post:List-Archive: List-Unsubscribe:List-Id:MIME-Version:References:In-Reply-To:Message-ID:Date: Subject:To:From:Reply-To:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Owner; bh=BQqMHXMHF/q/BoeuApG/CdsDKEiJicSpmHIgpRChex0=; b=FSb1yE/AEhTzCXNYb2Cg8vThi voEFO7YBpB/v6WMBDhPfdYXisvVwWUWsSr+dvhXyDiwKRWoDSsXURjg5SEADcb2BbC4RJ+/tF0qna hC51Z0bUbKe9bDFog59xOpt+fmAdi4X5uFnNr2kUB0bX8Gb8J1TOnveP9/CALPSX/AFnpfIQYkCXP E7ZiOJMVWQHmpi8RbtsnUGHPbsmF5WMEV8HdqK34Q7ud5MOa/aFVMWRbI20SZx1MfrEJcm4nhTDZ7 nnHTaL/mj3sKxHzQk9pO6UjcQkxNzL3hi8/WDuMqlmZ4lWbEtJ36Iu6OmmTlyKGPHKMSI3Aj3++5r B1dkY4O6g==; Received: from localhost ([::1] helo=merlin.infradead.org) by merlin.infradead.org with esmtp (Exim 4.92.3 #3 (Red Hat Linux)) id 1jxp8i-0005Rk-37; Tue, 21 Jul 2020 10:04:48 +0000 Received: from esa4.microchip.iphmx.com ([68.232.154.123]) by merlin.infradead.org with esmtps (Exim 4.92.3 #3 (Red Hat Linux)) id 1jxp8g-0005R5-8U for linux-arm-kernel@lists.infradead.org; Tue, 21 Jul 2020 10:04:46 +0000 DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=microchip.com; i=@microchip.com; q=dns/txt; s=mchp; t=1595325886; x=1626861886; h=from:to:cc:subject:date:message-id:in-reply-to: references:mime-version:content-transfer-encoding; bh=LOmnsw9iC3qsLnhUejBW18I+VfFv6IlLy/JZ85tkXDA=; b=KcaaP+RKWL1JOiyrv+dKEAYsweNEJYqp5k967wtUJvT754VZ6KnVydsI taI1JgW4Gta6K5JMg1F4YWn6xSH4qi2w4/6LSpx2U92PkcrZn5YoTMRuX 85qbmNkGbK0NmTyZ4FCoO7Q/1MBxEeelRfJSeOlXuKbX1EF2cl8BoDaOm p1iojYOFd0+Es0Vx7wIncRw60LWFDNQn6SIAwQuq5TUB4L24bWQ9JoJhz arA0jRMtpb3cx+lZPMYBOcUpvoZeLDM3Vh/jYo5x4kPOhEENk2kbBnVA1 e9dgPoAQgIfDISqgIXl7nxNnYPjbqpX3zCPJw2PPQ7b8pbs+Eb1s+pmJu Q==; IronPort-SDR: zZyoZ/SxVwtSNGzApPWj4oo2HX57s/YMElnbCXevHIAwb0mOZ7KGvZM+NcXWJYCBv3tYndj691 UJuNKSpiHSrNSNx3pJvZlLaJ2XtOI08XI1gMZlTjcZ9k4w8c7k3Qm9Il1e0wvbyykEdONMCh4I +VQDdP3gDJrH/4BFjhueZhVjoQteMFH2EiHC2PWwUSYWRuoQfdAsF7Nv/ipWrodkqVRm9EqnE7 TsEUfX93/yfqq0XgbsTzHlzAtTNsc6INp68WJMMPKLVzYArDPHX4UUEKmHwZfewe+GYWcNpCjY HAo= X-IronPort-AV: E=Sophos;i="5.75,378,1589266800"; d="scan'208";a="80694890" Received: from smtpout.microchip.com (HELO email.microchip.com) ([198.175.253.82]) by esa4.microchip.iphmx.com with ESMTP/TLS/AES256-SHA256; 21 Jul 2020 03:04:45 -0700 Received: from chn-vm-ex02.mchp-main.com (10.10.85.144) by chn-vm-ex01.mchp-main.com (10.10.85.143) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.1979.3; Tue, 21 Jul 2020 03:04:06 -0700 Received: from rob-ult-m19940.microchip.com (10.10.115.15) by chn-vm-ex02.mchp-main.com (10.10.85.144) with Microsoft SMTP Server id 15.1.1979.3 via Frontend Transport; Tue, 21 Jul 2020 03:03:40 -0700 From: Codrin Ciubotariu To: , , , Subject: [PATCH net-next 2/7] macb: bindings doc: use an MDIO node as a container for PHY nodes Date: Tue, 21 Jul 2020 13:02:29 +0300 Message-ID: <20200721100234.1302910-3-codrin.ciubotariu@microchip.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20200721100234.1302910-1-codrin.ciubotariu@microchip.com> References: <20200721100234.1302910-1-codrin.ciubotariu@microchip.com> MIME-Version: 1.0 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20200721_060446_420973_31BB7B2E X-CRM114-Status: UNSURE ( 7.68 ) X-CRM114-Notice: Please train this message. X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: andrew@lunn.ch, alexandre.belloni@bootlin.com, f.fainelli@gmail.com, claudiu.beznea@microchip.com, ludovic.desroches@microchip.com, robh+dt@kernel.org, kuba@kernel.org, Codrin Ciubotariu , davem@davemloft.net Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org The MACB driver embeds an MDIO bus controller and for this reason there was no need for an MDIO sub-node present to contain the PHY nodes. Adding MDIO devies directly under an Ethernet node is deprecated, so an MDIO node is included to contain of the PHY nodes (and other MDIO devices' nodes). Signed-off-by: Codrin Ciubotariu --- Documentation/devicetree/bindings/net/macb.txt | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) diff --git a/Documentation/devicetree/bindings/net/macb.txt b/Documentation/devicetree/bindings/net/macb.txt index 0b61a90f1592..88d5199c2279 100644 --- a/Documentation/devicetree/bindings/net/macb.txt +++ b/Documentation/devicetree/bindings/net/macb.txt @@ -32,6 +32,11 @@ Required properties: The MAC address will be determined using the optional properties defined in ethernet.txt. +Optional subnodes: +- mdio : specifies the MDIO bus in the MACB, used as a container for PHY nodes or other + nodes of devices present on the MDIO bus. Please see ethernet-phy.yaml in the same + directory for more details. + Optional properties for PHY child node: - reset-gpios : Should specify the gpio for phy reset - magic-packet : If present, indicates that the hardware supports waking @@ -48,8 +53,12 @@ Examples: local-mac-address = [3a 0e 03 04 05 06]; clock-names = "pclk", "hclk", "tx_clk"; clocks = <&clkc 30>, <&clkc 30>, <&clkc 13>; - ethernet-phy@1 { - reg = <0x1>; - reset-gpios = <&pioE 6 1>; + mdio { + #address-cells = <1>; + #size-cells = <0>; + ethernet-phy@1 { + reg = <0x1>; + reset-gpios = <&pioE 6 1>; + }; }; }; -- 2.25.1 _______________________________________________ linux-arm-kernel mailing list linux-arm-kernel@lists.infradead.org http://lists.infradead.org/mailman/listinfo/linux-arm-kernel