• Cyrille Pitchen's avatar
    spi: atmel: update DT bindings documentation · 2c01a3d6
    Cyrille Pitchen authored
    - add new property "atmel,fifo-size"
    - change "cs-gpios" to optional for SPI controller version >= 2.
    
    Please be aware that the VERSION register can not be used to guess the
    size of FIFOs. Indeed, for a given hardware version, the SPI controller
    can be integrated on Atmel SoCs with different FIFO sizes. Also the
    "atmel,fifo-size" property is optional as older SPI controllers don't
    embed FIFO at all.
    
    Besides, the FIFO size can not be read or guessed from other registers:
    When designing the FIFO feature, no dedicated registers were added to
    store this size. Unused spaces in the I/O register range are limited and
    better reserved for future usages. Instead, the FIFO size of each
    peripheral is documented in the programmer datasheet.
    
    Finally, on a given SoC, there can be several instances of the SPI
    controller with different FIFO sizes. This explain why we'd rather use a
    dedicated DT property than use the "compatible" property.
    
    For instance, sama5d2x SoCs come with some SPI controllers, the ones
    inside Flexcoms, integrating 32 data FIFOs whereas other SPI controllers
    use 16 data FIFOs. All these SPI controllers share the same IP version.
    Signed-off-by: default avatarCyrille Pitchen <cyrille.pitchen@atmel.com>
    Acked-by: default avatarNicolas Ferre <nicolas.ferre@atmel.com>
    Signed-off-by: default avatarMark Brown <broonie@kernel.org>
    2c01a3d6
spi_atmel.txt 971 Bytes