github golles/ha-knmi 2.0.0

latest releases: 2.1.0, 2.0.1
2 months ago

Release Notes

Before proceeding with the update, please review the comprehensive release notes, as there are breaking changes.

Version 2.0.0

Exciting news! Version 2.0.0 is here, featuring a collaboration with Weerlive, unleashing a new API with enhanced capabilities for all users. Thank you, Martijn!

New features:

  • Extended daily forecast: The weather entity now provides a 5-day daily forecast, up from the previous 3 days.
  • Hourly forecast: The weather entity is extended with hourly forecast for the upcoming 24 hours.
  • Entity names, attribute names and some states are now translated into English and Dutch and this can easily be extended into other languages.

Breaking changes:

To align with the latest developments:

  • Python Version: The component now utilizes Python 3.12, in line with HA 2024.2 release.
  • Deprecated forecast attribute: The deprecated forecast attribute in the weather entity has now been removed, as it won't be supported after 2024.3.
  • All the previous entities will be removed during the upgrade and new ones are being created, Entity name (and unique_id) and attributes are renamed so you need to update your dashboards, automations and scripts (I'm really really sorry about this!). Better unique id's are now created to prevent this in the future.

New entities:

In response to user feedback and the deprecation of the forecast attributes in HA, several new entities have been introduced. Most of these sensors are not enabled by default, allowing you to choose the ones you find valuable. The amount of sensors enabled doesn't impact the API limits.

Binary sensors

Name (EN) Name (NL) Attributes Notes
Sun Zon Sunrise, Sunset, Sun chance today, tomorrow and day after tomorrow Times of today, in UTC, frontend will convert this into your local time
Warning Waarschuwing Title, Description, Code, Next code, Next warning Code has its own entity, see Weather code below

Sensors

Normal sensors:

Name (EN) Name (NL) Attributes Notes
Dew point Dauwpunt Unit configurable
Solar irradiance Globale stralingsintensiteit
Wind chill Gevoelstemperatuur Unit configurable
Air pressure Luchtdruk Unit configurable
Humidity Luchtvochtigheid
Max temperature today Max temperatuur vandaag Unit configurable
Max temperature tomorrow Max temperatuur morgen Unit configurable
Min temperature today Min temperatuur vandaag Unit configurable
Min temperature tomorrow Min temperatuur morgen Unit configurable
Precipitation today Neerslag vandaag
Precipitation tomorrow Neerslag morgen
Description Omschrijving State is in Dutch
Temperature Temperatuur Unit configurable
Weather forecast Weersverwachting State is in Dutch
Wind speed Windsnelheid Bearing, Degree, Beaufort and Knots Unit configurable
Weather code Weercode Raw state is in Dutch
Visibility Zicht Unit configurable

Diagnostic sensors:

Name (EN) Name (NL) Notes
Location Plaats
Remaining API requests Resterende API verzoeken
Latest update Laatste update Server side update time

Weather

The weather entity contains all the weather information, ideal for displaying a comprehensive overview in the Home Assistant frontend. It includes both a daily forecast spanning up to 5 days and an hourly forecast covering up to 24 hours.

Daily forecast attributes:

Attribute Notes
datetime Times in UTC, frontend will convert this into your local time
condition
templow
temperature
precipitation_probability in a percentage
wind_bearing
wind_speed
wind_speed_bft Not officially supported, but nice addition
sun_chance Not officially supported, but nice addition

Hourly forecast attributes:

Attribute Notes
datetime Times in UTC, frontend will convert this into your local time
condition
temperature
precipitation_probability in millimeters
wind_bearing
wind_speed
wind_speed_bft Not officially supported, but nice addition
solar_irradiance Not officially supported, but nice addition

Thank you for your continued support and feedback!

What's Changed

  • Fix black formatting by @golles in #118
  • Bump codecov/codecov-action from 3 to 4 by @dependabot in #117
  • Update pip requirement from <23.4,>=21.0 to >=21.0,<24.1 by @dependabot in #116
  • Update Python to 3.12, devcontainer and make it possible to run HA in a Codespace by @golles in #119
  • Update to Weerlive API v2 by @golles in #120

Full Changelog: 1.7.1...2.0.0

Don't miss a new ha-knmi release

NewReleases is sending notifications on new releases.