1 /* 2 * Copyright 2008 Freescale Semiconductor, Inc. 3 * 4 * This program is free software; you can redistribute it and/or 5 * modify it under the terms of the GNU General Public License 6 * Version 2 as published by the Free Software Foundation. 7 */ 8 9 #ifndef _DDR_SPD_H_ 10 #define _DDR_SPD_H_ 11 12 /* 13 * Format from "JEDEC Standard No. 21-C, 14 * Appendix D: Rev 1.0: SPD's for DDR SDRAM 15 */ 16 typedef struct ddr1_spd_eeprom_s { 17 unsigned char info_size; /* 0 # bytes written into serial memory */ 18 unsigned char chip_size; /* 1 Total # bytes of SPD memory device */ 19 unsigned char mem_type; /* 2 Fundamental memory type */ 20 unsigned char nrow_addr; /* 3 # of Row Addresses on this assembly */ 21 unsigned char ncol_addr; /* 4 # of Column Addrs on this assembly */ 22 unsigned char nrows; /* 5 Number of DIMM Banks */ 23 unsigned char dataw_lsb; /* 6 Data Width of this assembly */ 24 unsigned char dataw_msb; /* 7 ... Data Width continuation */ 25 unsigned char voltage; /* 8 Voltage intf std of this assembly */ 26 unsigned char clk_cycle; /* 9 SDRAM Cycle time @ CL=X */ 27 unsigned char clk_access; /* 10 SDRAM Access from Clk @ CL=X (tAC) */ 28 unsigned char config; /* 11 DIMM Configuration type */ 29 unsigned char refresh; /* 12 Refresh Rate/Type */ 30 unsigned char primw; /* 13 Primary SDRAM Width */ 31 unsigned char ecw; /* 14 Error Checking SDRAM width */ 32 unsigned char min_delay; /* 15 for Back to Back Random Address */ 33 unsigned char burstl; /* 16 Burst Lengths Supported */ 34 unsigned char nbanks; /* 17 # of Banks on SDRAM Device */ 35 unsigned char cas_lat; /* 18 CAS# Latencies Supported */ 36 unsigned char cs_lat; /* 19 CS# Latency */ 37 unsigned char write_lat; /* 20 Write Latency (aka Write Recovery) */ 38 unsigned char mod_attr; /* 21 SDRAM Module Attributes */ 39 unsigned char dev_attr; /* 22 SDRAM Device Attributes */ 40 unsigned char clk_cycle2; /* 23 Min SDRAM Cycle time @ CL=X-0.5 */ 41 unsigned char clk_access2; /* 24 SDRAM Access from 42 Clk @ CL=X-0.5 (tAC) */ 43 unsigned char clk_cycle3; /* 25 Min SDRAM Cycle time @ CL=X-1 */ 44 unsigned char clk_access3; /* 26 Max Access from Clk @ CL=X-1 (tAC) */ 45 unsigned char trp; /* 27 Min Row Precharge Time (tRP)*/ 46 unsigned char trrd; /* 28 Min Row Active to Row Active (tRRD) */ 47 unsigned char trcd; /* 29 Min RAS to CAS Delay (tRCD) */ 48 unsigned char tras; /* 30 Minimum RAS Pulse Width (tRAS) */ 49 unsigned char bank_dens; /* 31 Density of each bank on module */ 50 unsigned char ca_setup; /* 32 Addr + Cmd Setup Time Before Clk */ 51 unsigned char ca_hold; /* 33 Addr + Cmd Hold Time After Clk */ 52 unsigned char data_setup; /* 34 Data Input Setup Time Before Strobe */ 53 unsigned char data_hold; /* 35 Data Input Hold Time After Strobe */ 54 unsigned char res_36_40[5];/* 36-40 reserved for VCSDRAM */ 55 unsigned char trc; /* 41 Min Active to Auto refresh time tRC */ 56 unsigned char trfc; /* 42 Min Auto to Active period tRFC */ 57 unsigned char tckmax; /* 43 Max device cycle time tCKmax */ 58 unsigned char tdqsq; /* 44 Max DQS to DQ skew (tDQSQ max) */ 59 unsigned char tqhs; /* 45 Max Read DataHold skew (tQHS) */ 60 unsigned char res_46; /* 46 Reserved */ 61 unsigned char dimm_height; /* 47 DDR SDRAM DIMM Height */ 62 unsigned char res_48_61[14]; /* 48-61 Reserved */ 63 unsigned char spd_rev; /* 62 SPD Data Revision Code */ 64 unsigned char cksum; /* 63 Checksum for bytes 0-62 */ 65 unsigned char mid[8]; /* 64-71 Mfr's JEDEC ID code per JEP-106 */ 66 unsigned char mloc; /* 72 Manufacturing Location */ 67 unsigned char mpart[18]; /* 73 Manufacturer's Part Number */ 68 unsigned char rev[2]; /* 91 Revision Code */ 69 unsigned char mdate[2]; /* 93 Manufacturing Date */ 70 unsigned char sernum[4]; /* 95 Assembly Serial Number */ 71 unsigned char mspec[27]; /* 99-127 Manufacturer Specific Data */ 72 73 } ddr1_spd_eeprom_t; 74 75 /* 76 * Format from "JEDEC Appendix X: Serial Presence Detects for DDR2 SDRAM", 77 * SPD Revision 1.2 78 */ 79 typedef struct ddr2_spd_eeprom_s { 80 unsigned char info_size; /* 0 # bytes written into serial memory */ 81 unsigned char chip_size; /* 1 Total # bytes of SPD memory device */ 82 unsigned char mem_type; /* 2 Fundamental memory type */ 83 unsigned char nrow_addr; /* 3 # of Row Addresses on this assembly */ 84 unsigned char ncol_addr; /* 4 # of Column Addrs on this assembly */ 85 unsigned char mod_ranks; /* 5 Number of DIMM Ranks */ 86 unsigned char dataw; /* 6 Module Data Width */ 87 unsigned char res_7; /* 7 Reserved */ 88 unsigned char voltage; /* 8 Voltage intf std of this assembly */ 89 unsigned char clk_cycle; /* 9 SDRAM Cycle time @ CL=X */ 90 unsigned char clk_access; /* 10 SDRAM Access from Clk @ CL=X (tAC) */ 91 unsigned char config; /* 11 DIMM Configuration type */ 92 unsigned char refresh; /* 12 Refresh Rate/Type */ 93 unsigned char primw; /* 13 Primary SDRAM Width */ 94 unsigned char ecw; /* 14 Error Checking SDRAM width */ 95 unsigned char res_15; /* 15 Reserved */ 96 unsigned char burstl; /* 16 Burst Lengths Supported */ 97 unsigned char nbanks; /* 17 # of Banks on Each SDRAM Device */ 98 unsigned char cas_lat; /* 18 CAS# Latencies Supported */ 99 unsigned char mech_char; /* 19 DIMM Mechanical Characteristics */ 100 unsigned char dimm_type; /* 20 DIMM type information */ 101 unsigned char mod_attr; /* 21 SDRAM Module Attributes */ 102 unsigned char dev_attr; /* 22 SDRAM Device Attributes */ 103 unsigned char clk_cycle2; /* 23 Min SDRAM Cycle time @ CL=X-1 */ 104 unsigned char clk_access2; /* 24 SDRAM Access from Clk @ CL=X-1 (tAC) */ 105 unsigned char clk_cycle3; /* 25 Min SDRAM Cycle time @ CL=X-2 */ 106 unsigned char clk_access3; /* 26 Max Access from Clk @ CL=X-2 (tAC) */ 107 unsigned char trp; /* 27 Min Row Precharge Time (tRP)*/ 108 unsigned char trrd; /* 28 Min Row Active to Row Active (tRRD) */ 109 unsigned char trcd; /* 29 Min RAS to CAS Delay (tRCD) */ 110 unsigned char tras; /* 30 Minimum RAS Pulse Width (tRAS) */ 111 unsigned char rank_dens; /* 31 Density of each rank on module */ 112 unsigned char ca_setup; /* 32 Addr+Cmd Setup Time Before Clk (tIS) */ 113 unsigned char ca_hold; /* 33 Addr+Cmd Hold Time After Clk (tIH) */ 114 unsigned char data_setup; /* 34 Data Input Setup Time 115 Before Strobe (tDS) */ 116 unsigned char data_hold; /* 35 Data Input Hold Time 117 After Strobe (tDH) */ 118 unsigned char twr; /* 36 Write Recovery time tWR */ 119 unsigned char twtr; /* 37 Int write to read delay tWTR */ 120 unsigned char trtp; /* 38 Int read to precharge delay tRTP */ 121 unsigned char mem_probe; /* 39 Mem analysis probe characteristics */ 122 unsigned char trctrfc_ext; /* 40 Extensions to trc and trfc */ 123 unsigned char trc; /* 41 Min Active to Auto refresh time tRC */ 124 unsigned char trfc; /* 42 Min Auto to Active period tRFC */ 125 unsigned char tckmax; /* 43 Max device cycle time tCKmax */ 126 unsigned char tdqsq; /* 44 Max DQS to DQ skew (tDQSQ max) */ 127 unsigned char tqhs; /* 45 Max Read DataHold skew (tQHS) */ 128 unsigned char pll_relock; /* 46 PLL Relock time */ 129 unsigned char Tcasemax; /* 47 Tcasemax */ 130 unsigned char psiTAdram; /* 48 Thermal Resistance of DRAM Package from 131 Top (Case) to Ambient (Psi T-A DRAM) */ 132 unsigned char dt0_mode; /* 49 DRAM Case Temperature Rise from Ambient 133 due to Activate-Precharge/Mode Bits 134 (DT0/Mode Bits) */ 135 unsigned char dt2n_dt2q; /* 50 DRAM Case Temperature Rise from Ambient 136 due to Precharge/Quiet Standby 137 (DT2N/DT2Q) */ 138 unsigned char dt2p; /* 51 DRAM Case Temperature Rise from Ambient 139 due to Precharge Power-Down (DT2P) */ 140 unsigned char dt3n; /* 52 DRAM Case Temperature Rise from Ambient 141 due to Active Standby (DT3N) */ 142 unsigned char dt3pfast; /* 53 DRAM Case Temperature Rise from Ambient 143 due to Active Power-Down with 144 Fast PDN Exit (DT3Pfast) */ 145 unsigned char dt3pslow; /* 54 DRAM Case Temperature Rise from Ambient 146 due to Active Power-Down with Slow 147 PDN Exit (DT3Pslow) */ 148 unsigned char dt4r_dt4r4w; /* 55 DRAM Case Temperature Rise from Ambient 149 due to Page Open Burst Read/DT4R4W 150 Mode Bit (DT4R/DT4R4W Mode Bit) */ 151 unsigned char dt5b; /* 56 DRAM Case Temperature Rise from Ambient 152 due to Burst Refresh (DT5B) */ 153 unsigned char dt7; /* 57 DRAM Case Temperature Rise from Ambient 154 due to Bank Interleave Reads with 155 Auto-Precharge (DT7) */ 156 unsigned char psiTApll; /* 58 Thermal Resistance of PLL Package form 157 Top (Case) to Ambient (Psi T-A PLL) */ 158 unsigned char psiTAreg; /* 59 Thermal Reisitance of Register Package 159 from Top (Case) to Ambient 160 (Psi T-A Register) */ 161 unsigned char dtpllactive; /* 60 PLL Case Temperature Rise from Ambient 162 due to PLL Active (DT PLL Active) */ 163 unsigned char dtregact; /* 61 Register Case Temperature Rise from 164 Ambient due to Register Active/Mode Bit 165 (DT Register Active/Mode Bit) */ 166 unsigned char spd_rev; /* 62 SPD Data Revision Code */ 167 unsigned char cksum; /* 63 Checksum for bytes 0-62 */ 168 unsigned char mid[8]; /* 64 Mfr's JEDEC ID code per JEP-106 */ 169 unsigned char mloc; /* 72 Manufacturing Location */ 170 unsigned char mpart[18]; /* 73 Manufacturer's Part Number */ 171 unsigned char rev[2]; /* 91 Revision Code */ 172 unsigned char mdate[2]; /* 93 Manufacturing Date */ 173 unsigned char sernum[4]; /* 95 Assembly Serial Number */ 174 unsigned char mspec[27]; /* 99-127 Manufacturer Specific Data */ 175 176 } ddr2_spd_eeprom_t; 177 178 typedef struct ddr3_spd_eeprom_s { 179 /* General Section: Bytes 0-59 */ 180 unsigned char info_size_crc; /* 0 # bytes written into serial memory, 181 CRC coverage */ 182 unsigned char spd_rev; /* 1 Total # bytes of SPD mem device */ 183 unsigned char mem_type; /* 2 Key Byte / Fundamental mem type */ 184 unsigned char module_type; /* 3 Key Byte / Module Type */ 185 unsigned char density_banks; /* 4 SDRAM Density and Banks */ 186 unsigned char addressing; /* 5 SDRAM Addressing */ 187 unsigned char module_vdd; /* 6 Module nominal voltage, VDD */ 188 unsigned char organization; /* 7 Module Organization */ 189 unsigned char bus_width; /* 8 Module Memory Bus Width */ 190 unsigned char ftb_div; /* 9 Fine Timebase (FTB) 191 Dividend / Divisor */ 192 unsigned char mtb_dividend; /* 10 Medium Timebase (MTB) Dividend */ 193 unsigned char mtb_divisor; /* 11 Medium Timebase (MTB) Divisor */ 194 unsigned char tCK_min; /* 12 SDRAM Minimum Cycle Time */ 195 unsigned char res_13; /* 13 Reserved */ 196 unsigned char caslat_lsb; /* 14 CAS Latencies Supported, 197 Least Significant Byte */ 198 unsigned char caslat_msb; /* 15 CAS Latencies Supported, 199 Most Significant Byte */ 200 unsigned char tAA_min; /* 16 Min CAS Latency Time */ 201 unsigned char tWR_min; /* 17 Min Write REcovery Time */ 202 unsigned char tRCD_min; /* 18 Min RAS# to CAS# Delay Time */ 203 unsigned char tRRD_min; /* 19 Min Row Active to 204 Row Active Delay Time */ 205 unsigned char tRP_min; /* 20 Min Row Precharge Delay Time */ 206 unsigned char tRAS_tRC_ext; /* 21 Upper Nibbles for tRAS and tRC */ 207 unsigned char tRAS_min_lsb; /* 22 Min Active to Precharge 208 Delay Time */ 209 unsigned char tRC_min_lsb; /* 23 Min Active to Active/Refresh 210 Delay Time, LSB */ 211 unsigned char tRFC_min_lsb; /* 24 Min Refresh Recovery Delay Time */ 212 unsigned char tRFC_min_msb; /* 25 Min Refresh Recovery Delay Time */ 213 unsigned char tWTR_min; /* 26 Min Internal Write to 214 Read Command Delay Time */ 215 unsigned char tRTP_min; /* 27 Min Internal Read to Precharge 216 Command Delay Time */ 217 unsigned char tFAW_msb; /* 28 Upper Nibble for tFAW */ 218 unsigned char tFAW_min; /* 29 Min Four Activate Window 219 Delay Time*/ 220 unsigned char opt_features; /* 30 SDRAM Optional Features */ 221 unsigned char therm_ref_opt; /* 31 SDRAM Thermal and Refresh Opts */ 222 unsigned char therm_sensor; /* 32 Module Thermal Sensor */ 223 unsigned char device_type; /* 33 SDRAM device type */ 224 int8_t fine_tCK_min; /* 34 Fine offset for tCKmin */ 225 int8_t fine_tAA_min; /* 35 Fine offset for tAAmin */ 226 int8_t fine_tRCD_min; /* 36 Fine offset for tRCDmin */ 227 int8_t fine_tRP_min; /* 37 Fine offset for tRPmin */ 228 int8_t fine_tRC_min; /* 38 Fine offset for tRCmin */ 229 unsigned char res_39_59[21]; /* 39-59 Reserved, General Section */ 230 231 /* Module-Specific Section: Bytes 60-116 */ 232 union { 233 struct { 234 /* 60 (Unbuffered) Module Nominal Height */ 235 unsigned char mod_height; 236 /* 61 (Unbuffered) Module Maximum Thickness */ 237 unsigned char mod_thickness; 238 /* 62 (Unbuffered) Reference Raw Card Used */ 239 unsigned char ref_raw_card; 240 /* 63 (Unbuffered) Address Mapping from 241 Edge Connector to DRAM */ 242 unsigned char addr_mapping; 243 /* 64-116 (Unbuffered) Reserved */ 244 unsigned char res_64_116[53]; 245 } unbuffered; 246 struct { 247 /* 60 (Registered) Module Nominal Height */ 248 unsigned char mod_height; 249 /* 61 (Registered) Module Maximum Thickness */ 250 unsigned char mod_thickness; 251 /* 62 (Registered) Reference Raw Card Used */ 252 unsigned char ref_raw_card; 253 /* 63 DIMM Module Attributes */ 254 unsigned char modu_attr; 255 /* 64 RDIMM Thermal Heat Spreader Solution */ 256 unsigned char thermal; 257 /* 65 Register Manufacturer ID Code, Least Significant Byte */ 258 unsigned char reg_id_lo; 259 /* 66 Register Manufacturer ID Code, Most Significant Byte */ 260 unsigned char reg_id_hi; 261 /* 67 Register Revision Number */ 262 unsigned char reg_rev; 263 /* 68 Register Type */ 264 unsigned char reg_type; 265 /* 69-76 RC1,3,5...15 (MS Nibble) / RC0,2,4...14 (LS Nibble) */ 266 unsigned char rcw[8]; 267 } registered; 268 unsigned char uc[57]; /* 60-116 Module-Specific Section */ 269 } mod_section; 270 271 /* Unique Module ID: Bytes 117-125 */ 272 unsigned char mmid_lsb; /* 117 Module MfgID Code LSB - JEP-106 */ 273 unsigned char mmid_msb; /* 118 Module MfgID Code MSB - JEP-106 */ 274 unsigned char mloc; /* 119 Mfg Location */ 275 unsigned char mdate[2]; /* 120-121 Mfg Date */ 276 unsigned char sernum[4]; /* 122-125 Module Serial Number */ 277 278 /* CRC: Bytes 126-127 */ 279 unsigned char crc[2]; /* 126-127 SPD CRC */ 280 281 /* Other Manufacturer Fields and User Space: Bytes 128-255 */ 282 unsigned char mpart[18]; /* 128-145 Mfg's Module Part Number */ 283 unsigned char mrev[2]; /* 146-147 Module Revision Code */ 284 285 unsigned char dmid_lsb; /* 148 DRAM MfgID Code LSB - JEP-106 */ 286 unsigned char dmid_msb; /* 149 DRAM MfgID Code MSB - JEP-106 */ 287 288 unsigned char msd[26]; /* 150-175 Mfg's Specific Data */ 289 unsigned char cust[80]; /* 176-255 Open for Customer Use */ 290 291 } ddr3_spd_eeprom_t; 292 293 extern unsigned int ddr1_spd_check(const ddr1_spd_eeprom_t *spd); 294 extern void ddr1_spd_dump(const ddr1_spd_eeprom_t *spd); 295 extern unsigned int ddr2_spd_check(const ddr2_spd_eeprom_t *spd); 296 extern void ddr2_spd_dump(const ddr2_spd_eeprom_t *spd); 297 extern unsigned int ddr3_spd_check(const ddr3_spd_eeprom_t *spd); 298 299 /* 300 * Byte 2 Fundamental Memory Types. 301 */ 302 #define SPD_MEMTYPE_FPM (0x01) 303 #define SPD_MEMTYPE_EDO (0x02) 304 #define SPD_MEMTYPE_PIPE_NIBBLE (0x03) 305 #define SPD_MEMTYPE_SDRAM (0x04) 306 #define SPD_MEMTYPE_ROM (0x05) 307 #define SPD_MEMTYPE_SGRAM (0x06) 308 #define SPD_MEMTYPE_DDR (0x07) 309 #define SPD_MEMTYPE_DDR2 (0x08) 310 #define SPD_MEMTYPE_DDR2_FBDIMM (0x09) 311 #define SPD_MEMTYPE_DDR2_FBDIMM_PROBE (0x0A) 312 #define SPD_MEMTYPE_DDR3 (0x0B) 313 314 /* DIMM Type for DDR2 SPD (according to v1.3) */ 315 #define DDR2_SPD_DIMMTYPE_UNDEFINED (0x00) 316 #define DDR2_SPD_DIMMTYPE_RDIMM (0x01) 317 #define DDR2_SPD_DIMMTYPE_UDIMM (0x02) 318 #define DDR2_SPD_DIMMTYPE_SO_DIMM (0x04) 319 #define DDR2_SPD_DIMMTYPE_72B_SO_CDIMM (0x06) 320 #define DDR2_SPD_DIMMTYPE_72B_SO_RDIMM (0x07) 321 #define DDR2_SPD_DIMMTYPE_MICRO_DIMM (0x08) 322 #define DDR2_SPD_DIMMTYPE_MINI_RDIMM (0x10) 323 #define DDR2_SPD_DIMMTYPE_MINI_UDIMM (0x20) 324 325 /* Byte 3 Key Byte / Module Type for DDR3 SPD */ 326 #define DDR3_SPD_MODULETYPE_MASK (0x0f) 327 #define DDR3_SPD_MODULETYPE_RDIMM (0x01) 328 #define DDR3_SPD_MODULETYPE_UDIMM (0x02) 329 #define DDR3_SPD_MODULETYPE_SO_DIMM (0x03) 330 #define DDR3_SPD_MODULETYPE_MICRO_DIMM (0x04) 331 #define DDR3_SPD_MODULETYPE_MINI_RDIMM (0x05) 332 #define DDR3_SPD_MODULETYPE_MINI_UDIMM (0x06) 333 #define DDR3_SPD_MODULETYPE_MINI_CDIMM (0x07) 334 #define DDR3_SPD_MODULETYPE_72B_SO_UDIMM (0x08) 335 #define DDR3_SPD_MODULETYPE_72B_SO_RDIMM (0x09) 336 #define DDR3_SPD_MODULETYPE_72B_SO_CDIMM (0x0A) 337 #define DDR3_SPD_MODULETYPE_LRDIMM (0x0B) 338 #define DDR3_SPD_MODULETYPE_16B_SO_DIMM (0x0C) 339 #define DDR3_SPD_MODULETYPE_32B_SO_DIMM (0x0D) 340 341 #endif /* _DDR_SPD_H_ */ 342