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->CTR |= (__INTERRUPT__))
	Enable the specified I2C interrupt. More...
#define	__HAL_I2C_DISABLE_IT(__HANDLE__, __INTERRUPT__)   ((__HANDLE__)->Instance->CTR &= (~(__INTERRUPT__)))
	Disable the specified I2C interrupt. More...
#define	__HAL_I2C_GET_IT_SOURCE(__HANDLE__, __INTERRUPT__)   ((((__HANDLE__)->Instance->CTR & (__INTERRUPT__)) == (__INTERRUPT__)) ? SET : RESET)
	Check whether the specified I2C interrupt source is enabled or not. More...
#define	I2C_FLAG_MASK   (0x0001FFFFU)
	Check whether the specified I2C flag is set or not. More...
#define	__HAL_I2C_GET_FLAG(__HANDLE__, __FLAG__)   (((((__HANDLE__)->Instance->SR) & (__FLAG__)) == (__FLAG__)) ? SET : RESET)
#define	__HAL_I2C_CLEAR_FLAG(__HANDLE__, __FLAG__)   ((__HANDLE__)->Instance->SR |= (__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->CR, I2C_CR_IUE))
	Enable the specified I2C peripheral. More...
#define	__HAL_I2C_DISABLE(__HANDLE__)   (CLEAR_BIT((__HANDLE__)->Instance->CR, I2C_CR_IUE))
	Disable the specified I2C peripheral. More...
#define	__HAL_I2C_GENERATE_NACK(__HANDLE__)   (SET_BIT((__HANDLE__)->Instance->CR, I2C_CR_NACK))
	Generate a Non-Acknowledge I2C peripheral in Slave mode. More...

Detailed Description

Macro Definition Documentation

__HAL_I2C_CLEAR_FLAG

#define __HAL_I2C_CLEAR_FLAG	(		__HANDLE__,
			__FLAG__
	)		((__HANDLE__)->Instance->SR |= (__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_AF Acknowledge failure received flag I2C_FLAG_STOPF STOP detection flag

Return values

None

__HAL_I2C_DISABLE

#define __HAL_I2C_DISABLE

(

__HANDLE__

)

(CLEAR_BIT((__HANDLE__)->Instance->CR, I2C_CR_IUE))

Disable the specified I2C peripheral.

Parameters

__HANDLE__

specifies the I2C Handle.

Return values

None

__HAL_I2C_DISABLE_IT

#define __HAL_I2C_DISABLE_IT	(		__HANDLE__,
			__INTERRUPT__
	)		((__HANDLE__)->Instance->CTR &= (~(__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

__HAL_I2C_ENABLE

#define __HAL_I2C_ENABLE

(

__HANDLE__

)

(SET_BIT((__HANDLE__)->Instance->CR, I2C_CR_IUE))

Enable the specified I2C peripheral.

Parameters

__HANDLE__

specifies the I2C Handle.

Return values

None

__HAL_I2C_ENABLE_IT

#define __HAL_I2C_ENABLE_IT	(		__HANDLE__,
			__INTERRUPT__
	)		((__HANDLE__)->Instance->CTR |= (__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

__HAL_I2C_GENERATE_NACK

#define __HAL_I2C_GENERATE_NACK

(

__HANDLE__

)

(SET_BIT((__HANDLE__)->Instance->CR, I2C_CR_NACK))

Generate a Non-Acknowledge I2C peripheral in Slave mode.

Parameters

__HANDLE__

specifies the I2C Handle.

Return values

None

__HAL_I2C_GET_IT_SOURCE

#define __HAL_I2C_GET_IT_SOURCE	(		__HANDLE__,
			__INTERRUPT__
	)		((((__HANDLE__)->Instance->CTR & (__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).

__HAL_I2C_RESET_HANDLE_STATE

#define __HAL_I2C_RESET_HANDLE_STATE

(

__HANDLE__

)

((__HANDLE__)->State = HAL_I2C_STATE_RESET)

Reset I2C handle state.

Parameters

__HANDLE__

specifies the I2C Handle.

Return values

None

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_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_BUSY Bus busy

Return values

The	new state of FLAG (SET or RESET).