airquality8  2.0.0.0
airquality8.h
Go to the documentation of this file.
1 /****************************************************************************
2 ** Copyright (C) 2020 MikroElektronika d.o.o.
3 ** Contact: https://www.mikroe.com/contact
4 **
5 ** Permission is hereby granted, free of charge, to any person obtaining a copy
6 ** of this software and associated documentation files (the "Software"), to deal
7 ** in the Software without restriction, including without limitation the rights
8 ** to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9 ** copies of the Software, and to permit persons to whom the Software is
10 ** furnished to do so, subject to the following conditions:
11 ** The above copyright notice and this permission notice shall be
12 ** included in all copies or substantial portions of the Software.
13 **
14 ** THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
15 ** EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
16 ** OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
17 ** IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
18 ** DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT
19 ** OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
20 ** USE OR OTHER DEALINGS IN THE SOFTWARE.
21 ****************************************************************************/
22 
28 #ifndef AIRQUALITY8_H
29 #define AIRQUALITY8_H
30 
31 #ifdef __cplusplus
32 extern "C"{
33 #endif
34 
35 #include "mikrosdk_version.h"
36 
37 #ifdef __GNUC__
38 #if mikroSDK_GET_VERSION < 20800ul
39 #include "rcu_delays.h"
40 #else
41 #include "delays.h"
42 #endif
43 #endif
44 
45 #include "drv_digital_out.h"
46 #include "drv_digital_in.h"
47 #include "drv_i2c_master.h"
48 
58 #define AIRQUALITY8_REG_PID 0x00
59 #define AIRQUALITY8_REG_CONF 0x20
60 #define AIRQUALITY8_REG_PROD_DATA 0x26
61 #define AIRQUALITY8_REG_CMD 0x93
62 #define AIRQUALITY8_REG_STATUS 0x94
63 #define AIRQUALITY8_REG_TRACKING 0x3A
64 
65 #define AIRQUALITY8_REG_CFG_H 0x40
66 #define AIRQUALITY8_REG_CFG_D 0x50
67 #define AIRQUALITY8_REG_CFG_M 0x60
68 #define AIRQUALITY8_REG_CFG_S 0x68
69 #define AIRQUALITY8_REG_CFG_R 0x97
70  // airquality8_reg
72 
87 #define AIRQUALITY8_PRODUCT_ID 0x6320
88 
93 #define AIRQUALITY8_GAS_DETECTION_STRATEGY_AUTO 0
94 #define AIRQUALITY8_GAS_DETECTION_STRATEGY_FORCE_O3 1
95 #define AIRQUALITY8_GAS_DETECTION_STRATEGY_FORCE_NO2 2
96 
101 #define AIRQUALITY8_RCDA_STRATEGY_FIX 0
102 #define AIRQUALITY8_RCDA_STRATEGY_SET 1
103 #define AIRQUALITY8_RCDA_STRATEGY_ADJ 2
104 
109 #define AIRQUALITY8_STATUS_SEQUENCER_RUNNING_MASK 0x80
110 #define AIRQUALITY8_STATUS_SLEEP_TIMER_ENABLED_MASK 0x40
111 #define AIRQUALITY8_STATUS_ALARM_MASK 0x20
112 #define AIRQUALITY8_STATUS_LAST_SEQ_STEP_MASK 0x1F
113 #define AIRQUALITY8_STATUS_POR_EVENT_MASK 0x80
114 #define AIRQUALITY8_STATUS_ACCESS_CONFLICT_MASK 0x40
115 
121 #define AIRQUALITY8_SET_DEV_ADDR 0x33
122  // airquality8_set
124 
139 #define AIRQUALITY8_MAP_MIKROBUS( cfg, mikrobus ) \
140  cfg.scl = MIKROBUS( mikrobus, MIKROBUS_SCL ); \
141  cfg.sda = MIKROBUS( mikrobus, MIKROBUS_SDA ); \
142  cfg.rst = MIKROBUS( mikrobus, MIKROBUS_RST )
143  // airquality8_map // airquality8
146 
151 typedef struct
152 {
153  // Output pins
154  digital_out_t rst;
156  // Input pins
157  digital_in_t int_pin;
159  // Modules
160  i2c_master_t i2c;
162  // I2C slave address
163  uint8_t slave_address;
165 } airquality8_t;
166 
171 typedef struct
172 {
173  pin_name_t scl;
174  pin_name_t sda;
176  pin_name_t rst;
177  pin_name_t int_pin;
179  uint32_t i2c_speed;
180  uint8_t i2c_address;
183 
188 typedef enum
189 {
200 
202 
219 
235 
250 
266 err_t airquality8_generic_write ( airquality8_t *ctx, uint8_t reg, uint8_t *tx_buf, uint8_t tx_len );
267 
283 err_t airquality8_generic_read ( airquality8_t *ctx, uint8_t reg, uint8_t *rx_buf, uint8_t rx_len );
284 
297 
312 err_t airquality8_get_status ( airquality8_t *ctx, uint8_t *status );
313 
338 err_t airquality8_get_sensor_info ( airquality8_t *ctx, uint8_t *cfg_data, uint8_t *prod_data, uint16_t *pid );
339 
363 err_t airquality8_init_sensor ( airquality8_t *ctx, uint16_t *mox_lr, uint16_t *mox_er );
364 
387 
402 
427 err_t airquality8_read_rmox ( airquality8_t *ctx, float *rmox, uint16_t mox_lr, uint16_t mox_er );
428 
447 float airquality8_calc_oaq ( float *rmox, uint8_t rcda_strategy, uint8_t gas_detection_strategy );
448 
462 
463 #ifdef __cplusplus
464 }
465 #endif
466 #endif // AIRQUALITY8_H
467  // airquality8
469 
470 // ------------------------------------------------------------------------ END
airquality8_cfg_t::scl
pin_name_t scl
Definition: airquality8.h:173
AIRQUALITY8_ERROR_INIT_OUT_OF_RANGE
@ AIRQUALITY8_ERROR_INIT_OUT_OF_RANGE
Definition: airquality8.h:192
airquality8_cfg_t::i2c_address
uint8_t i2c_address
Definition: airquality8.h:180
AIRQUALITY8_ERROR_SENSOR
@ AIRQUALITY8_ERROR_SENSOR
Definition: airquality8.h:197
airquality8_t
Air Quality 8 Click context object.
Definition: airquality8.h:152
airquality8_get_status
err_t airquality8_get_status(airquality8_t *ctx, uint8_t *status)
Air Quality 8 get status function.
AIRQUALITY8_ERROR_ACCESS_CONFLICT
@ AIRQUALITY8_ERROR_ACCESS_CONFLICT
Definition: airquality8.h:198
airquality8_t::rst
digital_out_t rst
Definition: airquality8.h:154
airquality8_init_sensor
err_t airquality8_init_sensor(airquality8_t *ctx, uint16_t *mox_lr, uint16_t *mox_er)
Air Quality 8 init sensor function.
airquality8_cfg_t::i2c_speed
uint32_t i2c_speed
Definition: airquality8.h:179
airquality8_t::slave_address
uint8_t slave_address
Definition: airquality8.h:163
airquality8_start_measurement
err_t airquality8_start_measurement(airquality8_t *ctx)
Air Quality 8 start measurement function.
AIRQUALITY8_ERROR_SENSOR_UNSUPPORTED
@ AIRQUALITY8_ERROR_SENSOR_UNSUPPORTED
Definition: airquality8.h:195
AIRQUALITY8_OK
@ AIRQUALITY8_OK
Definition: airquality8.h:190
airquality8_cfg_t::sda
pin_name_t sda
Definition: airquality8.h:174
airquality8_hw_reset
void airquality8_hw_reset(airquality8_t *ctx)
Air Quality 8 reset function.
airquality8_generic_read
err_t airquality8_generic_read(airquality8_t *ctx, uint8_t reg, uint8_t *rx_buf, uint8_t rx_len)
Air Quality 8 I2C reading function.
raq_check_interrupt
uint8_t raq_check_interrupt(airquality8_t *ctx)
Air Quality 8 check interrupt function.
AIRQUALITY8_ERROR_I2C
@ AIRQUALITY8_ERROR_I2C
Definition: airquality8.h:194
airquality8_t::i2c
i2c_master_t i2c
Definition: airquality8.h:160
AIRQUALITY8_ERROR_GAS_TIMEOUT
@ AIRQUALITY8_ERROR_GAS_TIMEOUT
Definition: airquality8.h:193
airquality8_init_measurement
err_t airquality8_init_measurement(airquality8_t *ctx)
Air Quality 8 init measurement function.
airquality8_cfg_t::rst
pin_name_t rst
Definition: airquality8.h:176
airquality8_default_cfg
err_t airquality8_default_cfg(airquality8_t *ctx)
Air Quality 8 default configuration function.
airquality8_get_sensor_info
err_t airquality8_get_sensor_info(airquality8_t *ctx, uint8_t *cfg_data, uint8_t *prod_data, uint16_t *pid)
Air Quality 8 get sensor info function.
airquality8_cfg_setup
void airquality8_cfg_setup(airquality8_cfg_t *cfg)
Air Quality 8 configuration object setup function.
airquality8_init
err_t airquality8_init(airquality8_t *ctx, airquality8_cfg_t *cfg)
Air Quality 8 initialization function.
AIRQUALITY8_ERROR_CONFIG_MISSING
@ AIRQUALITY8_ERROR_CONFIG_MISSING
Definition: airquality8.h:196
AIRQUALITY8_ERROR
@ AIRQUALITY8_ERROR
Definition: airquality8.h:191
airquality8_calc_oaq
float airquality8_calc_oaq(float *rmox, uint8_t rcda_strategy, uint8_t gas_detection_strategy)
Air Quality 8 calculates AQI function.
airquality8_t::int_pin
digital_in_t int_pin
Definition: airquality8.h:157
airquality8_cfg_t
Air Quality 8 Click configuration object.
Definition: airquality8.h:172
airquality8_generic_write
err_t airquality8_generic_write(airquality8_t *ctx, uint8_t reg, uint8_t *tx_buf, uint8_t tx_len)
Air Quality 8 I2C writing function.
AIRQUALITY8_ERROR_POR_EVENT
@ AIRQUALITY8_ERROR_POR_EVENT
Definition: airquality8.h:199
airquality8_return_value_t
airquality8_return_value_t
Air Quality 8 Click return value data.
Definition: airquality8.h:189
airquality8_cfg_t::int_pin
pin_name_t int_pin
Definition: airquality8.h:177
airquality8_read_rmox
err_t airquality8_read_rmox(airquality8_t *ctx, float *rmox, uint16_t mox_lr, uint16_t mox_er)
Air Quality 8 calculate rmox resistance function.