Lines Matching +full:mac +full:- +full:s
1 .. SPDX-License-Identifier: GPL-2.0
10 phylink is a mechanism to support hot-pluggable networking modules
11 directly connected to a MAC without needing to re-initialise the
12 adapter on hot-plug events.
14 phylink supports conventional phylib-based setups, fixed link setups
26 the PHY, and pass them to the MAC driver. We expect the MAC driver
32 Fixed mode is the same as PHY mode as far as the MAC driver is
35 3. In-band mode
37 In-band mode is used with 802.3z, SGMII and similar interface modes,
38 and we are expecting to use and honor the in-band negotiation or
43 .. code-block:: none
47 phy-mode = "sgmii";
50 does not use in-band SGMII signalling. The PHY is expected to follow
55 .. code-block:: none
58 managed = "in-band-status";
60 phy-mode = "sgmii";
63 uses in-band mode, where results from the PHY's negotiation are passed
64 to the MAC through the SGMII control word, and the MAC is expected to
66 :c:func:`mac_link_down` functions must not force the MAC side link
76 1. Optionally split the network driver's phylib update function into
77 two parts dealing with link-down and link-up. This can be done as
82 link-up part now includes configuring the MAC for the link settings.
94 in the driver's Kconfig stanza.
100 to the driver's list of header files.
107 to the driver's private data structure. We shall refer to the
108 driver's private data pointer as ``priv`` below, and the driver's
113 .. flat-table::
114 :header-rows: 1
116 :stub-columns: 0
118 * - Original function
119 - Replacement function
120 * - phy_start(phydev)
121 - phylink_start(priv->phylink)
122 * - phy_stop(phydev)
123 - phylink_stop(priv->phylink)
124 * - phy_mii_ioctl(phydev, ifr, cmd)
125 - phylink_mii_ioctl(priv->phylink, ifr, cmd)
126 * - phy_ethtool_get_wol(phydev, wol)
127 - phylink_ethtool_get_wol(priv->phylink, wol)
128 * - phy_ethtool_set_wol(phydev, wol)
129 - phylink_ethtool_set_wol(priv->phylink, wol)
130 * - phy_disconnect(phydev)
131 - phylink_disconnect_phy(priv->phylink)
139 .. code-block:: c
146 return phylink_ethtool_ksettings_set(priv->phylink, cmd);
154 return phylink_ethtool_ksettings_get(priv->phylink, cmd);
163 err = phylink_of_phy_connect(priv->phylink, node, flags);
176 This function is replaced by a different form of MAC updates
179 Manipulation of the PHY's supported/advertised happens within phylink
186 Finally, note that the MAC driver has no direct access to the PHY
197 It is important that if in-band negotiation is used,
199 in-band negotiation from completing, since these functions are called
200 when the in-band link state changes - otherwise the link will never
204 and ``state->advertising`` with the supported ethtool link modes.
209 from the MAC, and report back the settings that the MAC is currently
210 using. This is particularly important for in-band negotiation
211 methods such as 1000base-X and SGMII.
213 The :c:func:`mac_link_up` method is used to inform the MAC that the
217 should be used to configure the MAC when the MAC and PCS are not
218 tightly integrated, or when the settings are not coming from in-band
221 The :c:func:`mac_config` method is used to update the MAC with the
223 when making changes to the MAC configuration. This means the
225 absolutely necessary to change the MAC configuration. An example
236 .. code-block:: c
239 priv->phylink_config.dev = &dev.dev;
240 priv->phylink_config.type = PHYLINK_NETDEV;
242 phylink = phylink_create(&priv->phylink_config, node, phy_mode, &phylink_ops);
248 priv->phylink = phylink;
253 .. code-block:: c
255 phylink_destroy(priv->phylink);
257 10. Arrange for MAC link state interrupts to be forwarded into
260 .. code-block:: c
262 phylink_mac_change(priv->phylink, link_is_up);
265 otherwise. If a MAC is unable to provide these interrupts, then
266 it should set ``priv->phylink_config.pcs_poll = true;`` in step 9.
273 as these will interfere with phylink's tracking of the link state,