xref: /freebsd/sys/contrib/device-tree/Bindings/net/dsa/brcm,sf2.yaml (revision 02e9120893770924227138ba49df1edb3896112a) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/net/dsa/brcm,sf2.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Broadcom Starfighter 2 integrated swich
8
9maintainers:
10  - Florian Fainelli <f.fainelli@gmail.com>
11
12properties:
13  compatible:
14    items:
15      - enum:
16          - brcm,bcm4908-switch
17          - brcm,bcm7278-switch-v4.0
18          - brcm,bcm7278-switch-v4.8
19          - brcm,bcm7445-switch-v4.0
20
21  reg:
22    minItems: 6
23    maxItems: 6
24
25  reg-names:
26    items:
27      - const: core
28      - const: reg
29      - const: intrl2_0
30      - const: intrl2_1
31      - const: fcb
32      - const: acb
33
34  interrupts:
35    minItems: 2
36    maxItems: 2
37
38  interrupt-names:
39    items:
40      - const: switch_0
41      - const: switch_1
42
43  resets:
44    maxItems: 1
45
46  reset-names:
47    const: switch
48
49  clocks:
50    minItems: 1
51    items:
52      - description: switch's main clock
53      - description: dividing of the switch core clock
54
55  clock-names:
56    minItems: 1
57    items:
58      - const: sw_switch
59      - const: sw_switch_mdiv
60
61  brcm,num-gphy:
62    $ref: /schemas/types.yaml#/definitions/uint32
63    description: maximum number of integrated gigabit PHYs in the switch
64
65  brcm,num-rgmii-ports:
66    $ref: /schemas/types.yaml#/definitions/uint32
67    description: maximum number of RGMII interfaces supported by the switch
68
69  brcm,fcb-pause-override:
70    description: if present indicates that the switch supports Failover Control
71      Block pause override capability
72    type: boolean
73
74  brcm,acb-packets-inflight:
75    description: if present indicates that the switch Admission Control Block
76      supports reporting the number of packets in-flight in a switch queue
77    type: boolean
78
79  ports:
80    type: object
81
82    patternProperties:
83      '^port@[0-9a-f]$':
84        $ref: dsa-port.yaml#
85        unevaluatedProperties: false
86
87        properties:
88          brcm,use-bcm-hdr:
89            description: if present, indicates that the switch port has Broadcom
90              tags enabled (per-packet metadata)
91            type: boolean
92
93required:
94  - reg
95  - interrupts
96
97allOf:
98  - $ref: dsa.yaml#
99  - if:
100      properties:
101        compatible:
102          contains:
103            enum:
104              - brcm,bcm7278-switch-v4.0
105              - brcm,bcm7278-switch-v4.8
106    then:
107      properties:
108        clocks:
109          minItems: 1
110          maxItems: 1
111        clock-names:
112          minItems: 1
113          maxItems: 1
114      required:
115        - clocks
116        - clock-names
117  - if:
118      properties:
119        compatible:
120          contains:
121            const: brcm,bcm7445-switch-v4.0
122    then:
123      properties:
124        clocks:
125          minItems: 2
126          maxItems: 2
127        clock-names:
128          minItems: 2
129          maxItems: 2
130      required:
131        - clocks
132        - clock-names
133
134additionalProperties: false
135
136examples:
137  - |
138    switch@f0b00000 {
139            compatible = "brcm,bcm7445-switch-v4.0";
140            reg = <0xf0b00000 0x40000>,
141                  <0xf0b40000 0x110>,
142                  <0xf0b40340 0x30>,
143                  <0xf0b40380 0x30>,
144                  <0xf0b40400 0x34>,
145                  <0xf0b40600 0x208>;
146            reg-names = "core", "reg", "intrl2_0", "intrl2_1",
147                        "fcb", "acb";
148            interrupts = <0 0x18 0>,
149                         <0 0x19 0>;
150            clocks = <&sw_switch>, <&sw_switch_mdiv>;
151            clock-names = "sw_switch", "sw_switch_mdiv";
152            brcm,num-gphy = <1>;
153            brcm,num-rgmii-ports = <2>;
154            brcm,fcb-pause-override;
155            brcm,acb-packets-inflight;
156
157            ports {
158                    #address-cells = <1>;
159                    #size-cells = <0>;
160
161                    port@0 {
162                            label = "gphy";
163                            reg = <0>;
164                    };
165            };
166    };
167