| 1 | |
| 2 | %YAML 1.2
|
| 3 | ---
|
| 4 | $id: http://devicetree.org/schemas/net/pse-pd/pse-controller.yaml#
|
| 5 | $schema: http://devicetree.org/meta-schemas/core.yaml#
|
| 6 |
|
| 7 | title: Power Sourcing Equipment (PSE).
|
| 8 |
|
| 9 | description: Binding for the Power Sourcing Equipment (PSE) as defined in the
|
| 10 | IEEE 802.3 specification. It is designed for hardware which is delivering
|
| 11 | power over twisted pair/ethernet cable. The ethernet-pse nodes should be
|
| 12 | used to describe PSE controller and referenced by the ethernet-phy node.
|
| 13 |
|
| 14 | maintainers:
|
| 15 | - Oleksij Rempel <[email protected]>
|
| 16 | - Kory Maincent <[email protected]>
|
| 17 |
|
| 18 | properties:
|
| 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 be
|
| 25 | 0 on PSE nodes with only a single output and at least 1 on nodes
|
| 26 | controlling several outputs which are not described in the pse-pis
|
| 27 | subnode. This property is deprecated, please use pse-pis instead.
|
| 28 | enum: [0, 1]
|
| 29 |
|
| 30 | pse-pis:
|
| 31 | type: object
|
| 32 | description:
|
| 33 | Overview of the PSE PIs provided by the controller.
|
| 34 |
|
| 35 | properties:
|
| 36 | "#address-cells":
|
| 37 | const: 1
|
| 38 |
|
| 39 | "#size-cells":
|
| 40 | const: 0
|
| 41 |
|
| 42 | required:
|
| 43 | - "#address-cells"
|
| 44 | - "#size-cells"
|
| 45 |
|
| 46 | patternProperties:
|
| 47 | "^pse-pi@[0-9a-f]+$":
|
| 48 | type: object
|
| 49 | description:
|
| 50 | PSE PI for power delivery via pairsets, compliant with IEEE
|
| 51 | 802.3-2022, Section 145.2.4. Each pairset comprises a positive and
|
| 52 | a negative VPSE pair, adhering to the pinout configurations
|
| 53 | 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: 1
|
| 61 |
|
| 62 | "#pse-cells":
|
| 63 | const: 0
|
| 64 |
|
| 65 | pairset-names:
|
| 66 | $ref: /schemas/types.yaml#/definitions/string-array
|
| 67 | 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: 1
|
| 72 | maxItems: 2
|
| 73 | items:
|
| 74 | enum:
|
| 75 | - alternative-a
|
| 76 | - alternative-b
|
| 77 |
|
| 78 | pairsets:
|
| 79 | $ref: /schemas/types.yaml#/definitions/phandle-array
|
| 80 | description:
|
| 81 | List of phandles, each pointing to the power supply for the
|
| 82 | corresponding pairset named in 'pairset-names'. This property
|
| 83 | 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-3)
|
| 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: 1
|
| 98 | maxItems: 2
|
| 99 |
|
| 100 | polarity-supported:
|
| 101 | $ref: /schemas/types.yaml#/definitions/string-array
|
| 102 | description:
|
| 103 | Polarity configuration supported by the PSE PI pairsets.
|
| 104 | minItems: 1
|
| 105 | maxItems: 4
|
| 106 | items:
|
| 107 | enum:
|
| 108 | - MDI-X
|
| 109 | - MDI
|
| 110 | - X
|
| 111 | - S
|
| 112 |
|
| 113 | vpwr-supply:
|
| 114 | description: Regulator power supply for the PSE PI.
|
| 115 |
|
| 116 | required:
|
| 117 | - reg
|
| 118 | - "#pse-cells"
|
| 119 |
|
| 120 | oneOf:
|
| 121 | - required:
|
| 122 | - "#pse-cells"
|
| 123 | - required:
|
| 124 | - pse-pis
|
| 125 |
|
| 126 | additionalProperties: true
|
| 127 |
|
| 128 | ...
|