samples: sensor: Add vl53l1x time of flight sensor sample

vl53l1x time of flight (TOF) sensor sample, fetching proximity and
distance data in every second.

Add overlay file for nucleo_f401re to make this sample works out-of-box.

Signed-off-by: Aaron Tsui <[email protected]>

Author: overheat

samples/sensor/vl53l1x/CMakeLists.txt

@@ -0,0 +1,8 @@
+# SPDX-License-Identifier: Apache-2.0
+
+cmake_minimum_required(VERSION 3.13.1)
+include($ENV{ZEPHYR_BASE}/cmake/app/boilerplate.cmake NO_POLICY_SCOPE)
+project(vl53l1x)
+
+FILE(GLOB app_sources src/*.c)
+target_sources(app PRIVATE ${app_sources})

samples/sensor/vl53l1x/README.rst

@@ -0,0 +1,48 @@
+.. _vl53l1x:
+
+VL53L1X: Time Of Flight sensor
+##############################
+
+Overview
+********
+This sample periodically measures the distance between the VL53L1X
+sensor and a target. The result is displayed on the console.
+It also shows how we can use the VL53L1X as a proximity sensor.
+
+
+Requirements
+************
+
+This sample uses the VL53L1X sensor controlled using the I2C interface.
+
+References
+**********
+
+ - VL53L1X: http://www.st.com/en/imaging-and-photonics-solutions/vl53l1x.html
+
+Building and Running
+********************
+
+ This project outputs sensor data to the console. It requires a VL53L1X
+ sensor.
+
+ .. zephyr-app-commands::
+    :app: samples/sensor/vl53l1x/
+    :goals: build flash
+
+
+Sample Output
+=============
+
+ .. code-block:: console
+
+   prox is 1
+   distance is 0.053000m
+   prox is 1
+   distance is 0.051000m
+   prox is 0
+   distance is 1.929000m
+   prox is 0
+   distance is 1.930000m
+
+    <repeats endlessly every second>

samples/sensor/vl53l1x/nucleo_f401re.overlay

@@ -0,0 +1,15 @@
+/*
+ * Copyright (c) 2019 Peter Bigot Consulting, LLC
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+&i2c1 { /* SDA CN5.9=PB9, SCL CN5.10=PB8, INT CN8.3=A2=PA4 */
+	vl53l1x@29 {
+		compatible = "st,vl53l1x";
+		reg = <0x29>;
+		label = "VL53L1X";
+		drdy-gpios = <&gpioa 4 GPIO_INT_ACTIVE_LOW>;
+	};
+};
+

samples/sensor/vl53l1x/prj.conf

@@ -0,0 +1,15 @@
+CONFIG_I2C=y
+CONFIG_GPIO=y
+CONFIG_SENSOR=y
+CONFIG_VL53L1X=y
+CONFIG_VL53L1X_PROXIMITY_THRESHOLD=100
+#CONFIG_VL53L1X_XSHUT_CONTROL_ENABLE=y
+#CONFIG_VL53L1X_TRIGGER_NONE=y
+CONFIG_VL53L1X_TRIGGER_OWN_THREAD=y
+#CONFIG_VL53L1X_TRIGGER_GLOBAL_THREAD=n
+
+
+#debug
+#CONFIG_DEBUG=y
+#CONFIG_LOG=y
+#CONFIG_SENSOR_LOG_LEVEL_DBG=y

samples/sensor/vl53l1x/sample.yaml

@@ -0,0 +1,7 @@
+sample:
+  name: Sample for MEMS sensors VL53L1X
+tests:
+  sample.sensor.vl53l1x:
+    build_only: true
+    depends_on: i2c vl53l1x
+    tags: sensors

samples/sensor/vl53l1x/src/main.c

@@ -0,0 +1,65 @@
+/*
+ * Copyright (c) 2017 STMicroelectronics
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#include <zephyr.h>
+#include <device.h>
+#include <sensor.h>
+#include <misc/printk.h>
+
+static void process_sample(struct device *dev)
+{
+	int ret;
+	struct sensor_value value;
+
+	ret = sensor_sample_fetch(dev);
+
+	if (ret) {
+		printk("sensor_sample_fetch failed ret %d\n", ret);
+		return;
+	}
+
+	ret = sensor_channel_get(dev, SENSOR_CHAN_PROX, &value);
+	printk("prox is %d\n", value.val1);
+
+	ret = sensor_channel_get(dev,
+					SENSOR_CHAN_DISTANCE,
+					&value);
+	printk("distance is %d.%06dm\n", value.val1, value.val2);
+}
+
+static void vl53l1x_handler(struct device *dev,
+			   struct sensor_trigger *trig)
+{
+	process_sample(dev);
+}
+
+
+void main(void)
+{
+	struct device *dev = device_get_binding(DT_ST_VL53L1X_0_LABEL);
+
+	if (dev == NULL) {
+		printk("Could not get VL53L1X device\n");
+		return;
+	}
+
+	if (IS_ENABLED(CONFIG_VL53L1X_TRIGGER)) {
+		struct sensor_trigger trig = {
+			.type = SENSOR_TRIG_DATA_READY,
+			.chan = SENSOR_CHAN_ALL,
+		};
+		if (sensor_trigger_set(dev, &trig, vl53l1x_handler) < 0) {
+			printk("Cannot configure trigger\n");
+			return;
+		};
+	}
+
+	while (!IS_ENABLED(CONFIG_VL53L1X_TRIGGER)) {
+		process_sample(dev);
+		k_sleep(1000);
+	}
+	k_sleep(K_FOREVER);
+}