Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

dt-bindings: pse: tps23881: Clarify channels property description

Improve the channels property description to better explain the
relationship between physical delivery channels and PSE PI pairsets.
The previous description was unclear about how channels are referenced
and used in the port matrix mapping.

Signed-off-by: Kory Maincent <kory.maincent@bootlin.com>
Link: https://patch.msgid.link/20250620-poe_doc_improve-v1-1-96357bb95d52@bootlin.com
Signed-off-by: Paolo Abeni <pabeni@redhat.com>

authored by

Kory Maincent and committed by
Paolo Abeni
42fa8f17 a6a4db16

+6 -4
+6 -4
Documentation/devicetree/bindings/net/pse-pd/ti,tps23881.yaml
··· 30 30 maxItems: 1 31 31 32 32 channels: 33 - description: each set of 8 ports can be assigned to one physical 34 - channels or two for PoE4. This parameter describes the configuration 35 - of the ports conversion matrix that establishes relationship between 36 - the logical ports and the physical channels. 33 + description: | 34 + Defines the 8 physical delivery channels on the controller that can 35 + be referenced by PSE PIs through their "pairsets" property. The actual 36 + port matrix mapping is created when PSE PIs reference these channels in 37 + their pairsets. For 4-pair operation, two channels from the same group 38 + (0-3 or 4-7) must be referenced by a single PSE PI. 37 39 type: object 38 40 additionalProperties: false 39 41