vl53l1_xtalk.h

00001 
00002 /*******************************************************************************
00003  This file is part of VL53L1 Protected
00004 
00005  Copyright (c) 2020, STMicroelectronics - All Rights Reserved
00006 
00007  License terms: STMicroelectronics Proprietary in accordance with licensing
00008  terms at www.st.com/sla0081
00009 
00010  STMicroelectronics confidential
00011  Reproduction and Communication of this document is strictly prohibited unless
00012  specifically authorized in writing by STMicroelectronics.
00013 
00014 */
00015 
00016 
00017 
00018 
00019 
00020 
00021 
00022 #ifndef _VL53L1_XTALK_H_
00023 #define _VL53L1_XTALK_H_
00024 
00025 #include "vl53l1_types.h"
00026 #include "vl53l1_ll_def.h"
00027 #include "vl53l1_xtalk_private_structs.h"
00028 
00029 #ifdef __cplusplus
00030 extern "C" {
00031 #endif
00032 
00033 
00034 
00035 
00036 VL53L1_Error VL53L1_xtalk_calibration_process_data(
00037     VL53L1_xtalk_range_results_t        *pxtalk_ranges,
00038     VL53L1_xtalk_histogram_data_t       *pxtalk_shape,
00039     VL53L1_xtalk_calibration_results_t  *pxtalk_cal);
00040 
00041 
00042 
00043 
00044 VL53L1_Error VL53L1_f_049(
00045         VL53L1_histogram_bin_data_t        *pavg_bins,
00046         VL53L1_xtalk_algo_data_t           *pdebug,
00047         VL53L1_xtalk_range_data_t          *pxtalk_data,
00048         uint8_t                             histogram__window_start,
00049         uint8_t                             histogram__window_end,
00050         VL53L1_xtalk_histogram_shape_t     *pxtalk_shape);
00051 
00052 
00053 
00054 VL53L1_Error VL53L1_f_047(
00055     VL53L1_xtalk_range_results_t  *pxtalk_results,
00056     VL53L1_xtalk_algo_data_t      *pdebug,
00057     int16_t                       *xgradient,
00058     int16_t                       *ygradient);
00059 
00060 
00061 
00062 
00063 VL53L1_Error VL53L1_f_048(
00064     VL53L1_xtalk_range_data_t *pxtalk_data,
00065     VL53L1_xtalk_algo_data_t  *pdebug,
00066     uint32_t                  *xtalk_mean_offset_kcps);
00067 
00068 
00069 
00070 
00071 VL53L1_Error VL53L1_f_053(
00072     VL53L1_histogram_bin_data_t    *phist_data,
00073     VL53L1_xtalk_range_data_t      *pxtalk_data,
00074     VL53L1_xtalk_algo_data_t       *pdebug,
00075     VL53L1_xtalk_histogram_shape_t *pxtalk_histo);
00076 
00077 
00078 
00079 
00080 
00081 VL53L1_Error VL53L1_f_040(
00082     uint32_t                       mean_offset,
00083     int16_t                        xgradient,
00084     int16_t                        ygradient,
00085     int8_t                         centre_offset_x,
00086     int8_t                         centre_offset_y,
00087     uint16_t                       roi_effective_spads,
00088     uint8_t                        roi_centre_spad,
00089     uint8_t                        roi_xy_size,
00090     uint32_t                      *xtalk_rate_kcps);
00091 
00092 
00093 
00094 
00095 VL53L1_Error VL53L1_f_041(
00096     VL53L1_histogram_bin_data_t    *phist_data,
00097     VL53L1_xtalk_histogram_shape_t *pxtalk_data,
00098     uint32_t                        xtalk_rate_kcps,
00099     VL53L1_histogram_bin_data_t    *pxtalkcount_data);
00100 
00101 
00102 
00103 
00104 VL53L1_Error VL53L1_f_055(
00105     VL53L1_histogram_bin_data_t   *phist_data,
00106     VL53L1_histogram_bin_data_t   *pxtalk_data,
00107     uint8_t                        xtalk_bin_offset);
00108 
00109 
00110 
00111 VL53L1_Error VL53L1_f_052(
00112     VL53L1_histogram_bin_data_t       *pxtalk_data,
00113     uint32_t                           amb_threshold,
00114     uint8_t                            VL53L1_p_022,
00115     uint8_t                            VL53L1_p_026);
00116 
00117 
00118 
00119 VL53L1_Error VL53L1_f_054(
00120     VL53L1_customer_nvm_managed_t *pcustomer,
00121     VL53L1_dynamic_config_t       *pdyn_cfg,
00122     VL53L1_xtalk_histogram_data_t *pxtalk_shape,
00123     VL53L1_histogram_bin_data_t   *pip_hist_data,
00124     VL53L1_histogram_bin_data_t   *pop_hist_data,
00125     VL53L1_histogram_bin_data_t   *pxtalk_count_data);
00126 
00127 
00128 
00129 
00130 VL53L1_Error VL53L1_f_051(
00131         uint8_t                      sigma_mult,
00132         int32_t                      VL53L1_p_004,
00133         uint32_t                    *ambient_noise);
00134 
00135 
00136 
00137 VL53L1_Error VL53L1_generate_dual_reflectance_xtalk_samples(
00138     VL53L1_xtalk_range_results_t *pxtalk_results,
00139     uint16_t                      expected_target_distance_mm,
00140     uint8_t                       higher_reflectance,
00141     VL53L1_histogram_bin_data_t  *pxtalk_avg_samples
00142 );
00143 
00144 
00145 
00146 
00147 
00148 VL53L1_Error VL53L1_f_050(
00149         VL53L1_histogram_bin_data_t     *pzone_avg_1,
00150         VL53L1_histogram_bin_data_t     *pzone_avg_2,
00151         uint16_t                             expected_target_distance,
00152         uint8_t                              subtract_amb,
00153         uint8_t                              higher_reflectance,
00154         VL53L1_histogram_bin_data_t         *pxtalk_output
00155 );
00156 
00157 #ifdef __cplusplus
00158 }
00159 #endif
00160 
00161 #endif
00162 
00163