Externe Integration - Netatmo

Entwicklung
1

:sun_behind_rain_cloud: Netatmo (externe Integration) — Vorstellung + Zusammenfassung bis zur v1.3.0

Hallo zusammen :waving_hand:

Ich habe festgestellt, dass ich nie ein eigenes Thema zur externen Integration Netatmo eröffnet habe, obwohl sie seit diesem Sommer existiert (v1.0.0 am 21. Juli 2026, verfügbar für alle seit dem Erscheinen der externen Integrationen mit Gladys 4.84). Ich hole das nach: Hier ist eine vollständige Vorstellung und die Zusammenfassung der Versionen bis zur v1.3.0, die gerade veröffentlicht wurde. Dieses Thema wird anschließend für die Ankündigung von Neuerungen und zur Sammlung eures Feedbacks dienen.

:puzzle_piece: Was ist das?

Es handelt sich um die „externe Integration“-Version des Netatmo-Dienstes von Gladys: Sie läuft in ihrem eigenen Container, wird aus dem Integrationskatalog installiert, und hier kommen nun die Netatmo-Neuerungen an (Kameras, Sicherheitszubehör, Echtzeit…).

:sparkles: Unterstützte Funktionen

  • Wetter: Station (NAMain) und Außenmodule, Wind, Regen und Innenräume (Temperatur, Min/Max, Luftfeuchtigkeit, CO2, Lärm, Druck, Wind, Böen, Regen…).
  • Energie: Thermostat (NATherm1), Relais (NAPlug) und Ventile (NRV), mit veränderbarem Sollwert von Gladys aus (in 0,5 °C-Schritten).
  • Kameras Innenraum (NACamera) und Außenkamera Presence (NOC): Bild auf dem Dashboard (wird priorisiert lokal abgerufen), Überwachungsschalter, Live-Stream mit der gewünschten Qualität.
  • Sicherheitszubehör: Tür-/Fenstersensor (NACamDoorTag), Innensirene (NIS), Rauchmelder (NSD).
  • Batterie und Signal jedes Moduls und ein Badge „nicht erreichbar“, wenn Netatmo ein offline-Modul meldet (Gladys hört dann auf, dessen letzte Werte zu veröffentlichen).
  • Echtzeit mit Gladys Plus (optional): Mit Ihrem Open-API-Schlüssel werden Änderungen in 2-3 Sekunden statt 2 Minuten übertragen, und Sie erhalten Szenenauslöser: Bewegung, erfasste Person, Tier und Fahrzeug (Presence), Rauch.

:rocket: Installation

  1. Erstellen Sie Ihre eigene Anwendung auf Netatmo Connect, um eine Client-ID und ein Client-Geheimnis zu erhalten (kein Scope oder Redirect-URL zu konfigurieren).
  2. In Gladys: Integrationen → suchen Sie nach Netatmo → Installieren.
  3. Registerkarte Konfiguration: Fügen Sie die Client-ID/Geheimnis ein, Speichern, dann Verbinden.
  4. Wählen Sie die Gerätefamilien (Energie, Wetter, Sicherheit) aus, speichern Sie und erstellen Sie Ihre Geräte über Entdeckung.

Die vollständige Schritt-für-Schritt-Anleitung finden Sie in der Dokumentation der Integration (Link „Dokumentation“ auf dem Konfigurationsbildschirm).

:scroll: Versionszusammenfassung

  • v1.0.0 (21. Juli): OAuth2-Anmeldung, Wetter- und Energiegeräte, Thermostat-Sollwert, Kameras (Bild, Überwachung, Live-Stream).
  • v1.0.1: Stabilisierung (Wiederherstellung nach Netatmo-Ausfall, Zeitlimits, Token), Einstellung der Videoqualität, keine falschen Werte für offline-Module.
  • v1.1.0: Gladys-Plus-Webhooks (Echtzeit), Tür-/Fenstersensor, Sirene und Rauchmelder, Dokumentation FR/EN.
  • v1.1.2: Zu schwere Kamerabilder werden verkleinert statt ignoriert.
  • v1.2.0: Echtzeit-Erkennungen (Bewegung, Person, Tier, Fahrzeug, Rauch) nutzbar in Szenen.
  • v1.3.0 (16. Oktober):
    • Tag Cloud und Einordnung in die Kategorien Klimat, Sicherheit und Umgebung des Katalogs;
    • die gesamte Integration auf Französisch, Englisch, Deutsch und Spanisch (Konfiguration, Nachrichten, Dokumentation);
    • technische Aktualisierung (SDK, Release-Tooling, Versionshinweise auf GitHub).

