1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) 2%YAML 1.2 3--- 4$id: http://devicetree.org/schemas/ata/ceva,ahci-1v84.yaml# 5$schema: http://devicetree.org/meta-schemas/core.yaml# 6 7title: Ceva AHCI SATA Controller 8 9maintainers: 10 - Piyush Mehta <piyush.mehta@xilinx.com> 11 12description: | 13 The Ceva SATA controller mostly conforms to the AHCI interface with some 14 special extensions to add functionality, is a high-performance dual-port 15 SATA host controller with an AHCI compliant command layer which supports 16 advanced features such as native command queuing and frame information 17 structure (FIS) based switching for systems employing port multipliers. 18 19properties: 20 compatible: 21 const: ceva,ahci-1v84 22 23 reg: 24 maxItems: 1 25 26 clocks: 27 maxItems: 1 28 29 dma-coherent: true 30 31 interrupts: 32 maxItems: 1 33 34 iommus: 35 maxItems: 4 36 37 power-domains: 38 maxItems: 1 39 40 ceva,p0-cominit-params: 41 $ref: /schemas/types.yaml#/definitions/uint8-array 42 description: | 43 OOB timing value for COMINIT parameter for port 0. 44 The fields for the above parameter must be as shown below:- 45 ceva,p0-cominit-params = /bits/ 8 <CIBGMN CIBGMX CIBGN CINMP>; 46 items: 47 - description: CINMP - COMINIT Negate Minimum Period. 48 - description: CIBGN - COMINIT Burst Gap Nominal. 49 - description: CIBGMX - COMINIT Burst Gap Maximum. 50 - description: CIBGMN - COMINIT Burst Gap Minimum. 51 52 ceva,p0-comwake-params: 53 $ref: /schemas/types.yaml#/definitions/uint8-array 54 description: | 55 OOB timing value for COMWAKE parameter for port 0. 56 The fields for the above parameter must be as shown below:- 57 ceva,p0-comwake-params = /bits/ 8 <CWBGMN CWBGMX CWBGN CWNMP>; 58 items: 59 - description: CWBGMN - COMWAKE Burst Gap Minimum. 60 - description: CWBGMX - COMWAKE Burst Gap Maximum. 61 - description: CWBGN - COMWAKE Burst Gap Nominal. 62 - description: CWNMP - COMWAKE Negate Minimum Period. 63 64 ceva,p0-burst-params: 65 $ref: /schemas/types.yaml#/definitions/uint8-array 66 description: | 67 Burst timing value for COM parameter for port 0. 68 The fields for the above parameter must be as shown below:- 69 ceva,p0-burst-params = /bits/ 8 <BMX BNM SFD PTST>; 70 items: 71 - description: BMX - COM Burst Maximum. 72 - description: BNM - COM Burst Nominal. 73 - description: SFD - Signal Failure Detection value. 74 - description: PTST - Partial to Slumber timer value. 75 76 ceva,p0-retry-params: 77 $ref: /schemas/types.yaml#/definitions/uint16-array 78 description: | 79 Retry interval timing value for port 0. 80 The fields for the above parameter must be as shown below:- 81 ceva,p0-retry-params = /bits/ 16 <RIT RCT>; 82 items: 83 - description: RIT - Retry Interval Timer. 84 - description: RCT - Rate Change Timer. 85 86 ceva,p1-cominit-params: 87 $ref: /schemas/types.yaml#/definitions/uint8-array 88 description: | 89 OOB timing value for COMINIT parameter for port 1. 90 The fields for the above parameter must be as shown below:- 91 ceva,p1-cominit-params = /bits/ 8 <CIBGMN CIBGMX CIBGN CINMP>; 92 items: 93 - description: CINMP - COMINIT Negate Minimum Period. 94 - description: CIBGN - COMINIT Burst Gap Nominal. 95 - description: CIBGMX - COMINIT Burst Gap Maximum. 96 - description: CIBGMN - COMINIT Burst Gap Minimum. 97 98 ceva,p1-comwake-params: 99 $ref: /schemas/types.yaml#/definitions/uint8-array 100 description: | 101 OOB timing value for COMWAKE parameter for port 1. 102 The fields for the above parameter must be as shown below:- 103 ceva,p1-comwake-params = /bits/ 8 <CWBGMN CWBGMX CWBGN CWNMP>; 104 items: 105 - description: CWBGMN - COMWAKE Burst Gap Minimum. 106 - description: CWBGMX - COMWAKE Burst Gap Maximum. 107 - description: CWBGN - COMWAKE Burst Gap Nominal. 108 - description: CWNMP - COMWAKE Negate Minimum Period. 109 110 ceva,p1-burst-params: 111 $ref: /schemas/types.yaml#/definitions/uint8-array 112 description: | 113 Burst timing value for COM parameter for port 1. 114 The fields for the above parameter must be as shown below:- 115 ceva,p1-burst-params = /bits/ 8 <BMX BNM SFD PTST>; 116 items: 117 - description: BMX - COM Burst Maximum. 118 - description: BNM - COM Burst Nominal. 119 - description: SFD - Signal Failure Detection value. 120 - description: PTST - Partial to Slumber timer value. 121 122 ceva,p1-retry-params: 123 $ref: /schemas/types.yaml#/definitions/uint16-array 124 description: | 125 Retry interval timing value for port 1. 126 The fields for the above parameter must be as shown below:- 127 ceva,pN-retry-params = /bits/ 16 <RIT RCT>; 128 items: 129 - description: RIT - Retry Interval Timer. 130 - description: RCT - Rate Change Timer. 131 132 ceva,broken-gen2: 133 $ref: /schemas/types.yaml#/definitions/flag 134 description: | 135 limit to gen1 speed instead of gen2. 136 137 phys: 138 maxItems: 1 139 140 phy-names: 141 items: 142 - const: sata-phy 143 144 resets: 145 maxItems: 1 146 147required: 148 - compatible 149 - reg 150 - clocks 151 - interrupts 152 - ceva,p0-cominit-params 153 - ceva,p0-comwake-params 154 - ceva,p0-burst-params 155 - ceva,p0-retry-params 156 - ceva,p1-cominit-params 157 - ceva,p1-comwake-params 158 - ceva,p1-burst-params 159 - ceva,p1-retry-params 160 161additionalProperties: false 162 163examples: 164 - | 165 #include <dt-bindings/clock/xlnx-zynqmp-clk.h> 166 #include <dt-bindings/interrupt-controller/irq.h> 167 #include <dt-bindings/power/xlnx-zynqmp-power.h> 168 #include <dt-bindings/reset/xlnx-zynqmp-resets.h> 169 #include <dt-bindings/clock/xlnx-zynqmp-clk.h> 170 #include <dt-bindings/phy/phy.h> 171 172 sata: ahci@fd0c0000 { 173 compatible = "ceva,ahci-1v84"; 174 reg = <0xfd0c0000 0x200>; 175 interrupt-parent = <&gic>; 176 interrupts = <0 133 IRQ_TYPE_LEVEL_HIGH>; 177 clocks = <&zynqmp_clk SATA_REF>; 178 ceva,p0-cominit-params = /bits/ 8 <0x0F 0x25 0x18 0x29>; 179 ceva,p0-comwake-params = /bits/ 8 <0x04 0x0B 0x08 0x0F>; 180 ceva,p0-burst-params = /bits/ 8 <0x0A 0x08 0x4A 0x06>; 181 ceva,p0-retry-params = /bits/ 16 <0x0216 0x7F06>; 182 ceva,p1-cominit-params = /bits/ 8 <0x0F 0x25 0x18 0x29>; 183 ceva,p1-comwake-params = /bits/ 8 <0x04 0x0B 0x08 0x0F>; 184 ceva,p1-burst-params = /bits/ 8 <0x0A 0x08 0x4A 0x06>; 185 ceva,p1-retry-params = /bits/ 16 <0x0216 0x7F06>; 186 ceva,broken-gen2; 187 phys = <&psgtr 1 PHY_TYPE_SATA 1 1>; 188 resets = <&zynqmp_reset ZYNQMP_RESET_SATA>; 189 }; 190