devicetree.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
* [PATCH 1/2] dt-bindings: phy: mediatek,xfi-tphy: add new bindings
@ 2024-02-01 21:52 Daniel Golle
  2024-02-01 21:53 ` [PATCH 2/2] phy: add driver for MediaTek XFI T-PHY Daniel Golle
                   ` (2 more replies)
  0 siblings, 3 replies; 12+ messages in thread
From: Daniel Golle @ 2024-02-01 21:52 UTC (permalink / raw)
  To: Bc-bocun Chen, Steven Liu, John Crispin, Chunfeng Yun, Vinod Koul,
	Kishon Vijay Abraham I, Rob Herring, Krzysztof Kozlowski,
	Conor Dooley, Daniel Golle, Qingfang Deng, SkyLake Huang,
	Matthias Brugger, AngeloGioacchino Del Regno, Philipp Zabel,
	linux-arm-kernel, linux-mediatek, linux-phy, devicetree,
	linux-kernel, netdev

Add bindings for the MediaTek XFI T-PHY Ethernet SerDes PHY found in the
MediaTek MT7988 SoC which can operate at various interfaces modes:

via USXGMII PCS:
 * USXGMII
 * 10GBase-R
 * 5GBase-R

via LynxI SGMII PCS:
 * 2500Base-X
 * 1000Base-X
 * Cisco SGMII (MAC side)

Signed-off-by: Daniel Golle <daniel@makrotopia.org>
---
 .../bindings/phy/mediatek,xfi-tphy.yaml       | 80 +++++++++++++++++++
 1 file changed, 80 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/phy/mediatek,xfi-tphy.yaml

diff --git a/Documentation/devicetree/bindings/phy/mediatek,xfi-tphy.yaml b/Documentation/devicetree/bindings/phy/mediatek,xfi-tphy.yaml
new file mode 100644
index 0000000000000..e897118dcf7e6
--- /dev/null
+++ b/Documentation/devicetree/bindings/phy/mediatek,xfi-tphy.yaml
@@ -0,0 +1,80 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/phy/mediatek,xfi-tphy.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: MediaTek XFI T-PHY
+
+maintainers:
+  - Daniel Golle <daniel@makrotopia.org>
+
+description:
+  The MediaTek XFI SerDes T-PHY provides the physical SerDes lanes
+  used by the (10G/5G) USXGMII PCS and (1G/2.5G) LynxI PCS found in
+  MediaTek's 10G-capabale SoCs.
+
+properties:
+  $nodename:
+    pattern: "^phy@[0-9a-f]+$"
+
+  compatible:
+    const: mediatek,mt7988-xfi-tphy
+
+  reg:
+    maxItems: 1
+
+  clocks:
+    items:
+      - description: XFI PHY clock
+      - description: XFI register clock
+
+  clock-names:
+    items:
+      - const: xfipll
+      - const: topxtal
+
+  resets:
+    items:
+      - description: PEXTP reset
+
+  mediatek,usxgmii-performance-errata:
+    $ref: /schemas/types.yaml#/definitions/flag
+    description:
+      One instance of the T-PHY on MT7988 suffers from a performance
+      problem in 10GBase-R mode which needs a work-around in the driver.
+      The work-around is enabled using this flag.
+
+  "#phy-cells":
+    const: 0
+
+required:
+  - compatible
+  - reg
+  - clocks
+  - clock-names
+  - resets
+  - "#phy-cells"
+
+additionalProperties: false
+
+examples:
+  - |
+    #include <dt-bindings/clock/mediatek,mt7988-clk.h>
+    soc {
+      #address-cells = <2>;
+      #size-cells = <2>;
+
+      phy@11f20000 {
+        compatible = "mediatek,mt7988-xfi-tphy";
+        reg = <0 0x11f20000 0 0x10000>;
+        clocks = <&xfi_pll CLK_XFIPLL_PLL_EN>,
+                 <&topckgen CLK_TOP_XFI_PHY_0_XTAL_SEL>;
+        clock-names = "xfipll", "topxtal";
+        resets = <&watchdog 14>;
+        mediatek,usxgmii-performance-errata;
+        #phy-cells = <0>;
+      };
+    };
+
+...
-- 
2.43.0

^ permalink raw reply related	[flat|nested] 12+ messages in thread

end of thread, other threads:[~2024-02-05 15:29 UTC | newest]

Thread overview: 12+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2024-02-01 21:52 [PATCH 1/2] dt-bindings: phy: mediatek,xfi-tphy: add new bindings Daniel Golle
2024-02-01 21:53 ` [PATCH 2/2] phy: add driver for MediaTek XFI T-PHY Daniel Golle
2024-02-02 13:21   ` AngeloGioacchino Del Regno
2024-02-02 16:33     ` Daniel Golle
2024-02-05 15:26       ` AngeloGioacchino Del Regno
2024-02-04  6:29   ` Chunfeng Yun (云春峰)
2024-02-05 15:29     ` AngeloGioacchino Del Regno
2024-02-02  8:21 ` [PATCH 1/2] dt-bindings: phy: mediatek,xfi-tphy: add new bindings Krzysztof Kozlowski
2024-02-04  6:17   ` Chunfeng Yun (云春峰)
2024-02-05  8:08     ` Krzysztof Kozlowski
2024-02-02 21:24 ` Rob Herring
2024-02-02 21:36   ` Daniel Golle

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).