Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
dt-bindings: phy: ocelot-serdes: convert to YAML
Convert the phy-ocelot-serdes device tree binding to the new YAML format.
Additionally, add the file to MAINTAINERS since the original file didn't
exist.
Signed-off-by: Colin Foster <colin.foster@in-advantage.com>
Reviewed-by: Rob Herring <robh@kernel.org>
Link: https://lore.kernel.org/r/20220911163715.4036144-2-colin.foster@in-advantage.com
Signed-off-by: Vinod Koul <vkoul@kernel.org>
authored by
Colin Foster
and committed by
Vinod Koul
a525f380
677c577e
+57
-43
+56
Documentation/devicetree/bindings/phy/mscc,vsc7514-serdes.yaml
+56
Documentation/devicetree/bindings/phy/mscc,vsc7514-serdes.yaml
···
1
+
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2
+
%YAML 1.2
3
+
---
4
+
$id: http://devicetree.org/schemas/phy/mscc,vsc7514-serdes.yaml#
5
+
$schema: http://devicetree.org/meta-schemas/core.yaml#
6
+
7
+
title: Microsemi Ocelot SerDes muxing
8
+
9
+
maintainers:
10
+
- Alexandre Belloni <alexandre.belloni@bootlin.com>
11
+
- UNGLinuxDriver@microchip.com
12
+
13
+
description: |
14
+
On Microsemi Ocelot, there is a handful of registers in HSIO address
15
+
space for setting up the SerDes to switch port muxing.
16
+
17
+
A SerDes X can be "muxed" to work with switch port Y or Z for example.
18
+
One specific SerDes can also be used as a PCIe interface.
19
+
20
+
Hence, a SerDes represents an interface, be it an Ethernet or a PCIe one.
21
+
22
+
There are two kinds of SerDes: SERDES1G supports 10/100Mbps in
23
+
half/full-duplex and 1000Mbps in full-duplex mode while SERDES6G supports
24
+
10/100Mbps in half/full-duplex and 1000/2500Mbps in full-duplex mode.
25
+
26
+
Also, SERDES6G number (aka "macro") 0 is the only interface supporting
27
+
QSGMII.
28
+
29
+
This is a child of the HSIO syscon ("mscc,ocelot-hsio", see
30
+
Documentation/devicetree/bindings/mips/mscc.txt) on the Microsemi Ocelot.
31
+
32
+
properties:
33
+
compatible:
34
+
enum:
35
+
- mscc,vsc7514-serdes
36
+
37
+
"#phy-cells":
38
+
const: 2
39
+
description: |
40
+
The first number defines the input port to use for a given SerDes macro.
41
+
The second defines the macro to use. They are defined in
42
+
dt-bindings/phy/phy-ocelot-serdes.h
43
+
44
+
required:
45
+
- compatible
46
+
- "#phy-cells"
47
+
48
+
additionalProperties:
49
+
false
50
+
51
+
examples:
52
+
- |
53
+
serdes: serdes {
54
+
compatible = "mscc,vsc7514-serdes";
55
+
#phy-cells = <2>;
56
+
};
-43
Documentation/devicetree/bindings/phy/phy-ocelot-serdes.txt
-43
Documentation/devicetree/bindings/phy/phy-ocelot-serdes.txt
···
1
-
Microsemi Ocelot SerDes muxing driver
2
-
-------------------------------------
3
-
4
-
On Microsemi Ocelot, there is a handful of registers in HSIO address
5
-
space for setting up the SerDes to switch port muxing.
6
-
7
-
A SerDes X can be "muxed" to work with switch port Y or Z for example.
8
-
One specific SerDes can also be used as a PCIe interface.
9
-
10
-
Hence, a SerDes represents an interface, be it an Ethernet or a PCIe one.
11
-
12
-
There are two kinds of SerDes: SERDES1G supports 10/100Mbps in
13
-
half/full-duplex and 1000Mbps in full-duplex mode while SERDES6G supports
14
-
10/100Mbps in half/full-duplex and 1000/2500Mbps in full-duplex mode.
15
-
16
-
Also, SERDES6G number (aka "macro") 0 is the only interface supporting
17
-
QSGMII.
18
-
19
-
This is a child of the HSIO syscon ("mscc,ocelot-hsio", see
20
-
Documentation/devicetree/bindings/mips/mscc.txt) on the Microsemi Ocelot.
21
-
22
-
Required properties:
23
-
24
-
- compatible: should be "mscc,vsc7514-serdes"
25
-
- #phy-cells : from the generic phy bindings, must be 2.
26
-
The first number defines the input port to use for a given
27
-
SerDes macro. The second defines the macro to use. They are
28
-
defined in dt-bindings/phy/phy-ocelot-serdes.h
29
-
30
-
Example:
31
-
32
-
serdes: serdes {
33
-
compatible = "mscc,vsc7514-serdes";
34
-
#phy-cells = <2>;
35
-
};
36
-
37
-
ethernet {
38
-
port1 {
39
-
phy-handle = <&phy_foo>;
40
-
/* Link SERDES1G_5 to port1 */
41
-
phys = <&serdes 1 SERDES1G_5>;
42
-
};
43
-
};
+1
MAINTAINERS
+1
MAINTAINERS
···
13488
13488
L: linux-mips@vger.kernel.org
13489
13489
S: Supported
13490
13490
F: Documentation/devicetree/bindings/mips/mscc.txt
13491
+
F: Documentation/devicetree/bindings/phy/mscc,vsc7514-serdes.yaml
13491
13492
F: Documentation/devicetree/bindings/power/reset/ocelot-reset.txt
13492
13493
F: arch/mips/boot/dts/mscc/
13493
13494
F: arch/mips/configs/generic/board-ocelot.config