Patrick Schurig 2b2cb19276 Add openmeteo integration plugin (site + PV plane)
- Weather/solar current conditions from Open-Meteo (Meteo-France model)
- Satellite-observed GHI + clear-sky index (MTG)
- Per-plane GTI with geographic azimuth convention (180=South)
- Self-hosted ready via baseUrl/satelliteBaseUrl plugin settings
2026-05-30 12:19:25 +02:00

50 lines
2.2 KiB
Markdown

# OpenMeteo
This plugin allows to get current weather and solar irradiance data from [Open-Meteo](https://open-meteo.com), including plane-of-array irradiance (GTI) for photovoltaic surfaces and satellite-observed clear-sky data.
## Usage
The data is refreshed every 15 minutes automatically, and can also be refreshed manually.
A **site** is added by entering its latitude and longitude (no discovery). It provides the shared weather and solar data for the location, including a satellite-observed GHI and clear-sky index.
One or more **PV planes** can be added as children of a site. Each plane has its own tilt, azimuth and peak power, and reports the global tilted irradiance (GTI) for that orientation. Multiple orientations are handled by adding multiple planes.
> Note: the azimuth is entered in geographic convention (180 = South, 90 = East, 270 = West).
By default the plugin queries the public Open-Meteo API. For commercial deployments, the `Base URL` and `Base URL (satellite radiation)` plugin settings can be pointed to a self-hosted Open-Meteo instance (the public API is for non-commercial use only).
## Supported Things
* Open-Meteo site (interfaces: weather, daylightsensor)
* Weather condition
* Temperature (current, daily min and max)
* Humidity
* Pressure
* Wind speed and direction
* Cloudiness
* Snowfall
* Global, direct normal and diffuse irradiance (GHI / DNI / DHI)
* Terrestrial (top-of-atmosphere) radiation
* Daily shortwave radiation sum
* Satellite-observed GHI, clear-sky GHI and clear-sky index
* Sunrise and sunset time
* Daylight
* Open-Meteo PV plane
* Global tilted irradiance (GTI) for the configured tilt and azimuth
## Requirements
* Internet connection, or a reachable self-hosted Open-Meteo instance
* The package 'nymea-plugin-openmeteo' must be installed
* No API key is required. For commercial use, a self-hosted instance is required (the public Open-Meteo API is non-commercial only).
## More
Open-Meteo https://open-meteo.com
Weather data by Météo-France, satellite radiation by EUMETSAT, provided through Open-Meteo (CC-BY 4.0).
For the overall architecture (role of this plugin, conventions, license boundary), see the `etm-powersync-docs` repository.