Collaboration diagram for I2C_Exported_Functions:

Functions
void	I2C_AcknowledgeConfig (I2C_TypeDef *I2Cx, FunctionalState NewState)
	Enables or disables the specified I2C acknowledge feature. More...

void	I2C_ARPCmd (I2C_TypeDef *I2Cx, FunctionalState NewState)
	Enables or disables the specified I2C ARP. More...

void	I2C_CalculatePEC (I2C_TypeDef *I2Cx, FunctionalState NewState)
	Enables or disables the PEC value calculation of the transferred bytes. More...

ErrorStatus	I2C_CheckEvent (I2C_TypeDef *I2Cx, uint32_t I2C_EVENT)
	I2C State Monitoring Functions. More...

void	I2C_ClearFlag (I2C_TypeDef *I2Cx, uint32_t I2C_FLAG)
	Clears the I2Cx's pending flags. More...

void	I2C_ClearITPendingBit (I2C_TypeDef *I2Cx, uint32_t I2C_IT)
	Clears the I2Cx's interrupt pending bits. More...

void	I2C_Cmd (I2C_TypeDef *I2Cx, FunctionalState NewState)
	Enables or disables the specified I2C peripheral. More...

void	I2C_DeInit (I2C_TypeDef *I2Cx)
	Deinitialize the I2Cx peripheral registers to their default reset values. More...

void	I2C_DMACmd (I2C_TypeDef *I2Cx, FunctionalState NewState)
	Enables or disables the specified I2C DMA requests. More...

void	I2C_DMALastTransferCmd (I2C_TypeDef *I2Cx, FunctionalState NewState)
	Specifies that the next DMA transfer is the last one. More...

void	I2C_DualAddressCmd (I2C_TypeDef *I2Cx, FunctionalState NewState)
	Enables or disables the specified I2C dual addressing mode. More...

void	I2C_FastModeDutyCycleConfig (I2C_TypeDef *I2Cx, uint16_t I2C_DutyCycle)
	Selects the specified I2C fast mode duty cycle. More...

void	I2C_GeneralCallCmd (I2C_TypeDef *I2Cx, FunctionalState NewState)
	Enables or disables the specified I2C general call feature. More...

void	I2C_GenerateSTART (I2C_TypeDef *I2Cx, FunctionalState NewState)
	Generates I2Cx communication START condition. More...

void	I2C_GenerateSTOP (I2C_TypeDef *I2Cx, FunctionalState NewState)
	Generates I2Cx communication STOP condition. More...

FlagStatus	I2C_GetFlagStatus (I2C_TypeDef *I2Cx, uint32_t I2C_FLAG)
	Checks whether the specified I2C flag is set or not. More...

ITStatus	I2C_GetITStatus (I2C_TypeDef *I2Cx, uint32_t I2C_IT)
	Checks whether the specified I2C interrupt has occurred or not. More...

uint32_t	I2C_GetLastEvent (I2C_TypeDef *I2Cx)
	Returns the last I2Cx Event. More...

uint8_t	I2C_GetPEC (I2C_TypeDef *I2Cx)
	Returns the PEC value for the specified I2C. More...

void	I2C_Init (I2C_TypeDef I2Cx, I2C_InitTypeDef I2C_InitStruct)
	Initializes the I2Cx peripheral according to the specified parameters in the I2C_InitStruct. More...

void	I2C_ITConfig (I2C_TypeDef *I2Cx, uint16_t I2C_IT, FunctionalState NewState)
	Enables or disables the specified I2C interrupts. More...

void	I2C_NACKPositionConfig (I2C_TypeDef *I2Cx, uint16_t I2C_NACKPosition)
	Selects the specified I2C NACK position in master receiver mode. More...

void	I2C_OwnAddress2Config (I2C_TypeDef *I2Cx, uint8_t Address)
	Configures the specified I2C own address2. More...

void	I2C_PECPositionConfig (I2C_TypeDef *I2Cx, uint16_t I2C_PECPosition)
	Selects the specified I2C PEC position. More...

uint16_t	I2C_ReadRegister (I2C_TypeDef *I2Cx, uint8_t I2C_Register)
	Reads the specified I2C register and returns its value. More...

uint8_t	I2C_ReceiveData (I2C_TypeDef *I2Cx)
	Returns the most recent received data by the I2Cx peripheral. More...

void	I2C_Send7bitAddress (I2C_TypeDef *I2Cx, uint8_t Address, uint8_t I2C_Direction)
	Transmits the address byte to select the slave device. More...

void	I2C_SendData (I2C_TypeDef *I2Cx, uint8_t Data)
	Sends a data byte through the I2Cx peripheral. More...

void	I2C_SMBusAlertConfig (I2C_TypeDef *I2Cx, uint16_t I2C_SMBusAlert)
	Drives the SMBusAlert pin high or low for the specified I2C. More...

void	I2C_SoftwareResetCmd (I2C_TypeDef *I2Cx, FunctionalState NewState)
	Enables or disables the specified I2C software reset. More...

void	I2C_StretchClockCmd (I2C_TypeDef *I2Cx, FunctionalState NewState)
	Enables or disables the specified I2C Clock stretching. More...

void	I2C_StructInit (I2C_InitTypeDef *I2C_InitStruct)
	Fills each I2C_InitStruct member with its default value. More...

void	I2C_TransmitPEC (I2C_TypeDef *I2Cx, FunctionalState NewState)
	Enables or disables the specified I2C PEC transfer. More...

Detailed Description

Function Documentation

void I2C_AcknowledgeConfig	(	I2C_TypeDef *	I2Cx,
		FunctionalState	NewState
	)

Enables or disables the specified I2C acknowledge feature.

Parameters

I2Cx	where x can be 1, 2 or 3 to select the I2C peripheral.
NewState	new state of the I2C Acknowledgement. This parameter can be: ENABLE or DISABLE.

Return values

None.

Parameters

I2Cx	where x can be 1 or 2 to select the I2C peripheral.
NewState	new state of the I2C Acknowledgement. This parameter can be: ENABLE or DISABLE.

Return values

None. Enables or disables the specified I2C acknowledge feature.

Parameters

I2Cx	where x can be 1 or 2 to select the I2C peripheral.
NewState	new state of the Acknowledge. This parameter can be: ENABLE or DISABLE.

Return values

None

Definition at line 472 of file stm32f4xx_i2c.c.

void I2C_ARPCmd	(	I2C_TypeDef *	I2Cx,
		FunctionalState	NewState
	)

Enables or disables the specified I2C ARP.

Parameters

I2Cx	where x can be 1, 2 or 3 to select the I2C peripheral.
NewState	new state of the I2Cx ARP. This parameter can be: ENABLE or DISABLE.

Return values

None

Parameters

I2Cx	where x can be 1 or 2 to select the I2C peripheral.
NewState	new state of the I2Cx ARP. This parameter can be: ENABLE or DISABLE.

