Lines Matching +full:c +full:- +full:phy

1 .. SPDX-License-Identifier: GPL-2.0
5 PHY link topology
11 The PHY link topology representation in the networking stack aims at representing
15 :c:type:`struct net_device <net_device>`, which exposes configuration options
19   +-----------------------+        +----------+      +--------------+
21   |       MAC             | ------ |   PHY    | ---- |    Port      | ---... to LP
22   +-----------------------+        +----------+      +--------------+
25 Commands that needs to configure the PHY will go through the net_device.phydev
26 field to reach the PHY and perform the relevant configuration.
37   +-----+  SGMII  +------------+
38   | MAC | ------- | SFP Module |
39   +-----+         +------------+
41 Knowing that some modules embed a PHY, the actual link is more like ::
43   +-----+  SGMII   +--------------+
44   | MAC | -------- | PHY (on SFP) |
45   +-----+          +--------------+
47 In this case, the SFP PHY is handled by phylib, and registered by phylink through
52 as media-converters, to translate the non-serialized MAC MII interface to a
55   +-----+  RGMII  +-----------------------+  SGMII  +--------------+
56   | MAC | ------- | PHY (media converter) | ------- | PHY (on SFP) |
57   +-----+         +-----------------------+         +--------------+
63 PHY on the link, for use by both kernel drivers and subsystems, but also to
70 The :c:type:`struct phy_link_topology <phy_link_topology>` is a per-netdevice
74 :c:func:`phy_link_topo_add_phy`
76 Besides registering the PHY to the topology, this call will also assign a unique
77 index to the PHY, which can then be reported to userspace to refer to this PHY
79 0 is reserved to indicate the PHY doesn't belong to any topology yet.
81 The PHY can then be removed from the topology through
83 :c:func:`phy_link_topo_del_phy`
86 are linked to a net_device through :c:func:`phy_attach_direct` will automatically
90 upstream is phylink (so, no media-converter).
92 PHY drivers that can be used as SFP upstream need to call :c:func:`phy_sfp_attach_phy`
93 and :c:func:`phy_sfp_detach_phy`, which can be used as a
95 :c:type:`struct sfp_upstream_ops <sfp_upstream_ops>`.
101 see ``Documentation/networking/ethtool-netlink.rst``.
104 field in :c:type:`struct phy_device <phy_device>`. This index is reported to
113 * ``ETHTOOL_MSG_STRSET_GET`` to get the stats string set from a given PHY
115   cable testing on a given PHY on the link (most likely the outermost PHY)
116 * ``ETHTOOL_MSG_PSE_SET`` and ``ETHTOOL_MSG_PSE_GET`` for PHY-controlled PoE and PSE settings
120 Note that the PHY index can be passed to other requests, which will silently