]> git.ipfire.org Git - thirdparty/kernel/linux.git/commit
net: pse-pd: tps23881: Clarify setup_pi_matrix callback documentation
authorKory Maincent <kory.maincent@bootlin.com>
Fri, 20 Jun 2025 10:02:40 +0000 (12:02 +0200)
committerPaolo Abeni <pabeni@redhat.com>
Tue, 24 Jun 2025 08:57:43 +0000 (10:57 +0200)
commitdad51ea09040f9ac2ea2a0f694e5e3ed5cf167b9
tree6f5163e17a14854e921a1ea059a682fa48f3be7b
parent42fa8f17e453ca142d3ed1b2a7b264bf52e8599e
net: pse-pd: tps23881: Clarify setup_pi_matrix callback documentation

Improve the setup_pi_matrix callback documentation to clarify its purpose
and usage. The enhanced description explains that PSE PI devicetree nodes
are pre-parsed before this callback is invoked, and drivers should utilize
pcdev->pi[x]->pairset[y].np to map PSE controller hardware ports to their
corresponding Power Interfaces.

This clarification helps driver implementers understand the callback's
role in establishing the hardware-to-PI relationship mapping.

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