Return values

None

Definition at line 712 of file stm32f4xx_i2c.c.

void I2C_CalculatePEC	(	I2C_TypeDef *	I2Cx,
		FunctionalState	NewState
	)

Enables or disables the PEC value calculation of the transferred bytes.

Enables or disables I2C PEC calculation.

Parameters

I2Cx	where x can be 1, 2 or 3 to select the I2C peripheral.
NewState	new state of the I2Cx PEC value calculation. This parameter can be: ENABLE or DISABLE.

Return values

None

Parameters

I2Cx	where x can be 1 or 2 to select the I2C peripheral.
NewState	new state of the I2Cx PEC calculation. This parameter can be: ENABLE or DISABLE.

Return values

None	Enables or disables I2C PEC calculation.

Parameters

I2Cx	where x can be 1 or 2 to select the I2C peripheral.
NewState	new state of the I2Cx PEC value calculation. This parameter can be: ENABLE or DISABLE.

Return values

None

Definition at line 849 of file stm32f4xx_i2c.c.

ErrorStatus I2C_CheckEvent	(	I2C_TypeDef *	I2Cx,
		uint32_t	I2C_EVENT
	)

I2C State Monitoring Functions.

This I2C driver provides three different ways for I2C state monitoring depending on the application requirements and constraints:

1) Basic state monitoring: Using I2C_CheckEvent() function: It compares the status registers (SR1 and SR2) content to a given event (can be the combination of one or more flags). It returns SUCCESS if the current status includes the given flags and returns ERROR if one or more flags are missing in the current status.

When to use:
- This function is suitable for most applications as well as for startup activity since the events are fully described in the product reference manual (RM0008).
- It is also suitable for users who need to define their own events.
Limitations:
- If an error occurs (ie. error flags are set besides to the monitored flags), the I2C_CheckEvent() function may return SUCCESS despite the communication hold or corrupted real state. In this case, it is advised to use error interrupts to monitor the error events and handle them in the interrupt IRQ handler.
  Note
  For error management, it is advised to use the following functions:
  - I2C_ITConfig() to configure and enable the error interrupts (I2C_IT_ERR).
  - I2Cx_ER_IRQHandler() which is called when the error interrupt occurs. Where x is the peripheral instance (I2C1, I2C2 ...)
  - I2C_GetFlagStatus() or I2C_GetITStatus() to be called into I2Cx_ER_IRQHandler() in order to determine which error occurred.
  - I2C_ClearFlag() or I2C_ClearITPendingBit() and/or I2C_SoftwareResetCmd() and/or I2C_GenerateStop() in order to clear the error flag and source, and return to correct communication status.
  2) Advanced state monitoring: Using the function I2C_GetLastEvent() which returns the image of both status registers in a single word (uint32_t) (Status Register 2 value is shifted left by 16 bits and concatenated to Status Register 1).

When to use:

This function is suitable for the same applications above but it allows to overcome the limitations of I2C_GetFlagStatus() function (see below). The returned value could be compared to events already defined in the library (stm32f10x_i2c.h) or to custom values defined by user.
This function is suitable when multiple flags are monitored at the same time.
At the opposite of I2C_CheckEvent() function, this function allows user to choose when an event is accepted (when all events flags are set and no other flags are set or just when the needed flags are set like I2C_CheckEvent() function).

Limitations:

User may need to define his own events.
Same remark concerning the error management is applicable for this function if user decides to check only regular communication flags (and ignores error flags).

3) Flag-based state monitoring: Using the function I2C_GetFlagStatus() which simply returns the status of one single flag (ie. I2C_FLAG_RXNE ...).

When to use:
- This function could be used for specific applications or in debug phase.
- It is suitable when only one flag checking is needed (most I2C events are monitored through multiple flags).
Limitations:
- When calling this function, the Status register is accessed. Some flags are cleared when the status register is accessed. So checking the status of one Flag, may clear other ones.
- Function may need to be called twice or more in order to monitor one single event.

1) Basic state monitoring

I2C State Monitoring Functions.

Parameters

I2Cx where x can be 1, 2 or 3 to select the I2C peripheral.

I2C_EVENT

specifies the event to be checked. This parameter can be one of the following values:

I2C_EVENT_SLAVE_TRANSMITTER_ADDRESS_MATCHED: EV1
I2C_EVENT_SLAVE_RECEIVER_ADDRESS_MATCHED: EV1
I2C_EVENT_SLAVE_TRANSMITTER_SECONDADDRESS_MATCHED: EV1
I2C_EVENT_SLAVE_RECEIVER_SECONDADDRESS_MATCHED: EV1
I2C_EVENT_SLAVE_GENERALCALLADDRESS_MATCHED: EV1
I2C_EVENT_SLAVE_BYTE_RECEIVED: EV2
(I2C_EVENT_SLAVE_BYTE_RECEIVED | I2C_FLAG_DUALF): EV2
(I2C_EVENT_SLAVE_BYTE_RECEIVED | I2C_FLAG_GENCALL): EV2
I2C_EVENT_SLAVE_BYTE_TRANSMITTED: EV3
(I2C_EVENT_SLAVE_BYTE_TRANSMITTED | I2C_FLAG_DUALF): EV3
(I2C_EVENT_SLAVE_BYTE_TRANSMITTED | I2C_FLAG_GENCALL): EV3
I2C_EVENT_SLAVE_ACK_FAILURE: EV3_2
I2C_EVENT_SLAVE_STOP_DETECTED: EV4
I2C_EVENT_MASTER_MODE_SELECT: EV5
I2C_EVENT_MASTER_TRANSMITTER_MODE_SELECTED: EV6
I2C_EVENT_MASTER_RECEIVER_MODE_SELECTED: EV6
I2C_EVENT_MASTER_BYTE_RECEIVED: EV7
I2C_EVENT_MASTER_BYTE_TRANSMITTING: EV8
I2C_EVENT_MASTER_BYTE_TRANSMITTED: EV8_2
I2C_EVENT_MASTER_MODE_ADDRESS10: EV9

Note: For detailed description of Events, please refer to section I2C_Events in stm32f4xx_i2c.h file.

Return values

An	ErrorStatus enumeration value: SUCCESS: Last event is equal to the I2C_EVENT ERROR: Last event is different from the I2C_EVENT

Checks whether the last I2Cx Event is equal to the one passed as parameter.

This I2C driver provides three different ways for I2C state monitoring depending on the application requirements and constraints:

1) Basic state monitoring: Using I2C_CheckEvent() function: It compares the status registers (SR1 and SR2) content to a given event (can be the combination of one or more flags). It returns SUCCESS if the current status includes the given flags and returns ERROR if one or more flags are missing in the current status.

