1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2 %YAML 1.2
3 ---
4 $id: http://devicetree.org/schemas/memory-controllers/nvidia,tegra20-emc.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6
7 title: NVIDIA Tegra20 SoC External Memory Controller
8
9 maintainers:
10 - Dmitry Osipenko <digetx@gmail.com>
11 - Jon Hunter <jonathanh@nvidia.com>
12 - Thierry Reding <thierry.reding@gmail.com>
13
14 description: |
15 The External Memory Controller (EMC) interfaces with the off-chip SDRAM to
16 service the request stream sent from Memory Controller. The EMC also has
17 various performance-affecting settings beyond the obvious SDRAM configuration
18 parameters and initialization settings. Tegra20 EMC supports multiple JEDEC
19 standard protocols: DDR1, LPDDR2 and DDR2.
20
21 properties:
22 compatible:
23 const: nvidia,tegra20-emc
24
25 reg:
26 maxItems: 1
27
28 clocks:
29 maxItems: 1
30
31 interrupts:
32 maxItems: 1
33
34 "#address-cells":
35 const: 1
36
37 "#size-cells":
38 const: 0
39
40 "#interconnect-cells":
41 const: 0
42
43 nvidia,memory-controller:
44 $ref: /schemas/types.yaml#/definitions/phandle
45 description:
46 Phandle of the Memory Controller node.
47
48 power-domains:
49 maxItems: 1
50 description:
51 Phandle of the SoC "core" power domain.
52
53 operating-points-v2:
54 description:
55 Should contain freqs and voltages and opp-supported-hw property, which
56 is a bitfield indicating SoC process ID mask.
57
58 nvidia,use-ram-code:
59 type: boolean
60 description:
61 If present, the emc-tables@ sub-nodes will be addressed.
62
63 $defs:
64 emc-table:
65 type: object
66 properties:
67 compatible:
68 const: nvidia,tegra20-emc-table
69
70 clock-frequency:
71 description:
72 Memory clock rate in kHz.
73 minimum: 1000
74 maximum: 900000
75
76 reg:
77 maxItems: 1
78 description:
79 Either an opaque enumerator to tell different tables apart, or
80 the valid frequency for which the table should be used (in kHz).
81
82 nvidia,emc-registers:
83 description:
84 EMC timing characterization data. These are the registers
85 (see section "15.4.1 EMC Registers" in the TRM) whose values
86 need to be specified, according to the board documentation.
87 $ref: /schemas/types.yaml#/definitions/uint32-array
88 items:
89 - description: EMC_RC
90 - description: EMC_RFC
91 - description: EMC_RAS
92 - description: EMC_RP
93 - description: EMC_R2W
94 - description: EMC_W2R
95 - description: EMC_R2P
96 - description: EMC_W2P
97 - description: EMC_RD_RCD
98 - description: EMC_WR_RCD
99 - description: EMC_RRD
100 - description: EMC_REXT
101 - description: EMC_WDV
102 - description: EMC_QUSE
103 - description: EMC_QRST
104 - description: EMC_QSAFE
105 - description: EMC_RDV
106 - description: EMC_REFRESH
107 - description: EMC_BURST_REFRESH_NUM
108 - description: EMC_PDEX2WR
109 - description: EMC_PDEX2RD
110 - description: EMC_PCHG2PDEN
111 - description: EMC_ACT2PDEN
112 - description: EMC_AR2PDEN
113 - description: EMC_RW2PDEN
114 - description: EMC_TXSR
115 - description: EMC_TCKE
116 - description: EMC_TFAW
117 - description: EMC_TRPAB
118 - description: EMC_TCLKSTABLE
119 - description: EMC_TCLKSTOP
120 - description: EMC_TREFBW
121 - description: EMC_QUSE_EXTRA
122 - description: EMC_FBIO_CFG6
123 - description: EMC_ODT_WRITE
124 - description: EMC_ODT_READ
125 - description: EMC_FBIO_CFG5
126 - description: EMC_CFG_DIG_DLL
127 - description: EMC_DLL_XFORM_DQS
128 - description: EMC_DLL_XFORM_QUSE
129 - description: EMC_ZCAL_REF_CNT
130 - description: EMC_ZCAL_WAIT_CNT
131 - description: EMC_AUTO_CAL_INTERVAL
132 - description: EMC_CFG_CLKTRIM_0
133 - description: EMC_CFG_CLKTRIM_1
134 - description: EMC_CFG_CLKTRIM_2
135
136 required:
137 - clock-frequency
138 - compatible
139 - reg
140 - nvidia,emc-registers
141
142 additionalProperties: false
143
144 patternProperties:
145 "^emc-table@[0-9]+$":
146 $ref: "#/$defs/emc-table"
147
148 "^emc-tables@[a-f0-9-]+$":
149 type: object
150 properties:
151 reg:
152 maxItems: 1
153 description:
154 An opaque enumerator to tell different tables apart.
155
156 nvidia,ram-code:
157 $ref: /schemas/types.yaml#/definitions/uint32
158 description:
159 Value of RAM_CODE this timing set is used for.
160
161 "#address-cells":
162 const: 1
163
164 "#size-cells":
165 const: 0
166
167 lpddr2:
168 $ref: ddr/jedec,lpddr2.yaml#
169 type: object
170
171 patternProperties:
172 "^emc-table@[0-9]+$":
173 $ref: "#/$defs/emc-table"
174
175 oneOf:
176 - required:
177 - nvidia,ram-code
178
179 - required:
180 - lpddr2
181
182 additionalProperties: false
183
184 required:
185 - compatible
186 - reg
187 - interrupts
188 - clocks
189 - nvidia,memory-controller
190 - "#interconnect-cells"
191 - operating-points-v2
192
193 additionalProperties: false
194
195 examples:
196 - |
197 external-memory-controller@7000f400 {
198 compatible = "nvidia,tegra20-emc";
199 reg = <0x7000f400 0x400>;
200 interrupts = <0 78 4>;
201 clocks = <&clock_controller 57>;
202
203 nvidia,memory-controller = <&mc>;
204 operating-points-v2 = <&dvfs_opp_table>;
205 power-domains = <&domain>;
206
207 #interconnect-cells = <0>;
208 #address-cells = <1>;
209 #size-cells = <0>;
210
211 nvidia,use-ram-code;
212
213 emc-tables@0 {
214 nvidia,ram-code = <0>;
215 reg = <0>;
216
217 #address-cells = <1>;
218 #size-cells = <0>;
219
220 emc-table@333000 {
221 reg = <333000>;
222 compatible = "nvidia,tegra20-emc-table";
223 clock-frequency = <333000>;
224 nvidia,emc-registers = <0x00000018 0x00000033
225 0x00000012 0x00000004 0x00000004 0x00000005
226 0x00000003 0x0000000c 0x00000006 0x00000006
227 0x00000003 0x00000001 0x00000004 0x00000005
228 0x00000004 0x00000009 0x0000000d 0x00000bff
229 0x00000000 0x00000003 0x00000003 0x00000006
230 0x00000006 0x00000001 0x00000011 0x000000c8
231 0x00000003 0x0000000e 0x00000007 0x00000008
232 0x00000002 0x00000000 0x00000000 0x00000002
233 0x00000000 0x00000000 0x00000083 0xf0440303
234 0x007fe010 0x00001414 0x00000000 0x00000000
235 0x00000000 0x00000000 0x00000000 0x00000000>;
236 };
237 };
238
239 emc-tables@1 {
240 reg = <1>;
241
242 lpddr2 {
243 compatible = "elpida,B8132B2PB-6D-F", "jedec,lpddr2-s4";
244 revision-id1 = <1>;
245 density = <2048>;
246 io-width = <16>;
247 };
248 };
249 };
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.