[PATCH V2 2/2] mtd: spi-nor: Bindings for Cadence Quad SPI Flash Controller driver.

[Rob Herring]

On Wed, Jan 7, 2015 at 7:17 AM, Ezequiel Garcia
<ezequiel at vanguardiasur.com.ar> wrote:
> (CCing DT mailing list and DT binding maintainers)
>
> On 01/06/2015 02:08 PM, Graham Moore wrote:
>> Signed-off-by: Graham Moore <grmoore at opensource.altera.com>
>> ---
>>  .../devicetree/bindings/mtd/cadence_quadspi.txt    |   50 ++++++++++++++++++++
>>  1 file changed, 50 insertions(+)
>>  create mode 100644 Documentation/devicetree/bindings/mtd/cadence_quadspi.txt
>>
>> diff --git a/Documentation/devicetree/bindings/mtd/cadence_quadspi.txt b/Documentation/devicetree/bindings/mtd/cadence_quadspi.txt
>> new file mode 100644
>> index 0000000..3a8ea1c
>> --- /dev/null
>> +++ b/Documentation/devicetree/bindings/mtd/cadence_quadspi.txt
>> @@ -0,0 +1,50 @@
>> +* Cadence Quad SPI controller
>> +
>> +Required properties:
>> +- compatible : Should be "cdns,qspi-nor".

This controller only works with flash devices and is different than this one:?

Documentation/devicetree/bindings/spi/spi-cadence.txt

>> +- 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.
>> +- ext-decoder : Value of 0 means no external chipselect decoder is
>> +     connected, 1 means there is an external chipselect decoder connected.
>
> As I already said in the driver patch, I think this property should be
> boolean and have a vendor prefix.

The above binding already uses "is-decoded-cs". Let's not invent something new.

>> +- fifo-depth : Size of the data FIFO in words.
>
> This one looks generic enough to leave it as it is, without any vendor
> prefix.

All sorts of properties with fifo in them... Nothing is particularly
dominate, so this is fine.

>> +- bus-num : Number of the SPI bus to which the controller is connected.
>> +
>
> I think you forgot to remove bus-num here.
>
>> +Optional subnodes:
>> +Subnodes of the Cadence Quad SPI controller are spi slave nodes with additional
>> +custom properties:
>> +- cdns,page-size : Size, in bytes, of the device's write page
>> +- cdns,block-size : Size of the device's erase block
>> +- cdns,read-delay : Selay for read capture logic, in clock cycles

s/Selay/Delay/

>> +- cdns,tshsl-ns : Delay in master reference clocks for the length that the master mode chip select outputs are de-asserted between transactions.
>> +- cdns,tsd2d-ns : Delay in master reference clocks between one chip select being de-activated and the activation of another.
>> +- cdns,tchsh-ns : Delay in master reference clocks between last bit of current transaction and deasserting the device chip select (qspi_n_ss_out).
>> +- cdns,tslch-ns : Delay in master reference clocks between setting qspi_n_ss_out low and first bit transfer.

Aren't these properties probeable at all? We really should have
standard bindings for this. It seems spi NOR flash devices have gone
somewhat undocumented, but it is not hard to find examples already in
use.

Is it master reference clocks or nanoseconds for the units?

Rob

>> +
>> +Example:
>> +
>> +     qspi: spi at ff705000 {
>> +             compatible = "cdns,qspi-nor";
>> +             #address-cells = <1>;
>> +             #size-cells = <0>;
>> +             reg = <0xff705000 0x1000>,
>> +                     <0xffa00000 0x1000>;
>> +             interrupts = <0 151 4>;
>> +             clocks = <&qspi_clk>;
>> +             ext-decoder = <0>;
>> +             fifo-depth = <128>;
>> +
>> +             flash0: n25q00 at 0 {
>> +                     ...
>> +                     cdns,page-size = <256>;
>> +                     cdns,block-size = <16>;
>> +                     cdns,read-delay = <4>;
>> +                     cdns,tshsl-ns = <50>;
>> +                     cdns,tsd2d-ns = <50>;
>> +                     cdns,tchsh-ns = <4>;
>> +                     cdns,tslch-ns = <4>;
>> +             }
>> +     }
>>
>
> --
> Ezequiel Garcia, VanguardiaSur
> www.vanguardiasur.com.ar