libs/rt-thread-official
libs
/
rt-thread-official
mirror of https://github.com/RT-Thread/rt-thread.git
4
0
Fork 0
Code Issues Releases Wiki Activity
rt-thread-official/bsp/acm32f0x0-nucleo/libraries/HAL_Driver/Src/HAL_I2C.c

1140 lines
40 KiB
C
Raw Normal View History

警告消除及代码格式化 修改文件头信息 修改ACM32F030 BSP的文件格式 新增BSP驱动中的lib文件 IAR和GCC支持备份 1. 修复不能包含HAL_EFLASH.h问题， 2. 消除GCC编译的几个警告 1. gcc启动文件重命名；2. 文件头信息修改; 3. 硬件timer支持修改 移动 .ignore_format.yml到bsp的目录下 修改目录成相对目录
2021-08-23 10:13:53 +08:00
/*
******************************************************************************
* @file HAL_I2C.c
* @version V1.0.0
* @date 2020
* @brief I2C HAL module driver.
* This file provides firmware functions to manage the following
* functionalities of the Inter Integrated Circuit (I2C) peripheral:
* @ Initialization and de-initialization functions
* @ IO operation functions
* @ Peripheral Control functions
******************************************************************************
*/
#include "ACM32Fxx_HAL.h"
/* Private functions for I2C */
static HAL_StatusTypeDef I2C_Set_Clock_Speed(I2C_HandleTypeDef *hi2c, uint32_t ClockSpeed);
static HAL_StatusTypeDef I2C_Master_Request_Write(I2C_HandleTypeDef *hi2c, uint8_t DevAddress, uint32_t Timeout);
static HAL_StatusTypeDef I2C_Master_Request_Read(I2C_HandleTypeDef *hi2c, uint8_t DevAddress, uint32_t Timeout);
static HAL_StatusTypeDef I2C_Check_Device_Ready(I2C_HandleTypeDef *hi2c, uint8_t DevAddress, uint32_t Timeout);
static HAL_StatusTypeDef I2C_WaitOnFlagUntilTimeout(I2C_HandleTypeDef *hi2c, uint32_t Flag, FlagStatus Status, uint32_t Timeout);
/************************************************************************
* function : HAL_I2C_IRQHandler
* Description: This function handles I2C interrupt request.
* input : hi2c : pointer to a I2C_HandleTypeDef structure that contains
* the configuration information for I2C module
************************************************************************/
__weak void HAL_I2C_IRQHandler(I2C_HandleTypeDef *hi2c)
{
uint32_t i;
/* Slave ADDR1 Interrupt */
if (READ_BIT(hi2c->Instance->SR, I2C_SR_RX_ADDR1))
{
/* Clear ADDR1 Interrupt Flag */
hi2c->Instance->SR = READ_BIT(hi2c->Instance->SR, I2C_SR_RX_ADDR1);
/* Slave Transmit */
if (READ_BIT(hi2c->Instance->SR, I2C_SR_SRW))
{
i = 1;
/* Wait for transmission End*/
while(!READ_BIT(hi2c->Instance->SR, I2C_SR_MTF));
/* Clear MTF */
hi2c->Instance->SR = READ_BIT(hi2c->Instance->SR, I2C_SR_MTF);
/* BUS BUSY */
while(READ_BIT(hi2c->Instance->SR, I2C_SR_BUS_BUSY))
{
if (i >= hi2c->Tx_Size && hi2c->Tx_Size != 0)
{
break;
}
if (READ_BIT(hi2c->Instance->SR, I2C_SR_MTF))
{
/* Clear MTF */
hi2c->Instance->SR = READ_BIT(hi2c->Instance->SR, I2C_SR_MTF);
}
if (READ_BIT(hi2c->Instance->SR, I2C_SR_TXE))
{
hi2c->Instance->DR = hi2c->Tx_Buffer[i++];
hi2c->Tx_Count++;
}
}
/* Set Slave machine is DILE */
hi2c->Slave_TxState = SLAVE_TX_STATE_IDLE;
}
/* Slave Receive */
else
{
i = 0;
/* Wait for transmission End*/
while(!READ_BIT(hi2c->Instance->SR, I2C_SR_MTF));
/* Clear MTF */
hi2c->Instance->SR = READ_BIT(hi2c->Instance->SR, I2C_SR_MTF);
/* BUS BUSY */
while(READ_BIT(hi2c->Instance->SR, I2C_SR_BUS_BUSY))
{
/* Receive Data */
if (READ_BIT(hi2c->Instance->SR, I2C_SR_RXNE))
{
hi2c->Rx_Buffer[i++] = hi2c->Instance->DR;
/* Wait for transmission End*/
while(!READ_BIT(hi2c->Instance->SR, I2C_SR_MTF));
/* Clear MTF */
hi2c->Instance->SR = READ_BIT(hi2c->Instance->SR, I2C_SR_MTF);
hi2c->Rx_Count++;
if (hi2c->Rx_Size != 0)
{
if (i >= hi2c->Rx_Size)
{
break;
}
}
}
}
/* Set Slave machine is DILE */
hi2c->Slave_RxState = SLAVE_RX_STATE_IDLE;
}
if (hi2c->Slave_RxState == SLAVE_RX_STATE_IDLE && hi2c->Slave_TxState == SLAVE_TX_STATE_IDLE)
{
/* Disable RX_ADDR1_INT_EN */
CLEAR_BIT(hi2c->Instance->CR, I2C_CR_RX_ADDR1_INT_EN);
}
}
/* STOP Flag Interrupt */
if (READ_BIT(hi2c->Instance->SR, I2C_SR_STOPF))
{
/* Clear STOPF Interrupt Flag */
hi2c->Instance->SR = READ_BIT(hi2c->Instance->SR, I2C_SR_STOPF);
/* Clear STOPF */
CLEAR_BIT(hi2c->Instance->CR, I2C_CR_STOPF_INTEN);
if (hi2c->I2C_STOPF_Callback != NULL)
{
hi2c->I2C_STOPF_Callback();
}
}
}
/************************************************************************
* function : HAL_I2C_MspInit
* Description:
* input : hi2c : pointer to a I2C_HandleTypeDef structure that contains
* the configuration information for I2C module
************************************************************************/
__weak void HAL_I2C_MspInit(I2C_HandleTypeDef *hi2c)
{
/*
NOTE : This function should be modified by the user.
*/
/* For Example */
GPIO_InitTypeDef GPIO_Handle;
/* I2C1 */
if (hi2c->Instance == I2C1)
{
/* Enable Clock */
System_Module_Enable(EN_I2C1);
System_Module_Enable(EN_GPIOAB);
/* I2C1 SDA PortB Pin7 */
/* I2C1 SCL PortB Pin6 */
GPIO_Handle.Pin = GPIO_PIN_6 | GPIO_PIN_7;
GPIO_Handle.Mode = GPIO_MODE_AF_PP;
GPIO_Handle.Pull = GPIO_PULLUP;
GPIO_Handle.Alternate = GPIO_FUNCTION_6;
HAL_GPIO_Init(GPIOB, &GPIO_Handle);
/* Clear Pending Interrupt */
NVIC_ClearPendingIRQ(I2C1_IRQn);
/* Enable External Interrupt */
NVIC_EnableIRQ(I2C1_IRQn);
}
/* I2C2 */
else if (hi2c->Instance == I2C2)
{
}
}
/************************************************************************
* function : HAL_I2C_MspDeInit
* Description:
* input : hi2c : pointer to a I2C_HandleTypeDef structure that contains
* the configuration information for I2C module
************************************************************************/
__weak void HAL_I2C_MspDeInit(I2C_HandleTypeDef *hi2c)
{
/*
NOTE : This function should be modified by the user.
*/
/* For Example */
/* I2C1 */
if (hi2c->Instance == I2C1)
{
/* Disable Clock */
System_Module_Disable(EN_I2C1);
/* I2C1 SDA PortB Pin7 */
/* I2C1 SCL PortB Pin6 */
HAL_GPIO_DeInit(GPIOB, GPIO_PIN_6 | GPIO_PIN_7);
/* Clear Pending Interrupt */
NVIC_ClearPendingIRQ(I2C1_IRQn);
/* Disable External Interrupt */
NVIC_DisableIRQ(I2C1_IRQn);
}
/* I2C2 */
else if (hi2c->Instance == I2C2)
{
}
}
/************************************************************************
* function : HAL_I2C_Init
* Description: I2c initial with parameters.
* input : hi2c : pointer to a I2C_HandleTypeDef structure that contains
* the configuration information for I2C module
************************************************************************/
HAL_StatusTypeDef HAL_I2C_Init(I2C_HandleTypeDef *hi2c)
{
/* Check I2C Parameter */
if (!IS_I2C_ALL_INSTANCE(hi2c->Instance)) return HAL_ERROR;
if (!IS_I2C_ALL_MODE(hi2c->Init.I2C_Mode)) return HAL_ERROR;
if (!IS_I2C_CLOCK_SPEED(hi2c->Init.Clock_Speed)) return HAL_ERROR;
if (!IS_I2C_TX_AUTO_EN(hi2c->Init.Tx_Auto_En)) return HAL_ERROR;
if (!IS_I2C_STRETCH_EN(hi2c->Init.No_Stretch_Mode)) return HAL_ERROR;
/* Disable the selected I2C peripheral */
CLEAR_BIT(hi2c->Instance->CR, I2C_CR_MEN);
/* Init the low level hardware : GPIO, CLOCK, NVIC */
HAL_I2C_MspInit(hi2c);
switch (hi2c->Init.I2C_Mode)
{
/* Master Mode */
case I2C_MODE_MASTER:
{
/* Set Master Mode */
SET_BIT(hi2c->Instance->CR, I2C_CR_MASTER);
/* Set Clock Speed */
I2C_Set_Clock_Speed(hi2c, hi2c->Init.Clock_Speed);
/* Set SDA auto change the direction */
if (hi2c->Init.Tx_Auto_En == TX_AUTO_EN_ENABLE)
SET_BIT(hi2c->Instance->CR, I2C_CR_TX_AUTO_EN);
else
CLEAR_BIT(hi2c->Instance->CR, I2C_CR_TX_AUTO_EN);
/* Enable the selected I2C peripheral */
SET_BIT(hi2c->Instance->CR, I2C_CR_MEN);
}break;
/* Slave Mode */
case I2C_MODE_SLAVE:
{
SET_BIT(hi2c->Instance->CR, I2C_CR_TXE_SEL);
/* Set SDA auto change the direction */
if (hi2c->Init.Tx_Auto_En == TX_AUTO_EN_ENABLE)
SET_BIT(hi2c->Instance->CR, I2C_CR_TX_AUTO_EN);
else
CLEAR_BIT(hi2c->Instance->CR, I2C_CR_TX_AUTO_EN);
/* Set Clock Stretch Mode */
if (hi2c->Init.No_Stretch_Mode == NO_STRETCH_MODE_NOSTRETCH)
SET_BIT(hi2c->Instance->CR, I2C_CR_NOSTRETCH);
else
CLEAR_BIT(hi2c->Instance->CR, I2C_CR_NOSTRETCH);
/* Set Address 1 */
hi2c->Instance->SLAVE_ADDR1 = hi2c->Init.Own_Address;
/* Enable the selected I2C peripheral */
SET_BIT(hi2c->Instance->CR, I2C_CR_MEN);
}break;
default: break;
}
return HAL_OK;
}
/************************************************************************
* function : HAL_I2C_DeInit
* Description: I2c De-initial with parameters.
* input : hi2c : pointer to a I2C_HandleTypeDef structure that contains
* the configuration information for I2C module
************************************************************************/
HAL_StatusTypeDef HAL_I2C_DeInit(I2C_HandleTypeDef *hi2c)
{
/* Check I2C Parameter */
if (!IS_I2C_ALL_INSTANCE(hi2c->Instance)) return HAL_ERROR;
hi2c->Slave_RxState = SLAVE_RX_STATE_IDLE;
hi2c->Slave_TxState = SLAVE_TX_STATE_IDLE;
HAL_I2C_MspDeInit(hi2c);
hi2c->Tx_Size = 0;
hi2c->Rx_Size = 0;
hi2c->Tx_Count = 0;
hi2c->Rx_Count = 0;
return HAL_OK;
}
/************************************************************************
* function : HAL_I2C_Master_Transmit
* Description: Transmits in master mode an amount of data in blocking mode.
* input : hi2c : pointer to a I2C_HandleTypeDef structure that contains
* the configuration information for I2C module
* DevAddress : Target device address
* pData : Pointer to data buffer
* Size : Amount of data to be sent
* Timeout : Timeout value
************************************************************************/
HAL_StatusTypeDef HAL_I2C_Master_Transmit(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size, uint32_t Timeout)
{
uint32_t i;
/* Check I2C Parameter */
if (!IS_I2C_ALL_INSTANCE(hi2c->Instance)) return HAL_ERROR;
hi2c->Tx_Buffer = pData;
hi2c->Tx_Size = Size;
hi2c->Tx_Count = 0;
/* Send Write Access Request */
if (I2C_Master_Request_Write(hi2c, DevAddress, 0) == HAL_OK)
{
for (i = 0; i < hi2c->Tx_Size; i++)
{
/* Wait TXE Flag */
if(I2C_WaitOnFlagUntilTimeout(hi2c, I2C_SR_TXE, RESET, Timeout) != HAL_OK) return HAL_ERROR;
/* Send Data */
hi2c->Instance->DR = hi2c->Tx_Buffer[hi2c->Tx_Count++];
/* Wait for transmission End*/
if(I2C_WaitOnFlagUntilTimeout(hi2c, I2C_SR_MTF, RESET, Timeout) != HAL_OK) return HAL_ERROR;
/* Clear MTF */
hi2c->Instance->SR = READ_BIT(hi2c->Instance->SR, I2C_SR_MTF);
/* Get NACK */
if (READ_BIT(hi2c->Instance->SR, I2C_SR_RACK))
{
/* Generate Stop */
SET_BIT(hi2c->Instance->CR, I2C_CR_STOP);
/* Wait for the bus to idle */
if(I2C_WaitOnFlagUntilTimeout(hi2c, I2C_SR_BUS_BUSY, SET, Timeout) != HAL_OK) return HAL_ERROR;
return HAL_ERROR;
}
}
/* Generate Stop */
SET_BIT(hi2c->Instance->CR, I2C_CR_STOP);
/* Wait for the bus to idle */
if(I2C_WaitOnFlagUntilTimeout(hi2c, I2C_SR_BUS_BUSY, SET, Timeout) != HAL_OK) return HAL_ERROR;
}
else
{
return HAL_ERROR;
}
return HAL_OK;
}
/************************************************************************
* function : HAL_I2C_Master_Receive
* Description: Transmits in master mode an amount of data in blocking mode.
* input : hi2c : pointer to a I2C_HandleTypeDef structure that contains
* the configuration information for I2C module
* DevAddress : Target device address
* pData : Pointer to data buffer
* Size : Amount of data to be Receive
* Timeout : Timeout value
************************************************************************/
HAL_StatusTypeDef HAL_I2C_Master_Receive(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size, uint32_t Timeout)
{
uint32_t i;
/* Check I2C Parameter */
if (!IS_I2C_ALL_INSTANCE(hi2c->Instance)) return HAL_ERROR;
hi2c->Rx_Buffer = pData;
hi2c->Rx_Size = Size;
hi2c->Rx_Count = 0;
/* Send Read Access Request */
if (I2C_Master_Request_Read(hi2c, DevAddress, Timeout) == HAL_OK)
{
/* Wait Master Transition receiving state */
if(I2C_WaitOnFlagUntilTimeout(hi2c, I2C_SR_TX_RX_FLAG, RESET, Timeout) != HAL_OK) return HAL_ERROR;
/* Clear TX_RX_FLAG */
hi2c->Instance->SR = READ_BIT(hi2c->Instance->SR, I2C_SR_TX_RX_FLAG);
/* Generate ACK */
CLEAR_BIT(hi2c->Instance->CR, I2C_CR_TACK);
for (i = 0; i < hi2c->Rx_Size - 1; i++)
{
/* Wait RXNE Flag */
if(I2C_WaitOnFlagUntilTimeout(hi2c, I2C_SR_RXNE, RESET, Timeout) != HAL_OK) return HAL_ERROR;
/* Read Data */
hi2c->Rx_Buffer[hi2c->Rx_Count++] = hi2c->Instance->DR;
/* Wait for transmission End*/
if(I2C_WaitOnFlagUntilTimeout(hi2c, I2C_SR_MTF, RESET, Timeout) != HAL_OK) return HAL_ERROR;
/* Clear MTF */
hi2c->Instance->SR = READ_BIT(hi2c->Instance->SR, I2C_SR_MTF);
}
/* Prepare for Generate NACK */
SET_BIT(hi2c->Instance->CR, I2C_CR_TACK);
/* Prepare for Generate STOP */
SET_BIT(hi2c->Instance->CR, I2C_CR_STOP);
/* Wait RXNE Flag */
if(I2C_WaitOnFlagUntilTimeout(hi2c, I2C_SR_RXNE, RESET, Timeout) != HAL_OK) return HAL_ERROR;
/* Read Data */
hi2c->Rx_Buffer[hi2c->Rx_Count++] = hi2c->Instance->DR;
/* Wait for transmission End*/
if(I2C_WaitOnFlagUntilTimeout(hi2c, I2C_SR_MTF, RESET, Timeout) != HAL_OK) return HAL_ERROR;
/* Clear MTF */
hi2c->Instance->SR = READ_BIT(hi2c->Instance->SR, I2C_SR_MTF);
/* Wait for the bus to idle */
if(I2C_WaitOnFlagUntilTimeout(hi2c, I2C_SR_BUS_BUSY, SET, Timeout) != HAL_OK) return HAL_ERROR;
/* Generate ACK */
CLEAR_BIT(hi2c->Instance->CR, I2C_CR_TACK);
}
else
{
return HAL_ERROR;
}
return HAL_OK;
}
/************************************************************************
* function : HAL_I2C_Slave_Transmit
* Description: Transmits in Slave mode an amount of data in blocking mode.
* input : hi2c : pointer to a I2C_HandleTypeDef structure that contains
* the configuration information for I2C module
* pData : Pointer to data buffer
* Size : Amount of data to be sent
* Timeout : Timeout value
************************************************************************/
HAL_StatusTypeDef HAL_I2C_Slave_Transmit(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint32_t Size, uint32_t Timeout)
{
uint32_t i = 0;
/* Check I2C Parameter */
if (!IS_I2C_ALL_INSTANCE(hi2c->Instance)) return HAL_ERROR;
hi2c->Tx_Buffer = pData;
hi2c->Tx_Size = Size;
hi2c->Tx_Count = 0;
/* Clear RX_ADDR1 Flag */
hi2c->Instance->SR = READ_BIT(hi2c->Instance->SR, I2C_SR_RX_ADDR1);
/* Match the Address 1 */
if(I2C_WaitOnFlagUntilTimeout(hi2c, I2C_SR_RX_ADDR1, RESET, Timeout) != HAL_OK) return HAL_ERROR;
/* Clear RX_ADDR1 Flag */
hi2c->Instance->SR = READ_BIT(hi2c->Instance->SR, I2C_SR_RX_ADDR1);
/* Slave Transmit */
if (READ_BIT(hi2c->Instance->SR, I2C_SR_SRW))
{
/* BUS BUSY */
while(READ_BIT(hi2c->Instance->SR, I2C_SR_BUS_BUSY))
{
if (READ_BIT(hi2c->Instance->SR, I2C_SR_MTF))
{
/* Clear MTF */
hi2c->Instance->SR = READ_BIT(hi2c->Instance->SR, I2C_SR_MTF);
hi2c->Tx_Count++;
}
if (READ_BIT(hi2c->Instance->SR, I2C_SR_TXE))
{
if (i < hi2c->Tx_Size || hi2c->Tx_Size == 0)
{
hi2c->Instance->DR = hi2c->Tx_Buffer[i++];
}
}
}
hi2c->Instance->SR = READ_REG(hi2c->Instance->SR);
}
else
{
return HAL_ERROR;
}
hi2c->Tx_Count--;
return HAL_OK;
}
/************************************************************************
* function : HAL_I2C_Slave_Transmit_IT
* Description: Transmit in slave mode an amount of data in non-blocking mode with Interrupt
* input : hi2c : pointer to a I2C_HandleTypeDef structure that contains
* the configuration information for I2C module
* pData : Pointer to data buffer
* Size : Amount of data to be sent
* return : HAL_StatusTypeDef
************************************************************************/
HAL_StatusTypeDef HAL_I2C_Slave_Transmit_IT(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint32_t Size)
{
/* Check I2C Parameter */
if (!IS_I2C_ALL_INSTANCE(hi2c->Instance)) return HAL_ERROR;
/* Rx machine is running */
if (hi2c->Slave_TxState != SLAVE_TX_STATE_IDLE)
return HAL_ERROR;
/* Set Slave machine is sending */
hi2c->Slave_TxState = SLAVE_TX_STATE_SENDING;
hi2c->Tx_Buffer = pData;
hi2c->Tx_Size = Size;
hi2c->Tx_Count = 0;
CLEAR_BIT(hi2c->Instance->CR, I2C_CR_TXE_SEL);
hi2c->Instance->DR = hi2c->Tx_Buffer[0];
hi2c->Tx_Count++;
/* Clear RX ADDR1 Flag */
SET_BIT(hi2c->Instance->SR, I2C_SR_RX_ADDR1);
/* RX ADDR1 Interrupt Enable */
SET_BIT(hi2c->Instance->CR, I2C_CR_RX_ADDR1_INT_EN);
return HAL_OK;
}
/************************************************************************
* function : HAL_I2C_Slave_Receive
* Description: Receive in Slave mode an amount of data in blocking mode.
* input : hi2c : pointer to a I2C_HandleTypeDef structure that contains
* the configuration information for I2C module
* pData : Pointer to data buffer
* Size : Amount of data to be sent
* Timeout : Timeout value
* return : HAL_StatusTypeDef
************************************************************************/
HAL_StatusTypeDef HAL_I2C_Slave_Receive(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint32_t Size, uint32_t Timeout)
{
/* Check I2C Parameter */
if (!IS_I2C_ALL_INSTANCE(hi2c->Instance)) return HAL_ERROR;;
hi2c->Rx_Buffer = pData;
hi2c->Rx_Size = Size;
hi2c->Rx_Count = 0;
/* Match the Address 1 */
if(I2C_WaitOnFlagUntilTimeout(hi2c, I2C_SR_RX_ADDR1, RESET, Timeout) != HAL_OK) return HAL_ERROR;
/* Clear RX_ADDR1 Flag */
hi2c->Instance->SR = READ_BIT(hi2c->Instance->SR, I2C_SR_RX_ADDR1);
/* Slave Receive */
if (!READ_BIT(hi2c->Instance->SR, I2C_SR_SRW))
{
/* Wait for transmission End*/
if(I2C_WaitOnFlagUntilTimeout(hi2c, I2C_SR_MTF, RESET, Timeout) != HAL_OK) return HAL_ERROR;
/* Clear MTF */
hi2c->Instance->SR = READ_BIT(hi2c->Instance->SR, I2C_SR_MTF);
/* BUS BUSY */
while(READ_BIT(hi2c->Instance->SR, I2C_SR_BUS_BUSY))
{
/* Receive Data */
if (READ_BIT(hi2c->Instance->SR, I2C_SR_RXNE))
{
hi2c->Rx_Buffer[hi2c->Rx_Count++] = hi2c->Instance->DR;
/* Wait for transmission End*/
if(I2C_WaitOnFlagUntilTimeout(hi2c, I2C_SR_MTF, RESET, Timeout) != HAL_OK) return HAL_ERROR;
/* Clear MTF */
hi2c->Instance->SR = READ_BIT(hi2c->Instance->SR, I2C_SR_MTF);
if (hi2c->Rx_Size != 0)
{
if (hi2c->Rx_Count >= hi2c->Rx_Size)
{
break;
}
}
}
}
/* Generate ACK */
CLEAR_BIT(hi2c->Instance->CR, I2C_CR_TACK);
hi2c->Instance->SR = READ_REG(hi2c->Instance->SR);
}
/* Slave Transmit */
else
{
return HAL_ERROR;
}
return HAL_OK;
}
/************************************************************************
* function : HAL_I2C_Slave_Receive_IT
* Description: Receive in slave mode an amount of data in non-blocking mode with Interrupt
* input : hi2c : pointer to a I2C_HandleTypeDef structure that contains
* the configuration information for I2C module
* pData : Pointer to data buffer
* Size : Amount of data to be sent
************************************************************************/
HAL_StatusTypeDef HAL_I2C_Slave_Receive_IT(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint32_t Size)
{
/* Check I2C Parameter */
if (!IS_I2C_ALL_INSTANCE(hi2c->Instance)) return HAL_ERROR;
/* Rx machine is running */
if (hi2c->Slave_RxState != SLAVE_RX_STATE_IDLE)
return HAL_ERROR;
/* Set Slave machine is receiving */
hi2c->Slave_RxState = SLAVE_RX_STATE_RECEIVING;
hi2c->Rx_Buffer = pData;
hi2c->Rx_Size = Size;
hi2c->Rx_Count = 0;
/* Clear RX ADDR1 Flag */
SET_BIT(hi2c->Instance->SR, I2C_SR_RX_ADDR1);
/* RX ADDR1 Interrupt Enable */
SET_BIT(hi2c->Instance->CR, I2C_CR_RX_ADDR1_INT_EN);
return HAL_OK;
}
/************************************************************************
* function : HAL_I2C_Slave_Receive_DMA
* Description: Receive in slave mode an amount of data in non-blocking mode with DMA
* input : hi2c : pointer to a I2C_HandleTypeDef structure that contains
* the configuration information for I2C module
* pData : Pointer to data buffer
* Size : Amount of data to be sent
************************************************************************/
HAL_StatusTypeDef HAL_I2C_Slave_Receive_DMA(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint32_t Size)
{
/* Check I2C Parameter */
if (!IS_I2C_ALL_INSTANCE(hi2c->Instance)) return HAL_ERROR;
hi2c->Rx_Buffer = pData;
hi2c->Rx_Size = Size;
hi2c->Rx_Count = Size;
/* DMA Enable */
SET_BIT(hi2c->Instance->CR, I2C_CR_DMA_EN);
/* Clear STOPF Interrupt Flag */
hi2c->Instance->SR = READ_BIT(hi2c->Instance->SR, I2C_SR_STOPF);
/* STOPF Interrupt Enable */
SET_BIT(hi2c->Instance->CR, I2C_CR_STOPF_INTEN);
HAL_DMA_Start(hi2c->HDMA_Rx, (uint32_t)&hi2c->Instance->DR, (uint32_t)hi2c->Rx_Buffer, hi2c->Rx_Size);
return HAL_OK;
}
/************************************************************************
* function : HAL_I2C_Slave_Transmit_DMA
* Description: Transmit in slave mode an amount of data in non-blocking mode with DMA
* input : hi2c : pointer to a I2C_HandleTypeDef structure that contains
* the configuration information for I2C module
* pData : Pointer to data buffer
* Size : Amount of data to be sent
************************************************************************/
HAL_StatusTypeDef HAL_I2C_Slave_Transmit_DMA(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint32_t Size)
{
/* Check I2C Parameter */
if (!IS_I2C_ALL_INSTANCE(hi2c->Instance)) return HAL_ERROR;
hi2c->Tx_Buffer = pData;
hi2c->Tx_Size = Size;
hi2c->Tx_Count = Size;
/* Must Set TXE_SEL In DMA Mode !!! */
SET_BIT(hi2c->Instance->CR, I2C_CR_TXE_SEL);
/* DMA Enable */
SET_BIT(hi2c->Instance->CR, I2C_CR_DMA_EN);
HAL_DMA_Start_IT(hi2c->HDMA_Tx, (uint32_t)hi2c->Tx_Buffer, (uint32_t)&hi2c->Instance->DR, hi2c->Tx_Size);
return HAL_OK;
}
/************************************************************************
* function : HAL_I2C_Mem_Write
* Description: Write an amount of data in blocking mode to a specific memory address
* input : hi2c : pointer to a I2C_HandleTypeDef structure that contains
* the configuration information for I2C module
* DevAddress : Target device address
* MemAddress : MemAddress Internal memory address
* MemAddSize : MemAddSize Size of internal memory address
* pData : Pointer to data buffer
* Size : Amount of data to be sent
* Timeout : Timeout value
************************************************************************/
HAL_StatusTypeDef HAL_I2C_Mem_Write(I2C_HandleTypeDef *hi2c, uint8_t DevAddress, uint16_t MemAddress, uint16_t MemAddSize, uint8_t *pData, uint16_t Size, uint32_t Timeout)
{
uint32_t i;
/* Check I2C Parameter */
if (!IS_I2C_ALL_INSTANCE(hi2c->Instance)) return HAL_ERROR;
hi2c->Tx_Buffer = pData;
hi2c->Tx_Size = Size;
hi2c->Tx_Count = 0;
/* Bus Busy */
if (READ_BIT(hi2c->Instance->SR, I2C_SR_BUS_BUSY))
return HAL_ERROR;
/* Send Write Access Request */
if (I2C_Master_Request_Write(hi2c, DevAddress,0) == HAL_OK)
{
/* If Memory address size is 8Bit */
if (MemAddSize == I2C_MEMADD_SIZE_8BIT)
{
/* Send Memory Address */
hi2c->Instance->DR = I2C_MEM_ADD_LSB(MemAddress);
}
/* If Memory address size is 16Bit */
else
{
/* Send Memory Address MSB*/
hi2c->Instance->DR = I2C_MEM_ADD_MSB(MemAddress);
/* Wait for transmission End*/
if(I2C_WaitOnFlagUntilTimeout(hi2c, I2C_SR_MTF, RESET, Timeout) != HAL_OK) return HAL_ERROR;
/* Clear MTF */
hi2c->Instance->SR = READ_BIT(hi2c->Instance->SR, I2C_SR_MTF);
/* Send Memory Address LSB*/
hi2c->Instance->DR = I2C_MEM_ADD_LSB(MemAddress);
}
/* Wait for transmission End*/
if(I2C_WaitOnFlagUntilTimeout(hi2c, I2C_SR_MTF, RESET, Timeout) != HAL_OK) return HAL_ERROR;
/* Clear MTF */
hi2c->Instance->SR = READ_BIT(hi2c->Instance->SR, I2C_SR_MTF);
/* Get NACK */
if (READ_BIT(hi2c->Instance->SR, I2C_SR_RACK))
{
/* Generate Stop */
SET_BIT(hi2c->Instance->CR, I2C_CR_STOP);
/* Wait for the bus to idle */
if(I2C_WaitOnFlagUntilTimeout(hi2c, I2C_SR_BUS_BUSY, SET, Timeout) != HAL_OK) return HAL_ERROR;
return HAL_ERROR;
}
/* Get ACK */
else
{
for (i = 0; i < hi2c->Tx_Size; i++)
{
/* Wait TXE Flag */
if(I2C_WaitOnFlagUntilTimeout(hi2c, I2C_SR_TXE, RESET, Timeout)!= HAL_OK) return HAL_ERROR;
/* Send Data */
hi2c->Instance->DR = hi2c->Tx_Buffer[hi2c->Tx_Count++];
/* Wait for transmission End*/
if(I2C_WaitOnFlagUntilTimeout(hi2c, I2C_SR_MTF, RESET, Timeout) != HAL_OK) return HAL_ERROR;
/* Clear MTF */
hi2c->Instance->SR = READ_BIT(hi2c->Instance->SR, I2C_SR_MTF);
/* Get NACK */
if (READ_BIT(hi2c->Instance->SR, I2C_SR_RACK))
{
/* Generate Stop */
SET_BIT(hi2c->Instance->CR, I2C_CR_STOP);
/* Wait for the bus to idle */
if(I2C_WaitOnFlagUntilTimeout(hi2c, I2C_SR_BUS_BUSY, SET, Timeout) != HAL_OK) return HAL_ERROR;
return HAL_ERROR;
}
}
/* Generate Stop */
SET_BIT(hi2c->Instance->CR, I2C_CR_STOP);
/* Wait for the bus to idle */
if(I2C_WaitOnFlagUntilTimeout(hi2c, I2C_SR_BUS_BUSY, SET, Timeout) != HAL_OK) return HAL_ERROR;
/* Check Device Ready */
while(I2C_Check_Device_Ready(hi2c, DevAddress, Timeout) != HAL_OK);
}
}
else
{
return HAL_ERROR;
}
return HAL_OK;
}
/************************************************************************
* function : HAL_I2C_Mem_Read
* Description: Read an amount of data in blocking mode to a specific memory address
* input : hi2c : pointer to a I2C_HandleTypeDef structure that contains
* the configuration information for I2C module
* DevAddress : Target device address
* MemAddress : MemAddress Internal memory address
* MemAddSize : MemAddSize Size of internal memory address
* pData : Pointer to data buffer
* Size : Amount of data to be sent
* Timeout : Timeout value
************************************************************************/
HAL_StatusTypeDef HAL_I2C_Mem_Read(I2C_HandleTypeDef *hi2c, uint8_t DevAddress, uint16_t MemAddress, uint16_t MemAddSize, uint8_t *pData, uint16_t Size, uint32_t Timeout)
{
uint32_t i;
/* Check I2C Parameter */
if (!IS_I2C_ALL_INSTANCE(hi2c->Instance)) return HAL_ERROR;
hi2c->Rx_Buffer = pData;
hi2c->Rx_Size = Size;
hi2c->Rx_Count = 0;
/* Bus Busy */
if (READ_BIT(hi2c->Instance->SR, I2C_SR_BUS_BUSY))
return HAL_ERROR;
/* Send Write Access Request */
if (I2C_Master_Request_Write(hi2c, DevAddress,0) == HAL_OK)
{
/* If Memory address size is 8Bit */
if (MemAddSize == I2C_MEMADD_SIZE_8BIT)
{
/* Send Memory Address */
hi2c->Instance->DR = I2C_MEM_ADD_LSB(MemAddress);
}
/* If Memory address size is 16Bit */
else
{
/* Send Memory Address MSB*/
hi2c->Instance->DR = I2C_MEM_ADD_MSB(MemAddress);
/* Wait for transmission End*/
if(I2C_WaitOnFlagUntilTimeout(hi2c, I2C_SR_MTF, RESET, Timeout) != HAL_OK) return HAL_ERROR;
/* Clear MTF */
hi2c->Instance->SR = READ_BIT(hi2c->Instance->SR, I2C_SR_MTF);
/* Send Memory Address LSB*/
hi2c->Instance->DR = I2C_MEM_ADD_LSB(MemAddress);
}
/* Wait for transmission End*/
if(I2C_WaitOnFlagUntilTimeout(hi2c, I2C_SR_MTF, RESET, Timeout) != HAL_OK) return HAL_ERROR;
/* Clear MTF */
hi2c->Instance->SR = READ_BIT(hi2c->Instance->SR, I2C_SR_MTF);
/* Get NACK */
if (READ_BIT(hi2c->Instance->SR, I2C_SR_RACK))
{
/* Generate Stop */
SET_BIT(hi2c->Instance->CR, I2C_CR_STOP);
/* Wait for the bus to idle */
if(I2C_WaitOnFlagUntilTimeout(hi2c, I2C_SR_BUS_BUSY, SET, Timeout) != HAL_OK) return HAL_ERROR;
return HAL_ERROR;
}
/* Get ACK */
else
{
/* Send Write Read Request */
if (I2C_Master_Request_Read(hi2c, DevAddress, Timeout) == HAL_OK)
{
/* Wait Master Transition receiving state */
if(I2C_WaitOnFlagUntilTimeout(hi2c, I2C_SR_TX_RX_FLAG, RESET, Timeout) != HAL_OK) return HAL_ERROR;
/* Clear TX_RX_FLAG */
hi2c->Instance->SR = READ_BIT(hi2c->Instance->SR, I2C_SR_TX_RX_FLAG);
/* Generate ACK */
CLEAR_BIT(hi2c->Instance->CR, I2C_CR_TACK);
for (i = 0; i < hi2c->Rx_Size - 1; i++)
{
/* Wait RXNE Flag */
if(I2C_WaitOnFlagUntilTimeout(hi2c, I2C_SR_RXNE, RESET, Timeout) != HAL_OK) return HAL_ERROR;
/* Read Data */
hi2c->Rx_Buffer[hi2c->Rx_Count++] = hi2c->Instance->DR;
/* Wait for transmission End*/
if(I2C_WaitOnFlagUntilTimeout(hi2c, I2C_SR_MTF, RESET, Timeout) != HAL_OK) return HAL_ERROR;
/* Clear MTF */
hi2c->Instance->SR = READ_BIT(hi2c->Instance->SR, I2C_SR_MTF);
}
/* Prepare for Generate NACK */
SET_BIT(hi2c->Instance->CR, I2C_CR_TACK);
/* Prepare for Generate STOP */
SET_BIT(hi2c->Instance->CR, I2C_CR_STOP);
/* Wait RXNE Flag */
if(I2C_WaitOnFlagUntilTimeout(hi2c, I2C_SR_RXNE, RESET, Timeout) != HAL_OK) return HAL_ERROR;
/* Read Data */
hi2c->Rx_Buffer[hi2c->Rx_Count++] = hi2c->Instance->DR;
/* Wait for transmission End*/
if(I2C_WaitOnFlagUntilTimeout(hi2c, I2C_SR_MTF, RESET, Timeout) != HAL_OK) return HAL_ERROR;
/* Clear MTF */
hi2c->Instance->SR = READ_BIT(hi2c->Instance->SR, I2C_SR_MTF);
/* Wait for the bus to idle */
if(I2C_WaitOnFlagUntilTimeout(hi2c, I2C_SR_BUS_BUSY, SET, Timeout) != HAL_OK) return HAL_ERROR;
/* Generate ACK */
CLEAR_BIT(hi2c->Instance->CR, I2C_CR_TACK);
}
else
{
/* Get NACK */
return HAL_ERROR;
}
}
}
else
{
return HAL_ERROR;
}
return HAL_OK;
}
/************************************************************************
* function : HAL_I2C_GetSlaveRxState
* Description: Get Slave Rx State
* input : hi2c : pointer to a I2C_HandleTypeDef structure that contains
* the configuration information for I2C module
* return : Slave State
************************************************************************/
uint8_t HAL_I2C_GetSlaveRxState(I2C_HandleTypeDef *hi2c)
{
return hi2c->Slave_RxState;
}
/************************************************************************
* function : HAL_I2C_GetSlaveTxState
* Description: Get Slave Tx State
* input : hi2c : pointer to a I2C_HandleTypeDef structure that contains
* the configuration information for I2C module
* return : Slave State
************************************************************************/
uint8_t HAL_I2C_GetSlaveTxState(I2C_HandleTypeDef *hi2c)
{
return hi2c->Slave_TxState;
}
/************************************************************************
* function : I2C_Set_Clock_Speed
* Description: Set I2C Clock Speed
* input : hi2c : pointer to a I2C_HandleTypeDef structure that contains
* the configuration information for I2C module
* ClockSpeed: I2C Clock Speed
************************************************************************/
static HAL_StatusTypeDef I2C_Set_Clock_Speed(I2C_HandleTypeDef *hi2c, uint32_t ClockSpeed)
{
uint32_t APB_Clock;
APB_Clock = System_Get_APBClock();
hi2c->Instance->CLK_DIV = APB_Clock / (4 * ClockSpeed) - 1;
return HAL_OK;
}
/**
* @brief This function handles I2C Communication Timeout.
* @param hi2c Pointer to a I2C_HandleTypeDef structure that contains
* the configuration information for I2C module
* @param Flag specifies the I2C flag to check.
* @param Status The new Flag status (SET or RESET).
* @param Timeout Timeout duration
* @param Tickstart Tick start value
* @retval HAL status
*/
static HAL_StatusTypeDef I2C_WaitOnFlagUntilTimeout(I2C_HandleTypeDef *hi2c, uint32_t Flag, FlagStatus Status, uint32_t Timeout)
{
__IO uint32_t lu32_Timeout;
/* have no timeout */
if (Timeout == 0)
{
while (__HAL_I2C_GET_FLAG(hi2c, Flag)==Status);
}
else
{
lu32_Timeout = Timeout * 0xFF;
while (__HAL_I2C_GET_FLAG(hi2c, Flag)==Status)
{
if (lu32_Timeout-- == 0)
{
return HAL_ERROR;
}
}
}
return HAL_OK;
}
/************************************************************************
* function : I2C_Master_Request_Write
* Description: I2C Write Access Request
* input : hi2c : pointer to a I2C_HandleTypeDef structure
* DevAddress: Device address
* Timeout: Timeout value
************************************************************************/
static HAL_StatusTypeDef I2C_Master_Request_Write(I2C_HandleTypeDef *hi2c, uint8_t DevAddress, uint32_t Timeout)
{
/* Generate Start */
SET_BIT(hi2c->Instance->CR, I2C_CR_START);
/* Clear MTF, To Prevent Errors */
hi2c->Instance->SR = READ_BIT(hi2c->Instance->SR, I2C_SR_MTF);
/* Send Device Address */
hi2c->Instance->DR = DevAddress & 0xFE;
/* Wait for transmission End*/
if(I2C_WaitOnFlagUntilTimeout(hi2c, I2C_SR_MTF, RESET, Timeout) != HAL_OK) return HAL_ERROR;
/* Clear MTF */
hi2c->Instance->SR = READ_BIT(hi2c->Instance->SR, I2C_SR_MTF);
/* Get NACK */
if (READ_BIT(hi2c->Instance->SR, I2C_SR_RACK))
{
/* Generate Stop */
SET_BIT(hi2c->Instance->CR, I2C_CR_STOP);
/* Wait for the bus to idle */
if(I2C_WaitOnFlagUntilTimeout(hi2c, I2C_SR_BUS_BUSY, SET, Timeout) != HAL_OK) return HAL_ERROR;
return HAL_ERROR;
}
/* Get ACK */
else
{
return HAL_OK;
}
}
/************************************************************************
* function : I2C_Master_Request_Read
* Description: I2C Read Access Request
* input : hi2c : pointer to a I2C_HandleTypeDef structure
* DevAddress: Device address
* Timeout: Timeout value
************************************************************************/
static HAL_StatusTypeDef I2C_Master_Request_Read(I2C_HandleTypeDef *hi2c, uint8_t DevAddress, uint32_t Timeout)
{
/* Generate Start */
SET_BIT(hi2c->Instance->CR, I2C_CR_START);
/* Clear MTF, To Prevent Errors */
hi2c->Instance->SR = READ_BIT(hi2c->Instance->SR, I2C_SR_MTF);
/* Send Device Address */
hi2c->Instance->DR = DevAddress | 0x01;
/* Wait for transmission End */
if(I2C_WaitOnFlagUntilTimeout(hi2c, I2C_SR_MTF, RESET, Timeout) != HAL_OK) return HAL_ERROR;
/* Clear MTF */
hi2c->Instance->SR = READ_BIT(hi2c->Instance->SR, I2C_SR_MTF);
/* Get NACK */
if (READ_BIT(hi2c->Instance->SR, I2C_SR_RACK))
{
/* Generate Stop */
SET_BIT(hi2c->Instance->CR, I2C_CR_STOP);
/* Wait for the bus to idle */
if(I2C_WaitOnFlagUntilTimeout(hi2c, I2C_SR_BUS_BUSY, SET, Timeout) != HAL_OK) return HAL_ERROR;
return HAL_ERROR;
}
/* Get ACK */
else
{
return HAL_OK;
}
}
/************************************************************************
* function : I2C_Check_Device_Ready
* Description: Check Device Ready
* input : hi2c : pointer to a I2C_HandleTypeDef structure
* DevAddress: Device address
* Timeout: Timeout value
************************************************************************/
static HAL_StatusTypeDef I2C_Check_Device_Ready(I2C_HandleTypeDef *hi2c, uint8_t DevAddress, uint32_t Timeout)
{
/* Bus Busy */
if (READ_BIT(hi2c->Instance->SR, I2C_SR_BUS_BUSY))
return HAL_ERROR;
/* Generate Start */
SET_BIT(hi2c->Instance->CR, I2C_CR_START);
/* Send Device Address */
hi2c->Instance->DR = DevAddress;
/* Wait for transmission End */
if(I2C_WaitOnFlagUntilTimeout(hi2c, I2C_SR_MTF, RESET, Timeout) != HAL_OK) return HAL_ERROR;
/* Clear MTF */
hi2c->Instance->SR = READ_BIT(hi2c->Instance->SR, I2C_SR_MTF);
/* Get NACK */
if (READ_BIT(hi2c->Instance->SR, I2C_SR_RACK))
{
/* Generate Stop */
SET_BIT(hi2c->Instance->CR, I2C_CR_STOP);
/* Wait for the bus to idle */
if(I2C_WaitOnFlagUntilTimeout(hi2c, I2C_SR_BUS_BUSY, SET, Timeout) != HAL_OK) return HAL_ERROR;
return HAL_ERROR;
}
/* Get ACK */
else
{
/* Generate Stop */
SET_BIT(hi2c->Instance->CR, I2C_CR_STOP);
/* Wait for the bus to idle */
if(I2C_WaitOnFlagUntilTimeout(hi2c, I2C_SR_BUS_BUSY, SET, Timeout) != HAL_OK) return HAL_ERROR;
return HAL_OK;
}
}