WLED/usermods/LDR_Dusk_Dawn_v2
Frank da488f76d2 LDR_Dusk_Dawn: use pinManager, check ldrPin before use (quick-fix for #3490) 2023-12-15 21:58:05 +01:00
..
README.md Add LDR sensor dusk/dawn preset control Usermod 2023-11-02 11:20:08 -04:00
usermod_LDR_Dusk_Dawn_v2.h LDR_Dusk_Dawn: use pinManager, check ldrPin before use (quick-fix for #3490) 2023-12-15 21:58:05 +01:00

README.md

LDR_Dusk_Dawn_v2

This usermod will obtain readings from a Light Dependent Resistor (LDR) and will turn on/off specific presets based on those readings. This is useful for exterior lighting situations where you want the lights to only be on when it is dark out.

Installation

Add "-D USERMOD_LDR_DUSK_DAWN" to your platformio.ini [common] build_flags and build.

Example:

[common]
build_flags =
  -D USERMOD_LDR_DUSK_DAWN   # Enable LDR Dusk Dawn Usermod

Usermod Settings

Setting Description Default
Enabled Enable/Disable the LDR functionality. Disabled
LDR Pin The analog capable pin your LDR is connected to. 34
Threshold Minutes The number of minutes of consistent readings above/below the on/off threshold before the LED state will change. 5
Threshold The analog read value threshold from the LDR. Readings lower than this number will count towards changing the LED state to off. You can see the current LDR reading by going into the info section when LDR functionality is enabled. 1000
On Preset The WLED preset to be used for the LED on state. 1
Off Preset The WLED preset to be used for the LED off state. 2

Author

@jeffwdh
jeffwdh@tarball.ca