xref: /OK3568_Linux_fs/u-boot/include/fsl_ddr.h (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun /*
2*4882a593Smuzhiyun  * Copyright 2008-2014 Freescale Semiconductor, Inc.
3*4882a593Smuzhiyun  *
4*4882a593Smuzhiyun  * SPDX-License-Identifier:	GPL-2.0
5*4882a593Smuzhiyun  */
6*4882a593Smuzhiyun 
7*4882a593Smuzhiyun #ifndef FSL_DDR_MAIN_H
8*4882a593Smuzhiyun #define FSL_DDR_MAIN_H
9*4882a593Smuzhiyun 
10*4882a593Smuzhiyun #include <fsl_ddrc_version.h>
11*4882a593Smuzhiyun #include <fsl_ddr_sdram.h>
12*4882a593Smuzhiyun #include <fsl_ddr_dimm_params.h>
13*4882a593Smuzhiyun 
14*4882a593Smuzhiyun #include <common_timing_params.h>
15*4882a593Smuzhiyun 
16*4882a593Smuzhiyun #ifndef CONFIG_SYS_FSL_DDR_MAIN_NUM_CTRLS
17*4882a593Smuzhiyun /* All controllers are for main memory */
18*4882a593Smuzhiyun #define CONFIG_SYS_FSL_DDR_MAIN_NUM_CTRLS	CONFIG_SYS_NUM_DDR_CTLRS
19*4882a593Smuzhiyun #endif
20*4882a593Smuzhiyun 
21*4882a593Smuzhiyun #ifdef CONFIG_SYS_FSL_DDR_LE
22*4882a593Smuzhiyun #define ddr_in32(a)	in_le32(a)
23*4882a593Smuzhiyun #define ddr_out32(a, v)	out_le32(a, v)
24*4882a593Smuzhiyun #define ddr_setbits32(a, v)	setbits_le32(a, v)
25*4882a593Smuzhiyun #define ddr_clrbits32(a, v)	clrbits_le32(a, v)
26*4882a593Smuzhiyun #define ddr_clrsetbits32(a, clear, set)	clrsetbits_le32(a, clear, set)
27*4882a593Smuzhiyun #else
28*4882a593Smuzhiyun #define ddr_in32(a)	in_be32(a)
29*4882a593Smuzhiyun #define ddr_out32(a, v)	out_be32(a, v)
30*4882a593Smuzhiyun #define ddr_setbits32(a, v)	setbits_be32(a, v)
31*4882a593Smuzhiyun #define ddr_clrbits32(a, v)	clrbits_be32(a, v)
32*4882a593Smuzhiyun #define ddr_clrsetbits32(a, clear, set)	clrsetbits_be32(a, clear, set)
33*4882a593Smuzhiyun #endif
34*4882a593Smuzhiyun 
35*4882a593Smuzhiyun u32 fsl_ddr_get_version(unsigned int ctrl_num);
36*4882a593Smuzhiyun 
37*4882a593Smuzhiyun #if defined(CONFIG_DDR_SPD) || defined(CONFIG_SPD_EEPROM)
38*4882a593Smuzhiyun /*
39*4882a593Smuzhiyun  * Bind the main DDR setup driver's generic names
40*4882a593Smuzhiyun  * to this specific DDR technology.
41*4882a593Smuzhiyun  */
42*4882a593Smuzhiyun static __inline__ int
compute_dimm_parameters(const unsigned int ctrl_num,const generic_spd_eeprom_t * spd,dimm_params_t * pdimm,unsigned int dimm_number)43*4882a593Smuzhiyun compute_dimm_parameters(const unsigned int ctrl_num,
44*4882a593Smuzhiyun 			const generic_spd_eeprom_t *spd,
45*4882a593Smuzhiyun 			dimm_params_t *pdimm,
46*4882a593Smuzhiyun 			unsigned int dimm_number)
47*4882a593Smuzhiyun {
48*4882a593Smuzhiyun 	return ddr_compute_dimm_parameters(ctrl_num, spd, pdimm, dimm_number);
49*4882a593Smuzhiyun }
50*4882a593Smuzhiyun #endif
51*4882a593Smuzhiyun 
52*4882a593Smuzhiyun /*
53*4882a593Smuzhiyun  * Data Structures
54*4882a593Smuzhiyun  *
55*4882a593Smuzhiyun  * All data structures have to be on the stack
56*4882a593Smuzhiyun  */
57*4882a593Smuzhiyun #define CONFIG_SYS_DIMM_SLOTS_PER_CTLR CONFIG_DIMM_SLOTS_PER_CTLR
58*4882a593Smuzhiyun 
59*4882a593Smuzhiyun typedef struct {
60*4882a593Smuzhiyun 	generic_spd_eeprom_t
61*4882a593Smuzhiyun 	   spd_installed_dimms[CONFIG_SYS_NUM_DDR_CTLRS][CONFIG_SYS_DIMM_SLOTS_PER_CTLR];
62*4882a593Smuzhiyun 	struct dimm_params_s
63*4882a593Smuzhiyun 	   dimm_params[CONFIG_SYS_NUM_DDR_CTLRS][CONFIG_SYS_DIMM_SLOTS_PER_CTLR];
64*4882a593Smuzhiyun 	memctl_options_t memctl_opts[CONFIG_SYS_NUM_DDR_CTLRS];
65*4882a593Smuzhiyun 	common_timing_params_t common_timing_params[CONFIG_SYS_NUM_DDR_CTLRS];
66*4882a593Smuzhiyun 	fsl_ddr_cfg_regs_t fsl_ddr_config_reg[CONFIG_SYS_NUM_DDR_CTLRS];
67*4882a593Smuzhiyun 	unsigned int first_ctrl;
68*4882a593Smuzhiyun 	unsigned int num_ctrls;
69*4882a593Smuzhiyun 	unsigned long long mem_base;
70*4882a593Smuzhiyun 	unsigned int dimm_slots_per_ctrl;
71*4882a593Smuzhiyun 	int (*board_need_mem_reset)(void);
72*4882a593Smuzhiyun 	void (*board_mem_reset)(void);
73*4882a593Smuzhiyun 	void (*board_mem_de_reset)(void);
74*4882a593Smuzhiyun } fsl_ddr_info_t;
75*4882a593Smuzhiyun 
76*4882a593Smuzhiyun /* Compute steps */
77*4882a593Smuzhiyun #define STEP_GET_SPD                 (1 << 0)
78*4882a593Smuzhiyun #define STEP_COMPUTE_DIMM_PARMS      (1 << 1)
79*4882a593Smuzhiyun #define STEP_COMPUTE_COMMON_PARMS    (1 << 2)
80*4882a593Smuzhiyun #define STEP_GATHER_OPTS             (1 << 3)
81*4882a593Smuzhiyun #define STEP_ASSIGN_ADDRESSES        (1 << 4)
82*4882a593Smuzhiyun #define STEP_COMPUTE_REGS            (1 << 5)
83*4882a593Smuzhiyun #define STEP_PROGRAM_REGS            (1 << 6)
84*4882a593Smuzhiyun #define STEP_ALL                     0xFFF
85*4882a593Smuzhiyun 
86*4882a593Smuzhiyun unsigned long long
87*4882a593Smuzhiyun fsl_ddr_compute(fsl_ddr_info_t *pinfo, unsigned int start_step,
88*4882a593Smuzhiyun 				       unsigned int size_only);
89*4882a593Smuzhiyun const char *step_to_string(unsigned int step);
90*4882a593Smuzhiyun 
91*4882a593Smuzhiyun unsigned int compute_fsl_memctl_config_regs(const unsigned int ctrl_num,
92*4882a593Smuzhiyun 			       const memctl_options_t *popts,
93*4882a593Smuzhiyun 			       fsl_ddr_cfg_regs_t *ddr,
94*4882a593Smuzhiyun 			       const common_timing_params_t *common_dimm,
95*4882a593Smuzhiyun 			       const dimm_params_t *dimm_parameters,
96*4882a593Smuzhiyun 			       unsigned int dbw_capacity_adjust,
97*4882a593Smuzhiyun 			       unsigned int size_only);
98*4882a593Smuzhiyun unsigned int compute_lowest_common_dimm_parameters(
99*4882a593Smuzhiyun 				const unsigned int ctrl_num,
100*4882a593Smuzhiyun 				const dimm_params_t *dimm_params,
101*4882a593Smuzhiyun 				common_timing_params_t *outpdimm,
102*4882a593Smuzhiyun 				unsigned int number_of_dimms);
103*4882a593Smuzhiyun unsigned int populate_memctl_options(const common_timing_params_t *common_dimm,
104*4882a593Smuzhiyun 				memctl_options_t *popts,
105*4882a593Smuzhiyun 				dimm_params_t *pdimm,
106*4882a593Smuzhiyun 				unsigned int ctrl_num);
107*4882a593Smuzhiyun void check_interleaving_options(fsl_ddr_info_t *pinfo);
108*4882a593Smuzhiyun 
109*4882a593Smuzhiyun unsigned int mclk_to_picos(const unsigned int ctrl_num, unsigned int mclk);
110*4882a593Smuzhiyun unsigned int get_memory_clk_period_ps(const unsigned int ctrl_num);
111*4882a593Smuzhiyun unsigned int picos_to_mclk(const unsigned int ctrl_num, unsigned int picos);
112*4882a593Smuzhiyun void fsl_ddr_set_lawbar(
113*4882a593Smuzhiyun 		const common_timing_params_t *memctl_common_params,
114*4882a593Smuzhiyun 		unsigned int memctl_interleaved,
115*4882a593Smuzhiyun 		unsigned int ctrl_num);
116*4882a593Smuzhiyun void fsl_ddr_sync_memctl_refresh(unsigned int first_ctrl,
117*4882a593Smuzhiyun 				 unsigned int last_ctrl);
118*4882a593Smuzhiyun 
119*4882a593Smuzhiyun int fsl_ddr_interactive_env_var_exists(void);
120*4882a593Smuzhiyun unsigned long long fsl_ddr_interactive(fsl_ddr_info_t *pinfo, int var_is_set);
121*4882a593Smuzhiyun void fsl_ddr_get_spd(generic_spd_eeprom_t *ctrl_dimms_spd,
122*4882a593Smuzhiyun 		     unsigned int ctrl_num, unsigned int dimm_slots_per_ctrl);
123*4882a593Smuzhiyun 
124*4882a593Smuzhiyun int do_reset(cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[]);
125*4882a593Smuzhiyun unsigned int check_fsl_memctl_config_regs(const fsl_ddr_cfg_regs_t *ddr);
126*4882a593Smuzhiyun void board_add_ram_info(int use_default);
127*4882a593Smuzhiyun 
128*4882a593Smuzhiyun /* processor specific function */
129*4882a593Smuzhiyun void fsl_ddr_set_memctl_regs(const fsl_ddr_cfg_regs_t *regs,
130*4882a593Smuzhiyun 				   unsigned int ctrl_num, int step);
131*4882a593Smuzhiyun void remove_unused_controllers(fsl_ddr_info_t *info);
132*4882a593Smuzhiyun 
133*4882a593Smuzhiyun /* board specific function */
134*4882a593Smuzhiyun int fsl_ddr_get_dimm_params(dimm_params_t *pdimm,
135*4882a593Smuzhiyun 			unsigned int controller_number,
136*4882a593Smuzhiyun 			unsigned int dimm_number);
137*4882a593Smuzhiyun void update_spd_address(unsigned int ctrl_num,
138*4882a593Smuzhiyun 			unsigned int slot,
139*4882a593Smuzhiyun 			unsigned int *addr);
140*4882a593Smuzhiyun 
141*4882a593Smuzhiyun void erratum_a009942_check_cpo(void);
142*4882a593Smuzhiyun #endif
143