STS-31介绍
详细参数请查看官方数据手册。



驱动源码
本驱动是基于软件模拟I2C库设计的，利用了它提供的I2CDevice_Struct数据类型以及I2C通讯所需要的接口。

头文件

1. /*
   
2. * sts31.h
   
3. *
   
4. *  Created on: Jun 2, 2020
   
5. *      Author: 81001
   
6. */
   
7. 
   
8. #ifndef SOURCE_ALWHALESLIB_HARDWARE_INC_STS31_H_
   
9. #define SOURCE_ALWHALESLIB_HARDWARE_INC_STS31_H_
   
10. 
    
11. //#ifdef STS31
    
12. #include "sts31.h"
    
13. #include "i2c_virtual.h"
    
14. 
    
15. //Define GPIO for STS31
    
16. #define STS31_1_SCL_PORT                'E'
    
17. #define STS31_1_SCL_PIN                        3
    
18. #define STS31_1_SDA_PORT                'E'
    
19. #define STS31_1_SDA_PIN                        2
    
20. 
    
21. #define STS31_2_SCL_PORT                'E'
    
22. #define STS31_2_SCL_PIN                        6
    
23. #define STS31_2_SDA_PORT                'E'
    
24. #define STS31_2_SDA_PIN                        5
    
25. 
    
26. #define STS31_3_SCL_PORT                'F'
    
27. #define STS31_3_SCL_PIN                        2
    
28. #define STS31_3_SDA_PORT                'F'
    
29. #define STS31_3_SDA_PIN                        1
    
30. 
    
31. #define STS31_4_SCL_PORT                'F'
    
32. #define STS31_4_SCL_PIN                        5
    
33. #define STS31_4_SDA_PORT                'F'
    
34. #define STS31_4_SDA_PIN                        4
    
35. 
    
36. #define STS31_5_SCL_PORT                'A'
    
37. #define STS31_5_SCL_PIN                        2
    
38. #define STS31_5_SDA_PORT                'A'
    
39. #define STS31_5_SDA_PIN                        1
    
40. 
    
41. #define STS31_6_SCL_PORT                'A'
    
42. #define STS31_6_SCL_PIN                        6
    
43. #define STS31_6_SDA_PORT                'A'
    
44. #define STS31_6_SDA_PIN                        5
    
45. 
    
46. #define STS31_7_SCL_PORT                'C'
    
47. #define STS31_7_SCL_PIN                        5
    
48. #define STS31_7_SDA_PORT                'C'
    
49. #define STS31_7_SDA_PIN                        4
    
50. 
    
51. #define STS31_8_SCL_PORT                'F'
    
52. #define STS31_8_SCL_PIN                        15
    
53. #define STS31_8_SDA_PORT                'F'
    
54. #define STS31_8_SDA_PIN                        14
    
55. 
    
56. #define STS31_9_SCL_PORT                'E'
    
57. #define STS31_9_SCL_PIN                        7
    
58. #define STS31_9_SDA_PORT                'G'
    
59. #define STS31_9_SDA_PIN                        1
    
60. 
    
61. #define STS31_10_SCL_PORT                'E'
    
62. #define STS31_10_SCL_PIN                        12
    
63. #define STS31_10_SDA_PORT                'E'
    
64. #define STS31_10_SDA_PIN                11
    
65. 
    
66. #define STS31_11_SCL_PORT                'E'
    
67. #define STS31_11_SCL_PIN                        15
    
68. #define STS31_11_SDA_PORT                'E'
    
69. #define STS31_11_SDA_PIN                14
    
70. 
    
71. #define STS31_12_SCL_PORT                'B'
    
72. #define STS31_12_SCL_PIN                        15
    
73. #define STS31_12_SDA_PORT                'B'
    
74. #define STS31_12_SDA_PIN                14
    
75. 
    
76. 
    
77. #define STS31_ADDRESS_0                                        0x4A        //ADDR PIN ->GND
    
