[PATCH net-next v3 1/7] dt-bindings: net: pse-dt: add bindings for generic PSE controller
From: Oleksij Rempel <o.rempel@pengutronix.de>
Date: 2022-08-27 05:11:26
Also in:
linux-doc, lkml, netdev
Subsystem:
networking drivers, open firmware and flattened device tree bindings, pse network driver, the rest · Maintainers:
Andrew Lunn, "David S. Miller", Eric Dumazet, Jakub Kicinski, Paolo Abeni, Rob Herring, Krzysztof Kozlowski, Conor Dooley, Oleksij Rempel, Kory Maincent, Linus Torvalds
Add binding for generic Ethernet PSE controller. Signed-off-by: Oleksij Rempel <o.rempel@pengutronix.de> --- 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@pengutronix.de> + +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 = <®_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 = <®_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