ethtool: Expand Ethernet Power Equipment with c33 (PoE) alongside PoDL
authorKory Maincent (Dent Project) <kory.maincent@bootlin.com>
Wed, 17 Apr 2024 14:39:49 +0000 (16:39 +0200)
committerJakub Kicinski <kuba@kernel.org>
Fri, 19 Apr 2024 01:27:01 +0000 (18:27 -0700)
commitb58be8db6327b21e0c7fbee559b8eb47f5110efe
tree655a637e238df3aafbe3e3a6ec31dc315b6befac
parent80d953c8326242d46e885cc58c9619c340f4fcf6
ethtool: Expand Ethernet Power Equipment with c33 (PoE) alongside PoDL

In the current PSE interface for Ethernet Power Equipment, support is
limited to PoDL. This patch extends the interface to accommodate the
objects specified in IEEE 802.3-2022 145.2 for Power sourcing
Equipment (PSE).

The following objects are now supported and considered mandatory:
- IEEE 802.3-2022 30.9.1.1.5 aPSEPowerDetectionStatus
- IEEE 802.3-2022 30.9.1.1.2 aPSEAdminState
- IEEE 802.3-2022 30.9.1.2.1 aPSEAdminControl

To avoid confusion between "PoDL PSE" and "PoE PSE", which have similar
names but distinct values, we have followed the suggestion of Oleksij
Rempel and Andrew Lunn to maintain separate naming schemes for each,
using c33 (clause 33) prefix for "PoE PSE".
You can find more details in the discussion threads here:
https://lore.kernel.org/netdev/20230912110637.GI780075@pengutronix.de/
https://lore.kernel.org/netdev/2539b109-72ad-470a-9dae-9f53de4f64ec@lunn.ch/

Reviewed-by: Andrew Lunn <andrew@lunn.ch>
Reviewed-by: Oleksij Rempel <o.rempel@pengutronix.de>
Signed-off-by: Kory Maincent <kory.maincent@bootlin.com>
Link: https://lore.kernel.org/r/20240417-feature_poe-v9-1-242293fd1900@bootlin.com
Signed-off-by: Jakub Kicinski <kuba@kernel.org>
Documentation/networking/index.rst
Documentation/networking/pse-pd/index.rst [new file with mode: 0644]
Documentation/networking/pse-pd/introduction.rst [new file with mode: 0644]
include/linux/pse-pd/pse.h
include/uapi/linux/ethtool.h
include/uapi/linux/ethtool_netlink.h