01. I2C简介
, S+ E9 e3 V( k' y& YI2C（内部集成电路）总线接口用作微控制器和 I2C 串行总线之间的接口。它提供多主模式功能，可以控制所有I2C总线特定的序列、协议、仲裁和时序。它支持标准和快速模式。它还与 SMBus 2.0 兼容。

它可以用于多种用途，包括 CRC 生成和验证、SMBus（系统管理总线）以及 PMBus（电源管理总线）。

- R2 B, j7 }& R/ \) e) p# S根据器件的不同，可利用 DMA 功能来减轻 CPU 的工作量。

02. 相关类型
7 e0 A! `! r: p$ ?; v" P$ XI2C Init structure

1. /**
   1 n. X+ V- ^8 p; d9 Q
2.   * @brief  I2C Init structure definition  
   ; Q5 \' L0 W( {1 n2 r
3.   */
   0 M' ^8 q) E, O
4. 
   7 K+ F6 n, n' X
5. typedef struct
   : P) F. g' m- v7 s  ^" f0 S" B, \
6. {
   
7.   uint32_t I2C_ClockSpeed;          /*!< Specifies the clock frequency.
   
8.                                          This parameter must be set to a value lower than 400kHz */
   
9. 
   ) H7 x# w: F  l
10.   uint16_t I2C_Mode;                /*!< Specifies the I2C mode.
    + b% a, `! H/ c8 t! z