When to use:
- This function is suitable for most applications as well as for startup activity since the events are fully described in the product reference manual (RM0008).
- It is also suitable for users who need to define their own events.
Limitations:
- If an error occurs (ie. error flags are set besides to the monitored flags), the I2C_CheckEvent() function may return SUCCESS despite the communication hold or corrupted real state. In this case, it is advised to use error interrupts to monitor the error events and handle them in the interrupt IRQ handler.
  Note
  For error management, it is advised to use the following functions:
  - I2C_ITConfig() to configure and enable the error interrupts (I2C_IT_ERR).
  - I2Cx_ER_IRQHandler() which is called when the error interrupt occurs. Where x is the peripheral instance (I2C1, I2C2 ...)
  - I2C_GetFlagStatus() or I2C_GetITStatus() to be called into I2Cx_ER_IRQHandler() in order to determine which error occured.
  - I2C_ClearFlag() or I2C_ClearITPendingBit() and/or I2C_SoftwareResetCmd() and/or I2C_GenerateStop() in order to clear the error flag and source, and return to correct communication status.
  2) Advanced state monitoring: Using the function I2C_GetLastEvent() which returns the image of both status registers in a single word (uint32_t) (Status Register 2 value is shifted left by 16 bits and concatenated to Status Register 1).

When to use:

This function is suitable for the same applications above but it allows to overcome the mentioned limitation of I2C_GetFlagStatus() function. The returned value could be compared to events already defined in the library (stm32f10x_i2c.h) or to custom values defined by user.
This function is suitable when multiple flags are monitored at the same time.
At the opposite of I2C_CheckEvent() function, this function allows user to choose when an event is accepted (when all events flags are set and no other flags are set or just when the needed flags are set like I2C_CheckEvent() function).

Limitations:

User may need to define his own events.
Same remark concerning the error management is applicable for this function if user decides to check only regular communication flags (and ignores error flags).

3) Flag-based state monitoring: Using the function I2C_GetFlagStatus() which simply returns the status of one single flag (ie. I2C_FLAG_RXNE ...).

When to use:
- This function could be used for specific applications or in debug phase.
- It is suitable when only one flag checking is needed (most I2C events are monitored through multiple flags).
Limitations:
- When calling this function, the Status register is accessed. Some flags are cleared when the status register is accessed. So checking the status of one Flag, may clear other ones.
- Function may need to be called twice or more in order to monitor one single event.

For detailed description of Events, please refer to section I2C_Events in stm32f10x_i2c.h file.

1) Basic state monitoring Checks whether the last I2Cx Event is equal to the one passed as parameter.

Parameters

I2Cx where x can be 1 or 2 to select the I2C peripheral.

I2C_EVENT

specifies the event to be checked. This parameter can be one of the following values:

I2C_EVENT_SLAVE_TRANSMITTER_ADDRESS_MATCHED : EV1
I2C_EVENT_SLAVE_RECEIVER_ADDRESS_MATCHED : EV1
I2C_EVENT_SLAVE_TRANSMITTER_SECONDADDRESS_MATCHED : EV1
I2C_EVENT_SLAVE_RECEIVER_SECONDADDRESS_MATCHED : EV1
I2C_EVENT_SLAVE_GENERALCALLADDRESS_MATCHED : EV1
I2C_EVENT_SLAVE_BYTE_RECEIVED : EV2
(I2C_EVENT_SLAVE_BYTE_RECEIVED | I2C_FLAG_DUALF) : EV2
(I2C_EVENT_SLAVE_BYTE_RECEIVED | I2C_FLAG_GENCALL) : EV2
I2C_EVENT_SLAVE_BYTE_TRANSMITTED : EV3
(I2C_EVENT_SLAVE_BYTE_TRANSMITTED | I2C_FLAG_DUALF) : EV3
(I2C_EVENT_SLAVE_BYTE_TRANSMITTED | I2C_FLAG_GENCALL) : EV3
I2C_EVENT_SLAVE_ACK_FAILURE : EV3_2
I2C_EVENT_SLAVE_STOP_DETECTED : EV4
I2C_EVENT_MASTER_MODE_SELECT : EV5
I2C_EVENT_MASTER_TRANSMITTER_MODE_SELECTED : EV6
I2C_EVENT_MASTER_RECEIVER_MODE_SELECTED : EV6
I2C_EVENT_MASTER_BYTE_RECEIVED : EV7
I2C_EVENT_MASTER_BYTE_TRANSMITTING : EV8
I2C_EVENT_MASTER_BYTE_TRANSMITTED : EV8_2
I2C_EVENT_MASTER_MODE_ADDRESS10 : EV9

Note: : For detailed description of Events, please refer to section I2C_Events in stm32f10x_i2c.h file.

Return values

An	ErrorStatus enumeration value: SUCCESS: Last event is equal to the I2C_EVENT ERROR: Last event is different from the I2C_EVENT

Definition at line 1152 of file stm32f4xx_i2c.c.

void I2C_ClearFlag	(	I2C_TypeDef *	I2Cx,
		uint32_t	I2C_FLAG
	)

Clears the I2Cx's pending flags.

Parameters

I2Cx	where x can be 1, 2 or 3 to select the I2C peripheral.
I2C_FLAG	specifies the flag to clear. This parameter can be any combination of the following values: I2C_FLAG_SMBALERT: SMBus Alert flag I2C_FLAG_TIMEOUT: Timeout or Tlow error flag I2C_FLAG_PECERR: PEC error in reception flag I2C_FLAG_OVR: Overrun/Underrun flag (Slave mode) I2C_FLAG_AF: Acknowledge failure flag I2C_FLAG_ARLO: Arbitration lost flag (Master mode) I2C_FLAG_BERR: Bus error flag

Note: STOPF (STOP detection) is cleared by software sequence: a read operation to I2C_SR1 register (I2C_GetFlagStatus()) followed by a write operation to I2C_CR1 register (I2C_Cmd() to re-enable the I2C peripheral).; ADD10 (10-bit header sent) is cleared by software sequence: a read operation to I2C_SR1 (I2C_GetFlagStatus()) followed by writing the second byte of the address in DR register.; BTF (Byte Transfer Finished) is cleared by software sequence: a read operation to I2C_SR1 register (I2C_GetFlagStatus()) followed by a read/write to I2C_DR register (I2C_SendData()).; ADDR (Address sent) is cleared by software sequence: a read operation to I2C_SR1 register (I2C_GetFlagStatus()) followed by a read operation to I2C_SR2 register ((void)(I2Cx->SR2)).; SB (Start Bit) is cleared software sequence: a read operation to I2C_SR1 register (I2C_GetFlagStatus()) followed by a write operation to I2C_DR register (I2C_SendData()).

Return values

None

Parameters

