[PATCH net-next v3 1/7] dt-bindings: net: pse-dt: add bindings for generic PSE controller

From: Oleksij Rempel
Date: Sat Aug 27 2022 - 01:11:26 EST


Add binding for generic Ethernet PSE controller.

Signed-off-by: Oleksij Rempel <o.rempel@xxxxxxxxxxxxxx>
---
changes v2:
- rename compatible to more generic "ieee802.3-pse"
- add class and type properties for PoDL and PoE variants
- add pairs property
---
.../bindings/net/pse-pd/generic-pse.yaml | 95 +++++++++++++++++++
1 file changed, 95 insertions(+)
create mode 100644 Documentation/devicetree/bindings/net/pse-pd/generic-pse.yaml

diff --git a/Documentation/devicetree/bindings/net/pse-pd/generic-pse.yaml b/Documentation/devicetree/bindings/net/pse-pd/generic-pse.yaml
new file mode 100644
index 0000000000000..ecd226df66f4e
--- /dev/null
+++ b/Documentation/devicetree/bindings/net/pse-pd/generic-pse.yaml
@@ -0,0 +1,95 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/net/pse-pd/generic-pse.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Generic Power Sourcing Equipment
+
+maintainers:
+ - Oleksij Rempel <o.rempel@xxxxxxxxxxxxxx>
+
+description: Generic PSE controller. The device must be referenced by the PHY
+ node to control power injection to the Ethernet cable.
+
+properties:
+ compatible:
+ const: ieee802.3-pse
+
+ '#pse-cells':
+ const: 0
+
+ ieee802.3-pse-supply:
+ description: Power supply for the PSE controller
+
+ ieee802.3-pairs:
+ $ref: /schemas/types.yaml#/definitions/int8-array
+ description: Array of number of twisted-pairs capable to deliver power.
+ Since not all circuits are able to support all pair variants, the array of
+ supported variants should be specified.
+ Note - single twisted-pair PSE is formally know as PoDL PSE.
+ items:
+ enum: [1, 2, 4]
+
+ ieee802.3-pse-type:
+ $ref: /schemas/types.yaml#/definitions/uint8
+ minimum: 1
+ maximum: 2
+ description: PSE Type. Describes classification- and class-capabilities.
+ Not compatible with PoDL PSE Type.
+ Type 1 - provides a Class 0, 1, 2, or 3 signature during Physical Layer
+ classification.
+ Type 2 - provides a Class 4 signature during Physical Layer
+ classification, understands 2-Event classification, and is capable of
+ Data Link Layer classification.
+
+ ieee802.3-pse-class:
+ $ref: /schemas/types.yaml#/definitions/int8-array
+ items:
+ enum: [0, 1, 2, 3, 4]
+ description: PSE Class. Array of supported classes by the 2 and 4 pair PSE.
+
+ ieee802.3-podl-pse-type:
+ $ref: /schemas/types.yaml#/definitions/string
+ enum: [a, b, c, d, e]
+ description: PoDL PSE Type. Describes compatibility to physical Layer
+ specifications.
+ Type A - cost optimized for 100BASE-T1
+ Type B - cost optimized for 1000BASE-T1
+ Type C - works with 100BASE-T1 and 1000BASE-T1
+ Type D - optimized for 10BASE-T1S
+ Type E - optimized for 10BASE-T1L
+
+ ieee802.3-podl-pse-class:
+ $ref: /schemas/types.yaml#/definitions/int8-array
+ items:
+ enum: [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15]
+ description: PoDL PSE Class. Array of supported classes by the
+ single twisted-pair PoDL PSE.
+
+additionalProperties: false
+
+required:
+ - compatible
+ - '#pse-cells'
+ - ieee802.3-pse-supply
+
+examples:
+ - |
+ pse_t1l2: ethernet-pse-1 {
+ compatible = "ieee802.3-pse";
+ ieee802.3-pse-supply = <&reg_t1l1>;
+ ieee802.3-podl-pse-type = "e";
+ ieee802.3-podl-pse-class = /bits/ 8 <0 1>;
+ ieee802.3-pairs = /bits/ 8 <1>;
+ #pse-cells = <0>;
+ };
+ - |
+ pse_poe: ethernet-pse-2 {
+ compatible = "ieee802.3-pse";
+ ieee802.3-pse-supply = <&reg_poe>;
+ ieee802.3-pairs = /bits/ 8 <2 4>;
+ ieee802.3-pse-type = /bits/ 8 <1>;
+ ieee802.3-pse-class = /bits/ 8 <0 1>;
+ #pse-cells = <0>;
+ };
--
2.30.2