Collaboration diagram for I2C Exported Macros:

Macros
#define	__HAL_I2C_RESET_HANDLE_STATE(__HANDLE__)
	Reset I2C handle state.
#define	__HAL_I2C_ENABLE_IT(__HANDLE__, __INTERRUPT__)
	Enable the specified I2C interrupt.
#define	__HAL_I2C_DISABLE_IT(__HANDLE__, __INTERRUPT__)
	Disable the specified I2C interrupt.
#define	__HAL_I2C_GET_IT_SOURCE(__HANDLE__, __INTERRUPT__)
	Check whether the specified I2C interrupt source is enabled or not.
#define	I2C_FLAG_MASK (0x0001FFFFU)
	Check whether the specified I2C flag is set or not.
#define	__HAL_I2C_GET_FLAG(__HANDLE__, __FLAG__)
#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__)
	Enable the specified I2C peripheral.
#define	__HAL_I2C_DISABLE(__HANDLE__)
	Disable the specified I2C peripheral.
#define	__HAL_I2C_GENERATE_NACK(__HANDLE__)
	Generate a Non-Acknowledge I2C peripheral in Slave mode.

Detailed Description

Macro Definition Documentation

◆ __HAL_I2C_CLEAR_FLAG

#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 564 of file stm32h7xx_hal_i2c.h.

◆ __HAL_I2C_DISABLE

#define __HAL_I2C_DISABLE ( __HANDLE__ )

Value:

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

CLEAR_BIT

#define CLEAR_BIT(REG, BIT)

Definition stm32h7xx.h:209

I2C_CR1_PE

#define I2C_CR1_PE

Peripheral enable.

Definition stm32h723xx.h:13052

Disable the specified I2C peripheral.

Parameters

__HANDLE__ specifies the I2C Handle.

Return values

None

Definition at line 578 of file stm32h7xx_hal_i2c.h.

◆ __HAL_I2C_DISABLE_IT

#define __HAL_I2C_DISABLE_IT	(		__HANDLE__,
			__INTERRUPT__ )

Value:

((__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 501 of file stm32h7xx_hal_i2c.h.

◆ __HAL_I2C_ENABLE

#define __HAL_I2C_ENABLE ( __HANDLE__ )

Value:

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

SET_BIT

#define SET_BIT(REG, BIT)

Definition stm32h7xx.h:207

Enable the specified I2C peripheral.

Parameters

__HANDLE__ specifies the I2C Handle.

Return values

None

Definition at line 572 of file stm32h7xx_hal_i2c.h.

◆ __HAL_I2C_ENABLE_IT

#define __HAL_I2C_ENABLE_IT	(		__HANDLE__,
			__INTERRUPT__ )

Value:

((__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 485 of file stm32h7xx_hal_i2c.h.

◆ __HAL_I2C_GENERATE_NACK

#define __HAL_I2C_GENERATE_NACK ( __HANDLE__ )

Value:

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

I2C_CR2_NACK

#define I2C_CR2_NACK

NACK generation (slave mode).

Definition stm32h723xx.h:13132

Generate a Non-Acknowledge I2C peripheral in Slave mode.

Parameters

__HANDLE__ specifies the I2C Handle.

Return values

None

Definition at line 584 of file stm32h7xx_hal_i2c.h.

◆ __HAL_I2C_GET_FLAG

#define __HAL_I2C_GET_FLAG	(		__HANDLE__,
			__FLAG__ )

Value:

(((((__HANDLE__)->Instance->ISR) & \

(__FLAG__)) == (__FLAG__)) ? SET : RESET)

RESET

@ RESET

Definition stm32h7xx.h:182

SET

@ SET

Definition stm32h7xx.h:183

Definition at line 544 of file stm32h7xx_hal_i2c.h.

◆ __HAL_I2C_GET_IT_SOURCE

#define __HAL_I2C_GET_IT_SOURCE	(		__HANDLE__,
			__INTERRUPT__ )

Value:

((((__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 517 of file stm32h7xx_hal_i2c.h.

◆ __HAL_I2C_RESET_HANDLE_STATE

#define __HAL_I2C_RESET_HANDLE_STATE ( __HANDLE__ )

Value:

((__HANDLE__)->State = HAL_I2C_STATE_RESET)

HAL_I2C_STATE_RESET

@ HAL_I2C_STATE_RESET

Peripheral is not yet Initialized.

Definition stm32h7xx_hal_i2c.h:110

Reset I2C handle state.

Parameters

__HANDLE__ specifies the I2C Handle.

Return values

None

Definition at line 468 of file stm32h7xx_hal_i2c.h.

◆ I2C_FLAG_MASK

#define I2C_FLAG_MASK (0x0001FFFFU)

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 543 of file stm32h7xx_hal_i2c.h.