ADS1115介绍
ADS1115是具有 PGA、振荡器、电压基准、比较器的 16 位、860SPS、4 通道 Δ-Σ ADC，数据通过一个 I2C 兼容型串行接口进行传输。有关它的详细说明可以参考官方数据手册。
1 F8 q4 d' v: M9 R1 x6 J+ ]
驱动源码
7 |# _6 V2 d4 O$ i. ~头文件

1. #ifndef __ADS1115_H__
   
2. #define __ADS1115_H__
   3 w8 u9 T$ e; w
3. 
   7 d3 Z4 s- W  O
4. #include "stm32f4xx.h"
   , [) F! n1 G8 D2 o5 v$ R  J: @* Y" U
5. #include "stm32f4xx_conf.h"
   
6. 
   $ y% e% \% w: k3 m4 c3 Q; ^
7. #ifdef ADS1115
   2 q, f% ?$ x' J* ?) z: ^: M& ]
8. #include "i2c_virtual.h"
   
9. 
   4 X; g+ F, G5 g( z2 o2 ~3 Q  c/ [
10. #define ADS1115_SCL_PORT        'A'
    - K- s3 h" B* U4 f. S
11. #define ADS1115_SCL_PIN                6
    
12. 
    
13. #define ADS1115_SDA_PORT        'A'
    4 B. ~+ ^) s7 C# W, h5 d! p7 g: }
14. #define ADS1115_SDA_PIN                5
    
15. 
    
16. #define Accuracy                                                                         32768        //ADC单端输入15位精度
    
17. #define ADS1115_ADDRESS_0                                        0x90        //ADDR PIN ->GND
    
18. #define ADS1115_ADDRESS_1                                                0x92        //ADDR PIN ->VDD
    - q% K* J4 ?( p& q  F8 e+ U1 @
19. #define ADS1115_ADDRESS_2                                        0x94        //ADDR PIN ->SDA
    
20. #define ADS1115_ADDRESS_3                                        0x96        //ADDR PIN ->SCL
    
21. 
    
22. //*************ADDR Initial********************/
    1 i$ \5 A. d+ u4 O$ K+ J
23. #define ADS1115_ADDRESS                ADS1115_ADDRESS_0                //ADDR PIN ->GND
    ) ~. p5 E0 z3 D$ `; o& M' J
24. #define ADS1115_ADDRESS_W        ADS1115_ADDRESS|0x00        //write address
    - _* x+ Y0 |2 |% W! u, ?+ n
25. #define ADS1115_ADDRESS_R        ADS1115_ADDRESS|0x01        //read address
    
26. 
    . u" _# D/ T: ~6 n- \: [4 R+ ~
27. /************POINTER REGISTER*****************/
    8 E; c* N2 K6 V* D0 a( x# @
28. #define ADS1115_Pointer_ConverReg                        0x00        //Convertion register
    
29. #define ADS1115_Pointer_ConfigReg                        0x01        //Config register
    
30. #define ADS1115_Pointer_LoThreshReg                        0x02        //Lo_thresh register
    
31. #define ADS1115_Pointer_HiThreshReg                        0x03        //Hi_thresh register
    $ S" s+ u6 b2 [
32. 
    / V0 N; ]3 p( L) R- s
33. /************CONFIG REGISTER*****************/
    8 B# S* ?8 ?0 A( i# f: c. P
34. 
    
35. //Bit[15]
    
36. #define ADS1115_OS_OperationalStatus                0x0000                //No Effect
    
37. #define ADS1115_OS_SingleConverStart                0x8000                //Begin a single conversion
    + [; K# Q, N: g1 T6 t
38. //Bits[14:12]
    * [. B6 h" U0 L. T/ F
39. #define ADS1115_MUX_Differ_01                                0x0000                //AINp=AIN0, AINn=AIN1(default)
    
40. #define ADS1115_MUX_Differ_03                                0x1000                //AINp=AIN0, AINn=AIN3
    
41. #define ADS1115_MUX_Differ_13                                0x2000                //AINp=AIN1, AINn=AIN3
    
42. #define ADS1115_MUX_Differ_23                                0x3000                //AINp=AIN2, AINn=AIN3
    - ]2 b; L" E: Y
43. #define ADS1115_MUX_Channel_0                                0x4000                //AINp=AIN0, AINn=GND
    
44. #define ADS1115_MUX_Channel_1                                0x5000                //AINp=AIN1, AINn=GND
    
45. #define ADS1115_MUX_Channel_2                                0x6000                //AINp=AIN2, AINn=GND
    
46. #define ADS1115_MUX_Channel_3                                0x7000                //AINp=AIN3, AINn=GND
    " `* t2 }& ~( y
47. //Bits[11:9]
    
48. #define ADS1115_PGA_6144                                        0x0000                //FS=6.144V
    
49. #define ADS1115_PGA_4096                                        0x0200                //FS=4.096V
    : C9 B6 U, l9 z! X3 s& M/ X: h
50. #define ADS1115_PGA_2048                                        0x0400                //FS=2.048V(default)
    
51. #define ADS1115_PGA_1024                                        0x0600                //FS=1.024V
    
52. #define ADS1115_PGA_0512                                        0x0800                //FS=0.512V
    
53. #define ADS1115_PGA_0256                                        0x0A00                //FS=0.256V
    
54. //Bit[8]
    ' a+ r/ n0 |# J4 u( k
55. #define ADS1115_MODE_ContinuConver                        0x0000                //Continuous conversion mode
    8 u- B" ~. p/ i7 G1 u
56. #define ADS1115_MODE_SingleConver                        0x0100                //Power-down single-shot mode(default)
    
57. //Bits[7:5]
    & l$ I9 h  S6 p/ b4 |# E5 f! U9 w: S
58. #define ADS1115_DataRate_8                                        0x0000                //Data Rate = 8
    
59. #define ADS1115_DataRate_16                                        0x0020                //Data Rate = 16
    
60. #define ADS1115_DataRate_32                                        0x0040                //Data Rate = 32
    
61. #define ADS1115_DataRate_64                                        0x0060                //Data Rate = 64
    
62. #define ADS1115_DataRate_128                                0x0080                //Data Rate = 128(default)
    
63. #define ADS1115_DataRate_250                                0x00A0                //Data Rate = 250
    " \* B! G2 u8 \0 E0 `
64. #define ADS1115_DataRate_475                                0x00C0                //Data Rate = 475
    / j+ j  x  o+ |2 p) `
65. #define ADS1115_DataRate_860                                0x00E0                //Data Rate = 860
    " }' L* y) _4 B* |* z
66. //Bit[4]
    
67. #define ADS1115_COMP_MODE_0                                        0x0000                //Traditional comparator with hysteresis
    , C6 `) h3 ]8 {+ c
68. #define ADS1115_COMP_MODE_1                                        0x0010                //Window comparator
    1 u) Q/ `1 S8 G  d  r
69. //Bit[3]
    
70. #define ADS1115_COMP_POL_0                                        0x0000                //Active low
    
71. #define ADS1115_COMP_POL_1                                        0x0008                //Active high
    / `- N) B: o+ ~5 z4 z" b  A# ~) u0 y
