Patrick Georgi | ac95903 | 2020-05-05 22:49:26 +0200 | [diff] [blame] | 1 | /* SPDX-License-Identifier: GPL-2.0-or-later */ |
Stefan Reinauer | eca92fb | 2006-08-23 14:28:37 +0000 | [diff] [blame] | 2 | |
Uwe Hermann | 998a57c | 2006-11-22 11:41:32 +0000 | [diff] [blame] | 3 | /* |
| 4 | * Serial Presence Detect (SPD) data stored on SDRAM modules. |
| 5 | * |
| 6 | * Datasheet: |
| 7 | * - Name: PC SDRAM Serial Presence Detect (SPD) Specification |
| 8 | * Revision 1.2A, December, 1997 |
| 9 | * - PDF: http://www.intel.com/design/chipsets/memory/spdsd12a.pdf |
| 10 | * |
| 11 | * Datasheet (alternative): |
| 12 | * - Name: SERIAL PRESENCE DETECT STANDARD, General Standard |
| 13 | * JEDEC Standard No. 21-C |
Elyes HAOUAS | c8d24dd | 2016-06-15 21:13:07 +0200 | [diff] [blame] | 14 | * Annex J: Serial Presence Detects for DDR2 SDRAM (Revision 1.3): |
| 15 | * - PDF: http://www.jedec.org/download/search/4_01_02_10R17.pdf |
Uwe Hermann | 998a57c | 2006-11-22 11:41:32 +0000 | [diff] [blame] | 16 | */ |
Stefan Reinauer | eca92fb | 2006-08-23 14:28:37 +0000 | [diff] [blame] | 17 | |
Uwe Hermann | 998a57c | 2006-11-22 11:41:32 +0000 | [diff] [blame] | 18 | #ifndef _SPD_H_ |
| 19 | #define _SPD_H_ |
Stefan Reinauer | eca92fb | 2006-08-23 14:28:37 +0000 | [diff] [blame] | 20 | |
Uwe Hermann | 998a57c | 2006-11-22 11:41:32 +0000 | [diff] [blame] | 21 | /* Byte numbers. */ |
Lee Leahy | 6a566d7 | 2017-03-07 17:45:12 -0800 | [diff] [blame] | 22 | /* Number of bytes used by module manufacturer */ |
| 23 | #define SPD_NUM_MANUFACTURER_BYTES 0 |
Uwe Hermann | 998a57c | 2006-11-22 11:41:32 +0000 | [diff] [blame] | 24 | #define SPD_TOTAL_SPD_MEMORY_SIZE 1 /* Total SPD memory size */ |
| 25 | #define SPD_MEMORY_TYPE 2 /* (Fundamental) memory type */ |
| 26 | #define SPD_NUM_ROWS 3 /* Number of row address bits */ |
Lee Leahy | 6a566d7 | 2017-03-07 17:45:12 -0800 | [diff] [blame] | 27 | /* Number of column address bits */ |
| 28 | #define SPD_NUM_COLUMNS 4 |
| 29 | /* Number of module rows (banks) */ |
| 30 | #define SPD_NUM_DIMM_BANKS 5 |
Uwe Hermann | 998a57c | 2006-11-22 11:41:32 +0000 | [diff] [blame] | 31 | #define SPD_MODULE_DATA_WIDTH_LSB 6 /* Module data width (LSB) */ |
| 32 | #define SPD_MODULE_DATA_WIDTH_MSB 7 /* Module data width (MSB) */ |
Lee Leahy | 6a566d7 | 2017-03-07 17:45:12 -0800 | [diff] [blame] | 33 | /* Module interface signal levels */ |
| 34 | #define SPD_MODULE_VOLTAGE 8 |
| 35 | /* SDRAM cycle time (highest CAS latency), RAS access time (tRAC) */ |
| 36 | #define SPD_MIN_CYCLE_TIME_AT_CAS_MAX 9 |
| 37 | /* SDRAM access time from clock (highest CAS latency), CAS access time (Tac, |
| 38 | * tCAC) |
| 39 | */ |
| 40 | #define SPD_ACCESS_TIME_FROM_CLOCK 10 |
Uwe Hermann | 998a57c | 2006-11-22 11:41:32 +0000 | [diff] [blame] | 41 | #define SPD_DIMM_CONFIG_TYPE 11 /* Module configuration type */ |
| 42 | #define SPD_REFRESH 12 /* Refresh rate/type */ |
| 43 | #define SPD_PRIMARY_SDRAM_WIDTH 13 /* SDRAM width (primary SDRAM) */ |
Lee Leahy | 6a566d7 | 2017-03-07 17:45:12 -0800 | [diff] [blame] | 44 | /* Error checking SDRAM (data) width */ |
| 45 | #define SPD_ERROR_CHECKING_SDRAM_WIDTH 14 |
| 46 | /* SDRAM device attributes, minimum clock delay for back to back random |
| 47 | * column |
| 48 | */ |
| 49 | #define SPD_MIN_CLOCK_DELAY_B2B_RAND_COLUMN 15 |
| 50 | /* SDRAM device attributes, burst lengths supported */ |
| 51 | #define SPD_SUPPORTED_BURST_LENGTHS 16 |
| 52 | /* SDRAM device attributes, number of banks on SDRAM device */ |
| 53 | #define SPD_NUM_BANKS_PER_SDRAM 17 |
| 54 | /* SDRAM device attributes, CAS latency */ |
| 55 | #define SPD_ACCEPTABLE_CAS_LATENCIES 18 |
| 56 | /* SDRAM device attributes, CS latency */ |
| 57 | #define SPD_CS_LATENCY 19 |
| 58 | /* SDRAM device attributes, WE latency */ |
| 59 | #define SPD_WE_LATENCY 20 |
Uwe Hermann | 998a57c | 2006-11-22 11:41:32 +0000 | [diff] [blame] | 60 | #define SPD_MODULE_ATTRIBUTES 21 /* SDRAM module attributes */ |
Lee Leahy | 6a566d7 | 2017-03-07 17:45:12 -0800 | [diff] [blame] | 61 | /* SDRAM device attributes, general */ |
| 62 | #define SPD_DEVICE_ATTRIBUTES_GENERAL 22 |
| 63 | /* SDRAM cycle time (2nd highest CAS latency) */ |
| 64 | #define SPD_SDRAM_CYCLE_TIME_2ND 23 |
| 65 | /* SDRAM access from clock (2nd highest CAS latency) */ |
| 66 | #define SPD_ACCESS_TIME_FROM_CLOCK_2ND 24 |
| 67 | /* SDRAM cycle time (3rd highest CAS latency) */ |
| 68 | #define SPD_SDRAM_CYCLE_TIME_3RD 25 |
| 69 | /* SDRAM access from clock (3rd highest CAS latency) */ |
| 70 | #define SPD_ACCESS_TIME_FROM_CLOCK_3RD 26 |
| 71 | /* Minimum row precharge time (Trp) */ |
| 72 | #define SPD_MIN_ROW_PRECHARGE_TIME 27 |
| 73 | /* Minimum row active to row active (Trrd) */ |
| 74 | #define SPD_MIN_ROWACTIVE_TO_ROWACTIVE 28 |
| 75 | /* Minimum RAS to CAS delay (Trcd) */ |
| 76 | #define SPD_MIN_RAS_TO_CAS_DELAY 29 |
| 77 | /* Minimum RAS pulse width (Tras) */ |
| 78 | #define SPD_MIN_ACTIVE_TO_PRECHARGE_DELAY 30 |
| 79 | /* Density of each row on module */ |
| 80 | #define SPD_DENSITY_OF_EACH_ROW_ON_MODULE 31 |
| 81 | /* Command and address signal input setup time */ |
| 82 | #define SPD_CMD_SIGNAL_INPUT_SETUP_TIME 32 |
| 83 | /* Command and address signal input hold time */ |
| 84 | #define SPD_CMD_SIGNAL_INPUT_HOLD_TIME 33 |
| 85 | /* Data signal input setup time */ |
| 86 | #define SPD_DATA_SIGNAL_INPUT_SETUP_TIME 34 |
Uwe Hermann | 998a57c | 2006-11-22 11:41:32 +0000 | [diff] [blame] | 87 | #define SPD_DATA_SIGNAL_INPUT_HOLD_TIME 35 /* Data signal input hold time */ |
Stefan Reinauer | 951c62f | 2008-08-01 11:40:16 +0000 | [diff] [blame] | 88 | #define SPD_WRITE_RECOVERY_TIME 36 /* Write recovery time (tWR) */ |
Lee Leahy | 6a566d7 | 2017-03-07 17:45:12 -0800 | [diff] [blame] | 89 | /* Internal write to read command delay (tWTR) */ |
| 90 | #define SPD_INT_WRITE_TO_READ_DELAY 37 |
| 91 | /* Internal read to precharge command delay (tRTP) */ |
| 92 | #define SPD_INT_READ_TO_PRECHARGE_DELAY 38 |
| 93 | /* Memory analysis probe characteristics */ |
| 94 | #define SPD_MEM_ANALYSIS_PROBE_PARAMS 39 |
| 95 | /* Extension of byte 41 (tRC) and byte 42 (tRFC) */ |
| 96 | #define SPD_BYTE_41_42_EXTENSION 40 |
| 97 | /* Minimum active to active auto refresh (tRCmin) */ |
| 98 | #define SPD_MIN_ACT_TO_ACT_AUTO_REFRESH 41 |
| 99 | /* Minimum auto refresh to active/auto refresh (tRFC) */ |
| 100 | #define SPD_MIN_AUTO_REFRESH_TO_ACT 42 |
| 101 | /* Maximum device cycle time (tCKmax) */ |
| 102 | #define SPD_MAX_DEVICE_CYCLE_TIME 43 |
| 103 | /* Maximum skew between DQS and DQ (tDQSQ) */ |
| 104 | #define SPD_MAX_DQS_DQ_SKEW 44 |
| 105 | /* Maximum read data-hold skew factor (tQHS) */ |
| 106 | #define SPD_MAX_READ_DATAHOLD_SKEW 45 |
Ed Swierk | d39aad9 | 2008-08-28 18:23:58 +0000 | [diff] [blame] | 107 | #define SPD_PLL_RELOCK_TIME 46 /* PLL relock time */ |
Uwe Hermann | 998a57c | 2006-11-22 11:41:32 +0000 | [diff] [blame] | 108 | #define SPD_SPD_DATA_REVISION_CODE 62 /* SPD data revision code */ |
| 109 | #define SPD_CHECKSUM_FOR_BYTES_0_TO_62 63 /* Checksum for bytes 0-62 */ |
Lee Leahy | 6a566d7 | 2017-03-07 17:45:12 -0800 | [diff] [blame] | 110 | /* Manufacturer's JEDEC ID code, per EIA/JEP106 (bytes 64-71) */ |
| 111 | #define SPD_MANUFACTURER_JEDEC_ID_CODE 64 |
Uwe Hermann | 998a57c | 2006-11-22 11:41:32 +0000 | [diff] [blame] | 112 | #define SPD_MANUFACTURING_LOCATION 72 /* Manufacturing location */ |
Lee Leahy | 6a566d7 | 2017-03-07 17:45:12 -0800 | [diff] [blame] | 113 | /* Manufacturer's part number, in 6-bit ASCII (bytes 73-90) */ |
| 114 | #define SPD_MANUFACTURER_PART_NUMBER 73 |
Uwe Hermann | 998a57c | 2006-11-22 11:41:32 +0000 | [diff] [blame] | 115 | #define SPD_REVISION_CODE 91 /* Revision code (bytes 91-92) */ |
Lee Leahy | 6a566d7 | 2017-03-07 17:45:12 -0800 | [diff] [blame] | 116 | /* Manufacturing date (byte 93: year, byte 94: week) */ |
| 117 | #define SPD_MANUFACTURING_DATE 93 |
| 118 | /* Assembly serial number (bytes 95-98) */ |
| 119 | #define SPD_ASSEMBLY_SERIAL_NUMBER 95 |
| 120 | /* Manufacturer specific data (bytes 99-125) */ |
| 121 | #define SPD_MANUFACTURER_SPECIFIC_DATA 99 |
| 122 | /* Intel specification for frequency */ |
| 123 | #define SPD_INTEL_SPEC_FOR_FREQUENCY 126 |
| 124 | /* Intel specification details for 100MHz support */ |
| 125 | #define SPD_INTEL_SPEC_100_MHZ 127 |
Stefan Reinauer | eca92fb | 2006-08-23 14:28:37 +0000 | [diff] [blame] | 126 | |
Marc Jones | bc8176c | 2007-05-04 18:24:55 +0000 | [diff] [blame] | 127 | /* DRAM specifications use the following naming conventions for SPD locations */ |
| 128 | #define SPD_tRP SPD_MIN_ROW_PRECHARGE_TIME |
| 129 | #define SPD_tRRD SPD_MIN_ROWACTIVE_TO_ROWACTIVE |
| 130 | #define SPD_tRCD SPD_MIN_RAS_TO_CAS_DELAY |
| 131 | #define SPD_tRAS SPD_MIN_ACTIVE_TO_PRECHARGE_DELAY |
| 132 | #define SPD_BANK_DENSITY SPD_DENSITY_OF_EACH_ROW_ON_MODULE |
| 133 | #define SPD_ADDRESS_CMD_HOLD SPD_CMD_SIGNAL_INPUT_HOLD_TIME |
Lee Leahy | 6a566d7 | 2017-03-07 17:45:12 -0800 | [diff] [blame] | 134 | /* SDRAM Device Minimum Active to Active/Auto Refresh Time (tRC) */ |
| 135 | #define SPD_tRC 41 |
| 136 | /* SDRAM Device Minimum Auto Refresh to Active/Auto Refresh (tRFC) */ |
| 137 | #define SPD_tRFC 42 |
Marc Jones | bc8176c | 2007-05-04 18:24:55 +0000 | [diff] [blame] | 138 | |
Uwe Hermann | 998a57c | 2006-11-22 11:41:32 +0000 | [diff] [blame] | 139 | /* SPD_MEMORY_TYPE values. */ |
Alexandru Gagniuc | 3261046 | 2013-05-21 14:07:41 -0500 | [diff] [blame] | 140 | enum spd_memory_type { |
| 141 | SPD_MEMORY_TYPE_UNDEFINED = 0x00, |
| 142 | SPD_MEMORY_TYPE_FPM_DRAM = 0x01, |
| 143 | SPD_MEMORY_TYPE_EDO = 0x02, |
| 144 | SPD_MEMORY_TYPE_PIPELINED_NIBBLE = 0x03, |
| 145 | SPD_MEMORY_TYPE_SDRAM = 0x04, |
| 146 | SPD_MEMORY_TYPE_MULTIPLEXED_ROM = 0x05, |
| 147 | SPD_MEMORY_TYPE_SGRAM_DDR = 0x06, |
| 148 | SPD_MEMORY_TYPE_SDRAM_DDR = 0x07, |
| 149 | SPD_MEMORY_TYPE_SDRAM_DDR2 = 0x08, |
| 150 | SPD_MEMORY_TYPE_FBDIMM_DDR2 = 0x09, |
| 151 | SPD_MEMORY_TYPE_FB_PROBE_DDR2 = 0x0a, |
| 152 | SPD_MEMORY_TYPE_SDRAM_DDR3 = 0x0b, |
Elyes HAOUAS | ed3ccc2 | 2016-06-20 18:57:19 +0200 | [diff] [blame] | 153 | SPD_MEMORY_TYPE_DDR4_SDRAM = 0x0c, |
| 154 | SPD_MEMORY_TYPE_DDR4E_SDRAM = 0x0e, |
| 155 | SPD_MEMORY_TYPE_LPDDR3_SDRAM = 0x0f, |
| 156 | SPD_MEMORY_TYPE_LPDDR4_SDRAM = 0x10, |
Elyes Haouas | 365cd34 | 2024-05-06 12:10:41 +0200 | [diff] [blame] | 157 | SPD_MEMORY_TYPE_LPDDR4X_SDRAM = 0x11, |
| 158 | SPD_MEMORY_TYPE_DDR5_SDRAM = 0x12, |
| 159 | SPD_MEMORY_TYPE_LPDDR5_SDRAM = 0x13, |
| 160 | SPD_MEMORY_TYPE_DDR5_NVDIMM_P = 0x14, |
| 161 | SPD_MEMORY_TYPE_LPDDR5X_SDRAM = 0x15, |
Elyes Haouas | 94c6cd1 | 2024-05-06 13:01:20 +0200 | [diff] [blame] | 162 | /* This is not a JEDEC module type ID */ |
| 163 | SPD_MEMORY_TYPE_LPDDR3_INTEL = 0xf1, |
Alexandru Gagniuc | 3261046 | 2013-05-21 14:07:41 -0500 | [diff] [blame] | 164 | }; |
Stefan Reinauer | eca92fb | 2006-08-23 14:28:37 +0000 | [diff] [blame] | 165 | |
Uwe Hermann | 998a57c | 2006-11-22 11:41:32 +0000 | [diff] [blame] | 166 | /* SPD_MODULE_VOLTAGE values. */ |
| 167 | #define SPD_VOLTAGE_TTL 0 /* 5.0 Volt/TTL */ |
| 168 | #define SPD_VOLTAGE_LVTTL 1 /* LVTTL */ |
| 169 | #define SPD_VOLTAGE_HSTL 2 /* HSTL 1.5 */ |
| 170 | #define SPD_VOLTAGE_SSTL3 3 /* SSTL 3.3 */ |
| 171 | #define SPD_VOLTAGE_SSTL2 4 /* SSTL 2.5 */ |
Elyes HAOUAS | 46bfce3 | 2016-06-15 19:05:11 +0200 | [diff] [blame] | 172 | #define SPD_VOLTAGE_SSTL1 5 /* SSTL 1.8 */ |
Stefan Reinauer | eca92fb | 2006-08-23 14:28:37 +0000 | [diff] [blame] | 173 | |
Uwe Hermann | 998a57c | 2006-11-22 11:41:32 +0000 | [diff] [blame] | 174 | /* SPD_DIMM_CONFIG_TYPE values. */ |
| 175 | #define ERROR_SCHEME_NONE 0 |
| 176 | #define ERROR_SCHEME_PARITY 1 |
| 177 | #define ERROR_SCHEME_ECC 2 |
Stefan Reinauer | eca92fb | 2006-08-23 14:28:37 +0000 | [diff] [blame] | 178 | |
Uwe Hermann | 998a57c | 2006-11-22 11:41:32 +0000 | [diff] [blame] | 179 | /* SPD_ACCEPTABLE_CAS_LATENCIES values. */ |
| 180 | // TODO: Check values. |
| 181 | #define SPD_CAS_LATENCY_1_0 0x01 |
| 182 | #define SPD_CAS_LATENCY_1_5 0x02 |
| 183 | #define SPD_CAS_LATENCY_2_0 0x04 |
| 184 | #define SPD_CAS_LATENCY_2_5 0x08 |
| 185 | #define SPD_CAS_LATENCY_3_0 0x10 |
| 186 | #define SPD_CAS_LATENCY_3_5 0x20 |
| 187 | #define SPD_CAS_LATENCY_4_0 0x40 |
Stefan Reinauer | eca92fb | 2006-08-23 14:28:37 +0000 | [diff] [blame] | 188 | |
Elyes HAOUAS | 89186b2 | 2016-06-26 17:46:21 +0200 | [diff] [blame] | 189 | #define SPD_CAS_LATENCY_DDR2_2 (1 << 2) |
Stefan Reinauer | 951c62f | 2008-08-01 11:40:16 +0000 | [diff] [blame] | 190 | #define SPD_CAS_LATENCY_DDR2_3 (1 << 3) |
| 191 | #define SPD_CAS_LATENCY_DDR2_4 (1 << 4) |
| 192 | #define SPD_CAS_LATENCY_DDR2_5 (1 << 5) |
| 193 | #define SPD_CAS_LATENCY_DDR2_6 (1 << 6) |
Elyes HAOUAS | d450609 | 2016-05-26 19:53:29 +0200 | [diff] [blame] | 194 | #define SPD_CAS_LATENCY_DDR2_7 (1 << 7) |
Stefan Reinauer | 951c62f | 2008-08-01 11:40:16 +0000 | [diff] [blame] | 195 | |
Uwe Hermann | 998a57c | 2006-11-22 11:41:32 +0000 | [diff] [blame] | 196 | /* SPD_SUPPORTED_BURST_LENGTHS values. */ |
| 197 | #define SPD_BURST_LENGTH_1 1 |
| 198 | #define SPD_BURST_LENGTH_2 2 |
| 199 | #define SPD_BURST_LENGTH_4 4 |
| 200 | #define SPD_BURST_LENGTH_8 8 |
| 201 | #define SPD_BURST_LENGTH_PAGE (1 << 7) |
Stefan Reinauer | eca92fb | 2006-08-23 14:28:37 +0000 | [diff] [blame] | 202 | |
Uwe Hermann | 998a57c | 2006-11-22 11:41:32 +0000 | [diff] [blame] | 203 | /* SPD_MODULE_ATTRIBUTES values. */ |
| 204 | #define MODULE_BUFFERED 1 |
| 205 | #define MODULE_REGISTERED 2 |
Stefan Reinauer | eca92fb | 2006-08-23 14:28:37 +0000 | [diff] [blame] | 206 | |
Elyes HAOUAS | c8d24dd | 2016-06-15 21:13:07 +0200 | [diff] [blame] | 207 | #define SPD_UNDEFINED 0x00 |
Raul E Rangel | 21db6cc | 2018-03-29 10:18:14 -0600 | [diff] [blame] | 208 | #define SPD_ECC_8BIT (1<<3) |
Subrata Banik | 3306f37 | 2021-10-26 13:19:20 +0530 | [diff] [blame] | 209 | #define SPD_ECC_8BIT_LP5_DDR5 (1<<4) |
Raul E Rangel | 21db6cc | 2018-03-29 10:18:14 -0600 | [diff] [blame] | 210 | |
Subrata Banik | 6de8b42 | 2021-10-26 20:46:21 +0530 | [diff] [blame] | 211 | enum lpx_module_type { |
| 212 | LPX_SPD_LPDIMM = 0x07, |
| 213 | LPX_SPD_NONDIMM = 0x0e, |
| 214 | }; |
| 215 | |
Uwe Hermann | d773fd3 | 2010-11-20 20:23:08 +0000 | [diff] [blame] | 216 | #endif |