vl53l1_api_debug.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_DEBUG_H_
70 #define _VL53L1_API_DEBUG_H_
71 
72 #include "vl53l1_platform.h"
73 
74 #ifdef __cplusplus
75 extern "C" {
76 #endif
77 
78 
79 
80 /* Start Patch_AdditionalDebugData_11823 */
81 
94  VL53L1_DEV Dev,
96 
97 /* End Patch_AdditionalDebugData_11823 */
98 
99 
100 #ifdef VL53L1_LOG_ENABLE
101 
112 void VL53L1_signed_fixed_point_sprintf(
113  int32_t fp_value,
114  uint8_t frac_bits,
115  uint16_t buf_size,
116  char *pbuffer);
117 
118 
127 void VL53L1_print_static_nvm_managed(
129  char *pprefix,
130  uint32_t trace_flags);
131 
132 
141 void VL53L1_print_customer_nvm_managed(
143  char *pprefix,
144  uint32_t trace_flags);
145 
146 
155 void VL53L1_print_nvm_copy_data(
156  VL53L1_nvm_copy_data_t *pdata,
157  char *pprefix,
158  uint32_t trace_flags);
159 
160 
170 void VL53L1_print_range_results(
171  VL53L1_range_results_t *pdata,
172  char *pprefix,
173  uint32_t trace_flags);
174 
184 void VL53L1_print_range_data(
185  VL53L1_range_data_t *pdata,
186  char *pprefix,
187  uint32_t trace_flags);
188 
198 void VL53L1_print_offset_range_results(
200  char *pprefix,
201  uint32_t trace_flags);
202 
212 void VL53L1_print_offset_range_data(
214  char *pprefix,
215  uint32_t trace_flags);
216 
217 
227 void VL53L1_print_cal_peak_rate_map(
229  char *pprefix,
230  uint32_t trace_flags);
231 
232 
242 void VL53L1_print_additional_offset_cal_data(
244  char *pprefix,
245  uint32_t trace_flags);
246 
256 void VL53L1_print_additional_data(
258  char *pprefix,
259  uint32_t trace_flags);
260 
261 
271 void VL53L1_print_gain_calibration_data(
273  char *pprefix,
274  uint32_t trace_flags);
275 
276 
286 void VL53L1_print_xtalk_config(
287  VL53L1_xtalk_config_t *pdata,
288  char *pprefix,
289  uint32_t trace_flags);
290 
300 void VL53L1_print_optical_centre(
302  char *pprefix,
303  uint32_t trace_flags);
304 
305 
315 void VL53L1_print_user_zone(
316  VL53L1_user_zone_t *pdata,
317  char *pprefix,
318  uint32_t trace_flags);
319 
328 void VL53L1_print_spad_rate_data(
329  VL53L1_spad_rate_data_t *pspad_rates,
330  char *pprefix,
331  uint32_t trace_flags);
332 
333 
342 void VL53L1_print_spad_rate_map(
343  VL53L1_spad_rate_data_t *pspad_rates,
344  char *pprefix,
345  uint32_t trace_flags);
346 
347 
348 #endif /* VL53L1_LOG_ENABLE */
349 
350 #ifdef __cplusplus
351 }
352 #endif
353 
354 #endif /* _VL53L1_API_DEBUG_H_ */
VL53L1_user_zone_t
Defines User Zone(ROI) parameters.
Definition: vl53l1_ll_def.h:413
uint32_t
unsigned int uint32_t
Typedef defining 32 bit unsigned int type. The developer should modify this to suit the platform bein...
Definition: vl53l1_types.h:113
uint8_t
unsigned char uint8_t
Typedef defining 8 bit unsigned char type. The developer should modify this to suit the platform bein...
Definition: vl53l1_types.h:133
VL53L1_additional_offset_cal_data_t
Additional Offset Calibration Data.
Definition: vl53l1_ll_def.h:692
VL53L1_range_data_t
Internal data structure for storing post processed ranges.
Definition: vl53l1_ll_def.h:523
VL53L1_offset_range_results_t
Structure for storing the set of range results required for the offset calibration functions.
Definition: vl53l1_ll_def.h:665
VL53L1_spad_rate_data_t
SPAD Rate Data output by SSC.
Definition: vl53l1_ll_def.h:1019
VL53L1_cal_peak_rate_map_t
Structure for storing the calibration peak rate map Used by DMAX to understand the spatial roll off i...
Definition: vl53l1_ll_def.h:714
VL53L1_customer_nvm_managed_t
Definition: vl53l1_register_structs.h:243
VL53L1_Dev_t
Definition: vl53l1_platform_user_data.h:78
VL53L1_offset_range_data_t
Structure for storing the set of range results required for the mm1 and mm2 offset calibration functi...
Definition: vl53l1_ll_def.h:633
VL53L1_range_results_t
Structure for storing the set of range results.
Definition: vl53l1_ll_def.h:608
VL53L1_get_additional_data
VL53L1_Error VL53L1_get_additional_data(VL53L1_DEV Dev, VL53L1_additional_data_t *pdata)
Gets the current LL Driver configuration parameters and the last set of histogram data for debug.
Definition: vl53l1_api_debug.c:89
int32_t
int int32_t
Typedef defining 32 bit int type. The developer should modify this to suit the platform being deploye...
Definition: vl53l1_types.h:118
VL53L1_xtalk_config_t
Xtalk Extraction and Paramter Config.
Definition: vl53l1_ll_def.h:212
VL53L1_additional_data_t
Additional debug data.
Definition: vl53l1_ll_def.h:1046
vl53l1_platform.h
VL53L1_optical_centre_t
Optical Centre data.
Definition: vl53l1_ll_def.h:401
VL53L1_nvm_copy_data_t
Definition: vl53l1_register_structs.h:2208
VL53L1_Error
int8_t VL53L1_Error
Definition: vl53l1_error_codes.h:89
VL53L1_gain_calibration_data_t
Gain calibration data.
Definition: vl53l1_ll_def.h:737
uint16_t
unsigned short uint16_t
Typedef defining 16 bit unsigned short type. The developer should modify this to suit the platform be...
Definition: vl53l1_types.h:123
VL53L1_static_nvm_managed_t
Definition: vl53l1_register_structs.h:128


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