:warning: Voraussetzungen

  • Gladys ≥ 4.86.0 für die v1.3.0.
  • Eine Netatmo-Connect-Anwendung auf Ihren Namen (kostenlos).
  • Gladys Plus nur, wenn Sie Echtzeit und Erkennungen wünschen.

:counterclockwise_arrows_button: Kommen Sie vom integrierten Netatmo-Dienst? Behalten Sie Ihre Historie!

Die Geräte der externen Integration haben neue Kennungen (ext:netatmo:*) und werden wie neue Geräte erstellt, aber seit Gladys 4.84.1 können Sie jedes alte Gerät zu seinem Ersatz migrieren: Die Historie, Szenen und Dashboards bleiben erhalten.

Bevor Sie beginnen: Löschen Sie Ihre alten Netatmo-Geräte nicht (die Migration startet mit ihnen), und migrieren Sie kurz nachdem Sie die neuen erstellt haben (wenn beide Werte für denselben Zeitraum aufgezeichnet haben, wird nur die Historie vor dem ersten Wert des neuen Geräts übernommen, um nichts doppelt zu zählen).

  1. Installieren Sie die externe Integration, verbinden Sie sie und erstellen Sie Ihre Geräte über das Register Entdeckung.
  2. Öffnen Sie Integrationen → Netatmo (die integrierte Integration, als veraltet gekennzeichnet) → Register Geräte.
  3. Klicken Sie auf einem alten Gerät auf Migrieren.
  4. Wählen Sie das Zielgerät (das neue Gerät unter der externen Netatmo-Integration).
  5. Überprüfen Sie die Funktionszuordnung: Sie ist vorgefüllt, passen Sie sie bei Bedarf an (insbesondere die Temperaturzeilen der Thermostate und Stationen). „Nicht migrieren“ löscht die Historie der betroffenen Funktion.
  6. Klicken Sie auf Migrieren und altes Gerät löschen.

Gladys verschiebt die Historie, aktualisiert Ihre Szenen und Dashboards, übernimmt den Raum und löscht dann das alte Gerät. Bei einer großen Historie können Sie den Fortschritt in Einstellungen → Aufgaben verfolgen (eine unterbrochene Migration kann neu gestartet werden, sie nimmt nur auf, was übrig bleibt).

:motorway: In Arbeit, im Gladys-Kern

Zwei Anfragen von @smuteau erfordern eine Weiterentwicklung des Kerns, die PRs sind vorgeschlagen:

  • der Batteriestand, der auf der Karte jedes Geräts angezeigt wird (Register Geräte) — die Integration veröffentlicht bereits die Batterie;
  • das Foto jedes Geräts, wie beim integrierten Dienst (die Bilder bleiben im Container der Integration).

:test_tube: Feedback willkommen

Vielen Dank im Voraus für Ihr Feedback :folded_hands:

2

Hallo @Terdious, ich würde dir einen PR für den Thermostat vorschlagen, da ich auf meiner Seite einen Fork gemacht habe, um fehlende Informationen hinzuzufügen. Oder ich gebe dir einen Überblick darüber, was ich benötige.

3

Gern geschehen @Will_71 :smiling_face_with_three_hearts: :folded_hands:

4

:rocket: Netatmo 2.0.0 ist verfügbar!

Großes Update des Netatmo-Externen Integrations, und dabei wird die Mindestversion auf Gladys 5.2.0 erhöht.

Neue Geräte

  • :window: Bubendorff / iDiamant Rollläden (NBR, NBO, NBS): Öffnen / Schließen / Stop und Position, über den neuen Schalter „Rollläden“.
  • :bell: Videoklingel: Bild auf dem Dashboard und Szenenauslöser „Wenn die Klingel klingelt“.
  • :cloud: Kohlenmonoxidmelder: CO-Alarm nutzbar in Szenen, mit Voralarm.
  • :herb: Home Coach (Luftqualität): Temperatur, Luftfeuchtigkeit, CO2, Lärm, Druck und Luftqualitätsindex (mit Farbe auf dem Dashboard und HomeKit, plus der Level in ganzen Worten), über den Schalter „Luftqualität“.