78. #define STS31_ADDRESS_1                                        0x4B        //ADDR PIN ->VDD
    
79. 
    
80. //*************ADDR Initial********************/
    
81. #define STS31_ADDRESS                                STS31_ADDRESS_0                //ADDR PIN ->GND
    
82. #define STS31_ADDRESS_W                (STS31_ADDRESS<<1) | 0x00        //write address
    
83. #define STS31_ADDRESS_R                        (STS31_ADDRESS<<1) | 0x01        //read address
    
84. 
    
85. //single shot mode
    
86. #define STS31_SINGLE_SHOT_MODE_HIGH_REP_EN_CLKSTR                                0x2C06s
    
87. #define STS31_SINGLE_SHOT_MODE_MEDIUM_REP_EN_CLKSTR                                0x2C0D
    
88. #define STS31_SINGLE_SHOT_MODE_LOW_REP_EN_CLKSTR                                0x2C10
    
89. 
    
90. #define STS31_SINGLE_SHOT_MODE_HIGH_REP_DISEN_CLKSTR                        0x2400
    
91. #define STS31_SINGLE_SHOT_MODE_MEDIUM_REP_DISEN_CLKSTR                        0x240B
    
92. #define STS31_SINGLE_SHOT_MODE_LOW_REP_DISEN_CLKSTR                                0x2416
    
93. 
    
94. //continue mode
    
95. #define STS31_CONTINUE_MODE_HIGH_REP_05MPS                                                                 0x2032
    
96. #define STS31_CONTINUE_MODE_MEDIUM_REP_05MPS                                                         0x2024
    
97. #define STS31_CONTINUE_MODE_LOW_REP_05MPS                                                                         0x202F
    
98. 
    
99. #define STS31_CONTINUE_MODE_HIGH_REP_1MPS                                                                        0x2130
    
100. #define STS31_CONTINUE_MODE_MEDIUM_REP_1MPS                                                        0x2126
     
101. #define STS31_CONTINUE_MODE_LOW_REP_1MPS                                                                        0x212D
     
102. 
     
103. #define STS31_CONTINUE_MODE_HIGH_REP_2MPS                                                                        0x2236
     
104. #define STS31_CONTINUE_MODE_MEDIUM_REP_2MPS                                                        0x2220
     
105. #define STS31_CONTINUE_MODE_LOW_REP_2MPS                                                                        0x222B
     
106. 
     
107. #define STS31_CONTINUE_MODE_HIGH_REP_4MPS                                                                        0x2334
     
108. #define STS31_CONTINUE_MODE_MEDIUM_REP_4MPS                                                        0x2322
     
109. #define STS31_CONTINUE_MODE_LOW_REP_4MPS                                                                        0x2329
     
110. 
     
111. #define STS31_CONTINUE_MODE_HIGH_REP_10MPS                                                                0x2737
     
112. #define STS31_CONTINUE_MODE_MEDIUM_REP_10MPS                                                        0x2721
     
113. #define STS31_CONTINUE_MODE_LOW_REP_10MPS                                                                        0x272A
     
114. 
     
115. #define STS31_FETCH_DATA                                                                                                                                                        0xE000
     
116. 
     
117. //Break command/Stop periodic data acquisition mode
     
118. #define STS31_BREAK_CMD                                                                                                                                0x3093
     
119. 
     
120. #define STS31_RESET_CMD                                                                                                                                0x30A2
     
121. #define STS31_HEATER_EN                                                                                                                                        0x306D
     
122. #define STS31_HEATER_DISEN                                                                                                                        0x3066
     
123. #define STS31_READ_STATUS                                                                                                                                0xF32D
     
124. #define STS31_CLEAR_STATUS                                                                                                                        0x3041
     
125. 
     
126. #define STS31_DEV_NUM                12
     
127. 
     
128. 
     
129. typedef I2CDevice_Struct STS31_Device;
     
130. 
     
131. extern STS31_Device STS31_DeviceArray[STS31_DEV_NUM];
     
