MIKROE-3176

             LightRanger 4 click PID: MIKROE‐3176 Weight: 23 g Light Ranger 4 click is an accurate distance measurement Click board™ based on a ToF (Time of Flight) measurement principle. The FlightSense™ enabled VL53L1X rangefinder module from STMicroelectronics is a complete measurement stack on the chip. It is surprisingly easy to work with, as this highly integrated range finder module exposes only I2C interface, XSH and INT pins to the host controller. It features the invisible Class1 laser emitter, used to emit a narrow band of a harmless modulated light beam in the IR range (940 nm), physical infrared filters and optics to achieve the best ranging performance in various ambient lighting conditions with a range of cover window options. It can measure distances up to 4000mm, with up to 50 Hz ranging frequency. ToF based light distance meters and rangefinders are one of the most accurate contactless distance measuring devices. The ability to precisely measure distance without making actual contact, allows Light Ranger 4 to be used in industry - for counting dimensions of goods in industry, controlling a safety area, building contactless digital measurement tools. Some other uses for this device could be building 3D visual guidance applications in robotics, for moving it through obstacles, and similar. How does it work? Light Ranger 4 click uses the FlightSense™ enabled VL53L1X rangefinder module from STMicroelectronics. This sensor uses the Class1 laser emitter, which emits light in the range of 940 nm. The light emission is in the IR range of the spectrum and it is not visible by a human eye. It is received by the IR sensor and processed by the integrated sections of the VL53L1X, giving the result on the output register, available via the standard I2C interface. The device is rated as Class 1 LASER product, and it does not cause harmful eye injuries. However, it should not be pointed towards the eyes. The highly integrated VL53L1X ToF sensor encompasses several integrated sections. It has an embedded MCU, OTP memory, RAM area, ROM area, ranging processing unit and the VCSEL driver. It exposes a simple I2C interface for the communication with the host MCU, offering a range of registers, used for configuring and status reporting. In addition, it offers an interrupt (INT) and XSH (XSHUT) pins routed to the mikroBUS™. Highly configurable interrupt engine allows this pin to be configured to generate interrupt signals for various events, alerting the host MCU about some important status changes, such as the Data Ready event, for example. It can be set to work in both opendrain configurations, as well as in the push-pull mode. Besides the INT pin, XSH pin is also avalible on the click board, which can be used for shuting down the main IC. The Click board™ is equipped with the 10K pull-up resistors, so it is advised to configure the INT and XSH pins in open-drain mode. The measurement is done by comparing the modulation shift of the light in the reflected beam. Therefore, the range and the accuracy depend on the material of the measured object, as well as the photo - pollution of the IR spectrum. The module is designed to suppress the noise and interference, while the programmable Field of view from 15 to 27 degrees allows focused measurement and prevents beam scattering. The measurement is naturally affected by the IR reflectance of an object, so best results are achieved when measuring the distance of the objects that have high IR reflectance. The maximum range that can be measured is 4000mm, while the minimum operational range is 40mm. The measurement error is linear, and it grows with the distance. It stays within 10% of the distance. Since the VL53L1X ToF sensor module is highly integrated and requires a minimum number of external components to work, this Click board™ has only one SMD jumper (VCC SEL) which can be used to set the power supply voltage between 3.3V and 5V, allowing both 3.3V and 5V tolerant MCUs to be interfaced with the Click board™. The RFD77402 module datasheet offers an extensive information about internal registers and how to configure them. However, the click comes with the library of functions that provide simplified operation and measurement. The use of these functions is demonstrated in the example, which can be used as the reference for custom design. Specifications Type Optical Can be used for counting dimensions of goods in industry, controlling a safety Applications area, building contactless digital measurement tools. Some other uses for this device could be building 3D visual guidance applications in robotics, for moving it through obstacles, and similar On-board modules FlightSense™ enabled VL53L1X ToF sensor module, from STMicroelectronics Contactless measurement between 40mm and up to 4000mm. The device is Key Features rated Class 1 laser product, operating in the IR (invisible) spectrum range. Integrated sections allow minimum number of external components to be used Interface I2C Input 3.3V Voltage Click board size M (42.9 x 25.4 mm) Pinout diagram This table shows how the pinout on LightRanger 4 Click corresponds to the pinout on the mikroBUS™ socket (the latter shown in the two middle columns). Notes Pin Pin Notes NC 1 AN PWM 16 NC XSH 2 RST INT 15 INT NC 3 CS RX 14 NC NC 4 SCK TX 13 NC NC 5 MISO SCL 12 SCL I2C Clock NC 6 MOSI SDA 11 SDA I2C Data Power supply 3.3V 7 3.3V 5V 10 NA Ground GND 8 GND GND 9 GND Shut Down Interrupt OUT     Ground Onboard settings and indicators Label Name Default PWR PWR - VCC SEL 3.3V JP1 Description Power LED indicator Power supply voltage select Software support We provide a library for the LightRanger 4 Click on our LibStock page, as well as a demo application (example), developed using MikroElektronika compilers. The demo can run on all the main MikroElektronika development boards. Library Description The library initializes and defines the I2C bus driver and drivers that offer a choice for writing data in registers and reading data from registers. The library includes functions for full Configuration chip, sets measurement distance mode, inter measurement period, timing budget and user Roi. The user has the functions available for softReset, power on procedure, read distance of the object in front of the sensor Key functions:    uint8_t lightranger4_deviceConfiguration() - Functions for device configuration void lightranger4_startMeasurement(uint32_t period_ms) - Functions for start measurement uint16_t lightranger4_getDistance() - Function reads distance of the object in front of the sensor Example description The application is composed of three sections:  System Initialization - Initializes I2C module and set INT pin as INPUT and RST pin as OUTPUT  Application Initialization - Initializes the driver init, chip configuration, adjusts the LONG mode (distance measurement up to 4 meters), sets the time budget and start measurement with the adjustment of inter measurements period.  Application Task - (code snippet) - Reads the distance of the object in front of the sensor and logs distance to USBUART every 500 ms. void applicationTask()  {   while(lightranger4_newDataReady() != 0)   {   Delay_1ms();   }     distance = lightranger4_getDistance();   IntToStr(distance, demoText);   mikrobus_logWrite(" ‐ Distance : ", _LOG_TEXT);   mikrobus_logWrite(demoText, _LOG_TEXT);   mikrobus_logWrite(" mm ", _LOG_LINE);     measurementStatus = lightranger4_getRangeStatus();   switch (measurementStatus)   {   case _LR4_MRESP_SIGNAL_FAIL:   {   mikrobus_logWrite( "Signal fail.", _LOG_LINE);   break;   }   case _LR4_MRESP_PHASE_OUT_OF_VALID_LIMITS:   {   mikrobus_logWrite( "Phase out of valid limits", _LOG_LINE);   break;   }   case _LR4_MRESP_SIGMA_FAIL:   {   mikrobus_logWrite( "Sigma Fail. ", _LOG_LINE);   break;   }   case _LR4_MRESP_WRAP_TARGET_FAIL:   {   mikrobus_logWrite( "Wrap target fail.", _LOG_LINE);   break;   }   case _LR4_MRESP_MINIMUM_DETECTION_THRESHOLD:   {   mikrobus_logWrite( "Target is below minimum detection threshold. ", _LOG_LINE);   break;   }   default:   {   break;   }   }     Delay_ms( 500 );  }  The full application code, and ready to use projects can be found on our LightRanger 4 click LibStock page. Other mikroE Libraries used in the example:  I2C Additional notes and information 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. The terminal available in all MikroElektronika compilers, or any other terminal application of your choice, can be used to read the message. mikroSDK This click board is supported with mikroSDK - MikroElektronika Software Development Kit. To ensure proper operation of mikroSDK compliant click board demo applications, mikroSDK should be downloaded from the LibStock and installed for the compiler you are using. For more information about mikroSDK, visit the official page.                                                                                       https://www.mikroe.com/lightranger‐4‐click 10‐2‐18