Merge tag 'for-v4.6/gxbb-dt' of https://github.com/carlocaione/linux-meson into next...
[cascardo/linux.git] / Documentation / devicetree / bindings / ata / ahci-platform.txt
1 * AHCI SATA Controller
2
3 SATA nodes are defined to describe on-chip Serial ATA controllers.
4 Each SATA controller should have its own node.
5
6 It is possible, but not required, to represent each port as a sub-node.
7 It allows to enable each port independently when dealing with multiple
8 PHYs.
9
10 Required properties:
11 - compatible        : compatible string, one of:
12   - "allwinner,sun4i-a10-ahci"
13   - "hisilicon,hisi-ahci"
14   - "ibm,476gtr-ahci"
15   - "marvell,armada-380-ahci"
16   - "marvell,armada-3700-ahci"
17   - "snps,dwc-ahci"
18   - "snps,exynos5440-ahci"
19   - "snps,spear-ahci"
20   - "generic-ahci"
21 - interrupts        : <interrupt mapping for SATA IRQ>
22 - reg               : <registers mapping>
23
24 Please note that when using "generic-ahci" you must also specify a SoC specific
25 compatible:
26         compatible = "manufacturer,soc-model-ahci", "generic-ahci";
27
28 Optional properties:
29 - dma-coherent      : Present if dma operations are coherent
30 - clocks            : a list of phandle + clock specifier pairs
31 - target-supply     : regulator for SATA target power
32 - phys              : reference to the SATA PHY node
33 - phy-names         : must be "sata-phy"
34
35 Required properties when using sub-nodes:
36 - #address-cells    : number of cells to encode an address
37 - #size-cells       : number of cells representing the size of an address
38
39
40 Sub-nodes required properties:
41 - reg               : the port number
42 And at least one of the following properties:
43 - phys              : reference to the SATA PHY node
44 - target-supply    : regulator for SATA target power
45
46 Examples:
47         sata@ffe08000 {
48                 compatible = "snps,spear-ahci";
49                 reg = <0xffe08000 0x1000>;
50                 interrupts = <115>;
51         };
52
53         ahci: sata@01c18000 {
54                 compatible = "allwinner,sun4i-a10-ahci";
55                 reg = <0x01c18000 0x1000>;
56                 interrupts = <56>;
57                 clocks = <&pll6 0>, <&ahb_gates 25>;
58                 target-supply = <&reg_ahci_5v>;
59         };
60
61 With sub-nodes:
62         sata@f7e90000 {
63                 compatible = "marvell,berlin2q-achi", "generic-ahci";
64                 reg = <0xe90000 0x1000>;
65                 interrupts = <GIC_SPI 7 IRQ_TYPE_LEVEL_HIGH>;
66                 clocks = <&chip CLKID_SATA>;
67                 #address-cells = <1>;
68                 #size-cells = <0>;
69
70                 sata0: sata-port@0 {
71                         reg = <0>;
72                         phys = <&sata_phy 0>;
73                         target-supply = <&reg_sata0>;
74                 };
75
76                 sata1: sata-port@1 {
77                         reg = <1>;
78                         phys = <&sata_phy 1>;
79                         target-supply = <&reg_sata1>;;
80                 };
81         };