/** ****************************************************************************** * @file stm320518_eval_i2c_ee.c * @author MCD Application Team * @version V1.0.0 * @date 20-April-2012 * @brief This file provides a set of functions needed to manage an I2C M24LR64 * EEPROM memory. * * =================================================================== * Notes: * - This driver is intended for STM32F0xx families devices only. * - The I2C EEPROM memory (M24LR64) is available on RF EEPROM daughter * board (ANT7-M24LR-A) provided with the EVAL board, to use this * driver you have to connect the ANT7-M24LR-A to CN12 connector. * =================================================================== * * It implements a high level communication layer for read and write * from/to this memory. The needed STM32F0xx hardware resources (I2C and * GPIO) are defined in stm320518_eval.h file, and the initialization is * performed in sEE_LowLevel_Init() function declared in stm320518_eval.c * file. * You can easily tailor this driver to any other development board, * by just adapting the defines for hardware resources and * sEE_LowLevel_Init() function. * * @note In this driver, basic read and write functions (sEE_ReadBuffer() * and sEE_WritePage()) use Polling mode to perform the data transfer * to/from EEPROM memory. * * +-----------------------------------------------------------------+ * | Pin assignment | * +---------------------------------------+-----------+-------------+ * | STM32F0xx I2C Pins | sEE | Pin | * +---------------------------------------+-----------+-------------+ * | . | E0(GND) | 1 (0V) | * | . | AC0 | 2 | * | . | AC1 | 3 | * | . | VSS | 4 (0V) | * | sEE_I2C_SDA_PIN/ SDA | SDA | 5 | * | sEE_I2C_SCL_PIN/ SCL | SCL | 6 | * | . | E1(GND) | 7 (0V) | * | . | VDD | 8 (3.3V) | * +---------------------------------------+-----------+-------------+ ****************************************************************************** * @attention * *

© COPYRIGHT 2012 STMicroelectronics

* * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); * You may not use this file except in compliance with the License. * You may obtain a copy of the License at: * * http://www.st.com/software_license_agreement_liberty_v2 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * ****************************************************************************** */ /* Includes ------------------------------------------------------------------*/ #include "stm320518_eval_i2c_ee.h" /** @addtogroup Utilities * @{ */ /** @addtogroup STM32_EVAL * @{ */ /** @addtogroup STM320518_EVAL * @{ */ /** @addtogroup STM320518_EVAL_I2C_EE * @brief This file includes the I2C EEPROM driver of STM320518-EVAL board. * @{ */ /** @defgroup STM320518_EVAL_I2C_EE_Private_Types * @{ */ /** * @} */ /** @defgroup STM320518_EVAL_I2C_EE_Private_Defines * @{ */ /** * @} */ /** @defgroup STM320518_EVAL_I2C_EE_Private_Macros * @{ */ /** * @} */ /** @defgroup STM320518_EVAL_I2C_EE_Private_Variables * @{ */ __IO uint16_t sEEAddress = 0; __IO uint32_t sEETimeout = sEE_LONG_TIMEOUT; __IO uint16_t sEEDataNum; /** * @} */ /** @defgroup STM320518_EVAL_I2C_EE_Private_Function_Prototypes * @{ */ /** * @} */ /** @defgroup STM320518_EVAL_I2C_EE_Private_Functions * @{ */ /** * @brief DeInitializes peripherals used by the I2C EEPROM driver. * @param None * @retval None */ void sEE_DeInit(void) { sEE_LowLevel_DeInit(); } /** * @brief Initializes peripherals used by the I2C EEPROM driver. * @param None * @retval None */ void sEE_Init(void) { I2C_InitTypeDef I2C_InitStructure; sEE_LowLevel_Init(); /*!< I2C configuration */ /* sEE_I2C configuration */ I2C_InitStructure.I2C_Mode = I2C_Mode_I2C; I2C_InitStructure.I2C_AnalogFilter = I2C_AnalogFilter_Enable; I2C_InitStructure.I2C_DigitalFilter = 0x00; I2C_InitStructure.I2C_OwnAddress1 = 0x00; I2C_InitStructure.I2C_Ack = I2C_Ack_Enable; I2C_InitStructure.I2C_AcknowledgedAddress = I2C_AcknowledgedAddress_7bit; I2C_InitStructure.I2C_Timing = sEE_I2C_TIMING; /* Apply sEE_I2C configuration after enabling it */ I2C_Init(sEE_I2C, &I2C_InitStructure); /* sEE_I2C Peripheral Enable */ I2C_Cmd(sEE_I2C, ENABLE); /*!< Select the EEPROM address */ sEEAddress = sEE_HW_ADDRESS; } /** * @brief Reads a block of data from the EEPROM. * @param pBuffer: pointer to the buffer that receives the data read from * the EEPROM. * @param ReadAddr: EEPROM's internal address to start reading from. * @param NumByteToRead: pointer to the variable holding number of bytes to * be read from the EEPROM. * * @retval sEE_OK (0) if operation is correctly performed, else return value * different from sEE_OK (0) or the timeout user callback. */ uint32_t sEE_ReadBuffer(uint8_t* pBuffer, uint16_t ReadAddr, uint16_t* NumByteToRead) { uint32_t NumbOfSingle = 0, Count = 0, DataNum = 0, StartCom = 0; /* Get number of reload cycles */ Count = (*NumByteToRead) / 255; NumbOfSingle = (*NumByteToRead) % 255; #ifdef sEE_M24C08 /* Configure slave address, nbytes, reload and generate start */ I2C_TransferHandling(sEE_I2C, sEEAddress, 1, I2C_SoftEnd_Mode, I2C_Generate_Start_Write); /* Wait until TXIS flag is set */ sEETimeout = sEE_LONG_TIMEOUT; while(I2C_GetFlagStatus(sEE_I2C, I2C_ISR_TXIS) == RESET) { if((sEETimeout--) == 0) return sEE_TIMEOUT_UserCallback(); } /* Send memory address */ I2C_SendData(sEE_I2C, (uint8_t)ReadAddr); #elif defined(sEE_M24M01) || defined(sEE_M24C64_32) || defined (sEE_M24LR64) /* Configure slave address, nbytes, reload and generate start */ I2C_TransferHandling(sEE_I2C, sEEAddress, 2, I2C_SoftEnd_Mode, I2C_Generate_Start_Write); /* Wait until TXIS flag is set */ sEETimeout = sEE_LONG_TIMEOUT; while(I2C_GetFlagStatus(sEE_I2C, I2C_ISR_TXIS) == RESET) { if((sEETimeout--) == 0) return sEE_TIMEOUT_UserCallback(); } /* Send MSB of memory address */ I2C_SendData(sEE_I2C, (uint8_t)((ReadAddr & 0xFF00) >> 8)); /* Wait until TXIS flag is set */ sEETimeout = sEE_LONG_TIMEOUT; while(I2C_GetFlagStatus(sEE_I2C, I2C_ISR_TXIS) == RESET) { if((sEETimeout--) == 0) return sEE_TIMEOUT_UserCallback(); } /* Send LSB of memory address */ I2C_SendData(sEE_I2C, (uint8_t)(ReadAddr & 0x00FF)); #endif /*!< sEE_M24C08 */ /* Wait until TC flag is set */ sEETimeout = sEE_LONG_TIMEOUT; while(I2C_GetFlagStatus(sEE_I2C, I2C_ISR_TC) == RESET) { if((sEETimeout--) == 0) return sEE_TIMEOUT_UserCallback(); } /* If number of Reload cycles is not equal to 0 */ if (Count != 0) { /* Starting communication */ StartCom = 1; /* Wait until all reload cycles are performed */ while( Count != 0) { /* If a read transfer is performed */ if (StartCom == 0) { /* Wait until TCR flag is set */ sEETimeout = sEE_LONG_TIMEOUT; while(I2C_GetFlagStatus(sEE_I2C, I2C_ISR_TCR) == RESET) { if((sEETimeout--) == 0) return sEE_TIMEOUT_UserCallback(); } } /* if remains one read cycle */ if ((Count == 1) && (NumbOfSingle == 0)) { /* if starting communication */ if (StartCom != 0) { /* Configure slave address, end mode and start condition */ I2C_TransferHandling(sEE_I2C, sEEAddress, 255, I2C_AutoEnd_Mode, I2C_Generate_Start_Read); } else { /* Configure slave address, end mode */ I2C_TransferHandling(sEE_I2C, sEEAddress, 255, I2C_AutoEnd_Mode, I2C_No_StartStop); } } else { /* if starting communication */ if (StartCom != 0) { /* Configure slave address, end mode and start condition */ I2C_TransferHandling(sEE_I2C, sEEAddress, 255, I2C_Reload_Mode, I2C_Generate_Start_Read); } else { /* Configure slave address, end mode */ I2C_TransferHandling(sEE_I2C, sEEAddress, 255, I2C_Reload_Mode, I2C_No_StartStop); } } /* Update local variable */ StartCom = 0; DataNum = 0; /* Wait until all data are received */ while (DataNum != 255) { /* Wait until RXNE flag is set */ sEETimeout = sEE_LONG_TIMEOUT; while(I2C_GetFlagStatus(sEE_I2C, I2C_ISR_RXNE) == RESET) { if((sEETimeout--) == 0) return sEE_TIMEOUT_UserCallback(); } /* Read data from RXDR */ pBuffer[DataNum]= I2C_ReceiveData(sEE_I2C); /* Update number of received data */ DataNum++; (*NumByteToRead)--; } /* Update Pointer of received buffer */ pBuffer += DataNum; /* update number of reload cycle */ Count--; } /* If number of single data is not equal to 0 */ if (NumbOfSingle != 0) { /* Wait until TCR flag is set */ sEETimeout = sEE_LONG_TIMEOUT; while(I2C_GetFlagStatus(sEE_I2C, I2C_ISR_TCR) == RESET) { if((sEETimeout--) == 0) return sEE_TIMEOUT_UserCallback(); } /* Update CR2 : set Nbytes and end mode */ I2C_TransferHandling(sEE_I2C, sEEAddress, (uint8_t)(NumbOfSingle), I2C_AutoEnd_Mode, I2C_No_StartStop); /* Reset local variable */ DataNum = 0; /* Wait until all data are received */ while (DataNum != NumbOfSingle) { /* Wait until RXNE flag is set */ sEETimeout = sEE_LONG_TIMEOUT; while(I2C_GetFlagStatus(sEE_I2C, I2C_ISR_RXNE) == RESET) { if((sEETimeout--) == 0) return sEE_TIMEOUT_UserCallback(); } /* Read data from RXDR */ pBuffer[DataNum]= I2C_ReceiveData(sEE_I2C); /* Update number of received data */ DataNum++; (*NumByteToRead)--; } } } else { /* Update CR2 : set Slave Address , set read request, generate Start and set end mode */ I2C_TransferHandling(sEE_I2C, sEEAddress, (uint32_t)(NumbOfSingle), I2C_AutoEnd_Mode, I2C_Generate_Start_Read); /* Reset local variable */ DataNum = 0; /* Wait until all data are received */ while (DataNum != NumbOfSingle) { /* Wait until RXNE flag is set */ sEETimeout = sEE_LONG_TIMEOUT; while(I2C_GetFlagStatus(sEE_I2C, I2C_ISR_RXNE) == RESET) { if((sEETimeout--) == 0) return sEE_TIMEOUT_UserCallback(); } /* Read data from RXDR */ pBuffer[DataNum]= I2C_ReceiveData(sEE_I2C); /* Update number of received data */ DataNum++; (*NumByteToRead)--; } } /* Wait until STOPF flag is set */ sEETimeout = sEE_LONG_TIMEOUT; while(I2C_GetFlagStatus(sEE_I2C, I2C_ISR_STOPF) == RESET) { if((sEETimeout--) == 0) return sEE_TIMEOUT_UserCallback(); } /* Clear STOPF flag */ I2C_ClearFlag(sEE_I2C, I2C_ICR_STOPCF); /* If all operations OK, return sEE_OK (0) */ return sEE_OK; } /** * @brief Writes more than one byte to the EEPROM with a single WRITE cycle. * * @note The number of bytes (combined to write start address) must not * cross the EEPROM page boundary. This function can only write into * the boundaries of an EEPROM page. * @note This function doesn't check on boundaries condition (in this driver * the function sEE_WriteBuffer() which calls sEE_WritePage() is * responsible of checking on Page boundaries). * * @param pBuffer: pointer to the buffer containing the data to be written to * the EEPROM. * @param WriteAddr: EEPROM's internal address to write to. * @param NumByteToWrite: pointer to the variable holding number of bytes to * be written into the EEPROM. * * @retval sEE_OK (0) if operation is correctly performed, else return value * different from sEE_OK (0) or the timeout user callback. */ uint32_t sEE_WritePage(uint8_t* pBuffer, uint16_t WriteAddr, uint8_t* NumByteToWrite) { uint32_t DataNum = 0; #ifdef sEE_M24C08 /* Configure slave address, nbytes, reload and generate start */ I2C_TransferHandling(sEE_I2C, sEEAddress, 1, I2C_Reload_Mode, I2C_Generate_Start_Write); /* Wait until TXIS flag is set */ sEETimeout = sEE_LONG_TIMEOUT; while(I2C_GetFlagStatus(sEE_I2C, I2C_ISR_TXIS) == RESET) { if((sEETimeout--) == 0) return sEE_TIMEOUT_UserCallback(); } /* Send memory address */ I2C_SendData(sEE_I2C, (uint8_t)WriteAddr); #elif defined(sEE_M24M01) || defined(sEE_M24C64_32) || defined (sEE_M24LR64) /* Configure slave address, nbytes, reload and generate start */ I2C_TransferHandling(sEE_I2C, sEEAddress, 2, I2C_Reload_Mode, I2C_Generate_Start_Write); /* Wait until TXIS flag is set */ sEETimeout = sEE_LONG_TIMEOUT; while(I2C_GetFlagStatus(sEE_I2C, I2C_ISR_TXIS) == RESET) { if((sEETimeout--) == 0) return sEE_TIMEOUT_UserCallback(); } /* Send MSB of memory address */ I2C_SendData(sEE_I2C, (uint8_t)((WriteAddr & 0xFF00) >> 8)); /* Wait until TXIS flag is set */ sEETimeout = sEE_LONG_TIMEOUT; while(I2C_GetFlagStatus(sEE_I2C, I2C_ISR_TXIS) == RESET) { if((sEETimeout--) == 0) return sEE_TIMEOUT_UserCallback(); } /* Send LSB of memory address */ I2C_SendData(sEE_I2C, (uint8_t)(WriteAddr & 0x00FF)); #endif /*!< sEE_M24C08 */ /* Wait until TCR flag is set */ sEETimeout = sEE_LONG_TIMEOUT; while(I2C_GetFlagStatus(sEE_I2C, I2C_ISR_TCR) == RESET) { if((sEETimeout--) == 0) return sEE_TIMEOUT_UserCallback(); } /* Update CR2 : set Slave Address , set write request, generate Start and set end mode */ I2C_TransferHandling(sEE_I2C, sEEAddress, (uint8_t)(*NumByteToWrite), I2C_AutoEnd_Mode, I2C_No_StartStop); while (DataNum != (*NumByteToWrite)) { /* Wait until TXIS flag is set */ sEETimeout = sEE_LONG_TIMEOUT; while(I2C_GetFlagStatus(sEE_I2C, I2C_ISR_TXIS) == RESET) { if((sEETimeout--) == 0) return sEE_TIMEOUT_UserCallback(); } /* Write data to TXDR */ I2C_SendData(sEE_I2C, (uint8_t)(pBuffer[DataNum])); /* Update number of transmitted data */ DataNum++; } /* Wait until STOPF flag is set */ sEETimeout = sEE_LONG_TIMEOUT; while(I2C_GetFlagStatus(sEE_I2C, I2C_ISR_STOPF) == RESET) { if((sEETimeout--) == 0) return sEE_TIMEOUT_UserCallback(); } /* Clear STOPF flag */ I2C_ClearFlag(sEE_I2C, I2C_ICR_STOPCF); /* If all operations OK, return sEE_OK (0) */ return sEE_OK; } /** * @brief Writes buffer of data to the I2C EEPROM. * @param pBuffer: pointer to the buffer containing the data to be written * to the EEPROM. * @param WriteAddr: EEPROM's internal address to write to. * @param NumByteToWrite: number of bytes to write to the EEPROM. * @retval None */ void sEE_WriteBuffer(uint8_t* pBuffer, uint16_t WriteAddr, uint16_t NumByteToWrite) { uint16_t NumOfPage = 0, NumOfSingle = 0, count = 0; uint16_t Addr = 0; Addr = WriteAddr % sEE_PAGESIZE; count = sEE_PAGESIZE - Addr; NumOfPage = NumByteToWrite / sEE_PAGESIZE; NumOfSingle = NumByteToWrite % sEE_PAGESIZE; /*!< If WriteAddr is sEE_PAGESIZE aligned */ if(Addr == 0) { /*!< If NumByteToWrite < sEE_PAGESIZE */ if(NumOfPage == 0) { /* Store the number of data to be written */ sEEDataNum = NumOfSingle; /* Start writing data */ sEE_WritePage(pBuffer, WriteAddr, (uint8_t*)(&sEEDataNum)); sEE_WaitEepromStandbyState(); } /*!< If NumByteToWrite > sEE_PAGESIZE */ else { while(NumOfPage--) { /* Store the number of data to be written */ sEEDataNum = sEE_PAGESIZE; sEE_WritePage(pBuffer, WriteAddr, (uint8_t*)(&sEEDataNum)); sEE_WaitEepromStandbyState(); WriteAddr += sEE_PAGESIZE; pBuffer += sEE_PAGESIZE; } if(NumOfSingle!=0) { /* Store the number of data to be written */ sEEDataNum = NumOfSingle; sEE_WritePage(pBuffer, WriteAddr, (uint8_t*)(&sEEDataNum)); sEE_WaitEepromStandbyState(); } } } /*!< If WriteAddr is not sEE_PAGESIZE aligned */ else { /*!< If NumByteToWrite < sEE_PAGESIZE */ if(NumOfPage== 0) { /*!< If the number of data to be written is more than the remaining space in the current page: */ if (NumByteToWrite > count) { /* Store the number of data to be written */ sEEDataNum = count; /*!< Write the data conained in same page */ sEE_WritePage(pBuffer, WriteAddr, (uint8_t*)(&sEEDataNum)); sEE_WaitEepromStandbyState(); /* Store the number of data to be written */ sEEDataNum = (NumByteToWrite - count); /*!< Write the remaining data in the following page */ sEE_WritePage((uint8_t*)(pBuffer + count), (WriteAddr + count), (uint8_t*)(&sEEDataNum)); sEE_WaitEepromStandbyState(); } else { /* Store the number of data to be written */ sEEDataNum = NumOfSingle; sEE_WritePage(pBuffer, WriteAddr, (uint8_t*)(&sEEDataNum)); sEE_WaitEepromStandbyState(); } } /*!< If NumByteToWrite > sEE_PAGESIZE */ else { NumByteToWrite -= count; NumOfPage = NumByteToWrite / sEE_PAGESIZE; NumOfSingle = NumByteToWrite % sEE_PAGESIZE; if(count != 0) { /* Store the number of data to be written */ sEEDataNum = count; sEE_WritePage(pBuffer, WriteAddr, (uint8_t*)(&sEEDataNum)); sEE_WaitEepromStandbyState(); WriteAddr += count; pBuffer += count; } while(NumOfPage--) { /* Store the number of data to be written */ sEEDataNum = sEE_PAGESIZE; sEE_WritePage(pBuffer, WriteAddr, (uint8_t*)(&sEEDataNum)); sEETimeout = sEE_LONG_TIMEOUT; sEE_WaitEepromStandbyState(); WriteAddr += sEE_PAGESIZE; pBuffer += sEE_PAGESIZE; } if(NumOfSingle != 0) { /* Store the number of data to be written */ sEEDataNum = NumOfSingle; sEE_WritePage(pBuffer, WriteAddr, (uint8_t*)(&sEEDataNum)); sEE_WaitEepromStandbyState(); } } } } /** * @brief Wait for EEPROM Standby state. * * @note This function allows to wait and check that EEPROM has finished the * last operation. It is mostly used after Write operation: after receiving * the buffer to be written, the EEPROM may need additional time to actually * perform the write operation. During this time, it doesn't answer to * I2C packets addressed to it. Once the write operation is complete * the EEPROM responds to its address. * * @param None * * @retval sEE_OK (0) if operation is correctly performed, else return value * different from sEE_OK (0) or the timeout user callback. */ uint32_t sEE_WaitEepromStandbyState(void) { __IO uint32_t sEETrials = 0; /* Keep looping till the slave acknowledge his address or maximum number of trials is reached (this number is defined by sEE_MAX_TRIALS_NUMBER define in stm32373c_eval_i2c_ee.h file) */ /* Configure CR2 register : set Slave Address and end mode */ I2C_TransferHandling(sEE_I2C, sEEAddress, 0, I2C_AutoEnd_Mode, I2C_No_StartStop); do { /* Initialize sEETimeout */ sEETimeout = sEE_FLAG_TIMEOUT; /* Clear NACKF */ I2C_ClearFlag(sEE_I2C, I2C_ICR_NACKCF | I2C_ICR_STOPCF); /* Generate start */ I2C_GenerateSTART(sEE_I2C, ENABLE); /* Wait until timeout elapsed */ while (sEETimeout-- != 0); /* Check if the maximum allowed numbe of trials has bee reached */ if (sEETrials++ == sEE_MAX_TRIALS_NUMBER) { /* If the maximum number of trials has been reached, exit the function */ return sEE_TIMEOUT_UserCallback(); } } while(I2C_GetFlagStatus(sEE_I2C, I2C_ISR_NACKF) != RESET); /* Clear STOPF */ I2C_ClearFlag(sEE_I2C, I2C_ICR_STOPCF); /* Return sEE_OK if device is ready */ return sEE_OK; } #ifdef USE_DEFAULT_TIMEOUT_CALLBACK /** * @brief Basic management of the timeout situation. * @param None. * @retval None. */ uint32_t sEE_TIMEOUT_UserCallback(void) { /* Block communication and all processes */ while (1) { } } #endif /* USE_DEFAULT_TIMEOUT_CALLBACK */ /** * @} */ /** * @} */ /** * @} */ /** * @} */ /** * @} */ /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/