Integración domótica Forecast.Solar, gratuita y de código abierto
Solar production forecast for your PV panels: power now, energy today and tomorrow.
Publicado por prohand
- Dispositivos
- Versión 1.0.1
- Requiere Gladys >=5.1.0
- ★ 0
La documentación de esta integración la escribe su autor y, por ahora, solo está disponible en inglés.
This integration shows in Gladys the production forecast of your solar panels, computed by the free Forecast.Solar service from the weather forecast.
Requires Gladys 5.1.0 or later.
Houses
The location comes from the houses configured in Gladys (Settings > Houses): at install time, Gladys asks you to allow access to the location of the houses.
- Each located house shows up as a device in the Discovery tab.
- Add only the houses that have solar panels: only those are queried (no request wasted).
- A house without location does not show up: set its location in Gladys, then run a discovery again.
What you get
For each added house, one Solar forecast device with 4 sensors:
| Sensor | Unit | Content |
|---|---|---|
| Estimated power now | W | Estimated power right now |
| Estimated energy today | kWh | Estimated production for the whole day |
| Estimated energy remaining today | kWh | Estimated production until the end of day |
| Estimated energy tomorrow | kWh | Estimated production for tomorrow |
These are forecasts, not measurements: they are not counted in the Gladys energy monitoring.
Configuration
- Open the Configuration tab of the integration.
- Describe your panels:
- Tilt: 0° = flat, 90° = vertical (often 30 to 35° on a roof);
- Orientation: 0° = south, -90° = east, 90° = west, 180° = north;
- Peak power in Wp, whole number (e.g. 3000 for 3 kWp; written on your contract or inverter).
- The API key is optional: leave it empty for the free plan.
- Save, then add the device of your house from the Discovery tab.
These settings apply to every added house.
The Refresh the forecast now button downloads the forecast right away and shows a summary for today and tomorrow.
Dashboard widgets
| Widget | Content |
|---|---|
| Solar forecast | Power now, energy today / remaining / tomorrow, power curve, peak |
| Best solar time slot | Best moment to run an appliance of N hours, today and tomorrow |
In the widget, choose the device (the house) and, for the best slot, the appliance duration (washing machine 2 h, dishwasher 3 h…).
Scenes
Triggers
| Trigger | When |
|---|---|
| Solar forecast updated | Each time a new forecast is downloaded |
| Solar production starts | Estimated start of production (sunrise) |
| Solar production peak | Estimated production peak of the day |
| Solar production ends | Estimated end of production (sunset) |
Optional filter on the house (empty = any). Variables available to the next actions: house, power now, energy today, remaining, tomorrow, peak power and time.
For a threshold ("if tomorrow > 10 kWh"), use the standard Gladys "device value" trigger on the "Estimated energy tomorrow" sensor.
Actions
| Action | Parameters | Results |
|---|---|---|
| Read the solar forecast | house | power, energy today / remaining / tomorrow, peak |
| Solar production in the next hours | house, hours | energy (kWh), average and maximum power (W) |
| Find the best solar time slot | house, duration, day | found, start / end time, energy, minutes until the start |
Example: every morning at 8 a.m., "Find the best solar time slot" (2 h, today), then wait "minutes until the start" and start the washing machine.
How it works
- The forecast is downloaded every 60 minutes by default (15 to 1440 minutes), per added house.
- Between two downloads, the values are recomputed and published every 5 minutes (the power follows the sun curve).
- The free plan allows 12 requests per hour per IP address. On an error or when the limit is reached, the integration retries 15 minutes later and keeps the last known forecast.
- Houses are read again at every start, every discovery and every hour.
- One plane of panels per house. For an east/west installation, enter the orientation and peak power of the main plane.
Troubleshooting
- "Configuration incomplete or invalid": a required field is empty or out of range (the field name is given).
- "No house with a location": set the location of a house in Settings > Houses.
- "Forecast.Solar request limit reached": too many requests from your IP address. Raise the refresh interval.
- For details, read the integration logs from Gladys (or
docker logson the host) withLOG_LEVEL=debug.
Parámetros de configuración
Estos son los parámetros que Forecast.Solar te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Getting started | section | No | The forecast uses the location of your houses in Gladys (Settings > Houses): one device per located house, add only the ones with solar panels. Then describe the panels below. Free plan: no account, 12 requests per hour. |
| Tilt (°) | number | Sí | Angle of the panels: 0 = flat, 90 = vertical. |
| Orientation (°) | number | Sí | Direction the panels face: 0 = south, -90 = east, 90 = west, 180 = north. |
| Peak power (Wp) | number | Sí | Installed peak power of the panels, in watt-peak (whole number), e.g. 3000 for 3 kWp or 6200 for 6.2 kWp. |
| API key (optional) | secret | No | Leave empty for the free plan. |
| Forecast refresh interval (min) | number | No | How often the forecast is downloaded again. The values shown in Gladys are still updated every 5 minutes. |
Cómo instalar Forecast.Solar en Gladys
- En Gladys, abre Integraciones: Forecast.Solar aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/prohand/gladys-forecastsolar:1.2.0), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/prohand/gladys-forecastsolar.
Forecast.Solar requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.
¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.
Sobre las integraciones externas
Forecast.Solar es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene prohand, no el equipo principal de Gladys.
- Explorar todas las integraciones externas
- Descubrir las integraciones nativas incluidas en Gladys
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación