proximity18  2.1.0.0
proximity18.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 PROXIMITY18_H
29 #define PROXIMITY18_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 
69 #define PROXIMITY18_REG_PS_CONF12 0x03
70 #define PROXIMITY18_REG_PS_CONF3_MS 0x04
71 #define PROXIMITY18_REG_PS_CANC 0x05
72 #define PROXIMITY18_REG_PS_THDL 0x06
73 #define PROXIMITY18_REG_PS_THDH 0x07
74 #define PROXIMITY18_REG_PS1_DATA 0x08
75 #define PROXIMITY18_REG_PS2_DATA 0x09
76 #define PROXIMITY18_REG_PS3_DATA 0x0A
77 #define PROXIMITY18_REG_INT_FLAG 0x0D
78 #define PROXIMITY18_REG_ID 0x0E
79  // proximity18_reg
81 
96 #define PROXIMITY18_PS_CONF2_MPX_INT_EN_DIS 0x0000
97 #define PROXIMITY18_PS_CONF2_MPX_INT_EN_EN 0x8000
98 #define PROXIMITY18_PS_CONF2_MPX_INT_EN_MASK 0x8000
99 #define PROXIMITY18_PS_CONF2_MPX_MODE_DIS 0x0000
100 #define PROXIMITY18_PS_CONF2_MPX_MODE_EN 0x4000
101 #define PROXIMITY18_PS_CONF2_MPX_MODE_MASK 0x4000
102 #define PROXIMITY18_PS_CONF2_PS_GAIN_TWO_STEP 0x0000
103 #define PROXIMITY18_PS_CONF2_PS_GAIN_SINGLE_X8 0x2000
104 #define PROXIMITY18_PS_CONF2_PS_GAIN_SINGLE_X1 0x3000
105 #define PROXIMITY18_PS_CONF2_PS_GAIN_MASK 0x3000
106 #define PROXIMITY18_PS_CONF2_PS_HD_12BITS 0x0000
107 #define PROXIMITY18_PS_CONF2_PS_HD_16BITS 0x0800
108 #define PROXIMITY18_PS_CONF2_PS_HD_MASK 0x0800
109 #define PROXIMITY18_PS_CONF2_PS_NS_MASK 0x0400
110 #define PROXIMITY18_PS_CONF2_PS_INT_DIS 0x0000
111 #define PROXIMITY18_PS_CONF2_PS_INT_CLOSE 0x0100
112 #define PROXIMITY18_PS_CONF2_PS_INT_AWAY 0x0200
113 #define PROXIMITY18_PS_CONF2_PS_INT_CLOSE_AWAY 0x0300
114 #define PROXIMITY18_PS_CONF2_PS_INT_MASK 0x0300
115 #define PROXIMITY18_PS_CONF2_MASK 0xFF00
116 #define PROXIMITY18_PS_CONF1_PS_DUTY_1_OF_40 0x0000
117 #define PROXIMITY18_PS_CONF1_PS_DUTY_1_OF_80 0x0040
118 #define PROXIMITY18_PS_CONF1_PS_DUTY_1_OF_160 0x0080
119 #define PROXIMITY18_PS_CONF1_PS_DUTY_1_OF_320 0x00C0
120 #define PROXIMITY18_PS_CONF1_PS_DUTY_MASK 0x00C0
121 #define PROXIMITY18_PS_CONF1_PS_PERS_1 0x0000
122 #define PROXIMITY18_PS_CONF1_PS_PERS_2 0x0010
123 #define PROXIMITY18_PS_CONF1_PS_PERS_3 0x0020
124 #define PROXIMITY18_PS_CONF1_PS_PERS_4 0x0030
125 #define PROXIMITY18_PS_CONF1_PS_PERS_MASK 0x0030
126 #define PROXIMITY18_PS_CONF1_PS_IT_1T 0x0000
127 #define PROXIMITY18_PS_CONF1_PS_IT_1p5T 0x0002
128 #define PROXIMITY18_PS_CONF1_PS_IT_2T 0x0004
129 #define PROXIMITY18_PS_CONF1_PS_IT_2p5T 0x0006
130 #define PROXIMITY18_PS_CONF1_PS_IT_3T 0x0008
131 #define PROXIMITY18_PS_CONF1_PS_IT_3p5T 0x000A
132 #define PROXIMITY18_PS_CONF1_PS_IT_4T 0x000C
133 #define PROXIMITY18_PS_CONF1_PS_IT_8T 0x000E
134 #define PROXIMITY18_PS_CONF1_PS_IT_MASK 0x000E
135 #define PROXIMITY18_PS_CONF1_PS_SD_POWER_ON 0x0000
136 #define PROXIMITY18_PS_CONF1_PS_SD_SHUT_DOWN 0x0001
137 #define PROXIMITY18_PS_CONF1_PS_SD_MASK 0x0001
138 #define PROXIMITY18_PS_CONF1_MASK 0x00FF
139 
144 #define PROXIMITY18_PS_MS_PS_SC_CUR_1X 0x0000
145 #define PROXIMITY18_PS_MS_PS_SC_CUR_2X 0x2000
146 #define PROXIMITY18_PS_MS_PS_SC_CUR_4X 0x4000
147 #define PROXIMITY18_PS_MS_PS_SC_CUR_8X 0x6000
148 #define PROXIMITY18_PS_MS_PS_SC_CUR_MASK 0x6000
149 #define PROXIMITY18_PS_MS_PS_SP_1X_CAP 0x0000
150 #define PROXIMITY18_PS_MS_PS_SP_1p5X_CAP 0x1000
151 #define PROXIMITY18_PS_MS_PS_SP_MASK 0x1000
152 #define PROXIMITY18_PS_MS_PS_SPO_00H 0x0000
153 #define PROXIMITY18_PS_MS_PS_SPO_FFH 0x0800
154 #define PROXIMITY18_PS_MS_PS_SPO_MASK 0x0800
155 #define PROXIMITY18_PS_MS_LED_I_50mA 0x0000
156 #define PROXIMITY18_PS_MS_LED_I_75mA 0x0100
157 #define PROXIMITY18_PS_MS_LED_I_100mA 0x0200
158 #define PROXIMITY18_PS_MS_LED_I_120mA 0x0300
159 #define PROXIMITY18_PS_MS_LED_I_140mA 0x0400
160 #define PROXIMITY18_PS_MS_LED_I_160mA 0x0500
161 #define PROXIMITY18_PS_MS_LED_I_180mA 0x0600
162 #define PROXIMITY18_PS_MS_LED_I_200mA 0x0700
163 #define PROXIMITY18_PS_MS_LED_I_MASK 0x0700
164 #define PROXIMITY18_PS_MS_MASK 0xFF00
165 #define PROXIMITY18_PS_CONF3_LED_I_LOW_DIS 0x0000
166 #define PROXIMITY18_PS_CONF3_LED_I_LOW_EN 0x0080
167 #define PROXIMITY18_PS_CONF3_LED_I_LOW_MASK 0x0080
168 #define PROXIMITY18_PS_CONF3_IRED_SELECT_IRED1 0x0000
169 #define PROXIMITY18_PS_CONF3_IRED_SELECT_IRED2 0x0020
170 #define PROXIMITY18_PS_CONF3_IRED_SELECT_IRED3 0x0040
171 #define PROXIMITY18_PS_CONF3_IRED_SELECT_MASK 0x0060
172 #define PROXIMITY18_PS_CONF3_PS_SMART_PERS_DIS 0x0000
173 #define PROXIMITY18_PS_CONF3_PS_SMART_PERS_EN 0x0010
174 #define PROXIMITY18_PS_CONF3_PS_SMART_PERS_MASK 0x0010
175 #define PROXIMITY18_PS_CONF3_PS_AF_DIS 0x0000
176 #define PROXIMITY18_PS_CONF3_PS_AF_EN 0x0008
177 #define PROXIMITY18_PS_CONF3_PS_AF_MASK 0x0008
178 #define PROXIMITY18_PS_CONF3_PS_TRIG_NO_TRIG 0x0000
179 #define PROXIMITY18_PS_CONF3_PS_TRIG_ONE_TIME 0x0004
180 #define PROXIMITY18_PS_CONF3_PS_TRIG_MASK 0x0004
181 #define PROXIMITY18_PS_CONF3_PS_MS_NORMAL 0x0000
182 #define PROXIMITY18_PS_CONF3_PS_MS_DET_LOGIC 0x0002
183 #define PROXIMITY18_PS_CONF3_PS_MS_MASK 0x0002
184 #define PROXIMITY18_PS_CONF3_PS_SC_EN_TURN_OFF 0x0000
185 #define PROXIMITY18_PS_CONF3_PS_SC_EN_TURN_ON 0x0001
186 #define PROXIMITY18_PS_CONF3_PS_SC_EN_MASK 0x0001
187 #define PROXIMITY18_PS_CONF3_MASK 0x00FF
188 
193 #define PROXIMITY18_INT_FLAG_MPX_DATA_READY 0x8000
194 #define PROXIMITY18_INT_FLAG_PS_SP 0x4000
195 #define PROXIMITY18_INT_FLAG_PS_IF_CLOSE 0x0200
196 #define PROXIMITY18_INT_FLAG_PS_IF_AWAY 0x0100
197 #define PROXIMITY18_INT_FLAG_MASK 0xFF00
198 
203 #define PROXIMITY18_DEVICE_ID 0x80
204 #define PROXIMITY18_DEVICE_ID_MASK 0xFF
205 
210 #define PROXIMITY18_DATA_READY_TIMEOUT_MS 5000
211 
217 #define PROXIMITY18_DEVICE_ADDRESS 0x41
218  // proximity18_set
220 
235 #define PROXIMITY18_MAP_MIKROBUS( cfg, mikrobus ) \
236  cfg.scl = MIKROBUS( mikrobus, MIKROBUS_SCL ); \
237  cfg.sda = MIKROBUS( mikrobus, MIKROBUS_SDA ); \
238  cfg.int_pin = MIKROBUS( mikrobus, MIKROBUS_INT )
239  // proximity18_map // proximity18
242 
247 typedef struct
248 {
249  // Input pins
250  digital_in_t int_pin;
252  // Modules
253  i2c_master_t i2c;
255  // I2C slave address
256  uint8_t slave_address;
258 } proximity18_t;
259 
264 typedef struct
265 {
266  pin_name_t scl;
267  pin_name_t sda;
269  pin_name_t int_pin;
271  uint32_t i2c_speed;
272  uint8_t i2c_address;
275 
280 typedef enum
281 {
283  PROXIMITY18_ERROR = -1
284 
286 
303 
318 
332 
345 err_t proximity18_write_register ( proximity18_t *ctx, uint8_t reg, uint16_t data_in );
346 
359 err_t proximity18_read_register ( proximity18_t *ctx, uint8_t reg, uint16_t *data_out );
360 
372 
382 
395 
407 
421 err_t proximity18_read_proximity ( proximity18_t *ctx, uint16_t *ps1_data, uint16_t *ps2_data, uint16_t *ps3_data );
422 
423 #ifdef __cplusplus
424 }
425 #endif
426 #endif // PROXIMITY18_H
427  // proximity18
429 
430 // ------------------------------------------------------------------------ END
proximity18_wait_for_data_ready
err_t proximity18_wait_for_data_ready(proximity18_t *ctx)
Proximity 18 wait for data ready function.
proximity18_t::int_pin
digital_in_t int_pin
Definition: proximity18.h:250
proximity18_read_register
err_t proximity18_read_register(proximity18_t *ctx, uint8_t reg, uint16_t *data_out)
Proximity 18 read register function.
proximity18_check_communication
err_t proximity18_check_communication(proximity18_t *ctx)
Proximity 18 check communication function.
proximity18_return_value_t
proximity18_return_value_t
Proximity 18 Click return value data.
Definition: proximity18.h:281
proximity18_cfg_t
Proximity 18 Click configuration object.
Definition: proximity18.h:265
PROXIMITY18_ERROR
@ PROXIMITY18_ERROR
Definition: proximity18.h:283
PROXIMITY18_OK
@ PROXIMITY18_OK
Definition: proximity18.h:282
proximity18_start_measurement
err_t proximity18_start_measurement(proximity18_t *ctx)
Proximity 18 start measurement function.
proximity18_t
Proximity 18 Click context object.
Definition: proximity18.h:248
proximity18_t::i2c
i2c_master_t i2c
Definition: proximity18.h:253
proximity18_cfg_t::sda
pin_name_t sda
Definition: proximity18.h:267
proximity18_cfg_t::scl
pin_name_t scl
Definition: proximity18.h:266
proximity18_cfg_t::i2c_speed
uint32_t i2c_speed
Definition: proximity18.h:271
proximity18_cfg_t::i2c_address
uint8_t i2c_address
Definition: proximity18.h:272
proximity18_write_register
err_t proximity18_write_register(proximity18_t *ctx, uint8_t reg, uint16_t data_in)
Proximity 18 write register function.
proximity18_read_proximity
err_t proximity18_read_proximity(proximity18_t *ctx, uint16_t *ps1_data, uint16_t *ps2_data, uint16_t *ps3_data)
Proximity 18 read proximity function.
proximity18_cfg_t::int_pin
pin_name_t int_pin
Definition: proximity18.h:269
proximity18_get_int_pin
uint8_t proximity18_get_int_pin(proximity18_t *ctx)
Proximity 18 get int pin function.
proximity18_init
err_t proximity18_init(proximity18_t *ctx, proximity18_cfg_t *cfg)
Proximity 18 initialization function.
proximity18_cfg_setup
void proximity18_cfg_setup(proximity18_cfg_t *cfg)
Proximity 18 configuration object setup function.
proximity18_default_cfg
err_t proximity18_default_cfg(proximity18_t *ctx)
Proximity 18 default configuration function.
proximity18_t::slave_address
uint8_t slave_address
Definition: proximity18.h:256