FaserF / dwd-illuminance

Home Assistant DWD Illuminance Sensor

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

hacs_badge

Homeassistant DWD Illuminance Sensor

Estimates outdoor illuminance based on current weather conditions and time of day. At night the value is 10. From a little before sunrise to a little after the value is ramped up to whatever the current conditions indicate. The same happens around sunset, except the value is ramped down. Below is an example of what that might look like over a three day period.

The following sources of weather data are supported:

This Integration is based on https://github.com/pnbruckner/ha-illuminance and only a fork to support DWD (Deutscher Wetter Dienst). If you are using another weather provider, please be sure to use the integration from pnbrucker instead of this one. I will only support DWD, as pnbrucker wont merge my DWD Commits (pnbruckner#17).

You can also have my integration and pnbrucker's integration installed at the same time, as this integration was renamed.

Follow the installation instructions below. Then add the desired configuration. Here is an example of a typical configuration:

sensor:
  - platform: dwd_illuminance
    entity_id: weather.dwd_weather_home

Installation

Place a copy of:

__init__.py at <config>/custom_components/dwd_illuminance/__init__.py sensor.py at <config>/custom_components/dwd_illuminance/sensor.py manifest.json at <config>/custom_components/dwd_illuminance/manifest.json

where <config> is your Home Assistant configuration directory.

Or add this github repository to HACS to install it via HACS.

NOTE: Do not download the file by using the link above directly. Rather, click on it, then on the page that comes up use the Raw button.

Configuration variables

Modes of operation

Two modes are available: normal & simple. The desired mode is selected via the configuration.

More details can be found here

  • entity_id: Entity ID of entity that indicates current weather conditions. See examples below.
  • mode (Optional): Mode of operation. Choices are normal (default) which uses sun elevation, and simple which uses time of day.
  • name (Optional): Name of the sensor. Default is DWD Illuminance.
  • scan_interval (Optional): Polling interval. Only applies during ramp up period around sunrise and ramp down period around sunset. Minimum is 5 minutes. Default is 5 minutes.

Examples

Deutscher Wetterdienst

sensor:
  - platform: dwd_illuminance
    name: DeutscherWetterDienst Illuminance
    mode: normal
    entity_id: weather.dwd_weather_home

About

Home Assistant DWD Illuminance Sensor

License:The Unlicense


Languages

Language:Python 100.0%