doc: t1040-l2switch: Update README
[oweals/u-boot.git] / doc / README.t1040-l2switch
1 This file contains information for VSC9953, a Vitesse L2 Switch IP
2 which is integrated in the T1040/T1020 Freescale SoCs.
3
4 About Device:
5 =============
6 VSC9953 is an 8-port Gigabit Ethernet switch supports the following features:
7         -       8192 MAC addresses
8         -       Static Address provisioning
9         -       Dynamic learning of MAC addresses and aging
10         -       4096 VLANs
11         -       Independent and shared VLAN learning (IVL, SVL)
12         -       Policing with storm control and MC/BC protection
13         -       IPv4 and IPv6 multicast
14         -       Jumbo frames (9.6 KB)
15         -       Access Control List
16         -       VLAN editing, translation and remarking
17         -       RMON counters per port
18
19 Switch interfaces:
20         -       8 Gigabit switch ports (ports 0 to 7) are external and are connected to external PHYs
21         -       2 switch ports (ports 8 and 9) of 2.5 G are connected (fixed links)
22                 to FMan ports (FM1@DTSEC1 and FM1@DTSEC2)
23
24 Commands Overview:
25 =============
26 Commands supported
27         - enable/disable a port or show its configuration (speed, duplexity, status, etc.)
28         - port statistics
29         - MAC learning
30         - add/remove FDB entries
31         - Port-based VLAN
32         - Private/Shared VLAN learning
33         - VLAN ingress filtering
34
35 Commands syntax
36 ethsw [port <port_no>] { enable | disable | show } - enable/disable a port; show a port's configuration
37 ethsw [port <port_no>] statistics { [help] | [clear] } - show an l2 switch port's statistics
38 ethsw [port <port_no>] learning { [help] | show | auto | disable } - enable/disable/show learning configuration on a port
39 ethsw [port <port_no>] [vlan <vid>] fdb { [help] | show | flush | { add | del } <mac> } - add/delete a mac entry in FDB; use show to see FDB entries;
40                                                                                           if [vlan <vid>] is missing, VID 1 will be used
41 ethsw [port <port_no>] pvid { [help] | show | <pvid> } - set/show PVID (ingress and egress VLAN tagging) for a port
42 ethsw [port <port_no>] vlan { [help] | show | add <vid> | del <vid> } - add a VLAN to a port (VLAN members)
43 ethsw [port <port_no>] untagged { [help] | show | all | none | pvid } - set egress tagging mode for a port
44 ethsw [port <port_no>] egress tag { [help] | show | pvid | classified } - configure VID source for egress tag.
45                                                                           Tag's VID could be the frame's classified VID or the PVID of the port
46 ethsw vlan fdb { [help] | show | shared | private } - make VLAN learning shared or private
47 ethsw [port <port_no>] ingress filtering { [help] | show | enable | disable } - enable/disable VLAN ingress filtering on port
48
49 => ethsw show
50     Port   Status     Link    Speed   Duplex
51        0  enabled     down       10     half
52        1  enabled     down       10     half
53        2  enabled     down       10     half
54        3  enabled       up     1000     full
55        4 disabled     down        -     half
56        5 disabled     down        -     half
57        6 disabled     down        -     half
58        7 disabled     down        -     half
59        8  enabled       up     2500     full
60        9  enabled       up     2500     full
61 =>