2020-05-28 00:20:02 +00:00
# Temperature usermod
2020-06-22 10:30:31 +00:00
Based on the excellent `QuinLED_Dig_Uno_Temp_MQTT` by srg74 and 400killer!
2020-05-28 00:20:02 +00:00
This usermod will read from an attached DS18B20 temperature sensor (as available on the QuinLED Dig-Uno)
The temperature is displayed both in the Info section of the web UI as well as published to the `/temperature` MQTT topic if enabled.
2021-05-17 10:52:27 +00:00
This usermod may be expanded with support for different sensor types in the future.
2020-05-28 00:20:02 +00:00
2020-09-13 17:26:27 +00:00
If temperature sensor is not detected during boot, this usermod will be disabled.
2020-05-28 00:20:02 +00:00
## Installation
2020-09-13 17:26:27 +00:00
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` - define this to have this user mod included wled00\usermods_list.cpp
* `USERMOD_DALLASTEMPERATURE_FIRST_MEASUREMENT_AT` - the number of milliseconds after boot to take first measurement, defaults to 20 seconds
2020-05-28 00:20:02 +00:00
2021-05-17 10:52:27 +00:00
All parameters can be configured at runtime using Usermods settings page, including pin, selection to display temerature in degrees Celsius or Farenheit mand measurement interval.
2021-05-07 10:41:39 +00:00
2020-05-28 00:20:02 +00:00
## Project link
* [QuinLED-Dig-Uno ](https://quinled.info/2018/09/15/quinled-dig-uno/ ) - Project link
2021-05-17 10:52:27 +00:00
* [Srg74-WLED-Wemos-shield ](https://github.com/srg74/WLED-wemos-shield ) - another great DIY WLED board
2020-05-28 00:20:02 +00:00
### PlatformIO requirements
2020-09-13 17:26:27 +00:00
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` .
2021-05-17 10:52:27 +00:00
If you are not using `platformio_override.ini` , you might have to uncomment `OneWire@~2.3.5 under` `[common]` section in `platformio.ini` :
2020-05-28 00:20:02 +00:00
```ini
# platformio.ini
...
[platformio]
...
; default_envs = esp07
default_envs = d1_mini
...
[common]
...
2021-03-30 09:45:48 +00:00
lib_deps =
2020-05-28 00:20:02 +00:00
...
2021-05-07 10:41:39 +00:00
#For Dallas sensor uncomment following line
2020-05-28 00:20:02 +00:00
OneWire@~2.3.5
...
```
2020-09-13 17:26:27 +00:00
## Change Log
2020-09-12
* Changed to use async, non-blocking implementation
* Do not report low temperatures that indicate an error to mqtt
* Disable plugin if temperature sensor not detected
2021-03-30 09:45:48 +00:00
* Report the number of seconds until the first read in the info screen instead of sensor error
2021-05-07 10:41:39 +00:00
2021-04
* Adaptation for runtime configuration.
