221 lines
7.2 KiB
C
221 lines
7.2 KiB
C
/*******************************************************************************
|
|
* Copyright (c) 2020, STMicroelectronics - All Rights Reserved
|
|
*
|
|
* This file is part of the VL53L8CX Ultra Lite Driver and is dual licensed,
|
|
* either 'STMicroelectronics Proprietary license'
|
|
* or 'BSD 3-clause "New" or "Revised" License' , at your option.
|
|
*
|
|
********************************************************************************
|
|
*
|
|
* 'STMicroelectronics Proprietary license'
|
|
*
|
|
********************************************************************************
|
|
*
|
|
* License terms: STMicroelectronics Proprietary in accordance with licensing
|
|
* terms at www.st.com/sla0081
|
|
*
|
|
* STMicroelectronics confidential
|
|
* Reproduction and Communication of this document is strictly prohibited unless
|
|
* specifically authorized in writing by STMicroelectronics.
|
|
*
|
|
*
|
|
********************************************************************************
|
|
*
|
|
* Alternatively, the VL53L8CX Ultra Lite Driver may be distributed under the
|
|
* terms of 'BSD 3-clause "New" or "Revised" License', in which case the
|
|
* following provisions apply instead of the ones mentioned above :
|
|
*
|
|
********************************************************************************
|
|
*
|
|
* License terms: BSD 3-clause "New" or "Revised" License.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions are met:
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions are met:
|
|
*
|
|
* 1. Redistributions of source code must retain the above copyright notice, this
|
|
* list of conditions and the following disclaimer.
|
|
*
|
|
* 2. Redistributions in binary form must reproduce the above copyright notice,
|
|
* this list of conditions and the following disclaimer in the documentation
|
|
* and/or other materials provided with the distribution.
|
|
*
|
|
* 3. Neither the name of the copyright holder nor the names of its contributors
|
|
* may be used to endorse or promote products derived from this software
|
|
* without specific prior written permission.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
|
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
|
* DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
|
|
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
|
* SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
|
|
* CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
|
|
* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
|
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
*
|
|
*
|
|
*******************************************************************************/
|
|
|
|
/***********************************/
|
|
/* VL53L8CX ULD get/set params */
|
|
/***********************************/
|
|
/*
|
|
* This example shows the possibility of VL53L8CX to get/set params. It
|
|
* initializes the VL53L8CX ULD, set a configuration, and starts
|
|
* a ranging to capture 10 frames.
|
|
*
|
|
* In this example, we also suppose that the number of target per zone is
|
|
* set to 1 , and all output are enabled (see file platform.h).
|
|
*/
|
|
|
|
#include <stdlib.h>
|
|
#include <string.h>
|
|
#include <stdio.h>
|
|
#include "vl53l8cx_api.h"
|
|
|
|
int example2(void)
|
|
{
|
|
|
|
/*********************************/
|
|
/* VL53L8CX ranging variables */
|
|
/*********************************/
|
|
|
|
uint8_t status, loop, isAlive, isReady, i;
|
|
uint32_t integration_time_ms;
|
|
VL53L8CX_Configuration Dev; /* Sensor configuration */
|
|
VL53L8CX_ResultsData Results; /* Results data from VL53L8CX */
|
|
|
|
|
|
/*********************************/
|
|
/* Customer platform */
|
|
/*********************************/
|
|
|
|
/* Fill the platform structure with customer's implementation. For this
|
|
* example, only the I2C address is used.
|
|
*/
|
|
Dev.platform.address = VL53L8CX_DEFAULT_I2C_ADDRESS;
|
|
|
|
/* (Optional) Reset sensor toggling PINs (see platform, not in API) */
|
|
//Reset_Sensor(&(Dev.platform));
|
|
|
|
/* (Optional) Set a new I2C address if the wanted address is different
|
|
* from the default one (filled with 0x20 for this example).
|
|
*/
|
|
//status = vl53l8cx_set_i2c_address(&Dev, 0x20);
|
|
|
|
|
|
/*********************************/
|
|
/* Power on sensor and init */
|
|
/*********************************/
|
|
|
|
/* (Optional) Check if there is a VL53L8CX sensor connected */
|
|
status = vl53l8cx_is_alive(&Dev, &isAlive);
|
|
if(!isAlive || status)
|
|
{
|
|
printf("VL53L8CX not detected at requested address\n");
|
|
return status;
|
|
}
|
|
|
|
/* (Mandatory) Init VL53L8CX sensor */
|
|
status = vl53l8cx_init(&Dev);
|
|
if(status)
|
|
{
|
|
printf("VL53L8CX ULD Loading failed\n");
|
|
return status;
|
|
}
|
|
|
|
printf("VL53L8CX ULD ready ! (Version : %s)\n",
|
|
VL53L8CX_API_REVISION);
|
|
|
|
|
|
/*********************************/
|
|
/* Set some params */
|
|
/*********************************/
|
|
|
|
/* Set resolution in 8x8. WARNING : As others settings depend to this
|
|
* one, it must be the first to use.
|
|
*/
|
|
status = vl53l8cx_set_resolution(&Dev, VL53L8CX_RESOLUTION_8X8);
|
|
if(status)
|
|
{
|
|
printf("vl53l8cx_set_resolution failed, status %u\n", status);
|
|
return status;
|
|
}
|
|
|
|
/* Set ranging frequency to 10Hz.
|
|
* Using 4x4, min frequency is 1Hz and max is 60Hz
|
|
* Using 8x8, min frequency is 1Hz and max is 15Hz
|
|
*/
|
|
status = vl53l8cx_set_ranging_frequency_hz(&Dev, 10);
|
|
if(status)
|
|
{
|
|
printf("vl53l8cx_set_ranging_frequency_hz failed, status %u\n", status);
|
|
return status;
|
|
}
|
|
|
|
/* Set target order to closest */
|
|
status = vl53l8cx_set_target_order(&Dev, VL53L8CX_TARGET_ORDER_CLOSEST);
|
|
if(status)
|
|
{
|
|
printf("vl53l8cx_set_target_order failed, status %u\n", status);
|
|
return status;
|
|
}
|
|
|
|
/* Get current integration time */
|
|
status = vl53l8cx_get_integration_time_ms(&Dev, &integration_time_ms);
|
|
if(status)
|
|
{
|
|
printf("vl53l8cx_get_integration_time_ms failed, status %u\n", status);
|
|
return status;
|
|
}
|
|
printf("Current integration time is : %d ms\n", (int)integration_time_ms);
|
|
|
|
|
|
/*********************************/
|
|
/* Ranging loop */
|
|
/*********************************/
|
|
|
|
status = vl53l8cx_start_ranging(&Dev);
|
|
|
|
loop = 0;
|
|
while(loop < 10)
|
|
{
|
|
/* Use polling function to know when a new measurement is ready.
|
|
* Another way can be to wait for HW interrupt raised on PIN A1
|
|
* (INT) when a new measurement is ready */
|
|
|
|
status = vl53l8cx_check_data_ready(&Dev, &isReady);
|
|
|
|
if(isReady)
|
|
{
|
|
vl53l8cx_get_ranging_data(&Dev, &Results);
|
|
|
|
/* As the sensor is set in 8x8 mode, we have a total
|
|
* of 64 zones to print. For this example, only the data of
|
|
* first zone are print */
|
|
printf("Print data no : %3u\n", Dev.streamcount);
|
|
for(i = 0; i < 64; i++)
|
|
{
|
|
printf("Zone : %3d, Status : %3u, Distance : %4d mm\n",
|
|
i,
|
|
Results.target_status[VL53L8CX_NB_TARGET_PER_ZONE*i],
|
|
Results.distance_mm[VL53L8CX_NB_TARGET_PER_ZONE*i]);
|
|
}
|
|
printf("\n");
|
|
loop++;
|
|
}
|
|
|
|
/* Wait a few ms to avoid too high polling (function in platform
|
|
* file, not in API) */
|
|
WaitMs(&(Dev.platform), 5);
|
|
}
|
|
|
|
status = vl53l8cx_stop_ranging(&Dev);
|
|
printf("End of ULD demo\n");
|
|
return status;
|
|
}
|