I2Cx	where x can be 1 or 2 to select the I2C peripheral.
I2C_FLAG	specifies the flag to clear. This parameter can be any combination of the following values: I2C_FLAG_SMBALERT: SMBus Alert flag I2C_FLAG_TIMEOUT: Timeout or Tlow error flag I2C_FLAG_PECERR: PEC error in reception flag I2C_FLAG_OVR: Overrun/Underrun flag (Slave mode) I2C_FLAG_AF: Acknowledge failure flag I2C_FLAG_ARLO: Arbitration lost flag (Master mode) I2C_FLAG_BERR: Bus error flag

Note

STOPF (STOP detection) is cleared by software sequence: a read operation to I2C_SR1 register (I2C_GetFlagStatus()) followed by a write operation to I2C_CR1 register (I2C_Cmd() to re-enable the I2C peripheral).
ADD10 (10-bit header sent) is cleared by software sequence: a read operation to I2C_SR1 (I2C_GetFlagStatus()) followed by writing the second byte of the address in DR register.
BTF (Byte Transfer Finished) is cleared by software sequence: a read operation to I2C_SR1 register (I2C_GetFlagStatus()) followed by a read/write to I2C_DR register (I2C_SendData()).
ADDR (Address sent) is cleared by software sequence: a read operation to I2C_SR1 register (I2C_GetFlagStatus()) followed by a read operation to I2C_SR2 register ((void)(I2Cx->SR2)).
SB (Start Bit) is cleared software sequence: a read operation to I2C_SR1 register (I2C_GetFlagStatus()) followed by a write operation to I2C_DR register (I2C_SendData()).

Return values

None

Parameters

I2Cx where x can be 1 or 2 to select the I2C peripheral.

I2C_FLAG

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

I2C_FLAG_ADDR: Address matched (slave mode)
I2C_FLAG_NACKF: NACK 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

The	new state of I2C_FLAG (SET or RESET).

Definition at line 1332 of file stm32f4xx_i2c.c.

void I2C_ClearITPendingBit	(	I2C_TypeDef *	I2Cx,
		uint32_t	I2C_IT
	)

Clears the I2Cx's interrupt pending bits.

Parameters

I2Cx where x can be 1, 2 or 3 to select the I2C peripheral.

I2C_IT

specifies the interrupt pending bit to clear. This parameter can be any combination of the following values:

I2C_IT_SMBALERT: SMBus Alert interrupt
I2C_IT_TIMEOUT: Timeout or Tlow error interrupt
I2C_IT_PECERR: PEC error in reception interrupt
I2C_IT_OVR: Overrun/Underrun interrupt (Slave mode)
I2C_IT_AF: Acknowledge failure interrupt
I2C_IT_ARLO: Arbitration lost interrupt (Master mode)
I2C_IT_BERR: Bus error interrupt

Note: STOPF (STOP detection) is cleared by software sequence: a read operation to I2C_SR1 register (I2C_GetITStatus()) followed by a write operation to I2C_CR1 register (I2C_Cmd() to re-enable the I2C peripheral).; ADD10 (10-bit header sent) is cleared by software sequence: a read operation to I2C_SR1 (I2C_GetITStatus()) followed by writing the second byte of the address in I2C_DR register.; BTF (Byte Transfer Finished) is cleared by software sequence: a read operation to I2C_SR1 register (I2C_GetITStatus()) followed by a read/write to I2C_DR register (I2C_SendData()).; ADDR (Address sent) is cleared by software sequence: a read operation to I2C_SR1 register (I2C_GetITStatus()) followed by a read operation to I2C_SR2 register ((void)(I2Cx->SR2)).; SB (Start Bit) is cleared by software sequence: a read operation to I2C_SR1 register (I2C_GetITStatus()) followed by a write operation to I2C_DR register (I2C_SendData()).

Return values

None	Clears the I2Cx's interrupt pending bits.

Parameters

I2Cx where x can be 1 or 2 to select the I2C peripheral.

I2C_IT

specifies the interrupt pending bit to clear. This parameter can be any combination of the following values:

I2C_IT_SMBALERT: SMBus Alert interrupt
I2C_IT_TIMEOUT: Timeout or Tlow error interrupt
I2C_IT_PECERR: PEC error in reception interrupt
I2C_IT_OVR: Overrun/Underrun interrupt (Slave mode)
I2C_IT_AF: Acknowledge failure interrupt
I2C_IT_ARLO: Arbitration lost interrupt (Master mode)
I2C_IT_BERR: Bus error interrupt

Note

STOPF (STOP detection) is cleared by software sequence: a read operation to I2C_SR1 register (I2C_GetITStatus()) followed by a write operation to I2C_CR1 register (I2C_Cmd() to re-enable the I2C peripheral).
ADD10 (10-bit header sent) is cleared by software sequence: a read operation to I2C_SR1 (I2C_GetITStatus()) followed by writing the second byte of the address in I2C_DR register.
BTF (Byte Transfer Finished) is cleared by software sequence: a read operation to I2C_SR1 register (I2C_GetITStatus()) followed by a read/write to I2C_DR register (I2C_SendData()).
ADDR (Address sent) is cleared by software sequence: a read operation to I2C_SR1 register (I2C_GetITStatus()) followed by a read operation to I2C_SR2 register ((void)(I2Cx->SR2)).
SB (Start Bit) is cleared by software sequence: a read operation to I2C_SR1 register (I2C_GetITStatus()) followed by a write operation to I2C_DR register (I2C_SendData()).

Return values

None

Parameters

I2Cx where x can be 1 or 2 to select the I2C peripheral.

I2C_IT

specifies the interrupt pending bit to clear. This parameter can be any combination of the following values:

I2C_IT_ADDR: Address matched (slave mode)
I2C_IT_NACKF: NACK received flag
I2C_IT_STOPF: STOP detection flag
I2C_IT_BERR: Bus error
I2C_IT_ARLO: Arbitration lost
I2C_IT_OVR: Overrun/Underrun
I2C_IT_PECERR: PEC error in reception
I2C_IT_TIMEOUT: Timeout or Tlow detection flag
I2C_IT_ALERT: SMBus Alert

Return values

The	new state of I2C_IT (SET or RESET).

Definition at line 1426 of file stm32f4xx_i2c.c.

void I2C_Cmd	(	I2C_TypeDef *	I2Cx,
		FunctionalState	NewState
	)

Enables or disables the specified I2C peripheral.

Parameters

I2Cx	where x can be 1, 2 or 3 to select the I2C peripheral.
NewState	new state of the I2Cx peripheral. This parameter can be: ENABLE or DISABLE.

Return values

None

Parameters

I2Cx	where x can be 1 or 2 to select the I2C peripheral.
NewState	new state of the I2Cx peripheral. This parameter can be: ENABLE or DISABLE.

Return values

None

Parameters

I2Cx	where x can be 1 or 2 to select the I2C peripheral.
NewState	new state of the I2Cx peripheral. This parameter can be: ENABLE or DISABLE.

Return values

None

