ST VL53L1X User Manual

ST VL53L1X User Manual

Ultra lite driver multiple zone implementation
Hide thumbs Also See for VL53L1X:

Advertisement

UM2555
User manual
VL53L1X ultra lite driver multiple zone implementation
Introduction
The VL53L1X ultra lite driver (ULD) allows a region of interest (ROI) to be selected. This region is defined by default in the
center of the single photon avalanche diode (SPAD) array, but the center of the ROI can be programmed in other locations of
the SPAD array, as explained in this user manual (see figure below).
Figure 1.
27 ° field of view (FoV) down to 15 °
This user manual explains how to configure the ROI of the VL53L1X with a view to moving the FoV so that each range produces
a distance in a different zone. This can be achieved using the software (SW) driver application programming interface in
conjunction with the instructions given in this document.
UM2555 - Rev 1 - April 2019
www.st.com
For further information contact your local STMicroelectronics sales office.

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the VL53L1X and is the answer not in the manual?

Questions and answers

Summary of Contents for ST VL53L1X

  • Page 1 27 ° field of view (FoV) down to 15 ° This user manual explains how to configure the ROI of the VL53L1X with a view to moving the FoV so that each range produces a distance in a different zone. This can be achieved using the software (SW) driver application programming interface in conjunction with the instructions given in this document.
  • Page 2: Document Scope

    In the figure below, the X length is 6 and the Y is 11. Selection and use of the center SPAD VL53L1X_SetROICenter( C) is the main focus of this user manual. ST delivers a software ultra lite driver referred to as the “driver” in this document. Figure 2.
  • Page 3: Acronyms And Abbreviations

    UM2555 Acronyms and abbreviations Acronyms and abbreviations Table 1. Acronyms and abbreviations Acronym/abbreviation Definition field of view region of interest SPAD single photon avalanche diode software ultra lite driver UM2555 - Rev 1 page 3/12...
  • Page 4: Vl53L1X_Setroicenter()

    UM2555 VL53L1X_SetROICenter() VL53L1X_SetROICenter() The function that sets the center of the ROI is VL53L1X_SetROICenter(). This function is included starting with revision 1.0.3 of the API. For earlier versions, it can be added. It is a very short function. The code is: VL53L1X_ERROR VL53L1X_SetROICenter(VL53L1_Dev_t dev, uint8_t ROICenter) VL53L1X_ERROR status = 0;...
  • Page 5: Spad Details

    UM2555 SPAD details SPAD details SPAD locations The photon detector is made up of a 16 x 16 array of SPADs. Each SPAD is identified by a number as shown in the table below. /* Table of SPAD locations. Each SPAD has a number which is not obvious. * 128,136,144,152,160,168,176,184, 192,200,208,216,224,232,240,248 * 129,137,145,153,161,169,177,185,...
  • Page 6: Roi Details

    UM2555 ROI details ROI details Example ROI The yellow color in the figure below shows the ROI. The center of this region is 223 (see pink text below). This is the exact center of the region in the Y direction and it is a half-SPAD right of the exact center in the X direction (as the X direction contains an even number of SPADs).
  • Page 7: Timing Considerations

    UM2555 Timing considerations Timing considerations There are two basic timing consideration principles: • Each range completes with the parameters it started with, even if that parameter is changed part way through the ranging operation. • Each ranging operation restarts using the timing budget and intermeasurement period currently available without host intervention.
  • Page 8: Example Code

    UM2555 Example code Example code In the example below, the code ranges using one of two regions: the right region centered about ROI 231 and the left region centered about ROI 167. Both regions are 8 SPADs wide by 16 SPADs high. This example can be used as the basis for a system to detect motion to the right or left.
  • Page 9: Calibration Details

    UM2555 Calibration details Calibration details Offset For the best accuracy, each zone must be calibrated separately. The procedure is as follows: • Set the ROI and the ROI center • Call the calibration function VL53L1X_CalibrateOffset() with a target at a known distance After each calibration call the function VL53L1X_GetOffset() and retain the value in an array.
  • Page 10: Revision History

    UM2555 Revision history Table 2. Document revision history Date Version Changes 16-Apr-2019 Initial release UM2555 - Rev 1 page 10/12...
  • Page 11: Table Of Contents

    UM2555 Contents Contents Document scope ..............2 Acronyms and abbreviations .
  • Page 12 ST’s terms and conditions of sale in place at the time of order acknowledgement. Purchasers are solely responsible for the choice, selection, and use of ST products and ST assumes no liability for application assistance or the design of Purchasers’...

Table of Contents