76 lines
2.8 KiB
C
76 lines
2.8 KiB
C
/**
|
|
******************************************************************************
|
|
* Copyright (c) 2020, STMicroelectronics - All Rights Reserved
|
|
*
|
|
* This software is licensed under terms that can be found in the LICENSE file
|
|
* in the root directory of this software component.
|
|
* If no LICENSE file comes with this software, it is provided AS-IS.
|
|
*
|
|
******************************************************************************
|
|
*/
|
|
|
|
#ifndef _VL53LX_PRESET_SETUP_H_
|
|
#define _VL53LX_PRESET_SETUP_H_
|
|
|
|
#ifdef __cplusplus
|
|
extern "C"
|
|
{
|
|
#endif
|
|
|
|
/* indexes for the bare driver tuning setting API function */
|
|
enum VL53LX_Tuning_t {
|
|
VL53LX_TUNING_VERSION = 0,
|
|
VL53LX_TUNING_PROXY_MIN,
|
|
VL53LX_TUNING_SINGLE_TARGET_XTALK_TARGET_DISTANCE_MM,
|
|
VL53LX_TUNING_SINGLE_TARGET_XTALK_SAMPLE_NUMBER,
|
|
VL53LX_TUNING_MIN_AMBIENT_DMAX_VALID,
|
|
VL53LX_TUNING_MAX_SIMPLE_OFFSET_CALIBRATION_SAMPLE_NUMBER,
|
|
VL53LX_TUNING_XTALK_FULL_ROI_TARGET_DISTANCE_MM,
|
|
VL53LX_TUNING_SIMPLE_OFFSET_CALIBRATION_REPEAT,
|
|
VL53LX_TUNING_XTALK_FULL_ROI_BIN_SUM_MARGIN,
|
|
VL53LX_TUNING_XTALK_FULL_ROI_DEFAULT_OFFSET,
|
|
VL53LX_TUNING_ZERO_DISTANCE_OFFSET_NON_LINEAR_FACTOR,
|
|
VL53LX_TUNING_MAX_TUNABLE_KEY
|
|
};
|
|
|
|
/* default values for the tuning settings parameters */
|
|
#define TUNING_VERSION 0x0007
|
|
|
|
#define TUNING_PROXY_MIN -30 /* min distance in mm */
|
|
#define TUNING_SINGLE_TARGET_XTALK_TARGET_DISTANCE_MM 600
|
|
/* Target distance in mm for single target Xtalk */
|
|
#define TUNING_SINGLE_TARGET_XTALK_SAMPLE_NUMBER 50
|
|
/* Number of sample used for single target Xtalk */
|
|
#define TUNING_MIN_AMBIENT_DMAX_VALID 8
|
|
/* Minimum ambient level to state the Dmax returned by the device is valid */
|
|
#ifdef SMALL_FOOTPRINT
|
|
#define TUNING_MAX_SIMPLE_OFFSET_CALIBRATION_SAMPLE_NUMBER 50
|
|
#else
|
|
#define TUNING_MAX_SIMPLE_OFFSET_CALIBRATION_SAMPLE_NUMBER 10
|
|
#endif
|
|
/* Maximum loops to perform simple offset calibration */
|
|
#define TUNING_XTALK_FULL_ROI_TARGET_DISTANCE_MM 600
|
|
/* Target distance in mm for target Xtalk from Bins method*/
|
|
#ifdef SMALL_FOOTPRINT
|
|
#define TUNING_SIMPLE_OFFSET_CALIBRATION_REPEAT 1
|
|
#else
|
|
#define TUNING_SIMPLE_OFFSET_CALIBRATION_REPEAT 3
|
|
#endif
|
|
/* Number of loops done during the simple offset calibration*/
|
|
#define TUNING_ZERO_DISTANCE_OFFSET_NON_LINEAR_FACTOR_DEFAULT 9
|
|
/* zero distance offset calibration non linear compensation default value */
|
|
|
|
/* The following settings are related to the fix for ticket EwokP #558410 */
|
|
#define TUNING_XTALK_FULL_ROI_BIN_SUM_MARGIN 24
|
|
/* Acceptance margin for the xtalk_shape bin_data sum computation */
|
|
#define TUNING_XTALK_FULL_ROI_DEFAULT_OFFSET 50
|
|
/* Recovery value for Xtalk compensation plane offset in kcps */
|
|
/* 50 stands for ~0.10 kcps cover glass in 7.9 format */
|
|
/* End of settings related to the fix for ticket EwokP #558410 */
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* _VL53LX_PRESET_SETUP_H_ */
|