Definition at line 313 of file stm32f4xx_i2c.c.

void I2C_DeInit ( I2C_TypeDef * I2Cx )

Deinitialize the I2Cx peripheral registers to their default reset values.

Deinitializes the I2Cx peripheral registers to their default reset values.

Parameters

I2Cx	where x can be 1, 2 or 3 to select the I2C peripheral.

Return values

None

Parameters

I2Cx	where x can be 1 or 2 to select the I2C peripheral.

Return values

None	Deinitialize the I2Cx peripheral registers to their default reset values.

Parameters

I2Cx	where x can be 1 or 2 to select the I2C peripheral.

Return values

None

Definition at line 137 of file stm32f4xx_i2c.c.

void I2C_DMACmd	(	I2C_TypeDef *	I2Cx,
		FunctionalState	NewState
	)

Enables or disables the specified I2C DMA requests.

Parameters

I2Cx	where x can be 1, 2 or 3 to select the I2C peripheral.
NewState	new state of the I2C DMA transfer. This parameter can be: ENABLE or DISABLE.

Return values

None

Parameters

I2Cx	where x can be 1 or 2 to select the I2C peripheral.
NewState	new state of the I2C DMA transfer. This parameter can be: ENABLE or DISABLE.

Return values

None

Definition at line 904 of file stm32f4xx_i2c.c.

void I2C_DMALastTransferCmd	(	I2C_TypeDef *	I2Cx,
		FunctionalState	NewState
	)

Specifies that the next DMA transfer is the last one.

Parameters

I2Cx	where x can be 1, 2 or 3 to select the I2C peripheral.
NewState	new state of the I2C DMA last transfer. This parameter can be: ENABLE or DISABLE.

Return values

None	Specifies that the next DMA transfer is the last one.

Parameters

I2Cx	where x can be 1 or 2 to select the I2C peripheral.
NewState	new state of the I2C DMA last transfer. This parameter can be: ENABLE or DISABLE.

Return values

None

Definition at line 928 of file stm32f4xx_i2c.c.

void I2C_DualAddressCmd	(	I2C_TypeDef *	I2Cx,
		FunctionalState	NewState
	)

Enables or disables the specified I2C dual addressing mode.

Enables or disables the I2C own address 2.

Parameters

I2Cx	where x can be 1, 2 or 3 to select the I2C peripheral.
NewState	new state of the I2C dual addressing mode. This parameter can be: ENABLE or DISABLE.

Return values

None

Parameters

I2Cx	where x can be 1 or 2 to select the I2C peripheral.
NewState	new state of the I2C own address 2. This parameter can be: ENABLE or DISABLE.

Return values

None	Enables or disables the I2C own address 2.

Parameters

I2Cx	where x can be 1 or 2 to select the I2C peripheral.
NewState	new state of the I2C dual addressing mode. This parameter can be: ENABLE or DISABLE.

Return values

None

Definition at line 522 of file stm32f4xx_i2c.c.

void I2C_FastModeDutyCycleConfig	(	I2C_TypeDef *	I2Cx,
		uint16_t	I2C_DutyCycle
	)

Selects the specified I2C fast mode duty cycle.

Parameters

I2Cx	where x can be 1, 2 or 3 to select the I2C peripheral.
I2C_DutyCycle	specifies the fast mode duty cycle. This parameter can be one of the following values: I2C_DutyCycle_2: I2C fast mode Tlow/Thigh = 2 I2C_DutyCycle_16_9: I2C fast mode Tlow/Thigh = 16/9

Return values

None

Parameters

I2Cx	where x can be 1 or 2 to select the I2C peripheral.
I2C_DutyCycle	specifies the fast mode duty cycle. This parameter can be one of the following values: I2C_DutyCycle_2: I2C fast mode Tlow/Thigh = 2 I2C_DutyCycle_16_9: I2C fast mode Tlow/Thigh = 16/9

Return values

None

Definition at line 622 of file stm32f4xx_i2c.c.

void I2C_GeneralCallCmd	(	I2C_TypeDef *	I2Cx,
		FunctionalState	NewState
	)

Enables or disables the specified I2C general call feature.

Enables or disables the I2C general call mode.

Parameters

I2Cx	where x can be 1, 2 or 3 to select the I2C peripheral.
NewState	new state of the I2C General call. This parameter can be: ENABLE or DISABLE.

Return values

None

Parameters

I2Cx	where x can be 1 or 2 to select the I2C peripheral.
NewState	new state of the I2C general call mode. This parameter can be: ENABLE or DISABLE.

Return values

None	Enables or disables the I2C general call mode.

Parameters

I2Cx	where x can be 1 or 2 to select the I2C peripheral.
NewState	new state of the I2C General call. This parameter can be: ENABLE or DISABLE.

Return values

None

Definition at line 546 of file stm32f4xx_i2c.c.

void I2C_GenerateSTART	(	I2C_TypeDef *	I2Cx,
		FunctionalState	NewState
	)

Generates I2Cx communication START condition.

Parameters

I2Cx	where x can be 1, 2 or 3 to select the I2C peripheral.
NewState	new state of the I2C START condition generation. This parameter can be: ENABLE or DISABLE.

Return values

None.

Parameters

I2Cx	where x can be 1 or 2 to select the I2C peripheral.
NewState	new state of the I2C START condition generation. This parameter can be: ENABLE or DISABLE.

Return values

None.

Parameters

I2Cx	where x can be 1 or 2 to select the I2C peripheral.
NewState	new state of the I2C START condition generation. This parameter can be: ENABLE or DISABLE.

Return values

None

Definition at line 393 of file stm32f4xx_i2c.c.

void I2C_GenerateSTOP	(	I2C_TypeDef *	I2Cx,
		FunctionalState	NewState
	)

Generates I2Cx communication STOP condition.

Parameters

I2Cx	where x can be 1, 2 or 3 to select the I2C peripheral.
NewState	new state of the I2C STOP condition generation. This parameter can be: ENABLE or DISABLE.

Return values

None.

Parameters

I2Cx	where x can be 1 or 2 to select the I2C peripheral.
NewState	new state of the I2C STOP condition generation. This parameter can be: ENABLE or DISABLE.

Return values

None.

Parameters

I2Cx	where x can be 1 or 2 to select the I2C peripheral.
NewState	new state of the I2C STOP condition generation. This parameter can be: ENABLE or DISABLE.

Return values

None

Definition at line 417 of file stm32f4xx_i2c.c.

FlagStatus I2C_GetFlagStatus	(	I2C_TypeDef *	I2Cx,
		uint32_t	I2C_FLAG
	)

Checks whether the specified I2C flag is set or not.

3) Flag-based state monitoring

Parameters

I2Cx where x can be 1, 2 or 3 to select the I2C peripheral.

I2C_FLAG

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

