From: Serge Semin <Sergey.Semin@baikalelectronics.ru>
To: Rob Herring <robh@kernel.org>
Cc: Serge Semin <fancer.lancer@gmail.com>,
Giuseppe Cavallaro <peppe.cavallaro@st.com>,
Alexandre Torgue <alexandre.torgue@st.com>,
Jose Abreu <joabreu@synopsys.com>,
"David S. Miller" <davem@davemloft.net>,
Jakub Kicinski <kuba@kernel.org>, Johan Hovold <johan@kernel.org>,
Maxime Ripard <mripard@kernel.org>,
Joao Pinto <jpinto@synopsys.com>, Lars Persson <larper@axis.com>,
Alexey Malahov <Alexey.Malahov@baikalelectronics.ru>,
Pavel Parkhomenko <Pavel.Parkhomenko@baikalelectronics.ru>,
Vyacheslav Mitrofanov
<Vyacheslav.Mitrofanov@baikalelectronics.ru>,
Maxime Coquelin <mcoquelin.stm32@gmail.com>,
<netdev@vger.kernel.org>,
<linux-stm32@st-md-mailman.stormreply.com>,
<linux-arm-kernel@lists.infradead.org>,
<devicetree@vger.kernel.org>, <linux-kernel@vger.kernel.org>
Subject: Re: [PATCH 07/25] dt-bindings: net: dwmac: Detach Generic DW MAC bindings
Date: Wed, 16 Dec 2020 12:10:25 +0300 [thread overview]
Message-ID: <20201216091025.6sbh72z3pebvm4sx@mobilestation> (raw)
In-Reply-To: <20201215175002.GA4074883@robh.at.kernel.org>
On Tue, Dec 15, 2020 at 11:50:02AM -0600, Rob Herring wrote:
> On Mon, Dec 14, 2020 at 12:15:57PM +0300, Serge Semin wrote:
> > Currently the snps,dwmac.yaml DT bindings file is used for both DT nodes
> > describing generic DW MAC devices and as DT schema with common properties
> > to be evaluated against a vendor-specific DW MAC IP-cores. Due to such
> > dual-purpose design the "compatible" property of the common DW MAC schema
> > needs to contain the vendor-specific strings to successfully pass the
> > schema evaluation in case if it's referenced from the vendor-specific DT
> > bindings. That's a bad design from maintainability point of view, since
> > adding/removing any DW MAC-based device bindings requires the common
> > schema modification. In order to fix that let's detach the schema which
> > provides the generic DW MAC DT nodes evaluation into a dedicated DT
> > bindings file preserving the common DW MAC properties declaration in the
> > snps,dwmac.yaml file. By doing so we'll still provide a common properties
> > evaluation for each vendor-specific MAC bindings which refer to the
> > common bindings file, while the generic DW MAC DT nodes will be checked
> > against the new snps,dwmac-generic.yaml DT schema.
>
> I'm okay with the change, but it needs a big fat note that
> snps,dwmac-generic.yaml should not have new users. New users should have
> an SoC specific compatible. History has shown that even IP versions are
> not enough to handle all the integration crap vendors do.
Agreed. I'll add such note to the "description" text of the
snps,dwmac-generic.yaml schema. Is that ok?
-Sergey
>
> >
> > Signed-off-by: Serge Semin <Sergey.Semin@baikalelectronics.ru>
> > ---
> > .../bindings/net/snps,dwmac-generic.yaml | 148 ++++++++++++++++++
> > .../devicetree/bindings/net/snps,dwmac.yaml | 139 +---------------
> > 2 files changed, 149 insertions(+), 138 deletions(-)
> > create mode 100644 Documentation/devicetree/bindings/net/snps,dwmac-generic.yaml
> >
> > diff --git a/Documentation/devicetree/bindings/net/snps,dwmac-generic.yaml b/Documentation/devicetree/bindings/net/snps,dwmac-generic.yaml
> > new file mode 100644
> > index 000000000000..f1b387911390
> > --- /dev/null
> > +++ b/Documentation/devicetree/bindings/net/snps,dwmac-generic.yaml
> > @@ -0,0 +1,148 @@
> > +# SPDX-License-Identifier: GPL-2.0
> > +%YAML 1.2
> > +---
> > +$id: http://devicetree.org/schemas/net/snps,dwmac-generic.yaml#
> > +$schema: http://devicetree.org/meta-schemas/core.yaml#
> > +
> > +title: Synopsys DesignWare Generic MAC Device Tree Bindings
> > +
> > +maintainers:
> > + - Alexandre Torgue <alexandre.torgue@st.com>
> > + - Giuseppe Cavallaro <peppe.cavallaro@st.com>
> > + - Jose Abreu <joabreu@synopsys.com>
> > +
> > +# Select the DT nodes, which have got compatible strings either as just a
> > +# single string with IP-core name optionally followed by the IP version or
> > +# two strings: one with IP-core name plus the IP version, another as just
> > +# the IP-core name.
> > +select:
> > + properties:
> > + compatible:
> > + oneOf:
> > + - items:
> > + - pattern: "^snps,dw(xg)+mac(-[0-9]+\\.[0-9]+a?)?$"
> > + - items:
> > + - pattern: "^snps,dwmac-[0-9]+\\.[0-9]+a?$"
> > + - const: snps,dwmac
> > + - items:
> > + - pattern: "^snps,dwxgmac-[0-9]+\\.[0-9]+a?$"
> > + - const: snps,dwxgmac
> > +
> > + required:
> > + - compatible
> > +
> > +allOf:
> > + - $ref: snps,dwmac.yaml#
> > +
> > +properties:
> > + compatible:
> > + oneOf:
> > + - description: Generic Synopsys DW MAC
> > + oneOf:
> > + - items:
> > + - enum:
> > + - snps,dwmac-3.50a
> > + - snps,dwmac-3.610
> > + - snps,dwmac-3.70a
> > + - snps,dwmac-3.710
> > + - snps,dwmac-4.00
> > + - snps,dwmac-4.10a
> > + - snps,dwmac-4.20a
> > + - const: snps,dwmac
> > + - const: snps,dwmac
> > + - description: Generic Synopsys DW xGMAC
> > + oneOf:
> > + - items:
> > + - enum:
> > + - snps,dwxgmac-2.10
> > + - const: snps,dwxgmac
> > + - const: snps,dwxgmac
> > + - description: ST SPEAr SoC Family GMAC
> > + deprecated: true
> > + const: st,spear600-gmac
> > +
> > + reg:
> > + maxItems: 1
> > +
> > +unevaluatedProperties: false
> > +
> > +examples:
> > + - |
> > + gmac0: ethernet@e0800000 {
> > + compatible = "snps,dwxgmac-2.10", "snps,dwxgmac";
> > + reg = <0xe0800000 0x8000>;
> > + interrupt-parent = <&vic1>;
> > + interrupts = <24 23 22>;
> > + interrupt-names = "macirq", "eth_wake_irq", "eth_lpi";
> > + mac-address = [000000000000]; /* Filled in by U-Boot */
> > + max-frame-size = <3800>;
> > + phy-mode = "gmii";
> > + snps,multicast-filter-bins = <256>;
> > + snps,perfect-filter-entries = <128>;
> > + rx-fifo-depth = <16384>;
> > + tx-fifo-depth = <16384>;
> > + clocks = <&clock>;
> > + clock-names = "stmmaceth";
> > + snps,axi-config = <&stmmac_axi_setup>;
> > + snps,mtl-rx-config = <&mtl_rx_setup>;
> > + snps,mtl-tx-config = <&mtl_tx_setup>;
> > + mdio0 {
> > + #address-cells = <1>;
> > + #size-cells = <0>;
> > + compatible = "snps,dwmac-mdio";
> > + phy1: ethernet-phy@0 {
> > + reg = <0>;
> > + };
> > + };
> > + };
> > + - |
> > + gmac1: ethernet@f8010000 {
> > + compatible = "snps,dwmac-4.10a", "snps,dwmac";
> > + reg = <0xf8010000 0x4000>;
> > + interrupts = <0 98 4>;
> > + interrupt-names = "macirq";
> > + clock-names = "stmmaceth", "ptp_ref";
> > + clocks = <&clock 4>, <&clock 5>;
> > + phy-mode = "rgmii";
> > + snps,txpbl = <8>;
> > + snps,rxpbl = <2>;
> > + snps,aal;
> > + snps,tso;
> > +
> > + snps,axi-config {
> > + snps,wr_osr_lmt = <0xf>;
> > + snps,rd_osr_lmt = <0xf>;
> > + snps,blen = <256 128 64 32 0 0 0>;
> > + };
> > +
> > + snps,mtl-rx-config {
> > + snps,rx-queues-to-use = <1>;
> > + snps,rx-sched-sp;
> > + queue0 {
> > + snps,dcb-algorithm;
> > + snps,map-to-dma-channel = <0x0>;
> > + snps,priority = <0x0>;
> > + };
> > + };
> > +
> > + snps,mtl-tx-config {
> > + snps,tx-queues-to-use = <2>;
> > + snps,tx-sched-wrr;
> > +
> > + queue0 {
> > + snps,weight = <0x10>;
> > + snps,dcb-algorithm;
> > + snps,priority = <0x0>;
> > + };
> > +
> > + queue1 {
> > + snps,avb-algorithm;
> > + snps,send_slope = <0x1000>;
> > + snps,idle_slope = <0x1000>;
> > + snps,high_credit = <0x3E800>;
> > + snps,low_credit = <0x1FC18000>;
> > + snps,priority = <0x1>;
> > + };
> > + };
> > + };
> > +...
> > diff --git a/Documentation/devicetree/bindings/net/snps,dwmac.yaml b/Documentation/devicetree/bindings/net/snps,dwmac.yaml
> > index 74820f491346..72b58f86bc41 100644
> > --- a/Documentation/devicetree/bindings/net/snps,dwmac.yaml
> > +++ b/Documentation/devicetree/bindings/net/snps,dwmac.yaml
> > @@ -11,31 +11,7 @@ maintainers:
> > - Giuseppe Cavallaro <peppe.cavallaro@st.com>
> > - Jose Abreu <joabreu@synopsys.com>
> >
> > -# Select every compatible, including the deprecated ones. This way, we
> > -# will be able to report a warning when we have that compatible, since
> > -# we will validate the node thanks to the select, but won't report it
> > -# as a valid value in the compatible property description
> > -select:
> > - properties:
> > - compatible:
> > - contains:
> > - enum:
> > - - snps,dwmac
> > - - snps,dwmac-3.50a
> > - - snps,dwmac-3.610
> > - - snps,dwmac-3.70a
> > - - snps,dwmac-3.710
> > - - snps,dwmac-4.00
> > - - snps,dwmac-4.10a
> > - - snps,dwmac-4.20a
> > - - snps,dwxgmac
> > - - snps,dwxgmac-2.10
> > -
> > - # Deprecated
> > - - st,spear600-gmac
> > -
> > - required:
> > - - compatible
> > +select: false
> >
> > allOf:
> > - $ref: "ethernet-controller.yaml#"
> > @@ -62,35 +38,6 @@ allOf:
> > MAC HW capability register.
> >
> > properties:
> > -
> > - # We need to include all the compatibles from schemas that will
> > - # include that schemas, otherwise compatible won't validate for
> > - # those.
> > - compatible:
> > - contains:
> > - enum:
> > - - allwinner,sun7i-a20-gmac
> > - - allwinner,sun8i-a83t-emac
> > - - allwinner,sun8i-h3-emac
> > - - allwinner,sun8i-r40-emac
> > - - allwinner,sun8i-v3s-emac
> > - - allwinner,sun50i-a64-emac
> > - - amlogic,meson6-dwmac
> > - - amlogic,meson8b-dwmac
> > - - amlogic,meson8m2-dwmac
> > - - amlogic,meson-gxbb-dwmac
> > - - amlogic,meson-axg-dwmac
> > - - snps,dwmac
> > - - snps,dwmac-3.50a
> > - - snps,dwmac-3.610
> > - - snps,dwmac-3.70a
> > - - snps,dwmac-3.710
> > - - snps,dwmac-4.00
> > - - snps,dwmac-4.10a
> > - - snps,dwmac-4.20a
> > - - snps,dwxgmac
> > - - snps,dwxgmac-2.10
> > -
> > reg:
> > minItems: 1
> > maxItems: 2
> > @@ -543,88 +490,4 @@ dependencies:
> > snps,reset-delay-us: ["snps,reset-gpio"]
> >
> > additionalProperties: true
> > -
> > -examples:
> > - - |
> > - gmac0: ethernet@e0800000 {
> > - compatible = "snps,dwxgmac-2.10", "snps,dwxgmac";
> > - reg = <0xe0800000 0x8000>;
> > - interrupt-parent = <&vic1>;
> > - interrupts = <24 23 22>;
> > - interrupt-names = "macirq", "eth_wake_irq", "eth_lpi";
> > - mac-address = [000000000000]; /* Filled in by U-Boot */
> > - max-frame-size = <3800>;
> > - phy-mode = "gmii";
> > - snps,multicast-filter-bins = <256>;
> > - snps,perfect-filter-entries = <128>;
> > - rx-fifo-depth = <16384>;
> > - tx-fifo-depth = <16384>;
> > - clocks = <&clock>;
> > - clock-names = "stmmaceth";
> > - snps,axi-config = <&stmmac_axi_setup>;
> > - snps,mtl-rx-config = <&mtl_rx_setup>;
> > - snps,mtl-tx-config = <&mtl_tx_setup>;
> > - mdio0 {
> > - #address-cells = <1>;
> > - #size-cells = <0>;
> > - compatible = "snps,dwmac-mdio";
> > - phy1: ethernet-phy@0 {
> > - reg = <0>;
> > - };
> > - };
> > - };
> > - - |
> > - gmac1: ethernet@f8010000 {
> > - compatible = "snps,dwmac-4.10a", "snps,dwmac";
> > - reg = <0xf8010000 0x4000>;
> > - interrupts = <0 98 4>;
> > - interrupt-names = "macirq";
> > - clock-names = "stmmaceth", "ptp_ref";
> > - clocks = <&clock 4>, <&clock 5>;
> > - phy-mode = "rgmii";
> > - snps,txpbl = <8>;
> > - snps,rxpbl = <2>;
> > - snps,aal;
> > - snps,tso;
> > -
> > - snps,axi-config {
> > - snps,wr_osr_lmt = <0xf>;
> > - snps,rd_osr_lmt = <0xf>;
> > - snps,blen = <256 128 64 32 0 0 0>;
> > - };
> > -
> > - snps,mtl-rx-config {
> > - snps,rx-queues-to-use = <1>;
> > - snps,rx-sched-sp;
> > - queue0 {
> > - snps,dcb-algorithm;
> > - snps,map-to-dma-channel = <0x0>;
> > - snps,priority = <0x0>;
> > - };
> > - };
> > -
> > - snps,mtl-tx-config {
> > - snps,tx-queues-to-use = <2>;
> > - snps,tx-sched-wrr;
> > - queue0 {
> > - snps,weight = <0x10>;
> > - snps,dcb-algorithm;
> > - snps,priority = <0x0>;
> > - };
> > -
> > - queue1 {
> > - snps,avb-algorithm;
> > - snps,send_slope = <0x1000>;
> > - snps,idle_slope = <0x1000>;
> > - snps,high_credit = <0x3E800>;
> > - snps,low_credit = <0xFFC18000>;
> > - snps,priority = <0x1>;
> > - };
> > - };
> > - };
> > -
> > -# FIXME: We should set it, but it would report all the generic
> > -# properties as additional properties.
> > -# additionalProperties: false
> > -
> > ...
> > --
> > 2.29.2
> >
next prev parent reply other threads:[~2020-12-16 9:11 UTC|newest]
Thread overview: 40+ messages / expand[flat|nested] mbox.gz Atom feed top
2020-12-14 9:15 [PATCH 00/25] net: stmmac: Fix clocks/reset-related procedures Serge Semin
2020-12-14 9:15 ` [PATCH 01/25] dt-bindings: net: dwmac: Validate PBL for all IP-cores Serge Semin
2020-12-15 17:14 ` Rob Herring
2020-12-14 9:15 ` [PATCH 02/25] dt-bindings: net: dwmac: Extend number of PBL values Serge Semin
2020-12-15 17:14 ` Rob Herring
2020-12-14 9:15 ` [PATCH 03/25] dt-bindings: net: dwmac: Fix the TSO property declaration Serge Semin
2020-12-15 17:22 ` Rob Herring
2020-12-16 8:59 ` Serge Semin
2020-12-14 9:15 ` [PATCH 04/25] dt-bindings: net: dwmac: Refactor snps,*-config properties Serge Semin
2020-12-14 14:30 ` Rob Herring
2020-12-15 8:54 ` Serge Semin
2020-12-15 14:08 ` Rob Herring
2020-12-16 6:24 ` Serge Semin
2020-12-14 9:15 ` [PATCH 05/25] dt-bindings: net: dwmac: Elaborate stmmaceth/pclk description Serge Semin
2020-12-15 17:30 ` Rob Herring
2020-12-14 9:15 ` [PATCH 06/25] dt-bindings: net: dwmac: Add Tx/Rx clock sources Serge Semin
2020-12-15 17:32 ` Rob Herring
2020-12-16 6:02 ` Serge Semin
2020-12-15 17:32 ` Rob Herring
2020-12-14 9:15 ` [PATCH 07/25] dt-bindings: net: dwmac: Detach Generic DW MAC bindings Serge Semin
2020-12-15 17:50 ` Rob Herring
2020-12-16 9:10 ` Serge Semin [this message]
2020-12-14 9:15 ` [PATCH 08/25] net: stmmac: Add snps,*-config sub-nodes support Serge Semin
2020-12-14 9:15 ` [PATCH 09/25] net: stmmac: dwmac-rk: Cleanup STMMAC DT-config in remove cb Serge Semin
2020-12-14 9:16 ` [PATCH 10/25] net: stmmac: dwmac-sti: " Serge Semin
2020-12-14 9:16 ` [PATCH 11/25] net: stmmac: dwmac-stm32: " Serge Semin
2020-12-14 9:16 ` [PATCH 12/25] net: stmmac: Directly call reverse methods in stmmac_probe_config_dt() Serge Semin
2020-12-14 9:16 ` [PATCH 13/25] net: stmmac: Fix clocks left enabled on glue-probes failure Serge Semin
2020-12-14 9:16 ` [PATCH 14/25] net: stmmac: Use optional clock request method to get stmmaceth Serge Semin
2020-12-14 9:16 ` [PATCH 15/25] net: stmmac: Use optional clock request method to get pclk Serge Semin
2020-12-14 9:16 ` [PATCH 16/25] net: stmmac: Use optional clock request method to get ptp_clk Serge Semin
2020-12-14 9:16 ` [PATCH 17/25] net: stmmac: Use optional reset control API to work with stmmaceth Serge Semin
2020-12-14 9:16 ` [PATCH 18/25] net: stmmac: dwc-qos: Cleanup STMMAC platform data clock pointers Serge Semin
2020-12-14 9:16 ` [PATCH 19/25] net: stmmac: dwc-qos: Use dev_err_probe() for probe errors handling Serge Semin
2020-12-14 9:16 ` [PATCH 20/25] net: stmmac: Add Tx/Rx platform clocks support Serge Semin
2020-12-14 9:16 ` [PATCH 21/25] net: stmmac: dwc-qos: Discard Tx/Rx clocks request Serge Semin
2020-12-14 9:16 ` [PATCH 22/25] net: stmmac: dwmac-imx: Discard Tx clock request Serge Semin
2020-12-14 9:16 ` [PATCH 23/25] net: stmmac: Call stmmaceth clock as system clock in warn-message Serge Semin
2020-12-14 9:16 ` [PATCH 24/25] net: stmmac: Use pclk to set MDC clock frequency Serge Semin
2020-12-14 9:16 ` [PATCH 25/25] net: stmmac: dwc-qos: Save master/slave clocks in the plat-data Serge Semin
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20201216091025.6sbh72z3pebvm4sx@mobilestation \
--to=sergey.semin@baikalelectronics.ru \
--cc=Alexey.Malahov@baikalelectronics.ru \
--cc=Pavel.Parkhomenko@baikalelectronics.ru \
--cc=Vyacheslav.Mitrofanov@baikalelectronics.ru \
--cc=alexandre.torgue@st.com \
--cc=davem@davemloft.net \
--cc=devicetree@vger.kernel.org \
--cc=fancer.lancer@gmail.com \
--cc=joabreu@synopsys.com \
--cc=johan@kernel.org \
--cc=jpinto@synopsys.com \
--cc=kuba@kernel.org \
--cc=larper@axis.com \
--cc=linux-arm-kernel@lists.infradead.org \
--cc=linux-kernel@vger.kernel.org \
--cc=linux-stm32@st-md-mailman.stormreply.com \
--cc=mcoquelin.stm32@gmail.com \
--cc=mripard@kernel.org \
--cc=netdev@vger.kernel.org \
--cc=peppe.cavallaro@st.com \
--cc=robh@kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
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).