Neuerungen Gladys 5.x

  • :fire: Heizungsmodus des Hauses (Planung / Abwesenheit / Frostschutz) an den Thermostaten und Ventilen. @Will_71, zögere nicht, mir zu sagen, ob das dem entspricht, was du vorhattest, und falls nicht, eine PR darüber zu machen.
  • :clapper_board: Szenen: Auslöser „Eine bekannte Person kommt / geht“, „Die Sirene ertönt“; Aktionen „Heizungsmodus ändern“, „Abwesenheit / Anwesenheit markieren“.
  • :bar_chart: Widgets des Dashboards: Netatmo Wetter, Netatmo Heizung, Netatmo Kameras.

Zuverlässigkeit

  • Das Wetter wird weiterhin gemeldet, auch wenn der Netatmo-Wetterdienst ausfällt, und ein längerer Ausfall wird angezeigt (Badge Degradiert + Nachricht in der Konfiguration).
  • Das Ende eines Rauchalarms („Rauch verflogen“) löst keine Rauch-Szenen mehr aus.

:warning: Nach dem Update zu tun

  • Gladys 5.2.0 mindestens für den Empfang dieser Version.
  • Für die Klingel und die Rollläden: „Verbinden“ erneut anklicken in der Konfiguration (neue Netatmo-Berechtigungen; der Bildschirm zeigt dies an, falls nötig).
  • Für bereits erstellte Geräte: Entdeckung → Aktualisieren an den Thermostaten / Ventilen (Heizungsmodus).

:folded_hands: Aufruf an Tester

Alles wurde basierend auf der Netatmo-API entwickelt (und mit dem überprüft, was Home Assistant / pyatmo und openHAB tun), aber ohne das gesamte Material zur Hand. Wenn Sie einen CO-Melder, eine Klingel, Bubendorff-Rollläden oder einen Home Coach haben, sind Ihre Rückmeldungen (und ein Auszug aus der Registerkarte Protokolle) hier willkommen!

:memo: Vollständige Versionshinweise: Release v2.0.0 · Terdious/gladys-netatmo · GitHub
:open_book: Dokumentation: gladys-netatmo/docs/de.md at master · Terdious/gladys-netatmo · GitHub

5

Netatmo-Integration v2.1.0 verfügbar :tada:

Neue Minor-Version. Sie erfordert weiterhin Gladys 5.2.0 mindestens (5.2.1 empfohlen).

:fire: Heizung

  • Modulierender Thermostat / OpenTherm (OTM + OTH-Relais) : Er funktioniert wie der klassische Thermostat (Temperatur, Sollwert, Heizmodus, Heizkesselstatus, Batterie). Das Relais meldet die Außentemperatur und einen binären Heizkessel-Fehler.

  • BTicino Smarther mit Netatmo-Thermostat (BNS) : Temperatur, Sollwert, Heizmodus, Heizkessel- und Klimaanlagenstatus. :warning: Es werden neue Netatmo-Berechtigungen benötigt: Klicken Sie erneut auf „Verbinden“ in der Integrationskonfiguration (der Bildschirm erinnert Sie daran).

  • Erweiterte Heizung, 4 neue Szenenaktionen :

    • Sollwert eines Raumes, optional mit Dauer ;
    • Boost eines Raumes ;
    • Rückkehr zum Zeitplan ;
    • Auswahl des Heizzeitplans.

    Das Heizungs-Widget zeigt auch den aktiven Zeitplan an, signalisiert Räume im manuellen Modus oder im Boost und bietet einen „Zeitplan ändern“-Button.

:camera: Kameras und Sicherheit

  • Innenkamera Advance (NPC) : Bild auf dem Dashboard, Überwachung ein / aus, Bewegungs- und Personenerkennung. Sie erscheint im Kameras-Widget. :warning: Auch hier müssen Sie erneut auf „Verbinden“ klicken.
    Einschränkung: Wie die Türklingel überträgt sie ihr Live-Bild nur per WebRTC, was Gladys noch nicht lesen kann. Derzeit haben wir also nur das Bild. Zwei Ansätze werden untersucht.
  • Scheinwerfer der Außenkamera (NOC) : Der Modus ein / aus / auto wird zu zwei Funktionen, Scheinwerfer (ein Licht: ein = erzwungen) und Automatikmodus des Scheinwerfers (ein Schalter). Eine „Alles ausschalten“-Szene schaltet den Automatikmodus nie aus. Bei bereits erstellten Kameras führen Sie Aktualisieren im Entdeckungsbildschirm aus.
    Nur eine „Modus“-Funktion wird auf Gladys-Seite angeboten. Wir werden migrieren, sobald sie verfügbar ist.
  • Anwesenheit bekannter Personen der Kameras : Ein Gerät „ - Bekannte Personen“, mit einer Anwesenheit pro in der Netatmo-App benannter Person, aktualisiert in Echtzeit durch Webhooks.

