airquality9  2.0.0.0
airquality9.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 AIRQUALITY9_H
29 #define AIRQUALITY9_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 #include "drv_spi_master.h"
49 #include "spi_specifics.h"
50 
71 #define AIRQUALITY9_REG_PART_ID 0x00
72 #define AIRQUALITY9_REG_OPMODE 0x10
73 #define AIRQUALITY9_REG_CONFIG 0x11
74 #define AIRQUALITY9_REG_COMMAND 0x12
75 #define AIRQUALITY9_REG_TEMP_IN 0x13
76 #define AIRQUALITY9_REG_RH_IN 0x15
77 #define AIRQUALITY9_REG_DATA_STATUS 0x20
78 #define AIRQUALITY9_REG_DATA_AQI 0x21
79 #define AIRQUALITY9_REG_DATA_TVOC 0x22
80 #define AIRQUALITY9_REG_DATA_ECO2 0x24
81 #define AIRQUALITY9_REG_DATA_T 0x30
82 #define AIRQUALITY9_REG_DATA_RH 0x32
83 #define AIRQUALITY9_REG_DATA_MISR 0x38
84 #define AIRQUALITY9_REG_GPR_WRITE 0x40
85 #define AIRQUALITY9_REG_GPR_READ 0x48
86  // airquality9_reg
88 
103 #define AIRQUALITY9_OPMODE_DEEP_SLEEP 0x00
104 #define AIRQUALITY9_OPMODE_IDLE 0x01
105 #define AIRQUALITY9_OPMODE_STANDARD 0x02
106 #define AIRQUALITY9_OPMODE_RESET 0xF0
107 
112 #define AIRQUALITY_CONFIG_INTPOL_LOW 0x00
113 #define AIRQUALITY_CONFIG_INTPOL_HIGH 0x40
114 #define AIRQUALITY_CONFIG_INTCFG_OPEN_DRAIN 0x00
115 #define AIRQUALITY_CONFIG_INTCFG_PUSH_PULL 0x20
116 #define AIRQUALITY_CONFIG_INTGPR_BIT 0x08
117 #define AIRQUALITY_CONFIG_INTDAT_BIT 0x02
118 #define AIRQUALITY_CONFIG_INTEN_BIT 0x01
119 
124 #define AIRQUALITY_STATUS_OPMODE_RUNNING 0x80
125 #define AIRQUALITY_STATUS_ERROR_DETECTED 0x40
126 #define AIRQUALITY_STATUS_VALID_NORMAL_OP 0x00
127 #define AIRQUALITY_STATUS_VALID_WARM_UP 0x04
128 #define AIRQUALITY_STATUS_VALID_INIT_START_UP 0x08
129 #define AIRQUALITY_STATUS_VALID_INVALID 0x0C
130 #define AIRQUALITY_STATUS_VALID_FLAG_BITS 0x0C
131 #define AIRQUALITY_STATUS_NEW_DATA 0x02
132 #define AIRQUALITY_STATUS_NEW_GPR 0x01
133 
138 #define AIRQUALITY9_PART_ID_LSB 0x60
139 #define AIRQUALITY9_PART_ID_MSB 0x01
140 
145 #define AIRQUALITY9_AQI_UBA_EXELLENT 1
146 #define AIRQUALITY9_AQI_UBA_GOOD 2
147 #define AIRQUALITY9_AQI_UBA_MODERATE 3
148 #define AIRQUALITY9_AQI_UBA_POOR 4
149 #define AIRQUALITY9_AQI_UBA_UNHEALTHY 5
150 
156 #define AIRQUALITY9_DEVICE_ADDRESS_0 0x52
157 #define AIRQUALITY9_DEVICE_ADDRESS_1 0x53
158 
167 #define AIRQUALITY9_SET_DATA_SAMPLE_EDGE SET_SPI_DATA_SAMPLE_EDGE
168 #define AIRQUALITY9_SET_DATA_SAMPLE_MIDDLE SET_SPI_DATA_SAMPLE_MIDDLE
169  // airquality9_set
171 
186 #define AIRQUALITY9_MAP_MIKROBUS( cfg, mikrobus ) \
187  cfg.scl = MIKROBUS( mikrobus, MIKROBUS_SCL ); \
188  cfg.sda = MIKROBUS( mikrobus, MIKROBUS_SDA ); \
189  cfg.miso = MIKROBUS( mikrobus, MIKROBUS_MISO ); \
190  cfg.mosi = MIKROBUS( mikrobus, MIKROBUS_MOSI ); \
191  cfg.sck = MIKROBUS( mikrobus, MIKROBUS_SCK ); \
192  cfg.cs = MIKROBUS( mikrobus, MIKROBUS_CS ); \
193  cfg.en = MIKROBUS( mikrobus, MIKROBUS_PWM ); \
194  cfg.int_pin = MIKROBUS( mikrobus, MIKROBUS_INT )
195  // airquality9_map // airquality9
198 
203 typedef enum
204 {
209 
214 typedef err_t ( *airquality9_master_io_t )( struct airquality9_s*, uint8_t, uint8_t*, uint8_t );
220 typedef struct airquality9_s
221 {
222  digital_out_t en;
224  digital_in_t int_pin;
226  i2c_master_t i2c;
227  spi_master_t spi;
229  uint8_t slave_address;
230  pin_name_t chip_select;
237 
242 typedef struct
243 {
244  pin_name_t scl;
245  pin_name_t sda;
246  pin_name_t miso;
247  pin_name_t mosi;
248  pin_name_t sck;
249  pin_name_t cs;
250  pin_name_t en;
251  pin_name_t int_pin;
253  uint32_t i2c_speed;
254  uint8_t i2c_address;
256  uint32_t spi_speed;
257  spi_master_mode_t spi_mode;
258  spi_master_chip_select_polarity_t cs_polarity;
263 
268 typedef enum
269 {
271  AIRQUALITY9_ERROR = -1
272 
274 
291 
307 
323 
338 
353 err_t airquality9_generic_write ( airquality9_t *ctx, uint8_t reg, uint8_t *data_in, uint8_t len );
354 
369 err_t airquality9_generic_read ( airquality9_t *ctx, uint8_t reg, uint8_t *data_out, uint8_t len );
370 
380 
390 
400 
412 
427 err_t airquality9_set_operating_mode ( airquality9_t *ctx, uint8_t opmode );
428 
440 err_t airquality9_set_interrupt_config ( airquality9_t *ctx, uint8_t int_cfg );
441 
453 err_t airquality9_read_status ( airquality9_t *ctx, uint8_t *status );
454 
466 err_t airquality9_read_aqi_uba ( airquality9_t *ctx, uint8_t *aqi_uba );
467 
480 err_t airquality9_read_tvoc ( airquality9_t *ctx, uint16_t *tvoc );
481 
493 err_t airquality9_read_eco2 ( airquality9_t *ctx, uint16_t *eco2 );
494 
495 #ifdef __cplusplus
496 }
497 #endif
498 #endif // AIRQUALITY9_H
499  // airquality9
501 
502 // ------------------------------------------------------------------------ END
airquality9_drv_t
airquality9_drv_t
Air Quality 9 Click driver selector.
Definition: airquality9.h:204
airquality9_set_interrupt_config
err_t airquality9_set_interrupt_config(airquality9_t *ctx, uint8_t int_cfg)
Air Quality 9 set interrupt config function.
airquality9_s::spi
spi_master_t spi
Definition: airquality9.h:227
airquality9_s::i2c
i2c_master_t i2c
Definition: airquality9.h:226
airquality9_cfg_t::scl
pin_name_t scl
Definition: airquality9.h:244
airquality9_cfg_setup
void airquality9_cfg_setup(airquality9_cfg_t *cfg)
Air Quality 9 configuration object setup function.
airquality9_master_io_t
err_t(* airquality9_master_io_t)(struct airquality9_s *, uint8_t, uint8_t *, uint8_t)
Air Quality 9 Click driver interface.
Definition: airquality9.h:214
AIRQUALITY9_ERROR
@ AIRQUALITY9_ERROR
Definition: airquality9.h:271
airquality9_s::en
digital_out_t en
Definition: airquality9.h:222
airquality9_s::write_f
airquality9_master_io_t write_f
Definition: airquality9.h:233
airquality9_default_cfg
err_t airquality9_default_cfg(airquality9_t *ctx)
Air Quality 9 default configuration function.
spi_specifics.h
This file contains SPI specific macros, functions, etc.
airquality9_return_value_t
airquality9_return_value_t
Air Quality 9 Click return value data.
Definition: airquality9.h:269
airquality9_get_int_pin
uint8_t airquality9_get_int_pin(airquality9_t *ctx)
Air Quality 9 get int pin function.
airquality9_s::int_pin
digital_in_t int_pin
Definition: airquality9.h:224
airquality9_cfg_t::sck
pin_name_t sck
Definition: airquality9.h:248
AIRQUALITY9_OK
@ AIRQUALITY9_OK
Definition: airquality9.h:270
airquality9_read_eco2
err_t airquality9_read_eco2(airquality9_t *ctx, uint16_t *eco2)
Air Quality 9 read eco2 function.
airquality9_cfg_t::mosi
pin_name_t mosi
Definition: airquality9.h:247
airquality9_cfg_t::en
pin_name_t en
Definition: airquality9.h:250
airquality9_cfg_t::spi_mode
spi_master_mode_t spi_mode
Definition: airquality9.h:257
airquality9_read_status
err_t airquality9_read_status(airquality9_t *ctx, uint8_t *status)
Air Quality 9 read status function.
airquality9_s::slave_address
uint8_t slave_address
Definition: airquality9.h:229
airquality9_cfg_t::miso
pin_name_t miso
Definition: airquality9.h:246
airquality9_cfg_t::i2c_speed
uint32_t i2c_speed
Definition: airquality9.h:253
airquality9_set_operating_mode
err_t airquality9_set_operating_mode(airquality9_t *ctx, uint8_t opmode)
Air Quality 9 set operating mode function.
airquality9_cfg_t::i2c_address
uint8_t i2c_address
Definition: airquality9.h:254
airquality9_cfg_t::drv_sel
airquality9_drv_t drv_sel
Definition: airquality9.h:260
airquality9_s::read_f
airquality9_master_io_t read_f
Definition: airquality9.h:234
airquality9_s::drv_sel
airquality9_drv_t drv_sel
Definition: airquality9.h:231
airquality9_read_tvoc
err_t airquality9_read_tvoc(airquality9_t *ctx, uint16_t *tvoc)
Air Quality 9 read tvoc function.
airquality9_cfg_t::spi_speed
uint32_t spi_speed
Definition: airquality9.h:256
airquality9_generic_read
err_t airquality9_generic_read(airquality9_t *ctx, uint8_t reg, uint8_t *data_out, uint8_t len)
Air Quality 9 data reading function.
airquality9_cfg_t::cs_polarity
spi_master_chip_select_polarity_t cs_polarity
Definition: airquality9.h:258
airquality9_cfg_t::int_pin
pin_name_t int_pin
Definition: airquality9.h:251
airquality9_generic_write
err_t airquality9_generic_write(airquality9_t *ctx, uint8_t reg, uint8_t *data_in, uint8_t len)
Air Quality 9 data writing function.
airquality9_init
err_t airquality9_init(airquality9_t *ctx, airquality9_cfg_t *cfg)
Air Quality 9 initialization function.
airquality9_cfg_t::cs
pin_name_t cs
Definition: airquality9.h:249
airquality9_cfg_t
Air Quality 9 Click configuration object.
Definition: airquality9.h:243
airquality9_s::chip_select
pin_name_t chip_select
Definition: airquality9.h:230
airquality9_read_aqi_uba
err_t airquality9_read_aqi_uba(airquality9_t *ctx, uint8_t *aqi_uba)
Air Quality 9 read aqi uba function.
airquality9_cfg_t::sda
pin_name_t sda
Definition: airquality9.h:245
airquality9_check_communication
err_t airquality9_check_communication(airquality9_t *ctx)
Air Quality 9 check communication function.
airquality9_s
Air Quality 9 Click context object.
Definition: airquality9.h:221
AIRQUALITY9_DRV_SEL_SPI
@ AIRQUALITY9_DRV_SEL_SPI
Definition: airquality9.h:205
airquality9_disable_device
void airquality9_disable_device(airquality9_t *ctx)
Air Quality 9 disable device function.
airquality9_enable_device
void airquality9_enable_device(airquality9_t *ctx)
Air Quality 9 enable device function.
airquality9_drv_interface_selection
void airquality9_drv_interface_selection(airquality9_cfg_t *cfg, airquality9_drv_t drv_sel)
Air Quality 9 driver interface setup function.
airquality9_t
struct airquality9_s airquality9_t
Air Quality 9 Click context object.
AIRQUALITY9_DRV_SEL_I2C
@ AIRQUALITY9_DRV_SEL_I2C
Definition: airquality9.h:206