pressure10  2.0.0.0
pressure10.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 PRESSURE10_H
36 #define PRESSURE10_H
37 
38 #include "drv_digital_out.h"
39 #include "drv_digital_in.h"
40 #include "drv_i2c_master.h"
41 #include "drv_spi_master.h"
42 
43 // -------------------------------------------------------------- PUBLIC MACROS
54 #define PRESSURE10_MAP_MIKROBUS( cfg, mikrobus ) \
55  cfg.scl = MIKROBUS( mikrobus, MIKROBUS_SCL ); \
56  cfg.sda = MIKROBUS( mikrobus, MIKROBUS_SDA ); \
57  cfg.miso = MIKROBUS( mikrobus, MIKROBUS_MISO ); \
58  cfg.mosi = MIKROBUS( mikrobus, MIKROBUS_MOSI ); \
59  cfg.sck = MIKROBUS( mikrobus, MIKROBUS_SCK ); \
60  cfg.cs = MIKROBUS( mikrobus, MIKROBUS_CS ); \
61  cfg.rdy = MIKROBUS( mikrobus, MIKROBUS_INT )
62 
68 #define PRESSURE10_MASTER_I2C 0
69 #define PRESSURE10_MASTER_SPI 1
70 
76 #define PRESSURE10_RETVAL uint8_t
77 
78 #define PRESSURE10_OK 0x00
79 #define PRESSURE10_INIT_ERROR 0xFF
80 
86 #define DEVICE_OK 0
87 #define DEVICE_ERROR 1
88 
94 #define I2C_COMMUNICATION 1
95 #define SPI_COMMUNICATION 0
96 
102 #define PRESSURE10_DEVICE_SLAVE_ADDR_0 0x48
103 #define PRESSURE10_DEVICE_SLAVE_ADDR_1 0x49
104 
110 #define PRESSURE10_REG_WHO_I_AM 0x00
111 #define PRESSURE10_REG_INFORMATION 0x01
112 #define PRESSURE10_REG_FIFO_STATUS 0x02
113 #define PRESSURE10_REG_STATUS 0x03
114 #define PRESSURE10_REG_PRESSURE_OUT_LOW 0x04
115 #define PRESSURE10_REG_PRESSURE_OUT_MID 0x05
116 #define PRESSURE10_REG_PRESSURE_OUT_HIGH 0x06
117 #define PRESSURE10_REG_TEMP_OUT_LOW 0x09
118 #define PRESSURE10_REG_TEMP_OUT_HIGH 0x0A
119 #define PRESSURE10_REG_DRDY_PIN_CRTL 0x0D
120 #define PRESSURE10_REG_CONTROL_1 0x0E
121 #define PRESSURE10_REG_CONTROL_2 0x0F
122 #define PRESSURE10_REG_ACTION_CONTROL_1 0x10
123 #define PRESSURE10_REG_ACTION_CONTROL_2 0x11
124 #define PRESSURE10_REG_FIFO_CONTROL 0x12
125 #define PRESSURE10_REG_AVERAGE_CONTROL 0x13
126 #define PRESSURE10_REG_I2C_DISABLE 0x15
127 #define PRESSURE10_REG_PRODUCT_NUMBER 0x1C
128 #define PRESSURE10_CMD_PRESS_DETECTION 0x20
129 #define PRESSURE10_CMD_TEMP_DETECTION 0x22
130 #define PRESSURE10_CMD_SW_RESET 0x26
131 #define PRESSURE10_CMD_PT_DETECTION 0x29
132 
138 #define PRESSURE10_DEF_WHO_I_AM 0x49
139 #define PRESSURE10_DEF_INFO 0x31
140 #define PRESSURE10_DEF_PRODUCT_NUM 0x40
141 
147 #define PRESSURE10_CTRLDRDY_AFEV_ENABLE 0x80
148 #define PRESSURE10_CTRLDRDY_AFEV_DISABLE 0x00
149 #define PRESSURE10_CTRLDRDY_ATDR_ENABLE 0x10
150 #define PRESSURE10_CTRLDRDY_ATDR_DISABLE 0x00
151 #define PRESSURE10_CTRLDRDY_APOR_ENABLE 0x04
152 #define PRESSURE10_CTRLDRDY_APOR_DISABLE 0x00
153 #define PRESSURE10_CTRLDRDY_APDY_ENABLE 0x01
154 #define PRESSURE10_CTRLDRDY_APDY_DISABLE 0x00
155 
161 #define PRESSURE10_CTRL1_PDRP_LOW_ACTIVE 0x00
162 #define PRESSURE10_CTRL1_PDRP_HIGH_ACTIVE 0x10
163 #define PRESSURE10_CTRL1_PTAP_ULTRA_LOW_PWR 0x00
164 #define PRESSURE10_CTRL1_PTAP_LOW_PWR 0x01
165 #define PRESSURE10_CTRL1_PTAP_HIGH_ACCURACY 0x02
166 #define PRESSURE10_CTRL1_PTAP_ULTRA_ACCURACY 0x03
167 
173 #define PRESSURE10_CTRL2_TMES_DISABLE 0x00
174 #define PRESSURE10_CTRL2_TMES_ENABLE 0x80
175 #define PRESSURE10_CTRL2_PMES_DISABLE 0x00
176 #define PRESSURE10_CTRL2_PMES_ENABLE 0x20
177 #define PRESSURE10_CTRL2_ODR_1HZ 0x00
178 #define PRESSURE10_CTRL2_ODR_10HZ 0x04
179 #define PRESSURE10_CTRL2_ODR_100HZ 0x08
180 #define PRESSURE10_CTRL2_ODR_200HZ 0x0C
181 #define PRESSURE10_CTRL2_MODE_REG_ACTION 0x00
182 #define PRESSURE10_CTRL2_MODE_CONT_MEAS 0x01
183 #define PRESSURE10_CTRL2_MODE_CMD_ACTION 0x02
184 
190 #define PRESSURE10_ACTRL1_TEMP_NO_MEAS 0x00
191 #define PRESSURE10_ACTRL1_TEMP_MEAS 0x08
192 #define PRESSURE10_ACTRL1_PRESS_NO_MEAS 0x00
193 #define PRESSURE10_ACTRL1_PRESS_MEAS 0x02
194 
200 #define PRESSURE10_ACTRL2_SW_RESET_NONE 0x00
201 #define PRESSURE10_ACTRL2_SW_RESET_EXECUTE 0x80
202 
208 #define PRESSURE10_AVCTRL_TFRQ_ONLY_FIRST_TIME 0x00
209 #define PRESSURE10_AVCTRL_TFRQ_ONLY_EVERY_64_TIMES 0x08
210 #define PRESSURE10_AVCTRL_TFRQ_ONLY_EVERY_32_TIMES 0x10
211 #define PRESSURE10_AVCTRL_TFRQ_ONLY_EVERY_16_TIMES 0x18
212 #define PRESSURE10_AVCTRL_TFRQ_ONLY_EVERY_8_TIMES 0x20
213 #define PRESSURE10_AVCTRL_TFRQ_ONLY_EVERY_4_TIMES 0x28
214 #define PRESSURE10_AVCTRL_TFRQ_ONLY_EVERY_2_TIMES 0x30
215 #define PRESSURE10_AVCTRL_TFRQ_EVERY_TIME 0x38
216 #define PRESSURE10_AVCTRL_AVG_NONE 0x00
217 #define PRESSURE10_AVCTRL_AVG_X2 0x01
218 #define PRESSURE10_AVCTRL_AVG_X4 0x02
219 #define PRESSURE10_AVCTRL_AVG_X8 0x03
220 #define PRESSURE10_AVCTRL_AVG_X16 0x04
221 #define PRESSURE10_AVCTRL_AVG_X32 0x05
222 #define PRESSURE10_AVCTRL_AVG_X64 0x06
223 #define PRESSURE10_AVCTRL_AVG_X128 0x07
224  // End group macro
227 // --------------------------------------------------------------- PUBLIC TYPES
233 typedef struct
234 {
235  uint8_t busy;
236  uint8_t temp_meas;
237  uint8_t data_over;
238  uint8_t press_meas;
240 
241 
245 typedef uint8_t pressure10_select_t;
246 
250 typedef void ( *pressure10_master_io_t )( struct pressure10_s*, uint8_t, uint8_t*, uint8_t );
251 
255 typedef struct pressure10_s
256 {
257  // Output pins
258 
259  digital_out_t cs;
260 
261  // Input pins
262 
263  digital_in_t rdy;
264 
265  // Modules
266 
267  i2c_master_t i2c;
268  spi_master_t spi;
269 
270  // ctx variable
271 
272  uint8_t slave_address;
273  pin_name_t chip_select;
277 
279 
283 typedef struct
284 {
285  // Communication gpio pins
286 
287  pin_name_t scl;
288  pin_name_t sda;
289  pin_name_t miso;
290  pin_name_t mosi;
291  pin_name_t sck;
292  pin_name_t cs;
293 
294  // Additional gpio pins
295 
296  pin_name_t rdy;
297 
298  // static variable
299 
300  uint32_t i2c_speed;
301  uint8_t i2c_address;
302 
303  uint32_t spi_speed;
304  spi_master_mode_t spi_mode;
305  spi_master_chip_select_polarity_t cs_polarity;
306 
308 
310  // End types group
312 
313 // ----------------------------------------------- PUBLIC FUNCTION DECLARATIONS
319 #ifdef __cplusplus
320 extern "C"{
321 #endif
322 
332 
341 
350 
361 void pressure10_generic_write ( pressure10_t *ctx, uint8_t reg, uint8_t *data_buf, uint8_t len );
362 
373 void pressure10_generic_read ( pressure10_t *ctx, uint8_t reg, uint8_t *data_buf, uint8_t len );
374 
380 void pressure10_send_cmd ( pressure10_t *ctx, uint8_t cmd );
381 
390 
398 
406 
414 
422 void pressure10_control_cfg ( pressure10_t *ctx, uint8_t ctrl_reg, uint8_t wr_data );
423 
432 
433 #ifdef __cplusplus
434 }
435 #endif
436 #endif // _PRESSURE10_H_
437  // End public_function group
440 
441 // ------------------------------------------------------------------------- END
pressure10_cfg_t::cs_polarity
spi_master_chip_select_polarity_t cs_polarity
Definition: pressure10.h:305
pressure10_select_t
uint8_t pressure10_select_t
Communication type.
Definition: pressure10.h:245
pressure10_s::rdy
digital_in_t rdy
Definition: pressure10.h:263
pressure10_generic_read
void pressure10_generic_read(pressure10_t *ctx, uint8_t reg, uint8_t *data_buf, uint8_t len)
Generic read function.
pressure10_check_communication
uint8_t pressure10_check_communication(pressure10_t *ctx)
Check communication.
pressure10_cfg_t::sck
pin_name_t sck
Definition: pressure10.h:291
pressure10_cfg_t
Click configuration structure definition.
Definition: pressure10.h:284
pressure10_status_t::temp_meas
uint8_t temp_meas
Definition: pressure10.h:236
pressure10_cfg_t::cs
pin_name_t cs
Definition: pressure10.h:292
pressure10_status_t::press_meas
uint8_t press_meas
Definition: pressure10.h:238
pressure10_cfg_setup
void pressure10_cfg_setup(pressure10_cfg_t *cfg)
Config Object Initialization function.
pressure10_status_t::data_over
uint8_t data_over
Definition: pressure10.h:237
pressure10_master_io_t
void(* pressure10_master_io_t)(struct pressure10_s *, uint8_t, uint8_t *, uint8_t)
Master Input/Output type.
Definition: pressure10.h:250
pressure10_cfg_t::i2c_speed
uint32_t i2c_speed
Definition: pressure10.h:300
pressure10_get_temperature
float pressure10_get_temperature(pressure10_t *ctx)
Get Temperature data in C.
pressure10_control_cfg
void pressure10_control_cfg(pressure10_t *ctx, uint8_t ctrl_reg, uint8_t wr_data)
Set the configuration in the control registers.
pressure10_s::slave_address
uint8_t slave_address
Definition: pressure10.h:272
pressure10_s::cs
digital_out_t cs
Definition: pressure10.h:259
pressure10_s::master_sel
pressure10_select_t master_sel
Definition: pressure10.h:276
PRESSURE10_RETVAL
#define PRESSURE10_RETVAL
Definition: pressure10.h:76
pressure10_cfg_t::rdy
pin_name_t rdy
Definition: pressure10.h:296
pressure10_s::spi
spi_master_t spi
Definition: pressure10.h:268
pressure10_get_drdy_pin
uint8_t pressure10_get_drdy_pin(pressure10_t *ctx)
Get DRDY pin state.
pressure10_status_t::busy
uint8_t busy
Definition: pressure10.h:235
pressure10_cfg_t::sda
pin_name_t sda
Definition: pressure10.h:288
pressure10_t
struct pressure10_s pressure10_t
Click ctx object definition.
pressure10_cfg_t::i2c_address
uint8_t i2c_address
Definition: pressure10.h:301
pressure10_cfg_t::mosi
pin_name_t mosi
Definition: pressure10.h:290
pressure10_s::i2c
i2c_master_t i2c
Definition: pressure10.h:267
pressure10_cfg_t::spi_mode
spi_master_mode_t spi_mode
Definition: pressure10.h:304
pressure10_cfg_t::miso
pin_name_t miso
Definition: pressure10.h:289
pressure10_get_pressure
float pressure10_get_pressure(pressure10_t *ctx)
Get Pressure data in mBar.
pressure10_s::read_f
pressure10_master_io_t read_f
Definition: pressure10.h:275
pressure10_s
Click ctx object definition.
Definition: pressure10.h:256
pressure10_cfg_t::scl
pin_name_t scl
Definition: pressure10.h:287
pressure10_init
PRESSURE10_RETVAL pressure10_init(pressure10_t *ctx, pressure10_cfg_t *cfg)
Initialization function.
pressure10_generic_write
void pressure10_generic_write(pressure10_t *ctx, uint8_t reg, uint8_t *data_buf, uint8_t len)
Generic write function.
pressure10_cfg_t::spi_speed
uint32_t spi_speed
Definition: pressure10.h:303
pressure10_cfg_t::sel
pressure10_select_t sel
Definition: pressure10.h:307
pressure10_status_t
Definition: pressure10.h:234
pressure10_s::write_f
pressure10_master_io_t write_f
Definition: pressure10.h:274
pressure10_s::chip_select
pin_name_t chip_select
Definition: pressure10.h:273
pressure10_default_cfg
void pressure10_default_cfg(pressure10_t *ctx)
Click Default Configuration function.
pressure10_get_status
void pressure10_get_status(pressure10_t *ctx, pressure10_status_t *status_obj)
Get status function.
pressure10_send_cmd
void pressure10_send_cmd(pressure10_t *ctx, uint8_t cmd)
Send command.