Defines
#define	__HAL_I2C_RESET_HANDLE_STATE(__HANDLE__)
	Reset I2C handle state.
#define	__HAL_I2C_ENABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->CR1 \|= (__INTERRUPT__))
	Enable the specified I2C interrupt.
#define	__HAL_I2C_DISABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->CR1 &= (~(__INTERRUPT__)))
	Disable the specified I2C interrupt.
#define	__HAL_I2C_GET_IT_SOURCE(__HANDLE__, __INTERRUPT__) ((((__HANDLE__)->Instance->CR1 & (__INTERRUPT__)) == (__INTERRUPT__)) ? SET : RESET)
	Check whether the specified I2C interrupt source is enabled or not.
#define	__HAL_I2C_GET_FLAG(__HANDLE__, __FLAG__) (((((__HANDLE__)->Instance->ISR) & (__FLAG__)) == (__FLAG__)) ? SET : RESET)
	Check whether the specified I2C flag is set or not.
#define	__HAL_I2C_CLEAR_FLAG(__HANDLE__, __FLAG__)
	Clear the I2C pending flags which are cleared by writing 1 in a specific bit.
#define	__HAL_I2C_ENABLE(__HANDLE__) (SET_BIT((__HANDLE__)->Instance->CR1, I2C_CR1_PE))
	Enable the specified I2C peripheral.
#define	__HAL_I2C_DISABLE(__HANDLE__) (CLEAR_BIT((__HANDLE__)->Instance->CR1, I2C_CR1_PE))
	Disable the specified I2C peripheral.
#define	__HAL_I2C_GENERATE_NACK(__HANDLE__) (SET_BIT((__HANDLE__)->Instance->CR2, I2C_CR2_NACK))
	Generate a Non-Acknowledge I2C peripheral in Slave mode.

Define Documentation

#define __HAL_I2C_CLEAR_FLAG	(	__HANDLE__,
		__FLAG__
	)

Value:

(((__FLAG__) == I2C_FLAG_TXE) ? ((__HANDLE__)->Instance->ISR |= (__FLAG__)) \
                                                                                 : ((__HANDLE__)->Instance->ICR = (__FLAG__)))

Clear the I2C pending flags which are cleared by writing 1 in a specific bit.

Parameters:

__HANDLE__ specifies the I2C Handle.

__FLAG__

specifies the flag to clear. This parameter can be any combination of the following values:

I2C_FLAG_TXE Transmit data register empty
I2C_FLAG_ADDR Address matched (slave mode)
I2C_FLAG_AF Acknowledge failure received flag
I2C_FLAG_STOPF STOP detection flag
I2C_FLAG_BERR Bus error
I2C_FLAG_ARLO Arbitration lost
I2C_FLAG_OVR Overrun/Underrun
I2C_FLAG_PECERR PEC error in reception
I2C_FLAG_TIMEOUT Timeout or Tlow detection flag
I2C_FLAG_ALERT SMBus alert

Return values:

None

Definition at line 551 of file stm32l4xx_hal_i2c.h.

Referenced by HAL_I2C_ER_IRQHandler(), HAL_I2C_IsDeviceReady(), HAL_I2C_Master_Receive(), HAL_I2C_Master_Transmit(), HAL_I2C_Mem_Read(), HAL_I2C_Mem_Write(), HAL_I2C_Slave_Receive(), HAL_I2C_Slave_Sequential_Receive_DMA(), HAL_I2C_Slave_Sequential_Receive_IT(), HAL_I2C_Slave_Sequential_Transmit_DMA(), HAL_I2C_Slave_Sequential_Transmit_IT(), HAL_I2C_Slave_Transmit(), I2C_Flush_TXDR(), I2C_IsAcknowledgeFailed(), I2C_ITAddrCplt(), I2C_ITListenCplt(), I2C_ITMasterCplt(), I2C_ITSlaveCplt(), I2C_Master_ISR_DMA(), I2C_Master_ISR_IT(), I2C_Slave_ISR_DMA(), I2C_Slave_ISR_IT(), and I2C_WaitOnRXNEFlagUntilTimeout().

#define __HAL_I2C_DISABLE ( __HANDLE__ ) (CLEAR_BIT((__HANDLE__)->Instance->CR1, I2C_CR1_PE))

Disable the specified I2C peripheral.

Parameters:

__HANDLE__ specifies the I2C Handle.

Return values:

None

Definition at line 564 of file stm32l4xx_hal_i2c.h.

Referenced by HAL_I2C_DeInit(), HAL_I2C_Init(), HAL_I2CEx_ConfigAnalogFilter(), HAL_I2CEx_ConfigDigitalFilter(), HAL_I2CEx_DisableWakeUp(), and HAL_I2CEx_EnableWakeUp().

#define __HAL_I2C_DISABLE_IT	(	__HANDLE__,
		__INTERRUPT__
	)	((__HANDLE__)->Instance->CR1 &= (~(__INTERRUPT__)))

Disable the specified I2C interrupt.

Parameters:

__HANDLE__	specifies the I2C Handle.
__INTERRUPT__	specifies the interrupt source to disable. This parameter can be one of the following values: I2C_IT_ERRI Errors interrupt enable I2C_IT_TCI Transfer complete interrupt enable I2C_IT_STOPI STOP detection interrupt enable I2C_IT_NACKI NACK received interrupt enable I2C_IT_ADDRI Address match interrupt enable I2C_IT_RXI RX interrupt enable I2C_IT_TXI TX interrupt enable

Return values:

None

Definition at line 491 of file stm32l4xx_hal_i2c.h.

Referenced by I2C_Disable_IRQ(), and I2C_Master_ISR_DMA().

