CircuitPython driver for the VL53L0X distance sensor. This code is adapted from the pololu driver here: https://github.com/pololu/vl53l0x-arduino
See usage in the examples/vl53l0x_simpletest.py file.
Author(s): Tony DiCola
Adafruit VL53L0X Time of Flight Distance Sensor - ~30 to 1000mm (Product ID: 3317)
Software and Dependencies:
Adafruit CircuitPython firmware for the ESP8622 and M0-based boards: https://github.com/adafruit/circuitpython/releases
Adafruit’s Bus Device library: https://github.com/adafruit/Adafruit_CircuitPython_BusDevice
- class adafruit_vl53l0x.VL53L0X(i2c, address=41, io_timeout_s=0)¶
Driver for the VL53L0X distance sensor.
Activate the continuous mode manager
- property data_ready¶
Check if data is available from the sensor. If true a call to .range will return quickly. If false, calls to .range will wait for the sensor’s next reading to be available.
- property distance¶
Perform a single reading of the range for an object in front of the sensor and return the distance in centimeters.
Perform a single reading of the range for an object in front of the sensor, but without return the distance.
- property is_continuous_mode¶
Is the sensor currently in continuous mode?
- property measurement_timing_budget¶
The measurement timing budget in microseconds.
- property range¶
Perform a single (or continuous if
start_continuouscalled) reading of the range for an object in front of the sensor and return the distance in millimeters.
Return a range reading in millimeters. Note: Avoid calling this directly. If you do single mode, you need to call
do_range_measurementfirst. Or your program will stuck or timeout occurred.
Set a new I2C address to the instantaited object. This is only called when using multiple VL53L0X sensors on the same I2C bus (SDA & SCL pins). See also the example for proper usage.
To properly set the address to an individual VL53L0X sensor, you must first ensure that all other VL53L0X sensors (using the default address of
0x29) on the same I2C bus are in their off state by pulling the “SHDN” pins LOW. When the “SHDN” pin is pulled HIGH again the default I2C address is
- property signal_rate_limit¶
The signal rate limit in mega counts per second.
Perform a continuous reading of the range for an object in front of the sensor.
Stop continuous readings.