11.                                          This parameter can be a value of @ref I2C_mode */
    ! A) x$ e$ H/ s4 x( `- K: N6 u
12. 
    
13.   uint16_t I2C_DutyCycle;           /*!< Specifies the I2C fast mode duty cycle.
    + Q( D& }4 n' U2 K* ~) \  }! }
14.                                          This parameter can be a value of @ref I2C_duty_cycle_in_fast_mode */
    7 m7 k2 D, L% p# u$ g4 c7 ~" A7 t% B
15. 
    1 g  t: G7 d; x7 `5 a  e9 ?
16.   uint16_t I2C_OwnAddress1;         /*!< Specifies the first device own address.
    - G. R" k: k1 c6 T- Y* S. ]
17.                                          This parameter can be a 7-bit or 10-bit address. */
    
18. 
    
19.   uint16_t I2C_Ack;                 /*!< Enables or disables the acknowledgement.
    
20.                                          This parameter can be a value of @ref I2C_acknowledgement */
    * [  I  `9 U, i
21. 
    
22.   uint16_t I2C_AcknowledgedAddress; /*!< Specifies if 7-bit or 10-bit address is acknowledged.
    
23.                                          This parameter can be a value of @ref I2C_acknowledged_address */
    1 z* R8 X1 O) b) S) @# Y4 [
24. }I2C_InitTypeDef;

复制代码

I2C_Exported_Constants

9 K" U. ^. l. ^- c* q+ w# l: v! _

1. 
   8 _) Y  b$ B+ N3 w2 O8 Y
2. /** @defgroup I2C_Exported_Constants
   2 L% N5 ^# j. x0 |
3.   * @{
   
4.   */
   ( V/ F$ C' j4 p. B8 c) S9 E( X
5. #define IS_I2C_ALL_PERIPH(PERIPH) (((PERIPH) == I2C1) || \
   
6.                                    ((PERIPH) == I2C2) || \
   
7.                                    ((PERIPH) == I2C3))
   
8. /** @defgroup I2C_Digital_Filter
   
9.   * @{
   * O6 h( e; S' w8 H
10.   */
    
11. 
    & S9 W* |/ z2 o/ i
12. #define IS_I2C_DIGITAL_FILTER(FILTER)   ((FILTER) <= 0x0000000F)
    8 s, }6 F) q$ C. D" I9 H. L/ Q
13. /**
      Z$ b( @) I; y2 S" n6 ^+ N: w. Q
14.   * @}
    
15.   */

复制代码

I2C_mode

1. /** @defgroup I2C_mode
   
2.   * @{
   
3.   */
   
4. 
   , d4 |- J" u5 G7 v  o# l
5. #define I2C_Mode_I2C                    ((uint16_t)0x0000)
   
6. #define I2C_Mode_SMBusDevice            ((uint16_t)0x0002)  
   - y: t- J' {% i( c. C3 Y0 K
7. #define I2C_Mode_SMBusHost              ((uint16_t)0x000A)
     W- U2 U" }) v4 V1 l
8. #define IS_I2C_MODE(MODE) (((MODE) == I2C_Mode_I2C) || \
   8 J& b# E1 U/ _) p) E* c' G5 s
9.                            ((MODE) == I2C_Mode_SMBusDevice) || \
   1 l" _) H* G* |6 {
10.                            ((MODE) == I2C_Mode_SMBusHost))

复制代码

; }% y/ r% U+ ]& x. \: xI2C_duty_cycle_in_fast_mode

' d0 S0 R7 J& K

1. /** @defgroup I2C_duty_cycle_in_fast_mode
   
2.   * @{
   + I1 P; ~: t; T: c2 h
3.   */
   $ z! u( g; X+ a- b8 W
4. 
   
5. #define I2C_DutyCycle_16_9              ((uint16_t)0x4000) /*!< I2C fast mode Tlow/Thigh = 16/9 */
   % h6 R2 P) ~* j! @' w
6. #define I2C_DutyCycle_2                 ((uint16_t)0xBFFF) /*!< I2C fast mode Tlow/Thigh = 2 */
   
7. #define IS_I2C_DUTY_CYCLE(CYCLE) (((CYCLE) == I2C_DutyCycle_16_9) || \
   
8.                                   ((CYCLE) == I2C_DutyCycle_2))

复制代码

) ?1 _. }+ G8 h$ VI2C_acknowledgement

& Q% ~( ~7 t# D# J' \% D) j* A

1. /** @defgroup I2C_acknowledgement
   
2.   * @{
   
3.   */
   ; _6 {) p* g( L" C" E6 g0 p
4. 
   
5. #define I2C_Ack_Enable                  ((uint16_t)0x0400)
   
6. #define I2C_Ack_Disable                 ((uint16_t)0x0000)
   8 b9 {7 k6 Q3 M3 S4 m
7. #define IS_I2C_ACK_STATE(STATE) (((STATE) == I2C_Ack_Enable) || \
   
8.                                  ((STATE) == I2C_Ack_Disable))

复制代码

I2C_transfer_direction
1 z* {( s4 b3 _% A% y

1. /** @defgroup I2C_transfer_direction
   
2.   * @{
   
3.   */
   
4. 
   * V. J8 F' {7 O
5. #define  I2C_Direction_Transmitter      ((uint8_t)0x00)
   7 ~& Y8 }! A& V& N; F' X
6. #define  I2C_Direction_Receiver         ((uint8_t)0x01)
   
7. #define IS_I2C_DIRECTION(DIRECTION) (((DIRECTION) == I2C_Direction_Transmitter) || \
   
8.                                      ((DIRECTION) == I2C_Direction_Receiver))

复制代码

I2C_acknowledged_address
, G+ _. a1 m& B, r# s& v% }8 m

1. /** @defgroup I2C_acknowledged_address
   % }0 Z& O8 \* R3 z( F
2.   * @{
   
3.   */
   + @  o) G/ l& p6 p+ _
4. 
   % i: \: j8 G0 ^# {4 H
5. #define I2C_AcknowledgedAddress_7bit    ((uint16_t)0x4000)
   
6. #define I2C_AcknowledgedAddress_10bit   ((uint16_t)0xC000)
   $ c. L$ ?8 @- [; F
7. #define IS_I2C_ACKNOWLEDGE_ADDRESS(ADDRESS) (((ADDRESS) == I2C_AcknowledgedAddress_7bit) || \
   
8.                                              ((ADDRESS) == I2C_AcknowledgedAddress_10bit))

复制代码

4 t( d  I5 l' U. jI2C_registers
! V+ m3 |6 T) G0 y. A

1. /** @defgroup I2C_registers
   
2.   * @{
   
3.   */
   
4. 
   9 x# ~6 {( I$ h6 T% o1 l; n3 f
5. #define I2C_Register_CR1                ((uint8_t)0x00)
   
6. #define I2C_Register_CR2                ((uint8_t)0x04)
   + t! P8 T6 G2 i# A3 P' L7 }) g
7. #define I2C_Register_OAR1               ((uint8_t)0x08)
   
8. #define I2C_Register_OAR2               ((uint8_t)0x0C)
   ' i4 G* Z) M, M* q( O% n
9. #define I2C_Register_DR                 ((uint8_t)0x10)
   
10. #define I2C_Register_SR1                ((uint8_t)0x14)
    - ~2 Z+ d7 E. x  @" y  ]
11. #define I2C_Register_SR2                ((uint8_t)0x18)
    " O9 x0 d- M6 p2 J/ j
12. #define I2C_Register_CCR                ((uint8_t)0x1C)
    
13. #define I2C_Register_TRISE              ((uint8_t)0x20)
    
14. #define IS_I2C_REGISTER(REGISTER) (((REGISTER) == I2C_Register_CR1) || \
    
15.                                    ((REGISTER) == I2C_Register_CR2) || \
    ( j& v: @  x0 V% W
16.                                    ((REGISTER) == I2C_Register_OAR1) || \
    
17.                                    ((REGISTER) == I2C_Register_OAR2) || \
    
18.                                    ((REGISTER) == I2C_Register_DR) || \
    6 o7 _& w( Z) X5 U# n
19.                                    ((REGISTER) == I2C_Register_SR1) || \
    
20.                                    ((REGISTER) == I2C_Register_SR2) || \
    
21.                                    ((REGISTER) == I2C_Register_CCR) || \
    + N1 n0 o$ [% U& m$ G" B6 I+ N
22.                                    ((REGISTER) == I2C_Register_TRISE))

复制代码

I2C_NACK_position

1. /** @defgroup I2C_NACK_position
   - p  D3 m4 |$ E/ a
2.   * @{
   
3.   */
   
4. 
   
5. #define I2C_NACKPosition_Next           ((uint16_t)0x0800)
   
6. #define I2C_NACKPosition_Current        ((uint16_t)0xF7FF)
   
7. #define IS_I2C_NACK_POSITION(POSITION)  (((POSITION) == I2C_NACKPosition_Next) || \
   ! H8 W% @0 k9 W! t1 r/ {
8.                                          ((POSITION) == I2C_NACKPosition_Current))

复制代码

I2C_SMBus_alert_pin_level
9 p2 Z" C. ?" I6 M# f
9 B  i4 U& K1 q5 e+ ~

1. /** @defgroup I2C_SMBus_alert_pin_level
   + W* I% J$ D6 r1 h! j% M
2.   * @{
   # l; ^0 A2 v; B' r
3.   */
   
4. 
   - y# ]' a- \) P2 B
5. #define I2C_SMBusAlert_Low              ((uint16_t)0x2000)
   & H3 W. \( X: N! i; O
6. #define I2C_SMBusAlert_High             ((uint16_t)0xDFFF)
   
7. #define IS_I2C_SMBUS_ALERT(ALERT) (((ALERT) == I2C_SMBusAlert_Low) || \
   
8.                                    ((ALERT) == I2C_SMBusAlert_High))

复制代码

I2C_PEC_position
% b! r- L* B% x* d
' m$ H5 g$ o: K2 B+ c7 H  |

1. /** @defgroup I2C_PEC_position
   
2.   * @{
   3 E- `; T3 F7 d+ l/ H9 O
3.   */
   
4. 
   + h! `5 G2 {- U/ o% d/ x
5. #define I2C_PECPosition_Next            ((uint16_t)0x0800)
   
6. #define I2C_PECPosition_Current         ((uint16_t)0xF7FF)
   1 l( H; c: ]+ G- j; L7 B2 l
7. #define IS_I2C_PEC_POSITION(POSITION) (((POSITION) == I2C_PECPosition_Next) || \
   
8.                                        ((POSITION) == I2C_PECPosition_Current))

复制代码

I2C_interrupts_definition
# ?0 N# ]" j+ n/ Z# q
% d0 N4 l! M' h3 [/ E2 Z

1. /** @defgroup I2C_interrupts_definition
   * v; ?$ D6 V- j. T# |4 N
2.   * @{
   
3.   */
   5 W# N# z  ]" x
4. 
   + ~" }* {0 M/ ^
5. #define I2C_IT_BUF                      ((uint16_t)0x0400)
   
6. #define I2C_IT_EVT                      ((uint16_t)0x0200)
   
7. #define I2C_IT_ERR                      ((uint16_t)0x0100)
   8 e* y( O1 |9 v9 F( @, y; l
8. #define IS_I2C_CONFIG_IT(IT) ((((IT) & (uint16_t)0xF8FF) == 0x00) && ((IT) != 0x00))

复制代码

9 b/ }# v. ^# U7 @/ o+ sI2C_interrupts_definition
3 ?2 A2 q+ {6 H! k' s( ?! z
: u& {! j6 c& P9 o9 _

1. /** @defgroup I2C_interrupts_definition
   
2.   * @{
   
3.   */
   / c# h% j. L9 z2 ^
4. 
   
5. #define I2C_IT_SMBALERT                 ((uint32_t)0x01008000)
   / F3 x8 l2 u- |, Q( M+ H
6. #define I2C_IT_TIMEOUT                  ((uint32_t)0x01004000)
   
7. #define I2C_IT_PECERR                   ((uint32_t)0x01001000)
   
8. #define I2C_IT_OVR                      ((uint32_t)0x01000800)
   0 j+ Q8 M( d- G. R2 H9 n8 R
9. #define I2C_IT_AF                       ((uint32_t)0x01000400)
   
10. #define I2C_IT_ARLO                     ((uint32_t)0x01000200)
    . M3 j0 \- h7 d: k0 d
11. #define I2C_IT_BERR                     ((uint32_t)0x01000100)
    
12. #define I2C_IT_TXE                      ((uint32_t)0x06000080)
    
13. #define I2C_IT_RXNE                     ((uint32_t)0x06000040)
    % B7 Y" l+ Q9 C) s6 R, H
14. #define I2C_IT_STOPF                    ((uint32_t)0x02000010)
    # F+ p& Z" r6 p7 Q6 v
15. #define I2C_IT_ADD10                    ((uint32_t)0x02000008)
    
16. #define I2C_IT_BTF                      ((uint32_t)0x02000004)
    4 e1 {& v3 b$ H4 `( W
17. #define I2C_IT_ADDR                     ((uint32_t)0x02000002)
    & ^* b1 w8 B* }+ T
18. #define I2C_IT_SB                       ((uint32_t)0x02000001)
    
19. 
    
20. #define IS_I2C_CLEAR_IT(IT) ((((IT) & (uint16_t)0x20FF) == 0x00) && ((IT) != (uint16_t)0x00))
    0 M' q" o5 c4 T8 [! Y/ L
21. 
    ; `/ d# @2 y  p" [4 e
22. #define IS_I2C_GET_IT(IT) (((IT) == I2C_IT_SMBALERT) || ((IT) == I2C_IT_TIMEOUT) || \
    
23.                            ((IT) == I2C_IT_PECERR) || ((IT) == I2C_IT_OVR) || \
    + p1 ?( S2 ~/ u- s& B3 |
24.                            ((IT) == I2C_IT_AF) || ((IT) == I2C_IT_ARLO) || \
    2 h) C& g. V; n* ^& U% w5 Y) a
25.                            ((IT) == I2C_IT_BERR) || ((IT) == I2C_IT_TXE) || \
    
26.                            ((IT) == I2C_IT_RXNE) || ((IT) == I2C_IT_STOPF) || \
      Y4 o+ ^$ C2 F+ d2 ?& E+ b
27.                            ((IT) == I2C_IT_ADD10) || ((IT) == I2C_IT_BTF) || \
    , M; N* @3 j7 _% d3 {- x
28.                            ((IT) == I2C_IT_ADDR) || ((IT) == I2C_IT_SB))

复制代码

0 ^- [' s' o  e8 XSR2 register flags

/ u2 H4 x1 H5 `' N; g! e5 l1 K

1. /**
   - ?( p3 H9 j4 D* h) D7 f% H0 m0 Y
2.   * @brief  SR2 register flags  
   + G$ z( l9 L$ A3 I8 l, f/ y
3.   */
   2 D- _/ r0 C4 [0 p& [& b
4. 
   
5. #define I2C_FLAG_DUALF                  ((uint32_t)0x00800000)
   5 j; P5 W% }# N
6. #define I2C_FLAG_SMBHOST                ((uint32_t)0x00400000)
   9 J2 G# s/ g# P8 h! a, E
7. #define I2C_FLAG_SMBDEFAULT             ((uint32_t)0x00200000)
   ( q5 G5 ~  r" |
8. #define I2C_FLAG_GENCALL                ((uint32_t)0x00100000)
   * i* ~- \; t1 `% F
9. #define I2C_FLAG_TRA                    ((uint32_t)0x00040000)
   # K: y2 @3 l! ?- O; h$ z
10. #define I2C_FLAG_BUSY                   ((uint32_t)0x00020000)
    ; a; c2 Z0 h4 {1 }1 E
11. #define I2C_FLAG_MSL                    ((uint32_t)0x00010000)

复制代码

SR1 register flags

2 B/ K8 s* g7 S+ m( l

1. /**
   8 k9 h9 U. ~' o. V* Y) k
2.   * @brief  SR1 register flags  
   
3.   */
   " y8 ]- n' Q+ C  [& i4 x
4. 
   
5. #define I2C_FLAG_SMBALERT               ((uint32_t)0x10008000)
   
6. #define I2C_FLAG_TIMEOUT                ((uint32_t)0x10004000)
   9 x- n7 E2 T# q+ Q
7. #define I2C_FLAG_PECERR                 ((uint32_t)0x10001000)
   0 Y: S4 e& }" \. `: E- {
8. #define I2C_FLAG_OVR                    ((uint32_t)0x10000800)
   
9. #define I2C_FLAG_AF                     ((uint32_t)0x10000400)
   
10. #define I2C_FLAG_ARLO                   ((uint32_t)0x10000200)
    
11. #define I2C_FLAG_BERR                   ((uint32_t)0x10000100)
    
12. #define I2C_FLAG_TXE                    ((uint32_t)0x10000080)
    
13. #define I2C_FLAG_RXNE                   ((uint32_t)0x10000040)
    
14. #define I2C_FLAG_STOPF                  ((uint32_t)0x10000010)
    
15. #define I2C_FLAG_ADD10                  ((uint32_t)0x10000008)
    
16. #define I2C_FLAG_BTF                    ((uint32_t)0x10000004)
    
17. #define I2C_FLAG_ADDR                   ((uint32_t)0x10000002)
    / v' U+ h$ ?2 v: V0 ^
18. #define I2C_FLAG_SB                     ((uint32_t)0x10000001)
    2 S# L6 q# L2 o) Y7 @) R" B
19. 
    . k4 |) ?* j; S+ R( |: y
20. #define IS_I2C_CLEAR_FLAG(FLAG) ((((FLAG) & (uint16_t)0x20FF) == 0x00) && ((FLAG) != (uint16_t)0x00))
    
21. 
    
22. #define IS_I2C_GET_FLAG(FLAG) (((FLAG) == I2C_FLAG_DUALF) || ((FLAG) == I2C_FLAG_SMBHOST) || \
    
23.                                ((FLAG) == I2C_FLAG_SMBDEFAULT) || ((FLAG) == I2C_FLAG_GENCALL) || \
    
24.                                ((FLAG) == I2C_FLAG_TRA) || ((FLAG) == I2C_FLAG_BUSY) || \
    
25.                                ((FLAG) == I2C_FLAG_MSL) || ((FLAG) == I2C_FLAG_SMBALERT) || \
    
26.                                ((FLAG) == I2C_FLAG_TIMEOUT) || ((FLAG) == I2C_FLAG_PECERR) || \
    - q4 i6 z8 u- P- e8 h; R
27.                                ((FLAG) == I2C_FLAG_OVR) || ((FLAG) == I2C_FLAG_AF) || \
    * I6 t( A' l* s
28.                                ((FLAG) == I2C_FLAG_ARLO) || ((FLAG) == I2C_FLAG_BERR) || \
    
29.                                ((FLAG) == I2C_FLAG_TXE) || ((FLAG) == I2C_FLAG_RXNE) || \
    2 W2 F, l$ r) Z( g7 a
30.                                ((FLAG) == I2C_FLAG_STOPF) || ((FLAG) == I2C_FLAG_ADD10) || \
    
31.                                ((FLAG) == I2C_FLAG_BTF) || ((FLAG) == I2C_FLAG_ADDR) || \
    0 ?9 l- w4 L, m* X- C) V+ y- r
32.                                ((FLAG) == I2C_FLAG_SB))

复制代码

% P* R; v+ \9 @; h03. 相关函数
4 h6 K# o4 G( i; l0 P

1. /*  Function used to set the I2C configuration to the default reset state *****/
   ; ^+ X% Q4 c+ ^1 q( u! T
2. void I2C_DeInit(I2C_TypeDef* I2Cx);
   " {: y" J( [0 c, [+ Y
3. 
   ' X9 p0 H8 d+ Q4 \( R' b: ]2 E6 u! S
4. /* Initialization and Configuration functions *********************************/
   0 b3 K6 c6 E# T
5. void I2C_Init(I2C_TypeDef* I2Cx, I2C_InitTypeDef* I2C_InitStruct);
   
6. void I2C_StructInit(I2C_InitTypeDef* I2C_InitStruct);
   8 e6 m. S( x; S8 g: n* W; U
7. void I2C_Cmd(I2C_TypeDef* I2Cx, FunctionalState NewState);
   " h; g4 l1 ?' ~2 O$ b% Y" Q8 I4 i2 d
8. void I2C_DigitalFilterConfig(I2C_TypeDef* I2Cx, uint16_t I2C_DigitalFilter);
   # y" l/ @6 L; R# f" i+ M* Z6 U
9. void I2C_AnalogFilterCmd(I2C_TypeDef* I2Cx, FunctionalState NewState);
   
10. void I2C_GenerateSTART(I2C_TypeDef* I2Cx, FunctionalState NewState);
    0 |7 e/ d, z, ~/ E2 C. u, k# @
11. void I2C_GenerateSTOP(I2C_TypeDef* I2Cx, FunctionalState NewState);
    # [$ ?: s0 j' k+ S4 _
12. void I2C_Send7bitAddress(I2C_TypeDef* I2Cx, uint8_t Address, uint8_t I2C_Direction);
      k1 l0 Q$ R0 ~3 @% I+ P! q  k$ P
13. void I2C_AcknowledgeConfig(I2C_TypeDef* I2Cx, FunctionalState NewState);
    4 t2 c$ q$ f9 |) `! @! t0 V
14. void I2C_OwnAddress2Config(I2C_TypeDef* I2Cx, uint8_t Address);
    
15. void I2C_DualAddressCmd(I2C_TypeDef* I2Cx, FunctionalState NewState);
      x- v5 x/ K" j7 A
16. void I2C_GeneralCallCmd(I2C_TypeDef* I2Cx, FunctionalState NewState);
    4 z0 x& a8 I5 W& A* t  x) b% Y
17. void I2C_SoftwareResetCmd(I2C_TypeDef* I2Cx, FunctionalState NewState);
    
18. void I2C_StretchClockCmd(I2C_TypeDef* I2Cx, FunctionalState NewState);
    
19. void I2C_FastModeDutyCycleConfig(I2C_TypeDef* I2Cx, uint16_t I2C_DutyCycle);
    
20. void I2C_NACKPositionConfig(I2C_TypeDef* I2Cx, uint16_t I2C_NACKPosition);
    
21. void I2C_SMBusAlertConfig(I2C_TypeDef* I2Cx, uint16_t I2C_SMBusAlert);
    
22. void I2C_ARPCmd(I2C_TypeDef* I2Cx, FunctionalState NewState);
    ; Y$ Y* c" @% {$ R1 _
23. 
    / N8 E* O+ \6 d  s0 F3 i3 n
24. /* Data transfers functions ***************************************************/
    & K( \1 U! W$ v- M% ]& B# c
25. void I2C_SendData(I2C_TypeDef* I2Cx, uint8_t Data);
    
26. uint8_t I2C_ReceiveData(I2C_TypeDef* I2Cx);
    " Y) T5 |6 a1 H5 j: @- F& @
27. 
      G+ ]6 [9 @1 H; B5 x
28. /* PEC management functions ***************************************************/
    : R1 B5 K% E- c9 O0 g
29. void I2C_TransmitPEC(I2C_TypeDef* I2Cx, FunctionalState NewState);
    ! _; S0 ]& W# w# `+ s, d
30. void I2C_PECPositionConfig(I2C_TypeDef* I2Cx, uint16_t I2C_PECPosition);
    
31. void I2C_CalculatePEC(I2C_TypeDef* I2Cx, FunctionalState NewState);
    * G4 K* ?0 y$ t. m9 _
32. uint8_t I2C_GetPEC(I2C_TypeDef* I2Cx);
    
33. 
    * s( Z$ O- T, a# ?
34. /* DMA transfers management functions *****************************************/
    
35. void I2C_DMACmd(I2C_TypeDef* I2Cx, FunctionalState NewState);
    
36. void I2C_DMALastTransferCmd(I2C_TypeDef* I2Cx, FunctionalState NewState);
    / Y, E) T! B! Z. S7 U; h6 ^
37. 
    
38. /* Interrupts, events and flags management functions **************************/
    
39. uint16_t I2C_ReadRegister(I2C_TypeDef* I2Cx, uint8_t I2C_Register);
    # T/ e% x  z3 @6 l; N& x: U7 \
40. void I2C_ITConfig(I2C_TypeDef* I2Cx, uint16_t I2C_IT, FunctionalState NewState);
    
41. 
    
42. /*
    
43. ===============================================================================
    
44.                           I2C State Monitoring Functions
    
45. ===============================================================================
    
46.   This I2C driver provides three different ways for I2C state monitoring
    4 F# T0 O$ C% l  Z, w) r/ @* M
47.   depending on the application requirements and constraints:
    
48. 
    : W' P' d( O7 d6 m. f# M
49. 
    
50.      1. Basic state monitoring (Using I2C_CheckEvent() function)
    3 f2 \0 P( {7 Y' e. S% U, S
51.      -----------------------------------------------------------
    
52.         It compares the status registers (SR1 and SR2) content to a given event
    : y$ s* |; ?8 r$ f) b& a2 C/ S
53.         (can be the combination of one or more flags).
    
54.         It returns SUCCESS if the current status includes the given flags
    ' j, }4 s% I$ H/ i7 n& Z% D" m3 G3 ^" n
55.         and returns ERROR if one or more flags are missing in the current status.
    
56. 
    
57.           - When to use
    5 |! C6 R- _  T- `0 {' N- N' h0 v
58.              - This function is suitable for most applications as well as for startup
    
59.                activity since the events are fully described in the product reference
    ; i, f1 P& e% |  F" {
60.                manual (RM0090).
    7 i8 [, s- \/ q$ U. @
61.              - It is also suitable for users who need to define their own events.
    8 [$ a/ }* {/ D5 z+ g
62. 
    
63.           - Limitations
    + p1 z$ Z9 a+ h$ B, O3 a; d, X
64.              - If an error occurs (ie. error flags are set besides to the monitored
    . G. w0 K. P" _
65.                flags), the I2C_CheckEvent() function may return SUCCESS despite
    ' \( w* O. L5 P) s" @
66.                the communication hold or corrupted real state.
    
67.                In this case, it is advised to use error interrupts to monitor
    , E: K1 g3 w9 ^: i! z
68.                the error events and handle them in the interrupt IRQ handler.
    1 v1 d. h) E  i! `3 e, W& f
69. 
    
70.      Note
    ' _, H- @% K$ |& i: d; k0 E: r
71.          For error management, it is advised to use the following functions:
    
72.            - I2C_ITConfig() to configure and enable the error interrupts (I2C_IT_ERR).
    
73.            - I2Cx_ER_IRQHandler() which is called when the error interrupt occurs.
    
74.              Where x is the peripheral instance (I2C1, I2C2 ...)
    
75.            - I2C_GetFlagStatus() or I2C_GetITStatus()  to be called into the
    9 U0 h: h+ b. ]# p6 [- T
76.              I2Cx_ER_IRQHandler() function in order to determine which error occurred.
    
77.            - I2C_ClearFlag() or I2C_ClearITPendingBit() and/or I2C_SoftwareResetCmd()
    ) j; {4 p& w: V4 U8 \" I
78.              and/or I2C_GenerateStop() in order to clear the error flag and source
    0 S9 @/ }8 c7 Z0 y
79.              and return to correct  communication status.
    8 F0 W3 s2 h5 [! A
80. 
    
81. 
    
82.      2. Advanced state monitoring (Using the function I2C_GetLastEvent())
    & e: p: q) s) W. h' h
83.      --------------------------------------------------------------------
    0 a% U. T& K" q2 t
84.         Using the function I2C_GetLastEvent() which returns the image of both status
    7 S# A+ U, v1 `8 A" G1 z6 w
85.         registers in a single word (uint32_t) (Status Register 2 value is shifted left
    4 N  `& ]  h3 X9 y
86.         by 16 bits and concatenated to Status Register 1).
    % c5 y5 r1 a$ b
87. 
    
88.           - When to use
    
89.              - This function is suitable for the same applications above but it
    
90.                allows to overcome the mentioned limitation of I2C_GetFlagStatus()
    ! m% J( x6 R  v) x
91.                function.
    ; h( b2 M8 [8 w* P
92.              - The returned value could be compared to events already defined in
    2 Z2 `# p: W) f6 i7 I& I' j  L8 }3 J
93.                this file or to custom values defined by user.
    
94.                This function is suitable when multiple flags are monitored at the
    
95.                same time.
    5 J7 K' ^! V5 ^8 t) b. H
96.              - At the opposite of I2C_CheckEvent() function, this function allows
    
97.                user to choose when an event is accepted (when all events flags are
    ) J7 `& r4 V) E1 X3 T* f
98.                set and no other flags are set or just when the needed flags are set
    
99.                like I2C_CheckEvent() function.
    
100. 
     + ^. N! \1 R( n0 \' r3 ]8 w% B
101.           - Limitations
     
102.              - User may need to define his own events.
     
103.              - Same remark concerning the error management is applicable for this
     . I- ?6 _; t" ]' z
104.                function if user decides to check only regular communication flags
     
105.                (and ignores error flags).
     9 k% ~6 d. s* I4 w+ Y0 ^- m
106. 
     
107. 
     ' i' L$ T" @/ j  j5 Y
108.      3. Flag-based state monitoring (Using the function I2C_GetFlagStatus())
     5 q5 \9 v; k' J/ d9 y7 B6 O
109.      -----------------------------------------------------------------------
     
110. 
     ) S; Z; P# ]7 _) k! S* Y, E3 b
111.       Using the function I2C_GetFlagStatus() which simply returns the status of
     
112.       one single flag (ie. I2C_FLAG_RXNE ...).
     
113. 
     5 s; S4 Z! c/ Y+ h" P
114.           - When to use
     ! q: w1 G$ a9 z* d
115.              - This function could be used for specific applications or in debug
     
116.                phase.
     
117.              - It is suitable when only one flag checking is needed (most I2C
     
118.                events are monitored through multiple flags).
     ; e: A# e/ M3 T4 V) F7 i
119.           - Limitations:
     & a: H8 ]' |4 {0 P2 _
120.              - When calling this function, the Status register is accessed.
     
121.                Some flags are cleared when the status register is accessed.
     $ v3 m& ]4 x1 Q4 s0 ]1 {
122.                So checking the status of one Flag, may clear other ones.
     
123.              - Function may need to be called twice or more in order to monitor
     9 u1 b0 h# P2 D3 o
124.                one single event.           
       J1 f( \9 }3 n# c. }$ E
125. */
     * ^/ [7 |1 e( O1 o/ P
126. 
     5 ~' }, I/ B. A8 r
127. /*
     $ G$ n4 d9 M( i! t  t3 I
128. ===============================================================================
     
129.                           1. Basic state monitoring
     
130. ===============================================================================
     
131. */
     ) ~7 D1 I5 w, A
132. ErrorStatus I2C_CheckEvent(I2C_TypeDef* I2Cx, uint32_t I2C_EVENT);
     ) q, L- C/ W. U" o* [/ o- Z
133. /*
     7 P* O# h5 }; l) I. g; l2 D
134. ===============================================================================
     % X% ^0 o% e. d' P7 n: e7 C- D
135.                           2. Advanced state monitoring
     
136. ===============================================================================
     % w0 b+ d1 e, o4 }: P! Y% n
137. */
     : i% l* }- r5 G+ u0 B# _( {: }7 W7 p
138. uint32_t I2C_GetLastEvent(I2C_TypeDef* I2Cx);
     : k2 t1 ^! a( ]$ B
139. /*
     2 f) @- Y  k* X$ u
140. ===============================================================================
     
141.                           3. Flag-based state monitoring
     
142. ===============================================================================
     
143. */
     
144. FlagStatus I2C_GetFlagStatus(I2C_TypeDef* I2Cx, uint32_t I2C_FLAG);
     
145. 
     
146. 
     
147. void I2C_ClearFlag(I2C_TypeDef* I2Cx, uint32_t I2C_FLAG);
     . u7 X1 M; F# M0 x2 ~6 m
148. ITStatus I2C_GetITStatus(I2C_TypeDef* I2Cx, uint32_t I2C_IT);
     # L. x! h( C7 W+ b5 a4 U/ y4 s
149. void I2C_ClearITPendingBit(I2C_TypeDef* I2Cx, uint32_t I2C_IT);

复制代码

04. 结构体封装

1. /**
   ! M+ j8 b( W& i. c" W
2.   * @brief Inter-integrated Circuit Interface
   
3.   */
   0 [: n/ D# ?% }0 D
4. 
   3 O7 q& Q+ T0 R0 r$ k" U6 l
5. typedef struct
   
6. {
   2 _& U; a' B" j7 d7 {9 Q
7.   __IO uint16_t CR1;        /*!< I2C Control register 1,     Address offset: 0x00 */
   
8.   uint16_t      RESERVED0;  /*!< Reserved, 0x02                                   */
   - z! x8 D1 r5 V# `5 M4 D+ Y( l+ ]
9.   __IO uint16_t CR2;        /*!< I2C Control register 2,     Address offset: 0x04 */
   8 F8 [6 }; D1 x5 P7 H
10.   uint16_t      RESERVED1;  /*!< Reserved, 0x06                                   */
    " o' L* X- o0 W( i6 O' u/ Q3 X
11.   __IO uint16_t OAR1;       /*!< I2C Own address register 1, Address offset: 0x08 */
    
12.   uint16_t      RESERVED2;  /*!< Reserved, 0x0A                                   */
    
13.   __IO uint16_t OAR2;       /*!< I2C Own address register 2, Address offset: 0x0C */
    
14.   uint16_t      RESERVED3;  /*!< Reserved, 0x0E                                   */
    ; C1 [6 w4 g- m
15.   __IO uint16_t DR;         /*!< I2C Data register,          Address offset: 0x10 */
    - t" H# y0 d$ s+ R. ~1 A
16.   uint16_t      RESERVED4;  /*!< Reserved, 0x12                                   */
    $ M5 ^* ~. Z; n& w
17.   __IO uint16_t SR1;        /*!< I2C Status register 1,      Address offset: 0x14 */
      |2 I1 m" a; V" A  R! U
18.   uint16_t      RESERVED5;  /*!< Reserved, 0x16                                   */
    0 h" f& o+ ^/ [% @7 n* o
19.   __IO uint16_t SR2;        /*!< I2C Status register 2,      Address offset: 0x18 */
    3 }6 h- z# g& u/ f8 ^/ _
20.   uint16_t      RESERVED6;  /*!< Reserved, 0x1A                                   */
    
21.   __IO uint16_t CCR;        /*!< I2C Clock control register, Address offset: 0x1C */
    
22.   uint16_t      RESERVED7;  /*!< Reserved, 0x1E                                   */
    
23.   __IO uint16_t TRISE;      /*!< I2C TRISE register,         Address offset: 0x20 */
    7 @% F: S1 f8 t- C
24.   uint16_t      RESERVED8;  /*!< Reserved, 0x22                                   */
    
25.   __IO uint16_t FLTR;       /*!< I2C FLTR register,          Address offset: 0x24 */
    
26.   uint16_t      RESERVED9;  /*!< Reserved, 0x26                                   */
    2 C# \( {% [8 h2 j2 j0 J& y. b- R" I
27. } I2C_TypeDef;

复制代码

& a) J8 ^8 a$ c2 F
+ j3 N# l$ q$ v* h5 [) M