mbox series

[v6,0/6] spi: cadence-quadspi: Add QSPI controller support for Intel LGM SoC

Message ID 20201030053153.5319-1-vadivel.muruganx.ramuthevar@linux.intel.com
Headers show
Series spi: cadence-quadspi: Add QSPI controller support for Intel LGM SoC | expand

Message

Ramuthevar,Vadivel MuruganX Oct. 30, 2020, 5:31 a.m. UTC
Add QSPI controller support for Intel LGM SoC.

Note from Vignesh(mtd subsystem maintainer):
This series is a subset of "[PATCH v12 0/4] spi: cadence-quadspi: Add
support for the Cadence QSPI controller" by Ramuthevar,Vadivel MuruganX
<vadivel.muruganx.ramuthevar@linux.intel.com> that intended to move
cadence-quadspi driver to spi-mem framework

Those patches were trying to accomplish too many things in a single set
of patches and need to split into smaller patches. This is reduced
version of above series.

Changes that are intended to make migration easy are split into separate
patches. Patches 1 to 3 drop features that cannot be supported under
spi-mem at the moment (backward compatibility is maintained).
Patch 4-5 are trivial cleanups. Patch 6 does the actual conversion to
spi-mem and patch 7 moves the driver to drivers/spi folder.

I have tested both INDAC mode (used by non TI platforms like Altera
SoCFPGA) and DAC mode (used by TI platforms) on TI EVMs.

Patches to move move bindings over to
"Documentation/devicetree/bindings/spi/" directory and also conversion
of bindig doc to YAML will be posted separately.  Support for Intel
platform would follow that.

Reference:
        https://lkml.org/lkml/2020/6/1/50

---
v6:
  - Rob's review comments update
  - add compatible string in properly aligned
  - remove cadence-qspi extra comaptible string in example
v5:
  - Rob's review comments update
  - const with single compatible string kept
v4:
  - Rob's review comments update
  - remove '|' no formatting to preserve
  - child node attributes follows under 'properties' under '@[0-9a-f]+$'.
v3:
  - Pratyush review comments update
  - CQSPI_SUPPORTS_MULTI_CHIPSELECT macro used instead of cqspi->use_direct_mode
  - disable DAC support placed in end of controller_init
v2:
  - Rob's review comments update for dt-bindings
  - add 'oneOf' for compatible selection
  - drop un-neccessary descriptions
  - add the cdns,is-decoded-cs and cdns,rclk-en properties as schema
  - remove 'allOf' in not required place
  - add AdditionalProperties false
  - add minItems/maxItems for qspi reset attributes

resend-v1:
  - As per Mark's suggestion , reorder the patch series 1-3 driver
    support patches, series 4-6 dt-bindings patches.
v1:
  - initial version



Ramuthevar Vadivel Murugan (6):
  spi: cadence-quadspi: Add QSPI support for Intel LGM SoC
  spi: cadence-quadspi: Disable the DAC for Intel LGM SoC
  spi: cadence-quadspi: Add multi-chipselect support for Intel LGM SoC
  spi: Move cadence-quadspi.txt to Documentation/devicetree/bindings/spi
  dt-bindings: spi: Convert cadence-quadspi.txt to cadence-quadspi.yaml
  dt-bindings: spi: Add compatible for Intel LGM SoC

 .../devicetree/bindings/mtd/cadence-quadspi.txt    |  67 ---------
 .../devicetree/bindings/spi/cadence-quadspi.yaml   | 150 +++++++++++++++++++++
 drivers/spi/Kconfig                                |   2 +-
 drivers/spi/spi-cadence-quadspi.c                  |  31 +++++
 4 files changed, 182 insertions(+), 68 deletions(-)
 delete mode 100644 Documentation/devicetree/bindings/mtd/cadence-quadspi.txt
 create mode 100644 Documentation/devicetree/bindings/spi/cadence-quadspi.yaml

Comments

Rob Herring Oct. 30, 2020, 3:18 p.m. UTC | #1
On Fri, Oct 30, 2020 at 01:31:52PM +0800, Ramuthevar,Vadivel MuruganX wrote:
> From: Ramuthevar Vadivel Murugan <vadivel.muruganx.ramuthevar@linux.intel.com>

> 

