1.. SPDX-License-Identifier: GPL-2.0 2 3====================================================== 4Texas Instruments CPSW switchdev based ethernet driver 5====================================================== 6 7:Version: 2.0 8 9Port renaming 10============= 11 12On older udev versions renaming of ethX to swXpY will not be automatically 13supported 14 15In order to rename via udev:: 16 17 ip -d link show dev sw0p1 | grep switchid 18 19 SUBSYSTEM=="net", ACTION=="add", ATTR{phys_switch_id}==<switchid>, \ 20 ATTR{phys_port_name}!="", NAME="sw0$attr{phys_port_name}" 21 22 23Dual mac mode 24============= 25 26- The new (cpsw_new.c) driver is operating in dual-emac mode by default, thus 27 working as 2 individual network interfaces. Main differences from legacy CPSW 28 driver are: 29 30 - optimized promiscuous mode: The P0_UNI_FLOOD (both ports) is enabled in 31 addition to ALLMULTI (current port) instead of ALE_BYPASS. 32 So, Ports in promiscuous mode will keep possibility of mcast and vlan 33 filtering, which is provides significant benefits when ports are joined 34 to the same bridge, but without enabling "switch" mode, or to different 35 bridges. 36 - learning disabled on ports as it make not too much sense for 37 segregated ports - no forwarding in HW. 38 - enabled basic support for devlink. 39 40 :: 41 42 devlink dev show 43 platform/48484000.switch 44 45 devlink dev param show 46 platform/48484000.switch: 47 name switch_mode type driver-specific 48 values: 49 cmode runtime value false 50 name ale_bypass type driver-specific 51 values: 52 cmode runtime value false 53 54Devlink configuration parameters 55================================ 56 57See Documentation/networking/devlink/ti-cpsw-switch.rst 58 59Bridging in dual mac mode 60========================= 61 62The dual_mac mode requires two vids to be reserved for internal purposes, 63which, by default, equal CPSW Port numbers. As result, bridge has to be 64configured in vlan unaware mode or default_pvid has to be adjusted:: 65 66 ip link add name br0 type bridge 67 ip link set dev br0 type bridge vlan_filtering 0 68 echo 0 > /sys/class/net/br0/bridge/default_pvid 69 ip link set dev sw0p1 master br0 70 ip link set dev sw0p2 master br0 71 72or:: 73 74 ip link add name br0 type bridge 75 ip link set dev br0 type bridge vlan_filtering 0 76 echo 100 > /sys/class/net/br0/bridge/default_pvid 77 ip link set dev br0 type bridge vlan_filtering 1 78 ip link set dev sw0p1 master br0 79 ip link set dev sw0p2 master br0 80 81Enabling "switch" 82================= 83 84The Switch mode can be enabled by configuring devlink driver parameter 85"switch_mode" to 1/true:: 86 87 devlink dev param set platform/48484000.switch \ 88 name switch_mode value 1 cmode runtime 89 90This can be done regardless of the state of Port's netdev devices - UP/DOWN, but 91Port's netdev devices have to be in UP before joining to the bridge to avoid 92overwriting of bridge configuration as CPSW switch driver copletly reloads its 93configuration when first Port changes its state to UP. 94 95When the both interfaces joined the bridge - CPSW switch driver will enable 96marking packets with offload_fwd_mark flag unless "ale_bypass=0" 97 98All configuration is implemented via switchdev API. 99 100Bridge setup 101============ 102 103:: 104 105 devlink dev param set platform/48484000.switch \ 106 name switch_mode value 1 cmode runtime 107 108 ip link add name br0 type bridge 109 ip link set dev br0 type bridge ageing_time 1000 110 ip link set dev sw0p1 up 111 ip link set dev sw0p2 up 112 ip link set dev sw0p1 master br0 113 ip link set dev sw0p2 master br0 114 115 [*] bridge vlan add dev br0 vid 1 pvid untagged self 116 117 [*] if vlan_filtering=1. where default_pvid=1 118 119 Note. Steps [*] are mandatory. 120 121 122On/off STP 123========== 124 125:: 126 127 ip link set dev BRDEV type bridge stp_state 1/0 128 129VLAN configuration 130================== 131 132:: 133 134 bridge vlan add dev br0 vid 1 pvid untagged self <---- add cpu port to VLAN 1 135 136Note. This step is mandatory for bridge/default_pvid. 137 138Add extra VLANs 139=============== 140 141 1. untagged:: 142 143 bridge vlan add dev sw0p1 vid 100 pvid untagged master 144 bridge vlan add dev sw0p2 vid 100 pvid untagged master 145 bridge vlan add dev br0 vid 100 pvid untagged self <---- Add cpu port to VLAN100 146 147 2. tagged:: 148 149 bridge vlan add dev sw0p1 vid 100 master 150 bridge vlan add dev sw0p2 vid 100 master 151 bridge vlan add dev br0 vid 100 pvid tagged self <---- Add cpu port to VLAN100 152 153FDBs 154---- 155 156FDBs are automatically added on the appropriate switch port upon detection 157 158Manually adding FDBs:: 159 160 bridge fdb add aa:bb:cc:dd:ee:ff dev sw0p1 master vlan 100 161 bridge fdb add aa:bb:cc:dd:ee:fe dev sw0p2 master <---- Add on all VLANs 162 163MDBs 164---- 165 166MDBs are automatically added on the appropriate switch port upon detection 167 168Manually adding MDBs:: 169 170 bridge mdb add dev br0 port sw0p1 grp 239.1.1.1 permanent vid 100 171 bridge mdb add dev br0 port sw0p1 grp 239.1.1.1 permanent <---- Add on all VLANs 172 173Multicast flooding 174================== 175CPU port mcast_flooding is always on 176 177Turning flooding on/off on switch ports: 178bridge link set dev sw0p1 mcast_flood on/off 179 180Access and Trunk port 181===================== 182 183:: 184 185 bridge vlan add dev sw0p1 vid 100 pvid untagged master 186 bridge vlan add dev sw0p2 vid 100 master 187 188 189 bridge vlan add dev br0 vid 100 self 190 ip link add link br0 name br0.100 type vlan id 100 191 192Note. Setting PVID on Bridge device itself working only for 193default VLAN (default_pvid). 194 195NFS 196=== 197 198The only way for NFS to work is by chrooting to a minimal environment when 199switch configuration that will affect connectivity is needed. 200Assuming you are booting NFS with eth1 interface(the script is hacky and 201it's just there to prove NFS is doable). 202 203setup.sh:: 204 205 #!/bin/sh 206 mkdir proc 207 mount -t proc none /proc 208 ifconfig br0 > /dev/null 209 if [ $? -ne 0 ]; then 210 echo "Setting up bridge" 211 ip link add name br0 type bridge 212 ip link set dev br0 type bridge ageing_time 1000 213 ip link set dev br0 type bridge vlan_filtering 1 214 215 ip link set eth1 down 216 ip link set eth1 name sw0p1 217 ip link set dev sw0p1 up 218 ip link set dev sw0p2 up 219 ip link set dev sw0p2 master br0 220 ip link set dev sw0p1 master br0 221 bridge vlan add dev br0 vid 1 pvid untagged self 222 ifconfig sw0p1 0.0.0.0 223 udhchc -i br0 224 fi 225 umount /proc 226 227run_nfs.sh::: 228 229 #!/bin/sh 230 mkdir /tmp/root/bin -p 231 mkdir /tmp/root/lib -p 232 233 cp -r /lib/ /tmp/root/ 234 cp -r /bin/ /tmp/root/ 235 cp /sbin/ip /tmp/root/bin 236 cp /sbin/bridge /tmp/root/bin 237 cp /sbin/ifconfig /tmp/root/bin 238 cp /sbin/udhcpc /tmp/root/bin 239 cp /path/to/setup.sh /tmp/root/bin 240 chroot /tmp/root/ busybox sh /bin/setup.sh 241 242 run ./run_nfs.sh 243