]> git.proxmox.com Git - mirror_ubuntu-jammy-kernel.git/blame - Documentation/devicetree/bindings/net/brcm,bcm7445-switch-v4.0.txt
Merge git://git.kernel.org/pub/scm/linux/kernel/git/netdev/net
[mirror_ubuntu-jammy-kernel.git] / Documentation / devicetree / bindings / net / brcm,bcm7445-switch-v4.0.txt
CommitLineData
879bd83d
FF
1* Broadcom Starfighter 2 integrated swich
2
3Required properties:
4
3b07d788
FF
5- compatible: should be one of
6 "brcm,bcm7445-switch-v4.0"
7 "brcm,bcm7278-switch-v4.0"
8 "brcm,bcm7278-switch-v4.8"
879bd83d
FF
9- reg: addresses and length of the register sets for the device, must be 6
10 pairs of register addresses and lengths
11- interrupts: interrupts for the devices, must be two interrupts
a85fad14
FF
12- #address-cells: must be 1, see dsa/dsa.txt
13- #size-cells: must be 0, see dsa/dsa.txt
14
15Deprecated binding required properties:
16
879bd83d
FF
17- dsa,mii-bus: phandle to the MDIO bus controller, see dsa/dsa.txt
18- dsa,ethernet: phandle to the CPU network interface controller, see dsa/dsa.txt
879bd83d
FF
19- #address-cells: must be 2, see dsa/dsa.txt
20
21Subnodes:
22
23The integrated switch subnode should be specified according to the binding
24described in dsa/dsa.txt.
25
26Optional properties:
27
28- reg-names: litteral names for the device base register addresses, when present
29 must be: "core", "reg", "intrl2_0", "intrl2_1", "fcb", "acb"
30
31- interrupt-names: litternal names for the device interrupt lines, when present
32 must be: "switch_0" and "switch_1"
33
34- brcm,num-gphy: specify the maximum number of integrated gigabit PHYs in the
35 switch
36
37- brcm,num-rgmii-ports: specify the maximum number of RGMII interfaces supported
38 by the switch
39
40- brcm,fcb-pause-override: boolean property, if present indicates that the switch
41 supports Failover Control Block pause override capability
42
43- brcm,acb-packets-inflight: boolean property, if present indicates that the switch
44 Admission Control Block supports reporting the number of packets in-flight in a
45 switch queue
46
9482d036
FF
47- resets: a single phandle and reset identifier pair. See
48 Documentation/devicetree/binding/reset/reset.txt for details.
49
50- reset-names: If the "reset" property is specified, this property should have
51 the value "switch" to denote the switch reset line.
52
64ff2aef
FF
53Port subnodes:
54
55Optional properties:
56
57- brcm,use-bcm-hdr: boolean property, if present, indicates that the switch
58 port has Broadcom tags enabled (per-packet metadata)
59
879bd83d
FF
60Example:
61
a85fad14
FF
62switch_top@f0b00000 {
63 compatible = "simple-bus";
64 #size-cells = <1>;
65 #address-cells = <1>;
66 ranges = <0 0xf0b00000 0x40804>;
67
68 ethernet_switch@0 {
69 compatible = "brcm,bcm7445-switch-v4.0";
70 #size-cells = <0>;
71 #address-cells = <1>;
72 reg = <0x0 0x40000
73 0x40000 0x110
74 0x40340 0x30
75 0x40380 0x30
76 0x40400 0x34
77 0x40600 0x208>;
78 reg-names = "core", "reg", intrl2_0", "intrl2_1",
79 "fcb, "acb";
80 interrupts = <0 0x18 0
81 0 0x19 0>;
82 brcm,num-gphy = <1>;
83 brcm,num-rgmii-ports = <2>;
84 brcm,fcb-pause-override;
85 brcm,acb-packets-inflight;
86
87 ports {
88 #address-cells = <1>;
89 #size-cells = <0>;
90
91 port@0 {
92 label = "gphy";
93 reg = <0>;
94 };
95 };
96 };
97};
98
99Example using the old DSA DeviceTree binding:
100
879bd83d
FF
101switch_top@f0b00000 {
102 compatible = "simple-bus";
103 #size-cells = <1>;
104 #address-cells = <1>;
105 ranges = <0 0xf0b00000 0x40804>;
106
107 ethernet_switch@0 {
108 compatible = "brcm,bcm7445-switch-v4.0";
109 #size-cells = <0>;
110 #address-cells = <2>;
111 reg = <0x0 0x40000
112 0x40000 0x110
113 0x40340 0x30
114 0x40380 0x30
115 0x40400 0x34
116 0x40600 0x208>;
117 interrupts = <0 0x18 0
118 0 0x19 0>;
119 brcm,num-gphy = <1>;
120 brcm,num-rgmii-ports = <2>;
121 brcm,fcb-pause-override;
122 brcm,acb-packets-inflight;
123
124 ...
125 switch@0 {
126 reg = <0 0>;
127 #size-cells = <0>;
128 #address-cells <1>;
129
130 port@0 {
131 label = "gphy";
132 reg = <0>;
64ff2aef 133 brcm,use-bcm-hdr;
879bd83d
FF
134 };
135 ...
136 };
137 };
138};