I2C库函数

1.void I2C_DeInit(I2C_TypeDef* I2Cx)

功能：将I2Cx外设寄存器重设为默认值

注释：该函数调用了RCC_APB1PeriphResetCmd来进行挂载于APB上外设的寄存器的复位

例如：I2C_DeInit();

 

2.void I2C_Init(I2C_TypeDef* I2Cx, I2C_InitTypeDef* I2C_InitStruct)

功能：根据I2C_InitStruct中指定的参数初始化I2Cx外设

例如：I2C_Init(I2C1 , &I2C_InitStructure);

 

3.void I2C_StructInit(I2C_InitTypeDef* I2C_InitStruct)

功能：根据默认值填充每个I2C_InitStruct成员

注释：直接向结构体成员赋值，不涉及寄存器写入的操作

例如：I2C_StructInit(&I2C_InitStructure);

 

4.void I2C_Cmd(I2C_TypeDef* I2Cx, FunctionalState NewState)

功能：使能I2C外设

注释：1. 在从模式下，如果清除使能位时通讯正在进行，在当前通讯结束后，I2C模块被禁用并返回空闲状态；

              由于在通讯结束后发生PE＝0 (Peripheral enable)，所有的位被清除

           2. 在主模式下，通讯结束之前，绝不能清除该位

例如：I2C_Cmd(I2C1 , ENABLE);

 

5.void I2C_DMACmd(I2C_TypeDef* I2Cx, FunctionalState NewState)

功能：使能或者失能指定I2C的DMA请求

例如：I2C_DMACmd(I2C1 , ENABLE);

 

6.void I2C_DMALastTransferCmd(I2C_TypeDef* I2Cx, FunctionalState NewState)

功能：指定下一个DMA传输是否为最后一个

注释：该位在主接收模式使用， 使得在最后一次接收数据时可以产生一个NACK

例如：I2C_DMALastTransferCmd(I2C1 , ENABLE);

 

7.void I2C_GenerateSTART(I2C_TypeDef* I2Cx, FunctionalState NewState)

功能：生成I2Cx通信起始信号

例如：I2C_GenerateSTART(I2C1 , ENABLE);

 

8.void I2C_GenerateSTOP(I2C_TypeDef* I2Cx, FunctionalState NewState)

功能：生成I2Cx通信停止信号

注释：当设置了STOP、START或PEC位，在硬件清除这个位之前，软件不要执行任何对I2C_CR1的写操作，

           否则有可能会第2次设置STOP、START或PEC位；

           PEC：数据包出错检测 (Packet error checking)

例如：I2C_GenerateSTOP(I2C1 , ENABLE);

 

9.void I2C_AcknowledgeConfig(I2C_TypeDef* I2Cx, FunctionalState NewState)

功能：使能或者失能指定的I2C应答功能

注释：在接收到一个字节后返回一个应答(匹配的地址或数据)

例如：I2C_AcknowledgeConfig(I2C1 , ENABLE);

 

10.void I2C_OwnAddress2Config(I2C_TypeDef* I2Cx, uint8_t Address)

功能：配置指定的I2C自身地址2

注释： I2C_OwnAddress1 在结构体内被赋值；

          双地址模式使能，OAR2才会被识别；

          I2C_OwnAddress_x是STM32设备本身的地址，当STM32作为主设备，不用关心该地址设置，随意设置数即可，

          但是如果STM32作为从设备使用时，必须进行配置

例如：I2C_OwnAddress2Config(I2C1 , 0x7F);

 

11.void I2C_DualAddressCmd(I2C_TypeDef* I2Cx, FunctionalState NewState)

功能：使能双地址模式

注释：双地址模式的使能使得OAR2才会被识别

例如：I2C_DualAddressCmd(I2C1 , ENABLE);

 

12.void I2C_GeneralCallCmd(I2C_TypeDef* I2Cx, FunctionalState NewState)

功能：使能或者失能广播呼叫

注释：以应答还是非应答响应地址00h

