pressure9  2.0.0.0
pressure9.h
Go to the documentation of this file.
1 /*
2  * MikroSDK - MikroE Software Development Kit
3  * Copyright© 2020 MikroElektronika d.o.o.
4  *
5  * Permission is hereby granted, free of charge, to any person
6  * obtaining a copy of this software and associated documentation
7  * files (the "Software"), to deal in the Software without restriction,
8  * including without limitation the rights to use, copy, modify, merge,
9  * publish, distribute, sublicense, and/or sell copies of the Software,
10  * and to permit persons to whom the Software is furnished to do so,
11  * subject to the following conditions:
12  *
13  * The above copyright notice and this permission notice shall be
14  * included in all copies or substantial portions of the Software.
15  *
16  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
17  * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
19  * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
20  * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
21  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE
22  * OR OTHER DEALINGS IN THE SOFTWARE.
23  */
24 
33 // ----------------------------------------------------------------------------
34 
35 #ifndef PRESSURE9_H
36 #define PRESSURE9_H
37 
38 #include "drv_digital_out.h"
39 #include "drv_i2c_master.h"
40 #include "drv_spi_master.h"
41 
42 // -------------------------------------------------------------- PUBLIC MACROS
53 #define PRESSURE9_MAP_MIKROBUS( cfg, mikrobus ) \
54  cfg.scl = MIKROBUS( mikrobus, MIKROBUS_SCL ); \
55  cfg.sda = MIKROBUS( mikrobus, MIKROBUS_SDA ); \
56  cfg.miso = MIKROBUS( mikrobus, MIKROBUS_MISO ); \
57  cfg.mosi = MIKROBUS( mikrobus, MIKROBUS_MOSI ); \
58  cfg.sck = MIKROBUS( mikrobus, MIKROBUS_SCK ); \
59  cfg.cs = MIKROBUS( mikrobus, MIKROBUS_CS )
60 
66 #define PRESSURE9_MASTER_I2C 0
67 #define PRESSURE9_MASTER_SPI 1
68 
74 #define PRESSURE9_RETVAL uint8_t
75 
76 #define PRESSURE9_OK 0x00
77 #define PRESSURE9_INIT_ERROR 0xFF
78 
84 #define PRESSURE9_REG_PRESSURE_DATA_B2 0x00
85 #define PRESSURE9_REG_PRESSURE_DATA_B1 0x01
86 #define PRESSURE9_REG_PRESSURE_DATA_B0 0x02
87 #define PRESSURE9_REG_TEMPERATRE_DATA_B2 0x03
88 #define PRESSURE9_REG_TEMPERATRE_DATA_B1 0x04
89 #define PRESSURE9_REG_TEMPERATRE_DATA_B0 0x05
90 #define PRESSURE9_REG_PRESSURE_CONFIG 0x06
91 #define PRESSURE9_REG_TEMPERATURE_CONFIG 0x07
92 #define PRESSURE9_REG_MEASUREMENT_CONFIG 0x08
93 #define PRESSURE9_REG_CONFIGURATION 0x09
94 #define PRESSURE9_REG_INT_STATUS 0x0A
95 #define PRESSURE9_REG_WATERMARK_CONFIG 0x0B
96 #define PRESSURE9_REG_FIFO_STATUS 0x0C
97 #define PRESSURE9_REG_RESET 0x0D
98 #define PRESSURE9_REG_PRODUCT_ID 0x1D
99 #define PRESSURE9_T_GAIN_COEFF 0x20
100 #define PRESSURE9_T_DVBE_COEFF 0x21
101 #define PRESSURE9_T_VBE_COEFF 0x22
102 #define PRESSURE9_COEFF_REG_1 0x26
103 #define PRESSURE9_COEFF_REG_2 0x27
104 #define PRESSURE9_COEFF_REG_3 0x28
105 #define PRESSURE9_COEFF_REG_4 0x29
106 #define PRESSURE9_COEFF_REG_5 0x2A
107 #define PRESSURE9_COEFF_REG_6 0x2B
108 #define PRESSURE9_COEFF_REG_7 0x2C
109 #define PRESSURE9_COEFF_REG_8 0x2D
110 #define PRESSURE9_COEFF_REG_9 0x2E
111 #define PRESSURE9_COEFF_REG_10 0x2F
112 #define PRESSURE9_COEFF_REG_11 0x30
113 #define PRESSURE9_COEFF_REG_12 0x31
114 #define PRESSURE9_COEFF_REG_13 0x32
115 #define PRESSURE9_COEFF_REG_14 0x33
116 #define PRESSURE9_COEFF_REG_15 0x34
117 #define PRESSURE9_COEFF_REG_16 0x35
118 #define PRESSURE9_COEFF_REG_17 0x36
119 #define PRESSURE9_COEFF_REG_18 0x37
120 
126 #define PRESSURE9_PTCFG_RATE_1_SAMPLE_SEC 0x00
127 #define PRESSURE9_PTCFG_RATE_2_SAMPLES_SEC 0x10
128 #define PRESSURE9_PTCFG_RATE_4_SAMPLES_SEC 0x20
129 #define PRESSURE9_PTCFG_RATE_8_SAMPLES_SEC 0x30
130 #define PRESSURE9_PTCFG_RATE_16_SAMPLES_SEC 0x40
131 #define PRESSURE9_PTCFG_RATE_32_SAMPLES_SEC 0x50
132 #define PRESSURE9_PTCFG_RATE_64_SAMPLES_SEC 0x60
133 #define PRESSURE9_PTCFG_RATE_128_SAMPLES_SEC 0x70
134 #define PRESSURE9_PTCFG_RES_X1_256_SAMPLES 0x00
135 #define PRESSURE9_PTCFG_RES_X2_512_SAMPLES 0x01
136 #define PRESSURE9_PTCFG_RES_X4_1024_SAMPLES 0x02
137 #define PRESSURE9_PTCFG_RES_X8_2048_SAMPLES 0x03
138 #define PRESSURE9_PTCFG_RES_X16_4096_SAMPLES 0x04
139 #define PRESSURE9_PTCFG_RES_X32_8192_SAMPLES 0x05
140 #define PRESSURE9_PTCFG_RES_X64_16384_SAMPLES 0x06
141 #define PRESSURE9_PTCFG_RES_X128_32768_SAMPLES 0x07
142 
147 #define PRESSURE9_MCFG_IDLE_STOP_BACKGROUND 0x00
148 #define PRESSURE9_MCFG_PRESSURE_MEASUREMENT 0x01
149 #define PRESSURE9_MCFG_TEMPERATURE_MEASUREMENT 0x02
150 #define PRESSURE9_MCFG_TEMP_AND_PRESS_ONE_SHOT 0x03
151 #define PRESSURE9_MCFG_PRESSURE_MEASUREMENT_CONT 0x05
152 #define PRESSURE9_MCFG_TEMPERATURE_MEASUREMENT_CONT 0x06
153 #define PRESSURE9_MCFG_TEMP_AND_PRESS_CONT 0x07
154 
159 #define PRESSURE9_CFG_SINT_NO_INT_ENABLED 0x00
160 #define PRESSURE9_CFG_SINT_PRESS_INT_ENABLED 0x10
161 #define PRESSURE9_CFG_SINT_TEMP_INT_ENABLED 0x20
162 #define PRESSURE9_CFG_SINT_PRESS_AND_TEMP_INT_EN 0x30
163 #define PRESSURE9_CFG_SINT_FIFO_WM_INT_ENABLED 0x40
164 #define PRESSURE9_CFG_SINT_FIFO_FULL_INT_ENABLED 0x80
165 #define PRESSURE9_CFG_PINT_INT_ACTIVE_LOW 0x00
166 #define PRESSURE9_CFG_PINT_INT_ACTIVE_HIGH 0x08
167 #define PRESSURE9_CFG_FIFO_SF_STREAMING_MODE 0x00
168 #define PRESSURE9_CFG_FIFO_SF_FULL_MODE 0x04
169 #define PRESSURE9_CFG_FIFO_EN_ENABLED 0x02
170 #define PRESSURE9_CFG_FIFO_EN_DISABLED 0x00
171 #define PRESSURE9_CFG_SPI_MODE_4_WIRE 0x00
172 #define PRESSURE9_CFG_SPI_MODE_3_WIRE 0x01
173 
178 #define PRESSURE9_RESET_CONFIGURATION_REG 0x08
179 #define PRESSURE9_FULL_SOFTWARE_RESET 0x09
180 #define PRESSURE9_FIFO_FLUSH 0x80
181 
186 #define PRESSURE9_DEV_SLAVE_ADR_GND 0x76
187 #define PRESSURE9_DEV_SLAVE_ADR_VCC 0x77
188 #define PRESSURE9_PRODUCT_ID 0x1A
189 
194 #define PRESSURE9_PRESSURE_COEFFICIENT_C00 0x00
195 #define PRESSURE9_PRESSURE_COEFFICIENT_C01 0x01
196 #define PRESSURE9_PRESSURE_COEFFICIENT_C02 0x02
197 #define PRESSURE9_PRESSURE_COEFFICIENT_C10 0x10
198 #define PRESSURE9_PRESSURE_COEFFICIENT_C20 0x20
199 #define PRESSURE9_PRESSURE_COEFFICIENT_C30 0x30
200 #define PRESSURE9_PRESSURE_COEFFICIENT_C11 0x11
201 #define PRESSURE9_PRESSURE_COEFFICIENT_C12 0x12
202 #define PRESSURE9_PRESSURE_COEFFICIENT_C21 0x21
203 #define PRESSURE9_TEMP_COEFFICIENT_T_GAIN 0x03
204 #define PRESSURE9_TEMP_COEFFICIENT_T_DVBE 0x04
205 #define PRESSURE9_TEMP_COEFFICIENT_T_VBE 0x05
206 #define PRESSURE9_COEFF_CAL_00 0x00
207 #define PRESSURE9_COEFF_CAL_10 0x10
208 #define PRESSURE9_COEFF_CAL_01 0x01
209 #define PRESSURE9_COEFF_CAL_02 0x02
210 #define PRESSURE9_COEFF_CAL_20 0x20
211 #define PRESSURE9_COEFF_CAL_30 0x30
212 #define PRESSURE9_COEFF_CAL_11 0x11
213 #define PRESSURE9_COEFF_CAL_12 0x12
214 #define PRESSURE9_COEFF_CAL_21 0x21
215 #define PRESSURE9_COEFF_T_GAIN 0x03
216 #define PRESSURE9_COEFF_T_DVBE 0x04
217 #define PRESSURE9_COEFF_T_VBE 0x05
218  // End group macro
221 // --------------------------------------------------------------- PUBLIC TYPES
230 typedef uint8_t pressure9_select_t;
231 
235 typedef void ( *pressure9_master_io_t )( struct pressure9_s*, uint8_t, uint8_t*, uint8_t );
236 
240 typedef struct
241 {
242  int32_t cal_00;
243  int32_t cal_10;
244  int32_t cal_01;
245  int32_t cal_02;
246  int32_t cal_20;
247  int32_t cal_30;
248  int32_t cal_11;
249  int32_t cal_12;
250  int32_t cal_21;
251 
253 
257 typedef struct
258 {
259  int32_t t_gain;
260  int32_t t_dvbe;
261  int32_t t_vbe;
262  float vbe;
263  float dvbe;
264  float adc_val;
265  float vbe_cal;
266  float dvbe_cal;
267  float t_cal;
269  float kptat;
270  float ap;
271  float bp;
272 
274 
278 typedef struct pressure9_s
279 {
280  // Output pins
281 
282  digital_out_t cs;
283 
284  // Modules
285 
286  i2c_master_t i2c;
287  spi_master_t spi;
288 
289  // ctx variable
290  uint8_t slave_address;
291  pin_name_t chip_select;
295 
296  // Pressure calibration coefficient
297 
299 
300  // Temperature calibration coefficient
301 
303 
304 } pressure9_t;
305 
309 typedef struct
310 {
311  // Communication gpio pins
312 
313  pin_name_t scl;
314  pin_name_t sda;
315  pin_name_t miso;
316  pin_name_t mosi;
317  pin_name_t sck;
318  pin_name_t cs;
319 
320  // static variable
321 
322  uint32_t i2c_speed;
323  uint8_t i2c_address;
324 
325  uint32_t spi_speed;
326  spi_master_mode_t spi_mode;
327  spi_master_chip_select_polarity_t cs_polarity;
328 
330 
332  // End types group
334 // ----------------------------------------------- PUBLIC FUNCTION DECLARATIONS
340 #ifdef __cplusplus
341 extern "C"{
342 #endif
343 
353 
363 
371 void pressure9_default_cfg ( pressure9_t *ctx );
372 
383 void pressure9_generic_write ( pressure9_t *ctx, uint8_t reg, uint8_t *data_buf, uint8_t len );
384 
395 void pressure9_generic_read ( pressure9_t *ctx, uint8_t reg, uint8_t *data_buf, uint8_t len );
396 
406 void pressure9_configuration ( pressure9_t *ctx, uint8_t reg_adr, uint8_t data_in );
407 
418 int32_t pressure9_get_coefficients ( pressure9_t *ctx, uint8_t coeff );
419 
427 
435 
442 int32_t pressure9_get_pressure_raw ( pressure9_t *ctx );
443 
451 
459 
460 
461 #ifdef __cplusplus
462 }
463 #endif
464 #endif // _PRESSURE9_H_
465  // End public_function group
468 
469 // ------------------------------------------------------------------------- END
pressure9_cfg_t::mosi
pin_name_t mosi
Definition: pressure9.h:316
pressure9_cfg_t::sel
pressure9_select_t sel
Definition: pressure9.h:329
pressure9_init
PRESSURE9_RETVAL pressure9_init(pressure9_t *ctx, pressure9_cfg_t *cfg)
Initialization function.
pressure9_t
struct pressure9_s pressure9_t
Click ctx object definition.
pressure9_press_cal_coef_t::cal_01
int32_t cal_01
Definition: pressure9.h:244
pressure9_temp_cal_coef_t::t_gain
int32_t t_gain
Definition: pressure9.h:259
pressure9_press_cal_coef_t::cal_30
int32_t cal_30
Definition: pressure9.h:247
pressure9_s::read_f
pressure9_master_io_t read_f
Definition: pressure9.h:293
pressure9_s
Click ctx object definition.
Definition: pressure9.h:278
pressure9_temp_cal_coef_t::dvbe
float dvbe
Definition: pressure9.h:263
pressure9_cfg_t::i2c_address
uint8_t i2c_address
Definition: pressure9.h:323
pressure9_generic_write
void pressure9_generic_write(pressure9_t *ctx, uint8_t reg, uint8_t *data_buf, uint8_t len)
Generic write function.
pressure9_press_cal_coef_t
Pressure calibration coefficient.
Definition: pressure9.h:240
pressure9_get_temperature_raw
int32_t pressure9_get_temperature_raw(pressure9_t *ctx)
Get Temperature Raw data.
pressure9_select_t
uint8_t pressure9_select_t
Communication type.
Definition: pressure9.h:230
pressure9_cfg_setup
void pressure9_cfg_setup(pressure9_cfg_t *cfg)
Config Object Initialization function.
pressure9_temp_cal_coef_t::vbe_cal_t_ref
float vbe_cal_t_ref
Definition: pressure9.h:268
pressure9_configuration
void pressure9_configuration(pressure9_t *ctx, uint8_t reg_adr, uint8_t data_in)
Writing data to the configuration registers.
pressure9_press_cal_coef_t::cal_21
int32_t cal_21
Definition: pressure9.h:250
pressure9_press_cal_coef_t::cal_11
int32_t cal_11
Definition: pressure9.h:248
pressure9_s::chip_select
pin_name_t chip_select
Definition: pressure9.h:291
pressure9_cfg_t::sck
pin_name_t sck
Definition: pressure9.h:317
pressure9_temp_cal_coef_t
Temperature calibration coefficient.
Definition: pressure9.h:257
pressure9_s::master_sel
pressure9_select_t master_sel
Definition: pressure9.h:294
pressure9_press_cal_coef_t::cal_02
int32_t cal_02
Definition: pressure9.h:245
pressure9_master_io_t
void(* pressure9_master_io_t)(struct pressure9_s *, uint8_t, uint8_t *, uint8_t)
Master Input/Output type.
Definition: pressure9.h:235
pressure9_cfg_t::spi_mode
spi_master_mode_t spi_mode
Definition: pressure9.h:326
pressure9_temp_cal_coef_t::adc_val
float adc_val
Definition: pressure9.h:264
pressure9_cfg_t::spi_speed
uint32_t spi_speed
Definition: pressure9.h:325
pressure9_s::temp_coef
pressure9_temp_cal_coef_t temp_coef
Definition: pressure9.h:302
pressure9_get_pressure_raw
int32_t pressure9_get_pressure_raw(pressure9_t *ctx)
Get Pressure Raw data.
pressure9_cfg_t::miso
pin_name_t miso
Definition: pressure9.h:315
pressure9_cfg_t::cs
pin_name_t cs
Definition: pressure9.h:318
pressure9_update_calculation_coefficient
void pressure9_update_calculation_coefficient(pressure9_t *ctx)
Update all calibration coefficients.
pressure9_get_coefficients
int32_t pressure9_get_coefficients(pressure9_t *ctx, uint8_t coeff)
Get calibration coefficients.
pressure9_cfg_t::i2c_speed
uint32_t i2c_speed
Definition: pressure9.h:322
pressure9_get_temperature_data
float pressure9_get_temperature_data(pressure9_t *ctx)
Get Temperature data in C.
pressure9_press_cal_coef_t::cal_20
int32_t cal_20
Definition: pressure9.h:246
pressure9_temp_cal_coef_t::bp
float bp
Definition: pressure9.h:271
pressure9_s::press_coef
pressure9_press_cal_coef_t press_coef
Definition: pressure9.h:298
pressure9_temp_cal_coef_t::vbe_cal
float vbe_cal
Definition: pressure9.h:265
PRESSURE9_RETVAL
#define PRESSURE9_RETVAL
Definition: pressure9.h:74
pressure9_press_cal_coef_t::cal_12
int32_t cal_12
Definition: pressure9.h:249
pressure9_temp_cal_coef_t::t_dvbe
int32_t t_dvbe
Definition: pressure9.h:260
pressure9_temp_cal_coef_t::ap
float ap
Definition: pressure9.h:270
pressure9_cfg_t::cs_polarity
spi_master_chip_select_polarity_t cs_polarity
Definition: pressure9.h:327
pressure9_press_cal_coef_t::cal_10
int32_t cal_10
Definition: pressure9.h:243
pressure9_generic_read
void pressure9_generic_read(pressure9_t *ctx, uint8_t reg, uint8_t *data_buf, uint8_t len)
Generic read function.
pressure9_temp_cal_coef_t::t_vbe
int32_t t_vbe
Definition: pressure9.h:261
pressure9_s::cs
digital_out_t cs
Definition: pressure9.h:282
pressure9_cfg_t
Click configuration structure definition.
Definition: pressure9.h:309
pressure9_temp_cal_coef_t::vbe
float vbe
Definition: pressure9.h:262
pressure9_press_cal_coef_t::cal_00
int32_t cal_00
Definition: pressure9.h:242
pressure9_default_cfg
void pressure9_default_cfg(pressure9_t *ctx)
Click Default Configuration function.
pressure9_cfg_t::sda
pin_name_t sda
Definition: pressure9.h:314
pressure9_temp_cal_coef_t::dvbe_cal
float dvbe_cal
Definition: pressure9.h:266
pressure9_s::spi
spi_master_t spi
Definition: pressure9.h:287
pressure9_s::write_f
pressure9_master_io_t write_f
Definition: pressure9.h:292
pressure9_get_pressure_data
float pressure9_get_pressure_data(pressure9_t *ctx)
Get Pressure data in mBar.
pressure9_s::slave_address
uint8_t slave_address
Definition: pressure9.h:290
pressure9_s::i2c
i2c_master_t i2c
Definition: pressure9.h:286
pressure9_temp_cal_coef_t::t_cal
float t_cal
Definition: pressure9.h:267
pressure9_cfg_t::scl
pin_name_t scl
Definition: pressure9.h:313
pressure9_temp_cal_coef_t::kptat
float kptat
Definition: pressure9.h:269