I2C_FLAG_DUALF: Dual flag (Slave mode)
I2C_FLAG_SMBHOST: SMBus host header (Slave mode)
I2C_FLAG_SMBDEFAULT: SMBus default header (Slave mode)
I2C_FLAG_GENCALL: General call header flag (Slave mode)
I2C_FLAG_TRA: Transmitter/Receiver flag
I2C_FLAG_BUSY: Bus busy flag
I2C_FLAG_MSL: Master/Slave flag
I2C_FLAG_SMBALERT: SMBus Alert flag
I2C_FLAG_TIMEOUT: Timeout or Tlow error flag
I2C_FLAG_PECERR: PEC error in reception flag
I2C_FLAG_OVR: Overrun/Underrun flag (Slave mode)
I2C_FLAG_AF: Acknowledge failure flag
I2C_FLAG_ARLO: Arbitration lost flag (Master mode)
I2C_FLAG_BERR: Bus error flag
I2C_FLAG_TXE: Data register empty flag (Transmitter)
I2C_FLAG_RXNE: Data register not empty (Receiver) flag
I2C_FLAG_STOPF: Stop detection flag (Slave mode)
I2C_FLAG_ADD10: 10-bit header sent flag (Master mode)
I2C_FLAG_BTF: Byte transfer finished flag
I2C_FLAG_ADDR: Address sent flag (Master mode) "ADSL" Address matched flag (Slave mode)"ENDAD"
I2C_FLAG_SB: Start bit flag (Master mode)

Return values

The	new state of I2C_FLAG (SET or RESET).

3) Flag-based state monitoring

Parameters

I2Cx where x can be 1 or 2 to select the I2C peripheral.

I2C_FLAG

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

I2C_FLAG_DUALF: Dual flag (Slave mode)
I2C_FLAG_SMBHOST: SMBus host header (Slave mode)
I2C_FLAG_SMBDEFAULT: SMBus default header (Slave mode)
I2C_FLAG_GENCALL: General call header flag (Slave mode)
I2C_FLAG_TRA: Transmitter/Receiver flag
I2C_FLAG_BUSY: Bus busy flag
I2C_FLAG_MSL: Master/Slave flag
I2C_FLAG_SMBALERT: SMBus Alert flag
I2C_FLAG_TIMEOUT: Timeout or Tlow error flag
I2C_FLAG_PECERR: PEC error in reception flag
I2C_FLAG_OVR: Overrun/Underrun flag (Slave mode)
I2C_FLAG_AF: Acknowledge failure flag
I2C_FLAG_ARLO: Arbitration lost flag (Master mode)
I2C_FLAG_BERR: Bus error flag
I2C_FLAG_TXE: Data register empty flag (Transmitter)
I2C_FLAG_RXNE: Data register not empty (Receiver) flag
I2C_FLAG_STOPF: Stop detection flag (Slave mode)
I2C_FLAG_ADD10: 10-bit header sent flag (Master mode)
I2C_FLAG_BTF: Byte transfer finished flag
I2C_FLAG_ADDR: Address sent flag (Master mode) "ADSL" Address matched flag (Slave mode)"ENDA"
I2C_FLAG_SB: Start bit flag (Master mode)

Return values

The	new state of I2C_FLAG (SET or RESET).

Parameters

I2Cx where x can be 1 or 2 to select the I2C peripheral.

I2C_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_NACKF: NACK 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

Return values

The	new state of I2C_FLAG (SET or RESET).

Definition at line 1255 of file stm32f4xx_i2c.c.

ITStatus I2C_GetITStatus	(	I2C_TypeDef *	I2Cx,
		uint32_t	I2C_IT
	)

Checks whether the specified I2C interrupt has occurred or not.

Parameters

I2Cx where x can be 1, 2 or 3 to select the I2C peripheral.

I2C_IT

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

I2C_IT_SMBALERT: SMBus Alert flag
I2C_IT_TIMEOUT: Timeout or Tlow error flag
I2C_IT_PECERR: PEC error in reception flag
I2C_IT_OVR: Overrun/Underrun flag (Slave mode)
I2C_IT_AF: Acknowledge failure flag
I2C_IT_ARLO: Arbitration lost flag (Master mode)
I2C_IT_BERR: Bus error flag
I2C_IT_TXE: Data register empty flag (Transmitter)
I2C_IT_RXNE: Data register not empty (Receiver) flag
I2C_IT_STOPF: Stop detection flag (Slave mode)
I2C_IT_ADD10: 10-bit header sent flag (Master mode)
I2C_IT_BTF: Byte transfer finished flag
I2C_IT_ADDR: Address sent flag (Master mode) "ADSL" Address matched flag (Slave mode)"ENDAD"
I2C_IT_SB: Start bit flag (Master mode)

Return values

The	new state of I2C_IT (SET or RESET).

Parameters

I2Cx where x can be 1 or 2 to select the I2C peripheral.

I2C_IT

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

I2C_IT_SMBALERT: SMBus Alert flag
I2C_IT_TIMEOUT: Timeout or Tlow error flag
I2C_IT_PECERR: PEC error in reception flag
I2C_IT_OVR: Overrun/Underrun flag (Slave mode)
I2C_IT_AF: Acknowledge failure flag
I2C_IT_ARLO: Arbitration lost flag (Master mode)
I2C_IT_BERR: Bus error flag
I2C_IT_TXE: Data register empty flag (Transmitter)
I2C_IT_RXNE: Data register not empty (Receiver) flag
I2C_IT_STOPF: Stop detection flag (Slave mode)
I2C_IT_ADD10: 10-bit header sent flag (Master mode)
I2C_IT_BTF: Byte transfer finished flag
I2C_IT_ADDR: Address sent flag (Master mode) "ADSL" Address matched flag (Slave mode)"ENDAD"
I2C_IT_SB: Start bit flag (Master mode)

Return values

The	new state of I2C_IT (SET or RESET).

Parameters

I2Cx where x can be 1 or 2 to select the I2C peripheral.

I2C_IT

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

I2C_IT_TXIS: Transmit interrupt status
I2C_IT_RXNE: Receive data register not empty
I2C_IT_ADDR: Address matched (slave mode)
I2C_IT_NACKF: NACK received flag
I2C_IT_STOPF: STOP detection flag
I2C_IT_TC: Transfer complete (master mode)
I2C_IT_TCR: Transfer complete reload
I2C_IT_BERR: Bus error
I2C_IT_ARLO: Arbitration lost
I2C_IT_OVR: Overrun/Underrun
I2C_IT_PECERR: PEC error in reception
I2C_IT_TIMEOUT: Timeout or Tlow detection flag
I2C_IT_ALERT: SMBus Alert

Return values

The	new state of I2C_IT (SET or RESET).

Definition at line 1366 of file stm32f4xx_i2c.c.

uint32_t I2C_GetLastEvent ( I2C_TypeDef * I2Cx )

Returns the last I2Cx Event.