例如：I2C_GeneralCallCmd(I2C1 , ENABLE);

 

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

功能：使能或者失能指定的I2C中断

注释：I2C_IT_BUF：缓冲器中断使能          I2C_IT_EVT：事件中断使能          I2C_IT_ERR：出错中断使能

例如：I2C_ITConfig(I2C1 , I2C_IT_BUF);

 

14.void I2C_SendData(I2C_TypeDef* I2Cx, uint8_t Data)

功能：通过I2Cx外设发送数据字节

注释：在从模式下，地址不会被拷贝进数据寄存器DR；

           硬件不管理写冲突(如果TxE=0，仍能写入数据寄存器)；

           如果在处理ACK脉冲时发生ARLO事件，接收到的字节不会被拷贝到数据寄存器里，因此不能读到它

例如：I2C_SendData(I2C1 , 0x01);

 

15.uint8_t I2C_ReceiveData(I2C_TypeDef* I2Cx)

功能：获取I2Cx外设最近接收的数据

注释：注意数据被覆盖的问题

例如：Data = I2C_ReceiveData(I2C1);

 

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

功能：发送地址以选中从设备

注释：同数据发送相同，地址也是数据的一种

例如：I2C_Send7bitAddress(I2C1 , 0xA0 , I2C_Direction_Transmitter);

 

17.uint16_t I2C_ReadRegister(I2C_TypeDef* I2Cx, uint8_t I2C_Register)

功能：读取指定的I2C寄存器并返回其值

例如：Register = I2C_ReadRegister(I2C1 , I2C_Register_CR1);

 

18.void I2C_SoftwareResetCmd(I2C_TypeDef* I2Cx, FunctionalState NewState)

功能：使能或者失能指定的I2C软件重置

注释：该位可以用于总线繁忙（BUSY位为’1’），但是在总线上又没有检测到停止条件时使用

例如：I2C_SoftwareResetCmd(I2C1 , ENABLE);

 

19.void I2C_NACKPositionConfig(I2C_TypeDef* I2Cx, uint16_t I2C_NACKPosition)

功能：在主接收模式下选择指定的I2C NACK位置

          下一个字节是最后一个收到的字节 / 当前字节是最后一个收到的字节

注释：当要接收的数据数量等于2时，这个函数在I2C主接收模式下非常有用；

           在这种情况下，应该在数据接收开始之前调用这个函数(使用参数I2C_NACKPosition_Next)；

           为了NACK第2个字节，必须在清除ADDR位之后清除ACK位；

           该函数配置与I2C_PECPositionConfig相同的寄存器位(POS)，但它用于I2C模式，

           而I2C_PECPositionConfig()用于SMBUS模式

例如：I2C_NACKPositionConfig(I2C1 , I2C_NACKPosition_Next);

 

20.void I2C_SMBusAlertConfig(I2C_TypeDef* I2Cx, uint16_t I2C_SMBusAlert)

功能：为指定的I2C驱动SMBus提醒 (SMBus alert)引脚的高或低

注释：提醒响应地址头紧跟在NACK还是ACK信号后面

例如：I2C_SMBusAlertConfig(I2C1 , I2C_SMBusAlert_Low);

 

21.void I2C_TransmitPEC(I2C_TypeDef* I2Cx, FunctionalState NewState)

功能：使能或者失能指定的I2C PEC传输    （PEC：数据包出错检测 Packet error checking）

注释：配置有无PEC传输；仲裁丢失时，PEC的计算失效

例如：I2C_TransmitPEC(I2C1 , ENABLE);

 

22.void I2C_PECPositionConfig(I2C_TypeDef* I2Cx, uint16_t I2C_PECPosition)

功能：选择指定的I2C PEC位置

注释：指示下一个字节为PEC还是当前字节为PEC；

           POS位只能用在2字节的接收配置中，必须在接收数据之前配置；

           为了NACK第2个字节，必须在清除ADDR位之后清除ACK位；

           为了检测第2个字节的PEC，必须在配置了POS位之后，拉伸ADDR事件时设置PEC位；

           该函数配置了与I2C_NACKPositionConfig()相同的位(POS)，但是用于SMBUS模式，

           而I2C_NACKPositionConfig()用于I2C模式

