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