xref: /openbmc/u-boot/include/fsl_ddr_sdram.h (revision b28c5fcc)
1 /*
2  * Copyright 2008-2014 Freescale Semiconductor, Inc.
3  *
4  * SPDX-License-Identifier:	GPL-2.0
5  */
6 
7 #ifndef FSL_DDR_MEMCTL_H
8 #define FSL_DDR_MEMCTL_H
9 
10 /*
11  * Pick a basic DDR Technology.
12  */
13 #include <ddr_spd.h>
14 #include <fsl_ddrc_version.h>
15 
16 #define SDRAM_TYPE_DDR1		2
17 #define SDRAM_TYPE_DDR2		3
18 #define SDRAM_TYPE_LPDDR1	6
19 #define SDRAM_TYPE_DDR3		7
20 #define SDRAM_TYPE_DDR4		5
21 
22 #define DDR_BL4		4	/* burst length 4 */
23 #define DDR_BC4		DDR_BL4	/* burst chop for ddr3 */
24 #define DDR_OTF		6	/* on-the-fly BC4 and BL8 */
25 #define DDR_BL8		8	/* burst length 8 */
26 
27 #define DDR3_RTT_OFF		0
28 #define DDR3_RTT_60_OHM		1 /* RTT_Nom = RZQ/4 */
29 #define DDR3_RTT_120_OHM	2 /* RTT_Nom = RZQ/2 */
30 #define DDR3_RTT_40_OHM		3 /* RTT_Nom = RZQ/6 */
31 #define DDR3_RTT_20_OHM		4 /* RTT_Nom = RZQ/12 */
32 #define DDR3_RTT_30_OHM		5 /* RTT_Nom = RZQ/8 */
33 
34 #define DDR4_RTT_OFF		0
35 #define DDR4_RTT_60_OHM		1	/* RZQ/4 */
36 #define DDR4_RTT_120_OHM	2	/* RZQ/2 */
37 #define DDR4_RTT_40_OHM		3	/* RZQ/6 */
38 #define DDR4_RTT_240_OHM	4	/* RZQ/1 */
39 #define DDR4_RTT_48_OHM		5	/* RZQ/5 */
40 #define DDR4_RTT_80_OHM		6	/* RZQ/3 */
41 #define DDR4_RTT_34_OHM		7	/* RZQ/7 */
42 
43 #define DDR2_RTT_OFF		0
44 #define DDR2_RTT_75_OHM		1
45 #define DDR2_RTT_150_OHM	2
46 #define DDR2_RTT_50_OHM		3
47 
48 #if defined(CONFIG_SYS_FSL_DDR1)
49 #define FSL_DDR_MIN_TCKE_PULSE_WIDTH_DDR	(1)
50 typedef ddr1_spd_eeprom_t generic_spd_eeprom_t;
51 #ifndef CONFIG_FSL_SDRAM_TYPE
52 #define CONFIG_FSL_SDRAM_TYPE	SDRAM_TYPE_DDR1
53 #endif
54 #elif defined(CONFIG_SYS_FSL_DDR2)
55 #define FSL_DDR_MIN_TCKE_PULSE_WIDTH_DDR	(3)
56 typedef ddr2_spd_eeprom_t generic_spd_eeprom_t;
57 #ifndef CONFIG_FSL_SDRAM_TYPE
58 #define CONFIG_FSL_SDRAM_TYPE	SDRAM_TYPE_DDR2
59 #endif
60 #elif defined(CONFIG_SYS_FSL_DDR3)
61 typedef ddr3_spd_eeprom_t generic_spd_eeprom_t;
62 #ifndef CONFIG_FSL_SDRAM_TYPE
63 #define CONFIG_FSL_SDRAM_TYPE	SDRAM_TYPE_DDR3
64 #endif
65 #elif defined(CONFIG_SYS_FSL_DDR4)
66 #define FSL_DDR_MIN_TCKE_PULSE_WIDTH_DDR	(3)	/* FIXME */
67 typedef struct ddr4_spd_eeprom_s generic_spd_eeprom_t;
68 #ifndef CONFIG_FSL_SDRAM_TYPE
69 #define CONFIG_FSL_SDRAM_TYPE	SDRAM_TYPE_DDR4
70 #endif
71 #endif	/* #if defined(CONFIG_SYS_FSL_DDR1) */
72 
73 #define FSL_DDR_ODT_NEVER		0x0
74 #define FSL_DDR_ODT_CS			0x1
75 #define FSL_DDR_ODT_ALL_OTHER_CS	0x2
76 #define FSL_DDR_ODT_OTHER_DIMM		0x3
77 #define FSL_DDR_ODT_ALL			0x4
78 #define FSL_DDR_ODT_SAME_DIMM		0x5
79 #define FSL_DDR_ODT_CS_AND_OTHER_DIMM	0x6
80 #define FSL_DDR_ODT_OTHER_CS_ONSAMEDIMM	0x7
81 
82 /* define bank(chip select) interleaving mode */
83 #define FSL_DDR_CS0_CS1			0x40
84 #define FSL_DDR_CS2_CS3			0x20
85 #define FSL_DDR_CS0_CS1_AND_CS2_CS3	(FSL_DDR_CS0_CS1 | FSL_DDR_CS2_CS3)
86 #define FSL_DDR_CS0_CS1_CS2_CS3		(FSL_DDR_CS0_CS1_AND_CS2_CS3 | 0x04)
87 
88 /* define memory controller interleaving mode */
89 #define FSL_DDR_CACHE_LINE_INTERLEAVING	0x0
90 #define FSL_DDR_PAGE_INTERLEAVING	0x1
91 #define FSL_DDR_BANK_INTERLEAVING	0x2
92 #define FSL_DDR_SUPERBANK_INTERLEAVING	0x3
93 #define FSL_DDR_256B_INTERLEAVING	0x8
94 #define FSL_DDR_3WAY_1KB_INTERLEAVING	0xA
95 #define FSL_DDR_3WAY_4KB_INTERLEAVING	0xC
96 #define FSL_DDR_3WAY_8KB_INTERLEAVING	0xD
97 /* placeholder for 4-way interleaving */
98 #define FSL_DDR_4WAY_1KB_INTERLEAVING	0x1A
99 #define FSL_DDR_4WAY_4KB_INTERLEAVING	0x1C
100 #define FSL_DDR_4WAY_8KB_INTERLEAVING	0x1D
101 
102 #define SDRAM_CS_CONFIG_EN		0x80000000
103 
104 /* DDR_SDRAM_CFG - DDR SDRAM Control Configuration
105  */
106 #define SDRAM_CFG_MEM_EN		0x80000000
107 #define SDRAM_CFG_SREN			0x40000000
108 #define SDRAM_CFG_ECC_EN		0x20000000
109 #define SDRAM_CFG_RD_EN			0x10000000
110 #define SDRAM_CFG_SDRAM_TYPE_DDR1	0x02000000
111 #define SDRAM_CFG_SDRAM_TYPE_DDR2	0x03000000
112 #define SDRAM_CFG_SDRAM_TYPE_MASK	0x07000000
113 #define SDRAM_CFG_SDRAM_TYPE_SHIFT	24
114 #define SDRAM_CFG_DYN_PWR		0x00200000
115 #define SDRAM_CFG_DBW_MASK		0x00180000
116 #define SDRAM_CFG_DBW_SHIFT		19
117 #define SDRAM_CFG_32_BE			0x00080000
118 #define SDRAM_CFG_16_BE			0x00100000
119 #define SDRAM_CFG_8_BE			0x00040000
120 #define SDRAM_CFG_NCAP			0x00020000
121 #define SDRAM_CFG_2T_EN			0x00008000
122 #define SDRAM_CFG_BI			0x00000001
123 
124 #define SDRAM_CFG2_FRC_SR		0x80000000
125 #define SDRAM_CFG2_D_INIT		0x00000010
126 #define SDRAM_CFG2_AP_EN		0x00000020
127 #define SDRAM_CFG2_ODT_CFG_MASK		0x00600000
128 #define SDRAM_CFG2_ODT_NEVER		0
129 #define SDRAM_CFG2_ODT_ONLY_WRITE	1
130 #define SDRAM_CFG2_ODT_ONLY_READ	2
131 #define SDRAM_CFG2_ODT_ALWAYS		3
132 
133 #define SDRAM_INTERVAL_BSTOPRE	0x3FFF
134 #define TIMING_CFG_2_CPO_MASK	0x0F800000
135 
136 #if defined(CONFIG_SYS_FSL_DDR_VER) && \
137 	(CONFIG_SYS_FSL_DDR_VER > FSL_DDR_VER_4_4)
138 #define RD_TO_PRE_MASK		0xf
139 #define RD_TO_PRE_SHIFT		13
140 #define WR_DATA_DELAY_MASK	0xf
141 #define WR_DATA_DELAY_SHIFT	9
142 #else
143 #define RD_TO_PRE_MASK		0x7
144 #define RD_TO_PRE_SHIFT		13
145 #define WR_DATA_DELAY_MASK	0x7
146 #define WR_DATA_DELAY_SHIFT	10
147 #endif
148 
149 /* DDR_EOR register */
150 #define DDR_EOR_RD_REOD_DIS	0x07000000
151 #define DDR_EOR_WD_REOD_DIS	0x00100000
152 
153 /* DDR_MD_CNTL */
154 #define MD_CNTL_MD_EN		0x80000000
155 #define MD_CNTL_CS_SEL_CS0	0x00000000
156 #define MD_CNTL_CS_SEL_CS1	0x10000000
157 #define MD_CNTL_CS_SEL_CS2	0x20000000
158 #define MD_CNTL_CS_SEL_CS3	0x30000000
159 #define MD_CNTL_CS_SEL_CS0_CS1	0x40000000
160 #define MD_CNTL_CS_SEL_CS2_CS3	0x50000000
161 #define MD_CNTL_MD_SEL_MR	0x00000000
162 #define MD_CNTL_MD_SEL_EMR	0x01000000
163 #define MD_CNTL_MD_SEL_EMR2	0x02000000
164 #define MD_CNTL_MD_SEL_EMR3	0x03000000
165 #define MD_CNTL_SET_REF		0x00800000
166 #define MD_CNTL_SET_PRE		0x00400000
167 #define MD_CNTL_CKE_CNTL_LOW	0x00100000
168 #define MD_CNTL_CKE_CNTL_HIGH	0x00200000
169 #define MD_CNTL_WRCW		0x00080000
170 #define MD_CNTL_MD_VALUE(x)	(x & 0x0000FFFF)
171 #define MD_CNTL_CS_SEL(x)	(((x) & 0x7) << 28)
172 #define MD_CNTL_MD_SEL(x)	(((x) & 0xf) << 24)
173 
174 /* DDR_CDR1 */
175 #define DDR_CDR1_DHC_EN	0x80000000
176 #define DDR_CDR1_V0PT9_EN	0x40000000
177 #define DDR_CDR1_ODT_SHIFT	17
178 #define DDR_CDR1_ODT_MASK	0x6
179 #define DDR_CDR2_ODT_MASK	0x1
180 #define DDR_CDR1_ODT(x) ((x & DDR_CDR1_ODT_MASK) << DDR_CDR1_ODT_SHIFT)
181 #define DDR_CDR2_ODT(x) (x & DDR_CDR2_ODT_MASK)
182 #define DDR_CDR2_VREF_OVRD(x)	(0x00008080 | ((((x) - 37) & 0x3F) << 8))
183 #define DDR_CDR2_VREF_TRAIN_EN	0x00000080
184 #define DDR_CDR2_VREF_RANGE_2	0x00000040
185 
186 /* DDR ERR_DISABLE */
187 #define DDR_ERR_DISABLE_APED	(1 << 8)  /* Address parity error disable */
188 
189 /* Mode Registers */
190 #define DDR_MR5_CA_PARITY_LAT_4_CLK	0x1 /* for DDR4-1600/1866/2133 */
191 #define DDR_MR5_CA_PARITY_LAT_5_CLK	0x2 /* for DDR4-2400 */
192 
193 /* DEBUG_26 register */
194 #define DDR_CAS_TO_PRE_SUB_MASK  0x0000f000 /* CAS to preamble subtract value */
195 #define DDR_CAS_TO_PRE_SUB_SHIFT 12
196 
197 /* DEBUG_29 register */
198 #define DDR_TX_BD_DIS	(1 << 10) /* Transmit Bit Deskew Disable */
199 
200 
201 #if (defined(CONFIG_SYS_FSL_DDR_VER) && \
202 	(CONFIG_SYS_FSL_DDR_VER >= FSL_DDR_VER_4_7))
203 #ifdef CONFIG_SYS_FSL_DDR3L
204 #define DDR_CDR_ODT_OFF		0x0
205 #define DDR_CDR_ODT_120ohm	0x1
206 #define DDR_CDR_ODT_200ohm	0x2
207 #define DDR_CDR_ODT_75ohm	0x3
208 #define DDR_CDR_ODT_60ohm	0x5
209 #define DDR_CDR_ODT_46ohm	0x7
210 #elif defined(CONFIG_SYS_FSL_DDR4)
211 #define DDR_CDR_ODT_OFF		0x0
212 #define DDR_CDR_ODT_100ohm	0x1
213 #define DDR_CDR_ODT_120OHM	0x2
214 #define DDR_CDR_ODT_80ohm	0x3
215 #define DDR_CDR_ODT_60ohm	0x4
216 #define DDR_CDR_ODT_40ohm	0x5
217 #define DDR_CDR_ODT_50ohm	0x6
218 #define DDR_CDR_ODT_30ohm	0x7
219 #else
220 #define DDR_CDR_ODT_OFF		0x0
221 #define DDR_CDR_ODT_120ohm	0x1
222 #define DDR_CDR_ODT_180ohm	0x2
223 #define DDR_CDR_ODT_75ohm	0x3
224 #define DDR_CDR_ODT_110ohm	0x4
225 #define DDR_CDR_ODT_60hm	0x5
226 #define DDR_CDR_ODT_70ohm	0x6
227 #define DDR_CDR_ODT_47ohm	0x7
228 #endif /* DDR3L */
229 #else
230 #define DDR_CDR_ODT_75ohm	0x0
231 #define DDR_CDR_ODT_55ohm	0x1
232 #define DDR_CDR_ODT_60ohm	0x2
233 #define DDR_CDR_ODT_50ohm	0x3
234 #define DDR_CDR_ODT_150ohm	0x4
235 #define DDR_CDR_ODT_43ohm	0x5
236 #define DDR_CDR_ODT_120ohm	0x6
237 #endif
238 
239 #define DDR_INIT_ADDR_EXT_UIA	(1 << 31)
240 
241 /* Record of register values computed */
242 typedef struct fsl_ddr_cfg_regs_s {
243 	struct {
244 		unsigned int bnds;
245 		unsigned int config;
246 		unsigned int config_2;
247 	} cs[CONFIG_CHIP_SELECTS_PER_CTRL];
248 	unsigned int timing_cfg_3;
249 	unsigned int timing_cfg_0;
250 	unsigned int timing_cfg_1;
251 	unsigned int timing_cfg_2;
252 	unsigned int ddr_sdram_cfg;
253 	unsigned int ddr_sdram_cfg_2;
254 	unsigned int ddr_sdram_cfg_3;
255 	unsigned int ddr_sdram_mode;
256 	unsigned int ddr_sdram_mode_2;
257 	unsigned int ddr_sdram_mode_3;
258 	unsigned int ddr_sdram_mode_4;
259 	unsigned int ddr_sdram_mode_5;
260 	unsigned int ddr_sdram_mode_6;
261 	unsigned int ddr_sdram_mode_7;
262 	unsigned int ddr_sdram_mode_8;
263 	unsigned int ddr_sdram_mode_9;
264 	unsigned int ddr_sdram_mode_10;
265 	unsigned int ddr_sdram_mode_11;
266 	unsigned int ddr_sdram_mode_12;
267 	unsigned int ddr_sdram_mode_13;
268 	unsigned int ddr_sdram_mode_14;
269 	unsigned int ddr_sdram_mode_15;
270 	unsigned int ddr_sdram_mode_16;
271 	unsigned int ddr_sdram_md_cntl;
272 	unsigned int ddr_sdram_interval;
273 	unsigned int ddr_data_init;
274 	unsigned int ddr_sdram_clk_cntl;
275 	unsigned int ddr_init_addr;
276 	unsigned int ddr_init_ext_addr;
277 	unsigned int timing_cfg_4;
278 	unsigned int timing_cfg_5;
279 	unsigned int timing_cfg_6;
280 	unsigned int timing_cfg_7;
281 	unsigned int timing_cfg_8;
282 	unsigned int timing_cfg_9;
283 	unsigned int ddr_zq_cntl;
284 	unsigned int ddr_wrlvl_cntl;
285 	unsigned int ddr_wrlvl_cntl_2;
286 	unsigned int ddr_wrlvl_cntl_3;
287 	unsigned int ddr_sr_cntr;
288 	unsigned int ddr_sdram_rcw_1;
289 	unsigned int ddr_sdram_rcw_2;
290 	unsigned int ddr_sdram_rcw_3;
291 	unsigned int ddr_sdram_rcw_4;
292 	unsigned int ddr_sdram_rcw_5;
293 	unsigned int ddr_sdram_rcw_6;
294 	unsigned int dq_map_0;
295 	unsigned int dq_map_1;
296 	unsigned int dq_map_2;
297 	unsigned int dq_map_3;
298 	unsigned int ddr_eor;
299 	unsigned int ddr_cdr1;
300 	unsigned int ddr_cdr2;
301 	unsigned int err_disable;
302 	unsigned int err_int_en;
303 	unsigned int debug[64];
304 } fsl_ddr_cfg_regs_t;
305 
306 typedef struct memctl_options_partial_s {
307 	unsigned int all_dimms_ecc_capable;
308 	unsigned int all_dimms_tckmax_ps;
309 	unsigned int all_dimms_burst_lengths_bitmask;
310 	unsigned int all_dimms_registered;
311 	unsigned int all_dimms_unbuffered;
312 	/*	unsigned int lowest_common_spd_caslat; */
313 	unsigned int all_dimms_minimum_trcd_ps;
314 } memctl_options_partial_t;
315 
316 #define DDR_DATA_BUS_WIDTH_64 0
317 #define DDR_DATA_BUS_WIDTH_32 1
318 #define DDR_DATA_BUS_WIDTH_16 2
319 #define DDR_CSWL_CS0	0x04000001
320 /*
321  * Generalized parameters for memory controller configuration,
322  * might be a little specific to the FSL memory controller
323  */
324 typedef struct memctl_options_s {
325 	/*
326 	 * Memory organization parameters
327 	 *
328 	 * if DIMM is present in the system
329 	 * where DIMMs are with respect to chip select
330 	 * where chip selects are with respect to memory boundaries
331 	 */
332 	unsigned int registered_dimm_en;    /* use registered DIMM support */
333 
334 	/* Options local to a Chip Select */
335 	struct cs_local_opts_s {
336 		unsigned int auto_precharge;
337 		unsigned int odt_rd_cfg;
338 		unsigned int odt_wr_cfg;
339 		unsigned int odt_rtt_norm;
340 		unsigned int odt_rtt_wr;
341 	} cs_local_opts[CONFIG_CHIP_SELECTS_PER_CTRL];
342 
343 	/* Special configurations for chip select */
344 	unsigned int memctl_interleaving;
345 	unsigned int memctl_interleaving_mode;
346 	unsigned int ba_intlv_ctl;
347 	unsigned int addr_hash;
348 
349 	/* Operational mode parameters */
350 	unsigned int ecc_mode;	 /* Use ECC? */
351 	/* Initialize ECC using memory controller? */
352 	unsigned int ecc_init_using_memctl;
353 	unsigned int dqs_config;	/* Use DQS? maybe only with DDR2? */
354 	/* SREN - self-refresh during sleep */
355 	unsigned int self_refresh_in_sleep;
356 	/* SR_IE - Self-refresh interrupt enable */
357 	unsigned int self_refresh_interrupt_en;
358 	unsigned int dynamic_power;	/* DYN_PWR */
359 	/* memory data width to use (16-bit, 32-bit, 64-bit) */
360 	unsigned int data_bus_width;
361 	unsigned int burst_length;	/* BL4, OTF and BL8 */
362 	/* On-The-Fly Burst Chop enable */
363 	unsigned int otf_burst_chop_en;
364 	/* mirrior DIMMs for DDR3 */
365 	unsigned int mirrored_dimm;
366 	unsigned int quad_rank_present;
367 	unsigned int ap_en;	/* address parity enable for RDIMM/DDR4-UDIMM */
368 	unsigned int x4_en;	/* enable x4 devices */
369 
370 	/* Global Timing Parameters */
371 	unsigned int cas_latency_override;
372 	unsigned int cas_latency_override_value;
373 	unsigned int use_derated_caslat;
374 	unsigned int additive_latency_override;
375 	unsigned int additive_latency_override_value;
376 
377 	unsigned int clk_adjust;		/* */
378 	unsigned int cpo_override;		/* override timing_cfg_2[CPO]*/
379 	unsigned int cpo_sample;		/* optimize debug_29[24:31] */
380 	unsigned int write_data_delay;		/* DQS adjust */
381 
382 	unsigned int cswl_override;
383 	unsigned int wrlvl_override;
384 	unsigned int wrlvl_sample;		/* Write leveling */
385 	unsigned int wrlvl_start;
386 	unsigned int wrlvl_ctl_2;
387 	unsigned int wrlvl_ctl_3;
388 
389 	unsigned int half_strength_driver_enable;
390 	unsigned int twot_en;
391 	unsigned int threet_en;
392 	unsigned int bstopre;
393 	unsigned int tfaw_window_four_activates_ps;	/* tFAW --  FOUR_ACT */
394 
395 	/* Rtt impedance */
396 	unsigned int rtt_override;		/* rtt_override enable */
397 	unsigned int rtt_override_value;	/* that is Rtt_Nom for DDR3 */
398 	unsigned int rtt_wr_override_value;	/* this is Rtt_WR for DDR3 */
399 
400 	/* Automatic self refresh */
401 	unsigned int auto_self_refresh_en;
402 	unsigned int sr_it;
403 	/* ZQ calibration */
404 	unsigned int zq_en;
405 	/* Write leveling */
406 	unsigned int wrlvl_en;
407 	/* RCW override for RDIMM */
408 	unsigned int rcw_override;
409 	unsigned int rcw_1;
410 	unsigned int rcw_2;
411 	/* control register 1 */
412 	unsigned int ddr_cdr1;
413 	unsigned int ddr_cdr2;
414 
415 	unsigned int trwt_override;
416 	unsigned int trwt;			/* read-to-write turnaround */
417 } memctl_options_t;
418 
419 phys_size_t fsl_ddr_sdram(void);
420 phys_size_t fsl_ddr_sdram_size(void);
421 phys_size_t fsl_other_ddr_sdram(unsigned long long base,
422 				unsigned int first_ctrl,
423 				unsigned int num_ctrls,
424 				unsigned int dimm_slots_per_ctrl,
425 				int (*board_need_reset)(void),
426 				void (*board_reset)(void),
427 				void (*board_de_reset)(void));
428 extern int fsl_use_spd(void);
429 void fsl_ddr_set_memctl_regs(const fsl_ddr_cfg_regs_t *regs,
430 			     unsigned int ctrl_num, int step);
431 u32 fsl_ddr_get_intl3r(void);
432 void print_ddr_info(unsigned int start_ctrl);
433 
434 static void __board_assert_mem_reset(void)
435 {
436 }
437 
438 static void __board_deassert_mem_reset(void)
439 {
440 }
441 
442 void board_assert_mem_reset(void)
443 	__attribute__((weak, alias("__board_assert_mem_reset")));
444 
445 void board_deassert_mem_reset(void)
446 	__attribute__((weak, alias("__board_deassert_mem_reset")));
447 
448 static int __board_need_mem_reset(void)
449 {
450 	return 0;
451 }
452 
453 int board_need_mem_reset(void)
454 	__attribute__((weak, alias("__board_need_mem_reset")));
455 
456 #if defined(CONFIG_DEEP_SLEEP)
457 void board_mem_sleep_setup(void);
458 bool is_warm_boot(void);
459 int fsl_dp_resume(void);
460 #endif
461 
462 /*
463  * The 85xx boards have a common prototype for fixed_sdram so put the
464  * declaration here.
465  */
466 #ifdef CONFIG_MPC85xx
467 extern phys_size_t fixed_sdram(void);
468 #endif
469 
470 #if defined(CONFIG_DDR_ECC)
471 extern void ddr_enable_ecc(unsigned int dram_size);
472 #endif
473 
474 
475 typedef struct fixed_ddr_parm{
476 	int min_freq;
477 	int max_freq;
478 	fsl_ddr_cfg_regs_t *ddr_settings;
479 } fixed_ddr_parm_t;
480 #endif
481