https://github.com/stm32duino/vl53l1
Arduino library to support the VL53L1 Time-of-Flight ranging sensor with advanced multi-zone and multi-object detection
https://github.com/stm32duino/vl53l1
Last synced: 8 months ago
JSON representation
Arduino library to support the VL53L1 Time-of-Flight ranging sensor with advanced multi-zone and multi-object detection
- Host: GitHub
- URL: https://github.com/stm32duino/vl53l1
- Owner: stm32duino
- License: bsd-3-clause
- Created: 2020-07-31T13:04:07.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2022-11-24T13:26:24.000Z (about 3 years ago)
- Last Synced: 2025-04-05T14:34:49.900Z (10 months ago)
- Language: C++
- Homepage:
- Size: 305 KB
- Stars: 9
- Watchers: 1
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# VL53L1
Arduino library to support the VL53L1 Time-of-Flight ranging sensor with advanced multi-zone and multi-object detection.
## API
This sensor uses I2C to communicate. And I2C instance is required to access to the sensor.
The APIs provide simple distance measure and multi-object detection in both polling and interrupt modes.
## Examples
There are 2 examples with the VL53L1 library.
In order to use these examples you need to connect the VL53L1 satellite sensor directly to the Nucleo board with wires as explained below:
- pin 1 (Interrupt) of the VL53L1 satellite connected to pin A2 of the Nucleo board
- pin 2 (SCL_I) of the VL53L1 satellite connected to pin D15 (SCL) of the Nucleo board with a Pull-Up resistor of 4.7 KOhm
- pin 3 (XSDN_I) of the VL53L1 satellite connected to pin A1 of the Nucleo board
- pin 4 (SDA_I) of the VL53L1 satellite connected to pin D14 (SDA) of the Nucleo board with a Pull-Up resistor of 4.7 KOhm
- pin 5 (VDD) of the VL53L1 satellite connected to 3V3 pin of the Nucleo board
- pin 6 (GND) of the VL53L1 satellite connected to GND of the Nucleo board
- pins 7, 8, 9 and 10 are not connected.
* VL53L1_Sat_HelloWorld: This example code is to show how to get multi-object detection and proximity
values of the VL53L1 satellite sensor in polling mode.
* VL53L1_Sat_HelloWorld_Interrupt: This example code is to show how to get multi-object detection and proximity
values of the VL53L1 satellite sensor in interrupt mode.
## Note
The maximum detection distance is influenced by the color of the target and
the indoor or outdoor situation due to absence or presence of external
infrared. The detection range can be comprise between ~40cm and ~400cm.
The library should work also with standard Arduino boards. In this case you just
need to adjust the code in the sketch in order to use the correct Wire instance and
the correct pin number for XSHUT and GPIO1 pins.
## Documentation
You can find the source files at
https://github.com/stm32duino/VL53L1
The VL53L1 datasheet is available at
https://www.st.com/content/st_com/en/products/imaging-and-photonics-solutions/proximity-sensors/vl53l1.html