Merge branch 'x86-urgent-for-linus' of git://git.kernel.org/pub/scm/linux/kernel...
[cascardo/linux.git] / Documentation / devicetree / bindings / net / cavium-mdio.txt
1 * System Management Interface (SMI) / MDIO
2
3 Properties:
4 - compatible: One of:
5
6    "cavium,octeon-3860-mdio": Compatibility with all cn3XXX, cn5XXX
7                        and cn6XXX SOCs.
8
9    "cavium,thunder-8890-mdio": Compatibility with all cn8XXX SOCs.
10
11 - reg: The base address of the MDIO bus controller register bank.
12
13 - #address-cells: Must be <1>.
14
15 - #size-cells: Must be <0>.  MDIO addresses have no size component.
16
17 Typically an MDIO bus might have several children.
18
19 Example:
20         mdio@1180000001800 {
21                 compatible = "cavium,octeon-3860-mdio";
22                 #address-cells = <1>;
23                 #size-cells = <0>;
24                 reg = <0x11800 0x00001800 0x0 0x40>;
25
26                 ethernet-phy@0 {
27                         ...
28                         reg = <0>;
29                 };
30         };
31
32
33 * System Management Interface (SMI) / MDIO Nexus
34
35   Several mdio buses may be gathered as children of a single PCI
36   device, this PCI device is the nexus of the buses.
37
38 Properties:
39
40 - compatible: "cavium,thunder-8890-mdio-nexus";
41
42 - reg: The PCI device and function numbers of the nexus device.
43
44 - #address-cells: Must be <2>.
45
46 - #size-cells: Must be <2>.
47
48 - ranges: As needed for mapping of the MDIO bus device registers.
49
50 - assigned-addresses: As needed for mapping of the MDIO bus device registers.
51
52 Example:
53
54         mdio-nexus@1,3 {
55                 compatible = "cavium,thunder-8890-mdio-nexus";
56                 #address-cells = <2>;
57                 #size-cells = <2>;
58                 reg = <0x0b00 0 0 0 0>; /* DEVFN = 0x0b (1:3) */
59                 assigned-addresses = <0x03000000 0x87e0 0x05000000 0x0 0x800000>;
60                 ranges = <0x87e0 0x05000000 0x03000000 0x87e0 0x05000000 0x0 0x800000>;
61
62                 mdio0@87e0,05003800 {
63                         compatible = "cavium,thunder-8890-mdio";
64                         #address-cells = <1>;
65                         #size-cells = <0>;
66                         reg = <0x87e0 0x05003800 0x0 0x30>;
67
68                         ethernet-phy@0 {
69                                 ...
70                                 reg = <0>;
71                         };
72                 };
73                 mdio0@87e0,05003880 {
74                         compatible = "cavium,thunder-8890-mdio";
75                         #address-cells = <1>;
76                         #size-cells = <0>;
77                         reg = <0x87e0 0x05003880 0x0 0x30>;
78
79                         ethernet-phy@0 {
80                                 ...
81                                 reg = <0>;
82                         };
83                 };
84         };