> Convert the cadence-quadspi.txt documentation to cadence-quadspi.yaml

> remove the cadence-quadspi.txt from Documentation/devicetree/bindings/spi/

> 

> Signed-off-by: Ramuthevar Vadivel Murugan <vadivel.muruganx.ramuthevar@linux.intel.com>

> ---

>  .../devicetree/bindings/spi/cadence-quadspi.txt    |  67 ---------

>  .../devicetree/bindings/spi/cadence-quadspi.yaml   | 149 +++++++++++++++++++++

>  2 files changed, 149 insertions(+), 67 deletions(-)

>  delete mode 100644 Documentation/devicetree/bindings/spi/cadence-quadspi.txt

>  create mode 100644 Documentation/devicetree/bindings/spi/cadence-quadspi.yaml

> 

> diff --git a/Documentation/devicetree/bindings/spi/cadence-quadspi.txt b/Documentation/devicetree/bindings/spi/cadence-quadspi.txt

> deleted file mode 100644

> index 945be7d5b236..000000000000

> --- a/Documentation/devicetree/bindings/spi/cadence-quadspi.txt

> +++ /dev/null

> @@ -1,67 +0,0 @@

> -* Cadence Quad SPI controller

> -

> -Required properties:

> -- compatible : should be one of the following:

> -	Generic default - "cdns,qspi-nor".

> -	For TI 66AK2G SoC - "ti,k2g-qspi", "cdns,qspi-nor".

> -	For TI AM654 SoC  - "ti,am654-ospi", "cdns,qspi-nor".

> -- reg : Contains two entries, each of which is a tuple consisting of a

> -	physical address and length. The first entry is the address and

> -	length of the controller register set. The second entry is the

> -	address and length of the QSPI Controller data area.

> -- interrupts : Unit interrupt specifier for the controller interrupt.

> -- clocks : phandle to the Quad SPI clock.

> -- cdns,fifo-depth : Size of the data FIFO in words.

> -- cdns,fifo-width : Bus width of the data FIFO in bytes.

> -- cdns,trigger-address : 32-bit indirect AHB trigger address.

> -

> -Optional properties:

> -- cdns,is-decoded-cs : Flag to indicate whether decoder is used or not.

> -- cdns,rclk-en : Flag to indicate that QSPI return clock is used to latch

> -  the read data rather than the QSPI clock. Make sure that QSPI return

> -  clock is populated on the board before using this property.

> -

> -Optional subnodes:

> -Subnodes of the Cadence Quad SPI controller are spi slave nodes with additional

> -custom properties:

> -- cdns,read-delay : Delay for read capture logic, in clock cycles

> -- cdns,tshsl-ns : Delay in nanoseconds for the length that the master

> -                  mode chip select outputs are de-asserted between

> -		  transactions.

> -- cdns,tsd2d-ns : Delay in nanoseconds between one chip select being

> -                  de-activated and the activation of another.

> -- cdns,tchsh-ns : Delay in nanoseconds between last bit of current

> -                  transaction and deasserting the device chip select

> -		  (qspi_n_ss_out).

> -- cdns,tslch-ns : Delay in nanoseconds between setting qspi_n_ss_out low

> -                  and first bit transfer.

> -- resets	: Must contain an entry for each entry in reset-names.

> -		  See ../reset/reset.txt for details.

> -- reset-names	: Must include either "qspi" and/or "qspi-ocp".

> -

> -Example:

> -

> -	qspi: spi@ff705000 {

> -		compatible = "cdns,qspi-nor";

> -		#address-cells = <1>;

> -		#size-cells = <0>;

> -		reg = <0xff705000 0x1000>,

> -		      <0xffa00000 0x1000>;

> -		interrupts = <0 151 4>;

> -		clocks = <&qspi_clk>;

> -		cdns,is-decoded-cs;

> -		cdns,fifo-depth = <128>;

> -		cdns,fifo-width = <4>;

> -		cdns,trigger-address = <0x00000000>;

> -		resets = <&rst QSPI_RESET>, <&rst QSPI_OCP_RESET>;

> -		reset-names = "qspi", "qspi-ocp";

> -

> -		flash0: n25q00@0 {

> -			...

> -			cdns,read-delay = <4>;

> -			cdns,tshsl-ns = <50>;

> -			cdns,tsd2d-ns = <50>;

> -			cdns,tchsh-ns = <4>;

> -			cdns,tslch-ns = <4>;

> -		};

> -	};

