include/asm/mrccache.h

5  * SPDX-License-Identifier:	GPL-2.0+
34  * mrccache_find_current() - find the latest MRC cache record
39  * @entry:	Position and size of MRC cache in SPI flash
45  * mrccache_update() - update the MRC cache with a new record
50  * @sf:		SPI flash to write to
51  * @entry:	Position and size of MRC cache in SPI flash
53  * @return 0 if updated, -EEXIST if the record is the same as the latest
54  * record, -EINVAL if the record is not valid, other error if SPI write failed
60  * mrccache_reserve() - reserve MRC data on the stack
62  * This copies MRC data pointed by gd->arch.mrc_output to a new place on the
63  * stack with length gd->arch.mrc_output_len, and updates gd->arch.mrc_output
66  * This routine should be called by reserve_arch() before U-Boot is relocated
74  * mrccache_get_region() - get MRC region on the SPI flash
77  * as a subnode to the SPI flash. If a non-NULL device pointer is supplied,
78  * this also probes the SPI flash device and returns its device pointer for
81  * Be careful when calling this routine with a non-NULL device pointer:
82  * - driver model initialization must be complete
83  * - calling in the pre-relocation phase may bring some side effects during
84  *   the SPI flash device probe (eg: for SPI controllers on a PCI bus, it
86  *   might be exposed and it causes subsequent SPI flash probe fails).
88  * @devp:	Returns pointer to the SPI flash device
89  * @entry:	Position and size of MRC cache in SPI flash
90  * @return 0 if success, -ENOENT if SPI flash node does not exist in the
91  * device tree, -EPERM if MRC region subnode does not exist in the device
92  * tree, -EINVAL if MRC region properties format is incorrect, other error
93  * if SPI flash probe failed.
98  * mrccache_save() - save MRC data to the SPI flash
100  * This saves MRC data stored previously by gd->arch.mrc_output to a proper
101  * place within the MRC region on the SPI flash.
103  * @return 0 if saved to SPI flash successfully, other error if failed