129 lines · yaml
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)2%YAML 1.23---4$id: http://devicetree.org/schemas/net/pse-pd/pse-controller.yaml#5$schema: http://devicetree.org/meta-schemas/core.yaml#6 7title: Power Sourcing Equipment (PSE).8 9description: Binding for the Power Sourcing Equipment (PSE) as defined in the10 IEEE 802.3 specification. It is designed for hardware which is delivering11 power over twisted pair/ethernet cable. The ethernet-pse nodes should be12 used to describe PSE controller and referenced by the ethernet-phy node.13 14maintainers:15 - Oleksij Rempel <o.rempel@pengutronix.de>16 - Kory Maincent <kory.maincent@bootlin.com>17 18properties:19 $nodename:20 pattern: "^ethernet-pse(@.*|-([0-9]|[1-9][0-9]+))?$"21 22 "#pse-cells":23 description:24 Used to uniquely identify a PSE instance within an IC. Will be25 0 on PSE nodes with only a single output and at least 1 on nodes26 controlling several outputs which are not described in the pse-pis27 subnode. This property is deprecated, please use pse-pis instead.28 enum: [0, 1]29 30 pse-pis:31 type: object32 description:33 Overview of the PSE PIs provided by the controller.34 35 properties:36 "#address-cells":37 const: 138 39 "#size-cells":40 const: 041 42 required:43 - "#address-cells"44 - "#size-cells"45 46 patternProperties:47 "^pse-pi@[0-9a-f]+$":48 type: object49 description:50 PSE PI for power delivery via pairsets, compliant with IEEE51 802.3-2022, Section 145.2.4. Each pairset comprises a positive and52 a negative VPSE pair, adhering to the pinout configurations53 detailed in the standard.54 See Documentation/networking/pse-pd/pse-pi.rst for details.55 56 properties:57 reg:58 description:59 Address describing the PSE PI index.60 maxItems: 161 62 "#pse-cells":63 const: 064 65 pairset-names:66 $ref: /schemas/types.yaml#/definitions/string-array67 description:68 Names of the pairsets as per IEEE 802.3-2022, Section 145.2.4.69 Each name should correspond to a phandle in the 'pairset'70 property pointing to the power supply for that pairset.71 minItems: 172 maxItems: 273 items:74 enum:75 - alternative-a76 - alternative-b77 78 pairsets:79 $ref: /schemas/types.yaml#/definitions/phandle-array80 description:81 List of phandles, each pointing to the power supply for the82 corresponding pairset named in 'pairset-names'. This property83 aligns with IEEE 802.3-2022, Section 33.2.3 and 145.2.4.84 PSE Pinout Alternatives (as per IEEE 802.3-2022 Table 145\u20133)85 |-----------|---------------|---------------|---------------|---------------|86 | Conductor | Alternative A | Alternative A | Alternative B | Alternative B |87 | | (MDI-X) | (MDI) | (X) | (S) |88 |-----------|---------------|---------------|---------------|---------------|89 | 1 | Negative VPSE | Positive VPSE | - | - |90 | 2 | Negative VPSE | Positive VPSE | - | - |91 | 3 | Positive VPSE | Negative VPSE | - | - |92 | 4 | - | - | Negative VPSE | Positive VPSE |93 | 5 | - | - | Negative VPSE | Positive VPSE |94 | 6 | Positive VPSE | Negative VPSE | - | - |95 | 7 | - | - | Positive VPSE | Negative VPSE |96 | 8 | - | - | Positive VPSE | Negative VPSE |97 minItems: 198 maxItems: 299 100 polarity-supported:101 $ref: /schemas/types.yaml#/definitions/string-array102 description:103 Polarity configuration supported by the PSE PI pairsets.104 minItems: 1105 maxItems: 4106 items:107 enum:108 - MDI-X109 - MDI110 - X111 - S112 113 vpwr-supply:114 description: Regulator power supply for the PSE PI.115 116 required:117 - reg118 - "#pse-cells"119 120oneOf:121 - required:122 - "#pse-cells"123 - required:124 - pse-pis125 126additionalProperties: true127 128...129