/* SPDX-License-Identifier: GPL-2.0-only */

#ifndef _COMMON_MRC_CACHE_H_
#define _COMMON_MRC_CACHE_H_

#include <stddef.h>
#include <stdint.h>
#include <commonlib/region.h>

enum {
	MRC_TRAINING_DATA,
	MRC_VARIABLE_DATA,
};

/*
 * It's up to the caller to decide when to retrieve and stash data. There is
 * differentiation on recovery mode CONFIG(HAS_RECOVERY_MRC_CACHE), but that's
 * only for locating where to retrieve and save the data. If a platform doesn't
 * want to update the data then it shouldn't stash the data for saving.
 * Similarly, if the platform doesn't need the data for booting because of a
 * policy don't request the data.
 */

/* Get and stash data for saving provided the type passed in. */

/**
 * mrc_cache_load_current
 *
 * Fill in the buffer with the latest slot data.  This will be a
 * common entry point for ARM platforms.  Returns < 0 on error, size
 * of the returned data on success.
 */
ssize_t mrc_cache_load_current(int type, uint32_t version, void *buffer,
			       size_t buffer_size);
/**
 * mrc_cache_mmap_leak
 *
 * Return a pointer to a buffer with the latest slot data.  An mmap
 * will be executed (without a matching unmap).  This will be a common
 * entry point for platforms where mmap is considered a noop, like x86
 */
void *mrc_cache_current_mmap_leak(int type, uint32_t version,
				  size_t *data_size);
/**
 * Returns < 0 on error, 0 on success.
 */
int mrc_cache_stash_data(int type, uint32_t version, const void *data,
			 size_t size);

/**
 * API to locate the FSP Non-Volatile Storage Data (aka memory training data)
 * and store into the NVS.
 */
void save_memory_training_data(void);

#endif /* _COMMON_MRC_CACHE_H_ */