1 /* 2 * Copyright (C) Marvell International Ltd. and its affiliates 3 * 4 * SPDX-License-Identifier: GPL-2.0 5 */ 6 7 #ifndef _DDR3_TRAINING_IP_H_ 8 #define _DDR3_TRAINING_IP_H_ 9 10 #include "ddr3_training_ip_def.h" 11 #include "ddr_topology_def.h" 12 #include "ddr_training_ip_db.h" 13 14 #define DDR3_TIP_VERSION_STRING "DDR3 Training Sequence - Ver TIP-1.29." 15 16 #define MAX_CS_NUM 4 17 #define MAX_TOTAL_BUS_NUM (MAX_INTERFACE_NUM * MAX_BUS_NUM) 18 #define MAX_DQ_NUM 40 19 20 #define GET_MIN(arg1, arg2) ((arg1) < (arg2)) ? (arg1) : (arg2) 21 #define GET_MAX(arg1, arg2) ((arg1) < (arg2)) ? (arg2) : (arg1) 22 23 #define INIT_CONTROLLER_MASK_BIT 0x00000001 24 #define STATIC_LEVELING_MASK_BIT 0x00000002 25 #define SET_LOW_FREQ_MASK_BIT 0x00000004 26 #define LOAD_PATTERN_MASK_BIT 0x00000008 27 #define SET_MEDIUM_FREQ_MASK_BIT 0x00000010 28 #define WRITE_LEVELING_MASK_BIT 0x00000020 29 #define LOAD_PATTERN_2_MASK_BIT 0x00000040 30 #define READ_LEVELING_MASK_BIT 0x00000080 31 #define SW_READ_LEVELING_MASK_BIT 0x00000100 32 #define WRITE_LEVELING_SUPP_MASK_BIT 0x00000200 33 #define PBS_RX_MASK_BIT 0x00000400 34 #define PBS_TX_MASK_BIT 0x00000800 35 #define SET_TARGET_FREQ_MASK_BIT 0x00001000 36 #define ADJUST_DQS_MASK_BIT 0x00002000 37 #define WRITE_LEVELING_TF_MASK_BIT 0x00004000 38 #define LOAD_PATTERN_HIGH_MASK_BIT 0x00008000 39 #define READ_LEVELING_TF_MASK_BIT 0x00010000 40 #define WRITE_LEVELING_SUPP_TF_MASK_BIT 0x00020000 41 #define DM_PBS_TX_MASK_BIT 0x00040000 42 #define CENTRALIZATION_RX_MASK_BIT 0x00100000 43 #define CENTRALIZATION_TX_MASK_BIT 0x00200000 44 #define TX_EMPHASIS_MASK_BIT 0x00400000 45 #define PER_BIT_READ_LEVELING_TF_MASK_BIT 0x00800000 46 #define VREF_CALIBRATION_MASK_BIT 0x01000000 47 48 enum hws_result { 49 TEST_FAILED = 0, 50 TEST_SUCCESS = 1, 51 NO_TEST_DONE = 2 52 }; 53 54 enum hws_training_result { 55 RESULT_PER_BIT, 56 RESULT_PER_BYTE 57 }; 58 59 enum auto_tune_stage { 60 INIT_CONTROLLER, 61 STATIC_LEVELING, 62 SET_LOW_FREQ, 63 LOAD_PATTERN, 64 SET_MEDIUM_FREQ, 65 WRITE_LEVELING, 66 LOAD_PATTERN_2, 67 READ_LEVELING, 68 WRITE_LEVELING_SUPP, 69 PBS_RX, 70 PBS_TX, 71 SET_TARGET_FREQ, 72 ADJUST_DQS, 73 WRITE_LEVELING_TF, 74 READ_LEVELING_TF, 75 WRITE_LEVELING_SUPP_TF, 76 DM_PBS_TX, 77 VREF_CALIBRATION, 78 CENTRALIZATION_RX, 79 CENTRALIZATION_TX, 80 TX_EMPHASIS, 81 LOAD_PATTERN_HIGH, 82 PER_BIT_READ_LEVELING_TF, 83 MAX_STAGE_LIMIT 84 }; 85 86 enum hws_access_type { 87 ACCESS_TYPE_UNICAST = 0, 88 ACCESS_TYPE_MULTICAST = 1 89 }; 90 91 enum hws_algo_type { 92 ALGO_TYPE_DYNAMIC, 93 ALGO_TYPE_STATIC 94 }; 95 96 struct init_cntr_param { 97 int is_ctrl64_bit; 98 int do_mrs_phy; 99 int init_phy; 100 int msys_init; 101 }; 102 103 struct pattern_info { 104 u8 num_of_phases_tx; 105 u8 tx_burst_size; 106 u8 delay_between_bursts; 107 u8 num_of_phases_rx; 108 u32 start_addr; 109 u8 pattern_len; 110 }; 111 112 /* CL value for each frequency */ 113 struct cl_val_per_freq { 114 u8 cl_val[DDR_FREQ_LIMIT]; 115 }; 116 117 struct cs_element { 118 u8 cs_num; 119 u8 num_of_cs; 120 }; 121 122 struct mode_info { 123 /* 32 bits representing MRS bits */ 124 u32 reg_mr0[MAX_INTERFACE_NUM]; 125 u32 reg_mr1[MAX_INTERFACE_NUM]; 126 u32 reg_mr2[MAX_INTERFACE_NUM]; 127 u32 reg_m_r3[MAX_INTERFACE_NUM]; 128 /* 129 * Each element in array represent read_data_sample register delay for 130 * a specific interface. 131 * Each register, 4 bits[0+CS*8 to 4+CS*8] represent Number of DDR 132 * cycles from read command until data is ready to be fetched from 133 * the PHY, when accessing CS. 134 */ 135 u32 read_data_sample[MAX_INTERFACE_NUM]; 136 /* 137 * Each element in array represent read_data_sample register delay for 138 * a specific interface. 139 * Each register, 4 bits[0+CS*8 to 4+CS*8] represent the total delay 140 * from read command until opening the read mask, when accessing CS. 141 * This field defines the delay in DDR cycles granularity. 142 */ 143 u32 read_data_ready[MAX_INTERFACE_NUM]; 144 }; 145 146 struct hws_tip_freq_config_info { 147 u8 is_supported; 148 u8 bw_per_freq; 149 u8 rate_per_freq; 150 }; 151 152 struct hws_cs_config_info { 153 u32 cs_reg_value; 154 u32 cs_cbe_value; 155 }; 156 157 struct dfx_access { 158 u8 pipe; 159 u8 client; 160 }; 161 162 struct hws_xsb_info { 163 struct dfx_access *dfx_table; 164 }; 165 166 int ddr3_tip_register_dq_table(u32 dev_num, u32 *table); 167 int hws_ddr3_tip_select_ddr_controller(u32 dev_num, int enable); 168 int hws_ddr3_tip_init_controller(u32 dev_num, 169 struct init_cntr_param *init_cntr_prm); 170 int hws_ddr3_tip_load_topology_map(u32 dev_num, 171 struct hws_topology_map *topology); 172 int hws_ddr3_tip_run_alg(u32 dev_num, enum hws_algo_type algo_type); 173 int hws_ddr3_tip_mode_read(u32 dev_num, struct mode_info *mode_info); 174 int hws_ddr3_tip_read_training_result(u32 dev_num, 175 enum hws_result result[MAX_STAGE_LIMIT][MAX_INTERFACE_NUM]); 176 int ddr3_tip_is_pup_lock(u32 *pup_buf, enum hws_training_result read_mode); 177 u8 ddr3_tip_get_buf_min(u8 *buf_ptr); 178 u8 ddr3_tip_get_buf_max(u8 *buf_ptr); 179 180 #endif /* _DDR3_TRAINING_IP_H_ */ 181