132. 
     
133. 
     
134. uint8_t STS31_Init(STS31_Device *sts31Dev);
     
135. void STS31_InitAll();
     
136. 
     
137. uint8_t  STS_ReadData(STS31_Device *sts31Dev, uint8_t *dataTemp);
     
138. float STS_GetTemperature(STS31_Device *sts31Dev);
     
139. 
     
140. //#endif
     
141. #endif /* SOURCE_ALWHALESLIB_HARDWARE_INC_STS31_H_ */

复制代码

源文件

1. /*
   
2. * sts31.c
   
3. *
   
4. *  Created on: Jun 2, 2020
   
5. *      Author: 81001
   
6. */
   
7. #include "sts31.h"
   
8. #include "check.h"
   
9. 
   
10. STS31_Device STS31_DeviceArray[STS31_DEV_NUM]=
    
11. {
    
12.         {.port = {.SclPort=STS31_1_SCL_PORT,.SclPin=STS31_1_SCL_PIN,.SdaPort=STS31_1_SDA_PORT,.SdaPin=STS31_1_SDA_PIN}, .address = STS31_ADDRESS, .devStatus = 0},
    
13.         {.port = {.SclPort=STS31_2_SCL_PORT,.SclPin=STS31_2_SCL_PIN,.SdaPort=STS31_2_SDA_PORT,.SdaPin=STS31_2_SDA_PIN}, .address = STS31_ADDRESS, .devStatus = 0},
    
14.         {.port = {.SclPort=STS31_3_SCL_PORT,.SclPin=STS31_3_SCL_PIN,.SdaPort=STS31_3_SDA_PORT,.SdaPin=STS31_3_SDA_PIN}, .address = STS31_ADDRESS, .devStatus = 0},
    
15.         {.port = {.SclPort=STS31_4_SCL_PORT,.SclPin=STS31_4_SCL_PIN,.SdaPort=STS31_4_SDA_PORT,.SdaPin=STS31_4_SDA_PIN}, .address = STS31_ADDRESS, .devStatus = 0},
    
16.         {.port = {.SclPort=STS31_5_SCL_PORT,.SclPin=STS31_5_SCL_PIN,.SdaPort=STS31_5_SDA_PORT,.SdaPin=STS31_5_SDA_PIN}, .address = STS31_ADDRESS, .devStatus = 0},
    
17.         {.port = {.SclPort=STS31_6_SCL_PORT,.SclPin=STS31_6_SCL_PIN,.SdaPort=STS31_6_SDA_PORT,.SdaPin=STS31_6_SDA_PIN}, .address = STS31_ADDRESS, .devStatus = 0},
    
18.         {.port = {.SclPort=STS31_7_SCL_PORT,.SclPin=STS31_7_SCL_PIN,.SdaPort=STS31_7_SDA_PORT,.SdaPin=STS31_7_SDA_PIN}, .address = STS31_ADDRESS, .devStatus = 0},
    
19.         {.port = {.SclPort=STS31_8_SCL_PORT,.SclPin=STS31_8_SCL_PIN,.SdaPort=STS31_8_SDA_PORT,.SdaPin=STS31_8_SDA_PIN}, .address = STS31_ADDRESS, .devStatus = 0},
    
20.         {.port = {.SclPort=STS31_9_SCL_PORT,.SclPin=STS31_9_SCL_PIN,.SdaPort=STS31_9_SDA_PORT,.SdaPin=STS31_9_SDA_PIN}, .address = STS31_ADDRESS, .devStatus = 0},
    
21.         {.port = {.SclPort=STS31_10_SCL_PORT,.SclPin=STS31_10_SCL_PIN,.SdaPort=STS31_10_SDA_PORT,.SdaPin=STS31_10_SDA_PIN}, .address = STS31_ADDRESS, .devStatus = 0},
    
22.         {.port = {.SclPort=STS31_11_SCL_PORT,.SclPin=STS31_11_SCL_PIN,.SdaPort=STS31_11_SDA_PORT,.SdaPin=STS31_11_SDA_PIN}, .address = STS31_ADDRESS, .devStatus = 0},
    
23.         {.port = {.SclPort=STS31_12_SCL_PORT,.SclPin=STS31_12_SCL_PIN,.SdaPort=STS31_12_SDA_PORT,.SdaPin=STS31_12_SDA_PIN}, .address = STS31_ADDRESS, .devStatus = 0},
    
24. };
    