2) Advanced state monitoring

Parameters

I2Cx	where x can be 1, 2 or 3 to select the I2C peripheral.

Note: For detailed description of Events, please refer to section I2C_Events in stm32f4xx_i2c.h file.

Return values

The	last event

2) Advanced state monitoring

Parameters

I2Cx	where x can be 1 or 2 to select the I2C peripheral.

Note: : For detailed description of Events, please refer to section I2C_Events in stm32f10x_i2c.h file.

Return values

The	last event

Definition at line 1200 of file stm32f4xx_i2c.c.

uint8_t I2C_GetPEC ( I2C_TypeDef * I2Cx )

Returns the PEC value for the specified I2C.

Returns the I2C PEC.

Parameters

I2Cx	where x can be 1, 2 or 3 to select the I2C peripheral.

Return values

The	PEC value.

Parameters

I2Cx	where x can be 1 or 2 to select the I2C peripheral.

Return values

The	value of the PEC .

Returns the I2C PEC.

Parameters

I2Cx	where x can be 1 or 2 to select the I2C peripheral.

Return values

The	PEC value.

Definition at line 871 of file stm32f4xx_i2c.c.

void I2C_Init	(	I2C_TypeDef *	I2Cx,
		I2C_InitTypeDef *	I2C_InitStruct
	)

Initializes the I2Cx peripheral according to the specified parameters in the I2C_InitStruct.

Note: To use the I2C at 400 KHz (in fast mode), the PCLK1 frequency (I2C peripheral input clock) must be a multiple of 10 MHz.

Parameters

I2Cx	where x can be 1, 2 or 3 to select the I2C peripheral.
I2C_InitStruct	pointer to a I2C_InitTypeDef structure that contains the configuration information for the specified I2C peripheral.

Return values

None

Parameters

I2Cx	where x can be 1 or 2 to select the I2C peripheral.
I2C_InitStruct	pointer to a I2C_InitTypeDef structure that contains the configuration information for the specified I2C peripheral.

Return values

None

Parameters

I2Cx	where x can be 1 or 2 to select the I2C peripheral.
I2C_InitStruct	pointer to a I2C_InitTypeDef structure that contains the configuration information for the specified I2C peripheral.

Return values

None

Definition at line 180 of file stm32f4xx_i2c.c.

void I2C_ITConfig	(	I2C_TypeDef *	I2Cx,
		uint16_t	I2C_IT,
		FunctionalState	NewState
	)

Enables or disables the specified I2C interrupts.

Parameters

I2Cx	where x can be 1, 2 or 3 to select the I2C peripheral.
I2C_IT	specifies the I2C interrupts sources to be enabled or disabled. This parameter can be any combination of the following values: I2C_IT_BUF: Buffer interrupt mask I2C_IT_EVT: Event interrupt mask I2C_IT_ERR: Error interrupt mask
NewState	new state of the specified I2C interrupts. This parameter can be: ENABLE or DISABLE.

Return values

None

Parameters

I2Cx	where x can be 1 or 2 to select the I2C peripheral.
I2C_IT	specifies the I2C interrupts sources to be enabled or disabled. This parameter can be any combination of the following values: I2C_IT_BUF: Buffer interrupt mask I2C_IT_EVT: Event interrupt mask I2C_IT_ERR: Error interrupt mask
NewState	new state of the specified I2C interrupts. This parameter can be: ENABLE or DISABLE.

Return values

None

Definition at line 1093 of file stm32f4xx_i2c.c.

void I2C_NACKPositionConfig	(	I2C_TypeDef *	I2Cx,
		uint16_t	I2C_NACKPosition
	)

Selects the specified I2C NACK position in master receiver mode.

Note: This function is useful in I2C Master Receiver mode when the number of data to be received is equal to 2. In this case, this function should be called (with parameter I2C_NACKPosition_Next) before data reception starts,as described in the 2-byte reception procedure recommended in Reference Manual in Section: Master receiver.

Parameters

I2Cx	where x can be 1, 2 or 3 to select the I2C peripheral.
I2C_NACKPosition	specifies the NACK position. This parameter can be one of the following values: I2C_NACKPosition_Next: indicates that the next byte will be the last received byte. I2C_NACKPosition_Current: indicates that current byte is the last received byte.

Note: This function configures the same bit (POS) as I2C_PECPositionConfig() but is intended to be used in I2C mode while I2C_PECPositionConfig() is intended to used in SMBUS mode.

Return values

None	Selects the specified I2C NACK position in master receiver mode.

Parameters

I2Cx	where x can be 1 or 2 to select the I2C peripheral.
I2C_NACKPosition	specifies the NACK position. This parameter can be one of the following values: I2C_NACKPosition_Next: indicates that the next byte will be the last received byte. I2C_NACKPosition_Current: indicates that current byte is the last received byte.

Note: This function configures the same bit (POS) as I2C_PECPositionConfig() but is intended to be used in I2C mode while I2C_PECPositionConfig() is intended to used in SMBUS mode.

Return values

None

Definition at line 660 of file stm32f4xx_i2c.c.

void I2C_OwnAddress2Config	(	I2C_TypeDef *	I2Cx,
		uint8_t	Address
	)

Configures the specified I2C own address2.

Parameters

I2Cx	where x can be 1, 2 or 3 to select the I2C peripheral.
Address	specifies the 7bit I2C own address2.

Return values

None.

Parameters

I2Cx	where x can be 1 or 2 to select the I2C peripheral.
Address	specifies the 7bit I2C own address2.

Return values

None.

Definition at line 495 of file stm32f4xx_i2c.c.

void I2C_PECPositionConfig	(	I2C_TypeDef *	I2Cx,
		uint16_t	I2C_PECPosition
	)

Selects the specified I2C PEC position.

Parameters

I2Cx	where x can be 1, 2 or 3 to select the I2C peripheral.
I2C_PECPosition	specifies the PEC position. This parameter can be one of the following values: I2C_PECPosition_Next: indicates that the next byte is PEC I2C_PECPosition_Current: indicates that current byte is PEC

Note: This function configures the same bit (POS) as I2C_NACKPositionConfig() but is intended to be used in SMBUS mode while I2C_NACKPositionConfig() is intended to used in I2C mode.

Return values

None

Parameters

I2Cx	where x can be 1 or 2 to select the I2C peripheral.
I2C_PECPosition	specifies the PEC position. This parameter can be one of the following values: I2C_PECPosition_Next: indicates that the next byte is PEC I2C_PECPosition_Current: indicates that current byte is PEC

Note: This function configures the same bit (POS) as I2C_NACKPositionConfig() but is intended to be used in SMBUS mode while I2C_NACKPositionConfig() is intended to used in I2C mode.

Return values

None

Definition at line 825 of file stm32f4xx_i2c.c.

uint16_t I2C_ReadRegister	(	I2C_TypeDef *	I2Cx,
		uint8_t	I2C_Register
	)

