STM32F4 Standard Peripheral bibliotheek  1.0
ST Microelectronics bibliotheek documentatie voor de STM32F4 Standard Peripheral Library
 All Data Structures Files Functions Variables Enumerations Enumerator Groups
Initialization and Configuration functions

Initialization and Configuration functions. More...

Functions

void I2C_DeInit (I2C_TypeDef *I2Cx)
 Deinitialize the I2Cx peripheral registers to their default reset values. 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_StructInit (I2C_InitTypeDef *I2C_InitStruct)
 Fills each I2C_InitStruct member with its default value. More...
 
void I2C_Cmd (I2C_TypeDef *I2Cx, FunctionalState NewState)
 Enables or disables the specified I2C peripheral. 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...
 
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_AcknowledgeConfig (I2C_TypeDef *I2Cx, FunctionalState NewState)
 Enables or disables the specified I2C acknowledge feature. More...
 
void I2C_OwnAddress2Config (I2C_TypeDef *I2Cx, uint8_t Address)
 Configures the specified I2C own address2. More...
 
void I2C_DualAddressCmd (I2C_TypeDef *I2Cx, FunctionalState NewState)
 Enables or disables the specified I2C dual addressing mode. More...
 
void I2C_GeneralCallCmd (I2C_TypeDef *I2Cx, FunctionalState NewState)
 Enables or disables the specified I2C general call feature. 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_FastModeDutyCycleConfig (I2C_TypeDef *I2Cx, uint16_t I2C_DutyCycle)
 Selects the specified I2C fast mode duty cycle. More...
 
void I2C_NACKPositionConfig (I2C_TypeDef *I2Cx, uint16_t I2C_NACKPosition)
 Selects the specified I2C NACK position in master receiver mode. 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_ARPCmd (I2C_TypeDef *I2Cx, FunctionalState NewState)
 Enables or disables the specified I2C ARP. More...
 

Detailed Description

Initialization and Configuration functions.

 ===============================================================================
                   Initialization and Configuration functions
 ===============================================================================  

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.
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
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
void I2C_DeInit ( I2C_TypeDef *  I2Cx)

Deinitialize 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
void I2C_DualAddressCmd ( I2C_TypeDef *  I2Cx,
FunctionalState  NewState 
)

Enables or disables the specified I2C dual addressing mode.

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
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
void I2C_GeneralCallCmd ( I2C_TypeDef *  I2Cx,
FunctionalState  NewState 
)

Enables or disables the specified I2C general call feature.

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
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.
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.
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
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
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.
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.
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
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
void I2C_StretchClockCmd ( I2C_TypeDef *  I2Cx,
FunctionalState  NewState 
)

Enables or disables the specified 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
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