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