Commit 2de72bb4 authored by Rob Herring (Arm)'s avatar Rob Herring (Arm) Committed by Damien Le Moal
Browse files

dt-bindings: ata: Convert st,ahci to DT schema 



Convert the ST AHCI SATA Controller to DT schema format.

The phy-names changes from "ahci_phy" to "sata-phy" with the inclusion
of ahci-common.yaml. That's an ABI change, but the Linux driver at least
ignores the names. The binding uses "ports-implemented" property, so
including ahci-common.yaml is required.

Signed-off-by: default avatarRob Herring (Arm) <robh@kernel.org>
Signed-off-by: default avatarDamien Le Moal <dlemoal@kernel.org>
parent f07f2b3f

Documentation/devicetree/bindings/ata/ahci-st.txt

deleted100644 → 0
+0 −35
Original line number Diff line number Diff line 
STMicroelectronics STi SATA controller



This binding describes a SATA device.



Required properties:

 - compatible	   : Must be "st,ahci"

 - reg		   : Physical base addresses and length of register sets

 - interrupts	   : Interrupt associated with the SATA device

 - interrupt-names :   Associated name must be; "hostc"

 - clocks	   : The phandle for the clock

 - clock-names	   :   Associated name must be; "ahci_clk"

 - phys		   : The phandle for the PHY port

 - phy-names	   :   Associated name must be; "ahci_phy"



Optional properties:

 - resets	   : The power-down, soft-reset and power-reset lines of SATA IP

 - reset-names	   :   Associated names must be; "pwr-dwn", "sw-rst" and "pwr-rst"



Example:



	/* Example for stih407 family silicon */

	sata0: sata@9b20000 {

		compatible	= "st,ahci";

		reg		= <0x9b20000 0x1000>;

		interrupts	= <GIC_SPI 159 IRQ_TYPE_NONE>;

		interrupt-names	= "hostc";

		phys		= <&phy_port0 PHY_TYPE_SATA>;

		phy-names	= "ahci_phy";

		resets		= <&powerdown STIH407_SATA0_POWERDOWN>,

				  <&softreset STIH407_SATA0_SOFTRESET>,

				  <&softreset STIH407_SATA0_PWR_SOFTRESET>;

		reset-names	= "pwr-dwn", "sw-rst", "pwr-rst";

		clocks		= <&clk_s_c0_flexgen CLK_ICN_REG>;

		clock-names	= "ahci_clk";

	};

Documentation/devicetree/bindings/ata/st,ahci.yaml

0 → 100644
+72 −0
Original line number Diff line number Diff line 
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)

%YAML 1.2

---

$id: http://devicetree.org/schemas/ata/st,ahci.yaml#

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



title: STMicroelectronics STi SATA controller



maintainers:

  - Patrice Chotard <patrice.chotard@foss.st.com>



allOf:

  - $ref: ahci-common.yaml#



properties:

  compatible:

    const: st,ahci



  interrupt-names:

    items:

      - const: hostc



  clocks:

    maxItems: 1



  clock-names:

    items:

      - const: ahci_clk



  resets:

    items:

      - description: Power-down line

      - description: Soft-reset line

      - description: Power-reset line



  reset-names:

    items:

      - const: pwr-dwn

      - const: sw-rst

      - const: pwr-rst



required:

  - compatible

  - interrupt-names

  - phys

  - phy-names

  - clocks

  - clock-names



unevaluatedProperties: false



examples:

  - |

    #include <dt-bindings/interrupt-controller/arm-gic.h>

    #include <dt-bindings/phy/phy.h>

    #include <dt-bindings/reset/stih407-resets.h>

    #include <dt-bindings/clock/stih407-clks.h>



    sata@9b20000 {

        compatible    = "st,ahci";

        reg           = <0x9b20000 0x1000>;

        interrupts    = <GIC_SPI 159 IRQ_TYPE_NONE>;

        interrupt-names = "hostc";

        phys          = <&phy_port0 PHY_TYPE_SATA>;

        phy-names     = "sata-phy";

        resets        = <&powerdown STIH407_SATA0_POWERDOWN>,

                         <&softreset STIH407_SATA0_SOFTRESET>,

                         <&softreset STIH407_SATA0_PWR_SOFTRESET>;

        reset-names   = "pwr-dwn", "sw-rst", "pwr-rst";

        clocks        = <&clk_s_c0_flexgen CLK_ICN_REG>;

        clock-names   = "ahci_clk";

    };