25. 
    
26. 
    
27. /**
    
28. * @brief 初始化STS31温度传感器
    
29. *                 由于STS31温度传感器需要初始化后才能工作，因此需要在读取温度之前调用此函数。
    
30. *                 考虑到设备不存在或者通讯出错等因素，需要验证初始化设备是否成功。
    
31. *                 有两种方式可以完成验证：1. 获取此函数的返回值 2. 获取STS31_Device的devStatus成员的值。
    
32. *                 推荐采用第二种方式验证是否完成配置。此值也可用作STS31的插拔检测。
    
33. * @param sts31Dev: 需要初始化的I2C设备
    
34. * @return 初始化的结果（0：初始化失败，1：初始化成功）
    
35. */
    
36. uint8_t STS31_Init(STS31_Device *sts31Dev)
    
37. {
    
38. 
    
39.         I2C_Virtual_SetPin(sts31Dev->port.SdaPort, sts31Dev->port.SdaPin, sts31Dev->port.SclPort, sts31Dev->port.SclPin);
    
40. 
    
41.         I2C_Virtual_Start();                                                                                                                                        //启动总线
    
42.         I2C_Virtual_SendByte(sts31Dev->address<<0x01 | 0x00);                                //发送器件地址（写）
    
43. 
    
44.         if (I2C_Virtual_ack == 0)
    
45.         {
    
46.                 sts31Dev->devStatus = 0;
    
47.                 return 0;
    
48.         }
    
49. 
    
50.         I2C_Virtual_SendByte((STS31_CONTINUE_MODE_MEDIUM_REP_2MPS >> 8) & 0xFF);
    
51. 
    
52.         if (I2C_Virtual_ack == 0)
    
53.         {
    
54.                 sts31Dev->devStatus = 0;
    
55.                 return 0;
    
56.         }
    
57. 
    
58.         I2C_Virtual_SendByte(STS31_CONTINUE_MODE_MEDIUM_REP_2MPS & 0xFF);
    
59. 
    
60.         if (I2C_Virtual_ack == 0)
    
61.         {
    
62.                 sts31Dev->devStatus = 0;
    
63.                 return 0;
    
64.         }
    
65. 
    
66.         I2C_Virtual_Stop();
    
67. 
    
68.         sts31Dev->devStatus = 1;
    
69.         return 1;
    
70. }
    
71. 
    
72. 
    
73. /**
    
74. * 将STS31_DeviceArray中的成员依次进行初始化
    
75. */
    
76. void STS31_InitAll()
    
77. {
    
78.         for(uint8_t i = 0; i<STS31_DEV_NUM; i++)
    
79.         {
    
80.                 STS31_Init(&STS31_DeviceArray<i>);
    
81.         }
    
82. }
    
83. 
    
84. 
    
85. /**
    
86. * @brief 读取STS31的温度原始数据
    
87. * @param sts31Dev: 需要操作的I2C设备
    
88. * @param dataTemp: 传入需要读出的数据缓存地址（3个字节）
    
89. * @return 读取数据的执行结果，0：读取失败；1：读取成功
    
90. */
    
91. uint8_t STS_ReadData(STS31_Device *sts31Dev, uint8_t *dataTemp)
    