72. //Bit[2]
    
73. #define ADS1115_COMP_LAT_0                                        0x0000                //Non-latching comparator
    
74. #define ADS1115_COMP_LAT_1                                        0x0004                //Latching comparator
    # P# w- V# R$ k
75. //Bits[1:0]
    : Z2 x1 p8 b; `1 _3 J2 j; r! r
76. #define ADS1115_COMP_QUE_0                                        0x0000                //Assert after one conversion
    
77. #define ADS1115_COMP_QUE_1                                        0x0001                //Assert after two conversion
    
78. #define ADS1115_COMP_QUE_2                                        0x0002                //Assert after four conversion
    
79. #define ADS1115_COMP_QUE_3                                        0x0003                //Disable Comparator
    
80. 
    
81. typedef struct
    ( Q* ~" ~. P, N/ f4 E1 U: g. Q" X
82. {
    $ R0 J  s3 t5 J5 t: Q2 x
83.     u16 OS;
    $ E& W; P, L; n: N' a
84.     u16 MUX;
    + u" D5 [% [1 \# m
85.     u16 PGA;
    1 o" }" t+ H% o0 j, ?0 K
86.     u16 MODE;
    
87.     u16 DataRate;
    
88.     u16 COMP_MODE;
    
89.     u16 COMP_POL;
    9 d) K8 ?3 P/ u8 \4 |1 `
90.     u16 COMP_LAT;
    
91.     u16 COMP_QUE;
    
92. } ADS1115_InitTypeDefine;
    * |6 _6 \. V- o% e9 J+ e* q: ?
93. 
    " V. H3 Z; e+ k  s: E
94. extern int16_t ADS1115_RawData[4];
    & G) m7 L5 c+ `& |
95. 
    ( L% {4 P, l1 {& C3 K, m
96. void ADS1115_Init();
    
97. void ADS1115_UserConfig1();
    ( O: B* U+ y" @. S4 d/ g
98. void ADS1115_UserConfig2();
    
99. u8 ADS1115_Config(ADS1115_InitTypeDefine* ADS1115_InitStruct);
    
100. 
     , [1 o8 o6 ]( D: N7 C2 Y! p
101. u8 ADS1115_ReadRawData(int16_t* rawData);
     % W8 `9 H8 J# t- X4 ~6 r
102. void ADS1115_ScanChannel(uint8_t channel);
     . m3 [! F% o, K8 Y
103. float ADS1115_RawDataToVoltage(int16_t rawData);
     
104. 
     
105. float ADS1115_GetVoltage();
     
106. float ADS1115_GetAverageVoltage(uint16_t num);
     
107. 
     + @1 b, A) X, s, ]# Y
108. void ADS1115_RefreshAllChannel();
     
109. 
     
110. #endif
     4 z% T# l! X& x. h
111. #endif
     

复制代码

" J. C# P- ^% }% Y! H: \源文件
# ~  D  `7 ]# g& @9 t7 ?

1. #include "ads1115.h"
   
2. 
   
3. #ifdef ADS1115
   + P* V) j7 K, y+ J" W* o( h, s8 i
4. 
   
5. static ADS1115_InitTypeDefine ADS1115_InitType;
   
6. 
   ) |" \& H3 S+ y' ]
7. /**
   % X/ X( {/ u' I. N5 R# r/ x$ J
8. * 可供外部调用的全局变量，记录了ADS1115采样的原始16位数据。调用void ADS1115_RefreshAllChannel( )函数可以刷新这个变量。
     P( o, e- z2 n# x, M
9. * 通过定义宏ADS1115_USE_FILTER，可以将ADS1115的轮询采样数据经过滑动滤波后，保存到ADS1115_RawData[]中。
   
10. * 通过float ADS1115_RawDataToVoltage(int16_t rawData)函数可以将ADS1115_RawData[]换算成对应的电压值。
    
11. */
    $ Q& B" p: D: D
12. int16_t ADS1115_RawData[4] = {0};
    
13. 
      T4 r/ K8 t+ f6 u$ D
14. 
    
15. /**
    4 o0 [' T/ W$ M
16. * @brief 完成芯片控制端口初始化，并设置初始状态
    7 @3 E+ U/ K) o
17. */
    1 c9 U8 r  m3 J* C. l
18. void ADS1115_Init()
    . z+ R) \' |# h5 S
