ldc2  2.0.0.0
ldc2.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 LDC2_H
29 #define LDC2_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_spi_master.h"
48 #include "spi_specifics.h"
49 
70 #define LDC2_REG_DEVICE_ID 0x00
71 #define LDC2_REG_RP_MAX 0x01
72 #define LDC2_REG_RP_MIN 0x02
73 #define LDC2_REG_WDT_FREQ 0x03
74 #define LDC2_REG_LDC_CONFIG 0x04
75 #define LDC2_REG_COMPARATOR_THLD_HIGH 0x07
76 #define LDC2_REG_COMPARATOR_THLD_LOW 0x09
77 #define LDC2_REG_INTB_TERMINAL_CONFIG 0x0A
78 #define LDC2_REG_POWER_CONFIG 0x0B
79 #define LDC2_REG_STATUS 0x20
80 #define LDC2_REG_PROXIMITY_DATA 0x22
81 #define LDC2_REG_FREQ_CNT_DATA_LSB 0x23
82 #define LDC2_REG_FREQ_CNT_DATA_MID_BYTE 0x24
83 #define LDC2_REG_FREQ_CNT_DATA_MSB 0x25
84  // ldc2_reg
86 
101 #define LDC2_DEVICE_ID 0x84
102 
107 #define LDC2_SPI_READ_MASK 0x80
108 #define LDC2_SPI_WRITE_MASK 0x7F
109 
114 #define LDC2_COMPARATOR_THLD_MIN 0x00
115 #define LDC2_COMPARATOR_THLD_MAX 0xFF
116 
121 #define LDC2_STATUS_OSC_STOPPED 0x80
122 #define LDC2_STATUS_NO_NEW_DATA 0x40
123 #define LDC2_STATUS_WAKE_UP_DISABLED 0x20
124 #define LDC2_STATUS_PROX_DATA_LESS_THAN_THLD 0x10
125 
130 #define LDC2_MHZ_TO_HZ 1000000.0
131 #define LDC2_EXTERNAL_OSC_MHZ 1.8432
132 #define LDC2_PARALLEL_CAPACITANCE_uF 0.000047
133 #define LDC2_MIN_SENSOR_FREQ_CONST 68.94
134 #define LDC2_MIN_SENSOR_FREQ_DIVIDER 2500.0
135 #define LDC2_ROUND_TO_NEAREST_INT 0.5
136 
145 #define LDC2_SET_DATA_SAMPLE_EDGE SET_SPI_DATA_SAMPLE_EDGE
146 #define LDC2_SET_DATA_SAMPLE_MIDDLE SET_SPI_DATA_SAMPLE_MIDDLE
147  // ldc2_set
149 
164 #define LDC2_MAP_MIKROBUS( cfg, mikrobus ) \
165  cfg.miso = MIKROBUS( mikrobus, MIKROBUS_MISO ); \
166  cfg.mosi = MIKROBUS( mikrobus, MIKROBUS_MOSI ); \
167  cfg.sck = MIKROBUS( mikrobus, MIKROBUS_SCK ); \
168  cfg.cs = MIKROBUS( mikrobus, MIKROBUS_CS ); \
169  cfg.int_pin = MIKROBUS( mikrobus, MIKROBUS_INT )
170  // ldc2_map // ldc2
173 
178 typedef struct
179 {
180  digital_in_t int_pin;
182  // Modules
183  spi_master_t spi;
185  pin_name_t chip_select;
187 } ldc2_t;
188 
193 typedef struct
194 {
195  // Communication gpio pins
196  pin_name_t miso;
197  pin_name_t mosi;
198  pin_name_t sck;
199  pin_name_t cs;
201  // Additional gpio pins
202  pin_name_t int_pin;
204  // static variable
205  uint32_t spi_speed;
206  spi_master_mode_t spi_mode;
207  spi_master_chip_select_polarity_t cs_polarity;
209 } ldc2_cfg_t;
210 
215 typedef enum
216 {
217  LDC2_OK = 0,
218  LDC2_ERROR = -1
219 
221 
226 typedef enum
227 {
260 
262 
267 typedef enum
268 {
272 
274 
279 typedef enum
280 {
287 
289 
294 typedef enum
295 {
300 
302 
307 typedef enum
308 {
311 
313 
330 
344 err_t ldc2_init ( ldc2_t *ctx, ldc2_cfg_t *cfg );
345 
358 err_t ldc2_default_cfg ( ldc2_t *ctx );
359 
374 err_t ldc2_generic_write ( ldc2_t *ctx, uint8_t reg, uint8_t *data_in, uint8_t len );
375 
390 err_t ldc2_generic_read ( ldc2_t *ctx, uint8_t reg, uint8_t *data_out, uint8_t len );
391 
403 
418 
433 err_t ldc2_set_ldc_config ( ldc2_t *ctx, ldc2_amplitude_t amplitude, ldc2_resp_time_t res_time );
434 
447 err_t ldc2_set_comparator_threshold ( ldc2_t *ctx, uint8_t thld_low, uint8_t thld_high );
448 
462 
476 
488 err_t ldc2_get_status ( ldc2_t *ctx, uint8_t *status );
489 
503 err_t ldc2_read_raw_data ( ldc2_t *ctx, uint8_t *prox_data, uint32_t *freq_cnt );
504 
517 err_t ldc2_get_response_time ( ldc2_t *ctx, uint16_t *res_time );
518 
530 err_t ldc2_get_sensor_frequency ( ldc2_t *ctx, float *freq );
531 
545 err_t ldc2_get_rp_range ( ldc2_t *ctx, float *rp_min, float *rp_max );
546 
558 
567 uint8_t ldc2_get_int_pin ( ldc2_t *ctx );
568 
581 err_t ldc2_measure_resonance_impedance ( ldc2_t *ctx, uint8_t *prox_data, float *rp_data );
582 
595 err_t ldc2_measure_inductance ( ldc2_t *ctx, float *freq, float *inductance );
596 
597 #ifdef __cplusplus
598 }
599 #endif
600 #endif // LDC2_H
601  // ldc2
603 
604 // ------------------------------------------------------------------------ END
LDC2_RP_38p785
@ LDC2_RP_38p785
Definition: ldc2.h:245
LDC2_ERROR
@ LDC2_ERROR
Definition: ldc2.h:218
LDC2_RP_12p120
@ LDC2_RP_12p120
Definition: ldc2.h:249
LDC2_PWR_MODE_STANDBY
@ LDC2_PWR_MODE_STANDBY
Definition: ldc2.h:309
ldc2_get_status
err_t ldc2_get_status(ldc2_t *ctx, uint8_t *status)
LDC 2 get status function.
LDC2_AMPLITUDE_1V
@ LDC2_AMPLITUDE_1V
Definition: ldc2.h:269
LDC2_RP_3p078
@ LDC2_RP_3p078
Definition: ldc2.h:254
LDC2_RESPONSE_TIME_6144
@ LDC2_RESPONSE_TIME_6144
Definition: ldc2.h:286
LDC2_RP_1308p997
@ LDC2_RP_1308p997
Definition: ldc2.h:232
LDC2_INTB_MODE_DRDY
@ LDC2_INTB_MODE_DRDY
Definition: ldc2.h:299
LDC2_RP_3141p593
@ LDC2_RP_3141p593
Definition: ldc2.h:229
LDC2_RP_193p926
@ LDC2_RP_193p926
Definition: ldc2.h:239
ldc2_cfg_t::spi_speed
uint32_t spi_speed
Definition: ldc2.h:205
ldc2_read_raw_data
err_t ldc2_read_raw_data(ldc2_t *ctx, uint8_t *prox_data, uint32_t *freq_cnt)
LDC 2 read raw data function.
spi_specifics.h
This file contains SPI specific macros, functions, etc.
LDC2_OK
@ LDC2_OK
Definition: ldc2.h:217
LDC2_RP_1745p329
@ LDC2_RP_1745p329
Definition: ldc2.h:231
LDC2_RP_64p642
@ LDC2_RP_64p642
Definition: ldc2.h:243
LDC2_INTB_MODE_DISABLED
@ LDC2_INTB_MODE_DISABLED
Definition: ldc2.h:296
LDC2_RP_436p332
@ LDC2_RP_436p332
Definition: ldc2.h:236
LDC2_AMPLITUDE_2V
@ LDC2_AMPLITUDE_2V
Definition: ldc2.h:270
LDC2_INTB_MODE_COMPARATOR_OUT
@ LDC2_INTB_MODE_COMPARATOR_OUT
Definition: ldc2.h:298
ldc2_set_wdt_frequency
err_t ldc2_set_wdt_frequency(ldc2_t *ctx)
LDC 2 set watchdog timer frequency function.
ldc2_get_rp_range
err_t ldc2_get_rp_range(ldc2_t *ctx, float *rp_min, float *rp_max)
LDC 2 get Rp range function.
ldc2_cfg_setup
void ldc2_cfg_setup(ldc2_cfg_t *cfg)
LDC 2 configuration object setup function.
ldc2_pwr_mode_t
ldc2_pwr_mode_t
LDC 2 Click Power configuration values.
Definition: ldc2.h:308
LDC2_RP_2p394
@ LDC2_RP_2p394
Definition: ldc2.h:255
LDC2_RP_1p796
@ LDC2_RP_1p796
Definition: ldc2.h:256
LDC2_RP_1p026
@ LDC2_RP_1p026
Definition: ldc2.h:258
ldc2_generic_write
err_t ldc2_generic_write(ldc2_t *ctx, uint8_t reg, uint8_t *data_in, uint8_t len)
LDC 2 data writing function.
LDC2_RP_5p387
@ LDC2_RP_5p387
Definition: ldc2.h:252
LDC2_RP_16p160
@ LDC2_RP_16p160
Definition: ldc2.h:248
ldc2_t::chip_select
pin_name_t chip_select
Definition: ldc2.h:185
LDC2_RP_981p748
@ LDC2_RP_981p748
Definition: ldc2.h:233
ldc2_default_cfg
err_t ldc2_default_cfg(ldc2_t *ctx)
LDC 2 default configuration function.
LDC2_RP_1p347
@ LDC2_RP_1p347
Definition: ldc2.h:257
ldc2_cfg_t
LDC 2 Click configuration object.
Definition: ldc2.h:194
ldc2_check_device_id
err_t ldc2_check_device_id(ldc2_t *ctx)
LDC 2 check device ID function.
LDC2_AMPLITUDE_4V
@ LDC2_AMPLITUDE_4V
Definition: ldc2.h:271
ldc2_set_power_mode
err_t ldc2_set_power_mode(ldc2_t *ctx, ldc2_pwr_mode_t mode)
LDC 2 set power mode function.
ldc2_set_interrupt_mode
err_t ldc2_set_interrupt_mode(ldc2_t *ctx, ldc2_int_mode_t mode)
LDC 2 set interrupt mode function.
LDC2_RP_9p235
@ LDC2_RP_9p235
Definition: ldc2.h:250
LDC2_RP_83p111
@ LDC2_RP_83p111
Definition: ldc2.h:242
ldc2_amplitude_t
ldc2_amplitude_t
LDC 2 Click amplitude values.
Definition: ldc2.h:268
ldc2_cfg_t::int_pin
pin_name_t int_pin
Definition: ldc2.h:202
LDC2_RP_21p547
@ LDC2_RP_21p547
Definition: ldc2.h:247
LDC2_RP_747p998
@ LDC2_RP_747p998
Definition: ldc2.h:234
ldc2_get_int_pin
uint8_t ldc2_get_int_pin(ldc2_t *ctx)
LDC 2 get int pin function.
ldc2_generic_read
err_t ldc2_generic_read(ldc2_t *ctx, uint8_t reg, uint8_t *data_out, uint8_t len)
LDC 2 data reading function.
LDC2_RESPONSE_TIME_384
@ LDC2_RESPONSE_TIME_384
Definition: ldc2.h:282
LDC2_RP_27p704
@ LDC2_RP_27p704
Definition: ldc2.h:246
LDC2_RESPONSE_TIME_1536
@ LDC2_RESPONSE_TIME_1536
Definition: ldc2.h:284
ldc2_cfg_t::sck
pin_name_t sck
Definition: ldc2.h:198
ldc2_get_sensor_frequency
err_t ldc2_get_sensor_frequency(ldc2_t *ctx, float *freq)
LDC 2 get sensor frequency function.
LDC2_RP_3926p991
@ LDC2_RP_3926p991
Definition: ldc2.h:228
LDC2_RP_109p083
@ LDC2_RP_109p083
Definition: ldc2.h:241
ldc2_set_comparator_threshold
err_t ldc2_set_comparator_threshold(ldc2_t *ctx, uint8_t thld_low, uint8_t thld_high)
LDC 2 set comparator threshold function.
ldc2_cfg_t::spi_mode
spi_master_mode_t spi_mode
Definition: ldc2.h:206
ldc2_cfg_t::cs_polarity
spi_master_chip_select_polarity_t cs_polarity
Definition: ldc2.h:207
LDC2_RESPONSE_TIME_192
@ LDC2_RESPONSE_TIME_192
Definition: ldc2.h:281
LDC2_INTB_MODE_WAKE_UP
@ LDC2_INTB_MODE_WAKE_UP
Definition: ldc2.h:297
ldc2_t
LDC 2 Click context object.
Definition: ldc2.h:179
LDC2_RP_48p481
@ LDC2_RP_48p481
Definition: ldc2.h:244
LDC2_RESPONSE_TIME_3072
@ LDC2_RESPONSE_TIME_3072
Definition: ldc2.h:285
ldc2_rp_range_t
ldc2_rp_range_t
LDC 2 Click Rp range values.
Definition: ldc2.h:227
ldc2_measure_inductance
err_t ldc2_measure_inductance(ldc2_t *ctx, float *freq, float *inductance)
LDC 2 measure inductance function.
LDC2_RP_4p309
@ LDC2_RP_4p309
Definition: ldc2.h:253
LDC2_RP_2243p995
@ LDC2_RP_2243p995
Definition: ldc2.h:230
ldc2_cfg_t::miso
pin_name_t miso
Definition: ldc2.h:196
ldc2_cfg_t::cs
pin_name_t cs
Definition: ldc2.h:199
LDC2_PWR_MODE_ACTIVE
@ LDC2_PWR_MODE_ACTIVE
Definition: ldc2.h:310
ldc2_set_ldc_config
err_t ldc2_set_ldc_config(ldc2_t *ctx, ldc2_amplitude_t amplitude, ldc2_resp_time_t res_time)
LDC 2 set LDC config function.
LDC2_RP_0p798
@ LDC2_RP_0p798
Definition: ldc2.h:259
ldc2_t::spi
spi_master_t spi
Definition: ldc2.h:183
LDC2_RP_7p182
@ LDC2_RP_7p182
Definition: ldc2.h:251
ldc2_t::int_pin
digital_in_t int_pin
Definition: ldc2.h:180
LDC2_RP_581p776
@ LDC2_RP_581p776
Definition: ldc2.h:235
ldc2_set_rp_range
err_t ldc2_set_rp_range(ldc2_t *ctx, ldc2_rp_range_t rp_min, ldc2_rp_range_t rp_max)
LDC 2 set Rp range function.
LDC2_RESPONSE_TIME_768
@ LDC2_RESPONSE_TIME_768
Definition: ldc2.h:283
ldc2_cfg_t::mosi
pin_name_t mosi
Definition: ldc2.h:197
ldc2_measure_resonance_impedance
err_t ldc2_measure_resonance_impedance(ldc2_t *ctx, uint8_t *prox_data, float *rp_data)
LDC 2 measure resonance impedance function.
ldc2_return_value_t
ldc2_return_value_t
LDC 2 Click return value data.
Definition: ldc2.h:216
LDC2_RP_249p333
@ LDC2_RP_249p333
Definition: ldc2.h:238
ldc2_init
err_t ldc2_init(ldc2_t *ctx, ldc2_cfg_t *cfg)
LDC 2 initialization function.
ldc2_resp_time_t
ldc2_resp_time_t
LDC 2 Click response time values.
Definition: ldc2.h:280
ldc2_int_mode_t
ldc2_int_mode_t
LDC 2 Click INTB Terminal configuration values.
Definition: ldc2.h:295
LDC2_RP_145p444
@ LDC2_RP_145p444
Definition: ldc2.h:240
LDC2_RP_349p066
@ LDC2_RP_349p066
Definition: ldc2.h:237
ldc2_get_response_time
err_t ldc2_get_response_time(ldc2_t *ctx, uint16_t *res_time)
LDC 2 get response time function.