PHung Tung / F746-GUI

sp

Dependents:   WAV

BSP_DISCO_F746NG/stm32746g_discovery_eeprom.c@0:4e245f4bc8ac, 2019-06-07 (annotated)

Committer:
phungductung
Date:
Fri Jun 07 05:06:42 2019 +0000
Revision:
0:4e245f4bc8ac
spkt

Who changed what in which revision?

UserRevisionLine numberNew contents of line
phungductung 0:4e245f4bc8ac 1 /**
phungductung 0:4e245f4bc8ac 2 ******************************************************************************
phungductung 0:4e245f4bc8ac 3 * @file stm32746g_discovery_eeprom.c
phungductung 0:4e245f4bc8ac 4 * @author MCD Application Team
phungductung 0:4e245f4bc8ac 5 * @version V1.0.0
phungductung 0:4e245f4bc8ac 6 * @date 25-June-2015
phungductung 0:4e245f4bc8ac 7 * @brief This file provides a set of functions needed to manage an I2C M24LR64
phungductung 0:4e245f4bc8ac 8 * EEPROM memory.
phungductung 0:4e245f4bc8ac 9 @verbatim
phungductung 0:4e245f4bc8ac 10 To be able to use this driver, the switch EE_M24LR64 must be defined
phungductung 0:4e245f4bc8ac 11 in your toolchain compiler preprocessor
phungductung 0:4e245f4bc8ac 12
phungductung 0:4e245f4bc8ac 13 ===================================================================
phungductung 0:4e245f4bc8ac 14 Notes:
phungductung 0:4e245f4bc8ac 15 - The I2C EEPROM memory (M24LR64) is available on separate daughter
phungductung 0:4e245f4bc8ac 16 board ANT7-M24LR-A, which is not provided with the STM32746G_DISCOVERY
phungductung 0:4e245f4bc8ac 17 board.
phungductung 0:4e245f4bc8ac 18 To use this driver you have to connect the ANT7-M24LR-A to CN3
phungductung 0:4e245f4bc8ac 19 connector of STM32746G_DISCOVERY board.
phungductung 0:4e245f4bc8ac 20 ===================================================================
phungductung 0:4e245f4bc8ac 21
phungductung 0:4e245f4bc8ac 22 It implements a high level communication layer for read and write
phungductung 0:4e245f4bc8ac 23 from/to this memory. The needed STM32F7xx hardware resources (I2C and
phungductung 0:4e245f4bc8ac 24 GPIO) are defined in stm32746g_discovery.h file, and the initialization is
phungductung 0:4e245f4bc8ac 25 performed in EEPROM_IO_Init() function declared in stm32746g_discovery.c
phungductung 0:4e245f4bc8ac 26 file.
phungductung 0:4e245f4bc8ac 27 You can easily tailor this driver to any other development board,
phungductung 0:4e245f4bc8ac 28 by just adapting the defines for hardware resources and
phungductung 0:4e245f4bc8ac 29 EEPROM_IO_Init() function.
phungductung 0:4e245f4bc8ac 30
phungductung 0:4e245f4bc8ac 31 @note In this driver, basic read and write functions (BSP_EEPROM_ReadBuffer()
phungductung 0:4e245f4bc8ac 32 and BSP_EEPROM_WritePage()) use DMA mode to perform the data
phungductung 0:4e245f4bc8ac 33 transfer to/from EEPROM memory.
phungductung 0:4e245f4bc8ac 34
phungductung 0:4e245f4bc8ac 35 @note Regarding BSP_EEPROM_WritePage(), it is an optimized function to perform
phungductung 0:4e245f4bc8ac 36 small write (less than 1 page) BUT the number of bytes (combined to write start address) must not
phungductung 0:4e245f4bc8ac 37 cross the EEPROM page boundary. This function can only writes into
phungductung 0:4e245f4bc8ac 38 the boundaries of an EEPROM page.
phungductung 0:4e245f4bc8ac 39 This function doesn't check on boundaries condition (in this driver
phungductung 0:4e245f4bc8ac 40 the function BSP_EEPROM_WriteBuffer() which calls BSP_EEPROM_WritePage() is
phungductung 0:4e245f4bc8ac 41 responsible of checking on Page boundaries).
phungductung 0:4e245f4bc8ac 42
phungductung 0:4e245f4bc8ac 43
phungductung 0:4e245f4bc8ac 44 +-----------------------------------------------------------------+
phungductung 0:4e245f4bc8ac 45 | Pin assignment for M24LR64 EEPROM |
phungductung 0:4e245f4bc8ac 46 +---------------------------------------+-----------+-------------+
phungductung 0:4e245f4bc8ac 47 | STM32F7xx I2C Pins | EEPROM | Pin |
phungductung 0:4e245f4bc8ac 48 +---------------------------------------+-----------+-------------+
phungductung 0:4e245f4bc8ac 49 | . | E0(GND) | 1 (0V) |
phungductung 0:4e245f4bc8ac 50 | . | AC0 | 2 |
phungductung 0:4e245f4bc8ac 51 | . | AC1 | 3 |
phungductung 0:4e245f4bc8ac 52 | . | VSS | 4 (0V) |
phungductung 0:4e245f4bc8ac 53 | SDA | SDA | 5 |
phungductung 0:4e245f4bc8ac 54 | SCL | SCL | 6 |
phungductung 0:4e245f4bc8ac 55 | . | E1(GND) | 7 (0V) |
phungductung 0:4e245f4bc8ac 56 | . | VDD | 8 (3.3V) |
phungductung 0:4e245f4bc8ac 57 +---------------------------------------+-----------+-------------+
phungductung 0:4e245f4bc8ac 58 @endverbatim
phungductung 0:4e245f4bc8ac 59 ******************************************************************************
phungductung 0:4e245f4bc8ac 60 * @attention
phungductung 0:4e245f4bc8ac 61 *
phungductung 0:4e245f4bc8ac 62 * <h2><center>&copy; COPYRIGHT(c) 2015 STMicroelectronics</center></h2>
phungductung 0:4e245f4bc8ac 63 *
phungductung 0:4e245f4bc8ac 64 * Redistribution and use in source and binary forms, with or without modification,
phungductung 0:4e245f4bc8ac 65 * are permitted provided that the following conditions are met:
phungductung 0:4e245f4bc8ac 66 * 1. Redistributions of source code must retain the above copyright notice,
phungductung 0:4e245f4bc8ac 67 * this list of conditions and the following disclaimer.
phungductung 0:4e245f4bc8ac 68 * 2. Redistributions in binary form must reproduce the above copyright notice,
phungductung 0:4e245f4bc8ac 69 * this list of conditions and the following disclaimer in the documentation
phungductung 0:4e245f4bc8ac 70 * and/or other materials provided with the distribution.
phungductung 0:4e245f4bc8ac 71 * 3. Neither the name of STMicroelectronics nor the names of its contributors
phungductung 0:4e245f4bc8ac 72 * may be used to endorse or promote products derived from this software
phungductung 0:4e245f4bc8ac 73 * without specific prior written permission.
phungductung 0:4e245f4bc8ac 74 *
phungductung 0:4e245f4bc8ac 75 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
phungductung 0:4e245f4bc8ac 76 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
phungductung 0:4e245f4bc8ac 77 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
phungductung 0:4e245f4bc8ac 78 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
phungductung 0:4e245f4bc8ac 79 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
phungductung 0:4e245f4bc8ac 80 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
phungductung 0:4e245f4bc8ac 81 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
phungductung 0:4e245f4bc8ac 82 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
phungductung 0:4e245f4bc8ac 83 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
phungductung 0:4e245f4bc8ac 84 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
phungductung 0:4e245f4bc8ac 85 *
phungductung 0:4e245f4bc8ac 86 ******************************************************************************
phungductung 0:4e245f4bc8ac 87 */
phungductung 0:4e245f4bc8ac 88 /* Includes ------------------------------------------------------------------*/
phungductung 0:4e245f4bc8ac 89 #include "stm32746g_discovery_eeprom.h"
phungductung 0:4e245f4bc8ac 90
phungductung 0:4e245f4bc8ac 91 /** @addtogroup BSP
phungductung 0:4e245f4bc8ac 92 * @{
phungductung 0:4e245f4bc8ac 93 */
phungductung 0:4e245f4bc8ac 94
phungductung 0:4e245f4bc8ac 95 /** @addtogroup STM32746G_DISCOVERY
phungductung 0:4e245f4bc8ac 96 * @{
phungductung 0:4e245f4bc8ac 97 */
phungductung 0:4e245f4bc8ac 98
phungductung 0:4e245f4bc8ac 99 /** @addtogroup STM32746G_DISCOVERY_EEPROM
phungductung 0:4e245f4bc8ac 100 * @brief This file includes the I2C EEPROM driver of STM32746G-Discovery board.
phungductung 0:4e245f4bc8ac 101 * @{
phungductung 0:4e245f4bc8ac 102 */
phungductung 0:4e245f4bc8ac 103
phungductung 0:4e245f4bc8ac 104 /** @defgroup STM32746G_DISCOVERY_EEPROM_Private_Types STM32746G_DISCOVERY_EEPROM Private Types
phungductung 0:4e245f4bc8ac 105 * @{
phungductung 0:4e245f4bc8ac 106 */
phungductung 0:4e245f4bc8ac 107 /**
phungductung 0:4e245f4bc8ac 108 * @}
phungductung 0:4e245f4bc8ac 109 */
phungductung 0:4e245f4bc8ac 110
phungductung 0:4e245f4bc8ac 111 /** @defgroup STM32746G_DISCOVERY_EEPROM_Private_Defines STM32746G_DISCOVERY_EEPROM Private Defines
phungductung 0:4e245f4bc8ac 112 * @{
phungductung 0:4e245f4bc8ac 113 */
phungductung 0:4e245f4bc8ac 114 /**
phungductung 0:4e245f4bc8ac 115 * @}
phungductung 0:4e245f4bc8ac 116 */
phungductung 0:4e245f4bc8ac 117
phungductung 0:4e245f4bc8ac 118 /** @defgroup STM32746G_DISCOVERY_EEPROM_Private_Macros STM32746G_DISCOVERY_EEPROM Private Macros
phungductung 0:4e245f4bc8ac 119 * @{
phungductung 0:4e245f4bc8ac 120 */
phungductung 0:4e245f4bc8ac 121 /**
phungductung 0:4e245f4bc8ac 122 * @}
phungductung 0:4e245f4bc8ac 123 */
phungductung 0:4e245f4bc8ac 124
phungductung 0:4e245f4bc8ac 125 /** @defgroup STM32746G_DISCOVERY_EEPROM_Private_Variables STM32746G_DISCOVERY_EEPROM Private Variables
phungductung 0:4e245f4bc8ac 126 * @{
phungductung 0:4e245f4bc8ac 127 */
phungductung 0:4e245f4bc8ac 128 __IO uint16_t EEPROMAddress = 0;
phungductung 0:4e245f4bc8ac 129 __IO uint16_t EEPROMDataRead;
phungductung 0:4e245f4bc8ac 130 __IO uint8_t EEPROMDataWrite;
phungductung 0:4e245f4bc8ac 131 /**
phungductung 0:4e245f4bc8ac 132 * @}
phungductung 0:4e245f4bc8ac 133 */
phungductung 0:4e245f4bc8ac 134
phungductung 0:4e245f4bc8ac 135 /** @defgroup STM32746G_DISCOVERY_EEPROM_Private_Function_Prototypes STM32746G_DISCOVERY_EEPROM Private Function Prototypes
phungductung 0:4e245f4bc8ac 136 * @{
phungductung 0:4e245f4bc8ac 137 */
phungductung 0:4e245f4bc8ac 138 /**
phungductung 0:4e245f4bc8ac 139 * @}
phungductung 0:4e245f4bc8ac 140 */
phungductung 0:4e245f4bc8ac 141
phungductung 0:4e245f4bc8ac 142 /** @defgroup STM32746G_DISCOVERY_EEPROM_Exported_Functions STM32746G_DISCOVERY_EEPROM Exported Functions
phungductung 0:4e245f4bc8ac 143 * @{
phungductung 0:4e245f4bc8ac 144 */
phungductung 0:4e245f4bc8ac 145
phungductung 0:4e245f4bc8ac 146 /**
phungductung 0:4e245f4bc8ac 147 * @brief Initializes peripherals used by the I2C EEPROM driver.
phungductung 0:4e245f4bc8ac 148 *
phungductung 0:4e245f4bc8ac 149 * @note There are 2 different versions of M24LR64 (A01 & A02).
phungductung 0:4e245f4bc8ac 150 * Then try to connect on 1st one (EEPROM_I2C_ADDRESS_A01)
phungductung 0:4e245f4bc8ac 151 * and if problem, check the 2nd one (EEPROM_I2C_ADDRESS_A02)
phungductung 0:4e245f4bc8ac 152 * @retval EEPROM_OK (0) if operation is correctly performed, else return value
phungductung 0:4e245f4bc8ac 153 * different from EEPROM_OK (0)
phungductung 0:4e245f4bc8ac 154 */
phungductung 0:4e245f4bc8ac 155 uint32_t BSP_EEPROM_Init(void)
phungductung 0:4e245f4bc8ac 156 {
phungductung 0:4e245f4bc8ac 157 /* I2C Initialization */
phungductung 0:4e245f4bc8ac 158 EEPROM_IO_Init();
phungductung 0:4e245f4bc8ac 159
phungductung 0:4e245f4bc8ac 160 /* Select the EEPROM address for A01 and check if OK */
phungductung 0:4e245f4bc8ac 161 EEPROMAddress = EEPROM_I2C_ADDRESS_A01;
phungductung 0:4e245f4bc8ac 162 if(EEPROM_IO_IsDeviceReady(EEPROMAddress, EEPROM_MAX_TRIALS) != HAL_OK)
phungductung 0:4e245f4bc8ac 163 {
phungductung 0:4e245f4bc8ac 164 /* Select the EEPROM address for A02 and check if OK */
phungductung 0:4e245f4bc8ac 165 EEPROMAddress = EEPROM_I2C_ADDRESS_A02;
phungductung 0:4e245f4bc8ac 166 if(EEPROM_IO_IsDeviceReady(EEPROMAddress, EEPROM_MAX_TRIALS) != HAL_OK)
phungductung 0:4e245f4bc8ac 167 {
phungductung 0:4e245f4bc8ac 168 return EEPROM_FAIL;
phungductung 0:4e245f4bc8ac 169 }
phungductung 0:4e245f4bc8ac 170 }
phungductung 0:4e245f4bc8ac 171 return EEPROM_OK;
phungductung 0:4e245f4bc8ac 172 }
phungductung 0:4e245f4bc8ac 173
phungductung 0:4e245f4bc8ac 174 /**
phungductung 0:4e245f4bc8ac 175 * @brief DeInitializes the EEPROM.
phungductung 0:4e245f4bc8ac 176 * @retval EEPROM state
phungductung 0:4e245f4bc8ac 177 */
phungductung 0:4e245f4bc8ac 178 uint8_t BSP_EEPROM_DeInit(void)
phungductung 0:4e245f4bc8ac 179 {
phungductung 0:4e245f4bc8ac 180 /* I2C won't be disabled because common to other functionalities */
phungductung 0:4e245f4bc8ac 181 return EEPROM_OK;
phungductung 0:4e245f4bc8ac 182 }
phungductung 0:4e245f4bc8ac 183
phungductung 0:4e245f4bc8ac 184 /**
phungductung 0:4e245f4bc8ac 185 * @brief Reads a block of data from the EEPROM.
phungductung 0:4e245f4bc8ac 186 * @param pBuffer: pointer to the buffer that receives the data read from
phungductung 0:4e245f4bc8ac 187 * the EEPROM.
phungductung 0:4e245f4bc8ac 188 * @param ReadAddr: EEPROM's internal address to start reading from.
phungductung 0:4e245f4bc8ac 189 * @param NumByteToRead: pointer to the variable holding number of bytes to
phungductung 0:4e245f4bc8ac 190 * be read from the EEPROM.
phungductung 0:4e245f4bc8ac 191 *
phungductung 0:4e245f4bc8ac 192 * @note The variable pointed by NumByteToRead is reset to 0 when all the
phungductung 0:4e245f4bc8ac 193 * data are read from the EEPROM. Application should monitor this
phungductung 0:4e245f4bc8ac 194 * variable in order know when the transfer is complete.
phungductung 0:4e245f4bc8ac 195 *
phungductung 0:4e245f4bc8ac 196 * @retval EEPROM_OK (0) if operation is correctly performed, else return value
phungductung 0:4e245f4bc8ac 197 * different from EEPROM_OK (0) or the timeout user callback.
phungductung 0:4e245f4bc8ac 198 */
phungductung 0:4e245f4bc8ac 199 uint32_t BSP_EEPROM_ReadBuffer(uint8_t* pBuffer, uint16_t ReadAddr, uint16_t* NumByteToRead)
phungductung 0:4e245f4bc8ac 200 {
phungductung 0:4e245f4bc8ac 201 uint32_t buffersize = *NumByteToRead;
phungductung 0:4e245f4bc8ac 202
phungductung 0:4e245f4bc8ac 203 /* Set the pointer to the Number of data to be read. This pointer will be used
phungductung 0:4e245f4bc8ac 204 by the DMA Transfer Completer interrupt Handler in order to reset the
phungductung 0:4e245f4bc8ac 205 variable to 0. User should check on this variable in order to know if the
phungductung 0:4e245f4bc8ac 206 DMA transfer has been complete or not. */
phungductung 0:4e245f4bc8ac 207 EEPROMDataRead = *NumByteToRead;
phungductung 0:4e245f4bc8ac 208
phungductung 0:4e245f4bc8ac 209 if(EEPROM_IO_ReadData(EEPROMAddress, ReadAddr, pBuffer, buffersize) != HAL_OK)
phungductung 0:4e245f4bc8ac 210 {
phungductung 0:4e245f4bc8ac 211 BSP_EEPROM_TIMEOUT_UserCallback();
phungductung 0:4e245f4bc8ac 212 return EEPROM_FAIL;
phungductung 0:4e245f4bc8ac 213 }
phungductung 0:4e245f4bc8ac 214
phungductung 0:4e245f4bc8ac 215 /* If all operations OK, return EEPROM_OK (0) */
phungductung 0:4e245f4bc8ac 216 return EEPROM_OK;
phungductung 0:4e245f4bc8ac 217 }
phungductung 0:4e245f4bc8ac 218
phungductung 0:4e245f4bc8ac 219 /**
phungductung 0:4e245f4bc8ac 220 * @brief Writes more than one byte to the EEPROM with a single WRITE cycle.
phungductung 0:4e245f4bc8ac 221 *
phungductung 0:4e245f4bc8ac 222 * @note The number of bytes (combined to write start address) must not
phungductung 0:4e245f4bc8ac 223 * cross the EEPROM page boundary. This function can only write into
phungductung 0:4e245f4bc8ac 224 * the boundaries of an EEPROM page.
phungductung 0:4e245f4bc8ac 225 * This function doesn't check on boundaries condition (in this driver
phungductung 0:4e245f4bc8ac 226 * the function BSP_EEPROM_WriteBuffer() which calls BSP_EEPROM_WritePage() is
phungductung 0:4e245f4bc8ac 227 * responsible of checking on Page boundaries).
phungductung 0:4e245f4bc8ac 228 *
phungductung 0:4e245f4bc8ac 229 * @param pBuffer: pointer to the buffer containing the data to be written to
phungductung 0:4e245f4bc8ac 230 * the EEPROM.
phungductung 0:4e245f4bc8ac 231 * @param WriteAddr: EEPROM's internal address to write to.
phungductung 0:4e245f4bc8ac 232 * @param NumByteToWrite: pointer to the variable holding number of bytes to
phungductung 0:4e245f4bc8ac 233 * be written into the EEPROM.
phungductung 0:4e245f4bc8ac 234 *
phungductung 0:4e245f4bc8ac 235 * @note The variable pointed by NumByteToWrite is reset to 0 when all the
phungductung 0:4e245f4bc8ac 236 * data are written to the EEPROM. Application should monitor this
phungductung 0:4e245f4bc8ac 237 * variable in order know when the transfer is complete.
phungductung 0:4e245f4bc8ac 238 *
phungductung 0:4e245f4bc8ac 239 * @note This function just configure the communication and enable the DMA
phungductung 0:4e245f4bc8ac 240 * channel to transfer data. Meanwhile, the user application may perform
phungductung 0:4e245f4bc8ac 241 * other tasks in parallel.
phungductung 0:4e245f4bc8ac 242 *
phungductung 0:4e245f4bc8ac 243 * @retval EEPROM_OK (0) if operation is correctly performed, else return value
phungductung 0:4e245f4bc8ac 244 * different from EEPROM_OK (0) or the timeout user callback.
phungductung 0:4e245f4bc8ac 245 */
phungductung 0:4e245f4bc8ac 246 uint32_t BSP_EEPROM_WritePage(uint8_t* pBuffer, uint16_t WriteAddr, uint8_t* NumByteToWrite)
phungductung 0:4e245f4bc8ac 247 {
phungductung 0:4e245f4bc8ac 248 uint32_t buffersize = *NumByteToWrite;
phungductung 0:4e245f4bc8ac 249 uint32_t status = EEPROM_OK;
phungductung 0:4e245f4bc8ac 250
phungductung 0:4e245f4bc8ac 251 /* Set the pointer to the Number of data to be written. This pointer will be used
phungductung 0:4e245f4bc8ac 252 by the DMA Transfer Completer interrupt Handler in order to reset the
phungductung 0:4e245f4bc8ac 253 variable to 0. User should check on this variable in order to know if the
phungductung 0:4e245f4bc8ac 254 DMA transfer has been complete or not. */
phungductung 0:4e245f4bc8ac 255 EEPROMDataWrite = *NumByteToWrite;
phungductung 0:4e245f4bc8ac 256
phungductung 0:4e245f4bc8ac 257 if(EEPROM_IO_WriteData(EEPROMAddress, WriteAddr, pBuffer, buffersize) != HAL_OK)
phungductung 0:4e245f4bc8ac 258 {
phungductung 0:4e245f4bc8ac 259 BSP_EEPROM_TIMEOUT_UserCallback();
phungductung 0:4e245f4bc8ac 260 status = EEPROM_FAIL;
phungductung 0:4e245f4bc8ac 261 }
phungductung 0:4e245f4bc8ac 262
phungductung 0:4e245f4bc8ac 263 if(BSP_EEPROM_WaitEepromStandbyState() != EEPROM_OK)
phungductung 0:4e245f4bc8ac 264 {
phungductung 0:4e245f4bc8ac 265 return EEPROM_FAIL;
phungductung 0:4e245f4bc8ac 266 }
phungductung 0:4e245f4bc8ac 267
phungductung 0:4e245f4bc8ac 268 /* If all operations OK, return EEPROM_OK (0) */
phungductung 0:4e245f4bc8ac 269 return status;
phungductung 0:4e245f4bc8ac 270 }
phungductung 0:4e245f4bc8ac 271
phungductung 0:4e245f4bc8ac 272 /**
phungductung 0:4e245f4bc8ac 273 * @brief Writes buffer of data to the I2C EEPROM.
phungductung 0:4e245f4bc8ac 274 * @param pBuffer: pointer to the buffer containing the data to be written
phungductung 0:4e245f4bc8ac 275 * to the EEPROM.
phungductung 0:4e245f4bc8ac 276 * @param WriteAddr: EEPROM's internal address to write to.
phungductung 0:4e245f4bc8ac 277 * @param NumByteToWrite: number of bytes to write to the EEPROM.
phungductung 0:4e245f4bc8ac 278 * @retval EEPROM_OK (0) if operation is correctly performed, else return value
phungductung 0:4e245f4bc8ac 279 * different from EEPROM_OK (0) or the timeout user callback.
phungductung 0:4e245f4bc8ac 280 */
phungductung 0:4e245f4bc8ac 281 uint32_t BSP_EEPROM_WriteBuffer(uint8_t *pBuffer, uint16_t WriteAddr, uint16_t NumByteToWrite)
phungductung 0:4e245f4bc8ac 282 {
phungductung 0:4e245f4bc8ac 283 uint16_t numofpage = 0, numofsingle = 0, count = 0;
phungductung 0:4e245f4bc8ac 284 uint16_t addr = 0;
phungductung 0:4e245f4bc8ac 285 uint8_t dataindex = 0;
phungductung 0:4e245f4bc8ac 286 uint32_t status = EEPROM_OK;
phungductung 0:4e245f4bc8ac 287
phungductung 0:4e245f4bc8ac 288 addr = WriteAddr % EEPROM_PAGESIZE;
phungductung 0:4e245f4bc8ac 289 count = EEPROM_PAGESIZE - addr;
phungductung 0:4e245f4bc8ac 290 numofpage = NumByteToWrite / EEPROM_PAGESIZE;
phungductung 0:4e245f4bc8ac 291 numofsingle = NumByteToWrite % EEPROM_PAGESIZE;
phungductung 0:4e245f4bc8ac 292
phungductung 0:4e245f4bc8ac 293 /* If WriteAddr is EEPROM_PAGESIZE aligned */
phungductung 0:4e245f4bc8ac 294 if(addr == 0)
phungductung 0:4e245f4bc8ac 295 {
phungductung 0:4e245f4bc8ac 296 /* If NumByteToWrite < EEPROM_PAGESIZE */
phungductung 0:4e245f4bc8ac 297 if(numofpage == 0)
phungductung 0:4e245f4bc8ac 298 {
phungductung 0:4e245f4bc8ac 299 /* Store the number of data to be written */
phungductung 0:4e245f4bc8ac 300 dataindex = numofsingle;
phungductung 0:4e245f4bc8ac 301 /* Start writing data */
phungductung 0:4e245f4bc8ac 302 status = BSP_EEPROM_WritePage(pBuffer, WriteAddr, (uint8_t*)(&dataindex));
phungductung 0:4e245f4bc8ac 303 if(status != EEPROM_OK)
phungductung 0:4e245f4bc8ac 304 {
phungductung 0:4e245f4bc8ac 305 return status;
phungductung 0:4e245f4bc8ac 306 }
phungductung 0:4e245f4bc8ac 307 }
phungductung 0:4e245f4bc8ac 308 /* If NumByteToWrite > EEPROM_PAGESIZE */
phungductung 0:4e245f4bc8ac 309 else
phungductung 0:4e245f4bc8ac 310 {
phungductung 0:4e245f4bc8ac 311 while(numofpage--)
phungductung 0:4e245f4bc8ac 312 {
phungductung 0:4e245f4bc8ac 313 /* Store the number of data to be written */
phungductung 0:4e245f4bc8ac 314 dataindex = EEPROM_PAGESIZE;
phungductung 0:4e245f4bc8ac 315 status = BSP_EEPROM_WritePage(pBuffer, WriteAddr, (uint8_t*)(&dataindex));
phungductung 0:4e245f4bc8ac 316 if(status != EEPROM_OK)
phungductung 0:4e245f4bc8ac 317 {
phungductung 0:4e245f4bc8ac 318 return status;
phungductung 0:4e245f4bc8ac 319 }
phungductung 0:4e245f4bc8ac 320
phungductung 0:4e245f4bc8ac 321 WriteAddr += EEPROM_PAGESIZE;
phungductung 0:4e245f4bc8ac 322 pBuffer += EEPROM_PAGESIZE;
phungductung 0:4e245f4bc8ac 323 }
phungductung 0:4e245f4bc8ac 324
phungductung 0:4e245f4bc8ac 325 if(numofsingle!=0)
phungductung 0:4e245f4bc8ac 326 {
phungductung 0:4e245f4bc8ac 327 /* Store the number of data to be written */
phungductung 0:4e245f4bc8ac 328 dataindex = numofsingle;
phungductung 0:4e245f4bc8ac 329 status = BSP_EEPROM_WritePage(pBuffer, WriteAddr, (uint8_t*)(&dataindex));
phungductung 0:4e245f4bc8ac 330 if(status != EEPROM_OK)
phungductung 0:4e245f4bc8ac 331 {
phungductung 0:4e245f4bc8ac 332 return status;
phungductung 0:4e245f4bc8ac 333 }
phungductung 0:4e245f4bc8ac 334 }
phungductung 0:4e245f4bc8ac 335 }
phungductung 0:4e245f4bc8ac 336 }
phungductung 0:4e245f4bc8ac 337 /* If WriteAddr is not EEPROM_PAGESIZE aligned */
phungductung 0:4e245f4bc8ac 338 else
phungductung 0:4e245f4bc8ac 339 {
phungductung 0:4e245f4bc8ac 340 /* If NumByteToWrite < EEPROM_PAGESIZE */
phungductung 0:4e245f4bc8ac 341 if(numofpage== 0)
phungductung 0:4e245f4bc8ac 342 {
phungductung 0:4e245f4bc8ac 343 /* If the number of data to be written is more than the remaining space
phungductung 0:4e245f4bc8ac 344 in the current page: */
phungductung 0:4e245f4bc8ac 345 if(NumByteToWrite > count)
phungductung 0:4e245f4bc8ac 346 {
phungductung 0:4e245f4bc8ac 347 /* Store the number of data to be written */
phungductung 0:4e245f4bc8ac 348 dataindex = count;
phungductung 0:4e245f4bc8ac 349 /* Write the data contained in same page */
phungductung 0:4e245f4bc8ac 350 status = BSP_EEPROM_WritePage(pBuffer, WriteAddr, (uint8_t*)(&dataindex));
phungductung 0:4e245f4bc8ac 351 if(status != EEPROM_OK)
phungductung 0:4e245f4bc8ac 352 {
phungductung 0:4e245f4bc8ac 353 return status;
phungductung 0:4e245f4bc8ac 354 }
phungductung 0:4e245f4bc8ac 355
phungductung 0:4e245f4bc8ac 356 /* Store the number of data to be written */
phungductung 0:4e245f4bc8ac 357 dataindex = (NumByteToWrite - count);
phungductung 0:4e245f4bc8ac 358 /* Write the remaining data in the following page */
phungductung 0:4e245f4bc8ac 359 status = BSP_EEPROM_WritePage((uint8_t*)(pBuffer + count), (WriteAddr + count), (uint8_t*)(&dataindex));
phungductung 0:4e245f4bc8ac 360 if(status != EEPROM_OK)
phungductung 0:4e245f4bc8ac 361 {
phungductung 0:4e245f4bc8ac 362 return status;
phungductung 0:4e245f4bc8ac 363 }
phungductung 0:4e245f4bc8ac 364 }
phungductung 0:4e245f4bc8ac 365 else
phungductung 0:4e245f4bc8ac 366 {
phungductung 0:4e245f4bc8ac 367 /* Store the number of data to be written */
phungductung 0:4e245f4bc8ac 368 dataindex = numofsingle;
phungductung 0:4e245f4bc8ac 369 status = BSP_EEPROM_WritePage(pBuffer, WriteAddr, (uint8_t*)(&dataindex));
phungductung 0:4e245f4bc8ac 370 if(status != EEPROM_OK)
phungductung 0:4e245f4bc8ac 371 {
phungductung 0:4e245f4bc8ac 372 return status;
phungductung 0:4e245f4bc8ac 373 }
phungductung 0:4e245f4bc8ac 374 }
phungductung 0:4e245f4bc8ac 375 }
phungductung 0:4e245f4bc8ac 376 /* If NumByteToWrite > EEPROM_PAGESIZE */
phungductung 0:4e245f4bc8ac 377 else
phungductung 0:4e245f4bc8ac 378 {
phungductung 0:4e245f4bc8ac 379 NumByteToWrite -= count;
phungductung 0:4e245f4bc8ac 380 numofpage = NumByteToWrite / EEPROM_PAGESIZE;
phungductung 0:4e245f4bc8ac 381 numofsingle = NumByteToWrite % EEPROM_PAGESIZE;
phungductung 0:4e245f4bc8ac 382
phungductung 0:4e245f4bc8ac 383 if(count != 0)
phungductung 0:4e245f4bc8ac 384 {
phungductung 0:4e245f4bc8ac 385 /* Store the number of data to be written */
phungductung 0:4e245f4bc8ac 386 dataindex = count;
phungductung 0:4e245f4bc8ac 387 status = BSP_EEPROM_WritePage(pBuffer, WriteAddr, (uint8_t*)(&dataindex));
phungductung 0:4e245f4bc8ac 388 if(status != EEPROM_OK)
phungductung 0:4e245f4bc8ac 389 {
phungductung 0:4e245f4bc8ac 390 return status;
phungductung 0:4e245f4bc8ac 391 }
phungductung 0:4e245f4bc8ac 392 WriteAddr += count;
phungductung 0:4e245f4bc8ac 393 pBuffer += count;
phungductung 0:4e245f4bc8ac 394 }
phungductung 0:4e245f4bc8ac 395
phungductung 0:4e245f4bc8ac 396 while(numofpage--)
phungductung 0:4e245f4bc8ac 397 {
phungductung 0:4e245f4bc8ac 398 /* Store the number of data to be written */
phungductung 0:4e245f4bc8ac 399 dataindex = EEPROM_PAGESIZE;
phungductung 0:4e245f4bc8ac 400 status = BSP_EEPROM_WritePage(pBuffer, WriteAddr, (uint8_t*)(&dataindex));
phungductung 0:4e245f4bc8ac 401 if(status != EEPROM_OK)
phungductung 0:4e245f4bc8ac 402 {
phungductung 0:4e245f4bc8ac 403 return status;
phungductung 0:4e245f4bc8ac 404 }
phungductung 0:4e245f4bc8ac 405 WriteAddr += EEPROM_PAGESIZE;
phungductung 0:4e245f4bc8ac 406 pBuffer += EEPROM_PAGESIZE;
phungductung 0:4e245f4bc8ac 407 }
phungductung 0:4e245f4bc8ac 408 if(numofsingle != 0)
phungductung 0:4e245f4bc8ac 409 {
phungductung 0:4e245f4bc8ac 410 /* Store the number of data to be written */
phungductung 0:4e245f4bc8ac 411 dataindex = numofsingle;
phungductung 0:4e245f4bc8ac 412 status = BSP_EEPROM_WritePage(pBuffer, WriteAddr, (uint8_t*)(&dataindex));
phungductung 0:4e245f4bc8ac 413 if(status != EEPROM_OK)
phungductung 0:4e245f4bc8ac 414 {
phungductung 0:4e245f4bc8ac 415 return status;
phungductung 0:4e245f4bc8ac 416 }
phungductung 0:4e245f4bc8ac 417 }
phungductung 0:4e245f4bc8ac 418 }
phungductung 0:4e245f4bc8ac 419 }
phungductung 0:4e245f4bc8ac 420
phungductung 0:4e245f4bc8ac 421 /* If all operations OK, return EEPROM_OK (0) */
phungductung 0:4e245f4bc8ac 422 return EEPROM_OK;
phungductung 0:4e245f4bc8ac 423 }
phungductung 0:4e245f4bc8ac 424
phungductung 0:4e245f4bc8ac 425 /**
phungductung 0:4e245f4bc8ac 426 * @brief Wait for EEPROM Standby state.
phungductung 0:4e245f4bc8ac 427 *
phungductung 0:4e245f4bc8ac 428 * @note This function allows to wait and check that EEPROM has finished the
phungductung 0:4e245f4bc8ac 429 * last operation. It is mostly used after Write operation: after receiving
phungductung 0:4e245f4bc8ac 430 * the buffer to be written, the EEPROM may need additional time to actually
phungductung 0:4e245f4bc8ac 431 * perform the write operation. During this time, it doesn't answer to
phungductung 0:4e245f4bc8ac 432 * I2C packets addressed to it. Once the write operation is complete
phungductung 0:4e245f4bc8ac 433 * the EEPROM responds to its address.
phungductung 0:4e245f4bc8ac 434 *
phungductung 0:4e245f4bc8ac 435 * @retval EEPROM_OK (0) if operation is correctly performed, else return value
phungductung 0:4e245f4bc8ac 436 * different from EEPROM_OK (0) or the timeout user callback.
phungductung 0:4e245f4bc8ac 437 */
phungductung 0:4e245f4bc8ac 438 uint32_t BSP_EEPROM_WaitEepromStandbyState(void)
phungductung 0:4e245f4bc8ac 439 {
phungductung 0:4e245f4bc8ac 440 /* Check if the maximum allowed number of trials has bee reached */
phungductung 0:4e245f4bc8ac 441 if(EEPROM_IO_IsDeviceReady(EEPROMAddress, EEPROM_MAX_TRIALS) != HAL_OK)
phungductung 0:4e245f4bc8ac 442 {
phungductung 0:4e245f4bc8ac 443 /* If the maximum number of trials has been reached, exit the function */
phungductung 0:4e245f4bc8ac 444 BSP_EEPROM_TIMEOUT_UserCallback();
phungductung 0:4e245f4bc8ac 445 return EEPROM_TIMEOUT;
phungductung 0:4e245f4bc8ac 446 }
phungductung 0:4e245f4bc8ac 447 return EEPROM_OK;
phungductung 0:4e245f4bc8ac 448 }
phungductung 0:4e245f4bc8ac 449
phungductung 0:4e245f4bc8ac 450 /**
phungductung 0:4e245f4bc8ac 451 * @brief Basic management of the timeout situation.
phungductung 0:4e245f4bc8ac 452 * @retval None
phungductung 0:4e245f4bc8ac 453 */
phungductung 0:4e245f4bc8ac 454 __weak void BSP_EEPROM_TIMEOUT_UserCallback(void)
phungductung 0:4e245f4bc8ac 455 {
phungductung 0:4e245f4bc8ac 456 }
phungductung 0:4e245f4bc8ac 457
phungductung 0:4e245f4bc8ac 458 /**
phungductung 0:4e245f4bc8ac 459 * @}
phungductung 0:4e245f4bc8ac 460 */
phungductung 0:4e245f4bc8ac 461
phungductung 0:4e245f4bc8ac 462 /**
phungductung 0:4e245f4bc8ac 463 * @}
phungductung 0:4e245f4bc8ac 464 */
phungductung 0:4e245f4bc8ac 465
phungductung 0:4e245f4bc8ac 466 /**
phungductung 0:4e245f4bc8ac 467 * @}
phungductung 0:4e245f4bc8ac 468 */
phungductung 0:4e245f4bc8ac 469
phungductung 0:4e245f4bc8ac 470 /**
phungductung 0:4e245f4bc8ac 471 * @}
phungductung 0:4e245f4bc8ac 472 */
phungductung 0:4e245f4bc8ac 473
phungductung 0:4e245f4bc8ac 474 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/