19. {
    4 v6 ?% g6 g( T  E! F5 K* g
20.         I2C_Virtual_ConfigPort(ADS1115_SDA_PORT, ADS1115_SDA_PIN, ADS1115_SCL_PORT, ADS1115_SCL_PIN);
    
21. }
    . E& ~, k9 ^4 j+ j  H# B- N; J
22. 
    
23. 
    4 F9 S) H% k2 g( z1 \! i( Y
24. /**
    0 l4 l8 L( L+ d1 \
25. * @brief Configuration of ADS1115, single-shot
    
26. */
    
27. void ADS1115_UserConfig1()
    
28. {
    
29.         ADS1115_InitType.COMP_LAT = ADS1115_COMP_LAT_0;
    + Q" j9 P# d1 V9 ]
30.         ADS1115_InitType.COMP_MODE = ADS1115_COMP_MODE_0;
    2 E4 u$ M( I# f) A/ i! R
31.         ADS1115_InitType.COMP_POL = ADS1115_COMP_POL_0;
    & _; o  P1 ?. D1 {3 k
32.         ADS1115_InitType.DataRate = ADS1115_DataRate_475;
    
33.         ADS1115_InitType.MODE = ADS1115_MODE_SingleConver;
    
34.         ADS1115_InitType.MUX = ADS1115_MUX_Channel_0;
    3 Q6 C2 w8 V6 D) \9 i
35.         ADS1115_InitType.OS = ADS1115_OS_SingleConverStart;
    ; w( y0 T3 t* Y
36.         ADS1115_InitType.PGA = ADS1115_PGA_4096;
    # X8 }4 f. G7 n: Q
37. 
    
38.         ADS1115_Config(&ADS1115_InitType);
    , Y7 A( b" R  `
39. }
    
40. 
    
41. 
    
42. /**
    8 T% x2 z0 L* F/ A5 }* f
43. * @brief Configuration of ADS1115, continuous conversion
    9 I( z, _2 |; V! n" y; G
44. */
    8 t9 P+ X. q) Y3 |' C# N, _3 a
45. void ADS1115_UserConfig2()
    
46. {
    
47.         ADS1115_InitType.COMP_LAT = ADS1115_COMP_LAT_0;
    . S# u6 V0 Z3 o6 w7 _( O
48.         ADS1115_InitType.COMP_MODE = ADS1115_COMP_MODE_0;
    & M; e; f2 O% |3 j6 X9 U/ W) Z
49.         ADS1115_InitType.COMP_POL = ADS1115_COMP_POL_0;
    
50.         ADS1115_InitType.DataRate = ADS1115_DataRate_475;
    6 c) T) w0 _' }& J9 x
51.         ADS1115_InitType.MODE = ADS1115_MODE_ContinuConver;
    
52.         ADS1115_InitType.MUX = ADS1115_MUX_Channel_0;
    . e: @$ {- I6 e/ T  @  Y
53.         ADS1115_InitType.OS = ADS1115_OS_OperationalStatus;
    
54.         ADS1115_InitType.PGA = ADS1115_PGA_4096;
    ' e9 X3 ?1 x0 m1 p) m1 j: \
55. 
    
56.         ADS1115_Config(&ADS1115_InitType);
    3 A6 I# L5 t; M  c  W% T/ i
57. }
    
58. 
    
59. 
    * ~  _& l$ b! R6 c; g
60. /**
    9 x+ k, [! h# z0 o) t
61. * @brief 配置ADS1115
    
62. * @param ADS1115_InitStruct: 用来配置ADS1115的结构体变量指针
    / n0 J+ ?$ o6 r# ]1 j- c" M9 [& `
63. * @return 配置结果
    
64. *                 @arg: fail
    
65. *                 @arg: success
    " A6 `$ ]  {( b: R
66. */
    & P6 G  T! g" e6 s0 K0 c
67. u8 ADS1115_Config(ADS1115_InitTypeDefine *ADS1115_InitStruct)
    " A- z2 k; i0 N) o" ?
68. {
    
69.         u16 Config;
    
70.         u8 Writebuff[2];
    ' H. E" k4 |( j( P0 j
71. 
    
72.         Config = ADS1115_InitStruct->OS + ADS1115_InitStruct->MUX + ADS1115_InitStruct->PGA + ADS1115_InitStruct->MODE
    
73.                         + ADS1115_InitStruct->DataRate + ADS1115_InitStruct->COMP_MODE + ADS1115_InitStruct->COMP_POL
    / B# j$ ^* H( Y) |6 b
74.                         + ADS1115_InitStruct->COMP_LAT + ADS1115_InitStruct->COMP_QUE;
    
75. 
    
76.         Writebuff[0] = (unsigned char) ((Config >> 8) & 0xFF);
    6 `* A, z$ ?3 H7 i; \- W
77.         Writebuff[1] = (unsigned char) (Config & 0xFF);
    ( R/ ]# U% T+ v$ B* d
78. 
    , o$ o/ d+ D3 [2 O: l
79.         I2C_Virtual_Start();                                        //启动总线
    
80.         I2C_Virtual_SendByte(ADS1115_ADDRESS_W);                //发送器件地址（写）
    
81. 
    
82.         if (I2C_Virtual_ack == 0)
    
83.                 return (0);
    
84. 
    ( U2 U: ]4 c* `6 D0 G! s: n) u' A
85.         I2C_Virtual_SendByte(ADS1115_Pointer_ConfigReg);                //发送寄存器地址
    
86. 
    . L0 E% o5 G2 j
87.         if (I2C_Virtual_ack == 0)
    
88.                 return (0);
    " N! N1 g2 K" y: c
89. 
    - E3 ?/ G0 U2 t8 A! `
90.         I2C_Virtual_SendByte(Writebuff[0]);                //发送数据
    ( l. _: ~% s  r! D) K, c) F
91. 
    
92.         if (I2C_Virtual_ack == 0)
    . F! B  Q+ M; O3 [
93.                 return (0);
    
94. 
      w7 x4 Z* n0 U, a. b
95.         I2C_Virtual_SendByte(Writebuff[1]);                //发送数据
    : P9 \. i! A6 X5 o2 j
96. 
    
97.         if (I2C_Virtual_ack == 0)
    4 o4 Y6 N+ X% ~/ J, ?' A1 i/ P
98.                 return (0);
    
99. 
    
100.         I2C_Virtual_Stop();
     
101. 
     . @* q7 D3 {: L/ U( Y
102.         return (1);
     
103. }
     + y7 F$ ^: m% M( @5 U
104. 
     
105. 
     
106. 
     
107. /**
     
108. * @brief 读取ADS1115当前通道下的原始数据
     8 \9 [- R8 E9 a( h
109. * @param rawData: 传入一个int16_t整型变量的指针，ADS1115的原始数据将保存在这个变量中
     
110. * @return 读取结果
     " h; |2 l+ F; m# ^
111. *                 @arg 0: fail
     
112. *                 @arg 1: success
     6 t+ l! m+ Z3 l& |! G1 n' B. I- V9 U
113. */
     * l; S( V3 u$ w, C
114. uint8_t ADS1115_ReadRawData(int16_t *rawData)
     
115. {
     
116.         unsigned char Result[2];
     6 C' f2 y! z7 k2 L$ V
117. 
     + Z) W% I+ D8 o* [) B
118.         I2C_Virtual_Start();                                                                                                                        //启动总线
     7 s3 k  `  G- B, d
119.         I2C_Virtual_SendByte(ADS1115_ADDRESS_W);                                        //发送器件地址（写）
     5 H5 x* `) [% _8 [+ u; t4 H
120. 
     
121.         if (I2C_Virtual_ack == 0)
     
122.                 return (0);
     8 ~; s( X) @4 j: Y/ n
123. 
     3 q! j( P6 ]$ _7 ^" y/ O. H8 C
124.         I2C_Virtual_SendByte(ADS1115_Pointer_ConverReg);         //发送寄存器地址
     5 C1 u9 l: H& `7 X
125. 
     
126.         if (I2C_Virtual_ack == 0)
     
127.                 return (0);
     0 W( w" E: |: m6 Q( A: X  t: f
128. 
     . k% Y) y) ]: w  k! e- P
