sp
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?
User | Revision | Line number | New 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>© 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****/ |