92. {
    
93.         I2C_Virtual_SetPin(sts31Dev->port.SdaPort, sts31Dev->port.SdaPin, sts31Dev->port.SclPort, sts31Dev->port.SclPin);
    
94. 
    
95.         I2C_Virtual_Start();                                                                                                                                //启动总线
    
96.         I2C_Virtual_SendByte(sts31Dev->address<<0x01 | 0x00);                        //发送器件地址（写）
    
97. 
    
98.         if (I2C_Virtual_ack == 0)
    
99.         {
    
100.                 sts31Dev->devStatus = 0;
     
101.                 return 0;
     
102.         }
     
103. 
     
104. 
     
105.         I2C_Virtual_SendByte((STS31_FETCH_DATA >> 8) & 0xFF);
     
106. 
     
107.         if (I2C_Virtual_ack == 0)
     
108.         {
     
109.                 sts31Dev->devStatus = 0;
     
110.                 return 0;
     
111.         }
     
112. 
     
113. 
     
114.         I2C_Virtual_SendByte(STS31_FETCH_DATA & 0xFF);
     
115. 
     
116.         if (I2C_Virtual_ack == 0)
     
117.         {
     
118.                 sts31Dev->devStatus = 0;
     
119.                 return 0;
     
120.         }
     
121. 
     
122.         I2C_Virtual_Stop();
     
123. 
     
124.         delay_us(10);
     
125. 
     
126.         I2C_Virtual_Start();                                                                                                                        //启动总线
     
127.         I2C_Virtual_SendByte(sts31Dev->address<<0x01 | 0x01);                //发送器件地址（读）
     
128. 
     
129.         if (I2C_Virtual_ack == 0)
     
130.         {
     
131.                 sts31Dev->devStatus = 0;
     
132.                 return 0;
     
133.         }
     
134. 
     
135.         dataTemp[0] = I2C_Virtual_RcvByte();                                                                //接收数据
     
136.         I2C_Virtual_Ack();                                                                                                                        //发送就答位
     
137. 
     
138.         dataTemp[1] = I2C_Virtual_RcvByte();
     
139.         I2C_Virtual_Ack();                                                                                                                        //发送就答位
     
140. 
     
141.         dataTemp[2] = I2C_Virtual_RcvByte();
     
142.         I2C_Virtual_NoAck();                                                                                                        //发送非应位
     
143. 
     
144.         I2C_Virtual_Stop();                                                                                                                 //结束总线
     
145. 
     
146.         sts31Dev->devStatus = 1;
     
147.         return 1;
     
148. }
     
149. 
     
150. 
     
151. /**
     
152. * @brief 读取STS31的温度数据
     
153. *                 由STS_ReadData函数进一步封装得到，需要特别注意的是，如果读取出错将会返回919。
     
154. * @param sts31Dev: 需要操作的I2C设备
     
155. * @return 温度数值（float类型）
     
156. */
     
157. float STS_GetTemperature(STS31_Device *sts31Dev)
     
158. {
     
159.         float data = 0;
     
160.         uint8_t dataTemp[3] = { 0 };
     
161. 
     
162.         STS_ReadData(sts31Dev, dataTemp);
     
163. 
     
164.         if (CheckCRC8(dataTemp, 3) != 0)
     
165.         {
     
166.                 data = (-45 + 175 * (dataTemp[0] * 256 + dataTemp[1]) / 65535.0);
     
167.         }
     
168.         else
     
169.         {
     
170.                 data = 919;
     
171.         }
     
172. 
     
173.         return data;
     
174. }</i>

复制代码

应用指南
定义并初始化设备结构体变量

1. #define STS31_DEV_NUM                12
   
2. typedef I2CDevice_Struct STS31_Device;
   
3. 
   
4. //Define GPIO for STS31
   
5. #define STS31_1_SCL_PORT                'E'
   
6. #define STS31_1_SCL_PIN                        3
   
7. #define STS31_1_SDA_PORT                'E'
   
8. #define STS31_1_SDA_PIN                        2
   
9. 
   
10. #define STS31_2_SCL_PORT                'E'
    
11. #define STS31_2_SCL_PIN                        6
    
12. #define STS31_2_SDA_PORT                'E'
    
