diff --git a/source/_components/sensor.wunderground.markdown b/source/_components/sensor.wunderground.markdown index 143120840cd..82a5b352782 100644 --- a/source/_components/sensor.wunderground.markdown +++ b/source/_components/sensor.wunderground.markdown @@ -91,6 +91,9 @@ Configuration variables: - **precip_today_in**: Total precipitation in inches - **precip_today_metric**: Total precipitation in metric units - **precip_today_string**: Text summary of precipitation today + - **precip_1d_mm** [[1d]](#1d): Forecasted precipitation intensity in milimeters + - **precip_1d_in** [[1d]](#1d): Forecasted precipitation intensity in inches + - **precip_1d** [[1d]](#1d): Forecasted precipitation probability in % - **pressure_in**: Atmospheric air pressure in inches - **pressure_mb**: Atmospheric air pressure in millibars - **pressure_trend**: Atmospheric air presure trend signal (+/-) @@ -100,19 +103,137 @@ Configuration variables: - **temperature_string**: Temperature text combinding Fahrenheit and Celsius - **temp_c**: Current temperature in Celsius - **temp_f**: Current temperature in Fahrenheit + - **temp_high_record_c**: Maximum temperature meassured in Celsius + - **temp_high_record_f**: Maximum temperature meassured in Fahrenheit + - **temp_low_record_c**: Minimal temperature meassured in Celsius + - **temp_low_record_f**: Minimal temperature meassured in Fahrenheit + - **temp_high_avg_c**: Average high for today in Celsius + - **temp_high_avg_f**: Average high for today in Fahrenheit + - **temp_low_avg_c**: Average low for today in Celsius + - **temp_low_avg_f**: Average low for today in Fahrenheit + - **temp_high_1d_c** [[1d]](#1d): Forecasted high temperature in Celsius + - **temp_high_1d_f** [[1d]](#1d): Forecasted high temperature in Fahrenheit + - **temp_low_1d_c** [[1d]](#1d): Forecasted low temperature in Celsius + - **temp_low_1d_f** [[1d]](#1d): Forecasted low temperature in Fahrenheit - **UV**: Current levels of UV radiation. See [here](https://www.wunderground.com/resources/health/uvindex.asp) for explanation. - **visibility_km**: Average visibility in km - **visibility_mi**: Average visibility in miles - **weather**: A human-readable text summary with picture from Wunderground. + - **weather_1d** [[12h]](#12h): A human-readable weather forecast using imperial units. + - **weather_1d_metric** [[12h]](#12h): A human-readable weather forecast using metric units. + - **weather_1h** [[1h]](#1h): Weather conditions in 1 hour. (e.g. "Thunderstorm" etc.) - **wind_degrees**: Wind degrees - **wind_dir**: Wind direction - **wind_gust_kph**: Wind gusts speed in kph - **wind_gust_mph**: Wind gusts speed in mph + - **wind_gust_1d_kph** [[1d]](#1d): Max. forecasted Wind in kph + - **wind_gust_1d_mph** [[1d]](#1d): Max. forecasted Wind in mph - **wind_kph**: Current wind speed in kph - **wind_mph**: Current wind speed in mph + - **wind_1d_kph** [[1d]](#1d): Forecasted wind speed in kph + - **wind_1d_mph** [[1d]](#1d): Forecasted wind speed in mph - **wind_string**: Text summary of current wind conditions -All the conditions listed above will be updated each 5 minutes with exception of `alerts` that will be updated each 15 minutes by default. +All the conditions listed above will be updated every 5 minutes. + +### Forecasts + +_12 hour forecasts_ + +Monitored conditions marked above with [12h] are 12 hour +forecasts. To get a forecast for different period/daytime replace the +`_1d_` part of the sensor name. e.g. `weather_2n` will give you forecast for +tomorrow night. Valid values for day are `1` to `4` and +valid values for daytime are `d` or `n`. + +_Daily forecasts_ + +Conditions above marked with [1d] are daily forecasts. +To get forecast for different day, replace the number +in `_1d_` part of the sensor name. Valid values are from +`1` to `4`. + +_Hourly forecasts_ + +Conditions marked with [1h] are hourly forecasts. +To get forecast for different hour, replace the number +in the `_1h_` part of the sensor name with `1` to `36`. +E.g. `weather_24h` will give you weather in 24 hours. + +Additional examples: +==================== + +Daily forecast +-------------- + +```yaml +sensor: + - platform: wunderground + - api_key: your_api_key + monitored_conditions: + - weather_1d_metric + - weather_1n_metric + - weather_2d_metric + - weather_2n_metric + - weather_3d_metric + - weather_3n_metric + - weather_4d_metric + - weather_4n_metric + +group: + dialy_forecast: + name: Daily Forecast + entities: + - sensor.pws_weather_1d_metric + - sensor.pws_weather_1n_metric + - sensor.pws_weather_2d_metric + - sensor.pws_weather_2n_metric + - sensor.pws_weather_3d_metric + - sensor.pws_weather_3n_metric + - sensor.pws_weather_4d_metric + - sensor.pws_weather_4n_metric +``` + +![Daily Forecast](/images/screenshots/wunderground_daily_forecast.png) + +Weather overview +---------------- + +```yaml +sensor: + - platform: wunderground + - api_key: your_api_key + monitored_conditions: + - temp_high_record_c + - temp_high_1d_c + - temp_c + - temp_low_1d_c + - temp_low_record_c + - precip_1d + - precip_1d_mm + - wind_kph + - wind_1d_kph + - alerts + +group: + weather_overview: + name: Weather overview + entities: + - sensor.pws_weather_1d_metric + - sensor.pws_temp_high_record_c + - sensor.pws_temp_high_1d_c + - sensor.pws_temp_c + - sensor.pws_temp_low_1d_c + - sensor.pws_temp_low_record_c + - sensor.pws_precip_1d + - sensor.pws_precip_1d_mm + - sensor.pws_wind_kph + - sensor.pws_wind_1d_kph + - sensor.pws_alerts +``` + +![Weather overview](/images/screenshots/wunderground_weather_overview.png) +

Note: While the platform is called “wunderground” the sensors will show up in Home Assistant as “PWS” (eg: sensor.pws_weather). diff --git a/source/images/screenshots/wunderground_daily_forecast.png b/source/images/screenshots/wunderground_daily_forecast.png new file mode 100644 index 00000000000..52651410cfe Binary files /dev/null and b/source/images/screenshots/wunderground_daily_forecast.png differ diff --git a/source/images/screenshots/wunderground_weather_overview.png b/source/images/screenshots/wunderground_weather_overview.png new file mode 100644 index 00000000000..44462578224 Binary files /dev/null and b/source/images/screenshots/wunderground_weather_overview.png differ