[PATCH] dt-bindings: spi: xilinx: Add clocks & clock-names properties

[Mahapatra, Amit Kumar]

Hello Conor,


> -----Original Message-----
> From: Conor Dooley <conor at kernel.org>
> Sent: Tuesday, September 24, 2024 10:07 PM
> To: Mahapatra, Amit Kumar <amit.kumar-mahapatra at amd.com>
> Cc: broonie at kernel.org; robh at kernel.org; krzk+dt at kernel.org;
> conor+dt at kernel.org; Simek, Michal <michal.simek at amd.com>; linux-
> spi at vger.kernel.org; devicetree at vger.kernel.org; linux-arm-
> kernel at lists.infradead.org; linux-kernel at vger.kernel.org; git (AMD-Xilinx)
> <git at amd.com>; amitrkcian2002 at gmail.com
> Subject: Re: [PATCH] dt-bindings: spi: xilinx: Add clocks & clock-names properties
> 
> On Mon, Sep 23, 2024 at 06:02:42PM +0530, Amit Kumar Mahapatra wrote:
> > Include the 'clocks' and 'clock-names' properties in the AXI Quad-SPI
> > bindings. When the AXI4-Lite interface is enabled, the core operates
> > in legacy mode, maintaining backward compatibility with version 1.00,
> > and uses 's_axi_aclk' and 'ext_spi_clk'. For the AXI interface, it
> > uses 's_axi4_aclk' and 'ext_spi_clk'.
> >
> > Signed-off-by: Amit Kumar Mahapatra <amit.kumar-mahapatra at amd.com>
> > ---
> > BRANCH: for-next
> > ---
> >  .../devicetree/bindings/spi/spi-xilinx.yaml   | 29 +++++++++++++++++++
> >  1 file changed, 29 insertions(+)
> >
> > diff --git a/Documentation/devicetree/bindings/spi/spi-xilinx.yaml
> > b/Documentation/devicetree/bindings/spi/spi-xilinx.yaml
> > index 4beb3af0416d..9dfec195ecd4 100644
> > --- a/Documentation/devicetree/bindings/spi/spi-xilinx.yaml
> > +++ b/Documentation/devicetree/bindings/spi/spi-xilinx.yaml
> > @@ -12,6 +12,25 @@ maintainers:
> >  allOf:
> >    - $ref: spi-controller.yaml#
> 
> Please move the allOf block down to the end of the binding, after the property
> definitions.
 
Sure, I'll take care of it in the next series
> 
> > +  - if:
> > +      properties:
> > +        compatible:
> > +          contains:
> > +            const: xlnx,axi-quad-spi-1.00.a
> > +    then:
> > +      properties:
> > +        clock-names:
> > +          items:
> > +            - const: s_axi_aclk
> > +            - const: ext_spi_clk
> 
> These are all clocks, there should be no need to have "clk" in the names.

These are the names exported by the IP and used by the DTG.

> 
> > +
> > +    else:
> > +      properties:
> > +        clock-names:
> > +          items:
> > +            - const: s_axi4_aclk
> > +            - const: ext_spi_clk
> > +
> >  properties:
> >    compatible:
> >      enum:
> > @@ -25,6 +44,12 @@ properties:
> >    interrupts:
> >      maxItems: 1
> >
> > +  clocks:
> > +    maxItems: 2
> > +
> > +  clock-names:
> > +    maxItems: 2
> > +
> >    xlnx,num-ss-bits:
> >      description: Number of chip selects used.
> >      minimum: 1
> > @@ -39,6 +64,8 @@ required:
> >    - compatible
> >    - reg
> >    - interrupts
> > +  - clocks
> > +  - clock-names
> 
> New required properties are an ABI break, where is the driver patch that makes use
> of these clocks?

Alright, I will remove these from the required properties to avoid 
breaking the ABI. We're working on the driver patch and will send it once 
it's ready.

Regards,
Amit
> 
> Cheers,
> Conor.
> 
> >
> >  unevaluatedProperties: false
> >
> > @@ -49,6 +76,8 @@ examples:
> >        interrupt-parent = <&intc>;
> >        interrupts = <0 31 1>;
> >        reg = <0x41e00000 0x10000>;
> > +      clocks = <&clkc 72>, <&clkc 73>;
> > +      clock-names = "s_axi4_aclk", "ext_spi_clk";
> >        xlnx,num-ss-bits = <0x1>;
> >        xlnx,num-transfer-bits = <32>;
> >      };
> > --
> > 2.34.1
> >