proximity15  2.0.0.0
Main Page

Proximity 15 click

Proximity 15 Click is a compact add-on board that contains a close-range proximity sensing solution. This board features the VL53L1, a state-of-the-art, Time-of-Flight (ToF), a laser-ranging miniature sensor from STMicroelectronics.

click Product page


Click library

  • Author : Stefan Filipovic
  • Date : Aug 2021.
  • Type : I2C type

Software Support

We provide a library for the Proximity15 Click as well as a demo application (example), developed using MikroElektronika compilers. The demo can run on all the main MikroElektronika development boards.

Package can be downloaded/installed directly from NECTO Studio Package Manager(recommended way), downloaded from our LibStock™ or found on Mikroe github account.

Library Description

This library contains API for Proximity15 Click driver.

Standard key functions :

Example key functions :

Example Description

This example demonstrates the use of Proximity 15 click board.

The demo application is composed of two sections :

Application Init

Initializes the driver and performs the click default configuration which

enables the sensor and sets it to long distance mode with 50ms timing budget and 100ms inter measurement periods.

void application_init ( void )
{
log_cfg_t log_cfg;
proximity15_cfg_t proximity15_cfg;
LOG_MAP_USB_UART( log_cfg );
log_init( &logger, &log_cfg );
log_info( &logger, " Application Init " );
// Click initialization.
proximity15_cfg_setup( &proximity15_cfg );
PROXIMITY15_MAP_MIKROBUS( proximity15_cfg, MIKROBUS_1 );
err_t init_flag = proximity15_init( &proximity15, &proximity15_cfg );
if ( I2C_MASTER_ERROR == init_flag )
{
log_error( &logger, " Application Init Error. " );
log_info( &logger, " Please, run program again... " );
for ( ; ; );
}
init_flag = proximity15_default_cfg ( &proximity15 );
if ( PROXIMITY15_ERROR == init_flag )
{
log_error( &logger, " Default Config Error. " );
log_info( &logger, " Please, run program again... " );
for ( ; ; );
}
log_info( &logger, " Application Task " );
}

Application Task

Reads the distance measured by the sensor in milimeters and displays the value on the USB UART approximately every 100ms.

void application_task ( void )
{
uint16_t distance = 0;
if ( PROXIMITY15_OK == proximity15_get_distance ( &proximity15, &distance ) )
{
log_printf( &logger, " Distance(mm): %u\r\n\n", distance );
}
}

Note

In order to measure longer distance, increase the timing budget and inter measurement periods.

The full application code, and ready to use projects can be installed directly from NECTO Studio Package Manager(recommended way), downloaded from our LibStock™ or found on Mikroe github account.

Other Mikroe Libraries used in the example:

  • MikroSDK.Board
  • MikroSDK.Log
  • Click.Proximity15

Additional notes and informations

Depending on the development board you are using, you may need USB UART click, USB UART 2 Click or RS232 Click to connect to your PC, for development systems with no UART to USB interface available on the board. UART terminal is available in all MikroElektronika compilers.


PROXIMITY15_MAP_MIKROBUS
#define PROXIMITY15_MAP_MIKROBUS(cfg, mikrobus)
MikroBUS pin mapping.
Definition: proximity15.h:134
PROXIMITY15_OK
@ PROXIMITY15_OK
Definition: proximity15.h:186
proximity15_set_inter_measurement_period
err_t proximity15_set_inter_measurement_period(proximity15_t *ctx, uint16_t time_ms)
Proximity 15 set inter measurement period function.
proximity15_init
err_t proximity15_init(proximity15_t *ctx, proximity15_cfg_t *cfg)
Proximity 15 initialization function.
proximity15_timing_budget_t
proximity15_timing_budget_t
Proximity 15 Click timing budget values.
Definition: proximity15.h:197
application_task
void application_task(void)
Definition: main.c:73
proximity15_cfg_t
Proximity 15 Click configuration object.
Definition: proximity15.h:168
proximity15_get_distance
err_t proximity15_get_distance(proximity15_t *ctx, uint16_t *distance)
Proximity 15 get distance function.
proximity15_cfg_setup
void proximity15_cfg_setup(proximity15_cfg_t *cfg)
Proximity 15 configuration object setup function.
proximity15_set_timing_budget
err_t proximity15_set_timing_budget(proximity15_t *ctx, proximity15_timing_budget_t time)
Proximity 15 set timing budget function.
proximity15_t
Proximity 15 Click context object.
Definition: proximity15.h:148
application_init
void application_init(void)
Definition: main.c:33
proximity15_default_cfg
err_t proximity15_default_cfg(proximity15_t *ctx)
Proximity 15 default configuration function.
PROXIMITY15_ERROR
@ PROXIMITY15_ERROR
Definition: proximity15.h:187