VL53L1CB expansion board example, showing multi-ranges in an autonomous setup & polling mode. Uses the onboard sensor. Targets MbedOS v6.10.0.
Dependencies: X_NUCLEO_53L1A2
Diff: main.cpp
- Revision:
- 0:020912dfa221
- Child:
- 1:ff48a20de191
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/main.cpp Sun Nov 08 15:35:55 2020 +0000 @@ -0,0 +1,371 @@ +/* + * This VL53L1X Expansion board test application performs range measurements + * using the onboard embedded centre sensor and two satelites, in autonomous, interrupt mode. + * Measured ranges are ouput on the Serial Port, running at 115200 baud. + * +* + * This is designed to work with MBed V2 , MBed V5 and MBed V6. + * + * + * The Reset button can be used to restart the program. + */ + +#include <stdio.h> + +#include "mbed.h" +#include "XNucleo53L1A1.h" +#include "ToF_I2C.h" +#include <time.h> + +// i2c comms port pins +#define I2C_SDA D14 +#define I2C_SCL D15 + + +#define NUM_SENSORS 3 + +PinName CentreIntPin = A2; +// the satellite pins depend on solder blobs on the back of the shield. +// they may not exist or may be one of two sets. +// the centre pin always exists +PinName LeftIntPin = D9; +PinName RightIntPin = D4; +// alternate set +//PinName LeftIntPin = D8; +//PinName RightIntPin = D2; + + + +static XNucleo53L1A1 *board=NULL; + +// MBed V6.4 has renamed wait_ms and UnbufferedSerial replaces Serial +#if (MBED_VERSION > 60300) +UnbufferedSerial pc(SERIAL_TX, SERIAL_RX); +extern "C" void wait_ms(int ms); +#else +Serial pc(SERIAL_TX, SERIAL_RX); +#endif + +// flags to indicate an interrupt has happened +static int int_centre_result = 0; +static int int_left_result = 0; +static int int_right_result = 0; + +// flags to indicate an interrupt has cleared +static int int_centre_dropped = 0; +static int int_left_dropped = 0; +static int int_right_dropped = 0; + +void print_results( int devSpiNumber, VL53L1_MultiRangingData_t *pMultiRangingData ); + +class WaitForMeasurement { +public: + + +// this class services the interrupts from the ToF sensors. +// There is a limited amount you can do in an interrupt routine; printfs,mutexes break them among other things. +// We keep things simple by only raising a flag so all the real work is done outside the interrupt. +// This is designed around MBED V2 which doesn't have the RTOS features that would make this work nicely e.g. semaphores/queues. +WaitForMeasurement(): _interrupt(A1) +{ +} + + + // constructor - Sensor is not used and can be removed + WaitForMeasurement(PinName pin,VL53L1_DEV Dev) : _interrupt(pin) // create the InterruptIn on the pin specified to Counter + { + Devlocal = Dev; + pinlocal = pin; + + #include "mbed.h" + + + _interrupt.rise(callback(this, &WaitForMeasurement::got_interrupt)); // if interrupt happens read data + _interrupt.fall(callback(this, &WaitForMeasurement::linedropped)); // if interupt clears, clear interrupt + + } + + // function is called every time an interupt is cleared. Sets flags to clear the interrupt + void linedropped() + { + + if (Devlocal->i2c_slave_address == NEW_SENSOR_CENTRE_ADDRESS) + int_centre_dropped = 1; //flag to main that interrupt cleared. A flag is raised which allows the main routine to service interupt. + if (Devlocal->i2c_slave_address == NEW_SENSOR_LEFT_ADDRESS) + int_left_dropped = 1; //flag to main that interrupt cleared + if (Devlocal->i2c_slave_address == NEW_SENSOR_RIGHT_ADDRESS) + int_right_dropped = 1; //flag to main that interrupt cleared + + } + + // function is called every time an interupt is seen. A flag is raised which allows the main routine to service the interupt. + void got_interrupt() + { + DigitalIn intp(pinlocal); + + if (Devlocal->i2c_slave_address == NEW_SENSOR_CENTRE_ADDRESS) + int_centre_result = 1; //flag to main that interrupt happened + if (Devlocal->i2c_slave_address == NEW_SENSOR_LEFT_ADDRESS) + int_left_result = 1; //flag to main that interrupt happened7 + if (Devlocal->i2c_slave_address == NEW_SENSOR_RIGHT_ADDRESS) + int_right_result = 1; //flag to main that interrupt happened + } + + + //destructor + ~WaitForMeasurement() + { + printf("WaitForMeasurement destruction \n"); + } + +private: + InterruptIn _interrupt; + PinName pinlocal; + VL53L1_DEV Devlocal; + int status; + +}; + + + +VL53L1_Dev_t devCentre; +VL53L1_Dev_t devLeft; +VL53L1_Dev_t devRight; +VL53L1_DEV Dev = &devCentre; + + +/*=================================== Main ================================== +=============================================================================*/ +int main() +{ + int status; + VL53L1X * Sensor; + uint8_t ToFSensor = 1; // 0=Left, 1=Center(default), 2=Right + + //mbed compiler claims these are never used but they are. + WaitForMeasurement* int2; + WaitForMeasurement* int1; + WaitForMeasurement* int3; + + + pc.baud(115200); // baud rate is important as printf statements take a lot of time + + printf("Autonomous Interruptmbed = %d \r\n",MBED_VERSION); + +// create i2c interface + ToF_DevI2C *dev_I2C = new ToF_DevI2C(I2C_SDA, I2C_SCL); + + dev_I2C->frequency(400000); //also needs doing in spi_interface.c + + /* creates the 53L1A1 expansion board singleton obj */ + board = XNucleo53L1A1::instance(dev_I2C, CentreIntPin, LeftIntPin, RightIntPin); + + printf("board created!\r\n"); + + /* init the 53L1A1 expansion board with default values */ + status = board->init_board(); + if (status) { + printf("Failed to init board!\r\n"); + return 0; + } + + + printf("board initiated! - %d\r\n", status); + // create sensor controller classes for each vl53l1 and configure each vl53l1 + for (ToFSensor=0;ToFSensor < NUM_SENSORS;ToFSensor++){ + switch(ToFSensor){ + case 0: + if (board->sensor_centre== NULL ) continue; // don't create if sensor not detected + Dev=&devCentre; + Sensor=board->sensor_centre; + Dev->i2c_slave_address = NEW_SENSOR_CENTRE_ADDRESS; + printf("configuring centre channel \n"); + break; + case 1: + if (board->sensor_left== NULL ) continue; + Dev=&devLeft; + Sensor=board->sensor_left; + Dev->i2c_slave_address = NEW_SENSOR_LEFT_ADDRESS; + printf("configuring left channel \n"); + break; + case 2: + if (board->sensor_right== NULL ) continue; + Dev=&devRight; + Sensor=board->sensor_right; + Dev->i2c_slave_address = NEW_SENSOR_RIGHT_ADDRESS; + printf("configuring right channel \n"); + break; + default: + printf(" error in switch, invalid ToF sensor \n"); + } + + // configure the sensors + Dev->comms_speed_khz = 400; + + Dev->comms_type = 1; + + /* Device Initialization and setting */ + status = Sensor->vl53L1_DataInit(); + status = Sensor->vl53L1_StaticInit(); + status = Sensor->vl53L1_SetPresetMode(VL53L1_PRESETMODE_AUTONOMOUS); + status = Sensor->vl53L1_SetDistanceMode(VL53L1_DISTANCEMODE_LONG); + status = Sensor->vl53L1_SetMeasurementTimingBudgetMicroSeconds( 200 * 1000); + + + // set the ranging and signal rate filter + VL53L1_DetectionConfig_t thresholdconfig; + thresholdconfig.DetectionMode = VL53L1_DETECTION_DISTANCE_ONLY; /// type VL53L1_DetectionMode in vl53l1_def.h + thresholdconfig.Distance.CrossMode = VL53L1_THRESHOLD_IN_WINDOW; // type VL53L1_ThresholdMode. ignore if distance outside high and low + thresholdconfig.Distance.High = 300; // high distance in mm + thresholdconfig.Distance.Low = 200; // low distance in mm + thresholdconfig.Rate.CrossMode=0; // type VL53L1_ThresholdMode VL53L1_THRESHOLD_CROSSED_LOW VL53L1_THRESHOLD_CROSSED_HIGH VL53L1_THRESHOLD_OUT_OF_WINDOW VL53L1_THRESHOLD_IN_WINDOW + thresholdconfig.Rate.High = 0; + thresholdconfig.Rate.Low = 0; + thresholdconfig.IntrNoTarget = 0 ;// if 1 produce an interrupt even if there is no target found e.g out of range + status = Sensor->vl53L1_SetThresholdConfig(&thresholdconfig); + } + + // create interrupt handlers for the three sensors and start measurements + if (board->sensor_centre!= NULL ) + { + printf("starting interrupt centre\n"); + devCentre.i2c_slave_address = NEW_SENSOR_CENTRE_ADDRESS; + int1 = new WaitForMeasurement(CentreIntPin,&devCentre); // create interrupt handler + status = board->sensor_centre->vl53L1_StartMeasurement(); + } + + if (board->sensor_left!= NULL ) + { + printf("starting interrupt left\n"); + devLeft.i2c_slave_address = NEW_SENSOR_LEFT_ADDRESS; + int2 = new WaitForMeasurement(LeftIntPin,&devLeft); // create interrupt handler + status = board->sensor_left->vl53L1_StartMeasurement(); + printf("started interrupt left\n"); + } + + if (board->sensor_right!= NULL ) + { + printf("starting interrupt right\n"); + devRight.i2c_slave_address = NEW_SENSOR_RIGHT_ADDRESS; + int3 = new WaitForMeasurement(RightIntPin,&devRight); // create interrupt handler + status = board->sensor_right->vl53L1_StartMeasurement(); + } + + + printf("loop forever\n"); + + // loop waiting for interrupts to happen. This is signaled by int_centre_result,int_left_result or int_right_result + // being non zero. When the interrupts clear this is signaled by int_centre_dropped,int_left_dropped and int_right_dropped. + // These are set back to zero when processing is completed + while (1) + { + VL53L1_MultiRangingData_t MultiRangingData; + VL53L1_MultiRangingData_t *pMultiRangingData = &MultiRangingData; + + if ( int_left_dropped || int_centre_dropped || int_right_dropped ) + wait_ms(30); + + // when the interrupt pin goes loww start new measurement + if ( int_centre_dropped != 0) + { + int_centre_dropped = 0; + status = board->sensor_centre->vl53L1_ClearInterruptAndStartMeasurement(); + } + + if ( int_left_dropped != 0) + { + int_left_dropped = 0; + status = board->sensor_left->vl53L1_ClearInterruptAndStartMeasurement(); + } + + if ( int_right_dropped != 0) + { + int_right_dropped = 0; + status = board->sensor_right->vl53L1_ClearInterruptAndStartMeasurement(); + } + + if (int_right_result != 0) // interrupt seen on right sensor + { + status = board->sensor_right->vl53L1_GetMultiRangingData( pMultiRangingData); + if ( status == 0) + { + print_results( devRight.i2c_slave_address, pMultiRangingData ); + } + + // clear interrupt flag + int_right_result = 0; + } + + if (int_left_result != 0) // interrupt seen on left sensor + { + status = board->sensor_left->vl53L1_GetMultiRangingData( pMultiRangingData); + if ( status == 0) + { + print_results( devLeft.i2c_slave_address, pMultiRangingData ); + } + + // clear interrupt flag + int_left_result = 0; + } + + if (int_centre_result != 0) + { + status = board->sensor_centre->vl53L1_GetMultiRangingData( pMultiRangingData); + if ( status == 0) + { + print_results( devCentre.i2c_slave_address, pMultiRangingData ); + } + + // clear interrupt flag + int_centre_result = 0; + + } + wait_ms( 1 * 10); + + } + } + + + // print what ever results are required +void print_results( int devSpiNumber, VL53L1_MultiRangingData_t *pMultiRangingData ) +{ + int no_of_object_found=pMultiRangingData->NumberOfObjectsFound; + + int RoiNumber=pMultiRangingData->RoiNumber; + // int RoiStatus=pMultiRangingData->RoiStatus; + + if (( no_of_object_found < 10 ) && ( no_of_object_found != 0)) + { + for(int j=0;j<no_of_object_found;j++){ + if ((pMultiRangingData->RangeData[j].RangeStatus == VL53L1_RANGESTATUS_RANGE_VALID) || + (pMultiRangingData->RangeData[j].RangeStatus == VL53L1_RANGESTATUS_RANGE_VALID_NO_WRAP_CHECK_FAIL)) + { + printf("\t spiAddr=%d \t RoiNumber=%d \t D=%5dmm \n", + devSpiNumber, + RoiNumber, + pMultiRangingData->RangeData[j].RangeMilliMeter); + /* + printf("\t spiAddr=%d \t RoiNumber=%d \t status=%d, \t D=%5dmm, \t Signal=%2.2f Mcps, \t Ambient=%2.2f Mcps \n", + devSpiNumber, + RoiNumber, + pMultiRangingData->RangeData[j].RangeStatus, + pMultiRangingData->RangeData[j].RangeMilliMeter, + pMultiRangingData->RangeData[j].SignalRateRtnMegaCps/65536.0, + pMultiRangingData->RangeData[j].AmbientRateRtnMegaCps/65536.0); + */ + } + + } + } // if (( no_of_object_found < 10 ) && ( no_of_object_found != 0)) + +} + + +#if (MBED_VERSION > 60300) +extern "C" void wait_ms(int ms) + { + thread_sleep_for(ms); + } + #endif + +