129.         I2C_Virtual_Stop();
     
130.         delay_us(10);
     
131.         I2C_Virtual_Start();                                                                                        //写寄存器之后需要重新启动总线
     6 B( |9 b0 a/ f% R, J
132. 
     
133.         I2C_Virtual_SendByte(ADS1115_ADDRESS_R);                                                //发送器件地址（读）
     ! h0 C& M/ ]( N. O" F0 M
134. 
     2 h9 b( o5 c  l7 R. h& e
135.         if (I2C_Virtual_ack == 0)
     
136.                 return (0);
     2 J: v* q& r# s3 {
137. 
     
138.         Result[0] = I2C_Virtual_RcvByte();                //接收数据
     
139.         I2C_Virtual_Ack();                        //发送就答位
     
140.         Result[1] = I2C_Virtual_RcvByte();
     
141.         I2C_Virtual_NoAck();                        //发送非应位
     0 @* x* H) }  \: P9 o+ Z
142.         I2C_Virtual_Stop();                         //结束总线
     
143. 
     ; V' p4 h6 m  _5 g
144.         *rawData = (int16_t) (((Result[0] << 8) & 0xFF00) | (Result[1] & 0xFF));
     6 M* f7 Q3 R, P
145. 
     
146.         return 1;
     ) u- z$ x( W# B" Q3 v; ^8 J
147. }
     # g1 W- ^6 d: k& L  Q+ X9 Q
148. 
       ]! p' _1 Z4 z1 d- |" B- I  b
