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
7title: NVIDIA Tegra20 SoC External Memory Controller
8
9maintainers:
10  - Dmitry Osipenko <digetx@gmail.com>
11  - Jon Hunter <jonathanh@nvidia.com>
12  - Thierry Reding <thierry.reding@gmail.com>
13
14description: |
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
21properties:
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
144patternProperties:
145  "^emc-table@[0-9]+$":
146    $ref: "#/$defs/emc-table"
147
148  "^emc-tables@[a-z0-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
184required:
185  - compatible
186  - reg
187  - interrupts
188  - clocks
189  - nvidia,memory-controller
190  - "#interconnect-cells"
191  - operating-points-v2
192
193additionalProperties: false
194
195examples:
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    };
250