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
|
/*
* Author: William Penner <william.penner@intel.com>
* Copyright (c) 2014 Intel Corporation.
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*/
#pragma once
#include <string>
#include <mraa/i2c.h>
#include <math.h>
#define AM2315_NAME "am2315"
#define AM2315_I2C_ADDRESS 0x5c
#define AM2315_READ 0x03
#define AM2315_WRITE 0x10
/* AM2315 Commands */
#define AM2315_HUMIDITY 0x00
#define AM2315_TEMP 0x02
#define AM2315_MODEL 0x08
#define AM2315_VERSION 0x0A
#define AM2315_ID 0x0B
#define AM2315_STATUS 0x0F
#define AM2315_USER_A 0x10
#define AM2315_USER_B 0x12
#define AM2315_SAMPLE 2
#define HIGH_PRIORITY 99
namespace upm {
/**
* @brief AM2315 Temperature & Humidity Sensor library
* @defgroup am2315 libupm-am2315
* @ingroup adafruit i2c temp
*/
/**
* @library am2315
* @sensor am2315
* @comname AM2315 Temperature & Humidity Sensor
* @type temp
* @man adafruit
* @web http://www.adafruit.com/products/1293
* @con i2c
*
* @brief API for the AM2315 Temperature & Humidity Sensor
*
* AM2315 by Measurement Specialties
* (http://www.aosong.com/asp_bin/Products/en/AM2315.pdf)
* is a digital humidity sensor with temperature output.
* RH reports between 0 and 100%, and the temperature range is
* -40 to +125 degC.
* The sampling period of this sensor is 2 seconds. Reads occurring
* more often than that return cached data.
*
* @image html am2315.jpeg
* @snippet am2315.cxx Interesting
*/
class AM2315 {
public:
/**
* Instantiates an AM2315 object
*
* @param bus Number of the used bus
* @param devAddr Address of the used I2C device
* @param mode AM2315 oversampling
*/
AM2315 (int bus, int devAddr=AM2315_I2C_ADDRESS);
/**
* AM2315 object destructor; basically, it closes the I2C connection.
*/
~AM2315 ();
/**
* Gets the current measured humidity [RH]
*
* Data is updated every 2 seconds - accesses occurring more often than
* that return cached data
*/
float getHumidity(void);
/**
* Gets the humidity cell temperature [degC]
*
* Data is updated every 2 seconds - accesses occurring more often than
* that return cached data
*/
float getTemperature(void);
/**
* Gets the humidity cell temperature [degF]
*
* Data is updated every 2 seconds - accesses occurring more often than
* that return cached data
*/
float getTemperatureF(void);
/**
* Function intended to test the device and verify it
* is operating correctly.
*
*/
int testSensor(void);
/**
* Writes a four-byte (32b) register
*
* Note: these access routines are not the normal accesses to an I2C
* device. AM2315 contains a microcontroller that manages the
* actual readings. These handlers then make requests over I2C using
* a protocol defined by AM2315.
*
* @param reg Address of the register
* @param ival 32b value
*/
int i2cWriteReg_32(int reg, uint32_t ival);
/**
* Writes a two-byte (16b) register
*
* @param reg Address of the register
* @param ival 16b value
*/
int i2cWriteReg_16(int reg, uint16_t ival);
/**
* Writes a one-byte (8b) register
*
* @param reg Address of the register
* @param ival 8b value
*/
int i2cWriteReg_8(int reg, uint8_t ival);
/**
* Reads a four-byte register
*
* @param reg Address of the register
*/
uint32_t i2cReadReg_32 (int reg);
/**
* Reads a two-byte register
*
* @param reg Address of the register
*/
uint16_t i2cReadReg_16 (int reg);
/**
* Reads a one-byte register
*
* @param reg Address of the register
*/
uint8_t i2cReadReg_8 (int reg);
private:
char* m_name;
int m_controlAddr;
int m_bus;
mraa_i2c_context m_i2ControlCtx;
void update_values(void);
uint8_t i2cReadReg(int reg, uint8_t* data, int ilen);
int i2cWriteReg(uint8_t reg, uint8_t* data, uint8_t ilen);
uint16_t crc16(uint8_t* ptr, uint8_t len);
int32_t m_temperature;
int32_t m_humidity;
uint16_t m_model;
uint16_t m_version;
uint32_t m_id;
time_t m_last_time;
int m_base_priority;
pthread_t this_thread;
};
}
|