149. 
     3 h. t) Q( D# V, ^: |
150. /**
     
151. * @brief Switch the channel of ADS1115
     . M+ C1 e! ~- ?' Z& u$ Y; p4 Z
152. * @param channel
     % }, v" l2 O+ S
153. */
     5 m1 M% Y4 O1 o0 r3 Z8 M
154. void ADS1115_ScanChannel(uint8_t channel)
     ( @4 o: L4 X5 N- b3 `1 n' S
155. {
     
156.         switch (channel)
     
157.         {
     $ d! T( A' c  {& J' C5 ?
158.         case 0:
     6 G% _: R' E+ e, ~0 b2 P' [8 z2 _
159.                 ADS1115_InitType.MUX = ADS1115_MUX_Channel_0;
     
160.                 break;
     
161.         case 1:
     
162.                 ADS1115_InitType.MUX = ADS1115_MUX_Channel_1;
     + z9 w. ~- ]2 M3 z4 N* W$ _/ g
163.                 break;
     
164.         case 2:
     
165.                 ADS1115_InitType.MUX = ADS1115_MUX_Channel_2;
     1 ^8 O5 b' \4 d4 X+ Q8 z
166.                 break;
     
167.         case 3:
     
168.                 ADS1115_InitType.MUX = ADS1115_MUX_Channel_3;
     
169.                 break;
     + a6 {9 X8 j3 x) M. w
170.         default:
     
171.                 break;
     . z* a" j2 C0 E$ Y( k
172.         }
     % X. n  L0 \! A1 \: ^( s" {5 v4 x
173. 
     4 N2 i8 E& r4 N- g% r
174.         ADS1115_Config(&ADS1115_InitType);
     
175. }
     
176. 
     
177. 
     ; ]/ h9 r$ y- j9 J" P3 ?
178. /**
     ( H+ {7 C7 T+ I& n4 z& }, N1 h6 o' z
179. * @brief 将传感器的原始采样数据转化为电压数据，
     & W- B' y+ O6 R! |% u) j, F0 l
180. *                         根据ADS1115_InitType结构体中包含的增益信息计算
     : O8 q5 \4 h# n6 ?0 Z9 _
181. * @param rawData: 待转换的原始数据
     2 L" e' u. S- h3 y  T+ T) |3 N# w
182. * @retval 返回经过计算的电压值
     : k7 E; g. r# _: K# T& G! E  f
183. */
     
184. float ADS1115_RawDataToVoltage(int16_t rawData)
     
185. {
     9 b% f; G) V2 u- k! C/ q) ^
186.         float voltage;
     
187. 
     " r7 |6 \$ x9 X3 c5 |
188.         switch (ADS1115_InitType.PGA)
     # Q3 R5 s& x0 K1 M  @7 p( ?2 `, x
189.         {
     " m" z- z9 W5 R/ h$ E
190.         case ADS1115_PGA_0256:
     
191.                 voltage = rawData * 0.0078125;
     
192.                 break;
     6 O  b' ]# A3 [2 i" Q
193. 
     % D3 e/ a. s; _5 g( T- g0 F
194.         case ADS1115_PGA_0512:
     ( e0 W, o- `- f
195.                 voltage = rawData * 0.015625;
     
196.                 break;
     " `4 J: Y! F" F% _# J4 \
197. 
     * O; D9 }0 z) g6 N3 W; y& N1 K
198.         case ADS1115_PGA_1024:
     2 t! b+ L9 u: a0 O
199.                 voltage = rawData * 0.03125;
     
200.                 break;
     
201. 
     
202.         case ADS1115_PGA_2048:
     ( o1 p9 I# S1 S: \: r! W
203.                 voltage = rawData * 0.0625;
     
204.                 break;
     
205. 
     1 j7 Q% r4 a/ m$ q
206.         case ADS1115_PGA_4096:
     3 q) \) h, Q2 P4 g
207.                 voltage = rawData * 0.125;
     6 o4 @+ ^$ s0 h& e% B3 t" G
208.                 break;
     ! m7 I" i; o1 r& Q
209. 
     
210.         case ADS1115_PGA_6144:
     0 h7 Y0 {% \; d& U6 @; b
211.                 voltage = rawData * 0.1875;
     * V6 x& m, G* v. c+ `" T
212.                 break;
       ?- @" u: M( L8 c7 L& ^
213. 
     
214.         default:
     + G8 g% V, a0 {  p) E
215.                 voltage = 0;
     
216.                 break;
     
217.         }
     
218. 
     + g1 M' o$ G! r/ ^# }) T  T. ?7 ~( Z- h& H
219.         return voltage;
     
220. }
     ) h7 X4 X" l4 L. M
221. 
     , z7 I8 g, @: k! f
222. 
     $ d; I0 a& o/ P  V
223. /**
     9 a, I. B& X- r1 ~5 \  V* M: O
224. * @brief 直接获取ADS1115当前通道的电压采样值
     6 Z" \+ S+ z+ i6 [; q6 ?: w" k
225. * @return 电压采样值
     ! @+ h! u; h- }% w" y7 }9 O
226. */
     
227. float ADS1115_GetVoltage()
     9 [$ D  _! ^) b1 p# s) b: Z
228. {
     
229.         int16_t rawData;
     - C3 T+ k2 E$ ]/ k$ N
230. 
     ( N* r5 V! `$ i: ]
231.         ADS1115_ReadRawData(&rawData);
     5 X/ `3 f9 ?& `9 T- e( t7 E
232. 
     1 X2 f' m9 e! h7 c
233.         return ADS1115_RawDataToVoltage(rawData);
     
234. }
     + ?" P3 q+ {9 d: G8 b5 m1 h
235. 
     
236. 
     
237. /**
     
238. * @brief 获取并计算ADC采样的平均电压值
       b; Z6 v' o" b' v; `  p
239. * @param num: 计算平均值的数量
     ( O# ^+ N, M9 o' e* l: L. ]/ a
240. * @retval 电压采样的平均值
     
241. */
     
242. float ADS1115_GetAverageVoltage(uint16_t num)
     7 S/ f5 V% s5 n2 d  Z' W
243. {
     9 |( g5 b( h' g/ K# @
244.         int32_t sum = 0;
     
245.         int16_t rawData;
     
246. 
     & V. r: M' S3 w: S0 p
247.         if(num == 0)
     
248.         {
     % a- F1 }$ W( ~% {: W9 H" {
249.                 return ADS1115_GetVoltage( );
     1 K7 f. H: d. s
250.         }
     3 X: z2 ?- Q2 o  b# i
251. 
     6 j# K7 K0 x3 E4 ~% |( a! S: s
252.         for(uint16_t i =0; i< num;i++)
     
253.         {
     ! r: ]0 W; L6 H2 C- s' K5 J6 I1 i7 O' c
254.                 ADS1115_ReadRawData(&rawData);
     
255.                 sum += rawData;
     . ~3 ^7 P4 ^3 y# b- \. ?
256.         }
     
257. 
     9 M# ^! l. o: h4 w5 [/ |9 Q
258.         return ADS1115_RawDataToVoltage(sum/num);
     
259. }
     
260. 
     
261. /**
     
262. * @brief 刷新ADS1115全部通道的采样数据
     
263. *                 由于ADS1115通道切换后需要等待较长时间数据才能够稳定，
     ; u5 j8 T/ t% E7 M9 C- t
264. *                 在进行多路数据采集的时候，切换通道后延时阻塞等待切换完成会占用过多的系统时间，
     . ?6 R9 j1 I( c
265. *                 因此需要在一个定时器中轮询采集ADS1115数据，每次采集完成后，切换到下一个通道
     + l% B$ I. w+ w" x
266. *                 大幅度提高了系统工作的效率。
     % b( ?/ i$ t2 ]2 c0 j
267. *
     " T) m. i( p8 L' z! K& E, u
268. *                 调用此函数可以刷新全局变量ADS1115_RawData[4]的值。
     
269. *
     + z( Z+ d2 \5 ~- Y( q
270. *                 应当在一个定时器更新中断服务函数中周期性的调用此函数，更新周期最好小于200Hz
     8 i. M7 t6 l4 e- h5 z5 h3 {. k5 F1 i
271. */
     
272. void ADS1115_RefreshAllChannel()
     
273. {
     
274.         static uint8_t channel = 0;
       H9 J, A8 C* V5 t$ Z. W  n
275.         int16_t adcDataTemp = 0;
     + m& J+ D1 I/ ~1 m
276. 
     + s. S, j3 `" b
277.         //通道切换时可能有不确定的数据读出，因此需要将前1~2次读出的数据舍弃
     
278.         ADS1115_ReadRawData(&adcDataTemp);
     5 x* b' L8 {( u8 ]
279.         ADS1115_ReadRawData(&adcDataTemp);
     ) X3 n: s* G5 o: ~
280. 
     
281.         //读取数据返回正确，则将读到的数据写入ADS1115_RawData数组中
     . e# p2 t5 K  o- _
282.         if( ADS1115_ReadRawData(&adcDataTemp) !=0 )
     
283.         {
     " {. ~" u: Q) e9 {* n
284.                 ADS1115_RawData[channel] = adcDataTemp;
     : X; x- x" U& g% b! A2 S
285.         }
     
286.         
     # {+ W# s% ?0 Q6 m. C
287.         //ADS1115总共4个通道
     5 Y& P! m; [% h) ~( x
288.         channel++;
     7 v. W( x  g1 _# b" ^
289.         
     ( @. e9 d2 M3 A" y2 y1 c
290.         if(channel>ADS1115_MAX_CHANNEL-1)
     $ @: r5 U- K8 w7 ^, S. l/ Z
291.                 channel = 0;
     " H8 Q$ D/ g* w
292. 
     ) I& a6 @3 M; j$ g0 ?  o5 U
293.         //结束采样后切换至下一通道
     9 D: q6 R, e9 d% ^7 }7 H% ?
294.         ADS1115_ScanChannel(channel);
     7 J/ _0 \% ]8 |# f' M$ j
295. }
     
296. #endif
     

复制代码

7 p6 n- ]) z8 g; M  g5 V# z7 v使用指南
! [  r2 z$ x& m/ Q4 F5 L6 a+ l( l基本步骤
  k0 q! k' b4 H4 M初始化软件模拟I2C或者硬件I2C外设（以笔者编写的软件模拟I2C库为例）

1.         I2C_Virtual_ConfigPort(ADS1115_SDA_PORT, ADS1115_SDA_PIN, ADS1115_SCL_PORT, ADS1115_SCL_PIN);
   
2.         I2C_Virtual_SwitchBus(ADS1115_SDA_PORT, ADS1115_SDA_PIN, ADS1115_SCL_PORT, ADS1115_SCL_PIN);

复制代码

7 |# h2 t; p5 F1 \/ Q初始化ADS1115芯片的配置。笔者在驱动库中提供了两种初始化配置函数void ADS1115_UserConfig1()与void ADS1115_UserConfig2()，可以修改这两个函数中的配置参数后直接调用。

1.         ADS1115_UserConfig2();

复制代码

# f$ C9 Z  E  A- N0 r* y* E+ P- x& `设置或者切换ADS1115的通道（配置完ADS1115之后，可以设置一个初始通道）。
, b2 X6 ]# {8 B0 c4 |5 w- I6 u; f3 V/ o

1.         ADS1115_ScanChannel(1);

复制代码

根据项目的需要，选择采集原始数据然后在其他地方换算成电压数据，或者直接采集电压数据以及滤波后的电压数据。

1.         int16_t rawData = 0;
   - [8 k& [8 [! m8 N
2.         float voltage = 0;
   
3.         
   
4.         //获取ADS1115采集的原始16位数据
   . ~4 \/ S& z* I  ]
5.         ADS1115_ReadRawData(&rawDAta);
   6 U2 w7 X" F1 y+ u9 D. d
6.         //将ADS1115采集的原始16位数据换算为实际电压值
   8 N9 m3 M/ Q2 z3 W+ G5 T- D" X1 z
7.         voltage = ADS1115_RawDataToVoltage(rawData);
   
8. 
   
9.         //直接获取ADS1115采集的电压数据
   
10.         voltage = ADS1115_GetVoltage();
    
11.         
    
12.         //直接获取ADS1115采集的电压数据（经过多次采样计算平均值）
    
13.         voltage = ADS1115_GetAverageVoltage(10);
    

复制代码

9 p% |- g9 B4 J- z$ ]8 j% e- F注意事项
) t% J$ j) Y. G0 i! T( D不使用实时操作系统
对于多通道采样，每次通道切换时，应当等待几毫秒的时间后再进行采样，否则采样的数据可能不稳定或者发生通道间干扰。

1.         int32_t ADC_Temp_Filter[4] = {0};
   * g6 p/ ?% y, B0 `( ]
2.         float ADC_Temp[4] = {0};
   * \6 L( g- z% h3 u. R3 r$ V; t" o  ^
3.         
   5 |3 q7 O9 t3 x
4.         for (uint8_t chan = 0; chan < 4; chan++)
   " d! [6 x# b5 G5 F$ B7 j
5.         {
   
6.                 ADS1115_ScanChannel(chan);
   
7.                 delay_ms(5);
   4 N7 j! g0 f: M8 }- c8 c2 i
8.                 ADS1115_ReadRawData(&dataTemp);
   
9.                 //Keep 3 decimal places and filter
   0 r$ @; V9 a9 R% P# E, e8 L/ {
10.                 ADC_Temp_Filter[chan] = (int32_t)(ADS1115_GetVoltage()*1000);
    ) j) i& Y  F0 b* @- ]& o) J
11.                 ADC_Temp[chan] = Filter_MovingAverage(ADC_Temp_Filter[chan],chan)/1000.0;
    & a( I0 o' k# J" I
12.         }

复制代码

( d, |: @/ W2 b$ K. D( P6 f由于多通道切换的通道稳定等待时间的存在，上面的代码耗时将会很长（>20ms）。如果在中断服务函数中执行了这些代码，将会导致单片机的性能严重下降。因此，需要考虑在定时器更新中断服务函数中周期性的调用void ADS1115_RefreshAllChannel()。每次调用将刷新一个通道的数据，四次调用便可以将全部通道的数据都刷新一遍，大大提高了代码的运行效率。示例如下：

软件定时器1以40Hz的频率周期性的调用void ADS1115_RefreshAllChannel()，以获得10Hz的全通道数据刷新速度。
软件定时器0以10Hz的频率处理ADS1115的原始采样数据（换算成电压、滤波、校正等）与其他传感器的数据。
通过多个更新周期不同的定时器的配合，可以在无代码延时的情况下解决不同传感器数据采集速度不一致的问题，周期性的调用代替了延时等待。
5 ^: m$ z8 q$ o( v# b# k( H1 T. F! q  L

1. /**
   $ L* B" Q* N+ h2 L! d7 F
2. * @brief 设置软件定时器，主要包括初始化与开启各个软件定时器
   
3. */
   + P; K$ W- x2 n2 ?$ Z
4. void User_SetupTimer()
   * F. H7 m/ `- Y! l5 |5 \3 y( B1 R/ \
5. {
   % f/ Q" v5 @0 y7 Q; b. r8 k% x3 d
6.         //Poll frequency of software timer is 1KHz
   3 D  Q$ R% l6 M6 G, ]$ j
7. 
   
8.         //SW_Timer0 for refresh sensor data and modbus action.         Freq. = 10Hz
   
9.         SoftwareTimer_Init(0, 100, User_SoftwareTimer0_Handler, -1);
   
10. 
    
11.         //SW_Timer1 for ads1115 data acquisition.        Freq. = 40Hz
    
12.         SoftwareTimer_Init(1, 25, User_SoftwareTimer1_Handler, -1);
    
13. 
    
14.         //SW_Timer2 for RS485 scan.                Freq. = 10Hz
    
15.         SoftwareTimer_Init(2, 100, User_SoftwareTimer2_Handler, -1);
    2 J9 y/ c; R0 n
16. 
    
17.         //SW_Timer3 for MTSICS.                Freq. = 10Hz
    $ i5 p) p& G* v  G5 m( f
18.         SoftwareTimer_Init(3, 100, User_SoftwareTimer3_Handler, -1);
      k( ?# ~* |* Q' @1 \9 p& U
19. 
    
20.         //SW_Timer4 for RS100 (Printer has not been used).                Freq. = 10Hz
    ( j+ o# v9 v6 V7 G* c+ j
21.         SoftwareTimer_Init(4, 100, User_SoftwareTimer4_Handler, -1);
    $ ]* h4 B9 n0 J" ?$ ?, n/ H
22. 
    
23.         SoftwareTimer_Enable(0);
    5 X/ r% Q2 N  B2 J( G3 j3 w
24.         SoftwareTimer_Enable(1);
    
25.         SoftwareTimer_Enable(2);
    
26.         SoftwareTimer_Enable(3);
    . A2 R. q. V: T: l2 w. {: {. n. `
27.         SoftwareTimer_Enable(4);
    & [! d3 ]$ j2 n$ Y/ U$ j  ~- \
28. }
    $ y; w- A. X0 s5 t6 J% k: j
29. 
    
30. 
    
31. /**
    
32. * @brief 软件定时器1的更新服务函数
    
33. */
    $ n# J& B; w! Q+ l! Y! q4 [
34. void User_SoftwareTimer0_Handler()
    ' f0 F( i/ O! t" [2 g: o% _3 j; L
35. {
    
36.         User_RefreshData();
    
37.         User_RefreshAction();
    0 d* t; X4 [# g5 Q+ H3 [
38. }
    # C" Y; u/ Y3 i
39. 
    4 S0 r' P( h* o- f
40. 
    
41. /**
    & {) b* S5 S& q# q5 z
42. * @brief 软件定时器2的更新服务函数
    
43. */
    
44. void User_SoftwareTimer1_Handler()
    9 a' v- s% N9 K* ?2 y. N# M
45. {
    4 R, Y0 z  M( s
46.         ADS1115_RefreshAllChannel();
      C; `' m7 {, [8 e
47. }
    
48. 
    % o# F& p1 i( }5 D/ r8 @
49. /**
    
50. * @brief This function is called by timer update interrupt handler, which will be executed periodically.
    1 x: o+ |& I+ u8 I8 [4 w" Y2 L3 A: A! `
51. */
    
52. void User_RefreshData()
    
53. {
    
54.         for (uint8_t chan = 0; chan < 4; chan++)
    
55.         {
    
56.                 ADC_Voltage[chan] = Filter_MovingAverage(ADS1115_Data[chan]*10,chan)/10.0;                        //unit: mV, resolution: 0.1 mV
    
57.         }
    / L; ?6 _5 q( V- d# `8 G: G# r
58. 
    
59.         SensorData[0].value = OmronEC55_PV;
    ; \  l3 f/ u, |( w# L
60.         SensorData[1].value = SGDAQ_PV;
    
61.         SensorData[2].value = (float)RS100_Count*0.0005;
    + H' s) a8 i4 M9 ]3 @5 J, X: B  A- c
62.         SensorData[3].value = MTSICS_Weight;
    - `" s, C2 ^6 C( q5 f, z
63. 
    
64.         //Pt100 - 1 PV (℃)
    * s( o% ^5 \; \* A4 w
65.         SensorData[4].value = Pt100_RtoT(User_VoltageToResistance(ADC_Voltage[0]));
    7 }3 w4 x3 @$ u* o  s  V$ _1 X: Y
66.         SensorData[5].value = ADC_Voltage[1];
    & a" i# ]& x; e. C
67.         SensorData[6].value = ADC_Voltage[2];
    ! S. a' }3 q7 m, k" m+ e5 |; a
68.         SensorData[7].value = ADC_Voltage[3];
    
69. 
    
70.         //校正后的SGDAQ_PV
    
71.         SensorData[8].value = SensorData[1].value * HoldingReg_GetData(30) + HoldingReg_GetData(31);
    
72. }

复制代码

在两个或者多个ADS1115组合使用的情况下，对于多通道数据的采样处理应该遵循与上面相似的策略。以两个ADS1115通过软件模拟I2C组成的8通道数据采集功能为例：
volatile int16_t User_ADS1115Data[8];

# q# D- k$ T; z( _1 V, @6 b! k

1. /**
   5 N6 X# D) O+ {$ ?8 ^6 T' k  W! u
2. * @brief 软件定时器2的服务函数
   1 C/ p6 q0 p# ?1 u
3. *                 主要实现了两个ADS1115（总共8路）的数据采集功能。
   * v" Q5 a% w: p4 }3 t# l9 a
4. */
   
5. void User_SoftwareTimer2_Handler()
   
6. {
   - F9 u$ Z* S. F& V" \0 }+ n
7.         static uint8_t chan = 0;
   - z; x, g2 E6 y; x3 y
8.         static uint8_t isData1Copyed = 0;
   
9.         static uint8_t isData2Copyed = 0;
   
10. 
    
11.         //Operate ADS1115-1
    
12.         if(chan < 4)
    
13.         {
    + E1 N7 Y  _; L0 y4 n
14.                 if(isData1Copyed == 0)
    , y( e! x. G" H2 m3 i& X
15.                 {
    * a4 P6 S4 i$ ?7 I
16.                         //将ADS1115-2采样的数据复制到User_ADS1115Data[]中
    ; X. ?: Q6 Z: E5 S: i( n8 E
17.                         for(uint8_t i = 0; i <4; i++)
    
18.                         {
    ) F3 Y; D8 b& t6 _# l, u
19.                                 User_ADS1115Data[i+4] = ADS1115_RawData<i>;
    
20.                         }
    
21.                         isData1Copyed = 1;
    & H. y2 p9 t1 x" w9 ]
22.                         isData2Copyed = 0;
    , {9 W, w7 Z2 Y/ E3 J
23.                 }
    
24. 
    0 d7 [0 N: X, `9 }4 k
25.                 //切换I2C总线至ADS1115-1
    ; O: F( |* c" k9 y) Z! Q
26.                 I2C_Virtual_SwitchBus(ADS1115_SDA_PORT, ADS1115_SDA_PIN, ADS1115_SCL_PORT, ADS1115_SCL_PIN);
    
27. 
    
28.                 ADS1115_RefreshAllChannel();
    * [! }) p! |' ^0 e1 F/ }
29.         }
    5 {+ F5 u$ Q5 r' K. F* F# V
30.         //Operate ADS1115-2
    
31.         else
    # w0 F3 M5 I- L' c
32.         {
    - e+ f: P1 P* }6 q* S/ P
33.                 if(isData2Copyed == 0)
    * D1 Q+ ?: n% `
34.                 {
    
35.                         //将ADS1115-1采样的数据复制到User_ADS1115Data[]中
    8 g# }8 r+ @) \9 g
36.                         for(uint8_t i = 0; i <4; i++)
    9 Z- i* m7 ~* L4 m8 N; c$ H+ T
37.                         {
    * z, Y% w4 s1 T
38.                                 User_ADS1115Data<i> = ADS1115_RawData<i>;
    9 @2 A; X# }) h% Q; U8 {" k
39.                         }
    : B* v% a! a- V' t4 m
40.                         isData2Copyed = 1;
    - Q; o- a# Z4 \! d
41.                         isData1Copyed = 0;
    9 g, H( V% m. A4 o* @3 t# N" X
42.                 }
    
43. 
    ' ~' g' J; s6 W5 P+ M7 K( H( i8 ^
44.                 //切换I2C总线至ADS1115-2
    ( D& D  ]$ O1 ]$ n% h
45.                 I2C_Virtual_SwitchBus(ADS1115_SDA_PORT_2, ADS1115_SDA_PIN_2, ADS1115_SCL_PORT_2, ADS1115_SCL_PIN_2);
    4 U$ x& e$ z: }; j' k
46. 
    # @3 [  P# w/ m% t/ e7 O+ i
47.                 ADS1115_RefreshAllChannel();
    . b, q' N( y8 V. u3 Y7 y" D! G, M
48.         }
    % F/ _3 m7 C- a8 r5 ^
49. 
    
50.         chan++;
    % z. k" }- \* J* T0 ^; x! L) J
51.         if (chan > 7)
    
52.         {
    4 t; [( c8 b0 G9 s0 s* G9 `
53.                 chan = 0;
    + Y* S/ O3 Z0 e, K4 K
54.         }
    
55. }</i></i></i>

复制代码

9 e6 m- v# T6 @5 S使用实时操作系统
. `: s! z" Q1 x% n2 n4 ?' `. n在实时操作系统中使用延时函数时，任务调度器会自动切换执行低优先级任务，因此延时函数（由操作系统提供的API）不存在浪费CPU资源的问题。此时一般的做法是建立一个ADS1115的数据采集任务，在这个任务中轮询采集需要的数据。
7 u' f, T7 G/ N2 Y
8 Z# a, k1 ?& k; ^7 U

1. void ADS1115Daq_task(void *pvParameters)
   5 w( q% [9 k' E- D% v) {
2. {
   # t0 ~7 B2 O- a( q
3.         int16_t adcDataTemp[4] = {0};
   
4.         TickType_t ticks = xTaskGetTickCount();
   " V. Y' V- Y: q7 q- `% n$ k
5. 
   
6.         //配置ADS1115端口，由于采用了软件I2C通讯，因此可以直接调用虚拟I2C中的配置函数完成配置
   6 W& d9 z8 d7 P) V8 a
7.         I2C_Virtual_ConfigPort(ADS1115_SDA_PORT, ADS1115_SDA_PIN, ADS1115_SCL_PORT, ADS1115_SCL_PIN);
   3 O; F0 z. F: |; e" G" q
8.         I2C_Virtual_SwitchBus(ADS1115_SDA_PORT, ADS1115_SDA_PIN, ADS1115_SCL_PORT, ADS1115_SCL_PIN);
   
9.         
   
10.         //使用内置的快速配置模板完成ADS1115的配置
    
11.         ADS1115_UserConfig2();
    ( Y9 [# U0 f% J7 S! \
12. 
    ' e) A8 M5 e1 O& }8 V6 ^& T
13.         while (1)
    
14.         {
    
15.                 for (uint8_t chan = 0; chan < 4; chan++)
    
16.                 {
    
17.                         //设置ADS1115的采样通道
    # M% k2 I' |$ _' l
18.                         ADS1115_ScanChannel(chan);
    7 V$ T: |$ Y# q
19.                         //调用RTOS提供的API延时10ms
    5 e( {: Y2 v7 h! l2 N% I
20.                         vTaskDelay(10);
      ?. f* D: W, w- m9 L7 H& X6 C
21. 
    + H* S0 r- j" y, Z  O4 J
22.                         if(ADS1115_ReadRawData(&adcDataTemp[chan])!=0)
    & O/ u$ U7 b9 `8 E
23.                         {
    
24.                                 //保留小数点后三位精度
    % P. @$ |( `) I9 R; F1 i  c
25.                                 SensorData[chan].value = (float)(ADS1115_RawDataToVoltage(adcDataTemp[chan])*1000)/1000.0;
    / O% `1 X3 V7 M# g
26.                         }
    * b1 p$ G7 z4 f
27.                 }
    
28.                 //100ms 一个处理周期
    7 h! l8 E8 S. g+ A/ {) ?6 H
29.                 vTaskDelayUntil( &ticks, 100);
    
30.         }
    
31. }
    % r" R/ M# x  o7 ~" L0 p! z
32. 
    3 L& @' o; P! e9 i# C
33. 
    1 _7 H. \8 f0 I: L4 v+ j; \: |  H$ ?: \

复制代码

; Y; ?3 q; M3 q$ g/ q5 N