1 /* SPDX-License-Identifier: GPL-2.0-only */
3 #include <boot_device.h>
4 #include <commonlib/helpers.h>
5 #include <commonlib/region.h>
6 #include <console/console.h>
7 #include <cpu/x86/smm.h>
9 #include <fmap_config.h>
13 #define SMMSTORE_REGION "SMMSTORE"
16 _Static_assert(IS_ALIGNED(FMAP_SECTION_SMMSTORE_START
, SMM_BLOCK_SIZE
),
17 "SMMSTORE FMAP region not aligned to 64K");
19 _Static_assert(SMM_BLOCK_SIZE
<= FMAP_SECTION_SMMSTORE_SIZE
,
20 "SMMSTORE FMAP region must be at least 64K");
23 * The region format is still not finalized, but so far it looks like this:
28 * uint8_t value[value_sz]
32 * uint32le_t endmarker = 0xffffffff
34 * active needs to be set to 0x00 for the entry to be valid. This satisfies
35 * the constraint that entries are either complete or will be ignored, as long
36 * as flash is written sequentially and into a fully erased block.
38 * Future additions to the format will split the region in half with an active
39 * block marker to allow safe compaction (ie. write the new data in the unused
40 * region, mark it active after the write completed). Otherwise a well-timed
41 * crash/reboot could clear out all variables.
44 static enum cb_err
lookup_store_region(struct region
*region
)
46 if (fmap_locate_area(SMMSTORE_REGION
, region
)) {
48 "smm store: Unable to find SMM store FMAP region '%s'\n",
57 * Return a region device that points into the store file.
59 * It's the image builder's responsibility to make it block aligned so that
60 * erase works without destroying other data.
62 * It doesn't cache the location to cope with flash changing underneath (eg
65 * returns 0 on success, -1 on failure
66 * outputs the valid store rdev in rstore
68 static int lookup_store(struct region_device
*rstore
)
70 static struct region_device read_rdev
, write_rdev
;
71 static struct incoherent_rdev store_irdev
;
73 const struct region_device
*rdev
;
75 if (lookup_store_region(®ion
) != CB_SUCCESS
)
78 if (boot_device_ro_subregion(®ion
, &read_rdev
) < 0)
81 if (boot_device_rw_subregion(®ion
, &write_rdev
) < 0)
84 rdev
= incoherent_rdev_init(&store_irdev
, ®ion
, &read_rdev
, &write_rdev
);
89 return rdev_chain(rstore
, rdev
, 0, region_device_sz(rdev
));
92 /* this function is non reentrant */
93 int smmstore_lookup_region(struct region_device
*rstore
)
97 static struct region_device rdev
;
102 if (fmap_locate_area_as_rdev_rw(SMMSTORE_REGION
, &rdev
)) {
104 "smm store: Unable to find SMM store FMAP region '%s'\n",
116 * Read entire store into user provided buffer
118 * returns 0 on success, -1 on failure
119 * writes up to `*bufsize` bytes into `buf` and updates `*bufsize`
121 int smmstore_read_region(void *buf
, ssize_t
*bufsize
)
123 struct region_device store
;
128 if (lookup_store(&store
) < 0) {
129 printk(BIOS_WARNING
, "reading region failed\n");
133 ssize_t tx
= MIN(*bufsize
, region_device_sz(&store
));
134 *bufsize
= rdev_readat(&store
, buf
, 0, tx
);
142 static enum cb_err
scan_end(struct region_device
*store
)
147 const ssize_t data_sz
= region_device_sz(store
);
148 while (end
< data_sz
) {
149 /* make odd corner cases identifiable, eg. invalid v_sz */
152 if (rdev_readat(store
, &k_sz
, end
, sizeof(k_sz
)) < 0) {
153 printk(BIOS_WARNING
, "failed reading key size\n");
158 if (k_sz
== 0xffffffff)
161 /* something is fishy here:
162 * Avoid wrapping (since data_size < MAX_UINT32_T / 2) while
163 * other problems are covered by the loop condition
165 if (k_sz
> data_sz
) {
166 printk(BIOS_WARNING
, "key size out of bounds\n");
170 if (rdev_readat(store
, &v_sz
, end
+ sizeof(k_sz
), sizeof(v_sz
)) < 0) {
171 printk(BIOS_WARNING
, "failed reading value size\n");
175 if (v_sz
> data_sz
) {
176 printk(BIOS_WARNING
, "value size out of bounds\n");
180 end
+= sizeof(k_sz
) + sizeof(v_sz
) + k_sz
+ v_sz
+ 1;
181 end
= ALIGN_UP(end
, sizeof(uint32_t));
184 printk(BIOS_DEBUG
, "used smm store size might be 0x%zx bytes\n", end
);
186 if (k_sz
!= 0xffffffff) {
188 "EOF of data marker looks invalid: 0x%x\n", k_sz
);
192 if (rdev_chain(store
, store
, end
, data_sz
- end
))
198 * Append data to region
200 * Returns 0 on success, -1 on failure
202 int smmstore_append_data(void *key
, uint32_t key_sz
, void *value
,
205 struct region_device store
;
207 if (lookup_store(&store
) < 0) {
208 printk(BIOS_WARNING
, "reading region failed\n");
215 if (scan_end(&store
) != CB_SUCCESS
)
218 printk(BIOS_DEBUG
, "used size looks legit\n");
220 printk(BIOS_DEBUG
, "open (%zx, %zx) for writing\n",
221 region_device_offset(&store
), region_device_sz(&store
));
223 size
= sizeof(key_sz
) + sizeof(value_sz
) + key_sz
+ value_sz
225 if (rdev_chain(&store
, &store
, 0, size
)) {
226 printk(BIOS_WARNING
, "not enough space for new data\n");
230 if (rdev_writeat(&store
, &key_sz
, offset
, sizeof(key_sz
))
232 printk(BIOS_WARNING
, "failed writing key size\n");
235 offset
+= sizeof(key_sz
);
236 if (rdev_writeat(&store
, &value_sz
, offset
, sizeof(value_sz
))
237 != sizeof(value_sz
)) {
238 printk(BIOS_WARNING
, "failed writing value size\n");
241 offset
+= sizeof(value_sz
);
242 if (rdev_writeat(&store
, key
, offset
, key_sz
) != key_sz
) {
243 printk(BIOS_WARNING
, "failed writing key data\n");
247 if (rdev_writeat(&store
, value
, offset
, value_sz
) != value_sz
) {
248 printk(BIOS_WARNING
, "failed writing value data\n");
252 if (rdev_writeat(&store
, &nul
, offset
, sizeof(nul
)) != sizeof(nul
)) {
253 printk(BIOS_WARNING
, "failed writing termination\n");
263 * Returns 0 on success, -1 on failure, including partial erase
265 int smmstore_clear_region(void)
267 struct region_device store
;
269 if (lookup_store(&store
) < 0) {
270 printk(BIOS_WARNING
, "smm store: reading region failed\n");
274 ssize_t res
= rdev_eraseat(&store
, 0, region_device_sz(&store
));
275 if (res
!= region_device_sz(&store
)) {
276 printk(BIOS_WARNING
, "smm store: erasing region failed\n");
284 /* Implementation of Version 2 */
286 static struct region_device mdev_com_buf
;
288 static int smmstore_rdev_chain(struct region_device
*rdev
)
290 return rdev_chain_full(rdev
, &mdev_com_buf
);
294 * Call once before using the store. In SMM this must be called through an
295 * APM SMI handler providing the communication buffer address and length.
297 int smmstore_init(void *buf
, size_t len
)
299 if (!buf
|| len
< SMM_BLOCK_SIZE
)
302 if (smm_points_to_smram(buf
, len
))
305 rdev_chain_mem_rw(&mdev_com_buf
, buf
, len
);
312 * Provide metadata for the coreboot tables.
313 * Must only be called in ramstage, but not in SMM.
315 int smmstore_get_info(struct smmstore_params_info
*out
)
317 struct region_device store
;
319 if (lookup_store(&store
) < 0) {
320 printk(BIOS_ERR
, "smm store: lookup of store failed\n");
324 if (!IS_ALIGNED(region_device_offset(&store
), SMM_BLOCK_SIZE
)) {
325 printk(BIOS_ERR
, "smm store: store not aligned to block size\n");
329 out
->block_size
= SMM_BLOCK_SIZE
;
330 out
->num_blocks
= region_device_sz(&store
) / SMM_BLOCK_SIZE
;
332 /* FIXME: Broken edk2 always assumes memory mapped Firmware Block Volumes */
333 out
->mmap_addr
= (uintptr_t)rdev_mmap_full(&store
);
335 printk(BIOS_DEBUG
, "smm store: %d # blocks with size 0x%x\n",
336 out
->num_blocks
, out
->block_size
);
342 /* Returns -1 on error, 0 on success */
343 static int lookup_block_in_store(struct region_device
*store
, uint32_t block_id
)
345 if (lookup_store(store
) < 0) {
346 printk(BIOS_ERR
, "smm store: lookup of store failed\n");
350 if ((block_id
* SMM_BLOCK_SIZE
) >= region_device_sz(store
)) {
351 printk(BIOS_ERR
, "smm store: block ID out of range\n");
358 /* Returns NULL on error, pointer from rdev_mmap on success */
359 static void *mmap_com_buf(struct region_device
*com_buf
, uint32_t offset
, uint32_t bufsize
)
361 if (smmstore_rdev_chain(com_buf
) < 0) {
362 printk(BIOS_ERR
, "smm store: lookup of com buffer failed\n");
366 if (offset
>= region_device_sz(com_buf
)) {
367 printk(BIOS_ERR
, "smm store: offset out of range\n");
371 void *ptr
= rdev_mmap(com_buf
, offset
, bufsize
);
373 printk(BIOS_ERR
, "smm store: not enough space for new data\n");
379 * Reads the specified block of the SMMSTORE and places it in the communication
381 * @param block_id The id of the block to operate on
382 * @param offset Offset within the block.
383 * Must be smaller than the block size.
384 * @param bufsize Size of chunk to read within the block.
385 * Must be smaller than the block size.
387 * @return Returns -1 on error, 0 on success.
389 int smmstore_rawread_region(uint32_t block_id
, uint32_t offset
, uint32_t bufsize
)
391 struct region_device store
;
392 struct region_device com_buf
;
394 if (lookup_block_in_store(&store
, block_id
) < 0)
397 void *ptr
= mmap_com_buf(&com_buf
, offset
, bufsize
);
401 printk(BIOS_DEBUG
, "smm store: reading %p block %d, offset=0x%x, size=%x\n",
402 ptr
, block_id
, offset
, bufsize
);
404 ssize_t ret
= rdev_readat(&store
, ptr
, block_id
* SMM_BLOCK_SIZE
+ offset
, bufsize
);
405 rdev_munmap(&com_buf
, ptr
);
413 * Writes the specified block of the SMMSTORE by reading it from the communication
415 * @param block_id The id of the block to operate on
416 * @param offset Offset within the block.
417 * Must be smaller than the block size.
418 * @param bufsize Size of chunk to read within the block.
419 * Must be smaller than the block size.
421 * @return Returns -1 on error, 0 on success.
423 int smmstore_rawwrite_region(uint32_t block_id
, uint32_t offset
, uint32_t bufsize
)
425 struct region_device store
;
426 struct region_device com_buf
;
428 if (lookup_block_in_store(&store
, block_id
) < 0)
431 if (rdev_chain(&store
, &store
, block_id
* SMM_BLOCK_SIZE
+ offset
, bufsize
)) {
432 printk(BIOS_ERR
, "smm store: not enough space for new data\n");
436 void *ptr
= mmap_com_buf(&com_buf
, offset
, bufsize
);
440 printk(BIOS_DEBUG
, "smm store: writing %p block %d, offset=0x%x, size=%x\n",
441 ptr
, block_id
, offset
, bufsize
);
443 ssize_t ret
= rdev_writeat(&store
, ptr
, 0, bufsize
);
444 rdev_munmap(&com_buf
, ptr
);
452 * Erases the specified block of the SMMSTORE. The communication buffer remains untouched.
454 * @param block_id The id of the block to operate on
456 * @return Returns -1 on error, 0 on success.
458 int smmstore_rawclear_region(uint32_t block_id
)
460 struct region_device store
;
462 if (lookup_block_in_store(&store
, block_id
) < 0)
465 ssize_t ret
= rdev_eraseat(&store
, block_id
* SMM_BLOCK_SIZE
, SMM_BLOCK_SIZE
);
466 if (ret
!= SMM_BLOCK_SIZE
) {
467 printk(BIOS_ERR
, "smm store: erasing block failed\n");