:wrench: Behebt

  • Ein durch einen Webhook ausgelöster Refresh startet immer mit frischen Netatmo-Daten.

Auf echtem Gerät testen

Wenn Sie einen OpenTherm-Thermostat, einen Smarther, eine Advance-Kamera oder eine Außenkamera haben, sind Ihre Rückmeldungen wertvoll: gemeldete Werte, Scheinwerfersteuerung, Heizkessel-Fehler.

Vollständige Hinweise: Release v2.1.0 · Terdious/gladys-netatmo · GitHub

6

Kurze Zusammenfassung der Grenzen dieser beiden Versionen: Sie sind bereits alle durch PR core und SDK geregelt, die auf ihr Merge warten. @pierre-gilles, wenn du Zeit hast, sie noch einmal durchzulesen :smiley:

Der Home Coach gibt einen Level auf 5 Stufen (gut → sehr schlecht) an, kein Index. In der Zwischenzeit wandelt die Integration diesen Level in einen ungefähren Index um, mit der Bezeichnung nur auf Französisch. Sobald diese PRs gemerged sind, wechseln wir zu einem Standardtyp „Luftqualitätslevel“, übersetzt und mit Historie:

Der gewählte Ansatz: WebRTC-Live-Stream, verhandelt durch den Browser. Gladys übernimmt nur die Weiterleitung des Angebots und der Antwort an die Integration, wie es Home Assistant für diese Kameras tut. Der Stream geht direkt von der Netatmo-Cloud zum Browser: keine Umwandlung, der Ton wird beibehalten, sehr geringe Latenz, und es funktioniert auch über Gladys Plus.

Auf der Integrationsseite bereite ich die Verbindung für die Klingel (NDB) und die Advance-Kamera (NPC) (#70) vor. Sie bleibt inaktiv, bis Gladys sie unterstützt. Ich kann sie an meiner eigenen Klingel testen.

Der neue Standardtyp „Betriebsmodus“ einer Beleuchtung (aus / an / auto / Zeitplan) dient allen Lichtern, die einen Automatikmodus haben: Kameraprojektoren, Bewegungsmelder-Beleuchtung, Zigbee, Matter… Sobald gemerged, werden die beiden Funktionen des Projektors zu einer (#69).

Vielen Dank im Voraus! Sobald diese PRs veröffentlicht sind, aktualisiere ich die Integration.

7

Netatmo-Integration v2.2.0 verfügbar :tada:

Kleine Version, die den Weg für die Zukunft ebnet. Gladys 5.2.0 mindestens weiterhin erforderlich.

:bell: BTicino-Video-Türsprechanlage Classe 300X / Classe 300 EOS (Vorschau)

  • Neuer Schalter « BTicino-Video-Türsprechanlage (Classe 300) — Vorschau », standardmäßig deaktiviert.
  • Sobald aktiviert, werden die Module der Video-Türsprechanlage entdeckt: Innenstation, Straßenstation, Türöffner, Treppenhausbeleuchtung, Steckdose und Modul X. Derzeit haben wir deren Signal und den Status „nicht erreichbar“.
  • Die Aktivierung des Schalters erfordert 4 zusätzliche Netatmo-Berechtigungen: klicken Sie erneut auf „Verbinden“ (der Konfigurationsbildschirm erinnert Sie daran). Wenn Sie keine BTicino-Video-Türsprechanlage haben, ändert sich für Sie nichts, keine erneute Verbindung ist erforderlich.
  • Dies ist ein Schritt zur Datenerfassung. Ein Log [bticino-diagnostic] zeichnet die Rohdaten dieser Module auf, wobei Tokens, Schlüssel und E-Mail-Adressen ausgeblendet werden. Wenn Sie eine Classe 300 haben, helfen mir Ihre Logs, die Klingel als Szenarienauslöser, den Türöffner und die Treppenhausbeleuchtung hinzuzufügen. Denken Sie daran, sie vor dem Posten zu überprüfen.

:movie_camera: Direkter WebRTC-Stream der Klingel und der Advance-Kamera (vorbereitet)

Die Integration kann bereits den WebRTC-Livestream der Klingel (NDB) und der Innenkamera Advance (NPC) weiterleiten. Sie aktiviert ihn erst, wenn Gladys dies unterstützt (PR core #3215 und SDK #43). Bis dahin ändert sich nichts: Sie behalten das Standbild.

Vollständige Hinweise: Release v2.2.0 · Terdious/gladys-netatmo · GitHub