Volets & Soleil Smart-Home-Integration, kostenlos und Open Source
Empfohlene Rollladenschließung pro Fassade nach dem Sonnenstand. Lokal, ohne Konto.
Veröffentlicht von guim31
- Geräte
- Version 1.0.0
- Erfordert Gladys >=5.1.0
- ★ 0
Für jede Fassade deines Hauses zeigt diese Integration, ob die Sonne darauf scheint und wie weit du die Rollläden schließen solltest, damit das Haus im Sommer kühl bleibt oder im Winter die Sonne hereinlässt. Alles wird lokal aus dem Sonnenstand berechnet: kein Konto, kein Internet, keine API.
Die Integration bewegt nie selbst einen Rollladen: Das machen deine Szenen, mit den Werten, die sie veröffentlicht.
Ohne an ein Test-Gladys angeschlossene Rollläden entwickelt: Rückmeldungen im Forum sind willkommen.
Was du bekommst
Ein Gerät pro Fassade, mit:
- Sonne auf der Fassade (ja / nein): Die Sonne steht über der Schwelle und vor der Wand;
- Empfohlene Schließung (0-100 %), unten erklärt;
- Direkte Sonneneinstrahlung (0-100 %): der Anteil der Sonnenkraft, der die Wand trifft,
100 × cos θ, unabhängig von der Jahreszeit; - Einfallswinkel der Sonne (°): 0°, wenn die Sonne der Wand gegenübersteht, 90° bei streifendem Licht oder wenn die Sonne nicht auf der Fassade ist;
- Nächste Ankunft der Sonne und Nächster Abgang der Sonne, in Ortszeit (
14:32,morgen 07:12), über die nächsten 48 Stunden.
Alles wird jede Minute neu berechnet; nur geänderte Werte werden an Gladys gesendet.
Die empfohlene Schließung. Mit θ dem Winkel zwischen den Sonnenstrahlen und der Fassade und h der
Sonnenhöhe:
Schließung = 100 × cos θ × min(1, h / 15°), auf 10 % gerundet.
Eine Westfassade um 19 Uhr im Juli (Sonne tief und frontal) bekommt 90 %; eine Südfassade mittags (Sonne hoch, Strahlen fast parallel zur Wand) 40 %; der zweite Faktor dämpft die ersten Minuten einer tiefen, noch schwachen Sonne. Im Winter ist die Empfehlung immer 0 %: offen, damit die Sonne das Haus wärmt. Die 10-%-Stufen verhindern, dass sich die Rollläden jede Minute bewegen.
Konfiguration
- Standort: die Koordinaten deines Hauses in Gladys (Einstellungen → Häuser). Die Integration bittet bei der Installation um die Erlaubnis, sie zu lesen. Ohne sie zeigt sie einen Fehler und prüft alle 10 Minuten erneut.
- Sprache der Namen und Texte: die Sprache der Gerätenamen und der an Gladys gesendeten Texte.
- Jahreszeit: Automatisch (Monate) folgt den gewählten Sommermonaten (ein Bereich über den Jahreswechsel funktioniert, für die Südhalbkugel); Immer Sommer oder Immer Winter. Die Integration kann dein Thermometer nicht selbst lesen: Um der Außentemperatur zu folgen, nutze die Szenenaktion Jahreszeit erzwingen (siehe unten).
- Mindesthöhe der Sonne: Unter dieser Höhe über dem Horizont wird die Sonne ignoriert (standardmäßig 5°).
- Fassaden 1 bis 6: Trage die Ausrichtung jeder Fassade ein, die Richtung, in die ihre Fenster blicken:
Grad ab Norden im Uhrzeigersinn (90 = Ost, 180 = Süd, 270 = West) oder eine Himmelsrichtung in englischen
Buchstaben (N, NE, E, SE, S, SW, W, NW sowie NNE, ENE…). Achtung:
Owird als Westen gelesen (französisch und spanisch), für Osten alsoEoder 90 eingeben. Eine leere Ausrichtung ignoriert den Platz. Optional:- Name: der Gerätename (sonst „Fassade S“);
- Sichtfeld: 180° für eine flache Wand, weniger, wenn tiefe Fensterlaibungen oder Seitenwände die Sonne früher verdecken;
- Horizontmaske: die Höhe, die ein Hügel, ein Gebäude oder ein Balkon vor der Fassade verdeckt.
Tipp: Eine Kartenanwendung zeigt die Ausrichtung deiner Wände; eine Süd-Südwest-Fassade hat etwa 200°.
Aktionen
- Empfehlung jetzt anzeigen: die geltende Jahreszeit und die Empfehlung jeder Fassade, um die Ausrichtungen zu prüfen.
Szenen
Auslöser „Sonne erreicht eine Fassade“: Wähle die Fassade und den Zeitpunkt: bei Ankunft, 15 Min., 30 Min.
oder 1 Stunde vorher. Variablen: die Fassade, die Ankunftszeit, die Minuten vor Ankunft, die höchste
empfohlene Schließung der kommenden Sonnenperiode und die Jahreszeit (summer oder winter).
Beispiele:
- Wohnzimmer-Rollläden vor der Sonne senken: Auslöser „Sonne erreicht eine Fassade“, Wohnzimmer, 30 Min.
vorher → Bedingung: Die Variable Jahreszeit ist
summer→ Rollladenposition setzen. - Weiter schließen, wenn sie stark brennt: Auslöser auf die Empfohlene Schließung des Fassadengeräts über 70 % → Rollladenposition auf 30 % setzen (in Gladys zählt die Position eines Rollladens die Öffnung).
- Wieder öffnen, wenn die Sonne geht: Auslöser auf Sonne auf der Fassade, die auf „nein“ wechselt → Rollläden öffnen.
Aktion „Jahreszeit erzwingen“: Sommer, Winter oder zurück zur Konfiguration. Zum Beispiel eine Szene „jeden Tag um 10 Uhr, wenn die Außentemperatur über 25 °C liegt → Jahreszeit erzwingen: Sommer“. Die Wahl bleibt nach einem Neustart erhalten. Ausgabe: die geltende Jahreszeit.
Dashboard
Das Widget Sonne auf den Fassaden listet jede Fassade mit ihrer empfohlenen Schließung und der nächsten Sonnenzeit, die geltende Jahreszeit und drei Tasten, um die Jahreszeit zu erzwingen (die aktive trägt ein Häkchen). Seine Einstellungen blenden die Jahreszeit-Zeile oder die Tasten aus.
Grenzen und Fehlerbehebung
- „Kein Hausstandort“: Trage die Koordinaten des Hauses unter Einstellungen → Häuser ein; das erste Haus mit Koordinaten wird verwendet.
- „Unlesbare Fassadenausrichtung“: Korrigiere die Ausrichtung der in der Meldung genannten Plätze (Grad oder Himmelsrichtungen).
- Das Modell ist geometrisch: keine Wolken, kein Wetter. Bäume und Nachbarn werden durch die Mindesthöhe und die Horizontmaske angenähert.
- Die Zeiten folgen der Zeitzone von Gladys. Eine Sonnenperiode unter 5 Minuten kann übersehen werden.
- Protokolle: Der Container schreibt nur seinen Lebenszyklus;
LOG_LEVEL=debugzeigt jede Berechnung.
Konfigurationseinstellungen
Diese Einstellungen fragt Volets & Soleil in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| So funktioniert es | section | Nein | Der Sonnenstand wird lokal aus dem Standort deines Hauses in Gladys berechnet. Beschreibe unten jede Fassade: ein Gerät pro Fassade, mit der empfohlenen Schließung der Rollläden. |
| Sprache der Namen und Texte | select | Nein | |
| Jahreszeit | select | Nein | Sommer: schließen, damit das Haus kühl bleibt. Winter: immer 0 %, um die Sonne hereinzulassen. Automatisch: Sommer in den Monaten unten. Eine Szene oder das Widget kann die Jahreszeit erzwingen. |
| Sommer beginnt im | select | Nein | |
| Sommer endet nach | select | Nein | |
| Mindesthöhe der Sonne (°) | number | Nein | Unter dieser Höhe über dem Horizont wird die Sonne ignoriert (Bäume, Nachbarn). |
| Fassade 1 | section | Nein | Lass die Ausrichtung leer, um eine Fassade zu ignorieren. Ausrichtung: Grad ab Norden im Uhrzeigersinn (90 = Ost, 180 = Süd, 270 = West) oder N, NE, E, SE, S, SW, W, NW. |
| Ausrichtung | string | Nein | |
| Name (optional) | string | Nein | |
| Sichtfeld (°) | number | Nein | Breite des Himmels, den die Fenster sehen: 180 für eine flache Wand, weniger bei tiefen Fensterlaibungen oder Seitenwänden. |
| Horizontmaske (°) | number | Nein | Sonnenhöhe, die ein Hügel, ein Gebäude oder ein Balkon vor dieser Fassade verdeckt, 0 wenn frei. |
| Fassade 2 | section | Nein | |
| Ausrichtung | string | Nein | |
| Name (optional) | string | Nein | |
| Sichtfeld (°) | number | Nein | |
| Horizontmaske (°) | number | Nein | |
| Fassade 3 | section | Nein | |
| Ausrichtung | string | Nein | |
| Name (optional) | string | Nein | |
| Sichtfeld (°) | number | Nein | |
| Horizontmaske (°) | number | Nein | |
| Fassade 4 | section | Nein | |
| Ausrichtung | string | Nein | |
| Name (optional) | string | Nein | |
| Sichtfeld (°) | number | Nein | |
| Horizontmaske (°) | number | Nein | |
| Fassade 5 | section | Nein | |
| Ausrichtung | string | Nein | |
| Name (optional) | string | Nein | |
| Sichtfeld (°) | number | Nein | |
| Horizontmaske (°) | number | Nein | |
| Fassade 6 | section | Nein | |
| Ausrichtung | string | Nein | |
| Name (optional) | string | Nein | |
| Sichtfeld (°) | number | Nein | |
| Horizontmaske (°) | number | Nein |
So installierst du Volets & Soleil in Gladys
- Öffne in Gladys Integrationen: Volets & Soleil erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-volets-soleil:1.0.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-volets-soleil.
Volets & Soleil benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
Volets & Soleil ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von guim31 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation