vl53l1_api_preset_modes.h
Go to the documentation of this file.
1 /*
2 * Copyright (c) 2017, STMicroelectronics - All Rights Reserved
3 *
4 * This file is part of VL53L1 Core and is dual licensed,
5 * either 'STMicroelectronics
6 * Proprietary license'
7 * or 'BSD 3-clause "New" or "Revised" License' , at your option.
8 *
9 ********************************************************************************
10 *
11 * 'STMicroelectronics Proprietary license'
12 *
13 ********************************************************************************
14 *
15 * License terms: STMicroelectronics Proprietary in accordance with licensing
16 * terms at www.st.com/sla0081
17 *
18 * STMicroelectronics confidential
19 * Reproduction and Communication of this document is strictly prohibited unless
20 * specifically authorized in writing by STMicroelectronics.
21 *
22 *
23 ********************************************************************************
24 *
25 * Alternatively, VL53L1 Core may be distributed under the terms of
26 * 'BSD 3-clause "New" or "Revised" License', in which case the following
27 * provisions apply instead of the ones mentioned above :
28 *
29 ********************************************************************************
30 *
31 * License terms: BSD 3-clause "New" or "Revised" License.
32 *
33 * Redistribution and use in source and binary forms, with or without
34 * modification, are permitted provided that the following conditions are met:
35 *
36 * 1. Redistributions of source code must retain the above copyright notice, this
37 * list of conditions and the following disclaimer.
38 *
39 * 2. Redistributions in binary form must reproduce the above copyright notice,
40 * this list of conditions and the following disclaimer in the documentation
41 * and/or other materials provided with the distribution.
42 *
43 * 3. Neither the name of the copyright holder nor the names of its contributors
44 * may be used to endorse or promote products derived from this software
45 * without specific prior written permission.
46 *
47 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
48 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
49 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
50 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
51 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
52 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
53 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
54 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
55 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
56 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
57 *
58 *
59 ********************************************************************************
60 *
61 */
62 
69 #ifndef _VL53L1_API_PRESET_MODES_H_
70 #define _VL53L1_API_PRESET_MODES_H_
71 
72 #include "vl53l1_ll_def.h"
73 
74 #ifdef __cplusplus
75 extern "C" {
76 #endif
77 
78 
88 #ifndef VL53L1_NOCALIB
91 #endif
92 
93 
104  VL53L1_ssc_config_t *pdata);
105 
118  VL53L1_xtalk_config_t *pdata);
119 
129 #ifndef VL53L1_NOCALIB
132 #endif
133 
134 
146 
163  VL53L1_static_config_t *pstatic,
164  VL53L1_general_config_t *pgeneral,
165  VL53L1_timing_config_t *ptiming,
166  VL53L1_dynamic_config_t *pdynamic,
167  VL53L1_system_control_t *psystem,
168  VL53L1_tuning_parm_storage_t *ptuning_parms);
169 
186  VL53L1_static_config_t *pstatic,
187  VL53L1_general_config_t *pgeneral,
188  VL53L1_timing_config_t *ptiming,
189  VL53L1_dynamic_config_t *pdynamic,
190  VL53L1_system_control_t *psystem,
191  VL53L1_tuning_parm_storage_t *ptuning_parms);
192 
193 
210  VL53L1_static_config_t *pstatic,
211  VL53L1_general_config_t *pgeneral,
212  VL53L1_timing_config_t *ptiming,
213  VL53L1_dynamic_config_t *pdynamic,
214  VL53L1_system_control_t *psystem,
215  VL53L1_tuning_parm_storage_t *ptuning_parms);
216 
232 #ifndef VL53L1_NOCALIB
234  VL53L1_static_config_t *pstatic,
235  VL53L1_general_config_t *pgeneral,
236  VL53L1_timing_config_t *ptiming,
237  VL53L1_dynamic_config_t *pdynamic,
238  VL53L1_system_control_t *psystem,
239  VL53L1_tuning_parm_storage_t *ptuning_parms);
240 #endif
241 
242 
258 #ifndef VL53L1_NOCALIB
260  VL53L1_static_config_t *pstatic,
261  VL53L1_general_config_t *pgeneral,
262  VL53L1_timing_config_t *ptiming,
263  VL53L1_dynamic_config_t *pdynamic,
264  VL53L1_system_control_t *psystem,
265  VL53L1_tuning_parm_storage_t *ptuning_parms);
266 #endif
267 
268 
285 
286  VL53L1_static_config_t *pstatic,
287  VL53L1_general_config_t *pgeneral,
288  VL53L1_timing_config_t *ptiming,
289  VL53L1_dynamic_config_t *pdynamic,
290  VL53L1_system_control_t *psystem,
291  VL53L1_tuning_parm_storage_t *ptuning_parms);
292 
309 
310  VL53L1_static_config_t *pstatic,
311  VL53L1_general_config_t *pgeneral,
312  VL53L1_timing_config_t *ptiming,
313  VL53L1_dynamic_config_t *pdynamic,
314  VL53L1_system_control_t *psystem,
315  VL53L1_tuning_parm_storage_t *ptuning_parms);
316 
333 
334  VL53L1_static_config_t *pstatic,
335  VL53L1_general_config_t *pgeneral,
336  VL53L1_timing_config_t *ptiming,
337  VL53L1_dynamic_config_t *pdynamic,
338  VL53L1_system_control_t *psystem,
339  VL53L1_tuning_parm_storage_t *ptuning_parms);
340 
358 
359  VL53L1_static_config_t *pstatic,
360  VL53L1_general_config_t *pgeneral,
361  VL53L1_timing_config_t *ptiming,
362  VL53L1_dynamic_config_t *pdynamic,
363  VL53L1_system_control_t *psystem,
364  VL53L1_tuning_parm_storage_t *ptuning_parms,
365  VL53L1_low_power_auto_data_t *plpadata);
366 
384 
385  VL53L1_static_config_t *pstatic,
386  VL53L1_general_config_t *pgeneral,
387  VL53L1_timing_config_t *ptiming,
388  VL53L1_dynamic_config_t *pdynamic,
389  VL53L1_system_control_t *psystem,
390  VL53L1_tuning_parm_storage_t *ptuning_parms,
391  VL53L1_low_power_auto_data_t *plpadata);
392 
410 
411  VL53L1_static_config_t *pstatic,
412  VL53L1_general_config_t *pgeneral,
413  VL53L1_timing_config_t *ptiming,
414  VL53L1_dynamic_config_t *pdynamic,
415  VL53L1_system_control_t *psystem,
416  VL53L1_tuning_parm_storage_t *ptuning_parms,
417  VL53L1_low_power_auto_data_t *plpadata);
418 
419 
436  VL53L1_static_config_t *pstatic,
437  VL53L1_general_config_t *pgeneral,
438  VL53L1_timing_config_t *ptiming,
439  VL53L1_dynamic_config_t *pdynamic,
440  VL53L1_system_control_t *psystem,
441  VL53L1_tuning_parm_storage_t *ptuning_parms);
442 
459 
460  VL53L1_static_config_t *pstatic,
461  VL53L1_general_config_t *pgeneral,
462  VL53L1_timing_config_t *ptiming,
463  VL53L1_dynamic_config_t *pdynamic,
464  VL53L1_system_control_t *psystem,
465  VL53L1_tuning_parm_storage_t *ptuning_parms);
466 
467 #ifdef __cplusplus
468 }
469 #endif
470 
471 #endif /* _VL53L1_API_CORE_H_ */
VL53L1_timing_config_t
Definition: vl53l1_register_structs.h:932
VL53L1_low_power_auto_data_t
Structure to hold state, tuning and output variables for the low power auto mode (Presence)
Definition: vl53l1_ll_def.h:480
vl53l1_ll_def.h
Type definitions for VL53L1 LL Driver.
VL53L1_init_refspadchar_config_struct
VL53L1_Error VL53L1_init_refspadchar_config_struct(VL53L1_refspadchar_config_t *pdata)
Initializes Ref SPAD Char Configuration Parameters.
Definition: vl53l1_api_preset_modes.c:87
VL53L1_tuning_parm_storage_t
TuningParameter Storage.
Definition: vl53l1_ll_def.h:254
VL53L1_preset_mode_standard_ranging_mm2_cal
VL53L1_Error VL53L1_preset_mode_standard_ranging_mm2_cal(VL53L1_static_config_t *pstatic, VL53L1_general_config_t *pgeneral, VL53L1_timing_config_t *ptiming, VL53L1_dynamic_config_t *pdynamic, VL53L1_system_control_t *psystem, VL53L1_tuning_parm_storage_t *ptuning_parms)
Initializes static and dynamic configuration settings for preset mode VL53L1_DEVICEPRESETMODE_STANDAR...
Definition: vl53l1_api_preset_modes.c:862
VL53L1_general_config_t
Definition: vl53l1_register_structs.h:743
VL53L1_preset_mode_low_power_auto_long_ranging
VL53L1_Error VL53L1_preset_mode_low_power_auto_long_ranging(VL53L1_static_config_t *pstatic, VL53L1_general_config_t *pgeneral, VL53L1_timing_config_t *ptiming, VL53L1_dynamic_config_t *pdynamic, VL53L1_system_control_t *psystem, VL53L1_tuning_parm_storage_t *ptuning_parms, VL53L1_low_power_auto_data_t *plpadata)
Initializes static and dynamic configuration settings for preset mode VL53L1_DEVICEPRESETMODE_LOWPOWE...
Definition: vl53l1_api_preset_modes.c:1242
VL53L1_preset_mode_olt
VL53L1_Error VL53L1_preset_mode_olt(VL53L1_static_config_t *pstatic, VL53L1_general_config_t *pgeneral, VL53L1_timing_config_t *ptiming, VL53L1_dynamic_config_t *pdynamic, VL53L1_system_control_t *psystem, VL53L1_tuning_parm_storage_t *ptuning_parms)
Initializes static and dynamic configuration settings for preset mode VL53L1_DEVICEPRESETMODE_OLT.
Definition: vl53l1_api_preset_modes.c:1367
VL53L1_ssc_config_t
SPAD Self Check (SSC) Config data structure.
Definition: vl53l1_ll_def.h:187
VL53L1_preset_mode_low_power_auto_ranging
VL53L1_Error VL53L1_preset_mode_low_power_auto_ranging(VL53L1_static_config_t *pstatic, VL53L1_general_config_t *pgeneral, VL53L1_timing_config_t *ptiming, VL53L1_dynamic_config_t *pdynamic, VL53L1_system_control_t *psystem, VL53L1_tuning_parm_storage_t *ptuning_parms, VL53L1_low_power_auto_data_t *plpadata)
Initializes static and dynamic configuration settings for preset mode VL53L1_DEVICEPRESETMODE_LOWPOWE...
Definition: vl53l1_api_preset_modes.c:1136
VL53L1_customer_nvm_managed_t
Definition: vl53l1_register_structs.h:243
VL53L1_preset_mode_timed_ranging
VL53L1_Error VL53L1_preset_mode_timed_ranging(VL53L1_static_config_t *pstatic, VL53L1_general_config_t *pgeneral, VL53L1_timing_config_t *ptiming, VL53L1_dynamic_config_t *pdynamic, VL53L1_system_control_t *psystem, VL53L1_tuning_parm_storage_t *ptuning_parms)
Initializes static and dynamic configuration settings for preset mode VL53L1_DEVICEPRESETMODE_TIMED_R...
Definition: vl53l1_api_preset_modes.c:917
VL53L1_dynamic_config_t
Definition: vl53l1_register_structs.h:1105
VL53L1_preset_mode_standard_ranging_short_range
VL53L1_Error VL53L1_preset_mode_standard_ranging_short_range(VL53L1_static_config_t *pstatic, VL53L1_general_config_t *pgeneral, VL53L1_timing_config_t *ptiming, VL53L1_dynamic_config_t *pdynamic, VL53L1_system_control_t *psystem, VL53L1_tuning_parm_storage_t *ptuning_parms)
Initializes static and dynamic configuration settings for preset mode VL53L1_DEVICEPRESETMODE_STANDAR...
Definition: vl53l1_api_preset_modes.c:655
VL53L1_preset_mode_singleshot_ranging
VL53L1_Error VL53L1_preset_mode_singleshot_ranging(VL53L1_static_config_t *pstatic, VL53L1_general_config_t *pgeneral, VL53L1_timing_config_t *ptiming, VL53L1_dynamic_config_t *pdynamic, VL53L1_system_control_t *psystem, VL53L1_tuning_parm_storage_t *ptuning_parms)
Initializes static and dynamic configuration settings for preset mode VL53L1_DEVICEPRESETMODE_SINGLES...
Definition: vl53l1_api_preset_modes.c:1297
VL53L1_preset_mode_standard_ranging
VL53L1_Error VL53L1_preset_mode_standard_ranging(VL53L1_static_config_t *pstatic, VL53L1_general_config_t *pgeneral, VL53L1_timing_config_t *ptiming, VL53L1_dynamic_config_t *pdynamic, VL53L1_system_control_t *psystem, VL53L1_tuning_parm_storage_t *ptuning_parms)
Initializes static and dynamic configuration settings for preset mode VL53L1_DEVICEPRESETMODE_STANDAR...
Definition: vl53l1_api_preset_modes.c:395
VL53L1_static_config_t
Definition: vl53l1_register_structs.h:416
VL53L1_init_ssc_config_struct
VL53L1_Error VL53L1_init_ssc_config_struct(VL53L1_ssc_config_t *pdata)
Initializes SPAD Self Check (SSC) Configuration Parameters.
Definition: vl53l1_api_preset_modes.c:128
VL53L1_init_tuning_parm_storage_struct
VL53L1_Error VL53L1_init_tuning_parm_storage_struct(VL53L1_tuning_parm_storage_t *pdata)
Initializes Tuning Parameter Storage Values.
Definition: vl53l1_api_preset_modes.c:291
VL53L1_preset_mode_standard_ranging_long_range
VL53L1_Error VL53L1_preset_mode_standard_ranging_long_range(VL53L1_static_config_t *pstatic, VL53L1_general_config_t *pgeneral, VL53L1_timing_config_t *ptiming, VL53L1_dynamic_config_t *pdynamic, VL53L1_system_control_t *psystem, VL53L1_tuning_parm_storage_t *ptuning_parms)
Initializes static and dynamic configuration settings for preset mode VL53L1_DEVICEPRESETMODE_STANDAR...
Definition: vl53l1_api_preset_modes.c:731
VL53L1_system_control_t
Definition: vl53l1_register_structs.h:1290
VL53L1_xtalk_config_t
Xtalk Extraction and Paramter Config.
Definition: vl53l1_ll_def.h:212
VL53L1_preset_mode_standard_ranging_mm1_cal
VL53L1_Error VL53L1_preset_mode_standard_ranging_mm1_cal(VL53L1_static_config_t *pstatic, VL53L1_general_config_t *pgeneral, VL53L1_timing_config_t *ptiming, VL53L1_dynamic_config_t *pdynamic, VL53L1_system_control_t *psystem, VL53L1_tuning_parm_storage_t *ptuning_parms)
Initializes static and dynamic configuration settings for preset mode VL53L1_DEVICEPRESETMODE_STANDAR...
Definition: vl53l1_api_preset_modes.c:808
VL53L1_refspadchar_config_t
Reference SPAD Characterization (RefSpadChar) Config.
Definition: vl53l1_ll_def.h:168
VL53L1_init_xtalk_config_struct
VL53L1_Error VL53L1_init_xtalk_config_struct(VL53L1_customer_nvm_managed_t *pnvm, VL53L1_xtalk_config_t *pdata)
Initializes Xtalk Configuration Parameters.
Definition: vl53l1_api_preset_modes.c:174
VL53L1_preset_mode_low_power_auto_short_ranging
VL53L1_Error VL53L1_preset_mode_low_power_auto_short_ranging(VL53L1_static_config_t *pstatic, VL53L1_general_config_t *pgeneral, VL53L1_timing_config_t *ptiming, VL53L1_dynamic_config_t *pdynamic, VL53L1_system_control_t *psystem, VL53L1_tuning_parm_storage_t *ptuning_parms, VL53L1_low_power_auto_data_t *plpadata)
Initializes static and dynamic configuration settings for preset mode VL53L1_DEVICEPRESETMODE_LOWPOWE...
Definition: vl53l1_api_preset_modes.c:1189
VL53L1_preset_mode_timed_ranging_short_range
VL53L1_Error VL53L1_preset_mode_timed_ranging_short_range(VL53L1_static_config_t *pstatic, VL53L1_general_config_t *pgeneral, VL53L1_timing_config_t *ptiming, VL53L1_dynamic_config_t *pdynamic, VL53L1_system_control_t *psystem, VL53L1_tuning_parm_storage_t *ptuning_parms)
Initializes static and dynamic configuration settings for preset mode VL53L1_DEVICEPRESETMODE_TIMED_R...
Definition: vl53l1_api_preset_modes.c:989
VL53L1_offsetcal_config_t
Run Offset Cal Function (offsetcal) Config.
Definition: vl53l1_ll_def.h:778
VL53L1_Error
int8_t VL53L1_Error
Definition: vl53l1_error_codes.h:89
VL53L1_preset_mode_timed_ranging_long_range
VL53L1_Error VL53L1_preset_mode_timed_ranging_long_range(VL53L1_static_config_t *pstatic, VL53L1_general_config_t *pgeneral, VL53L1_timing_config_t *ptiming, VL53L1_dynamic_config_t *pdynamic, VL53L1_system_control_t *psystem, VL53L1_tuning_parm_storage_t *ptuning_parms)
Initializes static and dynamic configuration settings for preset mode VL53L1_DEVICEPRESETMODE_TIMED_R...
Definition: vl53l1_api_preset_modes.c:1062
VL53L1_init_offset_cal_config_struct
VL53L1_Error VL53L1_init_offset_cal_config_struct(VL53L1_offsetcal_config_t *pdata)
Initializes Offset Calibration Configuration Parameters.
Definition: vl53l1_api_preset_modes.c:249


vl53l1x
Author(s):
autogenerated on Fri Aug 2 2024 08:35:54