mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/chenhuacai/linux-loongson
synced 2025-09-04 10:33:13 +00:00
d1bf27c4e1
The documentation contained an unusual character due to an issue in my personal b4 setup. Fix the problem by providing the correct PSE Pinout Alternatives table number description. Signed-off-by: Kory Maincent <kory.maincent@bootlin.com> Reviewed-by: Simon Horman <horms@kernel.org> Link: https://patch.msgid.link/20250107142659.425877-1-kory.maincent@bootlin.com Signed-off-by: Jakub Kicinski <kuba@kernel.org>
129 lines
4.5 KiB
YAML
129 lines
4.5 KiB
YAML
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/net/pse-pd/pse-controller.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: Power Sourcing Equipment (PSE).
|
|
|
|
description: Binding for the Power Sourcing Equipment (PSE) as defined in the
|
|
IEEE 802.3 specification. It is designed for hardware which is delivering
|
|
power over twisted pair/ethernet cable. The ethernet-pse nodes should be
|
|
used to describe PSE controller and referenced by the ethernet-phy node.
|
|
|
|
maintainers:
|
|
- Oleksij Rempel <o.rempel@pengutronix.de>
|
|
- Kory Maincent <kory.maincent@bootlin.com>
|
|
|
|
properties:
|
|
$nodename:
|
|
pattern: "^ethernet-pse(@.*|-([0-9]|[1-9][0-9]+))?$"
|
|
|
|
"#pse-cells":
|
|
description:
|
|
Used to uniquely identify a PSE instance within an IC. Will be
|
|
0 on PSE nodes with only a single output and at least 1 on nodes
|
|
controlling several outputs which are not described in the pse-pis
|
|
subnode. This property is deprecated, please use pse-pis instead.
|
|
enum: [0, 1]
|
|
|
|
pse-pis:
|
|
type: object
|
|
description:
|
|
Overview of the PSE PIs provided by the controller.
|
|
|
|
properties:
|
|
"#address-cells":
|
|
const: 1
|
|
|
|
"#size-cells":
|
|
const: 0
|
|
|
|
required:
|
|
- "#address-cells"
|
|
- "#size-cells"
|
|
|
|
patternProperties:
|
|
"^pse-pi@[0-9a-f]+$":
|
|
type: object
|
|
description:
|
|
PSE PI for power delivery via pairsets, compliant with IEEE
|
|
802.3-2022, Section 145.2.4. Each pairset comprises a positive and
|
|
a negative VPSE pair, adhering to the pinout configurations
|
|
detailed in the standard.
|
|
See Documentation/networking/pse-pd/pse-pi.rst for details.
|
|
|
|
properties:
|
|
reg:
|
|
description:
|
|
Address describing the PSE PI index.
|
|
maxItems: 1
|
|
|
|
"#pse-cells":
|
|
const: 0
|
|
|
|
pairset-names:
|
|
$ref: /schemas/types.yaml#/definitions/string-array
|
|
description:
|
|
Names of the pairsets as per IEEE 802.3-2022, Section 145.2.4.
|
|
Each name should correspond to a phandle in the 'pairset'
|
|
property pointing to the power supply for that pairset.
|
|
minItems: 1
|
|
maxItems: 2
|
|
items:
|
|
enum:
|
|
- alternative-a
|
|
- alternative-b
|
|
|
|
pairsets:
|
|
$ref: /schemas/types.yaml#/definitions/phandle-array
|
|
description:
|
|
List of phandles, each pointing to the power supply for the
|
|
corresponding pairset named in 'pairset-names'. This property
|
|
aligns with IEEE 802.3-2022, Section 33.2.3 and 145.2.4.
|
|
PSE Pinout Alternatives (as per IEEE 802.3-2022 Table 145-3)
|
|
|-----------|---------------|---------------|---------------|---------------|
|
|
| Conductor | Alternative A | Alternative A | Alternative B | Alternative B |
|
|
| | (MDI-X) | (MDI) | (X) | (S) |
|
|
|-----------|---------------|---------------|---------------|---------------|
|
|
| 1 | Negative VPSE | Positive VPSE | - | - |
|
|
| 2 | Negative VPSE | Positive VPSE | - | - |
|
|
| 3 | Positive VPSE | Negative VPSE | - | - |
|
|
| 4 | - | - | Negative VPSE | Positive VPSE |
|
|
| 5 | - | - | Negative VPSE | Positive VPSE |
|
|
| 6 | Positive VPSE | Negative VPSE | - | - |
|
|
| 7 | - | - | Positive VPSE | Negative VPSE |
|
|
| 8 | - | - | Positive VPSE | Negative VPSE |
|
|
minItems: 1
|
|
maxItems: 2
|
|
|
|
polarity-supported:
|
|
$ref: /schemas/types.yaml#/definitions/string-array
|
|
description:
|
|
Polarity configuration supported by the PSE PI pairsets.
|
|
minItems: 1
|
|
maxItems: 4
|
|
items:
|
|
enum:
|
|
- MDI-X
|
|
- MDI
|
|
- X
|
|
- S
|
|
|
|
vpwr-supply:
|
|
description: Regulator power supply for the PSE PI.
|
|
|
|
required:
|
|
- reg
|
|
- "#pse-cells"
|
|
|
|
oneOf:
|
|
- required:
|
|
- "#pse-cells"
|
|
- required:
|
|
- pse-pis
|
|
|
|
additionalProperties: true
|
|
|
|
...
|