From: Dimitri Fedrau <dimitri.fedrau@liebherr.com>

Add property mac-series-termination-ohms in the device tree bindings for
selecting the resistance value of the builtin series termination resistors
of the PHY. Changing the resistance to an appropriate value can reduce
signal reflections and therefore improve signal quality.

Signed-off-by: Dimitri Fedrau <dimitri.fedrau@liebherr.com>
---
 Documentation/devicetree/bindings/net/ethernet-phy.yaml | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/Documentation/devicetree/bindings/net/ethernet-phy.yaml b/Documentation/devicetree/bindings/net/ethernet-phy.yaml
index 824bbe4333b7ed95cc39737d3c334a20aa890f01..4a710315a83ccf15bfc210ae432ae988cf31e04c 100644
--- a/Documentation/devicetree/bindings/net/ethernet-phy.yaml
+++ b/Documentation/devicetree/bindings/net/ethernet-phy.yaml
@@ -238,6 +238,11 @@ properties:
       peak-to-peak specified in ANSI X3.263. When omitted, the PHYs default
       will be left as is.
 
+  mac-series-termination-ohms:
+    description:
+      The resistance value of the series termination resistor. When omitted, the
+      PHYs default will be left as is.
+
   leds:
     type: object
 

-- 
2.39.5

On Fri, Mar 07, 2025 at 11:30:01AM +0100, Dimitri Fedrau wrote:
> Add property mac-series-termination-ohms in the device tree bindings for
> selecting the resistance value of the builtin series termination resistors
> of the PHY. Changing the resistance to an appropriate value can reduce
> signal reflections and therefore improve signal quality.
> 
> Signed-off-by: Dimitri Fedrau <dimitri.fedrau@liebherr.com>
> ---
>  Documentation/devicetree/bindings/net/ethernet-phy.yaml | 5 +++++
>  1 file changed, 5 insertions(+)
> 
> diff --git a/Documentation/devicetree/bindings/net/ethernet-phy.yaml b/Documentation/devicetree/bindings/net/ethernet-phy.yaml
> index 824bbe4333b7ed95cc39737d3c334a20aa890f01..4a710315a83ccf15bfc210ae432ae988cf31e04c 100644
> --- a/Documentation/devicetree/bindings/net/ethernet-phy.yaml
> +++ b/Documentation/devicetree/bindings/net/ethernet-phy.yaml
> @@ -238,6 +238,11 @@ properties:
>        peak-to-peak specified in ANSI X3.263. When omitted, the PHYs default
>        will be left as is.
>  
> +  mac-series-termination-ohms:

A property of the MAC (or associated with it) should be in the MAC's 
node. Also, sounds like either either end could have a property. We 
already have similar properties in other cases: 'termination-ohms' for 
example. That appears to be for series term as well given a value of 
120ohms. 

Rob

On Tue, Mar 11, 2025 at 12:33:44PM -0500, Rob Herring wrote:
> On Fri, Mar 07, 2025 at 11:30:01AM +0100, Dimitri Fedrau wrote:
> > Add property mac-series-termination-ohms in the device tree bindings for
> > selecting the resistance value of the builtin series termination resistors
> > of the PHY. Changing the resistance to an appropriate value can reduce
> > signal reflections and therefore improve signal quality.
> > 
> > Signed-off-by: Dimitri Fedrau <dimitri.fedrau@liebherr.com>
> > ---
> >  Documentation/devicetree/bindings/net/ethernet-phy.yaml | 5 +++++
> >  1 file changed, 5 insertions(+)
> > 
> > diff --git a/Documentation/devicetree/bindings/net/ethernet-phy.yaml b/Documentation/devicetree/bindings/net/ethernet-phy.yaml
> > index 824bbe4333b7ed95cc39737d3c334a20aa890f01..4a710315a83ccf15bfc210ae432ae988cf31e04c 100644
> > --- a/Documentation/devicetree/bindings/net/ethernet-phy.yaml
> > +++ b/Documentation/devicetree/bindings/net/ethernet-phy.yaml
> > @@ -238,6 +238,11 @@ properties:
> >        peak-to-peak specified in ANSI X3.263. When omitted, the PHYs default
> >        will be left as is.
> >  
> > +  mac-series-termination-ohms:
> 
> A property of the MAC (or associated with it) should be in the MAC's 
> node.

But it is the PHY which uses the property, and the PHY which is
implementing the resistor.

Also, a PHY has two sides, one towards the MAC and a second media side
to the network peer via the Ethernet cable. Both sides need
termination resistors. So we need something in the name to make it
clear which side of the PHY we are talking about. So we might end up
with something like mac-termination-ohms and media-termination-ohms,
in the PHY node.

> Also, sounds like either either end could have a property.

True, the MAC could also need a similar property, since the outputs
from the MAC to the PHY needs termination resistors.  For the MAC,
termination-ohms is probably sufficient, or phy-termination-ohms to
indicate it is towards the PHY?

	Andrew