> diff --git a/Documentation/devicetree/bindings/spi/cadence-quadspi.yaml b/Documentation/devicetree/bindings/spi/cadence-quadspi.yaml

> new file mode 100644

> index 000000000000..ec22b040d804

> --- /dev/null

> +++ b/Documentation/devicetree/bindings/spi/cadence-quadspi.yaml

> @@ -0,0 +1,149 @@

> +# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)

> +%YAML 1.2

> +---

> +$id: http://devicetree.org/schemas/spi/cadence-quadspi.yaml#

> +$schema: http://devicetree.org/meta-schemas/core.yaml#

> +

> +title: Cadence Quad SPI controller

> +

> +maintainers:

> +  - Vadivel Murugan <vadivel.muruganx.ramuthevar@intel.com>

> +

> +allOf:

> +  - $ref: "spi-controller.yaml#"

> +

> +properties:

> +  compatible:

> +    oneOf:

> +      - items:


You don't need 'oneOf' if there is only one entry...

So you've dropped 'cdns,qspi-nor' alone being valid. Granted, the txt 
file was fuzzy as to whether or not that was valid. So you have to look 
at all the dts files and see. I prefer we don't allow that and require a 
more specific compatible, but if there's a bunch then we should allow 
for it. The commit message should summarize what you decide.

> +          - enum:

> +              - ti,k2g-qspi

> +              - ti,am654-ospi

> +          - const: cdns,qspi-nor


> +examples:

> +  - |

> +    qspi: spi@ff705000 {

> +      compatible = "cadence,qspi","cdns,qpsi-nor";


And you missed fixing this.

> +      #address-cells = <1>;

> +      #size-cells = <0>;

> +      reg = <0xff705000 0x1000>,

> +            <0xffa00000 0x1000>;

> +      interrupts = <0 151 4>;

> +      clocks = <&qspi_clk>;

> +      cdns,fifo-depth = <128>;

> +      cdns,fifo-width = <4>;

> +      cdns,trigger-address = <0x00000000>;

> +      resets = <&rst 0x1>, <&rst 0x2>;

> +      reset-names = "qspi", "qspi-ocp";

> +

> +      flash@0 {

> +              compatible = "jedec,spi-nor";

> +              reg = <0x0>;

> +              cdns,read-delay = <4>;

> +              cdns,tshsl-ns = <50>;

> +              cdns,tsd2d-ns = <50>;

> +              cdns,tchsh-ns = <4>;

> +              cdns,tslch-ns = <4>;

> +     };

> +

> +    };

> +

> +...

> -- 

> 2.11.0

