1 # SPDX-License-Identifier: GPL-2.0-only OR BSD 1 # SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
2 %YAML 1.2 2 %YAML 1.2
3 --- 3 ---
4 $id: http://devicetree.org/schemas/mmc/samsung 4 $id: http://devicetree.org/schemas/mmc/samsung,exynos-dw-mshc.yaml#
5 $schema: http://devicetree.org/meta-schemas/co 5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6 6
7 title: 7 title:
8 Samsung Exynos SoC specific extensions to th 8 Samsung Exynos SoC specific extensions to the Synopsys Designware Mobile
9 Storage Host Controller 9 Storage Host Controller
10 10
11 maintainers: 11 maintainers:
12 - Jaehoon Chung <jh80.chung@samsung.com> 12 - Jaehoon Chung <jh80.chung@samsung.com>
13 - Krzysztof Kozlowski <krzk@kernel.org> 13 - Krzysztof Kozlowski <krzk@kernel.org>
14 14
15 properties: 15 properties:
16 compatible: 16 compatible:
17 oneOf: !! 17 enum:
18 - enum: !! 18 - samsung,exynos4210-dw-mshc
19 - axis,artpec8-dw-mshc !! 19 - samsung,exynos4412-dw-mshc
20 - samsung,exynos4210-dw-mshc !! 20 - samsung,exynos5250-dw-mshc
21 - samsung,exynos4412-dw-mshc !! 21 - samsung,exynos5420-dw-mshc
22 - samsung,exynos5250-dw-mshc !! 22 - samsung,exynos5420-dw-mshc-smu
23 - samsung,exynos5420-dw-mshc !! 23 - samsung,exynos7-dw-mshc
24 - samsung,exynos5420-dw-mshc-smu !! 24 - samsung,exynos7-dw-mshc-smu
25 - samsung,exynos7-dw-mshc !! 25 - axis,artpec8-dw-mshc
26 - samsung,exynos7-dw-mshc-smu <<
27 - items: <<
28 - enum: <<
29 - samsung,exynos5433-dw-mshc-smu <<
30 - samsung,exynos7885-dw-mshc-smu <<
31 - samsung,exynos850-dw-mshc-smu <<
32 - const: samsung,exynos7-dw-mshc-smu <<
33 26
34 reg: 27 reg:
35 maxItems: 1 28 maxItems: 1
36 29
37 interrupts: 30 interrupts:
38 maxItems: 1 31 maxItems: 1
39 32
40 clocks: 33 clocks:
41 maxItems: 2 34 maxItems: 2
42 description: 35 description:
43 Handle to "biu" and "ciu" clocks for the 36 Handle to "biu" and "ciu" clocks for the
44 bus interface unit clock and the card in 37 bus interface unit clock and the card interface unit clock.
45 38
46 clock-names: 39 clock-names:
47 items: 40 items:
48 - const: biu 41 - const: biu
49 - const: ciu 42 - const: ciu
50 43
51 samsung,dw-mshc-ciu-div: 44 samsung,dw-mshc-ciu-div:
52 $ref: /schemas/types.yaml#/definitions/uin 45 $ref: /schemas/types.yaml#/definitions/uint32
53 minimum: 0 46 minimum: 0
54 maximum: 7 47 maximum: 7
55 description: 48 description:
56 The divider value for the card interface 49 The divider value for the card interface unit (ciu) clock.
57 50
58 samsung,dw-mshc-ddr-timing: 51 samsung,dw-mshc-ddr-timing:
59 $ref: /schemas/types.yaml#/definitions/uin 52 $ref: /schemas/types.yaml#/definitions/uint32-array
60 items: 53 items:
61 - description: CIU clock phase shift val 54 - description: CIU clock phase shift value for tx mode
62 minimum: 0 55 minimum: 0
63 maximum: 7 56 maximum: 7
64 - description: CIU clock phase shift val 57 - description: CIU clock phase shift value for rx mode
65 minimum: 0 58 minimum: 0
66 maximum: 7 59 maximum: 7
67 description: 60 description:
68 The value of CUI clock phase shift value 61 The value of CUI clock phase shift value in transmit mode and CIU clock
69 phase shift value in receive mode for do 62 phase shift value in receive mode for double data rate mode operation.
70 See also samsung,dw-mshc-hs400-timing pr 63 See also samsung,dw-mshc-hs400-timing property.
71 64
72 samsung,dw-mshc-hs400-timing: 65 samsung,dw-mshc-hs400-timing:
73 $ref: /schemas/types.yaml#/definitions/uin 66 $ref: /schemas/types.yaml#/definitions/uint32-array
74 items: 67 items:
75 - description: CIU clock phase shift val 68 - description: CIU clock phase shift value for tx mode
76 minimum: 0 69 minimum: 0
77 maximum: 7 70 maximum: 7
78 - description: CIU clock phase shift val 71 - description: CIU clock phase shift value for rx mode
79 minimum: 0 72 minimum: 0
80 maximum: 7 73 maximum: 7
81 description: | 74 description: |
82 The value of CIU TX and RX clock phase s 75 The value of CIU TX and RX clock phase shift value for HS400 mode
83 operation. 76 operation.
84 Valid values for SDR and DDR CIU clock t 77 Valid values for SDR and DDR CIU clock timing::
85 - valid value for tx phase shift and r 78 - valid value for tx phase shift and rx phase shift is 0 to 7.
86 - when CIU clock divider value is set 79 - when CIU clock divider value is set to 3, all possible 8 phase shift
87 values can be used. 80 values can be used.
88 - if CIU clock divider value is 0 (tha 81 - if CIU clock divider value is 0 (that is divide by 1), both tx and rx
89 phase shift clocks should be 0. 82 phase shift clocks should be 0.
90 If missing, values from samsung,dw-mshc- 83 If missing, values from samsung,dw-mshc-ddr-timing property are used.
91 84
92 samsung,dw-mshc-sdr-timing: 85 samsung,dw-mshc-sdr-timing:
93 $ref: /schemas/types.yaml#/definitions/uin 86 $ref: /schemas/types.yaml#/definitions/uint32-array
94 items: 87 items:
95 - description: CIU clock phase shift val 88 - description: CIU clock phase shift value for tx mode
96 minimum: 0 89 minimum: 0
97 maximum: 7 90 maximum: 7
98 - description: CIU clock phase shift val 91 - description: CIU clock phase shift value for rx mode
99 minimum: 0 92 minimum: 0
100 maximum: 7 93 maximum: 7
101 description: 94 description:
102 The value of CIU clock phase shift value 95 The value of CIU clock phase shift value in transmit mode and CIU clock
103 phase shift value in receive mode for si 96 phase shift value in receive mode for single data rate mode operation.
104 See also samsung,dw-mshc-hs400-timing pr 97 See also samsung,dw-mshc-hs400-timing property.
105 98
106 samsung,read-strobe-delay: 99 samsung,read-strobe-delay:
107 $ref: /schemas/types.yaml#/definitions/uin 100 $ref: /schemas/types.yaml#/definitions/uint32
108 description: 101 description:
109 RCLK (Data strobe) delay to control HS40 102 RCLK (Data strobe) delay to control HS400 mode (Latency value for delay
110 line in Read path). If missing, default 103 line in Read path). If missing, default from hardware is used.
111 104
112 required: 105 required:
113 - compatible 106 - compatible
114 - reg 107 - reg
115 - interrupts 108 - interrupts
116 - clocks 109 - clocks
117 - clock-names 110 - clock-names
118 - samsung,dw-mshc-ddr-timing 111 - samsung,dw-mshc-ddr-timing
119 - samsung,dw-mshc-sdr-timing 112 - samsung,dw-mshc-sdr-timing
120 113
121 allOf: 114 allOf:
122 - $ref: synopsys-dw-mshc-common.yaml# !! 115 - $ref: "synopsys-dw-mshc-common.yaml#"
123 - if: 116 - if:
124 properties: 117 properties:
125 compatible: 118 compatible:
126 contains: 119 contains:
127 enum: 120 enum:
128 - samsung,exynos5250-dw-mshc 121 - samsung,exynos5250-dw-mshc
129 - samsung,exynos5420-dw-mshc 122 - samsung,exynos5420-dw-mshc
130 - samsung,exynos7-dw-mshc 123 - samsung,exynos7-dw-mshc
131 - samsung,exynos7-dw-mshc-smu 124 - samsung,exynos7-dw-mshc-smu
132 - axis,artpec8-dw-mshc 125 - axis,artpec8-dw-mshc
133 then: 126 then:
134 required: 127 required:
135 - samsung,dw-mshc-ciu-div 128 - samsung,dw-mshc-ciu-div
136 129
137 unevaluatedProperties: false 130 unevaluatedProperties: false
138 131
139 examples: 132 examples:
140 - | 133 - |
141 #include <dt-bindings/clock/exynos5420.h> 134 #include <dt-bindings/clock/exynos5420.h>
142 #include <dt-bindings/interrupt-controller 135 #include <dt-bindings/interrupt-controller/arm-gic.h>
143 136
144 mmc@12220000 { 137 mmc@12220000 {
145 compatible = "samsung,exynos5420-dw-ms 138 compatible = "samsung,exynos5420-dw-mshc";
146 interrupts = <GIC_SPI 77 IRQ_TYPE_LEVE 139 interrupts = <GIC_SPI 77 IRQ_TYPE_LEVEL_HIGH>;
147 #address-cells = <1>; 140 #address-cells = <1>;
148 #size-cells = <0>; 141 #size-cells = <0>;
149 reg = <0x12220000 0x1000>; 142 reg = <0x12220000 0x1000>;
150 clocks = <&clock CLK_MMC2>, <&clock CL 143 clocks = <&clock CLK_MMC2>, <&clock CLK_SCLK_MMC2>;
151 clock-names = "biu", "ciu"; 144 clock-names = "biu", "ciu";
152 fifo-depth = <0x40>; 145 fifo-depth = <0x40>;
153 card-detect-delay = <200>; 146 card-detect-delay = <200>;
154 samsung,dw-mshc-ciu-div = <3>; 147 samsung,dw-mshc-ciu-div = <3>;
155 samsung,dw-mshc-sdr-timing = <0 4>; 148 samsung,dw-mshc-sdr-timing = <0 4>;
156 samsung,dw-mshc-ddr-timing = <0 2>; 149 samsung,dw-mshc-ddr-timing = <0 2>;
157 pinctrl-names = "default"; 150 pinctrl-names = "default";
158 pinctrl-0 = <&sd2_clk &sd2_cmd &sd2_cd 151 pinctrl-0 = <&sd2_clk &sd2_cmd &sd2_cd &sd2_wp &sd2_bus1 &sd2_bus4>;
159 bus-width = <4>; 152 bus-width = <4>;
160 cap-sd-highspeed; 153 cap-sd-highspeed;
161 max-frequency = <200000000>; 154 max-frequency = <200000000>;
162 vmmc-supply = <&ldo19_reg>; 155 vmmc-supply = <&ldo19_reg>;
163 vqmmc-supply = <&ldo13_reg>; 156 vqmmc-supply = <&ldo13_reg>;
164 sd-uhs-sdr50; 157 sd-uhs-sdr50;
165 sd-uhs-sdr104; 158 sd-uhs-sdr104;
166 sd-uhs-ddr50; 159 sd-uhs-ddr50;
167 }; 160 };
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.