git/linux-nf
1
0
Fork 0
mirror of https://git.kernel.org/pub/scm/linux/kernel/git/netfilter/nf.git synced 2026-04-03 23:38:12 -04:00
Code Issues Packages Projects Releases Wiki Activity

net: pse-pd: tps23881: Clarify setup_pi_matrix callback documentation

Browse Source 
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>
This commit is contained in:
Kory Maincent
2025-06-20 12:02:40 +02:00
committed by Paolo Abeni
parent 42fa8f17e4
commit dad51ea090
1 changed files with 7 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
include/linux/pse-pd/pse.h
View File

@@ -159,7 +159,13 @@ struct ethtool_pse_control_status {
/**
* struct pse_controller_ops - PSE controller driver callbacks
*
* @setup_pi_matrix: setup PI matrix of the PSE controller
* @setup_pi_matrix: Setup PI matrix of the PSE controller.
* The PSE PIs devicetree nodes have already been parsed by
* of_load_pse_pis() and the pcdev->pi[x]->pairset[y].np
* populated. This callback should establish the
* relationship between the PSE controller hardware ports
* and the PSE Power Interfaces, either through software
* mapping or hardware configuration.
* @pi_get_admin_state: Get the operational state of the PSE PI. This ops
* is mandatory.
* @pi_get_pw_status: Get the power detection status of the PSE PI. This