>
Rob Herring Nov. 4, 2020, 10:02 p.m. UTC | #2
On Mon, Nov 02, 2020 at 01:59:41PM +0800, Ramuthevar, Vadivel MuruganX wrote:
> Hi Rob,
> 
> Thank you for the review comments...
> 
> On 30/10/2020 11:18 pm, Rob Herring wrote:
> > On Fri, Oct 30, 2020 at 01:31:52PM +0800, Ramuthevar,Vadivel MuruganX wrote:
> > > From: Ramuthevar Vadivel Murugan <vadivel.muruganx.ramuthevar@linux.intel.com>
> > > 
> > > Convert the cadence-quadspi.txt documentation to cadence-quadspi.yaml
> > > remove the cadence-quadspi.txt from Documentation/devicetree/bindings/spi/
> > > 
> > > Signed-off-by: Ramuthevar Vadivel Murugan <vadivel.muruganx.ramuthevar@linux.intel.com>
> > > ---
> > >   .../devicetree/bindings/spi/cadence-quadspi.txt    |  67 ---------
> > >   .../devicetree/bindings/spi/cadence-quadspi.yaml   | 149 +++++++++++++++++++++
> > >   2 files changed, 149 insertions(+), 67 deletions(-)
> > >   delete mode 100644 Documentation/devicetree/bindings/spi/cadence-quadspi.txt
> > >   create mode 100644 Documentation/devicetree/bindings/spi/cadence-quadspi.yaml
> > > 
> > > diff --git a/Documentation/devicetree/bindings/spi/cadence-quadspi.txt b/Documentation/devicetree/bindings/spi/cadence-quadspi.txt
> > > deleted file mode 100644
> > > index 945be7d5b236..000000000000
> > > --- a/Documentation/devicetree/bindings/spi/cadence-quadspi.txt
> > > +++ /dev/null
> > > @@ -1,67 +0,0 @@
> > > -* Cadence Quad SPI controller
> > > -
> > > -Required properties:
> > > -- compatible : should be one of the following:
> > > -	Generic default - "cdns,qspi-nor".
> > > -	For TI 66AK2G SoC - "ti,k2g-qspi", "cdns,qspi-nor".
> > > -	For TI AM654 SoC  - "ti,am654-ospi", "cdns,qspi-nor".
> > > -- reg : Contains two entries, each of which is a tuple consisting of a
> > > -	physical address and length. The first entry is the address and
> > > -	length of the controller register set. The second entry is the
> > > -	address and length of the QSPI Controller data area.
> > > -- interrupts : Unit interrupt specifier for the controller interrupt.
> > > -- clocks : phandle to the Quad SPI clock.
> > > -- cdns,fifo-depth : Size of the data FIFO in words.
> > > -- cdns,fifo-width : Bus width of the data FIFO in bytes.
> > > -- cdns,trigger-address : 32-bit indirect AHB trigger address.
> > > -
> > > -Optional properties:
> > > -- cdns,is-decoded-cs : Flag to indicate whether decoder is used or not.
> > > -- cdns,rclk-en : Flag to indicate that QSPI return clock is used to latch
> > > -  the read data rather than the QSPI clock. Make sure that QSPI return
> > > -  clock is populated on the board before using this property.
> > > -
> > > -Optional subnodes:
> > > -Subnodes of the Cadence Quad SPI controller are spi slave nodes with additional
> > > -custom properties:
> > > -- cdns,read-delay : Delay for read capture logic, in clock cycles
> > > -- cdns,tshsl-ns : Delay in nanoseconds for the length that the master
> > > -                  mode chip select outputs are de-asserted between
> > > -		  transactions.
> > > -- cdns,tsd2d-ns : Delay in nanoseconds between one chip select being
> > > -                  de-activated and the activation of another.
> > > -- cdns,tchsh-ns : Delay in nanoseconds between last bit of current
> > > -                  transaction and deasserting the device chip select
> > > -		  (qspi_n_ss_out).
> > > -- cdns,tslch-ns : Delay in nanoseconds between setting qspi_n_ss_out low
> > > -                  and first bit transfer.
> > > -- resets	: Must contain an entry for each entry in reset-names.
> > > -		  See ../reset/reset.txt for details.
> > > -- reset-names	: Must include either "qspi" and/or "qspi-ocp".
> > > -
> > > -Example:
> > > -
> > > -	qspi: spi@ff705000 {
> > > -		compatible = "cdns,qspi-nor";
> > > -		#address-cells = <1>;
> > > -		#size-cells = <0>;
> > > -		reg = <0xff705000 0x1000>,
> > > -		      <0xffa00000 0x1000>;
> > > -		interrupts = <0 151 4>;
> > > -		clocks = <&qspi_clk>;
> > > -		cdns,is-decoded-cs;
> > > -		cdns,fifo-depth = <128>;
> > > -		cdns,fifo-width = <4>;
> > > -		cdns,trigger-address = <0x00000000>;
> > > -		resets = <&rst QSPI_RESET>, <&rst QSPI_OCP_RESET>;
> > > -		reset-names = "qspi", "qspi-ocp";
> > > -
> > > -		flash0: n25q00@0 {
> > > -			...
> > > -			cdns,read-delay = <4>;
> > > -			cdns,tshsl-ns = <50>;
> > > -			cdns,tsd2d-ns = <50>;
> > > -			cdns,tchsh-ns = <4>;
> > > -			cdns,tslch-ns = <4>;
> > > -		};
> > > -	};
> > > diff --git a/Documentation/devicetree/bindings/spi/cadence-quadspi.yaml b/Documentation/devicetree/bindings/spi/cadence-quadspi.yaml
> > > new file mode 100644
> > > index 000000000000..ec22b040d804
> > > --- /dev/null
> > > +++ b/Documentation/devicetree/bindings/spi/cadence-quadspi.yaml
> > > @@ -0,0 +1,149 @@
> > > +# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
> > > +%YAML 1.2
> > > +---
> > > +$id: http://devicetree.org/schemas/spi/cadence-quadspi.yaml#
> > > +$schema: http://devicetree.org/meta-schemas/core.yaml#
> > > +
> > > +title: Cadence Quad SPI controller
> > > +
> > > +maintainers:
> > > +  - Vadivel Murugan <vadivel.muruganx.ramuthevar@intel.com>
> > > +
> > > +allOf:
> > > +  - $ref: "spi-controller.yaml#"
> > > +
> > > +properties:
> > > +  compatible:
> > > +    oneOf:
> > > +      - items:
> > 
> > You don't need 'oneOf' if there is only one entry...
> > 
> > So you've dropped 'cdns,qspi-nor' alone being valid. Granted, the txt
> > file was fuzzy as to whether or not that was valid. So you have to look
> > at all the dts files and see. I prefer we don't allow that and require a
> > more specific compatible, but if there's a bunch then we should allow
> > for it. The commit message should summarize what you decide.
> we need bunch of compatibles as below, TI, Altera and Intel uses different
> compatible's so we added 'oneOf'.

