* [PATCH v2 0/1] Convert phy-ocelot-serdes documentation to YAML
@ 2022-09-11 16:37 Colin Foster
2022-09-11 16:37 ` [PATCH v2 1/1] dt-bindings: phy: ocelot-serdes: convert " Colin Foster
0 siblings, 1 reply; 6+ messages in thread
From: Colin Foster @ 2022-09-11 16:37 UTC (permalink / raw)
To: linux-kernel, devicetree, linux-phy, linux-mips
Cc: Krzysztof Kozlowski, Rob Herring, Vinod Koul,
Kishon Vijay Abraham I, UNGLinuxDriver, Alexandre Belloni
Work is currently being done to add the phy-ocelot-serdes driver to a
non-syscon configuration. Doing so will require updates to the
documentation.
I can certainly wait until that change set to submit this, but I feel
sooner is better than later for Documentation format updates. Also,
those updates likely won't be ready before this next merge window.
The only liberty I took was adding Alexandre and UNGLinuxDriver as the
maintainers, otherwise the content should be the same.
v1 -> v2:
* Implemented changes from Krzysztof - see patch for details
Colin Foster (1):
dt-bindings: phy: ocelot-serdes: convert to YAML
.../bindings/phy/mscc,vsc7514-serdes.yaml | 56 +++++++++++++++++++
.../bindings/phy/phy-ocelot-serdes.txt | 43 --------------
MAINTAINERS | 1 +
3 files changed, 57 insertions(+), 43 deletions(-)
create mode 100644 Documentation/devicetree/bindings/phy/mscc,vsc7514-serdes.yaml
delete mode 100644 Documentation/devicetree/bindings/phy/phy-ocelot-serdes.txt
--
2.25.1
^ permalink raw reply [flat|nested] 6+ messages in thread* [PATCH v2 1/1] dt-bindings: phy: ocelot-serdes: convert to YAML 2022-09-11 16:37 [PATCH v2 0/1] Convert phy-ocelot-serdes documentation to YAML Colin Foster @ 2022-09-11 16:37 ` Colin Foster 2022-09-13 15:23 ` Rob Herring 2022-09-13 16:40 ` Vinod Koul 0 siblings, 2 replies; 6+ messages in thread From: Colin Foster @ 2022-09-11 16:37 UTC (permalink / raw) To: linux-kernel, devicetree, linux-phy, linux-mips Cc: Krzysztof Kozlowski, Rob Herring, Vinod Koul, Kishon Vijay Abraham I, UNGLinuxDriver, Alexandre Belloni 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> --- v1 -> v2: * new yaml file is now named mscc,vsc7514-serdes.yaml * examlpes != examples * remove "driver" name from the binding * remove ethernet port consumer from the example * add additionalProperties: false * remove unnecessary, obvious sentence in the description --- .../bindings/phy/mscc,vsc7514-serdes.yaml | 56 +++++++++++++++++++ .../bindings/phy/phy-ocelot-serdes.txt | 43 -------------- MAINTAINERS | 1 + 3 files changed, 57 insertions(+), 43 deletions(-) create mode 100644 Documentation/devicetree/bindings/phy/mscc,vsc7514-serdes.yaml delete mode 100644 Documentation/devicetree/bindings/phy/phy-ocelot-serdes.txt diff --git a/Documentation/devicetree/bindings/phy/mscc,vsc7514-serdes.yaml b/Documentation/devicetree/bindings/phy/mscc,vsc7514-serdes.yaml new file mode 100644 index 000000000000..3169b873231e --- /dev/null +++ b/Documentation/devicetree/bindings/phy/mscc,vsc7514-serdes.yaml @@ -0,0 +1,56 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/phy/mscc,vsc7514-serdes.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Microsemi Ocelot SerDes muxing + +maintainers: + - Alexandre Belloni <alexandre.belloni@bootlin.com> + - UNGLinuxDriver@microchip.com + +description: | + On Microsemi Ocelot, there is a handful of registers in HSIO address + space for setting up the SerDes to switch port muxing. + + A SerDes X can be "muxed" to work with switch port Y or Z for example. + One specific SerDes can also be used as a PCIe interface. + + Hence, a SerDes represents an interface, be it an Ethernet or a PCIe one. + + There are two kinds of SerDes: SERDES1G supports 10/100Mbps in + half/full-duplex and 1000Mbps in full-duplex mode while SERDES6G supports + 10/100Mbps in half/full-duplex and 1000/2500Mbps in full-duplex mode. + + Also, SERDES6G number (aka "macro") 0 is the only interface supporting + QSGMII. + + This is a child of the HSIO syscon ("mscc,ocelot-hsio", see + Documentation/devicetree/bindings/mips/mscc.txt) on the Microsemi Ocelot. + +properties: + compatible: + enum: + - mscc,vsc7514-serdes + + "#phy-cells": + const: 2 + description: | + The first number defines the input port to use for a given SerDes macro. + The second defines the macro to use. They are defined in + dt-bindings/phy/phy-ocelot-serdes.h + +required: + - compatible + - "#phy-cells" + +additionalProperties: + false + +examples: + - | + serdes: serdes { + compatible = "mscc,vsc7514-serdes"; + #phy-cells = <2>; + }; diff --git a/Documentation/devicetree/bindings/phy/phy-ocelot-serdes.txt b/Documentation/devicetree/bindings/phy/phy-ocelot-serdes.txt deleted file mode 100644 index 332219860187..000000000000 --- a/Documentation/devicetree/bindings/phy/phy-ocelot-serdes.txt +++ /dev/null @@ -1,43 +0,0 @@ -Microsemi Ocelot SerDes muxing driver -------------------------------------- - -On Microsemi Ocelot, there is a handful of registers in HSIO address -space for setting up the SerDes to switch port muxing. - -A SerDes X can be "muxed" to work with switch port Y or Z for example. -One specific SerDes can also be used as a PCIe interface. - -Hence, a SerDes represents an interface, be it an Ethernet or a PCIe one. - -There are two kinds of SerDes: SERDES1G supports 10/100Mbps in -half/full-duplex and 1000Mbps in full-duplex mode while SERDES6G supports -10/100Mbps in half/full-duplex and 1000/2500Mbps in full-duplex mode. - -Also, SERDES6G number (aka "macro") 0 is the only interface supporting -QSGMII. - -This is a child of the HSIO syscon ("mscc,ocelot-hsio", see -Documentation/devicetree/bindings/mips/mscc.txt) on the Microsemi Ocelot. - -Required properties: - -- compatible: should be "mscc,vsc7514-serdes" -- #phy-cells : from the generic phy bindings, must be 2. - The first number defines the input port to use for a given - SerDes macro. The second defines the macro to use. They are - defined in dt-bindings/phy/phy-ocelot-serdes.h - -Example: - - serdes: serdes { - compatible = "mscc,vsc7514-serdes"; - #phy-cells = <2>; - }; - - ethernet { - port1 { - phy-handle = <&phy_foo>; - /* Link SERDES1G_5 to port1 */ - phys = <&serdes 1 SERDES1G_5>; - }; - }; diff --git a/MAINTAINERS b/MAINTAINERS index 6705fb8bfd3a..806aba01e0bc 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -13493,6 +13493,7 @@ M: UNGLinuxDriver@microchip.com L: linux-mips@vger.kernel.org S: Supported F: Documentation/devicetree/bindings/mips/mscc.txt +F: Documentation/devicetree/bindings/phy/mscc,vsc7514-serdes.yaml F: Documentation/devicetree/bindings/power/reset/ocelot-reset.txt F: arch/mips/boot/dts/mscc/ F: arch/mips/configs/generic/board-ocelot.config -- 2.25.1 ^ permalink raw reply related [flat|nested] 6+ messages in thread
* Re: [PATCH v2 1/1] dt-bindings: phy: ocelot-serdes: convert to YAML 2022-09-11 16:37 ` [PATCH v2 1/1] dt-bindings: phy: ocelot-serdes: convert " Colin Foster @ 2022-09-13 15:23 ` Rob Herring 2022-09-13 16:40 ` Vinod Koul 1 sibling, 0 replies; 6+ messages in thread From: Rob Herring @ 2022-09-13 15:23 UTC (permalink / raw) To: Colin Foster Cc: Alexandre Belloni, linux-phy, linux-mips, Vinod Koul, devicetree, linux-kernel, Kishon Vijay Abraham I, Krzysztof Kozlowski, UNGLinuxDriver, Rob Herring On Sun, 11 Sep 2022 09:37:15 -0700, Colin Foster wrote: > 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> > --- > > v1 -> v2: > * new yaml file is now named mscc,vsc7514-serdes.yaml > * examlpes != examples > * remove "driver" name from the binding > * remove ethernet port consumer from the example > * add additionalProperties: false > * remove unnecessary, obvious sentence in the description > > --- > .../bindings/phy/mscc,vsc7514-serdes.yaml | 56 +++++++++++++++++++ > .../bindings/phy/phy-ocelot-serdes.txt | 43 -------------- > MAINTAINERS | 1 + > 3 files changed, 57 insertions(+), 43 deletions(-) > create mode 100644 Documentation/devicetree/bindings/phy/mscc,vsc7514-serdes.yaml > delete mode 100644 Documentation/devicetree/bindings/phy/phy-ocelot-serdes.txt > Reviewed-by: Rob Herring <robh@kernel.org> ^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: [PATCH v2 1/1] dt-bindings: phy: ocelot-serdes: convert to YAML 2022-09-11 16:37 ` [PATCH v2 1/1] dt-bindings: phy: ocelot-serdes: convert " Colin Foster 2022-09-13 15:23 ` Rob Herring @ 2022-09-13 16:40 ` Vinod Koul 2022-09-13 16:44 ` Colin Foster 2022-09-13 16:46 ` Colin Foster 1 sibling, 2 replies; 6+ messages in thread From: Vinod Koul @ 2022-09-13 16:40 UTC (permalink / raw) To: Colin Foster Cc: linux-kernel, devicetree, linux-phy, linux-mips, Krzysztof Kozlowski, Rob Herring, Kishon Vijay Abraham I, UNGLinuxDriver, Alexandre Belloni On 11-09-22, 09:37, Colin Foster wrote: > 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. Applied, thanks -- ~Vinod ^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: [PATCH v2 1/1] dt-bindings: phy: ocelot-serdes: convert to YAML 2022-09-13 16:40 ` Vinod Koul @ 2022-09-13 16:44 ` Colin Foster 2022-09-13 16:46 ` Colin Foster 1 sibling, 0 replies; 6+ messages in thread From: Colin Foster @ 2022-09-13 16:44 UTC (permalink / raw) To: Vinod Koul Cc: linux-kernel, devicetree, linux-phy, linux-mips, Krzysztof Kozlowski, Rob Herring, Kishon Vijay Abraham I, UNGLinuxDriver, Alexandre Belloni On Tue, Sep 13, 2022 at 10:10:24PM +0530, Vinod Koul wrote: > On 11-09-22, 09:37, Colin Foster wrote: > > 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. > > Applied, thanks Hi Vinod, I'll be adding to this document in an upcoming net-next patch set. What would I need from you so that I can ask the netdev maintainers to bring this in? Thanks, and thanks Vladimir for getting this done so quickly! > > -- > ~Vinod ^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: [PATCH v2 1/1] dt-bindings: phy: ocelot-serdes: convert to YAML 2022-09-13 16:40 ` Vinod Koul 2022-09-13 16:44 ` Colin Foster @ 2022-09-13 16:46 ` Colin Foster 1 sibling, 0 replies; 6+ messages in thread From: Colin Foster @ 2022-09-13 16:46 UTC (permalink / raw) To: Vinod Koul Cc: linux-kernel, devicetree, linux-phy, linux-mips, Krzysztof Kozlowski, Rob Herring, Kishon Vijay Abraham I, UNGLinuxDriver, Alexandre Belloni On Tue, Sep 13, 2022 at 10:10:24PM +0530, Vinod Koul wrote: > On 11-09-22, 09:37, Colin Foster wrote: > > 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. > Oops, Disregard my last email. I was confused about which patch this was - no need to bring this into net-next. > Applied, thanks > > -- > ~Vinod ^ permalink raw reply [flat|nested] 6+ messages in thread
end of thread, other threads:[~2022-09-13 17:49 UTC | newest] Thread overview: 6+ messages (download: mbox.gz follow: Atom feed -- links below jump to the message on this page -- 2022-09-11 16:37 [PATCH v2 0/1] Convert phy-ocelot-serdes documentation to YAML Colin Foster 2022-09-11 16:37 ` [PATCH v2 1/1] dt-bindings: phy: ocelot-serdes: convert " Colin Foster 2022-09-13 15:23 ` Rob Herring 2022-09-13 16:40 ` Vinod Koul 2022-09-13 16:44 ` Colin Foster 2022-09-13 16:46 ` Colin Foster
This is a public inbox, see mirroring instructions for how to clone and mirror all data and code used for this inbox; as well as URLs for NNTP newsgroup(s).