Re: [PATCH net-next v2 1/2] dt-bindings: net: ethernet-phy: Add master-slave role property for SPE PHYs

From: Florian Fainelli
Date: Mon Sep 09 2024 - 11:56:39 EST


On 9/9/24 05:43, Oleksij Rempel wrote:
Introduce a new `master-slave` string property in the ethernet-phy
binding to specify the link role for Single Pair Ethernet
(1000/100/10Base-T1) PHYs. This property supports the values
`forced-master` and `forced-slave`, which allow the PHY to operate in a
predefined role, necessary when hardware strap pins are unavailable or
wrongly set.

Signed-off-by: Oleksij Rempel <o.rempel@xxxxxxxxxxxxxx>
---
changes v2:
- use string property instead of multiple flags
---
.../devicetree/bindings/net/ethernet-phy.yaml | 14 ++++++++++++++
1 file changed, 14 insertions(+)

diff --git a/Documentation/devicetree/bindings/net/ethernet-phy.yaml b/Documentation/devicetree/bindings/net/ethernet-phy.yaml
index d9b62741a2259..025e59f6be6f3 100644
--- a/Documentation/devicetree/bindings/net/ethernet-phy.yaml
+++ b/Documentation/devicetree/bindings/net/ethernet-phy.yaml
@@ -158,6 +158,20 @@ properties:
Mark the corresponding energy efficient ethernet mode as
broken and request the ethernet to stop advertising it.
+ master-slave:
+ $ref: /schemas/types.yaml#/definitions/string
+ enum:
+ - forced-master
+ - forced-slave
+ description: |
+ Specifies the predefined link role for the PHY in Single Pair Ethernet
+ (1000/100/10Base-T1). This property is required for setups where the link
+ role must be assigned by the device tree due to limitations in using
+ hardware strap pins.

Nit: the way this is implemented right now, this is also applicable to 1000BaseT which is fine, just needs to be called out explicitly IMHO.
--
Florian