-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathDFRobot_LM75B.h
248 lines (223 loc) · 8.96 KB
/
DFRobot_LM75B.h
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
/*!
@file DFRobot_LM75B.h
@brief 定义DFRobot_LM75B 类的基础结构
@copyright Copyright (c) 2010 DFRobot Co.Ltd (http://www.dfrobot.com)
@licence The MIT License (MIT)
@author [fengli]([email protected])
@version V1.0
@date 2019-07-28
@get from https://www.dfrobot.com
@https://github.com/DFRobot/DFRobot_LM75B
*/
#ifndef DFROBOT_LM75B_H
#define DFROBOT_LM75B_H
#if ARDUINO >= 100
#include "Arduino.h"
#else
#include "WProgram.h"
#endif
#include <Wire.h>
//#define ENABLE_DBG
#define REG_LM75B_TEMP 0x00
#define REG_LM75B_CONF 0x01
#define REG_LM75B_THYST 0x02
#define REG_LM75B_TOS 0x03
#ifdef ENABLE_DBG
#define DBG(...) {Serial.print("[");Serial.print(__FUNCTION__); Serial.print("(): "); Serial.print(__LINE__); Serial.print(" ] "); Serial.println(__VA_ARGS__);}
#else
#define DBG(...)
#endif
class DFRobot_LM75B {
public:
#define ERR_OK 0 //无错误
#define ERR_DATA_BUS -1 //数据总线错误
#define ERR_IC_VERSION -2 //芯片版本不匹配
/*!
The Configuration register (Conf) is a write/read register and contains an 8-bit
non-complement data byte that is used to configure the device for different operation
conditions.
------------------------------------------------------------------------------------------
| b7 | b6 | b5 | b4 | b3 | b2 | b1 | b0 |
------------------------------------------------------------------------------------------
| reserved | OS_F_QUE | OS_POL |OS_COMP_INT|SHUTDOWN |
------------------------------------------------------------------------------------------
默认设置 device operation mode selection：(0*)normal
OS operation mode selection ：(0*)OS comparator
OS polarity selection ：(0*)OS active LOW
OS fault queue programming ：(00*)queue value = 1
reserved ： 000*
*/
typedef struct {
uint8_t sSHUTDOWN: 1;
uint8_t sOS_COMP_INT: 1;
uint8_t sOS_POL: 1;
uint8_t sOS_F_QUE: 2;
uint8_t sRESERVED: 3;
} __attribute__ ((packed)) sMode_t;
/*!
The LM75B can be configured for different operation conditions. It can be set in normal
mode to periodically monitor the ambient temperature, or in shutdown mode to minimize
power consumption.The device operation mode is selected by programming bit B0 (SHUTDOWN) of
register Conf.
*/
typedef enum {
eNormal = 0, /**<在此模式下，数据采集周期为100ms,其中10ms用于数据转换，需要电流为200mA，另外90ms处于idle状态，需要电流为10uA>**/
eShutdown = 1 /**<在此模式下，数据采集停止，但IIC通信不受影响，寄存器也可以正常读写>**/
} eShutDownMode_t;
/*!
The main difference between the two modes is that in OS comparator mode, the OS
output becomes active when Temp has exceeded Tth(ots) and reset when Temp has
dropped below Thys, reading a register or putting the device into shutdown mode does not
change the state of the OS output; while in OS interrupt mode, once it has been activated
either by exceeding Tth(ots) or dropping below Thys, the OS output will remain active
indefinitely until reading a register, then the OS output is reset.The OS mode is selected
by programming bit B1 (OS_COMP_INT) of register Conf.
*/
typedef enum {
eComparator = 0x00, /**<在此模式下，OS口输出采用比较器模式，>**/
eInterrupt = 0x01 /**<在此模式下，OS口输出采用中断模式>**/
} eOSMode_t;
/*!
The OS output active state can be selected as HIGH or LOW by programming bit B2
(OS_POL) of register Conf
*/
typedef enum {
eActive_LOW = 0, /**<在此模式下，OS的active状态为低电平>**/
eActive_HIGH = 1 /**<在此模式下，OS的active状态为高电平>**/
} eOSPolarityMode_t;
/*!
It is provided to avoid false tripping due to noise.fault queue is also defined as the number of
consecutive conversions returning a temperature trip.The value of fault queue is selectable by programming
the two bits B4 and B3 (OS_F_QUE[1:0]) in register Conf.
*/
typedef enum {
eValue1 = 1,/**<在此模式下，故障队列数为 1>**/
eValue2 = 2,/**<在此模式下，故障队列数为 2>**/
eValue3 = 4,/**<在此模式下，故障队列数为 4>**/
eValue4 = 6 /**<在此模式下，故障队列数为 6>**/
} eQueueValue_t;
/**
@brief 构造函数
@param pWire I2C总线指针对象，构造设备，可传参数也可不传参数，默认Wire
@param addr 7位I2C地址,由前三位决定地址的值，取值(0x48/0x49/0x5A/0x5B/0x5C/0x5D/0x5E/0x5F)默认0x48
@n IIC地址由构成如下图所示
6 5 4 3 2 1 0
1 0 0 1 A2 A1 A0
@n 地址的定义如下表所示,可以通过跳线来改变地址：默认为0x48
1 0 0 1 | A2 A1 A0
1 0 0 1 | 1 1 1 0x5F
1 0 0 1 | 1 1 0 0x5E
1 0 0 1 | 1 0 1 0x5D
1 0 0 1 | 1 0 0 0x5C
1 0 0 1 | 0 1 1 0x5B
1 0 0 1 | 0 1 0 0x5A
1 0 0 1 | 0 0 1 0x49
1 0 0 1 | 0 0 0 0x48
*/
DFRobot_LM75B(TwoWire *pWire = &Wire, uint8_t address = 0x48) {
_pWire = pWire;
_address = address;
};
/**
@brief 初始化函数
@return 返回0表示初始化成功，返回其他值表示初始化失败，返回错误码
*/
int begin();
/**
@brief 获取温度值.
@return 返回温度值，单位是摄氏度.
@n 范围是 -55°C 到 +125°C
*/
float getTempC();
/**
@brief 获取阈值温度.
@param 返回温度值，单位是摄氏度.
@n 范围是 -55°C 到 +125°C.
*/
float getTosC(void );
/**
@brief 获取滞后温度(类似于自定义的温度范围的最小值).
@param 返回温度值，单位是摄氏度.
@n 范围是 -55°C 到 +125°C.
*/
float getThystC();
/**
@brief 设置阈值温度
@param 温度值，单位是摄氏度，需满足Tos% 0.5 == 0 ；
@n 范围是 -55°C 到 +125°C
*/
//uint8_t getconfReg();
void setTos(float Tos);
/**
@brief 设置滞后温度(类似于自定义的温度范围的最小值).
@param 温度值，单位是摄氏度，需满足Thyst% 0.5 == 0 ；
@n 范围是 -55°C 到 +125°C,Thyst 必须小于等于 Tos 的值.
*/
void setThyst(float Thyst);
/**
@brief 获取故障队列的值.
@return 返回故障队列的值.
*/
DFRobot_LM75B::eQueueValue_t getQueueValue();
/**
@brief 设置故障队列的值.
@param eQueueValue_t类型的值，代表故障队列数
*/
void setQueueValue(DFRobot_LM75B::eQueueValue_t value);
/**
@brief 得到芯片的工作模式的模式.
@return 0或1 .
@n 0：Normal(正常模式)
@n 1：interrupt(关断模式)
*/
DFRobot_LM75B::eShutDownMode_t getShutDownMode();
/**
@brief 设置芯片的工作模式.
@param eQueueValue_t类型的值，代表芯片工作模式
*/
void setShutDownMode(DFRobot_LM75B::eShutDownMode_t ShutDownMode);
/**
@brief 得到OS引脚的active状态是高电平还是低电平.
@return 0或1 .
@n 0：LOW(active LOW)
@n 1：HIGH(active HIGH)
*/
DFRobot_LM75B::eOSPolarityMode_t getOSPolarityMode();
/**
@brief 设置OS引脚的active状态是高电平还是低电平..
@param eOSPolarityMode_t类型的值，代表OS引脚的极性
*/
void setOSPolarityMode(DFRobot_LM75B::eOSPolarityMode_t polarityMode);
/**
@brief 得到OS引脚的工作模式.
@return 0或1 .
@n 0：OS comparator(比较器模式)
@n 1：OS interrupt(中断模式)
*/
DFRobot_LM75B::eOSMode_t getOSMode();
/**
@brief 设置OS引脚的工作模式..
@param eOSMode_t类型的值，代表OS引脚的工作模式.
*/
void setOSMode(eOSMode_t OSMode);
private:
/**
@brief 通过IIC总线写入寄存器值
@param reg 寄存器地址 8bits
@param pBuf 要写入数据的存放缓存
@param size 要写入数据的长度
@return 返回实际读取的长度，返回0表示读取失败
*/
void writeReg(uint8_t reg, void* pBuf, size_t size) ;
/**
@brief 读取寄存器函数，设计为虚函数，由派生类实现函数体
@param reg 寄存器地址 8bits
@param pBuf 要写入数据的存放缓存
@param size 要写入数据的长度
@return 返回实际读取的长度，返回0表示读取失败
*/
uint8_t readReg(uint8_t reg, void* pBuf, size_t size);
TwoWire *_pWire;
uint8_t _address;
};
#endif