I2C Exported Macros

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

Detailed Description

Macro Definition 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

<strong>HANDLE</strong>

specifies the I2C Handle.

<strong>FLAG</strong>

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 495 of file stm32f7xx_hal_i2c.h.

#define __HAL_I2C_DISABLE

(

__HANDLE__

)

(CLEAR_BIT((__HANDLE__)->Instance->CR1, I2C_CR1_PE))

Disable the specified I2C peripheral.

Parameters

<strong>HANDLE</strong>

specifies the I2C Handle.

Return values

None

Definition at line 508 of file stm32f7xx_hal_i2c.h.

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

Disable the specified I2C interrupt.

Parameters

<strong>HANDLE</strong>	specifies the I2C Handle.
<strong>INTERRUPT</strong>	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 435 of file stm32f7xx_hal_i2c.h.

#define __HAL_I2C_ENABLE

(

__HANDLE__

)

(SET_BIT((__HANDLE__)->Instance->CR1, I2C_CR1_PE))

Enable the specified I2C peripheral.

Parameters

<strong>HANDLE</strong>

specifies the I2C Handle.

Return values

None

Definition at line 502 of file stm32f7xx_hal_i2c.h.

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

Enable the specified I2C interrupt.

Parameters

<strong>HANDLE</strong>	specifies the I2C Handle.
<strong>INTERRUPT</strong>	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 419 of file stm32f7xx_hal_i2c.h.

#define __HAL_I2C_GENERATE_NACK

(

__HANDLE__

)

(SET_BIT((__HANDLE__)->Instance->CR2, I2C_CR2_NACK))

Generate a Non-Acknowledge I2C peripheral in Slave mode.

Parameters

<strong>HANDLE</strong>

specifies the I2C Handle.

Return values

None

Definition at line 514 of file stm32f7xx_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

<strong>HANDLE</strong>

specifies the I2C Handle.

<strong>FLAG</strong>

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 476 of file stm32f7xx_hal_i2c.h.

#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

<strong>HANDLE</strong>	specifies the I2C Handle.
<strong>INTERRUPT</strong>	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 451 of file stm32f7xx_hal_i2c.h.

#define __HAL_I2C_RESET_HANDLE_STATE

(

__HANDLE__

)

((__HANDLE__)->State = HAL_I2C_STATE_RESET)

Reset I2C handle state.

Parameters

<strong>HANDLE</strong>

specifies the I2C Handle.

Return values

None

Definition at line 403 of file stm32f7xx_hal_i2c.h.