例如：I2C_PECPositionConfig(I2C1 , I2C_PECPosition_Next);

 

23.void I2C_CalculatePEC(I2C_TypeDef* I2Cx, FunctionalState NewState)

功能：使能或者失能传输字节的PEC值计算

例如：I2C_CalculatePEC(I2C1 , ENABLE);

 

24.uint8_t I2C_GetPEC(I2C_TypeDef* I2Cx)

功能：返回指定I2C的PEC值

注释：当ENPEC=1时，读取PEC[7:0]存放内部的PEC的值

例如：PEC = I2C_GetPEC(I2C1);

 

25.void I2C_ARPCmd(I2C_TypeDef* I2Cx, FunctionalState NewState)

功能：使能或者失能指定的I2C ARP（地址解析协议ARP）

注释：地址解析协议（通过给每个从设备动态地分配一个新的唯一地址，可以解决SMBus的从地址冲突）

例如：I2C_ARPCmd(I2C1 , ENABLE);

 

26.void I2C_StretchClockCmd(I2C_TypeDef* I2Cx, FunctionalState NewState)

功能：使能或者失能指定的I2C时钟时钟延长(从模式)

注释：该位用于当ADDR或BTF标志被置位，在从模式下禁止时钟延长，直到它被软件复位

          BTF：字节发送结束 (Byte transfer finished)

          ADDR：地址已被发送(主模式)/地址匹配(从模式) (Address sent (master mode)/matched (slave mode))

例如：I2C_StretchClockCmd(I2C1 , ENABLE);

 

27.void I2C_FastModeDutyCycleConfig(I2C_TypeDef* I2Cx, uint16_t I2C_DutyCycle)

功能：配置指定的I2C快速模式时的占空比

注释：CCR寄存器只有在关闭I2C时(PE=0)才能设置

例如：I2C_FastModeDutyCycleConfig(I2C1 , I2C_DutyCycle_2);

 

28.下面是三种I2C状态监控函数：

（1）.ErrorStatus I2C_CheckEvent(I2C_TypeDef* I2Cx, uint32_t I2C_EVENT)

基本状态监测

功能：检查最后一个I2Cx事件是否等于作为参数传递的事件

例如：errorstatus = I2C_CheckEvent(I2C1 , I2C_EVENT_SLAVE_TRANSMITTER_ADDRESS_MATCHED);

注释：

 

（2）.uint32_t I2C_GetLastEvent(I2C_TypeDef* I2Cx)

高级状态监控

功能：返回最后一个I2Cx事件

例如：event = I2C_GetLastEvent(I2C1);

注释：

 

（3）.FlagStatus I2C_GetFlagStatus(I2C_TypeDef* I2Cx, uint32_t I2C_FLAG)

基于标志位的状态监控

功能：检查是否设置了指定的I2C标志

例如：flagstatus = I2C_GetFlagStatus(I2C1 , I2C_FLAG_DUALF);

注释：

 

29.void I2C_ClearFlag(I2C_TypeDef* I2Cx, uint32_t I2C_FLAG)

功能：清除I2Cx的挂起标志

例如：I2C_ClearFlag(I2C1 , I2C_FLAG_SMBALERT);

 

30.ITStatus I2C_GetITStatus(I2C_TypeDef* I2Cx, uint32_t I2C_IT)

功能：获取中断标志位，检查指定的I2C中断是否发生

例如：status = I2C_GetITStatus(I2C1 , I2C_IT_SMBALERT);

 

31.void I2C_ClearITPendingBit(I2C_TypeDef* I2Cx, uint32_t I2C_IT)

功能：清除I2Cx的中断挂起位

例如：I2C_ClearITPendingBit(I2C1 , I2C_IT_SMBALERT);