WLED/usermods/Temperature
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
..
platformio_override.ini Async temperature usermod (#1178) 2020-09-13 19:26:27 +02:00
readme.md Spelling check by @wthomson (#2940) 2022-12-10 16:12:55 +01:00
usermod_temperature.h Fixes: 2022-06-05 10:16:56 +02:00
usermods_list.cpp Async temperature usermod (#1178) 2020-09-13 19:26:27 +02:00

readme.md

Temperature usermod

Based on the excellent QuinLED_Dig_Uno_Temp_MQTT usermod by srg74 and 400killer!
Reads an attached DS18B20 temperature sensor (as available on the QuinLED Dig-Uno)
Temperature is displayed in both the Info section of the web UI as well as published to the /temperature MQTT topic, if enabled.
May be expanded with support for different sensor types in the future.

If temperature sensor is not detected during boot, this usermod will be disabled.

Installation

Copy the example platformio_override.ini to the root directory. This file should be placed in the same directory as platformio.ini.

Define Your Options

  • USERMOD_DALLASTEMPERATURE - enables this user mod wled00/usermods_list.cpp
  • USERMOD_DALLASTEMPERATURE_FIRST_MEASUREMENT_AT - umber of milliseconds after boot to take first measurement, defaults to 20000 ms

All parameters can be configured at runtime via the Usermods settings page, including pin, temperature in degrees Celsius or Farenheit and measurement interval.

PlatformIO requirements

If you are using platformio_override.ini, you should be able to refresh the task list and see your custom task, for example env:d1_mini_usermod_dallas_temperature_C.

If you are not using platformio_override.ini, you might have to uncomment OneWire@~2.3.5 under [common] section in platformio.ini:

# platformio.ini
...
[platformio]
...
; default_envs = esp07
default_envs = d1_mini
...
[common]
...
lib_deps =
  ...
  #For Dallas sensor uncomment following line
  OneWire@~2.3.5
...

Change Log

2020-09-12

  • Changed to use async non-blocking implementation
  • Do not report erroneous low temperatures to MQTT
  • Disable plugin if temperature sensor not detected
  • Report the number of seconds until the first read in the info screen instead of sensor error 2021-04
  • Adaptation for runtime configuration.