pressure18  2.1.0.0
pressure18.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 PRESSURE18_H
29 #define PRESSURE18_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 PRESSURE18_REG_CHIP_ID 0x00
72 #define PRESSURE18_REG_ERR 0x02
73 #define PRESSURE18_REG_STATUS 0x03
74 #define PRESSURE18_REG_DATA_0 0x04
75 #define PRESSURE18_REG_DATA_1 0x05
76 #define PRESSURE18_REG_DATA_2 0x06
77 #define PRESSURE18_REG_DATA_3 0x07
78 #define PRESSURE18_REG_DATA_4 0x08
79 #define PRESSURE18_REG_DATA_5 0x09
80 #define PRESSURE18_REG_SENSOR_TIME_0 0x0C
81 #define PRESSURE18_REG_SENSOR_TIME_1 0x0D
82 #define PRESSURE18_REG_SENSOR_TIME_2 0x0E
83 #define PRESSURE18_REG_SENSOR_TIME_3 0x0F
84 #define PRESSURE18_REG_EVENT 0x10
85 #define PRESSURE18_REG_INT_STATUS 0x11
86 #define PRESSURE18_REG_FIFO_LENGTH_0 0x12
87 #define PRESSURE18_REG_FIFO_LENGTH_1 0x13
88 #define PRESSURE18_REG_FIFO_DATA 0x14
89 #define PRESSURE18_REG_FIFO_WTM_0 0x15
90 #define PRESSURE18_REG_FIFO_WTM_1 0x16
91 #define PRESSURE18_REG_FIFO_CONFIG_1 0x17
92 #define PRESSURE18_REG_FIFO_CONFIG_2 0x18
93 #define PRESSURE18_REG_INT_CTRL 0x19
94 #define PRESSURE18_REG_IF_CONF 0x1A
95 #define PRESSURE18_REG_PWR_CTRL 0x1B
96 #define PRESSURE18_REG_OSR 0x1C
97 #define PRESSURE18_REG_ODR 0x1D
98 #define PRESSURE18_REG_CONFIG 0x1F
99 #define PRESSURE18_REG_CALIB_DATA 0x31
100 #define PRESSURE18_REG_CMD 0x7E
101  // pressure18_reg
103 
118 #define PRESSURE18_CHIP_ID 0x50
119 
124 #define PRESSURE18_ERR_FATAL 0x01
125 #define PRESSURE18_ERR_CMD 0x02
126 #define PRESSURE18_ERR_CONF 0x04
127 
132 #define PRESSURE18_STATUS_CMD_RDY 0x10
133 #define PRESSURE18_STATUS_DRDY_PRESS 0x20
134 #define PRESSURE18_STATUS_DRDY_TEMP 0x40
135 
140 #define PRESSURE18_INT_CTRL_OD_PUSH_PULL 0x00
141 #define PRESSURE18_INT_CTRL_OD_OPEN_DRAIN 0x01
142 #define PRESSURE18_INT_CTRL_LEVEL_ACTIVE_LOW 0x00
143 #define PRESSURE18_INT_CTRL_LEVEL_ACTIVE_HIGH 0x02
144 #define PRESSURE18_INT_CTRL_LATCH_DISABLED 0x00
145 #define PRESSURE18_INT_CTRL_LATCH_ENABLED 0x04
146 #define PRESSURE18_INT_CTRL_FWTM_DISABLED 0x00
147 #define PRESSURE18_INT_CTRL_FWTM_ENABLED 0x08
148 #define PRESSURE18_INT_CTRL_FFULL_DISABLED 0x00
149 #define PRESSURE18_INT_CTRL_FFULL_ENABLED 0x10
150 #define PRESSURE18_INT_CTRL_DRDY_DISABLED 0x00
151 #define PRESSURE18_INT_CTRL_DRDY_ENABLED 0x40
152 
157 #define PRESSURE18_PWR_CTRL_PRESS_EN 0x01
158 #define PRESSURE18_PWR_CTRL_TEMP_EN 0x02
159 #define PRESSURE18_PWR_CTRL_MODE_SLEEP 0x00
160 #define PRESSURE18_PWR_CTRL_MODE_FORCED 0x10
161 #define PRESSURE18_PWR_CTRL_MODE_NORMAL 0x30
162 
167 #define PRESSURE18_OSR_P_X1 0x00
168 #define PRESSURE18_OSR_P_X2 0x01
169 #define PRESSURE18_OSR_P_X4 0x02
170 #define PRESSURE18_OSR_P_X8 0x03
171 #define PRESSURE18_OSR_P_X16 0x04
172 #define PRESSURE18_OSR_P_X32 0x05
173 #define PRESSURE18_OSR_T_X1 0x00
174 #define PRESSURE18_OSR_T_X2 0x08
175 #define PRESSURE18_OSR_T_X4 0x10
176 #define PRESSURE18_OSR_T_X8 0x18
177 #define PRESSURE18_OSR_T_X16 0x20
178 #define PRESSURE18_OSR_T_X32 0x28
179 
184 #define PRESSURE18_ODR_5_MS 0x00
185 #define PRESSURE18_ODR_10_MS 0x01
186 #define PRESSURE18_ODR_20_MS 0x02
187 #define PRESSURE18_ODR_40_MS 0x03
188 #define PRESSURE18_ODR_80_MS 0x04
189 #define PRESSURE18_ODR_160_MS 0x05
190 #define PRESSURE18_ODR_320_MS 0x06
191 #define PRESSURE18_ODR_640_MS 0x07
192 #define PRESSURE18_ODR_1p280_S 0x08
193 #define PRESSURE18_ODR_2p560_S 0x09
194 #define PRESSURE18_ODR_5p120_S 0x0A
195 #define PRESSURE18_ODR_10p24_S 0x0B
196 #define PRESSURE18_ODR_20p48_S 0x0C
197 #define PRESSURE18_ODR_40p96_S 0x0D
198 #define PRESSURE18_ODR_81p92_S 0x0E
199 #define PRESSURE18_ODR_163p84_S 0x0F
200 #define PRESSURE18_ODR_327p68_S 0x10
201 #define PRESSURE18_ODR_655p36_S 0x11
202 
207 #define PRESSURE18_CMD_NOP 0x00
208 #define PRESSURE18_CMD_EXTMODE_EN_MIDDLE 0x34
209 #define PRESSURE18_CMD_FIFO_FLUSH 0xB0
210 #define PRESSURE18_CMD_SOFT_RESET 0xB6
211 
216 #define PRESSURE18_PA_TO_MBAR 0.01
217 
223 #define PRESSURE18_DEVICE_ADDRESS_0 0x76
224 #define PRESSURE18_DEVICE_ADDRESS_1 0x77
225 
234 #define PRESSURE18_SET_DATA_SAMPLE_EDGE SET_SPI_DATA_SAMPLE_EDGE
235 #define PRESSURE18_SET_DATA_SAMPLE_MIDDLE SET_SPI_DATA_SAMPLE_MIDDLE
236  // pressure18_set
238 
253 #define PRESSURE18_MAP_MIKROBUS( cfg, mikrobus ) \
254  cfg.scl = MIKROBUS( mikrobus, MIKROBUS_SCL ); \
255  cfg.sda = MIKROBUS( mikrobus, MIKROBUS_SDA ); \
256  cfg.miso = MIKROBUS( mikrobus, MIKROBUS_MISO ); \
257  cfg.mosi = MIKROBUS( mikrobus, MIKROBUS_MOSI ); \
258  cfg.sck = MIKROBUS( mikrobus, MIKROBUS_SCK ); \
259  cfg.cs = MIKROBUS( mikrobus, MIKROBUS_CS ); \
260  cfg.int_pin = MIKROBUS( mikrobus, MIKROBUS_INT )
261  // pressure18_map // pressure18
264 
269 typedef enum
270 {
275 
280 typedef err_t ( *pressure18_master_io_t )( struct pressure18_s*, uint8_t, uint8_t*, uint8_t );
286 typedef struct
287 {
288  float par_t1;
289  float par_t2;
290  float par_t3;
291  float par_p1;
292  float par_p2;
293  float par_p3;
294  float par_p4;
295  float par_p5;
296  float par_p6;
297  float par_p7;
298  float par_p8;
299  float par_p9;
300  float par_p10;
301  float par_p11;
302  float t_lin;
303 
305 
310 typedef struct pressure18_s
311 {
312  digital_in_t int_pin;
314  i2c_master_t i2c;
315  spi_master_t spi;
317  uint8_t slave_address;
318  pin_name_t chip_select;
327 
332 typedef struct
333 {
334  pin_name_t scl;
335  pin_name_t sda;
336  pin_name_t miso;
337  pin_name_t mosi;
338  pin_name_t sck;
339  pin_name_t cs;
340  pin_name_t int_pin;
342  uint32_t i2c_speed;
343  uint8_t i2c_address;
345  uint32_t spi_speed;
346  spi_master_mode_t spi_mode;
347  spi_master_chip_select_polarity_t cs_polarity;
352 
357 typedef enum
358 {
360  PRESSURE18_ERROR = -1
361 
363 
380 
396 
411 
425 
440 err_t pressure18_generic_write ( pressure18_t *ctx, uint8_t reg, uint8_t *data_in, uint8_t len );
441 
456 err_t pressure18_generic_read ( pressure18_t *ctx, uint8_t reg, uint8_t *data_out, uint8_t len );
457 
470 err_t pressure18_write_register ( pressure18_t *ctx, uint8_t reg, uint8_t data_in );
471 
484 err_t pressure18_read_register ( pressure18_t *ctx, uint8_t reg, uint8_t *data_out );
485 
497 
507 
519 
532 err_t pressure18_read_data ( pressure18_t *ctx, float *pressure, float *temperature );
533 
534 #ifdef __cplusplus
535 }
536 #endif
537 #endif // PRESSURE18_H
538  // pressure18
540 
541 // ------------------------------------------------------------------------ END
PRESSURE18_OK
@ PRESSURE18_OK
Definition: pressure18.h:359
pressure18_generic_read
err_t pressure18_generic_read(pressure18_t *ctx, uint8_t reg, uint8_t *data_out, uint8_t len)
Pressure 18 data reading function.
pressure18_drv_interface_selection
void pressure18_drv_interface_selection(pressure18_cfg_t *cfg, pressure18_drv_t drv_sel)
Pressure 18 driver interface setup function.
pressure18_s::i2c
i2c_master_t i2c
Definition: pressure18.h:314
PRESSURE18_DRV_SEL_I2C
@ PRESSURE18_DRV_SEL_I2C
Definition: pressure18.h:272
pressure18_calib_coef_t::par_p2
float par_p2
Definition: pressure18.h:292
pressure18_calib_coef_t::par_p5
float par_p5
Definition: pressure18.h:295
pressure18_calib_coef_t::par_t2
float par_t2
Definition: pressure18.h:289
pressure18_s::read_f
pressure18_master_io_t read_f
Definition: pressure18.h:322
pressure18_cfg_t::int_pin
pin_name_t int_pin
Definition: pressure18.h:340
pressure18_s::spi
spi_master_t spi
Definition: pressure18.h:315
pressure18_cfg_t::spi_speed
uint32_t spi_speed
Definition: pressure18.h:345
pressure18_generic_write
err_t pressure18_generic_write(pressure18_t *ctx, uint8_t reg, uint8_t *data_in, uint8_t len)
Pressure 18 data writing function.
pressure18_calib_coef_t::par_p6
float par_p6
Definition: pressure18.h:296
spi_specifics.h
This file contains SPI specific macros, functions, etc.
pressure18_calib_coef_t::par_p4
float par_p4
Definition: pressure18.h:294
pressure18_cfg_t
Pressure 18 Click configuration object.
Definition: pressure18.h:333
pressure18_cfg_t::sda
pin_name_t sda
Definition: pressure18.h:335
pressure18_return_value_t
pressure18_return_value_t
Pressure 18 Click return value data.
Definition: pressure18.h:358
pressure18_cfg_t::cs_polarity
spi_master_chip_select_polarity_t cs_polarity
Definition: pressure18.h:347
pressure18_calib_coef_t::par_p8
float par_p8
Definition: pressure18.h:298
pressure18_s::chip_select
pin_name_t chip_select
Definition: pressure18.h:318
PRESSURE18_ERROR
@ PRESSURE18_ERROR
Definition: pressure18.h:360
PRESSURE18_DRV_SEL_SPI
@ PRESSURE18_DRV_SEL_SPI
Definition: pressure18.h:271
pressure18_calib_coef_t::par_p1
float par_p1
Definition: pressure18.h:291
pressure18_cfg_t::spi_mode
spi_master_mode_t spi_mode
Definition: pressure18.h:346
pressure18_soft_reset
err_t pressure18_soft_reset(pressure18_t *ctx)
Pressure 18 soft reset function.
pressure18_s::int_pin
digital_in_t int_pin
Definition: pressure18.h:312
pressure18_cfg_setup
void pressure18_cfg_setup(pressure18_cfg_t *cfg)
Pressure 18 configuration object setup function.
pressure18_calib_coef_t::par_p7
float par_p7
Definition: pressure18.h:297
pressure18_get_int_pin
uint8_t pressure18_get_int_pin(pressure18_t *ctx)
Pressure 18 get int pin function.
pressure18_cfg_t::scl
pin_name_t scl
Definition: pressure18.h:334
pressure18_init
err_t pressure18_init(pressure18_t *ctx, pressure18_cfg_t *cfg)
Pressure 18 initialization function.
pressure18_s
Pressure 18 Click context object.
Definition: pressure18.h:311
pressure18_write_register
err_t pressure18_write_register(pressure18_t *ctx, uint8_t reg, uint8_t data_in)
Pressure 18 write register function.
pressure18_cfg_t::drv_sel
pressure18_drv_t drv_sel
Definition: pressure18.h:349
pressure18_calib_coef_t::par_p11
float par_p11
Definition: pressure18.h:301
pressure18_calib_coef_t::t_lin
float t_lin
Definition: pressure18.h:302
pressure18_drv_t
pressure18_drv_t
Pressure 18 Click driver selector.
Definition: pressure18.h:270
pressure18_s::drv_sel
pressure18_drv_t drv_sel
Definition: pressure18.h:319
pressure18_cfg_t::i2c_speed
uint32_t i2c_speed
Definition: pressure18.h:342
pressure18_s::calib_coef
pressure18_calib_coef_t calib_coef
Definition: pressure18.h:324
pressure18_check_communication
err_t pressure18_check_communication(pressure18_t *ctx)
Pressure 18 check communication function.
pressure18_master_io_t
err_t(* pressure18_master_io_t)(struct pressure18_s *, uint8_t, uint8_t *, uint8_t)
Pressure 18 Click driver interface.
Definition: pressure18.h:280
pressure18_calib_coef_t
Pressure 18 Click calibration coefficients object.
Definition: pressure18.h:287
pressure18_default_cfg
err_t pressure18_default_cfg(pressure18_t *ctx)
Pressure 18 default configuration function.
pressure18_read_register
err_t pressure18_read_register(pressure18_t *ctx, uint8_t reg, uint8_t *data_out)
Pressure 18 read register function.
pressure18_t
struct pressure18_s pressure18_t
Pressure 18 Click context object.
pressure18_read_data
err_t pressure18_read_data(pressure18_t *ctx, float *pressure, float *temperature)
Pressure 18 read data function.
pressure18_calib_coef_t::par_t3
float par_t3
Definition: pressure18.h:290
pressure18_calib_coef_t::par_p9
float par_p9
Definition: pressure18.h:299
pressure18_cfg_t::i2c_address
uint8_t i2c_address
Definition: pressure18.h:343
pressure18_calib_coef_t::par_p10
float par_p10
Definition: pressure18.h:300
pressure18_cfg_t::mosi
pin_name_t mosi
Definition: pressure18.h:337
pressure18_cfg_t::sck
pin_name_t sck
Definition: pressure18.h:338
pressure18_s::write_f
pressure18_master_io_t write_f
Definition: pressure18.h:321
pressure18_calib_coef_t::par_p3
float par_p3
Definition: pressure18.h:293
pressure18_calib_coef_t::par_t1
float par_t1
Definition: pressure18.h:288
pressure18_cfg_t::cs
pin_name_t cs
Definition: pressure18.h:339
pressure18_cfg_t::miso
pin_name_t miso
Definition: pressure18.h:336
pressure18_s::slave_address
uint8_t slave_address
Definition: pressure18.h:317