[net-next PATCH v3 1/4] dt-bindings: net: phy: Document new LEDs active-low property

From: Christian Marangi
Date: Wed Dec 13 2023 - 06:13:40 EST


Document new LEDs active-low property to define if the LED require to be
set low to be turned on.

active-low can be defined in the leds node for PHY that apply the LED
polarity globally for each attached LED or in the specific led node for
PHY that supports setting the LED polarity per LED.

Declaring both way is not supported and will result in the schema
getting rejected.

Signed-off-by: Christian Marangi <ansuelsmth@xxxxxxxxx>
---
Changes v3:
- Out of RFC
Changes v2:
- Add this patch

.../devicetree/bindings/net/ethernet-phy.yaml | 20 +++++++++++++++++++
1 file changed, 20 insertions(+)

diff --git a/Documentation/devicetree/bindings/net/ethernet-phy.yaml b/Documentation/devicetree/bindings/net/ethernet-phy.yaml
index 8fb2a6ee7e5b..9cb3981fed2a 100644
--- a/Documentation/devicetree/bindings/net/ethernet-phy.yaml
+++ b/Documentation/devicetree/bindings/net/ethernet-phy.yaml
@@ -213,6 +213,11 @@ properties:
'#size-cells':
const: 0

+ 'active-low':
+ type: boolean
+ description:
+ This define whether all LEDs needs to be low to be turned on.
+
patternProperties:
'^led@[a-f0-9]+$':
$ref: /schemas/leds/common.yaml#
@@ -225,11 +230,26 @@ properties:
driver dependent and required for ports that define multiple
LED for the same port.

+ 'active-low':
+ type: boolean
+ description:
+ This define whether the LED needs to be low to be turned on.
+
required:
- reg

unevaluatedProperties: false

+ allOf:
+ - if:
+ required:
+ - active-low
+ then:
+ patternProperties:
+ '^led@[a-f0-9]+$':
+ properties:
+ 'active-low': false
+
additionalProperties: false

required:
--
2.40.1