xref: /OK3568_Linux_fs/kernel/Documentation/networking/devlink/sja1105.rst (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun.. SPDX-License-Identifier: GPL-2.0
2*4882a593Smuzhiyun
3*4882a593Smuzhiyun=======================
4*4882a593Smuzhiyunsja1105 devlink support
5*4882a593Smuzhiyun=======================
6*4882a593Smuzhiyun
7*4882a593SmuzhiyunThis document describes the devlink features implemented
8*4882a593Smuzhiyunby the ``sja1105`` device driver.
9*4882a593Smuzhiyun
10*4882a593SmuzhiyunParameters
11*4882a593Smuzhiyun==========
12*4882a593Smuzhiyun
13*4882a593Smuzhiyun.. list-table:: Driver-specific parameters implemented
14*4882a593Smuzhiyun  :widths: 5 5 5 85
15*4882a593Smuzhiyun
16*4882a593Smuzhiyun  * - Name
17*4882a593Smuzhiyun    - Type
18*4882a593Smuzhiyun    - Mode
19*4882a593Smuzhiyun    - Description
20*4882a593Smuzhiyun  * - ``best_effort_vlan_filtering``
21*4882a593Smuzhiyun    - Boolean
22*4882a593Smuzhiyun    - runtime
23*4882a593Smuzhiyun    - Allow plain ETH_P_8021Q headers to be used as DSA tags.
24*4882a593Smuzhiyun
25*4882a593Smuzhiyun      Benefits:
26*4882a593Smuzhiyun
27*4882a593Smuzhiyun      - Can terminate untagged traffic over switch net
28*4882a593Smuzhiyun        devices even when enslaved to a bridge with
29*4882a593Smuzhiyun        vlan_filtering=1.
30*4882a593Smuzhiyun      - Can terminate VLAN-tagged traffic over switch net
31*4882a593Smuzhiyun        devices even when enslaved to a bridge with
32*4882a593Smuzhiyun        vlan_filtering=1, with some constraints (no more than
33*4882a593Smuzhiyun        7 non-pvid VLANs per user port).
34*4882a593Smuzhiyun      - Can do QoS based on VLAN PCP and VLAN membership
35*4882a593Smuzhiyun        admission control for autonomously forwarded frames
36*4882a593Smuzhiyun        (regardless of whether they can be terminated on the
37*4882a593Smuzhiyun        CPU or not).
38*4882a593Smuzhiyun
39*4882a593Smuzhiyun      Drawbacks:
40*4882a593Smuzhiyun
41*4882a593Smuzhiyun      - User cannot use VLANs in range 1024-3071. If the
42*4882a593Smuzhiyun	switch receives frames with such VIDs, it will
43*4882a593Smuzhiyun	misinterpret them as DSA tags.
44*4882a593Smuzhiyun      - Switch uses Shared VLAN Learning (FDB lookup uses
45*4882a593Smuzhiyun	only DMAC as key).
46*4882a593Smuzhiyun      - When VLANs span cross-chip topologies, the total
47*4882a593Smuzhiyun	number of permitted VLANs may be less than 7 per
48*4882a593Smuzhiyun	port, due to a maximum number of 32 VLAN retagging
49*4882a593Smuzhiyun	rules per switch.
50