On Wed, 13 Jul 2022 08:29:10 +0300, Serge Semin wrote:
> Synopsys AHCI SATA controller is mainly compatible with the generic AHCI
> SATA controller except a few peculiarities and the platform environment
> requirements. In particular it can have at least two reference clocks to
> feed up its AHB/AXI interface and SATA PHYs domain and at least one reset
> control for the application clock domain. In addition to that the DMA
> interface of each port can be tuned up to work with the predefined maximum
> data chunk size. Note unlike generic AHCI controller DWC AHCI can't have
> more than 8 ports. All of that is reflected in the new DWC AHCI SATA
> device DT binding.
>
> Note the DWC AHCI SATA controller DT-schema has been created in a way so
> to be reused for the vendor-specific DT-schemas (see for example the
> "snps,dwc-ahci" compatible string binding). One of which we are about to
> introduce.
>
> Signed-off-by: Serge Semin <Sergey.Semin@xxxxxxxxxxxxxxxxxxxx>
>
> ---
>
> Changelog v2:
> - Replace min/max constraints of the snps,{tx,rx}-ts-max property with
> enum [ 1, 2, 4, ..., 1024 ]. (@Rob)
>
> Changelog v4:
> - Decrease the "additionalProperties" property identation otherwise it's
> percieved as the node property instead of the key one. (@Rob)
> - Use the ahci-port properties definition from the AHCI common schema
> in order to extend it with DWC AHCI SATA port properties. (@Rob)
> - Remove the Hannes' rb tag since the patch content has changed.
>
> Changelog v5:
> - Fix "resets" property description: replace "clocks" with "resets".
> (@Rob)
> - Extend "resets/clocks{-names}" property definitions. (@Rob)
> - Add "resets" property min/maxItems constraints. (@Rob)
> - Add names for the basic resets like RxOOB and PM-alive. (@Rob)
> - Add generic DWC AHCI SATA fallback for "rockchip,rk3568-dwc-ahci"
> bindings. (@Rob)
> - Due to the change above the schema has been split up into two parts:
> common DWC AHCI SATA properties and generic DW AHCI SATA controller
> DT-schema. (@Rob)
> ---
> .../bindings/ata/ahci-platform.yaml | 8 --
> .../bindings/ata/snps,dwc-ahci-common.yaml | 102 ++++++++++++++++++
> .../bindings/ata/snps,dwc-ahci.yaml | 75 +++++++++++++
> 3 files changed, 177 insertions(+), 8 deletions(-)
> create mode 100644 Documentation/devicetree/bindings/ata/snps,dwc-ahci-common.yaml
> create mode 100644 Documentation/devicetree/bindings/ata/snps,dwc-ahci.yaml
>
Reviewed-by: Rob Herring <robh@xxxxxxxxxx>
