stm32f10x_i2c.h
上传用户:yj_qqy
上传日期:2017-01-28
资源大小:2911k
文件大小:15k
源码类别:

uCOS

开发平台:

C/C++

  1. /******************** (C) COPYRIGHT 2008 STMicroelectronics ********************
  2. * File Name          : stm32f10x_i2c.h
  3. * Author             : MCD Application Team
  4. * Version            : V2.0.2
  5. * Date               : 07/11/2008
  6. * Description        : This file contains all the functions prototypes for the
  7. *                      I2C firmware library.
  8. ********************************************************************************
  9. * THE PRESENT FIRMWARE WHICH IS FOR GUIDANCE ONLY AIMS AT PROVIDING CUSTOMERS
  10. * WITH CODING INFORMATION REGARDING THEIR PRODUCTS IN ORDER FOR THEM TO SAVE TIME.
  11. * AS A RESULT, STMICROELECTRONICS SHALL NOT BE HELD LIABLE FOR ANY DIRECT,
  12. * INDIRECT OR CONSEQUENTIAL DAMAGES WITH RESPECT TO ANY CLAIMS ARISING FROM THE
  13. * CONTENT OF SUCH FIRMWARE AND/OR THE USE MADE BY CUSTOMERS OF THE CODING
  14. * INFORMATION CONTAINED HEREIN IN CONNECTION WITH THEIR PRODUCTS.
  15. *******************************************************************************/
  16. /* Define to prevent recursive inclusion -------------------------------------*/
  17. #ifndef __STM32F10x_I2C_H    
  18. #define __STM32F10x_I2C_H
  19. /* Includes ------------------------------------------------------------------*/
  20. #include "stm32f10x_map.h"
  21. /* Exported types ------------------------------------------------------------*/
  22. /* I2C Init structure definition */
  23. typedef struct
  24. {
  25.   u16 I2C_Mode;
  26.   u16 I2C_DutyCycle;
  27.   u16 I2C_OwnAddress1;
  28.   u16 I2C_Ack;
  29.   u16 I2C_AcknowledgedAddress;
  30.   u32 I2C_ClockSpeed;
  31. }I2C_InitTypeDef;
  32. /* Exported constants --------------------------------------------------------*/
  33. #define IS_I2C_ALL_PERIPH(PERIPH) (((*(u32*)&(PERIPH)) == I2C1_BASE) || 
  34.                                    ((*(u32*)&(PERIPH)) == I2C2_BASE))
  35. /* I2C modes */
  36. #define I2C_Mode_I2C                    ((u16)0x0000)
  37. #define I2C_Mode_SMBusDevice            ((u16)0x0002)
  38. #define I2C_Mode_SMBusHost              ((u16)0x000A)
  39. #define IS_I2C_MODE(MODE) (((MODE) == I2C_Mode_I2C) || 
  40.                            ((MODE) == I2C_Mode_SMBusDevice) || 
  41.                            ((MODE) == I2C_Mode_SMBusHost))
  42. /* I2C duty cycle in fast mode */
  43. #define I2C_DutyCycle_16_9              ((u16)0x4000)
  44. #define I2C_DutyCycle_2                 ((u16)0xBFFF)
  45. #define IS_I2C_DUTY_CYCLE(CYCLE) (((CYCLE) == I2C_DutyCycle_16_9) || 
  46.                                   ((CYCLE) == I2C_DutyCycle_2))
  47. /* I2C cknowledgementy */
  48. #define I2C_Ack_Enable                  ((u16)0x0400)
  49. #define I2C_Ack_Disable                 ((u16)0x0000)
  50. #define IS_I2C_ACK_STATE(STATE) (((STATE) == I2C_Ack_Enable) || 
  51.                                  ((STATE) == I2C_Ack_Disable))
  52. /* I2C transfer direction */
  53. #define  I2C_Direction_Transmitter      ((u8)0x00)
  54. #define  I2C_Direction_Receiver         ((u8)0x01)
  55. #define IS_I2C_DIRECTION(DIRECTION) (((DIRECTION) == I2C_Direction_Transmitter) || 
  56.                                      ((DIRECTION) == I2C_Direction_Receiver))
  57. /* I2C acknowledged address defines */
  58. #define I2C_AcknowledgedAddress_7bit    ((u16)0x4000)
  59. #define I2C_AcknowledgedAddress_10bit   ((u16)0xC000)
  60. #define IS_I2C_ACKNOWLEDGE_ADDRESS(ADDRESS) (((ADDRESS) == I2C_AcknowledgedAddress_7bit) || 
  61.                                              ((ADDRESS) == I2C_AcknowledgedAddress_10bit))
  62. /* I2C registers */
  63. #define I2C_Register_CR1                ((u8)0x00)
  64. #define I2C_Register_CR2                ((u8)0x04)
  65. #define I2C_Register_OAR1               ((u8)0x08)
  66. #define I2C_Register_OAR2               ((u8)0x0C)
  67. #define I2C_Register_DR                 ((u8)0x10)
  68. #define I2C_Register_SR1                ((u8)0x14)
  69. #define I2C_Register_SR2                ((u8)0x18)
  70. #define I2C_Register_CCR                ((u8)0x1C)
  71. #define I2C_Register_TRISE              ((u8)0x20)
  72. #define IS_I2C_REGISTER(REGISTER) (((REGISTER) == I2C_Register_CR1) || 
  73.                                    ((REGISTER) == I2C_Register_CR2) || 
  74.                                    ((REGISTER) == I2C_Register_OAR1) || 
  75.                                    ((REGISTER) == I2C_Register_OAR2) || 
  76.                                    ((REGISTER) == I2C_Register_DR) || 
  77.                                    ((REGISTER) == I2C_Register_SR1) || 
  78.                                    ((REGISTER) == I2C_Register_SR2) || 
  79.                                    ((REGISTER) == I2C_Register_CCR) || 
  80.                                    ((REGISTER) == I2C_Register_TRISE))
  81. /* I2C SMBus alert pin level */
  82. #define I2C_SMBusAlert_Low              ((u16)0x2000)
  83. #define I2C_SMBusAlert_High             ((u16)0xDFFF)
  84. #define IS_I2C_SMBUS_ALERT(ALERT) (((ALERT) == I2C_SMBusAlert_Low) || 
  85.                                    ((ALERT) == I2C_SMBusAlert_High))
  86. /* I2C PEC position */
  87. #define I2C_PECPosition_Next            ((u16)0x0800)
  88. #define I2C_PECPosition_Current         ((u16)0xF7FF)
  89. #define IS_I2C_PEC_POSITION(POSITION) (((POSITION) == I2C_PECPosition_Next) || 
  90.                                        ((POSITION) == I2C_PECPosition_Current))
  91. /* I2C interrupts definition */
  92. #define I2C_IT_BUF                      ((u16)0x0400)
  93. #define I2C_IT_EVT                      ((u16)0x0200)
  94. #define I2C_IT_ERR                      ((u16)0x0100)
  95. #define IS_I2C_CONFIG_IT(IT) ((((IT) & (u16)0xF8FF) == 0x00) && ((IT) != 0x00))
  96. /* I2C interrupts definition */
  97. #define I2C_IT_SMBALERT                 ((u32)0x01008000)
  98. #define I2C_IT_TIMEOUT                  ((u32)0x01004000)
  99. #define I2C_IT_PECERR                   ((u32)0x01001000)
  100. #define I2C_IT_OVR                      ((u32)0x01000800)
  101. #define I2C_IT_AF                       ((u32)0x01000400)
  102. #define I2C_IT_ARLO                     ((u32)0x01000200)
  103. #define I2C_IT_BERR                     ((u32)0x01000100)
  104. #define I2C_IT_TXE                      ((u32)0x06000080)
  105. #define I2C_IT_RXNE                     ((u32)0x06000040)
  106. #define I2C_IT_STOPF                    ((u32)0x02000010)
  107. #define I2C_IT_ADD10                    ((u32)0x02000008)
  108. #define I2C_IT_BTF                      ((u32)0x02000004)
  109. #define I2C_IT_ADDR                     ((u32)0x02000002)
  110. #define I2C_IT_SB                       ((u32)0x02000001)
  111. #define IS_I2C_CLEAR_IT(IT) ((((IT) & (u16)0x20FF) == 0x00) && ((IT) != (u16)0x00))                             
  112. #define IS_I2C_GET_IT(IT) (((IT) == I2C_IT_SMBALERT) || ((IT) == I2C_IT_TIMEOUT) || 
  113.                            ((IT) == I2C_IT_PECERR) || ((IT) == I2C_IT_OVR) || 
  114.                            ((IT) == I2C_IT_AF) || ((IT) == I2C_IT_ARLO) || 
  115.                            ((IT) == I2C_IT_BERR) || ((IT) == I2C_IT_TXE) || 
  116.                            ((IT) == I2C_IT_RXNE) || ((IT) == I2C_IT_STOPF) || 
  117.                            ((IT) == I2C_IT_ADD10) || ((IT) == I2C_IT_BTF) || 
  118.                            ((IT) == I2C_IT_ADDR) || ((IT) == I2C_IT_SB))
  119. /* I2C flags definition */
  120. /* SR2 register flags */
  121. #define I2C_FLAG_DUALF                  ((u32)0x00800000)
  122. #define I2C_FLAG_SMBHOST                ((u32)0x00400000)
  123. #define I2C_FLAG_SMBDEFAULT             ((u32)0x00200000)
  124. #define I2C_FLAG_GENCALL                ((u32)0x00100000)
  125. #define I2C_FLAG_TRA                    ((u32)0x00040000)
  126. #define I2C_FLAG_BUSY                   ((u32)0x00020000)
  127. #define I2C_FLAG_MSL                    ((u32)0x00010000)
  128. /* SR1 register flags */
  129. #define I2C_FLAG_SMBALERT               ((u32)0x10008000)
  130. #define I2C_FLAG_TIMEOUT                ((u32)0x10004000)
  131. #define I2C_FLAG_PECERR                 ((u32)0x10001000)
  132. #define I2C_FLAG_OVR                    ((u32)0x10000800)
  133. #define I2C_FLAG_AF                     ((u32)0x10000400)
  134. #define I2C_FLAG_ARLO                   ((u32)0x10000200)
  135. #define I2C_FLAG_BERR                   ((u32)0x10000100)
  136. #define I2C_FLAG_TXE                    ((u32)0x10000080)
  137. #define I2C_FLAG_RXNE                   ((u32)0x10000040)
  138. #define I2C_FLAG_STOPF                  ((u32)0x10000010)
  139. #define I2C_FLAG_ADD10                  ((u32)0x10000008)
  140. #define I2C_FLAG_BTF                    ((u32)0x10000004)
  141. #define I2C_FLAG_ADDR                   ((u32)0x10000002)
  142. #define I2C_FLAG_SB                     ((u32)0x10000001)
  143.                                
  144. #define IS_I2C_CLEAR_FLAG(FLAG) ((((FLAG) & (u16)0x20FF) == 0x00) && ((FLAG) != (u16)0x00))                                  
  145. #define IS_I2C_GET_FLAG(FLAG) (((FLAG) == I2C_FLAG_DUALF) || ((FLAG) == I2C_FLAG_SMBHOST) || 
  146.                                ((FLAG) == I2C_FLAG_SMBDEFAULT) || ((FLAG) == I2C_FLAG_GENCALL) || 
  147.                                ((FLAG) == I2C_FLAG_TRA) || ((FLAG) == I2C_FLAG_BUSY) || 
  148.                                ((FLAG) == I2C_FLAG_MSL) || ((FLAG) == I2C_FLAG_SMBALERT) || 
  149.                                ((FLAG) == I2C_FLAG_TIMEOUT) || ((FLAG) == I2C_FLAG_PECERR) || 
  150.                                ((FLAG) == I2C_FLAG_OVR) || ((FLAG) == I2C_FLAG_AF) || 
  151.                                ((FLAG) == I2C_FLAG_ARLO) || ((FLAG) == I2C_FLAG_BERR) || 
  152.                                ((FLAG) == I2C_FLAG_TXE) || ((FLAG) == I2C_FLAG_RXNE) || 
  153.                                ((FLAG) == I2C_FLAG_STOPF) || ((FLAG) == I2C_FLAG_ADD10) || 
  154.                                ((FLAG) == I2C_FLAG_BTF) || ((FLAG) == I2C_FLAG_ADDR) || 
  155.                                ((FLAG) == I2C_FLAG_SB))
  156. /* I2C Events */
  157. /* EV1 */
  158. #define  I2C_EVENT_SLAVE_TRANSMITTER_ADDRESS_MATCHED       ((u32)0x00060082) /* TRA, BUSY, TXE and ADDR flags */
  159. #define  I2C_EVENT_SLAVE_RECEIVER_ADDRESS_MATCHED          ((u32)0x00020002) /* BUSY and ADDR flags */
  160. #define  I2C_EVENT_SLAVE_TRANSMITTER_SECONDADDRESS_MATCHED ((u32)0x00860080)  /* DUALF, TRA, BUSY and TXE flags */
  161. #define  I2C_EVENT_SLAVE_RECEIVER_SECONDADDRESS_MATCHED    ((u32)0x00820000)  /* DUALF and BUSY flags */
  162. #define  I2C_EVENT_SLAVE_GENERALCALLADDRESS_MATCHED        ((u32)0x00120000)  /* GENCALL and BUSY flags */
  163. /* EV2 */
  164. #define  I2C_EVENT_SLAVE_BYTE_RECEIVED                     ((u32)0x00020040)  /* BUSY and RXNE flags */
  165.      
  166. /* EV3 */
  167. #define  I2C_EVENT_SLAVE_BYTE_TRANSMITTED                  ((u32)0x00060084)  /* TRA, BUSY, TXE and BTF flags */
  168. /* EV4 */
  169. #define  I2C_EVENT_SLAVE_STOP_DETECTED                     ((u32)0x00000010)  /* STOPF flag */
  170. /* EV5 */
  171. #define  I2C_EVENT_MASTER_MODE_SELECT                      ((u32)0x00030001)  /* BUSY, MSL and SB flag */
  172. /* EV6 */
  173. #define  I2C_EVENT_MASTER_TRANSMITTER_MODE_SELECTED        ((u32)0x00070082)  /* BUSY, MSL, ADDR, TXE and TRA flags */
  174. #define  I2C_EVENT_MASTER_RECEIVER_MODE_SELECTED           ((u32)0x00030002)  /* BUSY, MSL and ADDR flags */
  175. /* EV7 */
  176. #define  I2C_EVENT_MASTER_BYTE_RECEIVED                    ((u32)0x00030040)  /* BUSY, MSL and RXNE flags */
  177. /* EV8 */
  178. #define  I2C_EVENT_MASTER_BYTE_TRANSMITTED                 ((u32)0x00070084)  /* TRA, BUSY, MSL, TXE and BTF flags */
  179.       
  180. /* EV9 */
  181. #define  I2C_EVENT_MASTER_MODE_ADDRESS10                   ((u32)0x00030008)  /* BUSY, MSL and ADD10 flags */
  182.                                           
  183. /* EV3_2 */
  184. #define  I2C_EVENT_SLAVE_ACK_FAILURE                       ((u32)0x00000400)  /* AF flag */
  185. #define IS_I2C_EVENT(EVENT) (((EVENT) == I2C_EVENT_SLAVE_TRANSMITTER_ADDRESS_MATCHED) || 
  186.                              ((EVENT) == I2C_EVENT_SLAVE_RECEIVER_ADDRESS_MATCHED) || 
  187.                              ((EVENT) == I2C_EVENT_SLAVE_TRANSMITTER_SECONDADDRESS_MATCHED) || 
  188.                              ((EVENT) == I2C_EVENT_SLAVE_RECEIVER_SECONDADDRESS_MATCHED) || 
  189.                              ((EVENT) == I2C_EVENT_SLAVE_GENERALCALLADDRESS_MATCHED) || 
  190.                              ((EVENT) == I2C_EVENT_SLAVE_BYTE_RECEIVED) || 
  191.                              ((EVENT) == (I2C_EVENT_SLAVE_BYTE_RECEIVED | I2C_FLAG_DUALF)) || 
  192.                              ((EVENT) == (I2C_EVENT_SLAVE_BYTE_RECEIVED | I2C_FLAG_GENCALL)) || 
  193.                              ((EVENT) == I2C_EVENT_SLAVE_BYTE_TRANSMITTED) || 
  194.                              ((EVENT) == (I2C_EVENT_SLAVE_BYTE_TRANSMITTED | I2C_FLAG_DUALF)) || 
  195.                              ((EVENT) == (I2C_EVENT_SLAVE_BYTE_TRANSMITTED | I2C_FLAG_GENCALL)) || 
  196.                              ((EVENT) == I2C_EVENT_SLAVE_STOP_DETECTED) || 
  197.                              ((EVENT) == I2C_EVENT_MASTER_MODE_SELECT) || 
  198.                              ((EVENT) == I2C_EVENT_MASTER_TRANSMITTER_MODE_SELECTED) || 
  199.                              ((EVENT) == I2C_EVENT_MASTER_RECEIVER_MODE_SELECTED) || 
  200.                              ((EVENT) == I2C_EVENT_MASTER_BYTE_RECEIVED) || 
  201.                              ((EVENT) == I2C_EVENT_MASTER_BYTE_TRANSMITTED) || 
  202.                              ((EVENT) == I2C_EVENT_MASTER_MODE_ADDRESS10) || 
  203.                              ((EVENT) == I2C_EVENT_SLAVE_ACK_FAILURE))
  204. /* I2C own address1 -----------------------------------------------------------*/
  205. #define IS_I2C_OWN_ADDRESS1(ADDRESS1) ((ADDRESS1) <= 0x3FF)
  206. /* I2C clock speed ------------------------------------------------------------*/
  207. #define IS_I2C_CLOCK_SPEED(SPEED) (((SPEED) >= 0x1) && ((SPEED) <= 400000))
  208. /* Exported macro ------------------------------------------------------------*/
  209. /* Exported functions ------------------------------------------------------- */
  210. void I2C_DeInit(I2C_TypeDef* I2Cx);
  211. void I2C_Init(I2C_TypeDef* I2Cx, I2C_InitTypeDef* I2C_InitStruct);
  212. void I2C_StructInit(I2C_InitTypeDef* I2C_InitStruct);
  213. void I2C_Cmd(I2C_TypeDef* I2Cx, FunctionalState NewState);
  214. void I2C_DMACmd(I2C_TypeDef* I2Cx, FunctionalState NewState);
  215. void I2C_DMALastTransferCmd(I2C_TypeDef* I2Cx, FunctionalState NewState);
  216. void I2C_GenerateSTART(I2C_TypeDef* I2Cx, FunctionalState NewState);
  217. void I2C_GenerateSTOP(I2C_TypeDef* I2Cx, FunctionalState NewState);
  218. void I2C_AcknowledgeConfig(I2C_TypeDef* I2Cx, FunctionalState NewState);
  219. void I2C_OwnAddress2Config(I2C_TypeDef* I2Cx, u8 Address);
  220. void I2C_DualAddressCmd(I2C_TypeDef* I2Cx, FunctionalState NewState);
  221. void I2C_GeneralCallCmd(I2C_TypeDef* I2Cx, FunctionalState NewState);
  222. void I2C_ITConfig(I2C_TypeDef* I2Cx, u16 I2C_IT, FunctionalState NewState);
  223. void I2C_SendData(I2C_TypeDef* I2Cx, u8 Data);
  224. u8 I2C_ReceiveData(I2C_TypeDef* I2Cx);
  225. void I2C_Send7bitAddress(I2C_TypeDef* I2Cx, u8 Address, u8 I2C_Direction);
  226. u16 I2C_ReadRegister(I2C_TypeDef* I2Cx, u8 I2C_Register);
  227. void I2C_SoftwareResetCmd(I2C_TypeDef* I2Cx, FunctionalState NewState);
  228. void I2C_SMBusAlertConfig(I2C_TypeDef* I2Cx, u16 I2C_SMBusAlert);
  229. void I2C_TransmitPEC(I2C_TypeDef* I2Cx, FunctionalState NewState);
  230. void I2C_PECPositionConfig(I2C_TypeDef* I2Cx, u16 I2C_PECPosition);
  231. void I2C_CalculatePEC(I2C_TypeDef* I2Cx, FunctionalState NewState);
  232. u8 I2C_GetPEC(I2C_TypeDef* I2Cx);
  233. void I2C_ARPCmd(I2C_TypeDef* I2Cx, FunctionalState NewState);
  234. void I2C_StretchClockCmd(I2C_TypeDef* I2Cx, FunctionalState NewState);
  235. void I2C_FastModeDutyCycleConfig(I2C_TypeDef* I2Cx, u16 I2C_DutyCycle);
  236. u32 I2C_GetLastEvent(I2C_TypeDef* I2Cx);
  237. ErrorStatus I2C_CheckEvent(I2C_TypeDef* I2Cx, u32 I2C_EVENT);
  238. FlagStatus I2C_GetFlagStatus(I2C_TypeDef* I2Cx, u32 I2C_FLAG);
  239. void I2C_ClearFlag(I2C_TypeDef* I2Cx, u32 I2C_FLAG);
  240. ITStatus I2C_GetITStatus(I2C_TypeDef* I2Cx, u32 I2C_IT);
  241. void I2C_ClearITPendingBit(I2C_TypeDef* I2Cx, u32 I2C_IT);
  242. #endif /*__STM32F10x_I2C_H */
  243. /******************* (C) COPYRIGHT 2008 STMicroelectronics *****END OF FILE****/