drivers: sensors: Add official ST library for vl53l5cx

Adds the official ST library for the vl53l5cx tof sensor.

Signed-off-by: Fabian Blatz <[email protected]>

Author: faxe1008

CMakeLists.txt

@@ -31,6 +31,15 @@ zephyr_library_sources(sensor/vl53l1x/api/core/src/vl53l1_core_support.c)
 zephyr_library_sources(sensor/vl53l1x/api/core/src/vl53l1_register_funcs.c)
 endif()
 
+if(CONFIG_VL53L5CX)
+zephyr_include_directories(sensor/vl53l5cx/api/inc
+			   ${PROJECT_SOURCE_DIR}/drivers/sensor/st/vl53l5cx)
+zephyr_library_sources(sensor/vl53l5cx/api/src/vl53l5cx_api.c)
+zephyr_library_sources(sensor/vl53l5cx/api/src/vl53l5cx_plugin_detection_thresholds.c)
+zephyr_library_sources(sensor/vl53l5cx/api/src/vl53l5cx_plugin_motion_indicator.c)
+zephyr_library_sources(sensor/vl53l5cx/api/src/vl53l5cx_plugin_xtalk.c)
+endif()
+
 if(CONFIG_AUDIO_MPXXDTYY)
 zephyr_include_directories(audio/microphone)
 zephyr_library_sources(audio/microphone/OpenPDMFilter.c)

sensor/vl53l5cx/README

@@ -0,0 +1,48 @@
+VL53L5CX
+########
+
+Origin:
+   ST Microelectronics
+   https://www.st.com/en/embedded-software/stsw-img007.html
+
+Status:
+   version 1.0.7
+
+Purpose:
+   ST Microelectonics official API to use vl53l5cx sensor.
+
+Description:
+   This library written by STMicroelectronics is dedicated to vl53l5cx time of flight sensor.
+
+   This library is called from the vl53l5cx driver and is kept transparent for user.
+   User is calling a standard Zephyr driver and then the driver makes some calls to this library.
+
+   In order to fit with Zephyr rules and simplify version updates, we have done a minimum of modifications:
+      - split headers and source to inc/src
+      - keep only API directory
+        (remove documentation and samples, see ST website for this)
+
+   In order to use this library, you have to:
+      * define CONFIG_HAS_STLIB and CONFIG_VL53L5CX
+      * include vl53l5cx_api.h and vl53l1_platform.h in the driver .h
+      * depending on your I2C controller implementation you will need to define VL53L5CX_BUF_ATTRIBUTES
+        to place the larger buffers into a dmable memory region
+
+Dependencies:
+   This package depends on Zephyr I2C implementation and is linked statically.
+   This library will be used by a standard Zephyr driver.
+
+URL:
+   http://www.st.com/en/embedded-software/stsw-img007.html
+
+commit:
+   version 1.0.7
+
+Maintained-by:
+   External
+
+License:
+   BSD-3-Clause
+
+License Link:
+   http://www.st.com/en/embedded-software/stsw-img007.html