You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
91 lines
4.6 KiB
91 lines
4.6 KiB
/**
|
|
******************************************************************************
|
|
* @file EEPROM_Emul/Core/eeprom_emul.h
|
|
* @author MCD Application Team
|
|
* @brief This file contains all the functions prototypes for the EEPROM
|
|
* emulation firmware library.
|
|
******************************************************************************
|
|
* @attention
|
|
*
|
|
* <h2><center>© Copyright (c) 2020 STMicroelectronics.
|
|
* All rights reserved.</center></h2>
|
|
*
|
|
* This software component is licensed by ST under BSD 3-Clause license,
|
|
* the "License"; You may not use this file except in compliance with the
|
|
* License. You may obtain a copy of the License at:
|
|
* opensource.org/licenses/BSD-3-Clause
|
|
*
|
|
******************************************************************************
|
|
*/
|
|
|
|
/* Define to prevent recursive inclusion -------------------------------------*/
|
|
#ifndef __EEPROM_EMUL_H
|
|
#define __EEPROM_EMUL_H
|
|
|
|
/* Includes ------------------------------------------------------------------*/
|
|
#include <stdint.h>
|
|
#include <stdbool.h>
|
|
|
|
#define __IO volatile
|
|
#define __weak __attribute__((weak))
|
|
|
|
#include "eeprom_emul_conf.h"
|
|
#include "eeprom_emul_types.h"
|
|
#include "flash_interface.h"
|
|
|
|
|
|
/* Page definitions */
|
|
#define PAGE_SIZE FLASH_PAGE_SIZE /*!< Page size */
|
|
#define PAGE_HEADER_SIZE (EE_ELEMENT_SIZE * 4U) /*!< Page Header is 4 elements to save page state */
|
|
#define NB_MAX_ELEMENTS_BY_PAGE ((PAGE_SIZE - PAGE_HEADER_SIZE) / EE_ELEMENT_SIZE) /*!< Max number of elements by page */
|
|
#define PAGES_NUMBER (((((NB_OF_VARIABLES + NB_MAX_ELEMENTS_BY_PAGE) / NB_MAX_ELEMENTS_BY_PAGE) * 2U) * CYCLES_NUMBER) + GUARD_PAGES_NUMBER)
|
|
/*!< Number of consecutives pages used by the application */
|
|
#define NB_MAX_WRITTEN_ELEMENTS ((NB_MAX_ELEMENTS_BY_PAGE * PAGES_NUMBER) / 2U) /*!< Max number of elements written before triggering pages transfer */
|
|
#define START_PAGE PAGE(START_PAGE_ADDRESS) /*!< Page index of the 1st page used for EEPROM emul, in the bank */
|
|
#define END_EEPROM_ADDRESS (START_PAGE_ADDRESS + (PAGES_NUMBER * FLASH_PAGE_SIZE) - 1) /*!< Last address of EEPROM emulation flash pages */
|
|
|
|
/* No page define */
|
|
#define EE_NO_PAGE_FOUND ((uint32_t)0xFFFFFFFFU)
|
|
|
|
/* Macros to manipulate pages */
|
|
#define PAGE_ADDRESS(__PAGE__) (uint32_t)(FLASH_BASE + (__PAGE__) * PAGE_SIZE + ((START_PAGE_ADDRESS - FLASH_BASE) / BANK_SIZE) * BANK_SIZE) /*!< Get page address from page index */
|
|
#define PAGE(__ADDRESS__) (uint32_t)((((__ADDRESS__) - FLASH_BASE) % BANK_SIZE) / FLASH_PAGE_SIZE) /*!< Get page index from page address */
|
|
#define PREVIOUS_PAGE(__PAGE__) (uint32_t)((((__PAGE__) - START_PAGE - 1U + PAGES_NUMBER) % PAGES_NUMBER) + START_PAGE) /*!< Get page index of previous page, among circular page list */
|
|
#define FOLLOWING_PAGE(__PAGE__) (uint32_t)((((__PAGE__) - START_PAGE + 1U) % PAGES_NUMBER) + START_PAGE) /*!< Get page index of following page, among circular page list */
|
|
|
|
/* Macros to manipulate elements */
|
|
#define EE_VIRTUALADDRESS_VALUE(__ELEMENT__) (EE_VIRTUALADDRESS_TYPE)((__ELEMENT__) & EE_MASK_VIRTUALADDRESS) /*!< Get virtual address value from element value */
|
|
#define EE_DATA_VALUE(__ELEMENT__) (EE_DATA_TYPE)(((__ELEMENT__) & EE_MASK_DATA) >> EE_DATA_SHIFT) /*!< Get Data value from element value */
|
|
#define EE_CRC_VALUE(__ELEMENT__) (EE_CRC_TYPE)(((__ELEMENT__) & EE_MASK_CRC) >> EE_CRC_SHIFT) /*!< Get Crc value from element value */
|
|
#define EE_ELEMENT_VALUE(__VIRTADDR__, __DATA__, __CRC__) (((EE_ELEMENT_TYPE)(__DATA__) << EE_DATA_SHIFT) | (__CRC__) << EE_CRC_SHIFT | (__VIRTADDR__)) /*!< Get element value from virtual addr, data and crc values */
|
|
|
|
EE_Status EE_Format(EE_Erase_type EraseType);
|
|
|
|
EE_Status EE_Init(EE_Erase_type EraseType);
|
|
|
|
EE_Status EE_ReadVariable32bits(uint16_t VirtAddress, uint32_t *pData);
|
|
|
|
EE_Status EE_WriteVariable32bits(uint16_t VirtAddress, uint32_t Data);
|
|
|
|
EE_Status EE_ReadVariable16bits(uint16_t VirtAddress, uint16_t *pData);
|
|
|
|
EE_Status EE_WriteVariable16bits(uint16_t VirtAddress, uint16_t Data);
|
|
|
|
EE_Status EE_ReadVariable8bits(uint16_t VirtAddress, uint8_t *pData);
|
|
|
|
EE_Status EE_WriteVariable8bits(uint16_t VirtAddress, uint8_t Data);
|
|
|
|
EE_Status EE_CleanUp(void);
|
|
|
|
EE_Status EE_DeleteCorruptedFlashAddress(uint32_t Address);
|
|
|
|
/**
|
|
* Callback from NMI.
|
|
*
|
|
* @return true if handled by this library
|
|
*/
|
|
bool EE_NMI_Callback();
|
|
|
|
#endif /* __EEPROM_EMUL_H */
|
|
|
|
/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
|
|
|