#define __HAL_I2C_ENABLE ( __HANDLE__ ) (SET_BIT((__HANDLE__)->Instance->CR1, I2C_CR1_PE))

Enable the specified I2C peripheral.

Parameters:

__HANDLE__ specifies the I2C Handle.

Return values:

None

Definition at line 558 of file stm32l4xx_hal_i2c.h.

Referenced by HAL_I2C_Init(), HAL_I2CEx_ConfigAnalogFilter(), HAL_I2CEx_ConfigDigitalFilter(), HAL_I2CEx_DisableWakeUp(), and HAL_I2CEx_EnableWakeUp().

#define __HAL_I2C_ENABLE_IT	(	__HANDLE__,
		__INTERRUPT__
	)	((__HANDLE__)->Instance->CR1 \|= (__INTERRUPT__))

Enable the specified I2C interrupt.

Parameters:

__HANDLE__	specifies the I2C Handle.
__INTERRUPT__	specifies the interrupt source to enable. This parameter can be one of the following values: I2C_IT_ERRI Errors interrupt enable I2C_IT_TCI Transfer complete interrupt enable I2C_IT_STOPI STOP detection interrupt enable I2C_IT_NACKI NACK received interrupt enable I2C_IT_ADDRI Address match interrupt enable I2C_IT_RXI RX interrupt enable I2C_IT_TXI TX interrupt enable

Return values:

None

Definition at line 475 of file stm32l4xx_hal_i2c.h.

Referenced by I2C_Enable_IRQ().

#define __HAL_I2C_GENERATE_NACK ( __HANDLE__ ) (SET_BIT((__HANDLE__)->Instance->CR2, I2C_CR2_NACK))

Generate a Non-Acknowledge I2C peripheral in Slave mode.

Parameters:

__HANDLE__ specifies the I2C Handle.

Return values:

None

Definition at line 570 of file stm32l4xx_hal_i2c.h.

#define __HAL_I2C_GET_FLAG	(	__HANDLE__,
		__FLAG__
	)	(((((__HANDLE__)->Instance->ISR) & (__FLAG__)) == (__FLAG__)) ? SET : RESET)

Check whether the specified I2C flag is set or not.

Parameters:

__HANDLE__ specifies the I2C Handle.

__FLAG__

specifies the flag to check. This parameter can be one of the following values:

I2C_FLAG_TXE Transmit data register empty
I2C_FLAG_TXIS Transmit interrupt status
I2C_FLAG_RXNE Receive data register not empty
I2C_FLAG_ADDR Address matched (slave mode)
I2C_FLAG_AF Acknowledge failure received flag
I2C_FLAG_STOPF STOP detection flag
I2C_FLAG_TC Transfer complete (master mode)
I2C_FLAG_TCR Transfer complete reload
I2C_FLAG_BERR Bus error
I2C_FLAG_ARLO Arbitration lost
I2C_FLAG_OVR Overrun/Underrun
I2C_FLAG_PECERR PEC error in reception
I2C_FLAG_TIMEOUT Timeout or Tlow detection flag
I2C_FLAG_ALERT SMBus alert
I2C_FLAG_BUSY Bus busy
I2C_FLAG_DIR Transfer direction (slave mode)

Return values:

The	new state of __FLAG__ (SET or RESET).

Definition at line 532 of file stm32l4xx_hal_i2c.h.

Referenced by HAL_I2C_IsDeviceReady(), HAL_I2C_Master_Receive_DMA(), HAL_I2C_Master_Receive_IT(), HAL_I2C_Master_Transmit_DMA(), HAL_I2C_Master_Transmit_IT(), HAL_I2C_Mem_Read_DMA(), HAL_I2C_Mem_Read_IT(), HAL_I2C_Mem_Write_DMA(), HAL_I2C_Mem_Write_IT(), HAL_I2C_Slave_Receive(), I2C_Flush_TXDR(), I2C_IsAcknowledgeFailed(), I2C_WaitOnFlagUntilTimeout(), I2C_WaitOnRXNEFlagUntilTimeout(), I2C_WaitOnSTOPFlagUntilTimeout(), and I2C_WaitOnTXISFlagUntilTimeout().

#define __HAL_I2C_GET_IT_SOURCE	(	__HANDLE__,
		__INTERRUPT__
	)	((((__HANDLE__)->Instance->CR1 & (__INTERRUPT__)) == (__INTERRUPT__)) ? SET : RESET)

Check whether the specified I2C interrupt source is enabled or not.

Parameters:

__HANDLE__	specifies the I2C Handle.
__INTERRUPT__	specifies the I2C interrupt source to check. This parameter can be one of the following values: I2C_IT_ERRI Errors interrupt enable I2C_IT_TCI Transfer complete interrupt enable I2C_IT_STOPI STOP detection interrupt enable I2C_IT_NACKI NACK received interrupt enable I2C_IT_ADDRI Address match interrupt enable I2C_IT_RXI RX interrupt enable I2C_IT_TXI TX interrupt enable

Return values:

The	new state of __INTERRUPT__ (SET or RESET).

Definition at line 507 of file stm32l4xx_hal_i2c.h.

#define __HAL_I2C_RESET_HANDLE_STATE ( __HANDLE__ )

Value:

do{                                                   \
                                                                    (__HANDLE__)->State = HAL_I2C_STATE_RESET;       \
                                                                    (__HANDLE__)->MspInitCallback = NULL;            \
                                                                    (__HANDLE__)->MspDeInitCallback = NULL;          \
                                                                  } while(0)

Reset I2C handle state.

Parameters:

__HANDLE__ specifies the I2C Handle.

Return values:

None

Definition at line 452 of file stm32l4xx_hal_i2c.h.

Defines

Define Documentation