Ha Knmi Save
Custom component that integrates KNMI weather service (via weerlive) in to Home Assistant
KNMI
KNMI custom component for Home Assistant.
Weather data provided by KNMI, https://weerlive.nl.
Installation
HACS installation
The most convenient method for installing this custom component is via HACS. Simply search for the name, and you should be able to locate and install it seamlessly.
Manual installation guide:
- Utilize your preferred tool to access the directory in your Home Assistant (HA) configuration, where you can locate the
configuration.yamlfile. - Should there be no existing
custom_componentsdirectory, you must create one. - Inside the newly created
custom_componentsdirectory, generate a new directory namedknmi. - Retrieve and download all files from the
custom_components/knmi/directory in this repository. - Place the downloaded files into the newly created
knmidirectory. - Restart Home Assistant.
Configuration is done in the UI
Within the HA user interface, navigate to "Configuration" -> "Integrations", click the "+" button, and search for "KNMI" to add the integration.
Known limitations
This integration is translated into English and Dutch, including entity names and attributes, the data (from the API) is only available in Dutch. Feel free to create a pull request with your language, see translations. Non-numerical values are only available in Dutch
Entities
This integration comes with multiple pre-built entities, most of which are initially deactivated. To enable additional entities, follow these steps:
- Navigate to "Configuration" -> "Integrations" -> "KNMI" in the Home Assistant interface.
- Click on the specific integration with "1 service" that you desire.
- Click on "X entities hidden", and a summary of all entities in this integration will be displayed.
- Choose the desired entity, click on the cogwheel icon, and access its settings.
- Toggle the "Enabled" switch to activate the entity.
- Click "Update" to save the changes. Repeat these steps for each entity you wish to enable.
After completing this process, the newly enabled entities will receive values during the next update.
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 | in millimeters |
| wind_bearing | |
| wind_speed | |
| wind_speed_bft | Not officially supported, but nice addition |
| solar_irradiance | Not officially supported, but nice addition |
Examples
Integration with entities, notice the hidden ones:
Weather cards (hourly and daily forecast):
Weather entity (with daily and hourly forecast tabs):
Sun entity:
Warning entity:
Collect logs
To activate the debug log necessary for issue reporting, follow these steps:
- Go to "Configuration" -> "Integrations" -> "KNMI" within the Home Assistant interface.
- On the left side, locate the "Enable debug logging" button and click on it.
- Once you collected enough information, Stop debug logging, this will download the log file as well.
- Share the log file in an issue.
Additionally, logging for this component can be enabled by configuring the logger in Home Assistant with the following steps:
logger:
default: warn
logs:
custom_components.knmi: debug
More info can be found on the Home Assistant logger integration page
Contributions are welcome!
If you want to contribute to this please read the Contribution guidelines
Open Source Agenda Badge