Reads the specified I2C register and returns its value.

Parameters

I2C_Register

specifies the register to read. This parameter can be one of the following values:

I2C_Register_CR1: CR1 register.
I2C_Register_CR2: CR2 register.
I2C_Register_OAR1: OAR1 register.
I2C_Register_OAR2: OAR2 register.
I2C_Register_DR: DR register.
I2C_Register_SR1: SR1 register.
I2C_Register_SR2: SR2 register.
I2C_Register_CCR: CCR register.
I2C_Register_TRISE: TRISE register.

Return values

The	value of the read register.

Parameters

I2Cx where x can be 1 or 2 to select the I2C peripheral.

I2C_Register

specifies the register to read. This parameter can be one of the following values:

I2C_Register_CR1: CR1 register.
I2C_Register_CR2: CR2 register.
I2C_Register_OAR1: OAR1 register.
I2C_Register_OAR2: OAR2 register.
I2C_Register_TIMINGR: TIMING register.
I2C_Register_TIMEOUTR: TIMEOUTR register.
I2C_Register_ISR: ISR register.
I2C_Register_ICR: ICR register.
I2C_Register_PECR: PECR register.
I2C_Register_RXDR: RXDR register.
I2C_Register_TXDR: TXDR register.

Return values

The	value of the read register.

Definition at line 1066 of file stm32f4xx_i2c.c.

uint8_t I2C_ReceiveData ( I2C_TypeDef * I2Cx )

Returns the most recent received data by the I2Cx peripheral.

Parameters

I2Cx	where x can be 1, 2 or 3 to select the I2C peripheral.

Return values

The	value of the received data.

Parameters

I2Cx	where x can be 1 or 2 to select the I2C peripheral.

Return values

The	value of the received data.

Definition at line 763 of file stm32f4xx_i2c.c.

void I2C_Send7bitAddress	(	I2C_TypeDef *	I2Cx,
		uint8_t	Address,
		uint8_t	I2C_Direction
	)

Transmits the address byte to select the slave device.

Parameters

I2Cx	where x can be 1, 2 or 3 to select the I2C peripheral.
Address	specifies the slave address which will be transmitted
I2C_Direction	specifies whether the I2C device will be a Transmitter or a Receiver. This parameter can be one of the following values I2C_Direction_Transmitter: Transmitter mode I2C_Direction_Receiver: Receiver mode

Return values

None.

Parameters

I2Cx	where x can be 1 or 2 to select the I2C peripheral.
Address	specifies the slave address which will be transmitted
I2C_Direction	specifies whether the I2C device will be a Transmitter or a Receiver. This parameter can be one of the following values I2C_Direction_Transmitter: Transmitter mode I2C_Direction_Receiver: Receiver mode

Return values

None.

Definition at line 445 of file stm32f4xx_i2c.c.

void I2C_SendData	(	I2C_TypeDef *	I2Cx,
		uint8_t	Data
	)

Sends a data byte through the I2Cx peripheral.

Parameters

I2Cx	where x can be 1, 2 or 3 to select the I2C peripheral.
Data	Byte to be transmitted..

Return values

None

Parameters

I2Cx	where x can be 1 or 2 to select the I2C peripheral.
Data	Byte to be transmitted..

Return values

None

Definition at line 750 of file stm32f4xx_i2c.c.

void I2C_SMBusAlertConfig	(	I2C_TypeDef *	I2Cx,
		uint16_t	I2C_SMBusAlert
	)

Drives the SMBusAlert pin high or low for the specified I2C.

Parameters

I2Cx	where x can be 1, 2 or 3 to select the I2C peripheral.
I2C_SMBusAlert	specifies SMBAlert pin level. This parameter can be one of the following values: I2C_SMBusAlert_Low: SMBAlert pin driven low I2C_SMBusAlert_High: SMBAlert pin driven high

Return values

None

Parameters

I2Cx	where x can be 1 or 2 to select the I2C peripheral.
I2C_SMBusAlert	specifies SMBAlert pin level. This parameter can be one of the following values: I2C_SMBusAlert_Low: SMBAlert pin driven low I2C_SMBusAlert_High: SMBAlert pin driven high

Return values

None

Definition at line 688 of file stm32f4xx_i2c.c.

void I2C_SoftwareResetCmd	(	I2C_TypeDef *	I2Cx,
		FunctionalState	NewState
	)

Enables or disables the specified I2C software reset.

Note: When software reset is enabled, the I2C IOs are released (this can be useful to recover from bus errors).

Parameters

I2Cx	where x can be 1, 2 or 3 to select the I2C peripheral.
NewState	new state of the I2C software reset. This parameter can be: ENABLE or DISABLE.

Return values

None

Parameters

I2Cx	where x can be 1 or 2 to select the I2C peripheral.
NewState	new state of the I2C software reset. This parameter can be: ENABLE or DISABLE.

Return values

None

Definition at line 572 of file stm32f4xx_i2c.c.

void I2C_StretchClockCmd	(	I2C_TypeDef *	I2Cx,
		FunctionalState	NewState
	)

Enables or disables the specified I2C Clock stretching.

Enables or disables the I2C Clock stretching.

Parameters

I2Cx	where x can be 1, 2 or 3 to select the I2C peripheral.
NewState	new state of the I2Cx Clock stretching. This parameter can be: ENABLE or DISABLE.

Return values

None

Parameters

I2Cx	where x can be 1 or 2 to select the I2C peripheral.
NewState	new state of the I2Cx Clock stretching. This parameter can be: ENABLE or DISABLE.

Return values

None	Enables or disables the I2C Clock stretching.

Parameters

I2Cx	where x can be 1 or 2 to select the I2C peripheral.
NewState	new state of the I2Cx Clock stretching. This parameter can be: ENABLE or DISABLE.

Return values

None

Definition at line 596 of file stm32f4xx_i2c.c.

void I2C_StructInit ( I2C_InitTypeDef * I2C_InitStruct )

Fills each I2C_InitStruct member with its default value.

Parameters

I2C_InitStruct pointer to an I2C_InitTypeDef structure which will be initialized.

Return values

None

Definition at line 289 of file stm32f4xx_i2c.c.

void I2C_TransmitPEC	(	I2C_TypeDef *	I2Cx,
		FunctionalState	NewState
	)

Enables or disables the specified I2C PEC transfer.

Parameters

I2Cx	where x can be 1, 2 or 3 to select the I2C peripheral.
NewState	new state of the I2C PEC transmission. This parameter can be: ENABLE or DISABLE.

Return values

None

Parameters

I2Cx	where x can be 1 or 2 to select the I2C peripheral.
NewState	new state of the I2C PEC transmission. This parameter can be: ENABLE or DISABLE.

Return values

None

Definition at line 794 of file stm32f4xx_i2c.c.