History

srg74 8caeddde15 Spelling check by @wthomson (#2940 ) A lot of spelling corrections. Now repo will sound like educated person :) Co-authored-by: Bill Thomson <bt@kattt.org>		2022-12-10 16:12:55 +01:00
..
readme.md	Spelling check by @wthomson (#2940 )	2022-12-10 16:12:55 +01:00
usermod_vl53l0x_gestures.h	Adapting for the new WLED release: (#2802 )	2022-10-21 01:31:43 +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