korg/linux
0
0
Fork 0
mirror of https://mirrors.bfsu.edu.cn/git/linux.git synced 2024-12-02 08:34:20 +08:00
Code Issues Packages Projects Releases Wiki Activity

net: phylink: Document MAC_(A)SYM_PAUSE

Browse Source 
This documents the possible MLO_PAUSE_* settings which can result from
different combinations of MAC_(A)SYM_PAUSE. Special note is paid to
settings which can result from user configuration (MLO_PAUSE_AN). The
autonegotiation results are more-or-less a direct consequence of IEEE
802.3 Table 28B-2.

Signed-off-by: Sean Anderson <sean.anderson@seco.com>
Signed-off-by: David S. Miller <davem@davemloft.net>
This commit is contained in:
Sean Anderson 2022-09-20 18:12:28 -04:00 committed by David S. Miller
parent 1a4019f492
commit 72bc36956f
1 changed files with 29 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
include/linux/phylink.h
View File

@ -21,6 +21,35 @@ enum {
MLO_AN_FIXED, /* Fixed-link mode */
MLO_AN_INBAND, /* In-band protocol */
/* MAC_SYM_PAUSE and MAC_ASYM_PAUSE are used when configuring our
* autonegotiation advertisement. They correspond to the PAUSE and
* ASM_DIR bits defined by 802.3, respectively.
*
* The following table lists the values of tx_pause and rx_pause which
* might be requested in mac_link_up. The exact values depend on either
* the results of autonegotation (if MLO_PAUSE_AN is set) or user
* configuration (if MLO_PAUSE_AN is not set).
*
* MAC_SYM_PAUSE MAC_ASYM_PAUSE MLO_PAUSE_AN tx_pause/rx_pause
* ============= ============== ============ ==================
* 0 0 0 0/0
* 0 0 1 0/0
* 0 1 0 0/0, 0/1, 1/0, 1/1
* 0 1 1 0/0, 1/0
* 1 0 0 0/0, 1/1
* 1 0 1 0/0, 1/1
* 1 1 0 0/0, 0/1, 1/0, 1/1
* 1 1 1 0/0, 0/1, 1/1
*
* If you set MAC_ASYM_PAUSE, the user may request any combination of
* tx_pause and rx_pause. You do not have to support these
* combinations.
*
* However, you should support combinations of tx_pause and rx_pause
* which might be the result of autonegotation. For example, don't set
* MAC_SYM_PAUSE unless your device can support tx_pause and rx_pause
* at the same time.
*/
MAC_SYM_PAUSE = BIT(0),
MAC_ASYM_PAUSE = BIT(1),
MAC_10HD = BIT(2),