Then you add oneOf when you need it. You don't for what you wrote, 
but once it is correct you will as Altera uses 'cdns,qspi-nor' alone. 

> cdns,qspi-nor can be dropped instead I can add cadence,qspi ,because this
> driver suuports qspi-nor and qspi-nand as well.

No, you can't change it because it is an ABI.

> 
> Sure, let me go through other documentation files for reference.
> 
> > 
> > > +          - enum:
> > > +              - ti,k2g-qspi
> > > +              - ti,am654-ospi
> > > +          - const: cdns,qspi-nor
> > 
> > > +examples:
> > > +  - |
> > > +    qspi: spi@ff705000 {
> > > +      compatible = "cadence,qspi","cdns,qpsi-nor";
> > 
> > And you missed fixing this.
> Yes, fixed by "cadence,qspi" keeping alone, need to remove cdns,qspi-nor,
> thanks!

Nope!

Rob
Linus Walleij Nov. 5, 2020, 7:11 a.m. UTC | #3
On Fri, Oct 30, 2020 at 6:32 AM Ramuthevar,Vadivel MuruganX
<vadivel.muruganx.ramuthevar@linux.intel.com> wrote:

> +       ddata  = of_device_get_match_data(dev);
> +       if (ddata->hwcaps_mask & CQSPI_SUPPORTS_MULTI_CHIPSELECT) {
> +               if (of_property_read_u32(np, "num-chipselect",

The standard SPI bindings in spi-controller.yaml already has a binding
for this "num-cs" so please use that. It is also what your device tree
binding is referencing, so if you were using "num-chipselect" the
YAML check should give a warning?

Yours,
Linus Walleij
Ramuthevar,Vadivel MuruganX Nov. 6, 2020, 4:33 a.m. UTC | #4
Hi Linus,

Thank you for the review comments...

On 5/11/2020 3:11 pm, Linus Walleij wrote:
> On Fri, Oct 30, 2020 at 6:32 AM Ramuthevar,Vadivel MuruganX
> <vadivel.muruganx.ramuthevar@linux.intel.com> wrote:
> 
>> +       ddata  = of_device_get_match_data(dev);
>> +       if (ddata->hwcaps_mask & CQSPI_SUPPORTS_MULTI_CHIPSELECT) {
>> +               if (of_property_read_u32(np, "num-chipselect",
> 
> The standard SPI bindings in spi-controller.yaml already has a binding
> for this "num-cs" so please use that. It is also what your device tree
> binding is referencing, 
yes, you are point is valid, I will use that.
so if you were using "num-chipselect" the
> YAML check should give a warning?
In the example, I just converted from existing txt -to- yaml that's
why I didnt face any problem.

Regards
Vadivel
> 
> Yours,
> Linus Walleij
>
Ramuthevar,Vadivel MuruganX Nov. 9, 2020, 1:40 a.m. UTC | #5
Hi Rob,

On 5/11/2020 6:02 am, Rob Herring wrote:
> On Mon, Nov 02, 2020 at 01:59:41PM +0800, Ramuthevar, Vadivel MuruganX wrote:

>> Hi Rob,

>>

>> Thank you for the review comments...

>>

>> On 30/10/2020 11:18 pm, Rob Herring wrote:

>>> On Fri, Oct 30, 2020 at 01:31:52PM +0800, Ramuthevar,Vadivel MuruganX wrote:

>>>> From: Ramuthevar Vadivel Murugan <vadivel.muruganx.ramuthevar@linux.intel.com>

>>>>

>>>> Convert the cadence-quadspi.txt documentation to cadence-quadspi.yaml

>>>> remove the cadence-quadspi.txt from Documentation/devicetree/bindings/spi/

>>>>

>>>> Signed-off-by: Ramuthevar Vadivel Murugan <vadivel.muruganx.ramuthevar@linux.intel.com>

>>>> ---

>>>>    .../devicetree/bindings/spi/cadence-quadspi.txt    |  67 ---------

>>>>    .../devicetree/bindings/spi/cadence-quadspi.yaml   | 149 +++++++++++++++++++++

>>>>    2 files changed, 149 insertions(+), 67 deletions(-)

>>>>    delete mode 100644 Documentation/devicetree/bindings/spi/cadence-quadspi.txt

>>>>    create mode 100644 Documentation/devicetree/bindings/spi/cadence-quadspi.yaml

>>>>

>>>> diff --git a/Documentation/devicetree/bindings/spi/cadence-quadspi.txt b/Documentation/devicetree/bindings/spi/cadence-quadspi.txt

>>>> deleted file mode 100644

>>>> index 945be7d5b236..000000000000

>>>> --- a/Documentation/devicetree/bindings/spi/cadence-quadspi.txt

>>>> +++ /dev/null

>>>> @@ -1,67 +0,0 @@

>>>> -* Cadence Quad SPI controller

>>>> -

>>>> -Required properties:

>>>> -- compatible : should be one of the following:

>>>> -	Generic default - "cdns,qspi-nor".

>>>> -	For TI 66AK2G SoC - "ti,k2g-qspi", "cdns,qspi-nor".

>>>> -	For TI AM654 SoC  - "ti,am654-ospi", "cdns,qspi-nor".

>>>> -- reg : Contains two entries, each of which is a tuple consisting of a

>>>> -	physical address and length. The first entry is the address and

>>>> -	length of the controller register set. The second entry is the

>>>> -	address and length of the QSPI Controller data area.

>>>> -- interrupts : Unit interrupt specifier for the controller interrupt.

>>>> -- clocks : phandle to the Quad SPI clock.

>>>> -- cdns,fifo-depth : Size of the data FIFO in words.

>>>> -- cdns,fifo-width : Bus width of the data FIFO in bytes.

>>>> -- cdns,trigger-address : 32-bit indirect AHB trigger address.

>>>> -

>>>> -Optional properties:

>>>> -- cdns,is-decoded-cs : Flag to indicate whether decoder is used or not.

>>>> -- cdns,rclk-en : Flag to indicate that QSPI return clock is used to latch

>>>> -  the read data rather than the QSPI clock. Make sure that QSPI return

>>>> -  clock is populated on the board before using this property.

>>>> -

>>>> -Optional subnodes:

>>>> -Subnodes of the Cadence Quad SPI controller are spi slave nodes with additional

>>>> -custom properties:

>>>> -- cdns,read-delay : Delay for read capture logic, in clock cycles

>>>> -- cdns,tshsl-ns : Delay in nanoseconds for the length that the master

>>>> -                  mode chip select outputs are de-asserted between

>>>> -		  transactions.

>>>> -- cdns,tsd2d-ns : Delay in nanoseconds between one chip select being

>>>> -                  de-activated and the activation of another.

>>>> -- cdns,tchsh-ns : Delay in nanoseconds between last bit of current

>>>> -                  transaction and deasserting the device chip select

>>>> -		  (qspi_n_ss_out).

>>>> -- cdns,tslch-ns : Delay in nanoseconds between setting qspi_n_ss_out low

>>>> -                  and first bit transfer.

>>>> -- resets	: Must contain an entry for each entry in reset-names.

>>>> -		  See ../reset/reset.txt for details.

>>>> -- reset-names	: Must include either "qspi" and/or "qspi-ocp".

>>>> -

>>>> -Example:

>>>> -

>>>> -	qspi: spi@ff705000 {

>>>> -		compatible = "cdns,qspi-nor";

>>>> -		#address-cells = <1>;

>>>> -		#size-cells = <0>;

>>>> -		reg = <0xff705000 0x1000>,

>>>> -		      <0xffa00000 0x1000>;

>>>> -		interrupts = <0 151 4>;

>>>> -		clocks = <&qspi_clk>;

>>>> -		cdns,is-decoded-cs;

>>>> -		cdns,fifo-depth = <128>;

>>>> -		cdns,fifo-width = <4>;

>>>> -		cdns,trigger-address = <0x00000000>;

>>>> -		resets = <&rst QSPI_RESET>, <&rst QSPI_OCP_RESET>;

>>>> -		reset-names = "qspi", "qspi-ocp";

>>>> -

>>>> -		flash0: n25q00@0 {

>>>> -			...

>>>> -			cdns,read-delay = <4>;

>>>> -			cdns,tshsl-ns = <50>;

>>>> -			cdns,tsd2d-ns = <50>;

>>>> -			cdns,tchsh-ns = <4>;

>>>> -			cdns,tslch-ns = <4>;

>>>> -		};

>>>> -	};

>>>> diff --git a/Documentation/devicetree/bindings/spi/cadence-quadspi.yaml b/Documentation/devicetree/bindings/spi/cadence-quadspi.yaml

>>>> new file mode 100644

>>>> index 000000000000..ec22b040d804

>>>> --- /dev/null

>>>> +++ b/Documentation/devicetree/bindings/spi/cadence-quadspi.yaml

>>>> @@ -0,0 +1,149 @@

>>>> +# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)

>>>> +%YAML 1.2

>>>> +---

>>>> +$id: http://devicetree.org/schemas/spi/cadence-quadspi.yaml#

>>>> +$schema: http://devicetree.org/meta-schemas/core.yaml#

>>>> +

>>>> +title: Cadence Quad SPI controller

>>>> +

>>>> +maintainers:

>>>> +  - Vadivel Murugan <vadivel.muruganx.ramuthevar@intel.com>

>>>> +

>>>> +allOf:

>>>> +  - $ref: "spi-controller.yaml#"

>>>> +

>>>> +properties:

>>>> +  compatible:

>>>> +    oneOf:

>>>> +      - items:

>>>

>>> You don't need 'oneOf' if there is only one entry...

>>>

>>> So you've dropped 'cdns,qspi-nor' alone being valid. Granted, the txt

>>> file was fuzzy as to whether or not that was valid. So you have to look

>>> at all the dts files and see. I prefer we don't allow that and require a

>>> more specific compatible, but if there's a bunch then we should allow

>>> for it. The commit message should summarize what you decide.

>> we need bunch of compatibles as below, TI, Altera and Intel uses different

>> compatible's so we added 'oneOf'.

> 

> Then you add oneOf when you need it. You don't for what you wrote,

> but once it is correct you will as Altera uses 'cdns,qspi-nor' alone.

Yes, yo're right , we need oneOf in the case of adding 'cadence,qspi' 
and 'cdns,qspi-nor' two different group of items.
> 

>> cdns,qspi-nor can be dropped instead I can add cadence,qspi ,because this

>> driver suuports qspi-nor and qspi-nand as well.

> 

> No, you can't change it because it is an ABI.

Ok, Got it, thanks!

Regards
Vadivel
> 

>>

>> Sure, let me go through other documentation files for reference.

>>

>>>

>>>> +          - enum:

>>>> +              - ti,k2g-qspi

>>>> +              - ti,am654-ospi

>>>> +          - const: cdns,qspi-nor

>>>

>>>> +examples:

>>>> +  - |

>>>> +    qspi: spi@ff705000 {

>>>> +      compatible = "cadence,qspi","cdns,qpsi-nor";

>>>

>>> And you missed fixing this.

>> Yes, fixed by "cadence,qspi" keeping alone, need to remove cdns,qspi-nor,

>> thanks!

> 

> Nope!

> 

> Rob

>