rtd2  2.0.0.0
rtd2.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 RTD2_H
36 #define RTD2_H
37 
38 #include "drv_digital_out.h"
39 #include "drv_digital_in.h"
40 #include "drv_spi_master.h"
41 #include "spi_specifics.h"
42 
43 // -------------------------------------------------------------- PUBLIC MACROS
54 #define RTD2_MAP_MIKROBUS( cfg, mikrobus ) \
55  cfg.miso = MIKROBUS( mikrobus, MIKROBUS_MISO ); \
56  cfg.mosi = MIKROBUS( mikrobus, MIKROBUS_MOSI ); \
57  cfg.sck = MIKROBUS( mikrobus, MIKROBUS_SCK ); \
58  cfg.cs = MIKROBUS( mikrobus, MIKROBUS_CS ); \
59  cfg.str = MIKROBUS( mikrobus, MIKROBUS_AN ); \
60  cfg.rst = MIKROBUS( mikrobus, MIKROBUS_RST ); \
61  cfg.rdy = MIKROBUS( mikrobus, MIKROBUS_INT )
62 
72 #define RTD2_SET_DATA_SAMPLE_EDGE SET_SPI_DATA_SAMPLE_EDGE
73 #define RTD2_SET_DATA_SAMPLE_MIDDLE SET_SPI_DATA_SAMPLE_MIDDLE
74 
79 #define RTD2_REG_MUX0 0x00
80 #define RTD2_REG_VBIAS 0x01
81 #define RTD2_REG_MUX1 0x02
82 #define RTD2_REG_SYS0 0x03
83 #define RTD2_REG_OFC0 0x04
84 #define RTD2_REG_OFC1 0x05
85 #define RTD2_REG_OFC2 0x06
86 #define RTD2_REG_FSC0 0x07
87 #define RTD2_REG_FSC1 0x08
88 #define RTD2_REG_FSC2 0x09
89 #define RTD2_REG_IDAC0 0x0A
90 #define RTD2_REG_IDAC1 0x0B
91 #define RTD2_REG_GPIOCFG 0x0C
92 #define RTD2_REG_GPIODIR 0x0D
93 #define RTD2_REG_GPIODAT 0x0E
94 
105 #define RTD2_CMD_WAKEUP 0x01
106 #define RTD2_CMD_SLEEP 0x03
107 #define RTD2_CMD_SYNC 0x05
108 #define RTD2_CMD_RESET 0x07
109 #define RTD2_CMD_NOP 0xFF
110 
116 #define RTD2_CMD_RDATA 0x12
117 #define RTD2_CMD_RDATAC 0x14
118 #define RTD2_CMD_SDATAC 0x16
119 
125 #define RTD2_CMD_RREG 0x20
126 
132 #define RTD2_CMD_WREG 0x40
133 
139 #define RTD2_CMD_SYSOCAL 0x60
140 #define RTD2_CMD_SYSGCAL 0x61
141 #define RTD2_CMD_SELFOCAL 0x62
142 
148 #define RTD2_RW_DUMMY 0xFF
149 
161 #define RTD2_BCS_OFF 0x00
162 #define RTD2_BCS_500 0x40
163 #define RTD2_BCS_2 0x80
164 #define RTD2_BCS_10 0xC0
165 
171 #define RTD2_AINP0 0x00
172 #define RTD2_AINP1 0x08
173 #define RTD2_AINP2 0x10
174 #define RTD2_AINP3 0x18
175 #define RTD2_AIN_POS 0x38
176 
182 #define RTD2_AINN0 0x00
183 #define RTD2_AINN1 0x01
184 #define RTD2_AINN2 0x02
185 #define RTD2_AINN3 0x03
186 #define RTD2_AIN_NEG 0x07
187 
193 #define RTD2_VBIAS_OFF 0x00
194 #define RTD2_VBIAS0 0x01
195 #define RTD2_VBIAS1 0x02
196 #define RTD2_VBIAS2 0x04
197 #define RTD2_VBIAS3 0x08
198 
210 #define RTD2_INT_VREF_OFF 0x00
211 #define RTD2_INT_VREF_ON 0x20
212 #define RTD2_INT_VREF_CONV 0x40
213 
219 #define RTD2_REF0 0x00
220 #define RTD2_INT 0x10
221 #define RTD2_INT_REF0 0x18
222 
228 #define RTD2_MEAS_NORM 0x00
229 #define RTD2_MEAS_OFFSET 0x01
230 #define RTD2_MEAS_GAIN 0x02
231 #define RTD2_MEAS_TEMP 0x03
232 #define RTD2_MEAS_REF0 0x05
233 #define RTD2_MEAS_AVDD 0x06
234 #define RTD2_MEAS_DVDD 0x07
235 
247 #define RTD2_GAIN_1 0x00
248 #define RTD2_GAIN_2 0x10
249 #define RTD2_GAIN_4 0x20
250 #define RTD2_GAIN_8 0x30
251 #define RTD2_GAIN_16 0x40
252 #define RTD2_GAIN_32 0x50
253 #define RTD2_GAIN_64 0x60
254 #define RTD2_GAIN_128 0x70
255 
261 #define RTD2_DR_5 0x00
262 #define RTD2_DR_10 0x01
263 #define RTD2_DR_20 0x02
264 #define RTD2_DR_40 0x03
265 #define RTD2_DR_80 0x04
266 #define RTD2_DR_160 0x05
267 #define RTD2_DR_320 0x06
268 #define RTD2_DR_640 0x07
269 #define RTD2_DR_1000 0x08
270 #define RTD2_DR_2000 0x0F
271 
283 #define RTD2_IDAC_ID 0x90
284 
290 #define RTD2_DRDY_OFF 0x00
291 #define RTD2_DRDY_ON 0x08
292 
298 #define RTD2_IDAC_OFF 0x00
299 #define RTD2_IDAC_50 0x01
300 #define RTD2_IDAC_100 0x02
301 #define RTD2_IDAC_250 0x03
302 #define RTD2_IDAC_500 0x04
303 #define RTD2_IDAC_750 0x05
304 #define RTD2_IDAC_1000 0x06
305 #define RTD2_IDAC_1500 0x07
306 
318 #define RTD2_IDAC1_A0 0xCC
319 #define RTD2_IDAC1_A1 0xDC
320 #define RTD2_IDAC1_A2 0xEC
321 #define RTD2_IDAC1_A3 0xFC
322 
328 #define RTD2_IDAC2_A0 0xCC
329 #define RTD2_IDAC2_A1 0xCD
330 #define RTD2_IDAC2_A2 0xCE
331 #define RTD2_IDAC2_A3 0xCF
332 
344 #define RTD2_GPIO_0 0x01
345 #define RTD2_GPIO_1 0x02
346 #define RTD2_GPIO_2 0x04
347 #define RTD2_GPIO_3 0x08
348 
360 #define RTD2_IO_0 0x01
361 #define RTD2_IO_1 0x02
362 #define RTD2_IO_2 0x04
363 #define RTD2_IO_3 0x08
364 
371 #define RTD2_OUT_0 0x01
372 #define RTD2_OUT_1 0x02
373 #define RTD2_OUT_2 0x04
374 #define RTD2_OUT_3 0x08
375 
381 #define RTD2_PIN_LOW 0x00
382 #define RTD2_PIN_HIGH 0x01
383 
389 #define RTD2_ERROR 0x00
390 #define RTD2_SUCCESS 0x01
391 
397 #define RTD2_START_CONVERSION_DISABLE 0x00
398 #define RTD2_START_CONVERSION_ENABLE 0x01
399 
405 #define RTD2_NEW_DATA_IS_NOT_READY 0x00
406 #define RTD2_NEW_DATA_IS_READY 0x01
407 
413 #define COEFF_PT100_RESISTANCE_OHMS_0_C 100.00000000
414 #define COEFF_ALPHA 0.3920000000
415 #define COEFF_ADC_RES_RT_P 0.0000753846
416 #define COEFF_ADC_COR_FACT 50.980300000
417  // End group macro
419 // --------------------------------------------------------------- PUBLIC TYPES
428 typedef struct
429 {
430  digital_out_t cs;
431  // Output pins
432 
433  digital_out_t str;
434  digital_out_t rst;
435 
436  // Input pins
437  digital_in_t rdy;
438 
439  // Modules
440  spi_master_t spi;
441  pin_name_t chip_select;
442 
443 } rtd2_t;
444 
448 typedef struct
449 {
450  // Communication gpio pins
451  pin_name_t miso;
452  pin_name_t mosi;
453  pin_name_t sck;
454  pin_name_t cs;
455 
456  // Additional gpio pins
457  pin_name_t str;
458  pin_name_t rst;
459  pin_name_t rdy;
460 
461  // static variable
462  uint32_t spi_speed;
463  spi_master_mode_t spi_mode;
464  spi_master_chip_select_polarity_t cs_polarity;
465 
466 } rtd2_cfg_t;
467  // End types group
469 // ----------------------------------------------- PUBLIC FUNCTION DECLARATIONS
470 
475 #ifdef __cplusplus
476 extern "C"{
477 #endif
478 
488 
498 err_t rtd2_init ( rtd2_t *ctx, rtd2_cfg_t *cfg );
499 
519 void rtd2_default_cfg ( rtd2_t *ctx );
520 
533 void rtd2_hw_reset ( rtd2_t *ctx );
534 
548 void rtd2_toggle_cs ( rtd2_t *ctx, uint8_t cs_state );
549 
563 void rtd2_enable_start ( rtd2_t *ctx, uint8_t en_start );
564 
581 uint8_t rtd2_check_interupt ( rtd2_t *ctx );
582 
594 void rtd2_send_cmd ( rtd2_t *ctx, uint8_t cmd );
595 
606 void rtd2_set_wakeup ( rtd2_t *ctx );
607 
618 void rtd2_set_sleep ( rtd2_t *ctx );
619 
631 void rtd2_set_sync ( rtd2_t *ctx );
632 
644 void rtd2_set_reset ( rtd2_t *ctx );
645 
658 
671 
684 
702 void rtd2_write_continuous ( rtd2_t *ctx, uint8_t reg, uint8_t *p_tx_data, uint8_t n_bytes );
703 
721 void rtd2_read_continuous ( rtd2_t *ctx, uint8_t reg, uint8_t *p_rx_data, uint8_t n_bytes );
722 
738 void rtd2_write_reg ( rtd2_t *ctx, uint8_t reg, uint8_t tx_data );
739 
756 uint8_t rtd2_read_reg ( rtd2_t *ctx, uint8_t reg );
757 
778 uint8_t rtd2_set_burn_out_source ( rtd2_t *ctx, uint8_t burn_out );
779 
803 void rtd2_set_mux_sel ( rtd2_t *ctx, uint8_t adc_pos, uint8_t adc_neg );
804 
826 uint8_t rtd2_set_bias ( rtd2_t *ctx, uint8_t bias );
827 
847 uint8_t rtd2_set_int_ref ( rtd2_t *ctx, uint8_t s_ref );
848 
868 void rtd2_set_system_monitor ( rtd2_t *ctx, uint8_t sys_mon );
869 
902 void rtd2_set_system_control ( rtd2_t *ctx, uint8_t gain, uint8_t output_rate );
903 
924 void rtd2_set_idac_current_mag ( rtd2_t *ctx, uint8_t c_idac );
925 
948 void rtd2_set_idac_current_out ( rtd2_t *ctx, uint8_t c_out_1, uint8_t c_out_2 );
949 
965 
978 int32_t rtd2_read_output_data ( rtd2_t *ctx );
979 
994 float rtd2_calc_temperature ( int32_t adc_val );
995 
1010 
1011 #ifdef __cplusplus
1012 }
1013 #endif
1014 #endif // _RTD2_H_
1015  // End public_function group
1018 
1019 // ------------------------------------------------------------------------- END
rtd2_set_system_control
void rtd2_set_system_control(rtd2_t *ctx, uint8_t gain, uint8_t output_rate)
Set system control function.
rtd2_cfg_t::sck
pin_name_t sck
Definition: rtd2.h:453
rtd2_t::chip_select
pin_name_t chip_select
Definition: rtd2.h:441
rtd2_set_mux_sel
void rtd2_set_mux_sel(rtd2_t *ctx, uint8_t adc_pos, uint8_t adc_neg)
Set multiplexer selection function.
rtd2_set_idac_current_out
void rtd2_set_idac_current_out(rtd2_t *ctx, uint8_t c_out_1, uint8_t c_out_2)
Set IDAC current out function.
rtd2_t::cs
digital_out_t cs
Definition: rtd2.h:430
rtd2_set_int_ref
uint8_t rtd2_set_int_ref(rtd2_t *ctx, uint8_t s_ref)
Set int ref function.
rtd2_set_bias
uint8_t rtd2_set_bias(rtd2_t *ctx, uint8_t bias)
Set bias function.
rtd2_cfg_t::spi_mode
spi_master_mode_t spi_mode
Definition: rtd2.h:463
rtd2_get_temperature
float rtd2_get_temperature(rtd2_t *ctx)
Get temperature function.
rtd2_calc_temperature
float rtd2_calc_temperature(int32_t adc_val)
Calculate temperature function.
rtd2_set_system_monitor
void rtd2_set_system_monitor(rtd2_t *ctx, uint8_t sys_mon)
Set system monitor function.
rtd2_send_cmd
void rtd2_send_cmd(rtd2_t *ctx, uint8_t cmd)
Send command function.
rtd2_toggle_cs
void rtd2_toggle_cs(rtd2_t *ctx, uint8_t cs_state)
Toggle CS pin function.
rtd2_set_sleep
void rtd2_set_sleep(rtd2_t *ctx)
Set to sleep function.
spi_specifics.h
This file contains SPI specific macros, functions, etc.
rtd2_t::rst
digital_out_t rst
Definition: rtd2.h:434
rtd2_cfg_t::rdy
pin_name_t rdy
Definition: rtd2.h:459
rtd2_t
Click ctx object definition.
Definition: rtd2.h:429
rtd2_enable_start
void rtd2_enable_start(rtd2_t *ctx, uint8_t en_start)
Enable conversion start function.
rtd2_cfg_t::spi_speed
uint32_t spi_speed
Definition: rtd2.h:462
rtd2_set_read_data_once
void rtd2_set_read_data_once(rtd2_t *ctx)
Set read data once function.
rtd2_cfg_t::rst
pin_name_t rst
Definition: rtd2.h:458
rtd2_cfg_t
Click configuration structure definition.
Definition: rtd2.h:449
rtd2_set_idac_current_mag
void rtd2_set_idac_current_mag(rtd2_t *ctx, uint8_t c_idac)
Set IDAC current magnitude function.
rtd2_cfg_t::miso
pin_name_t miso
Definition: rtd2.h:451
rtd2_cfg_t::mosi
pin_name_t mosi
Definition: rtd2.h:452
rtd2_check_new_data_ready
uint8_t rtd2_check_new_data_ready(rtd2_t *ctx)
Check new data ready function.
rtd2_t::str
digital_out_t str
Definition: rtd2.h:433
rtd2_cfg_setup
void rtd2_cfg_setup(rtd2_cfg_t *cfg)
Config Object Initialization function.
rtd2_set_sync
void rtd2_set_sync(rtd2_t *ctx)
Set sync function.
rtd2_set_read_data_continuous
void rtd2_set_read_data_continuous(rtd2_t *ctx)
Set read data continuous function.
rtd2_cfg_t::cs_polarity
spi_master_chip_select_polarity_t cs_polarity
Definition: rtd2.h:464
rtd2_read_output_data
int32_t rtd2_read_output_data(rtd2_t *ctx)
Read output data function.
rtd2_cfg_t::str
pin_name_t str
Definition: rtd2.h:457
rtd2_default_cfg
void rtd2_default_cfg(rtd2_t *ctx)
Set default configuration function.
rtd2_set_burn_out_source
uint8_t rtd2_set_burn_out_source(rtd2_t *ctx, uint8_t burn_out)
Set burn out source function.
rtd2_hw_reset
void rtd2_hw_reset(rtd2_t *ctx)
Hardware reset function.
rtd2_t::rdy
digital_in_t rdy
Definition: rtd2.h:437
rtd2_set_wakeup
void rtd2_set_wakeup(rtd2_t *ctx)
Set wakeup function.
rtd2_t::spi
spi_master_t spi
Definition: rtd2.h:440
rtd2_read_reg
uint8_t rtd2_read_reg(rtd2_t *ctx, uint8_t reg)
Read the register function.
rtd2_init
err_t rtd2_init(rtd2_t *ctx, rtd2_cfg_t *cfg)
Initialization function.
rtd2_set_stop_data
void rtd2_set_stop_data(rtd2_t *ctx)
Set stop data function.
rtd2_set_reset
void rtd2_set_reset(rtd2_t *ctx)
Set reset function.
rtd2_read_continuous
void rtd2_read_continuous(rtd2_t *ctx, uint8_t reg, uint8_t *p_rx_data, uint8_t n_bytes)
Continuous read the data function.
rtd2_write_continuous
void rtd2_write_continuous(rtd2_t *ctx, uint8_t reg, uint8_t *p_tx_data, uint8_t n_bytes)
Continuous write the data function.
rtd2_write_reg
void rtd2_write_reg(rtd2_t *ctx, uint8_t reg, uint8_t tx_data)
Write the register function.
rtd2_cfg_t::cs
pin_name_t cs
Definition: rtd2.h:454
rtd2_check_interupt
uint8_t rtd2_check_interupt(rtd2_t *ctx)
Check interrupt status function.