30a029c19f
* BH1750 upgrades Moved the definitions into the main usermods_list.cpp instead of having a section to copy across. Added Home Assistant Discovery topic for light sensor. This is toggleable from the usermod menu. * Configure pin, other enhancements, readme Implemented pin manager Made pins configurable at runtime Improved info screen outputs Added F() around strings Updated readme * Resolve conflict * Merge branch 'main' * Missing comma Co-authored-by: Christian Schwinne <dev.aircoookie@gmail.com> Co-authored-by: Christian Schwinne <cschwinne@gmail.com> |
||
---|---|---|
.. | ||
readme.md | ||
usermod_bh1750.h |
BH1750 usermod
This usermod will read from an ambient light sensor like the BH1750 sensor.
The luminance is displayed both in 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
- This must be added under
lib_deps
in yourplatformio.ini
(orplatformio_override.ini
).
- Data is published over MQTT - make sure you've enabled the MQTT sync interface.
Compiliation
To enable, compile with USERMOD_BH1750
defined (e.g. in platformio_override.ini
)
[env:usermod_BH1750_d1_mini]
extends = env:d1_mini
build_flags =
${common.build_flags_esp8266}
-D USERMOD_BH1750
lib_deps =
${esp8266.lib_deps}
claws/BH1750 @ ^1.2.0
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 10000msUSERMOD_BH1750_MIN_MEASUREMENT_INTERVAL
- the min number of milliseconds between measurements, defaults to 500msUSERMOD_BH1750_OFFSET_VALUE
- the offset value to report on, defaults to 1USERMOD_BH1750_FIRST_MEASUREMENT_AT
- the number of milliseconds after boot to take first measurement, defaults to 10 seconds
In addition, on 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 illuminance from other modules
- Enhanced info-screen outputs
- Updated
readme.md