1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) 2%YAML 1.2 3--- 4$id: "http://devicetree.org/schemas/mmc/arasan,sdhci.yaml#" 5$schema: "http://devicetree.org/meta-schemas/core.yaml#" 6 7title: Device Tree Bindings for the Arasan SDHCI Controller 8 9maintainers: 10 - Adrian Hunter <adrian.hunter@intel.com> 11 12allOf: 13 - $ref: "mmc-controller.yaml#" 14 - if: 15 properties: 16 compatible: 17 contains: 18 const: arasan,sdhci-5.1 19 then: 20 required: 21 - phys 22 - phy-names 23 - if: 24 properties: 25 compatible: 26 contains: 27 enum: 28 - xlnx,zynqmp-8.9a 29 - xlnx,versal-8.9a 30 then: 31 properties: 32 clock-output-names: 33 oneOf: 34 - items: 35 - const: clk_out_sd0 36 - const: clk_in_sd0 37 - items: 38 - const: clk_out_sd1 39 - const: clk_in_sd1 40 41properties: 42 compatible: 43 oneOf: 44 - const: arasan,sdhci-8.9a # generic Arasan SDHCI 8.9a PHY 45 - const: arasan,sdhci-4.9a # generic Arasan SDHCI 4.9a PHY 46 - const: arasan,sdhci-5.1 # generic Arasan SDHCI 5.1 PHY 47 - items: 48 - const: rockchip,rk3399-sdhci-5.1 # rk3399 eMMC PHY 49 - const: arasan,sdhci-5.1 50 description: 51 For this device it is strongly suggested to include 52 arasan,soc-ctl-syscon. 53 - items: 54 - const: xlnx,zynqmp-8.9a # ZynqMP SDHCI 8.9a PHY 55 - const: arasan,sdhci-8.9a 56 description: 57 For this device it is strongly suggested to include 58 clock-output-names and '#clock-cells'. 59 - items: 60 - const: xlnx,versal-8.9a # Versal SDHCI 8.9a PHY 61 - const: arasan,sdhci-8.9a 62 description: 63 For this device it is strongly suggested to include 64 clock-output-names and '#clock-cells'. 65 - items: 66 - const: intel,lgm-sdhci-5.1-emmc # Intel LGM eMMC PHY 67 - const: arasan,sdhci-5.1 68 description: 69 For this device it is strongly suggested to include 70 arasan,soc-ctl-syscon. 71 - items: 72 - const: intel,lgm-sdhci-5.1-sdxc # Intel LGM SDXC PHY 73 - const: arasan,sdhci-5.1 74 description: 75 For this device it is strongly suggested to include 76 arasan,soc-ctl-syscon. 77 - items: 78 - const: intel,keembay-sdhci-5.1-emmc # Intel Keem Bay eMMC PHY 79 - const: arasan,sdhci-5.1 80 description: 81 For this device it is strongly suggested to include 82 arasan,soc-ctl-syscon. 83 - const: intel,keembay-sdhci-5.1-sd # Intel Keem Bay SD controller 84 description: 85 For this device it is strongly suggested to include 86 arasan,soc-ctl-syscon. 87 - const: intel,keembay-sdhci-5.1-sdio # Intel Keem Bay SDIO controller 88 description: 89 For this device it is strongly suggested to include 90 arasan,soc-ctl-syscon. 91 - items: 92 - const: intel,thunderbay-sdhci-5.1 # Intel Thunder Bay eMMC PHY 93 - const: arasan,sdhci-5.1 94 description: 95 For this device it is strongly suggested to include 96 clock-output-names and '#clock-cells'. 97 98 reg: 99 maxItems: 1 100 101 clocks: 102 minItems: 2 103 maxItems: 3 104 105 clock-names: 106 minItems: 2 107 items: 108 - const: clk_xin 109 - const: clk_ahb 110 - const: gate 111 112 interrupts: 113 maxItems: 1 114 115 phys: 116 maxItems: 1 117 118 phy-names: 119 const: phy_arasan 120 121 resets: 122 maxItems: 1 123 124 arasan,soc-ctl-syscon: 125 $ref: /schemas/types.yaml#/definitions/phandle 126 description: 127 A phandle to a syscon device (see ../mfd/syscon.txt) used to access 128 core corecfg registers. Offsets of registers in this syscon are 129 determined based on the main compatible string for the device. 130 131 clock-output-names: 132 minItems: 1 133 maxItems: 2 134 description: 135 Name of the card clock which will be exposed by this device. 136 137 '#clock-cells': 138 enum: [0, 1] 139 description: 140 With this property in place we will export one or two clocks 141 representing the Card Clock. These clocks are expected to be 142 consumed by our PHY. 143 144 xlnx,fails-without-test-cd: 145 $ref: /schemas/types.yaml#/definitions/flag 146 description: 147 When present, the controller doesn't work when the CD line is not 148 connected properly, and the line is not connected properly. 149 Test mode can be used to force the controller to function. 150 151 xlnx,int-clock-stable-broken: 152 $ref: /schemas/types.yaml#/definitions/flag 153 description: 154 When present, the controller always reports that the internal clock 155 is stable even when it is not. 156 157 xlnx,mio-bank: 158 $ref: /schemas/types.yaml#/definitions/uint32 159 enum: [0, 1, 2] 160 default: 0 161 description: 162 The MIO bank number in which the command and data lines are configured. 163 164dependencies: 165 '#clock-cells': [ clock-output-names ] 166 167required: 168 - compatible 169 - reg 170 - interrupts 171 - clocks 172 - clock-names 173 174unevaluatedProperties: false 175 176examples: 177 - | 178 mmc@e0100000 { 179 compatible = "arasan,sdhci-8.9a"; 180 reg = <0xe0100000 0x1000>; 181 clock-names = "clk_xin", "clk_ahb"; 182 clocks = <&clkc 21>, <&clkc 32>; 183 interrupt-parent = <&gic>; 184 interrupts = <0 24 4>; 185 }; 186 187 - | 188 mmc@e2800000 { 189 compatible = "arasan,sdhci-5.1"; 190 reg = <0xe2800000 0x1000>; 191 clock-names = "clk_xin", "clk_ahb"; 192 clocks = <&cru 8>, <&cru 18>; 193 interrupt-parent = <&gic>; 194 interrupts = <0 24 4>; 195 phys = <&emmc_phy>; 196 phy-names = "phy_arasan"; 197 }; 198 199 - | 200 #include <dt-bindings/clock/rk3399-cru.h> 201 #include <dt-bindings/interrupt-controller/arm-gic.h> 202 #include <dt-bindings/interrupt-controller/irq.h> 203 mmc@fe330000 { 204 compatible = "rockchip,rk3399-sdhci-5.1", "arasan,sdhci-5.1"; 205 reg = <0xfe330000 0x10000>; 206 interrupts = <GIC_SPI 11 IRQ_TYPE_LEVEL_HIGH>; 207 clocks = <&cru SCLK_EMMC>, <&cru ACLK_EMMC>; 208 clock-names = "clk_xin", "clk_ahb"; 209 arasan,soc-ctl-syscon = <&grf>; 210 assigned-clocks = <&cru SCLK_EMMC>; 211 assigned-clock-rates = <200000000>; 212 clock-output-names = "emmc_cardclock"; 213 phys = <&emmc_phy>; 214 phy-names = "phy_arasan"; 215 #clock-cells = <0>; 216 }; 217 218 - | 219 mmc@ff160000 { 220 compatible = "xlnx,zynqmp-8.9a", "arasan,sdhci-8.9a"; 221 interrupt-parent = <&gic>; 222 interrupts = <0 48 4>; 223 reg = <0xff160000 0x1000>; 224 clocks = <&clk200>, <&clk200>; 225 clock-names = "clk_xin", "clk_ahb"; 226 clock-output-names = "clk_out_sd0", "clk_in_sd0"; 227 #clock-cells = <1>; 228 clk-phase-sd-hs = <63>, <72>; 229 }; 230 231 - | 232 mmc@f1040000 { 233 compatible = "xlnx,versal-8.9a", "arasan,sdhci-8.9a"; 234 interrupt-parent = <&gic>; 235 interrupts = <0 126 4>; 236 reg = <0xf1040000 0x10000>; 237 clocks = <&clk200>, <&clk200>; 238 clock-names = "clk_xin", "clk_ahb"; 239 clock-output-names = "clk_out_sd0", "clk_in_sd0"; 240 #clock-cells = <1>; 241 clk-phase-sd-hs = <132>, <60>; 242 }; 243 244 - | 245 #define LGM_CLK_EMMC5 246 #define LGM_CLK_NGI 247 #define LGM_GCLK_EMMC 248 mmc@ec700000 { 249 compatible = "intel,lgm-sdhci-5.1-emmc", "arasan,sdhci-5.1"; 250 reg = <0xec700000 0x300>; 251 interrupt-parent = <&ioapic1>; 252 interrupts = <44 1>; 253 clocks = <&cgu0 LGM_CLK_EMMC5>, <&cgu0 LGM_CLK_NGI>, 254 <&cgu0 LGM_GCLK_EMMC>; 255 clock-names = "clk_xin", "clk_ahb", "gate"; 256 clock-output-names = "emmc_cardclock"; 257 #clock-cells = <0>; 258 phys = <&emmc_phy>; 259 phy-names = "phy_arasan"; 260 arasan,soc-ctl-syscon = <&sysconf>; 261 }; 262 263 - | 264 #define LGM_CLK_SDIO 265 #define LGM_GCLK_SDXC 266 mmc@ec600000 { 267 compatible = "intel,lgm-sdhci-5.1-sdxc", "arasan,sdhci-5.1"; 268 reg = <0xec600000 0x300>; 269 interrupt-parent = <&ioapic1>; 270 interrupts = <43 1>; 271 clocks = <&cgu0 LGM_CLK_SDIO>, <&cgu0 LGM_CLK_NGI>, 272 <&cgu0 LGM_GCLK_SDXC>; 273 clock-names = "clk_xin", "clk_ahb", "gate"; 274 clock-output-names = "sdxc_cardclock"; 275 #clock-cells = <0>; 276 phys = <&sdxc_phy>; 277 phy-names = "phy_arasan"; 278 arasan,soc-ctl-syscon = <&sysconf>; 279 }; 280 281 - | 282 #define KEEM_BAY_PSS_AUX_EMMC 283 #define KEEM_BAY_PSS_EMMC 284 mmc@33000000 { 285 compatible = "intel,keembay-sdhci-5.1-emmc", "arasan,sdhci-5.1"; 286 interrupts = <GIC_SPI 82 IRQ_TYPE_LEVEL_HIGH>; 287 reg = <0x33000000 0x300>; 288 clock-names = "clk_xin", "clk_ahb"; 289 clocks = <&scmi_clk KEEM_BAY_PSS_AUX_EMMC>, 290 <&scmi_clk KEEM_BAY_PSS_EMMC>; 291 phys = <&emmc_phy>; 292 phy-names = "phy_arasan"; 293 assigned-clocks = <&scmi_clk KEEM_BAY_PSS_AUX_EMMC>; 294 assigned-clock-rates = <200000000>; 295 clock-output-names = "emmc_cardclock"; 296 #clock-cells = <0>; 297 arasan,soc-ctl-syscon = <&mmc_phy_syscon>; 298 }; 299 300 - | 301 #define KEEM_BAY_PSS_AUX_SD0 302 #define KEEM_BAY_PSS_SD0 303 mmc@31000000 { 304 compatible = "intel,keembay-sdhci-5.1-sd"; 305 interrupts = <GIC_SPI 83 IRQ_TYPE_LEVEL_HIGH>; 306 reg = <0x31000000 0x300>; 307 clock-names = "clk_xin", "clk_ahb"; 308 clocks = <&scmi_clk KEEM_BAY_PSS_AUX_SD0>, 309 <&scmi_clk KEEM_BAY_PSS_SD0>; 310 arasan,soc-ctl-syscon = <&sd0_phy_syscon>; 311 }; 312 313 - | 314 #define EMMC_XIN_CLK 315 #define EMMC_AXI_CLK 316 #define TBH_PSS_EMMC_RST_N 317 mmc@80420000 { 318 compatible = "intel,thunderbay-sdhci-5.1", "arasan,sdhci-5.1"; 319 interrupts = <GIC_SPI 714 IRQ_TYPE_LEVEL_HIGH>; 320 reg = <0x80420000 0x400>; 321 clocks = <&scmi_clk EMMC_XIN_CLK>, 322 <&scmi_clk EMMC_AXI_CLK>; 323 clock-names = "clk_xin", "clk_ahb"; 324 phys = <&emmc_phy>; 325 phy-names = "phy_arasan"; 326 assigned-clocks = <&scmi_clk EMMC_XIN_CLK>; 327 clock-output-names = "emmc_cardclock"; 328 resets = <&rst_pss1 TBH_PSS_EMMC_RST_N>; 329 #clock-cells = <0x0>; 330 }; 331