From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from out28-2.mail.aliyun.com (out28-2.mail.aliyun.com [115.124.28.2]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 29BA338F93B; Fri, 2 Oct 2026 15:30:49 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=115.124.28.2 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1790955054; cv=none; b=IQekmLAbvIaXUrS2gjvLFUlvGusPLj8MIoErdrvDT7wlMs6NZucPL61vENtbZEWdyr4t6pam57gd0ePf/dHWk47iOrhxnHlVHh6jIO9lSMVTVDwvecK+5HAWaDPyW4/QvpihcAGuXzD5miFC+ycBDNu09OBFSVTdMcMgFTLcI8I= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1790955054; c=relaxed/simple; bh=iFDZbYNwRbaLsSSqKtIpcvoFerU/QQT98MpCBkhGANs=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version; b=M66tJyMmCZN1+HYnaQh6MR0HnNOIse3XPwanaA5xe/ZHgPVFTzTPd2LeEyfiN0QUdtm8BT1uma8dK3ZJAyKT49rKJEbKcGAghX5bfvoig2lLm8suVbqW0Ht6Bon1Gm+oUswJuEJIqpNWDMkkW6FdEaedYeRIsVE8xuCvgeFbD94= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=motor-comm.com; spf=pass smtp.mailfrom=motor-comm.com; arc=none smtp.client-ip=115.124.28.2 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=motor-comm.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=motor-comm.com X-Alimail-AntiSpam:AC=CONTINUE;BC=0.07441826|-1;CH=green;DM=|CONTINUE|false|;DS=CONTINUE|ham_regular_dialog|0.04611-0.00409288-0.949797;FP=16204400867606070449|14|2|17|0|-1|-1|-1;HT=maildocker-contentspam033022149254;MF=kyle.switch@motor-comm.com;NM=1;PH=DS;RN=18;RT=18;SR=0;TI=SMTPD_---.jTkAIZF_1790955038; Received: from motor-comm.com(mailfrom:kyle.switch@motor-comm.com fp:SMTPD_---.jTkAIZF_1790955038 cluster:ay29) by smtp.aliyun-inc.com; Fri, 02 Oct 2026 23:30:39 +0800 From: Kyle Switch To: andrew+netdev@lunn.ch, davem@davemloft.net, edumazet@google.com, kuba@kernel.org, pabeni@redhat.com, robh@kernel.org, krzk+dt@kernel.org, conor+dt@kernel.org, andrew@lunn.ch, hkallweit1@gmail.com, linux@armlinux.org.uk, Frank.Sae@motor-comm.com, netdev@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org Cc: ming.xu@motor-comm.com, xiaolin.xu@motor-comm.com, jianmin.wang@motor-comm.com Subject: [PATCH net-next v24 1/3] dt-bindings: net: Document Motorcomm YT8824 PHY package Date: Fri, 2 Oct 2026 23:30:32 +0800 Message-Id: <20261002153034.934814-2-kyle.switch@motor-comm.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20261002153034.934814-1-kyle.switch@motor-comm.com> References: <20261002153034.934814-1-kyle.switch@motor-comm.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Motorcomm YT8824 Ethernet PHY is PHY package of 4 PHY-s. Signed-off-by: Kyle Switch --- .../bindings/net/motorcomm,yt8824.yaml | 78 +++++++++++++++++++ MAINTAINERS | 2 + 2 files changed, 80 insertions(+) create mode 100644 Documentation/devicetree/bindings/net/motorcomm,yt8824.yaml diff --git a/Documentation/devicetree/bindings/net/motorcomm,yt8824.yaml b/Documentation/devicetree/bindings/net/motorcomm,yt8824.yaml new file mode 100644 index 000000000000..4c67f8afcf27 --- /dev/null +++ b/Documentation/devicetree/bindings/net/motorcomm,yt8824.yaml @@ -0,0 +1,78 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/net/motorcomm,yt8824.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: MotorComm YT8824 Ethernet PHY + +maintainers: + - Kyle Switch + +description: + Motorcomm YT8824 Ethernet PHY is a PHY package of 4 PHYs. + +$ref: ethernet-phy-package.yaml# + +properties: + compatible: + enum: + - motorcomm,yt8824-package + + motorcomm,package-mode: + description: | + PHY package can be configured in 2 modes: + - internal: YT8824 is embedded in the switch, using + an internal interface to the MAC. + - 10g-qxgmii: YT8824 is a standalone external PHY, + connected via 10G QXGMII. + $ref: /schemas/types.yaml#/definitions/string + enum: [ internal, 10g-qxgmii ] + + reg: + description: + The absolute MDIO address of the YT8824 shared top extend + register block. + For internal mode, this is fixed at 9; + For external mode, it is the base MDIO address of the four + member PHYs plus 4, where base is typically 0x0. + Note that this is NOT the reg of the first member PHY. + +required: + - compatible + - motorcomm,package-mode + - reg + +unevaluatedProperties: false + +examples: + - | + mdio { + #address-cells = <1>; + #size-cells = <0>; + + ethernet-phy-package@9 { + #address-cells = <1>; + #size-cells = <0>; + compatible = "motorcomm,yt8824-package"; + reg = <9>; + + motorcomm,package-mode = "internal"; + + ethernet-phy@4 { + reg = <4>; + }; + + ethernet-phy@5 { + reg = <5>; + }; + + ethernet-phy@6 { + reg = <6>; + }; + + ethernet-phy@7 { + reg = <7>; + }; + }; + }; diff --git a/MAINTAINERS b/MAINTAINERS index 3011f995437f..d81560893a56 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -18426,8 +18426,10 @@ F: drivers/net/ethernet/stmicro/stmmac/dwmac-motorcomm.c MOTORCOMM PHY DRIVER M: Frank +M: Kyle Switch L: netdev@vger.kernel.org S: Maintained +F: Documentation/devicetree/bindings/net/motorcomm,yt8824.yaml F: Documentation/devicetree/bindings/net/motorcomm,yt8xxx.yaml F: drivers/net/phy/motorcomm.c -- 2.25.1