tjh.dev
Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
DT: phy.txt: Clarify expected compatible values
PHY devices may only list compatibility with clause 22, 45, and if
they need to be more specific, their PHY identifier values. No other
compatible strings are allowed. Make this clear in the documentation,
and remove examples where make/model compatible strings are listed.
Signed-off-by: Andrew Lunn <andrew@lunn.ch>
Acked-by: Florian Fainelli <f.fainelli@gmail.com>
Signed-off-by: David S. Miller <davem@davemloft.net>
authored by
Andrew Lunn
and committed by
David S. Miller
e4bf797a
ae461131
+6
-20
+2
-2
Documentation/devicetree/bindings/net/brcm,bcmgenet.txt
+2
-2
Documentation/devicetree/bindings/net/brcm,bcmgenet.txt
···
68
68
phy1: ethernet-phy@1 {
69
69
max-speed = <1000>;
70
70
reg = <0x1>;
71
-
compatible = "brcm,28nm-gphy", "ethernet-phy-ieee802.3-c22";
71
+
compatible = "ethernet-phy-ieee802.3-c22";
72
72
};
73
73
};
74
74
};
···
115
115
phy0: ethernet-phy@0 {
116
116
max-speed = <1000>;
117
117
reg = <0x0>;
118
-
compatible = "brcm,bcm53125", "ethernet-phy-ieee802.3-c22";
118
+
compatible = "ethernet-phy-ieee802.3-c22";
119
119
};
120
120
};
121
121
};
-8
Documentation/devicetree/bindings/net/mdio-mux-gpio.txt
-8
Documentation/devicetree/bindings/net/mdio-mux-gpio.txt
···
38
38
39
39
phy11: ethernet-phy@1 {
40
40
reg = <1>;
41
-
compatible = "marvell,88e1149r";
42
41
marvell,reg-init = <3 0x10 0 0x5777>,
43
42
<3 0x11 0 0x00aa>,
44
43
<3 0x12 0 0x4105>,
···
47
48
};
48
49
phy12: ethernet-phy@2 {
49
50
reg = <2>;
50
-
compatible = "marvell,88e1149r";
51
51
marvell,reg-init = <3 0x10 0 0x5777>,
52
52
<3 0x11 0 0x00aa>,
53
53
<3 0x12 0 0x4105>,
···
56
58
};
57
59
phy13: ethernet-phy@3 {
58
60
reg = <3>;
59
-
compatible = "marvell,88e1149r";
60
61
marvell,reg-init = <3 0x10 0 0x5777>,
61
62
<3 0x11 0 0x00aa>,
62
63
<3 0x12 0 0x4105>,
···
65
68
};
66
69
phy14: ethernet-phy@4 {
67
70
reg = <4>;
68
-
compatible = "marvell,88e1149r";
69
71
marvell,reg-init = <3 0x10 0 0x5777>,
70
72
<3 0x11 0 0x00aa>,
71
73
<3 0x12 0 0x4105>,
···
81
85
82
86
phy21: ethernet-phy@1 {
83
87
reg = <1>;
84
-
compatible = "marvell,88e1149r";
85
88
marvell,reg-init = <3 0x10 0 0x5777>,
86
89
<3 0x11 0 0x00aa>,
87
90
<3 0x12 0 0x4105>,
···
90
95
};
91
96
phy22: ethernet-phy@2 {
92
97
reg = <2>;
93
-
compatible = "marvell,88e1149r";
94
98
marvell,reg-init = <3 0x10 0 0x5777>,
95
99
<3 0x11 0 0x00aa>,
96
100
<3 0x12 0 0x4105>,
···
99
105
};
100
106
phy23: ethernet-phy@3 {
101
107
reg = <3>;
102
-
compatible = "marvell,88e1149r";
103
108
marvell,reg-init = <3 0x10 0 0x5777>,
104
109
<3 0x11 0 0x00aa>,
105
110
<3 0x12 0 0x4105>,
···
108
115
};
109
116
phy24: ethernet-phy@4 {
110
117
reg = <4>;
111
-
compatible = "marvell,88e1149r";
112
118
marvell,reg-init = <3 0x10 0 0x5777>,
113
119
<3 0x11 0 0x00aa>,
114
120
<3 0x12 0 0x4105>,
-8
Documentation/devicetree/bindings/net/mdio-mux.txt
-8
Documentation/devicetree/bindings/net/mdio-mux.txt
···
47
47
48
48
phy11: ethernet-phy@1 {
49
49
reg = <1>;
50
-
compatible = "marvell,88e1149r";
51
50
marvell,reg-init = <3 0x10 0 0x5777>,
52
51
<3 0x11 0 0x00aa>,
53
52
<3 0x12 0 0x4105>,
···
56
57
};
57
58
phy12: ethernet-phy@2 {
58
59
reg = <2>;
59
-
compatible = "marvell,88e1149r";
60
60
marvell,reg-init = <3 0x10 0 0x5777>,
61
61
<3 0x11 0 0x00aa>,
62
62
<3 0x12 0 0x4105>,
···
65
67
};
66
68
phy13: ethernet-phy@3 {
67
69
reg = <3>;
68
-
compatible = "marvell,88e1149r";
69
70
marvell,reg-init = <3 0x10 0 0x5777>,
70
71
<3 0x11 0 0x00aa>,
71
72
<3 0x12 0 0x4105>,
···
74
77
};
75
78
phy14: ethernet-phy@4 {
76
79
reg = <4>;
77
-
compatible = "marvell,88e1149r";
78
80
marvell,reg-init = <3 0x10 0 0x5777>,
79
81
<3 0x11 0 0x00aa>,
80
82
<3 0x12 0 0x4105>,
···
90
94
91
95
phy21: ethernet-phy@1 {
92
96
reg = <1>;
93
-
compatible = "marvell,88e1149r";
94
97
marvell,reg-init = <3 0x10 0 0x5777>,
95
98
<3 0x11 0 0x00aa>,
96
99
<3 0x12 0 0x4105>,
···
99
104
};
100
105
phy22: ethernet-phy@2 {
101
106
reg = <2>;
102
-
compatible = "marvell,88e1149r";
103
107
marvell,reg-init = <3 0x10 0 0x5777>,
104
108
<3 0x11 0 0x00aa>,
105
109
<3 0x12 0 0x4105>,
···
108
114
};
109
115
phy23: ethernet-phy@3 {
110
116
reg = <3>;
111
-
compatible = "marvell,88e1149r";
112
117
marvell,reg-init = <3 0x10 0 0x5777>,
113
118
<3 0x11 0 0x00aa>,
114
119
<3 0x12 0 0x4105>,
···
117
124
};
118
125
phy24: ethernet-phy@4 {
119
126
reg = <4>;
120
-
compatible = "marvell,88e1149r";
121
127
marvell,reg-init = <3 0x10 0 0x5777>,
122
128
<3 0x11 0 0x00aa>,
123
129
<3 0x12 0 0x4105>,
+4
-2
Documentation/devicetree/bindings/net/phy.txt
+4
-2
Documentation/devicetree/bindings/net/phy.txt
···
17
17
"ethernet-phy-ieee802.3-c22" or "ethernet-phy-ieee802.3-c45" for
18
18
PHYs that implement IEEE802.3 clause 22 or IEEE802.3 clause 45
19
19
specifications. If neither of these are specified, the default is to
20
-
assume clause 22. The compatible list may also contain other
21
-
elements.
20
+
assume clause 22.
22
21
23
22
If the phy's identifier is known then the list may contain an entry
24
23
of the form: "ethernet-phy-idAAAA.BBBB" where
···
26
27
BBBB - The value of the 16 bit Phy Identifier 2 register as
27
28
4 hex digits. This is the chip vendor OUI bits 19:24,
28
29
followed by 10 bits of a vendor specific ID.
30
+
31
+
The compatible list should not contain other values than those
32
+
listed here.
29
33
30
34
- max-speed: Maximum PHY supported speed (10, 100, 1000...)
31
35