From mboxrd@z Thu Jan 1 00:00:00 1970 From: lho@apm.com (Loc Ho) Date: Thu, 14 Nov 2013 12:31:57 -0700 Subject: [PATCH 1/3] Documentation: Add APM X-Gene SoC 6.0Gbps SATA PHY driver binding documentation In-Reply-To: <1384457519-21335-1-git-send-email-lho@apm.com> References: <1384457519-21335-1-git-send-email-lho@apm.com> Message-ID: <1384457519-21335-2-git-send-email-lho@apm.com> To: linux-arm-kernel@lists.infradead.org List-Id: linux-arm-kernel.lists.infradead.org Documentation: Add APM X-Gene SoC 6.0Gbps SATA PHY driver binding documentation Document the DTS binding for the X-Gene SoC SATA PHY driver. Signed-off-by: Loc Ho Signed-off-by: Tuan Phan Signed-off-by: Suman Tripathi Reviewed-by: Arnd Bergmann Reviewed-by: Olof Johansson --- .../devicetree/bindings/ata/apm-xgene.txt | 69 ++++++++++++++++++++ 1 files changed, 69 insertions(+), 0 deletions(-) create mode 100644 Documentation/devicetree/bindings/ata/apm-xgene.txt diff --git a/Documentation/devicetree/bindings/ata/apm-xgene.txt b/Documentation/devicetree/bindings/ata/apm-xgene.txt new file mode 100644 index 0000000..d18db67 --- /dev/null +++ b/Documentation/devicetree/bindings/ata/apm-xgene.txt @@ -0,0 +1,69 @@ +* APM X-Gene 6.0 Gb/s SATA PHY nodes + +SATA PHY nodes are defined to describe on-chip Serial ATA PHY. Each SATA PHY +(pair of PHY) has its own node. + +Required properties: +- compatible : Shall be "apm,xgene-ahci-phy" +- reg : First memory resource shall be the PHY memory resource + Second memory resource shall be the optional PHY + memory resource if mux'ed with another IP +- id : PHY ID (0 = first, 1 = second, 2 = third) +- #phy-cells : Shall be 0 + +Optional properties: +- status : Shall be "ok" if enabled or "na" if disabled. Default + is "ok". +- CTLE0 : PHY override parameters for channel 0 register REG1 + field CTLE_EQ. First value for Gen1, second value + for Gen2, and third value for Gen3. Default is 0x2. +- CTLE1 : PHY override parameters for channel 1 register REG1 + field CTLE_EQ. First value for Gen1, second value + for Gen2, and third value for Gen3. Default is 0x2. +- PQ0 : PHY override parameters for channel 0 register REG125 + field PQ_REG. First value for Gen1, second value + for Gen2, and third value for Gen3. Default is 0xA. +- PQ1 : PHY override parameters for channel 1 register REG125 + field PQ_REG. First value for Gen1, second value + for Gen2, and third value for Gen3. Default is 0xA. +- PQS0 : PHY override parameters for channel 0 register REG125 + field PQ_SIGN. First value for Gen1, second value + for Gen2, and third value for Gen3. Default is 0x1. +- PQS1 : PHY override parameters for channel 1 register REG125 + field PQ_SIGN. First value for Gen1, second value + for Gen2, and third value for Gen3. Default is 0x1. +- SPD0 : PHY override parameters for channel 0 register REG61 + field PQ_SIGN. First value for Gen1, second value + for Gen2, and third value for Gen3. Default is 0x5. +- SPD1 : PHY override parameters for channel 1 register REG61 + field PQ_SIGN. First value for Gen1, second value + for Gen2, and third value for Gen3. Default is 0x5. + +NOTE: PHY override parameters are board specific setting. + +Example: + sataphy0: sataphy at 1f210000 { + compatible = "apm,xgene-ahci-phy"; + id = <0>; + reg = <0x0 0x1f210000 0x0 0x10000>; + #phy-cells = <0>; + status = "na"; + }; + + sataphy1: sataphy at 1f220000 { + compatible = "apm,xgene-ahci-phy"; + id = <1>; + reg = <0x0 0x1f220000 0x0 0x10000>; + #phy-cells = <0>; + status = "ok"; + }; + + sataphy2: sataphy at 1f230000 { + compatible = "apm,xgene-ahci-phy"; + id = <2>; + reg = <0x0 0x1f230000 0x0 0x10000 + 0x0 0x1f2d0000 0x0 0x10000 >; + #phy-cells = <0>; + status = "ok"; + }; + -- 1.5.5