ST / X_NUCLEO_53L0A1

Library for use with VL53L0X, cut 1.1, based on mass-market API v1.1.

Dependencies:   ST_INTERFACES X_NUCLEO_COMMON

Dependents:   ConcorsoFinal HelloWorld_IHM01A1 m3pi_BT m3pi_LIDAR ... more

Fork of X_NUCLEO_53L0A1 by ST Expansion SW Team

X-NUCLEO-53L0A1 Proximity Sensor Expansion Board Firmware Package

Introduction

This firmware package includes Component Device Drivers and the Board Support Package for STMicroelectronics' X-NUCLEO-53L0A1 Proximity sensor expansion board based on VL53L0X.

Firmware Library

Class X_NUCLEO_53L0A1 is intended to represent the Proximity sensor expansion board with the same name.

The expansion board provides support for the following components:

1. on-board VL53L0X proximity sensor,
2. up to two additional VL53L0X Satellites,
3. on-board 4-digit display

It is intentionally implemented as a singleton because only one X-NUCLEO-VL53L0A1 may be deployed at a time in a HW component stack. In order to get the singleton instance you have to call class method `Instance()`, e.g.:

// Sensors expansion board singleton instance
static X_NUCLEO_53L0A1 *board = X_NUCLEO_53L0A1::Instance(device_i2c, A2, D8, D2);

Example Applications

• Hello World 53L0
• Display 53L0A1
• Display 53L0A1 Interrupts
• Display 53L0A1 with satellites
• 53L0A1 Satellites with Interrupts
• 53L0A1_HandGestureRecognition

The library and sample application code were tested against mbed revision 143, dated 26th May 2017.

--- a/Components/VL53L0X/vl53l0x_class.h	Thu Dec 01 14:17:46 2016 +0000
+++ b/Components/VL53L0X/vl53l0x_class.h	Fri Dec 02 10:44:40 2016 +0000
@@ -721,7 +721,6 @@
  */		
     virtual int GetDistance(uint32_t *piData)
     {
-//       return VL6180x_RangeGetResult(Device, piData);
         int status=0;
         VL53L0X_RangingMeasurementData_t pRangingMeasurementData;
 
@@ -729,8 +728,15 @@
         if (!status) {
             status=GetMeasurement(range_single_shot_polling, &pRangingMeasurementData);
         }
+        if (pRangingMeasurementData.RangeStatus == 0) {
+        // we have a valid range.
+            *piData = pRangingMeasurementData.RangeMilliMeter;
+        }
+        else {
+            *piData = 0;
+            status = VL53L0X_ERROR_RANGE_ERROR;
+        }
         StopMeasurement(range_single_shot_polling);
-        *piData = pRangingMeasurementData.RangeMilliMeter;
         return status;
     }