Hydro-Québec Peaks Smart-Home-Integration, kostenlos und Open Source
Winterspitzen von Hydro-Québec: Vorheizen, Beginn und Ende jeder Spitze in deinen Szenen.
Veröffentlicht von prohand
- Geräte
- Version 1.0.1
- Erfordert Gladys >=5.3.0
- ★ 0
Diese Integration bringt die Winterspitzen-Ereignisse von Hydro-Québec in Gladys: die Stunden, einige Stunden oder einen Tag im Voraus angekündigt, in denen Kunden mit einem Spitzen-Angebot gebeten werden, weniger Strom zu verbrauchen. Gladys kann dann das Haus vorheizen, während der Spitze Last abwerfen und danach alles zurückstellen — von selbst.
Inoffizielle Integration, nicht mit Hydro-Québec verbunden. Sie liest die öffentlichen Daten, die Hydro-Québec veröffentlicht (offene Daten, Lizenz CC BY-NC 4.0).
Bevor du beginnst
Gladys 5.3 oder neuer ist erforderlich. Du brauchst kein Hydro-Québec-Konto, keine Kundennummer und keinen Schlüssel: Die Spitzenereignisse sind öffentlich.
Du musst nur wissen, bei welchem Angebot du angemeldet bist. Es steht auf deiner Rechnung und in deinem Kundenbereich:
| Angebot | Code | Für |
|---|---|---|
| Tarif D mit Winter-Gutschrift-Option | CPC-D | Privatkunden |
| Tarif Flex D | TPC-DPC | Privatkunden |
| Winter-Gutschrift-Option, Geschäftskunden | CPC-G | Geschäftskunden |
| Tarif Flex G, Geschäftskunden | TPC-GPC | Geschäftskunden |
| Lastmanagement, Geschäftskunden | GDP-Affaires | Geschäftskunden |
| OEA, Geschäftskunden | OEA | Geschäftskunden |
Hydro-Québec veröffentlicht Spitzen im Winter (in der Regel Dezember bis März). Außerhalb dieser Zeit zeigen die Geräte einfach an, dass keine Spitze angekündigt ist.
Konfiguration
| Feld | Was eintragen |
|---|---|
| Verfolgte Angebote | Kreuze dein Angebot an. Pro angekreuztem Angebot wird ein Gerät erstellt. |
| Weitere Angebote | Angebote, die in der Liste fehlen, mit ihrem Code, durch Kommas getrennt (z. B. ENG_100H_2F_7J). |
| Vorlauf des Vorheizens | Wie viele Minuten vor einer Spitze sich das Vorheizfenster öffnet. Hydro-Québec empfiehlt etwa zwei Stunden (120). 0 schaltet es aus. |
| Aktualisierungsintervall | Wie oft die Daten von Hydro-Québec neu gelesen werden, in Sekunden (900 = 15 Minuten, mindestens 300). |
Öffne dann Entdecken in der Integration und erstelle das Gerät deines Angebots.
Die Schaltfläche Angebote auflisten nennt alle Angebotscodes, die Hydro-Québec in dieser Saison veröffentlicht, bereit zum Kopieren in Weitere Angebote. Verbindung testen liest die Daten sofort und zeigt für jedes verfolgte Angebot, wie viele Spitzen angekündigt sind und welche als Nächstes kommt.
Das Gerät eines Angebots
Jedes Angebot wird zu einem Gerät namens Hydro-Québec <Code> mit diesen
schreibgeschützten Funktionen:
| Funktion | Werte |
|---|---|
| Spitze läuft | 1 während einer Spitze, sonst 0 |
| Vorheizfenster | 1 während des Vorlaufs vor einer Spitze, sonst 0 |
| Spitze heute Morgen | 1, wenn heute eine Morgenspitze (AM) angekündigt ist |
| Spitze heute Abend | 1, wenn heute eine Abendspitze (PM) angekündigt ist |
| Spitze morgen früh | dasselbe, morgen |
| Spitze morgen Abend | dasselbe, morgen |
| Minuten bis zur nächsten Spitze | Minuten bis zum Beginn der nächsten Spitze; 0 während einer Spitze, -1, wenn keine angekündigt ist |
| Nächste Spitze | die laufende oder nächste Spitze, z. B. 2026-12-15 06:00–09:00, —, wenn keine |
Alle Zeiten sind Ortszeit Québec, unabhängig von der Zeitzone deines Gladys-Servers. Eine Spitze läuft von ihrem Beginn bis zu ihrem Ende: Um 09:00 Uhr ist die Spitze von 06:00 bis 09:00 Uhr vorbei.
Die Anzeigen wechseln auf die Minute genau: Die Integration bewertet sie jede Minute anhand der bereits vorhandenen Daten neu und liest die Daten von Hydro-Québec im Aktualisierungsintervall neu.
Szenen und Dashboard (Gladys 5.1+)
Szenen-Auslöser
| Auslöser | Wann |
|---|---|
| Eine Spitze wird angekündigt | Hydro-Québec hat eine neue Spitze für das Angebot veröffentlicht |
| Das Vorheizfenster öffnet sich | der Vorlauf vor einer Spitze beginnt |
| Eine Spitze beginnt | zu Beginn der Spitze |
| Eine Spitze endet | am Ende der Spitze |
Jeder Auslöser kann auf ein Angebot (sein Gerät) und auf die Morgen-
(AM) oder Abendspitzen (PM) beschränkt werden. In den folgenden Aktionen
liefert das Ereignis: offer (den Code), start und end (Ortszeit Québec,
JJJJ-MM-TT HH:MM), duration_minutes — und beim Vorheizen
lead_minutes. Zum Beispiel eine Benachrichtigung:
Spitze von {{triggerEvent.data.start}} bis {{triggerEvent.data.end}}.
Jeder Auslöser feuert einmal pro Spitze, auch nach einem Neustart der Integration. Zwei Regeln:
- Spitzen, die bereits veröffentlicht waren, als du die Integration installiert (oder ein neues Angebot angekreuzt) hast, werden nicht „angekündigt" — nur die danach veröffentlichten;
- war die Integration beim Beginn einer Spitze gestoppt, gibt sie nicht mehr als 10 Minuten zu spät vor, die Spitze habe „gerade begonnen". Das Ende einer Spitze, deren Beginn gemeldet wurde, wird immer gemeldet, auch verspätet: Die Szene, die die Heizung zurückstellt, läuft immer.
Szenen-Aktion
Hydro-Québec-Spitzen jetzt lesen liest die Daten sofort und gibt den
folgenden Aktionen: peak_in_progress, preheat_in_progress,
next_peak_start und minutes_until_next_peak (für das gewählte Angebot oder
das erste verfolgte). Praktisch in einer Szene, die durch etwas anderes
gestartet wird — „wenn ich nach Hause komme und keine Spitze läuft, Heizung
hoch".
Beispielszenen
- Vorheizen: Auslöser Das Vorheizfenster öffnet sich → Thermostate um 1 bis 2 °C erhöhen, Warmwasserspeicher aufheizen.
- Während der Spitze: Auslöser Eine Spitze beginnt → Thermostate senken, Warmwasserspeicher ausschalten, Ladestation pausieren.
- Nach der Spitze: Auslöser Eine Spitze endet → Sollwerte zurücksetzen, Warmwasserspeicher und Ladestation wieder einschalten.
- Den Haushalt warnen: Auslöser Eine Spitze wird angekündigt → Nachricht senden „Spitze morgen {{triggerEvent.data.start}}: Trockner vermeiden".
Das Widget „Hydro-Québec-Spitzen"
Füge es einem Dashboard hinzu: ein Countdown bis zur nächsten Spitze (oder bis zum Ende der laufenden), die nächsten angekündigten Spitzen — ihre Anzahl ist eine Einstellung des Widgets —, der Zustand jedes verfolgten Angebots, eine Schaltfläche Aktualisieren und ein Link zu den offenen Daten.
Gut zu wissen
- Die Daten stammen aus den offenen Daten von Hydro-Québec und werden etwa alle 15 Minuten mit einer bedingten Anfrage gelesen: Hat sich nichts geändert, wird nichts heruntergeladen.
- Hydro-Québec veröffentlicht eine Spitze manchmal nur wenige Stunden vorher. Wird eine Spitze innerhalb ihres Vorheizfensters veröffentlicht, feuert der Vorheiz-Auslöser sofort.
- Die Integration führt ein kleines Gedächtnis in ihrem Volume
/data(die bereits angekündigten Spitzen). Löschen bedeutet nur, dass der nächste Start die bereits veröffentlichten Spitzen nicht ankündigt. - Sie kennt weder deinen Verbrauch noch deine Gutschriften: Diese bleiben in deinem Hydro-Québec-Kundenbereich.
Fehlerbehebung
- Der Konfigurationsbildschirm verlangt, ein Angebot zu wählen: Kreuze mindestens ein Angebot an oder trage eines in Weitere Angebote ein.
- „Hydro-Québec in dieser Saison unbekannt" unter Verbindung testen: Der eingetragene Code ist nicht im Feed — prüfe ihn mit Angebote auflisten.
- Den ganzen Winter keine Spitze: Prüfe das Angebot; außerhalb des Winters ist keine Spitze normal.
- „Offene Daten von Hydro-Québec nicht erreichbar": Dein Gladys erreicht
donnees.solutions.hydroquebec.comnicht (DNS, Firewall). Die Integration behält die zuletzt gelesenen Daten und versucht es in jedem Intervall erneut.
Konfigurationseinstellungen
Diese Einstellungen fragt Hydro-Québec Peaks in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Erste Schritte | section | Nein | Diese Integration liest die Winterspitzen-Ereignisse, die Hydro-Québec als offene Daten veröffentlicht: kein Konto, kein Schlüssel. Kreuze das Angebot an, bei dem du angemeldet bist (es steht auf deiner Rechnung und in deinem Kundenbereich): Jedes Angebot wird zu einem Gerät mit seinen Spitzen-Anzeigen, dazu Szenen-Auslöser für die Ankündigung, das Vorheizfenster, den Beginn und das Ende jeder Spitze. Inoffizielle Integration, nicht mit Hydro-Québec verbunden. |
| Verfolgte Angebote | multi_select | Nein | Die Spitzen-Angebote, bei denen du angemeldet bist. Ein Gerät pro Angebot. |
| Weitere Angebote | string | Nein | Angebote, die in der Liste oben fehlen, mit ihrem Code, durch Kommas getrennt (die Schaltfläche „Angebote auflisten“ nennt sie alle). |
| Vorlauf des Vorheizens (Minuten) | number | Nein | Wie lange vor einer Spitze sich das Vorheizfenster öffnet. Hydro-Québec empfiehlt etwa zwei Stunden. 0 schaltet das Vorheizen aus. |
| Aktualisierungsintervall (s) | number | Nein | Wie oft die Daten von Hydro-Québec neu gelesen werden, in Sekunden. Spitzen werden Stunden im Voraus veröffentlicht: 15 Minuten genügen. Die Anzeigen selbst wechseln auf die Minute genau. |
So installierst du Hydro-Québec Peaks in Gladys
- Öffne in Gladys Integrationen: Hydro-Québec Peaks erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/prohand/gladys-hydroquebec-peak:1.0.1) 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/prohand/gladys-hydroquebec-peak.
Hydro-Québec Peaks benötigt Gladys >=5.3.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
Hydro-Québec Peaks 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 prohand 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