RJRP44 / VL53L8CX-Library

πŸ’½ A vl53l8cx library for esp32 using the esp-idf framework

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

VL53L8CX library for ESP32

Component Registry Uld Version

A vl53l5cx library for esp32 using the esp-idf framework. This library is based on ST's Ultra Lite Driver (ULD) for VL53L8CX v.1.2.2. This library is just an adaptation of the ST's library for esp-32.

Warning This Library is not compatible with Arduino framework

Contents πŸ“Œ


Getting started

Wiring for the SATEL-VL53L8

For the examples this is the used wiring, but feel free to modify it and adapt it for your needs.

SATEL-VL53L8 Pins ESP32S3 Pins
5v 5v
1v8 NC
3v3 NC
IOVDD NC
PWREN GPIO5, 10 kΞ© pullup resistor required to 3v3 if you want to use the Reset_Sensor() function, otherwise connect it to 3v3 or 5v
MCLK_SCL GPIO2, 2.2 kΞ© pullup resistor required to 3v3
MOSI_SDA GPIO1, 2.2 kΞ© pullup resistor required to 3v3
MISO NC
NCS 3v3
SPI_I2C_N GND
GPIO1 NC
GPIO2 NC
GND GND

Library Installation πŸ“₯

The library is available at https://components.espressif.com/components/rjrp44/vl53l8cx.

So, you can use the IDF Component Manager to easily import this library into your project. To add this component to your project, run:

idf.py add-dependency "rjrp44/vl53l8cx^2.0.0" 

Examples πŸ“„

You can find in πŸ“ ./examples ST's examples adapted for ESP32 with IΒ²C. For more information about the available features read UM3109.

Usual errors πŸ›

Stack overflow error πŸ’½

If by running an example you get a stack overflow error, this means that your main stack size is too small.

***ERROR*** A stack overflow in task main has been detected.

Increase the main stack size :

Run idf.py menuconfig. Go to Component Component config -> ESP System settings and increase the Main task stack size to at least 7168.

More parameters βš™

In order to get more control over your sensor configuration, run idf.py menuconfig and go to Component Config -> Vl53l8cx.

πŸ“ License

Copyright Β© 2024 RJRP.

This project is BSD 3-Clause licensed.

✨ Show your support

Give a ⭐️ if this project helped you!

πŸ‘€ Authors

About

πŸ’½ A vl53l8cx library for esp32 using the esp-idf framework

License:Other


Languages

Language:C 100.0%Language:CMake 0.0%