History

Blaz Kristan 82e448de7c Beta-3 changes - remove I2C init from usermods - PCF8574 (&co) port expander support - refactor PIR & Rotary encoder & 4LD - reboot race condition - optimisations		2023-05-30 19:36:14 +02:00
..
readme.md	Spelling check by @wthomson (#2940 )	2022-12-10 16:12:55 +01:00
usermod_vl53l0x_gestures.h	Beta-3 changes	2023-05-30 19:36:14 +02:00

readme.md

Description

Implements support of simple hand gestures via a VL53L0X sensor: on/off and brightness adjustment. Useful for controlling strips when you want to avoid touching anything.

on/off - swipe your hand below the sensor ("shortPressAction" is called. Can be customized via WLED macros)
brightness adjustment - hold your hand below the sensor for 1 second to switch to "brightness" mode. adjust the brightness by changing the distance between your hand and the sensor (see parameters below for customization).

Installation

Attach VL53L0X sensor to i2c pins according to default pins for your board.
Add -D USERMOD_VL53L0X_GESTURES to your build flags at platformio.ini (plaformio_override.ini) for needed environment. In my case, for example: build_flags = ${env.build_flags} -D USERMOD_VL53L0X_GESTURES
Add "pololu/VL53L0X" dependency below to lib_deps like this:

lib_deps = ${env.lib_deps}
      pololu/VL53L0X @ ^1.3.0

My entire platformio_override.ini for example (for nodemcu board):

[platformio]
default_envs = nodemcuv2

[env:nodemcuv2]
build_flags = ${env.build_flags} -D USERMOD_VL53L0X_GESTURES
lib_deps = ${env.lib_deps}
           pololu/VL53L0X @ ^1.3.0