13. #define STS31_2_SDA_PIN                        5
    
14. 
    
15. #define STS31_3_SCL_PORT                'F'
    
16. #define STS31_3_SCL_PIN                        2
    
17. #define STS31_3_SDA_PORT                'F'
    
18. #define STS31_3_SDA_PIN                        1
    
19. 
    
20. #define STS31_4_SCL_PORT                'F'
    
21. #define STS31_4_SCL_PIN                        5
    
22. #define STS31_4_SDA_PORT                'F'
    
23. #define STS31_4_SDA_PIN                        4
    
24. 
    
25. #define STS31_5_SCL_PORT                'A'
    
26. #define STS31_5_SCL_PIN                        2
    
27. #define STS31_5_SDA_PORT                'A'
    
28. #define STS31_5_SDA_PIN                        1
    
29. 
    
30. #define STS31_6_SCL_PORT                'A'
    
31. #define STS31_6_SCL_PIN                        6
    
32. #define STS31_6_SDA_PORT                'A'
    
33. #define STS31_6_SDA_PIN                        5
    
34. 
    
35. #define STS31_7_SCL_PORT                'C'
    
36. #define STS31_7_SCL_PIN                        5
    
37. #define STS31_7_SDA_PORT                'C'
    
38. #define STS31_7_SDA_PIN                        4
    
39. 
    
40. #define STS31_8_SCL_PORT                'F'
    
41. #define STS31_8_SCL_PIN                        15
    
42. #define STS31_8_SDA_PORT                'F'
    
43. #define STS31_8_SDA_PIN                        14
    
44. 
    
45. #define STS31_9_SCL_PORT                'E'
    
46. #define STS31_9_SCL_PIN                        7
    
47. #define STS31_9_SDA_PORT                'G'
    
48. #define STS31_9_SDA_PIN                        1
    
49. 
    
50. #define STS31_10_SCL_PORT                'E'
    
51. #define STS31_10_SCL_PIN                12
    
52. #define STS31_10_SDA_PORT                'E'
    
53. #define STS31_10_SDA_PIN                11
    
54. 
    
55. #define STS31_11_SCL_PORT                'E'
    
56. #define STS31_11_SCL_PIN                15
    
57. #define STS31_11_SDA_PORT                'E'
    
58. #define STS31_11_SDA_PIN                14
    
59. 
    
60. #define STS31_12_SCL_PORT                'B'
    
61. #define STS31_12_SCL_PIN                15
    
62. #define STS31_12_SDA_PORT                'B'
    
63. #define STS31_12_SDA_PIN                14
    
64. 
    
65. extern STS31_Device STS31_DeviceArray[STS31_DEV_NUM];
    
66. 
    
67. STS31_Device STS31_DeviceArray[STS31_DEV_NUM]=
    
