Documentation:: Add documentation for APM X-Gene SoC SATA host controller DTS 
binding

Signed-off-by: Loc Ho <[email protected]>
Signed-off-by: Tuan Phan <[email protected]>
Signed-off-by: Suman Tripathi <[email protected]>
Reviewed-by: Arnd Bergmann <[email protected]>
Reviewed-by: Olof Johansson <[email protected]>
---
 .../devicetree/bindings/ata/apm-xgene.txt          |   62 +++++++++++++++++++-
 1 files changed, 61 insertions(+), 1 deletions(-)

diff --git a/Documentation/devicetree/bindings/ata/apm-xgene.txt 
b/Documentation/devicetree/bindings/ata/apm-xgene.txt
index d18db67..0d16bfe 100644
--- a/Documentation/devicetree/bindings/ata/apm-xgene.txt
+++ b/Documentation/devicetree/bindings/ata/apm-xgene.txt
@@ -1,4 +1,4 @@
-* APM X-Gene 6.0 Gb/s SATA PHY nodes
+* APM X-Gene 6.0 Gb/s SATA PHY and controller nodes
 
 SATA PHY nodes are defined to describe on-chip Serial ATA PHY. Each SATA PHY
 (pair of PHY) has its own node.
@@ -67,3 +67,63 @@ Example:
                        status = "ok";
                };
 
+SATA host controller nodes are defined to describe on-chip Serial ATA
+controllers. Each SATA controller (pair of ports) have its own node.
+
+Required properties:
+- compatible           : Shall be "apm,xgene-ahci"
+- reg                  : First memory resource shall be the AHCI memory
+                         resource.
+                         Second memory resource shall be the host controller
+                         memory resource.
+- id                   : Controller ID (0 = first, 1 = second, 2 = third)
+- interrupt-parent     : Interrupt controller
+- interrupts           : Interrupt mapping for SATA host controller IRQ
+- clocks               : Reference to the clock entry
+- phys                 : PHY reference
+- phy-names            : Name of the PHY reference
+
+Optional properties:
+- status               : Shall be "ok" if enabled or "na" if disabled.
+                         Default is "ok".
+
+Example:
+               sata0: sata@1a000000 {
+                       compatible = "apm,xgene-ahci";
+                       id = <0>;
+                       reg =  <0x0 0x1a000000 0x0 0x100000
+                               0x0 0x1f210000 0x0 0x10000>;
+                       interrupt-parent = <&gic>;
+                       interrupts = <0x0 0x86 0x4>;
+                       clocks = <&eth01clk 0>;
+                       status = "na";
+                       phys = <&sataphy0>;
+                       phy-names = "sataphy0";
+               };
+
+               sata1: sata@1a400000 {
+                       compatible = "apm,xgene-ahci";
+                       id = <1>;
+                       reg =  <0x0 0x1a400000 0x0 0x100000
+                               0x0 0x1f220000 0x0 0x10000>;
+                       interrupt-parent = <&gic>;
+                       interrupts = <0x0 0x87 0x4>;
+                       clocks = <&eth23clk 0>;
+                       status = "ok";
+                       phys = <&sataphy1>;
+                       phy-names = "sataphy1";
+               };
+
+               sata2: sata@1a800000 {
+                       compatible = "apm,xgene-ahci";
+                       id = <2>;
+                       reg =  <0x0 0x1a800000 0x0 0x100000
+                               0x0 0x1f230000 0x0 0x10000
+                               0x0 0x1f2d0000 0x0 0x10000 >;
+                       interrupt-parent = <&gic>;
+                       interrupts = <0x0 0x88 0x4>;
+                       clocks = <&sata45clk 0>;
+                       status = "ok";
+                       phys = <&sataphy2>;
+                       phy-names = "sataphy2";
+               };
-- 
1.5.5

--
To unsubscribe from this list: send the line "unsubscribe devicetree" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Reply via email to