Commit fb673925 authored by Florian Fainelli's avatar Florian Fainelli Committed by Rob Herring
Browse files

dt-bindings: ata: Convert Broadcom SATA to YAML 



Convert the Broadcom SATA3 AHCI controller Device Tree binding to YAML
to help with validation.

Acked-by: default avatarDamien Le Moal <damien.lemoal@opensource.wdc.com>
Signed-off-by: default avatarFlorian Fainelli <f.fainelli@gmail.com>
Signed-off-by: default avatarRob Herring <robh@kernel.org>
Link: https://lore.kernel.org/r/20211217042001.479577-5-f.fainelli@gmail.com
parent 1f012283

Documentation/devicetree/bindings/ata/brcm,sata-brcm.txt

deleted100644 → 0
+0 −45
Original line number Diff line number Diff line 
* Broadcom SATA3 AHCI Controller



SATA nodes are defined to describe on-chip Serial ATA controllers.

Each SATA controller should have its own node.



Required properties:

- compatible         : should be one or more of

			"brcm,bcm7216-ahci"

			"brcm,bcm7425-ahci"

			"brcm,bcm7445-ahci"

			"brcm,bcm-nsp-ahci"

			"brcm,sata3-ahci"

			"brcm,bcm63138-ahci"

- reg                : register mappings for AHCI and SATA_TOP_CTRL

- reg-names          : "ahci" and "top-ctrl"

- interrupts         : interrupt mapping for SATA IRQ



Optional properties:



- reset: for "brcm,bcm7216-ahci" must be a valid reset phandle

  pointing to the RESCAL reset controller provider node.

- reset-names: for "brcm,bcm7216-ahci", must be "rescal".



Also see ahci-platform.txt.



Example:



	sata@f045a000 {

		compatible = "brcm,bcm7445-ahci", "brcm,sata3-ahci";

		reg = <0xf045a000 0xa9c>, <0xf0458040 0x24>;

		reg-names = "ahci", "top-ctrl";

		interrupts = <0 30 0>;

		#address-cells = <1>;

		#size-cells = <0>;



		sata0: sata-port@0 {

			reg = <0>;

			phys = <&sata_phy 0>;

		};



		sata1: sata-port@1 {

			reg = <1>;

			phys = <&sata_phy 1>;

		};

	};

Documentation/devicetree/bindings/ata/brcm,sata-brcm.yaml

0 → 100644
+90 −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/brcm,sata-brcm.yaml#

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



title: Broadcom SATA3 AHCI Controller



description:

  SATA nodes are defined to describe on-chip Serial ATA controllers.

  Each SATA controller should have its own node.



maintainers:

  - Florian Fainelli <f.fainelli@gmail.com>



allOf:

  - $ref: sata-common.yaml#



properties:

  compatible:

    oneOf:

      - items:

          - enum:

              - brcm,bcm7216-ahci

              - brcm,bcm7445-ahci

              - brcm,bcm7425-ahci

              - brcm,bcm63138-ahci

          - const: brcm,sata3-ahci

      - items:

          - const: brcm,bcm-nsp-ahci



  reg:

    minItems: 2

    maxItems: 2



  reg-names:

    items:

      - const: ahci

      - const: top-ctrl



  interrupts:

    maxItems: 1



  dma-coherent: true



if:

  properties:

    compatible:

      contains:

        enum:

          - brcm,bcm7216-ahci

          - brcm,bcm63138-ahci

then:

  properties:

    resets:

      maxItems: 1

    reset-names:

      enum:

        - rescal

        - ahci



required:

  - compatible

  - reg

  - interrupts

  - "#address-cells"

  - "#size-cells"



unevaluatedProperties: false



examples:

  - |

    sata@f045a000 {

        compatible = "brcm,bcm7445-ahci", "brcm,sata3-ahci";

        reg = <0xf045a000 0xa9c>, <0xf0458040 0x24>;

        reg-names = "ahci", "top-ctrl";

        interrupts = <0 30 0>;

        #address-cells = <1>;

        #size-cells = <0>;



        sata0: sata-port@0 {

            reg = <0>;

            phys = <&sata_phy 0>;

        };



        sata1: sata-port@1 {

            reg = <1>;

            phys = <&sata_phy 1>;

        };

    };