Go to the documentation of this file.
28 #ifndef ENVIRONMENT3_H
29 #define ENVIRONMENT3_H
35 #include "drv_digital_out.h"
36 #include "drv_digital_in.h"
37 #include "drv_i2c_master.h"
38 #include "drv_spi_master.h"
60 #define ENVIRONMENT3_REG_STATUS 0x73
61 #define ENVIRONMENT3_REG_VARIANT_ID 0xF0
62 #define ENVIRONMENT3_REG_RESET 0xE0
63 #define ENVIRONMENT3_REG_CHIP_ID 0xD0
64 #define ENVIRONMENT3_REG_CONFIG 0x75
65 #define ENVIRONMENT3_REG_CTRL_MEAS 0x74
66 #define ENVIRONMENT3_REG_CTRL_HUM 0x72
67 #define ENVIRONMENT3_REG_CTRL_GAS_1 0x71
68 #define ENVIRONMENT3_REG_CTRL_GAS_0 0x70
69 #define ENVIRONMENT3_REG_GAS_WAIT_SHARED 0x6E
70 #define ENVIRONMENT3_REG_GAS_WAIT_0 0x64
71 #define ENVIRONMENT3_REG_RES_HEAT_0 0x5A
72 #define ENVIRONMENT3_REG_IDAC_HEAT_0 0x50
73 #define ENVIRONMENT3_REG_GAS_R_LSB_FIELD_2 0x4F
74 #define ENVIRONMENT3_REG_GAS_R_MSB_FIELD_2 0x4E
75 #define ENVIRONMENT3_REG_HUM_LSB_FIELD_2 0x48
76 #define ENVIRONMENT3_REG_HUM_MSB_FIELD_2 0x47
77 #define ENVIRONMENT3_REG_TEMP_XLSB_FIELD_2 0x46
78 #define ENVIRONMENT3_REG_TEMP_LSB_FIELD_2 0x45
79 #define ENVIRONMENT3_REG_TEMP_MSB_FIELD_2 0x44
80 #define ENVIRONMENT3_REG_PRESS_XLSB_FIELD_2 0x43
81 #define ENVIRONMENT3_REG_PRESS_LSB_FIELD_2 0x42
82 #define ENVIRONMENT3_REG_PRESS_MSB_FIELD_2 0x41
83 #define ENVIRONMENT3_REG_SUB_MEAS_INDEX_FIELD_2 0x40
84 #define ENVIRONMENT3_REG_MEAS_STATUS_FIELD_2 0x3F
85 #define ENVIRONMENT3_REG_GAS_R_LSB_FIELD_1 0x3E
86 #define ENVIRONMENT3_REG_GAS_R_MSB_FIELD_1 0x3D
87 #define ENVIRONMENT3_REG_HUM_LSB_FIELD_1 0x37
88 #define ENVIRONMENT3_REG_HUM_MSB_FIELD_1 0x36
89 #define ENVIRONMENT3_REG_TEMP_XLSB_FIELD_1 0x35
90 #define ENVIRONMENT3_REG_TEMP_LSB_FIELD_1 0x34
91 #define ENVIRONMENT3_REG_TEMP_MSB_FIELD_1 0x33
92 #define ENVIRONMENT3_REG_PRESS_XLSB_FIELD_1 0x32
93 #define ENVIRONMENT3_REG_PRESS_LSB_FIELD_1 0x31
94 #define ENVIRONMENT3_REG_PRESS_MSB_FIELD_1 0x30
95 #define ENVIRONMENT3_REG_SUB_MEAS_INDEX_FIELD_1 0x2F
96 #define ENVIRONMENT3_REG_MEAS_STATUS_FIELD_1 0x2E
97 #define ENVIRONMENT3_REG_GAS_R_LSB_FIELD_0 0x2D
98 #define ENVIRONMENT3_REG_GAS_R_MSB_FIELD_0 0x2C
99 #define ENVIRONMENT3_REG_HUM_LSB_FIELD_0 0x26
100 #define ENVIRONMENT3_REG_HUM_MSB_FIELD_0 0x25
101 #define ENVIRONMENT3_REG_TEMP_XLSB_FIELD_0 0x24
102 #define ENVIRONMENT3_REG_TEMP_LSB_FIELD_0 0x23
103 #define ENVIRONMENT3_REG_TEMP_MSB_FIELD_0 0x22
104 #define ENVIRONMENT3_REG_PRESS_XLSB_FIELD_0 0x21
105 #define ENVIRONMENT3_REG_PRESS_LSB_FIELD_0 0x20
106 #define ENVIRONMENT3_REG_PRESS_MSB_FIELD_0 0x1F
107 #define ENVIRONMENT3_REG_SUB_MEAS_INDEX_FIELD_0 0x1E
108 #define ENVIRONMENT3_REG_MEAS_STATUS_FIELD_0 0x1D
109 #define ENVIRONMENT3_REG_MEM_PAGE 0xF3
110 #define ENVIRONMENT3_REG_UNIQUE_ID 0x83
111 #define ENVIRONMENT3_REG_COEFF_1 0x8A
112 #define ENVIRONMENT3_REG_COEFF_2 0xE1
113 #define ENVIRONMENT3_REG_COEFF_3 0x00
131 #define ENVIRONMENT3_CHIP_ID 0x61
137 #define ENVIRONMENT3_SOFT_RESET 0xB6
143 #define ENVIRONMENT3_E_NULL_PTR -2
144 #define ENVIRONMENT3_E_COM_FAIL -3
145 #define ENVIRONMENT3_E_INVALID_LENGTH -4
146 #define ENVIRONMENT3_W_DEFINE_OP_MODE 1
147 #define ENVIRONMENT3_W_NO_NEW_DATA 2
153 #define ENVIRONMENT3_NBCONV_MASK 0x0F
154 #define ENVIRONMENT3_FILTER_MASK 0x1C
155 #define ENVIRONMENT3_ODR3_MASK 0x80
156 #define ENVIRONMENT3_ODR20_MASK 0xE0
157 #define ENVIRONMENT3_OST_MASK 0xE0
158 #define ENVIRONMENT3_OSP_MASK 0x1C
159 #define ENVIRONMENT3_OSH_MASK 0x07
160 #define ENVIRONMENT3_HCTRL_MASK 0x08
161 #define ENVIRONMENT3_RUN_GAS_MASK 0x30
162 #define ENVIRONMENT3_MODE_MASK 0x03
163 #define ENVIRONMENT3_RHRANGE_MASK 0x30
164 #define ENVIRONMENT3_RSERROR_MASK 0xF0
165 #define ENVIRONMENT3_NEW_DATA_MASK 0x80
166 #define ENVIRONMENT3_GAS_INDEX_MASK 0x0F
167 #define ENVIRONMENT3_GAS_RANGE_MASK 0x0F
168 #define ENVIRONMENT3_GASM_VALID_MASK 0x20
169 #define ENVIRONMENT3_HEAT_STAB_MASK 0x10
170 #define ENVIRONMENT3_MEM_PAGE_MASK 0x10
171 #define ENVIRONMENT3_BIT_H1_DATA_MASK 0x0F
172 #define ENVIRONMENT3_HUM_REG_SHIFT_VAL_MASK 0x04
173 #define ENVIRONMENT3_SPI_READ_MASK 0x80
174 #define ENVIRONMENT3_SPI_WRITE_MASK 0x7F
180 #define ENVIRONMENT3_FILTER_POS 2
181 #define ENVIRONMENT3_OST_POS 5
182 #define ENVIRONMENT3_OSP_POS 2
183 #define ENVIRONMENT3_ODR3_POS 7
184 #define ENVIRONMENT3_ODR20_POS 5
185 #define ENVIRONMENT3_RUN_GAS_POS 4
186 #define ENVIRONMENT3_HCTRL_POS 3
192 #define ENVIRONMENT3_ENABLE 0x01
193 #define ENVIRONMENT3_DISABLE 0x00
194 #define ENVIRONMENT3_ENABLE_HEATER 0x00
195 #define ENVIRONMENT3_DISABLE_HEATER 0x01
196 #define ENVIRONMENT3_ENABLE_GAS_MEAS_H 0x02
197 #define ENVIRONMENT3_ENABLE_GAS_MEAS_L 0x01
198 #define ENVIRONMENT3_DISABLE_GAS_MEAS 0x00
204 #define ENVIRONMENT3_VARIANT_GAS_LOW 0x00
205 #define ENVIRONMENT3_VARIANT_GAS_HIGH 0x01
211 #define ENVIRONMENT3_OS_NONE 0
212 #define ENVIRONMENT3_OS_1X 1
213 #define ENVIRONMENT3_OS_2X 2
214 #define ENVIRONMENT3_OS_4X 3
215 #define ENVIRONMENT3_OS_8X 4
216 #define ENVIRONMENT3_OS_16X 5
222 #define ENVIRONMENT3_FILTER_OFF 0
223 #define ENVIRONMENT3_FILTER_SIZE_1 1
224 #define ENVIRONMENT3_FILTER_SIZE_3 2
225 #define ENVIRONMENT3_FILTER_SIZE_7 3
226 #define ENVIRONMENT3_FILTER_SIZE_15 4
227 #define ENVIRONMENT3_FILTER_SIZE_31 5
228 #define ENVIRONMENT3_FILTER_SIZE_63 6
229 #define ENVIRONMENT3_FILTER_SIZE_127 7
235 #define ENVIRONMENT3_ODR_0_59_MS 0
236 #define ENVIRONMENT3_ODR_62_5_MS 1
237 #define ENVIRONMENT3_ODR_125_MS 2
238 #define ENVIRONMENT3_ODR_250_MS 3
239 #define ENVIRONMENT3_ODR_500_MS 4
240 #define ENVIRONMENT3_ODR_1000_MS 5
241 #define ENVIRONMENT3_ODR_10_MS 6
242 #define ENVIRONMENT3_ODR_20_MS 7
243 #define ENVIRONMENT3_ODR_NONE 8
249 #define ENVIRONMENT3_MODE_SLEEP 0
250 #define ENVIRONMENT3_MODE_FORCED 1
256 #define ENVIRONMENT3_MEM_PAGE_0 0x10
257 #define ENVIRONMENT3_MEM_PAGE_1 0x00
263 #define ENVIRONMENT3_LEN_COEFF_ALL 42
264 #define ENVIRONMENT3_LEN_COEFF_1 23
265 #define ENVIRONMENT3_LEN_COEFF_2 14
266 #define ENVIRONMENT3_LEN_COEFF_3 5
267 #define ENVIRONMENT3_LEN_FIELD 17
268 #define ENVIRONMENT3_LEN_CONFIG 5
269 #define ENVIRONMENT3_LEN_INTERLEAVE_BUFF 20
275 #define ENVIRONMENT3_IDX_T2_LSB 0
276 #define ENVIRONMENT3_IDX_T2_MSB 1
277 #define ENVIRONMENT3_IDX_T3 2
278 #define ENVIRONMENT3_IDX_P1_LSB 4
279 #define ENVIRONMENT3_IDX_P1_MSB 5
280 #define ENVIRONMENT3_IDX_P2_LSB 6
281 #define ENVIRONMENT3_IDX_P2_MSB 7
282 #define ENVIRONMENT3_IDX_P3 8
283 #define ENVIRONMENT3_IDX_P4_LSB 10
284 #define ENVIRONMENT3_IDX_P4_MSB 11
285 #define ENVIRONMENT3_IDX_P5_LSB 12
286 #define ENVIRONMENT3_IDX_P5_MSB 13
287 #define ENVIRONMENT3_IDX_P7 14
288 #define ENVIRONMENT3_IDX_P6 15
289 #define ENVIRONMENT3_IDX_P8_LSB 18
290 #define ENVIRONMENT3_IDX_P8_MSB 19
291 #define ENVIRONMENT3_IDX_P9_LSB 20
292 #define ENVIRONMENT3_IDX_P9_MSB 21
293 #define ENVIRONMENT3_IDX_P10 22
294 #define ENVIRONMENT3_IDX_H2_MSB 23
295 #define ENVIRONMENT3_IDX_H2_LSB 24
296 #define ENVIRONMENT3_IDX_H1_LSB 24
297 #define ENVIRONMENT3_IDX_H1_MSB 25
298 #define ENVIRONMENT3_IDX_H3 26
299 #define ENVIRONMENT3_IDX_H4 27
300 #define ENVIRONMENT3_IDX_H5 28
301 #define ENVIRONMENT3_IDX_H6 29
302 #define ENVIRONMENT3_IDX_H7 30
303 #define ENVIRONMENT3_IDX_T1_LSB 31
304 #define ENVIRONMENT3_IDX_T1_MSB 32
305 #define ENVIRONMENT3_IDX_GH2_LSB 33
306 #define ENVIRONMENT3_IDX_GH2_MSB 34
307 #define ENVIRONMENT3_IDX_GH1 35
308 #define ENVIRONMENT3_IDX_GH3 36
309 #define ENVIRONMENT3_IDX_RES_HEAT_VAL 37
310 #define ENVIRONMENT3_IDX_RES_HEAT_RANGE 39
311 #define ENVIRONMENT3_IDX_RANGE_SW_ERR 41
318 #define ENVIRONMENT3_DEVICE_SLAVE_ADDR_0 0x76
319 #define ENVIRONMENT3_DEVICE_SLAVE_ADDR_1 0x77
337 #define ENVIRONMENT3_MAP_MIKROBUS( cfg, mikrobus ) \
338 cfg.scl = MIKROBUS( mikrobus, MIKROBUS_SCL ); \
339 cfg.sda = MIKROBUS( mikrobus, MIKROBUS_SDA ); \
340 cfg.miso = MIKROBUS( mikrobus, MIKROBUS_MISO ); \
341 cfg.mosi = MIKROBUS( mikrobus, MIKROBUS_MOSI ); \
342 cfg.sck = MIKROBUS( mikrobus, MIKROBUS_SCK ); \
343 cfg.cs = MIKROBUS( mikrobus, MIKROBUS_CS ); \
830 #endif // ENVIRONMENT3_H
int8_t environment3_set_operating_mode(environment3_t *ctx, uint8_t op_mode)
Environment 3 set operating mode function.
int16_t par_gh2
Definition: environment3.h:398
float temperature
Definition: environment3.h:377
int8_t range_sw_err
Definition: environment3.h:416
uint8_t gas_index
Definition: environment3.h:372
uint8_t slave_address
Definition: environment3.h:455
spi_master_mode_t spi_mode
Definition: environment3.h:489
uint8_t environment3_read_byte(environment3_t *ctx, uint8_t reg)
Environment 3 single data reading function.
uint8_t enable
Definition: environment3.h:440
int8_t par_h7
Definition: environment3.h:396
int16_t par_p9
Definition: environment3.h:411
uint8_t status
Definition: environment3.h:371
void environment3_drv_interface_selection(environment3_cfg_t *cfg, environment3_drv_t drv_sel)
Environment 3 driver interface setup function.
int8_t environment3_soft_reset(environment3_t *ctx)
Environment 3 soft reset function.
pin_name_t miso
Definition: environment3.h:480
uint8_t filter
Definition: environment3.h:429
int16_t par_p2
Definition: environment3.h:404
uint8_t i2c_address
Definition: environment3.h:486
int8_t par_h3
Definition: environment3.h:392
err_t(* environment3_master_io_t)(struct environment3_s *, uint8_t, uint8_t *, uint8_t)
Environment 3 Click driver interface.
Definition: environment3.h:363
float environment3_get_humidity(environment3_t *ctx)
Environment 3 get humidity data function.
uint8_t par_p10
Definition: environment3.h:412
Environment 3 Click context object.
Definition: environment3.h:451
pin_name_t cs
Definition: environment3.h:483
uint16_t par_h2
Definition: environment3.h:391
environment3_master_io_t write_f
Definition: environment3.h:459
i2c_master_t i2c
Definition: environment3.h:452
environment3_drv_t drv_sel
Definition: environment3.h:492
err_t environment3_generic_write(environment3_t *ctx, uint8_t reg, uint8_t *data_in, uint8_t len)
Environment 3 data writing function.
Environment 3 Click configuration object.
Definition: environment3.h:477
uint8_t gas_wait
Definition: environment3.h:376
uint8_t res_heat_range
Definition: environment3.h:414
spi_master_t spi
Definition: environment3.h:453
pin_name_t sck
Definition: environment3.h:482
err_t environment3_generic_read(environment3_t *ctx, uint8_t reg, uint8_t *data_out, uint8_t len)
Environment 3 data reading function.
Environment 3 field data structure.
Definition: environment3.h:370
uint8_t os_temp
Definition: environment3.h:427
int8_t par_t3
Definition: environment3.h:402
uint16_t heater_dur
Definition: environment3.h:442
int16_t par_p5
Definition: environment3.h:407
pin_name_t mosi
Definition: environment3.h:481
pin_name_t scl
Definition: environment3.h:478
int8_t environment3_get_operating_mode(environment3_t *ctx)
Environment 3 get operating mode function.
@ ENVIRONMENT3_OK
Definition: environment3.h:502
environment3_master_io_t read_f
Definition: environment3.h:460
uint16_t par_h1
Definition: environment3.h:390
float environment3_get_pressure(environment3_t *ctx)
Environment 3 get pressure data function.
uint32_t spi_speed
Definition: environment3.h:488
spi_master_chip_select_polarity_t cs_polarity
Definition: environment3.h:490
float t_fine
Definition: environment3.h:413
environment3_field_data_t f_data
Definition: environment3.h:462
float environment3_get_temperature(environment3_t *ctx)
Environment 3 get temperature data function.
int8_t par_h5
Definition: environment3.h:394
err_t environment3_write_byte(environment3_t *ctx, uint8_t reg, uint8_t data_in)
Environment 3 single data writing function.
pin_name_t sda
Definition: environment3.h:479
environment3_gas_settings_t gas_sett
Definition: environment3.h:465
int8_t res_heat_val
Definition: environment3.h:415
int8_t environment3_set_heater_conf(environment3_t *ctx, environment3_gas_settings_t *conf)
Environment 3 set heater configuration function.
int8_t par_p6
Definition: environment3.h:408
int16_t par_p4
Definition: environment3.h:406
int8_t par_p7
Definition: environment3.h:409
int8_t par_gh3
Definition: environment3.h:399
int8_t par_p3
Definition: environment3.h:405
uint8_t environment3_get_device_id(environment3_t *ctx)
Environment 3 get device ID function.
@ ENVIRONMENT3_ERROR
Definition: environment3.h:503
uint8_t par_h6
Definition: environment3.h:395
uint16_t par_p1
Definition: environment3.h:403
int8_t environment3_get_all_data(environment3_t *ctx, float *temp, float *hum, float *pres, uint32_t *gas)
Environment 3 get all data function.
int8_t par_h4
Definition: environment3.h:393
environment3_calibration_data_t calib
Definition: environment3.h:463
err_t environment3_default_cfg(environment3_t *ctx)
Environment 3 default configuration function.
uint8_t meas_index
Definition: environment3.h:373
uint32_t i2c_speed
Definition: environment3.h:485
uint16_t heater_temp
Definition: environment3.h:441
environment3_return_value_t
Environment 3 Click return value data.
Definition: environment3.h:501
uint32_t environment3_get_gas_resistance(environment3_t *ctx)
Environment 3 get gas resistance data function.
int16_t par_t2
Definition: environment3.h:401
environment3_drv_t
Environment 3 Click driver selector.
Definition: environment3.h:353
int8_t environment3_set_regs(environment3_t *ctx, uint8_t *reg, uint8_t *data_in, uint8_t len)
Environment 3 write data to registers function.
float gas_resistance
Definition: environment3.h:380
Environment 3 gas settings structure.
Definition: environment3.h:439
uint8_t os_pres
Definition: environment3.h:428
float humidity
Definition: environment3.h:379
uint8_t odr
Definition: environment3.h:430
int8_t environment3_get_regs(environment3_t *ctx, uint8_t reg, uint8_t *data_out, uint16_t len)
Environment 3 read data from register address function.
environment3_tph_settings_t tph_sett
Definition: environment3.h:464
Environment 3 calibration data structure.
Definition: environment3.h:389
int16_t par_p8
Definition: environment3.h:410
struct environment3_s environment3_t
Environment 3 Click context object.
Environment 3 TPH settings structure.
Definition: environment3.h:425
@ ENVIRONMENT3_DRV_SEL_SPI
Definition: environment3.h:354
uint8_t device_mem_page
Definition: environment3.h:467
@ ENVIRONMENT3_DRV_SEL_I2C
Definition: environment3.h:355
float pressure
Definition: environment3.h:378
uint16_t par_t1
Definition: environment3.h:400
int8_t environment3_enable_heater(environment3_t *ctx, uint8_t state)
Environment 3 enable heater function.
int8_t environment3_set_sensor_conf(environment3_t *ctx, environment3_tph_settings_t *conf)
Environment 3 set sensor configuration function.
void environment3_cfg_setup(environment3_cfg_t *cfg)
Environment 3 configuration object setup function.
err_t environment3_init(environment3_t *ctx, environment3_cfg_t *cfg)
Environment 3 initialization function.
int8_t par_gh1
Definition: environment3.h:397
pin_name_t chip_select
Definition: environment3.h:456
uint8_t device_variant_id
Definition: environment3.h:468
uint8_t res_heat
Definition: environment3.h:374
int8_t environment3_check_id(environment3_t *ctx)
Environment 3 check device ID function.
uint8_t idac
Definition: environment3.h:375
environment3_drv_t drv_sel
Definition: environment3.h:457
uint8_t os_hum
Definition: environment3.h:426