68. {
    
69.         {.port = {.SclPort=STS31_1_SCL_PORT,.SclPin=STS31_1_SCL_PIN,.SdaPort=STS31_1_SDA_PORT,.SdaPin=STS31_1_SDA_PIN}, .address = STS31_ADDRESS, .devStatus = 0},
    
70.         {.port = {.SclPort=STS31_2_SCL_PORT,.SclPin=STS31_2_SCL_PIN,.SdaPort=STS31_2_SDA_PORT,.SdaPin=STS31_2_SDA_PIN}, .address = STS31_ADDRESS, .devStatus = 0},
    
71.         {.port = {.SclPort=STS31_3_SCL_PORT,.SclPin=STS31_3_SCL_PIN,.SdaPort=STS31_3_SDA_PORT,.SdaPin=STS31_3_SDA_PIN}, .address = STS31_ADDRESS, .devStatus = 0},
    
72.         {.port = {.SclPort=STS31_4_SCL_PORT,.SclPin=STS31_4_SCL_PIN,.SdaPort=STS31_4_SDA_PORT,.SdaPin=STS31_4_SDA_PIN}, .address = STS31_ADDRESS, .devStatus = 0},
    
73.         {.port = {.SclPort=STS31_5_SCL_PORT,.SclPin=STS31_5_SCL_PIN,.SdaPort=STS31_5_SDA_PORT,.SdaPin=STS31_5_SDA_PIN}, .address = STS31_ADDRESS, .devStatus = 0},
    
74.         {.port = {.SclPort=STS31_6_SCL_PORT,.SclPin=STS31_6_SCL_PIN,.SdaPort=STS31_6_SDA_PORT,.SdaPin=STS31_6_SDA_PIN}, .address = STS31_ADDRESS, .devStatus = 0},
    
75.         {.port = {.SclPort=STS31_7_SCL_PORT,.SclPin=STS31_7_SCL_PIN,.SdaPort=STS31_7_SDA_PORT,.SdaPin=STS31_7_SDA_PIN}, .address = STS31_ADDRESS, .devStatus = 0},
    
76.         {.port = {.SclPort=STS31_8_SCL_PORT,.SclPin=STS31_8_SCL_PIN,.SdaPort=STS31_8_SDA_PORT,.SdaPin=STS31_8_SDA_PIN}, .address = STS31_ADDRESS, .devStatus = 0},
    
77.         {.port = {.SclPort=STS31_9_SCL_PORT,.SclPin=STS31_9_SCL_PIN,.SdaPort=STS31_9_SDA_PORT,.SdaPin=STS31_9_SDA_PIN}, .address = STS31_ADDRESS, .devStatus = 0},
    
78.         {.port = {.SclPort=STS31_10_SCL_PORT,.SclPin=STS31_10_SCL_PIN,.SdaPort=STS31_10_SDA_PORT,.SdaPin=STS31_10_SDA_PIN}, .address = STS31_ADDRESS, .devStatus = 0},
    
79.         {.port = {.SclPort=STS31_11_SCL_PORT,.SclPin=STS31_11_SCL_PIN,.SdaPort=STS31_11_SDA_PORT,.SdaPin=STS31_11_SDA_PIN}, .address = STS31_ADDRESS, .devStatus = 0},
    
80.         {.port = {.SclPort=STS31_12_SCL_PORT,.SclPin=STS31_12_SCL_PIN,.SdaPort=STS31_12_SDA_PORT,.SdaPin=STS31_12_SDA_PIN}, .address = STS31_ADDRESS, .devStatus = 0},
    
81. };

复制代码

配置STS-31芯片
在工程的合适位置调用void STS31_InitAll()或uint8_t STS31_Init(STS31_Device *sts31Dev)完成初始化。初始化函数按照默认的配置方式（STS31_CONTINUE_MODE_MEDIUM_REP_2MPS）对芯片进行初始化，如果需要其他的配置方式需要重写此函数。

需要特别注意的是由于STS31温度传感器需要初始化后才能工作，因此需要在读取温度之前调用此函数。考虑到设备不存在或者通讯出错等因素，需要验证初始化设备是否成功。有两种方式可以完成验证：

1.获取此函数的返回值，0为配置失败，1为配置成功。
2.获取STS31_Device的devStatus成员的值。
推荐采用第二种方式验证是否完成配置。此值也可用作STS31的插拔检测，即当sts31Dev->devStatus = 0时，可认为通讯失败或者器件不存在，此时可以选择周期性的轮询初始化函数，以检测STS-31芯片是否恢复工作。

读取STS-31温度
在工程合适位置调用uint8_t STS_ReadData(STS31_Device *sts31Dev, uint8_t *dataTemp)或float STS_GetTemperature(STS31_Device *sts31Dev)。后面的函数是对前面的封装，可以直接调用以获取传感器采集的温度数据，如果采集或通讯出错，将返回数值919。

特别说明
如果在PCB加热器上应用了此传感器作为温度的反馈，应该特别注意传感器配置与读取数据的有效性。当传感器失效时，应该及时的关闭加热器，以免温度调节失控。