From patchwork Tue Jul 21 10:02:29 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Codrin Ciubotariu X-Patchwork-Id: 11675291 Return-Path: Received: from mail.kernel.org (pdx-korg-mail-1.web.codeaurora.org [172.30.200.123]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id C50196C1 for ; Tue, 21 Jul 2020 10:05:56 +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 9CE6320771 for ; Tue, 21 Jul 2020 10:05:56 +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 9CE6320771 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+patchwork-linux-arm=patchwork.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-Spam-Score: -2.5 (--) X-Spam-Report: SpamAssassin version 3.4.4 on merlin.infradead.org summary: Content analysis details: (-2.5 points) pts rule name description ---- ---------------------- -------------------------------------------------- -2.3 RCVD_IN_DNSWL_MED RBL: Sender listed at https://www.dnswl.org/, medium trust [68.232.154.123 listed in list.dnswl.org] 0.0 RCVD_IN_MSPIKE_H3 RBL: Good reputation (+3) [68.232.154.123 listed in wl.mailspike.net] -0.0 SPF_HELO_PASS SPF: HELO matches SPF record -0.0 SPF_PASS SPF: sender matches SPF record -0.1 DKIM_VALID Message has at least one valid DKIM or DK signature -0.1 DKIM_VALID_AU Message has a valid DKIM or DK signature from author's domain 0.1 DKIM_SIGNED Message has a DKIM or DK signature, not necessarily valid -0.1 DKIM_VALID_EF Message has a valid DKIM or DK signature from envelope-from domain 0.0 RCVD_IN_MSPIKE_WL Mailspike good senders 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 Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+patchwork-linux-arm=patchwork.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>; + }; }; };