1 From 9c2487f148ee38807d86beaf12dc2b818a764a99 Mon Sep 17 00:00:00 2001
2 From: John Crispin <blogic@openwrt.org>
3 Date: Tue, 17 Nov 2015 00:20:07 +0100
4 Subject: [PATCH 500/513] Documentation: DT: net: add docs for ralink/mediatek
7 Add three files. ralink,rt2880-net.txt descibes the actual frame engine
8 and the other two describe the switch forntend bindings.
10 Signed-off-by: John Crispin <blogic@openwrt.org>
11 Signed-off-by: Felix Fietkau <nbd@nbd.name>
12 Signed-off-by: Michael Lee <igvtee@gmail.com>
13 Cc: devicetree@vger.kernel.org
15 .../bindings/net/mediatek,mt7620-gsw.txt | 26 +++++++++
16 .../devicetree/bindings/net/ralink,rt2880-net.txt | 61 ++++++++++++++++++++
17 .../devicetree/bindings/net/ralink,rt3050-esw.txt | 32 ++++++++++
18 3 files changed, 119 insertions(+)
19 create mode 100644 Documentation/devicetree/bindings/net/mediatek,mt7620-gsw.txt
20 create mode 100644 Documentation/devicetree/bindings/net/ralink,rt2880-net.txt
21 create mode 100644 Documentation/devicetree/bindings/net/ralink,rt3050-esw.txt
24 +++ b/Documentation/devicetree/bindings/net/mediatek,mt7620-gsw.txt
26 +Mediatek Gigabit Switch
27 +=======================
29 +The mediatek gigabit switch can be found on Mediatek SoCs (mt7620, mt7621).
32 +- compatible: Should be "mediatek,mt7620-gsw"
33 +- reg: Address and length of the register set for the device
34 +- interrupt-parent: Should be the phandle for the interrupt controller
35 + that services interrupts for this device
36 +- interrupts: Should contain the gigabit switches interrupt
37 +- resets: Should contain the gigabit switches resets
38 +- reset-names: Should contain the reset names "gsw"
43 + compatible = "ralink,mt7620-gsw";
44 + reg = <0x10110000 8000>;
46 + resets = <&rstctrl 23>;
47 + reset-names = "gsw";
49 + interrupt-parent = <&intc>;
53 +++ b/Documentation/devicetree/bindings/net/ralink,rt2880-net.txt
55 +Ralink Frame Engine Ethernet controller
56 +=======================================
58 +The Ralink frame engine ethernet controller can be found on Ralink and
59 +Mediatek SoCs (RT288x, RT3x5x, RT366x, RT388x, rt5350, mt7620, mt7621, mt76x8).
61 +Depending on the SoC, there is a number of ports connected to the CPU port
62 +directly and/or via a (gigabit-)switch.
64 +* Ethernet controller node
67 +- compatible: Should be one of "ralink,rt2880-eth", "ralink,rt3050-eth",
68 + "ralink,rt3050-eth", "ralink,rt3883-eth", "ralink,rt5350-eth",
69 + "mediatek,mt7620-eth", "mediatek,mt7621-eth"
70 +- reg: Address and length of the register set for the device
71 +- interrupt-parent: Should be the phandle for the interrupt controller
72 + that services interrupts for this device
73 +- interrupts: Should contain the frame engines interrupt
74 +- resets: Should contain the frame engines resets
75 +- reset-names: Should contain the reset names "fe". If a switch is present
76 + "esw" is also required.
82 +- compatible: Should be "ralink,eth-port"
83 +- reg: The number of the physical port
84 +- phy-handle: reference to the node describing the phy
90 + phy0: ethernet-phy@0 {
97 + compatible = "ralink,rt2880-eth";
98 + reg = <0x00400000 10000>;
100 + #address-cells = <1>;
103 + resets = <&rstctrl 18>;
104 + reset-names = "fe";
106 + interrupt-parent = <&cpuintc>;
110 + compatible = "ralink,eth-port";
112 + phy-handle = <&phy0>;
117 +++ b/Documentation/devicetree/bindings/net/ralink,rt3050-esw.txt
119 +Ralink Fast Ethernet Embedded Switch
120 +====================================
122 +The ralink fast ethernet embedded switch can be found on Ralink and Mediatek
123 +SoCs (RT3x5x, rt5350, mt76x8).
125 +Required properties:
126 +- compatible: Should be "ralink,rt3050-esw"
127 +- reg: Address and length of the register set for the device
128 +- interrupt-parent: Should be the phandle for the interrupt controller
129 + that services interrupts for this device
130 +- interrupts: Should contain the embedded switches interrupt
131 +- resets: Should contain the embedded switches resets
132 +- reset-names: Should contain the reset names "esw"
134 +Optional properties:
135 +- ralink,portmap: can be used to choose if the default switch setup is
137 +- ralink,led_polarity: override the active high/low settings of the leds
142 + compatible = "ralink,rt3050-esw";
143 + reg = <0x10110000 8000>;
145 + resets = <&rstctrl 23>;
146 + reset-names = "esw";
148 + interrupt-parent = <&intc>;