mirror
/
WLED
kopia lustrzana https://github.com/Aircoookie/WLED
1
0
Forkuj 0
Kod Zgłoszenia Packages Projekty Wydania Wiki Aktywność
WLED/usermods/BH1750_v2
Historia
Will Miles 4a3af814bf
Merge pull request #4669 from willmmiles/4597-usermods-not-building 
Correct issues with usermods not being linked.
- Explicitly set libArchive: false in usermod library.json files
- Fix up symlink path generation on Windows
- Add validation script to report usermod linkage in resulting binary
 		2025-05-26 22:41:45 -04:00
..
BH1750_v2.cpp usermods: Fix 7sd_reloaded cross module binding 2025-03-28 20:15:36 -04:00
BH1750_v2.h usermods: Fix 7sd_reloaded cross module binding 2025-03-28 20:15:36 -04:00
library.json Add libArchive to other usermods 2025-05-06 22:38:33 -04:00
readme.md Fixed markdownlint errors #2 2025-05-11 12:49:32 -04:00

readme.md

BH1750 usermod

This usermod will read from an ambient light sensor like the BH1750. The luminance is displayed in both the Info section of the web UI, as well as published to the /luminance MQTT topic if enabled.

Dependencies

  • Libraries
    • claws/BH1750 @^1.2.0
  • Data is published over MQTT - make sure you've enabled the MQTT sync interface.

Compilation

To enable, compile with BH1750 in custom_usermods (e.g. in platformio_override.ini)

Configuration Options

The following settings can be set at compile-time but are configurable on the usermod menu (except First Measurement time):

  • USERMOD_BH1750_MAX_MEASUREMENT_INTERVAL - the max number of milliseconds between measurements, defaults to 10000ms
  • USERMOD_BH1750_MIN_MEASUREMENT_INTERVAL - the min number of milliseconds between measurements, defaults to 500ms
  • USERMOD_BH1750_OFFSET_VALUE - the offset value to report on, defaults to 1
  • USERMOD_BH1750_FIRST_MEASUREMENT_AT - the number of milliseconds after boot to take first measurement, defaults to 10000 ms

In addition, the Usermod screen allows you to:

  • enable/disable the usermod
  • Enable Home Assistant Discovery of usermod
  • Configure the SCL/SDA pins

API

The following method is available to interact with the usermod from other code modules:

  • getIlluminance read the brightness from the sensor

Change Log

Jul 2022

  • Added Home Assistant Discovery
  • Implemented PinManager to register pins
  • Made pins configurable in usermod menu
  • Added API call to read luminance from other modules
  • Enhanced info-screen outputs
  • Updated readme.md