xref: /aosp_15_r20/external/coreboot/src/lib/spd_cache.c (revision b9411a12aaaa7e1e6a6fb7c5e057f44ee179a49c)
1 /* SPDX-License-Identifier: GPL-2.0-only */
2 
3 #include <assert.h>
4 #include <console/console.h>
5 #include <crc_byte.h>
6 #include <fmap.h>
7 #include <spd_cache.h>
8 #include <spd_bin.h>
9 #include <string.h>
10 
11 /*
12  * SPD_CACHE layout
13  *    +==========+ offset 0x00
14  *    |DIMM 1 SPD|   SPD data length is CONFIG_DIMM_SPD_SIZE.
15  *    +----------+ offset CONFIG_DIMM_SPD_SIZE * 1
16  *    |DIMM 2 SPD|
17  *    +----------+ offset CONFIG_DIMM_SPD_SIZE * 2
18  *         ...
19  *    +----------+ offset CONFIG_DIMM_SPD_SIZE * (N -1)
20  *    |DIMM N SPD|   N = CONFIG_DIMM_MAX
21  *    +----------+ offset CONFIG_DIMM_SPD_SIZE * CONFIG_DIMM_MAX
22  *    |  CRC 16  |   Use to verify the data correctness.
23  *    +==========+
24  *
25  *  The size of the RW_SPD_CACHE needs to be aligned with 4KiB.
26  */
27 
28 /*
29  * Use to update SPD cache.
30  *  *blk : the new SPD data will be stash into the cache.
31  *
32  *  return CB_SUCCESS , update SPD cache successfully.
33  *  return CB_ERR , update SPD cache unsuccessfully and the cache is invalid
34  */
update_spd_cache(struct spd_block * blk)35 enum cb_err update_spd_cache(struct spd_block *blk)
36 {
37 	struct region_device rdev;
38 	uint16_t data_crc = 0;
39 	int i, j;
40 
41 	assert(blk->len <= SC_SPD_LEN);
42 
43 	if (fmap_locate_area_as_rdev_rw(SPD_CACHE_FMAP_NAME, &rdev)) {
44 		printk(BIOS_ERR, "SPD_CACHE: Cannot access %s region\n", SPD_CACHE_FMAP_NAME);
45 		return CB_ERR;
46 	}
47 
48 	/* Erase whole area, it's for align with 4KiB which is the size of SPI rom sector. */
49 	if (rdev_eraseat(&rdev, 0, region_device_sz(&rdev)) < 0) {
50 		printk(BIOS_ERR, "SPD_CACHE: Cannot erase %s region\n", SPD_CACHE_FMAP_NAME);
51 		return CB_ERR;
52 	}
53 
54 	/* Write SPD data */
55 	for (i = 0; i < SC_SPD_NUMS; i++) {
56 		if (blk->spd_array[i] == NULL) {
57 			/* If DIMM is not present, we calculate the CRC with 0xff. */
58 			for (j = 0; j < SC_SPD_LEN; j++)
59 				data_crc = crc16_byte(data_crc, 0xff);
60 		} else {
61 			if (rdev_writeat(&rdev, blk->spd_array[i], SC_SPD_OFFSET(i), blk->len)
62 										< 0) {
63 				printk(BIOS_ERR, "SPD_CACHE: Cannot write SPD data at %d\n",
64 					SC_SPD_OFFSET(i));
65 				return CB_ERR;
66 			}
67 
68 			for (j = 0; j < blk->len; j++)
69 				data_crc = crc16_byte(data_crc, blk->spd_array[i][j]);
70 
71 			/* If the blk->len < SC_SPD_LEN, we calculate the CRC with 0xff. */
72 			if (blk->len < SC_SPD_LEN)
73 				for (j = 0; j < (SC_SPD_LEN - (blk->len)); j++)
74 					data_crc = crc16_byte(data_crc, 0xff);
75 		}
76 	}
77 
78 	/* Write the crc16 */
79 	/* It must be the last step to ensure that the data is written correctly */
80 	if (rdev_writeat(&rdev, &data_crc, SC_CRC_OFFSET, SC_CRC_LEN) < 0) {
81 		printk(BIOS_ERR, "SPD_CACHE: Cannot write crc at 0x%04x\n", SC_CRC_OFFSET);
82 		return CB_ERR;
83 	}
84 	return CB_SUCCESS;
85 }
86 
87 /*
88  * Locate the RW_SPD_CACHE area in the fmap and read SPD_CACHE data.
89  *  return CB_SUCCESS ,if the SPD_CACHE data is ready and the pointer return at *spd_cache.
90  *  return CB_ERR ,if it cannot locate RW_SPD_CACHE area in the fmap or data cannot be read.
91  */
load_spd_cache(uint8_t ** spd_cache,size_t * spd_cache_sz)92 enum cb_err load_spd_cache(uint8_t **spd_cache, size_t *spd_cache_sz)
93 {
94 	struct region_device rdev;
95 
96 	if (fmap_locate_area_as_rdev(SPD_CACHE_FMAP_NAME, &rdev) < 0) {
97 		printk(BIOS_ERR, "SPD_CACHE: Cannot find %s region\n", SPD_CACHE_FMAP_NAME);
98 		return CB_ERR;
99 	}
100 
101 	/* Assume boot device is memory mapped. */
102 	assert(CONFIG(BOOT_DEVICE_MEMORY_MAPPED));
103 	*spd_cache = rdev_mmap_full(&rdev);
104 
105 	if (*spd_cache == NULL)
106 		return CB_ERR;
107 
108 	*spd_cache_sz = region_device_sz(&rdev);
109 
110 	/* SPD cache found */
111 	printk(BIOS_INFO, "SPD_CACHE: cache found, size 0x%zx\n", *spd_cache_sz);
112 
113 	return CB_SUCCESS;
114 }
115 
116 /* Use to verify the cache data is valid. */
spd_cache_is_valid(uint8_t * spd_cache,size_t spd_cache_sz)117 bool spd_cache_is_valid(uint8_t *spd_cache, size_t spd_cache_sz)
118 {
119 	uint16_t data_crc = 0;
120 	int i;
121 
122 	if (spd_cache_sz < SC_SPD_TOTAL_LEN + SC_CRC_LEN)
123 		return false;
124 
125 	/* Check the spd_cache crc */
126 	for (i = 0; i < SC_SPD_TOTAL_LEN; i++)
127 		data_crc = crc16_byte(data_crc, *(spd_cache + i));
128 
129 	return *(uint16_t *)(spd_cache + SC_CRC_OFFSET) == data_crc;
130 }
131 
132 /*
133  * Check if the DIMM is preset in cache.
134  *  return true , DIMM is present.
135  *  return false, DIMM is not present.
136  */
get_cached_dimm_present(uint8_t * spd_cache,uint8_t idx)137 static bool get_cached_dimm_present(uint8_t *spd_cache, uint8_t idx)
138 {
139 	if (*(uint16_t *)(spd_cache + SC_SPD_OFFSET(idx)) == 0xffff)
140 		return false;
141 	else
142 		return true;
143 }
144 
145 /*
146  * Use to check if the SODIMM is changed.
147  *  spd_cache : it's a valid SPD cache.
148  *  blk       : it must include the smbus addresses of SODIMM.
149  */
check_if_dimm_changed(u8 * spd_cache,struct spd_block * blk)150 bool check_if_dimm_changed(u8 *spd_cache, struct spd_block *blk)
151 {
152 	int i;
153 	u32 sn;
154 	bool dimm_present_in_cache;
155 	bool dimm_changed = false;
156 	/* Check if the dimm is the same with last system boot. */
157 	for (i = 0; i < SC_SPD_NUMS && !dimm_changed; i++) {
158 		if (blk->addr_map[i] == 0) {
159 			printk(BIOS_NOTICE, "SPD_CACHE: DIMM%d does not exist\n", i);
160 			continue;
161 		}
162 		/* Return true if any error happened here. */
163 		if (get_spd_sn(blk->addr_map[i], &sn) == CB_ERR)
164 			return true;
165 		dimm_present_in_cache = get_cached_dimm_present(spd_cache, i);
166 		/* Dimm is not present now. */
167 		if (sn == 0xffffffff) {
168 			if (!dimm_present_in_cache)
169 				printk(BIOS_NOTICE, "SPD_CACHE: DIMM%d is not present\n", i);
170 			else {
171 				printk(BIOS_NOTICE, "SPD_CACHE: DIMM%d lost\n", i);
172 				dimm_changed = true;
173 			}
174 		} else { /* Dimm is present now. */
175 			if (dimm_present_in_cache) {
176 				if (memcmp(&sn, spd_cache + SC_SPD_OFFSET(i) + DDR4_SPD_SN_OFF,
177 						SPD_SN_LEN) == 0)
178 					printk(BIOS_NOTICE, "SPD_CACHE: DIMM%d is the same\n",
179 											i);
180 				else {
181 					printk(BIOS_NOTICE, "SPD_CACHE: DIMM%d is new one\n",
182 											i);
183 					dimm_changed = true;
184 				}
185 			} else {
186 				printk(BIOS_NOTICE, "SPD_CACHE: DIMM%d is new one\n", i);
187 				dimm_changed = true;
188 			}
189 		}
190 	}
191 	return dimm_changed;
192 }
193 
194 /* Use to fill the struct spd_block with cache data.*/
spd_fill_from_cache(uint8_t * spd_cache,struct spd_block * blk)195 enum cb_err spd_fill_from_cache(uint8_t *spd_cache, struct spd_block *blk)
196 {
197 	int i;
198 	u8 dram_type;
199 
200 	/* Find the first present SPD */
201 	for (i = 0; i < SC_SPD_NUMS; i++)
202 		if (get_cached_dimm_present(spd_cache, i))
203 			break;
204 
205 	if (i == SC_SPD_NUMS) {
206 		printk(BIOS_ERR, "SPD_CACHE: No DIMM is present.\n");
207 		return CB_ERR;
208 	}
209 
210 	dram_type = *(spd_cache + SC_SPD_OFFSET(i) + SPD_DRAM_TYPE);
211 
212 	if (dram_type == SPD_DRAM_DDR4)
213 		blk->len = SPD_PAGE_LEN_DDR4;
214 	else
215 		blk->len = SPD_PAGE_LEN;
216 
217 	for (i = 0; i < SC_SPD_NUMS; i++)
218 		if (get_cached_dimm_present(spd_cache, i))
219 			blk->spd_array[i] = spd_cache + SC_SPD_OFFSET(i);
220 		else
221 			blk->spd_array[i] = NULL;
222 
223 	return CB_SUCCESS;
224 }
225