README

Herzlich Willkommen beim HomematicIP CCU Netatmo Addon Projekt.

Das Projekt basiert auf den Postings im Thread NetAtmo Wetterdaten HOWTO aus dem HomeMatic-Forum / FHZ-Forum. Um die Handhabung des dort vorgestellten Skripts zu vereinfachen wurde es für dieses Projekt überarbeitet und stellenweise angepasst. Die optionalen Blöcke für die Wind-, Regen- und Zusatzmodule müssen nicht mehr auskommentiert werden, diese werden nur noch ausgeführt wenn die entsprechenden Modulids gesetzt wurden. Anstatt die Credentials und Modulids statisch im Skript anzugeben können diese nun als Kommandozeilenparameter beim Aufruf übergeben werden.

Nachfolgend finden Sie eine Beschreibung der Kommandozeilenparameter und eine detaillierte Schritt-für-Schritt Anleitung zur Erstinstallation. Es ist aber auch möglich anhand der Anleitung bei bedarf bisher nicht genutzte Module nachträglich einzubinden, dazu müssen lediglich die entsprechenden Abschnitte befolgt werden.

Parameter:

-clientid: API Client ID (erforderlich) => Siehe 1.3 Beziehen der Clientid und des Clientsecrets
-clientsecret: API Client Secret (erforderlich) => Siehe 1.3 Beziehen der Clientid und des Clientsecrets
-username: Netatmo Account Benutzername (erforderlich)
-password: Netatmo Account Passwort (erforderlich)
-deviceid: ID des Netatmo Basismoduls (erforderlich) => Siehe 1.4.1 Basisstation
-moduleid: ID des Netatmo Außenmoduls (optional) => Siehe 1.4.2 Übrige Module
-windid: ID des Netatmo Windsensors (optional) => Siehe 1.4.2 Übrige Module
-rainid: ID des Netatmo Regensensors (optional) => Siehe 1.4.2 Übrige Module
-z1moduleid: ID des ersten Netatmo Zusatz Innenmoduls (optional) => Siehe 1.4.2 Übrige Module
-z2moduleid: ID des ersten Netatmo Zusatz Innenmoduls (optional) => Siehe 1.4.2 Übrige Module
-z3moduleid: ID des ersten Netatmo Zusatz Innenmoduls (optional) => Siehe 1.4.2 Übrige Module

Inhaltsverzeichnis

Vorbereitungen
Installation
Anlegen der Geräte im CUx Daemon
CCU Geräte anlernen
Systemvariablen anlegen
Programm für automatischen Datenabruf anlegen

1. Vorbereitungen

Für die Nutzung des HmIP-CCU-Netatmo-Addons werden neben den normalen Benutzerdaten für Ihren Netatmo Account noch eine Clientid sowie ein Clientsecret notwendig. Dafür wird ein Netatmo Developer Account benötigt, im Folgenden wird beschrieben wie Sie den Account anlegen und wo die benötigten Daten zu finden sind.

1.1 Erstellung eines Netatmo Developer Accounts

Falls Sie bereits einen Netatmo Developer Account haben fahren Sie bitte mit Abschnitt 1.2 fort

Öffnen Sie einen beliebigen Browser und navigieren Sie zur Adresse https://dev.netatmo.com/
Klicken Sie auf Log In
Klicken Sie auf Singn Up
Vergeben Sie einen Benutzernamen und Passwort
Setzen Sie das Häkchen zum Bestätigen der AGBs und Nutzungsbedingungen
Bestätigen Sie Ihre Eingaben mit einem Klick auf den Button Sign Up

1.2 Registrieren einer neuen App

Öffnen Sie einen beliebigen Browser und navigieren Sie zur Adresse https://dev.netatmo.com/
Klicken Sie auf Log In
Geben Sie Ihren Benutzernamen und Passwort ein
Melden Sie sich mit einem Klick auf den Button LOG IN an
Klicken Sie auf Ihren Benutzernamen => my apps
Klicken Sie auf den Button Create
Füllen Sie das Formular aus
Setzen Sie das Häkchen zum Akzeptieren der Nutzungsbedingungen
Speichern Sie die Eingaben mit einem Klick auf den Button Save

1.3 Beziehen der Clientid und des Clientsecrets

Öffnen Sie einen beliebigen Browser und navigieren Sie zur Adresse https://dev.netatmo.com/
Klicken Sie auf Log In
Geben Sie Ihren Benutzernamen und Passwort ein
Melden Sie sich mit einem Klick auf den Button LOG IN an
Klicken Sie auf Ihren Benutzernamen => my apps
Klicken Sie auf die Kachel Ihrer App
Notieren Sie die Angaben aus den Feldern client ID und client secret im Abschnitt App Technical Parameters

1.4 Ermitteln der Modul IDs

1.4.1 Basisstation

Die Modul ID der Basisstation finden Sie in der Netatmo Android-/iOS bzw iPad OS App, gehen Sie dazu wie folgt vor:

Öffnen Sie die App auf Ihrem Tablet oder Smartphone
Tippen Sie auf die drei Striche oben links
Tippen Sie auf den Menüpunkt Haus steuern
Tippen Sie auf eine Gruppe
Tippen Sie auf eínen Geräteeintrag
Notieren Sie sich die Daten des Eintrags MAC-Adresse

1.4.2 Übrige Module

Die Modul IDs der Netatmo Außen-, Wind-, Regen-, sowie Zusatz Innenmodule setzen sich je nach Modultyp aus einem Präfix und den letzten sechs Stellen der Seriennummer des Moduls im Schema 00:00:00:00:00:00 zusammen. Die Seriennummer der Module finden Sie auf der Rückseite der original Netatmo Modulverpackung auf dem Etikett über dem oberen Barcode.

Die Modultypspezifischen Präfixe lauten wie folgt:

Außenmodul: 02:00:00
Regensensor: 05:00:00
Windsensor: 06:00:00
Zusatz Innenmodul: 03:00:00

2. Installation

2.1 CUx Daemon Installieren

Laden Sie hier den CUx Daemon herunter
Öffnen Sie einen beliebigen Browser und navigieren Sie zur Adresse ihrer CCU
Loggen Sie sich mit ihrem User und Passwort ein
Klicken Sie auf Einstellungen -> Systemsteuerung
Klicken Sie auf den Button Zusatzsoftware
Wählen Sie die in Schritt 1. heruntergeladene Datei zum Upload aus
Klicken Sie auf den Button Installieren
Bestätigen Sie die folgenden Hinweise mit einem Klick auf OK

2.2 Addon Verzeichnis für Netatmo anlegen

Mit Kommandozeile: ssh <ihr_ccu_user>@<ihre_ccu_addresse> mkdir /usr/local/addons/netatmo
Mit einem Client wie WinSCP: Mit ihrem CCU User und Passwort einloggen und das Verzeichnis netatmo manuell anlegen unter /usr/local/addons

2.3 Hochladen des Addon Script in das Addon Verzeichnis

Mit Kommandozeile: scp <pfad_zum_skript>/netatmo_new.tcl <ihr_ccu_user>@<ihre_ccu_addresse>:/usr/local/addons/netatmo
Mit einem Client wie WinSCP: Mit ihrem CCU User und Passwort einloggen und das tcl Skript manuell im Verzeichnis netatmo ablegen unter /usr/local/addons/netatmo

3. Anlegen der Geräte im CUx Daemon

3.1 Login auf der CCU Web UI

Öffnen Sie einen beliebigen Browser und navigieren Sie zur Adresse ihrer CCU
Loggen Sie sich mit ihrem User und Passwort ein
Klicken Sie auf Einstellungen -> Systemsteuerung
Klicken Sie auf den Button CUx-Daemon
Klicken Sie auf Geräte

3.2 Main Modul

Wählen Sie als CUxD Gerätetyp (90) Universal Wrapper Device aus
Wählen Sie als Funktion Thermostat aus
Setzen Sie als Seriennummer 1, bzw. die erste freie Nummer
Vergeben Sie als Name einen eindeutigen Namen
Wählen Sie als Geräte-Icon Temperatursensor innen
Klicken Sie auf den Button Gerät auf CCU erzeugen!
Öffnen Sie das Dropdown Aktueller Status und Notieren Sie die CUx Geräte ID beginnend mit CUX900200

3.3 Optional: Außenmodul

Wählen Sie als CUxD Gerätetyp (90) Universal Wrapper Device aus
Wählen Sie als Funktion Thermostat aus
Setzen Sie als Seriennummer 2, bzw. die erste freie Nummer
Vergeben Sie als Name einen eindeutigen Namen
Wählen Sie als Geräte-Icon Temperatursensor außen
Klicken Sie auf den Button Gerät auf CCU erzeugen!
Öffnen Sie das Dropdown Aktueller Status und Notieren Sie die CUx Geräte ID beginnend mit CUX900200

3.4 Optional: Windmesser

Achtung: Der Netatmo Windmesser kann nur in Verbindung mit dem Außenmodul eingebunden werden

Für den Netatmo Windmesser muss kein eigenes CUxD Gerät angelegt werden, es muss lediglich eine Systemvariable angelegt werden. Zum Anlegen der Systemvariable folgen Sie bitte der Anleitung unter 5.4 Optional: Windmesser

Nach der Anlage der Systemvariable werden die Daten des Windmessers zusammen mit den Daten des Innenmoduls angezeigt.

3.5 Optional: Regenmesser

Achtung: Der Netatmo Regenmesser kann nur in Verbindung mit dem Außenmodul eingebunden werden

Für den Netatmo Windmesser muss kein eigenes CUxD Gerät angelegt werden, es muss lediglich eine Systemvariable angelegt werden. Zum Anlegen der Systemvariable folgen Sie bitte der Anleitung unter 5.5 Optional: Regenmesser.

Nach der Anlage der Systemvariable werden die Daten des Regenmessers zusammen mit den Daten des Innenmoduls angezeigt.

3.6 Optional: Erstes Zusatz Innenmodul

Wählen Sie als CUxD Gerätetyp (90) Universal Wrapper Device aus
Wählen Sie als Funktion Thermostat aus
Setzen Sie als Seriennummer 3, bzw. die erste freie Nummer
Vergeben Sie als Name einen eindeutigen Namen
Wählen Sie als Geräte-Icon Temperatursensor innen
Klicken Sie auf den Button Gerät auf CCU erzeugen!
Öffnen Sie das Dropdown Aktueller Status und Notieren Sie die CUx Geräte ID beginnend mit CUX900200

3.7 Optional: Zweites Zusatz Innenmodul

Wählen Sie als CUxD Gerätetyp (90) Universal Wrapper Device aus
Wählen Sie als Funktion Thermostat aus
Setzen Sie als Seriennummer 4, bzw. die erste freie Nummer
Vergeben Sie als Name einen eindeutigen Namen
Wählen Sie als Geräte-Icon Temperatursensor innen
Klicken Sie auf den Button Gerät auf CCU erzeugen!
Öffnen Sie das Dropdown Aktueller Status und Notieren Sie die CUx Geräte ID beginnend mit CUX900200

3.8 Optional: Drittes Zusatz Innenmodul

Wählen Sie als CUxD Gerätetyp (90) Universal Wrapper Device aus
Wählen Sie als Funktion Thermostat aus
Setzen Sie als Seriennummer 5, bzw. die erste freie Nummer
Vergeben Sie als Name einen eindeutigen Namen
Wählen Sie als Geräte-Icon Temperatursensor innen
Klicken Sie auf den Button Gerät auf CCU erzeugen!
Öffnen Sie das Dropdown Aktueller Status und Notieren Sie die CUx Geräte ID beginnend mit CUX900200

3.9 CUxD Zentrale

Wählen Sie als CUxD Gerätetyp (28) System
Wählen Sie als Funktion Exec aus
Setzen Sie als Seriennummer 1, bzw. die erste freie Nummer
Vergeben Sie als Namen Zentrale CUxD
Wählen Sie als Geräte-Icon Fernbedienung 19 Tasten
Wählen Sie als Control Taster
Klicken Sie auf den Button Gerät auf CCU erzeugen!
Öffnen Sie das Dropdown Aktueller Status und Notieren Sie die CUx Geräte ID beginnend mit CUX900200

4. CCU Geräte anlernen

4.1 Navigieren Sie zurück zur CCU Web UI und öffnen Sie den Geräte Posteingang

Loggen Sie sich ggf. mit ihrem User und Passwort ein
Klicken Sie auf den Button Geräte anlernen
klicken Sie auf den Button Posteingang

4.2 Main Modul

Suchen Sie das Gerät anhand der in 3.2 Main Modul notierten Seriennummer aus der Liste heraus
Klicken Sie beim entsprechenden Eintrag auf den Button Einstellen
Wählen Sie im MODE Dropdown TEMP+HUM aus
Deaktivieren Sie das Häkchen bei WEATHER|USE_HMDATAPT falls es gesetzt ist
Setzen Sie das Häkchen bei Zyklische Statusmeldung
Setzen Sie das Häkchen bei WEATHER|STATISTIC
Speichern Sie die Änderungen mit einem Klick auf den Button OK
Schließen Sie das Status Popup mit einem Klick auf OK
Schließen Sie das Anlernen des Geräts mit einem Klick auf Fertig beim entsprechenden Eintrag ab

4.3 Optional: Außenmodul

Suchen Sie das Gerät anhand der in 3.3 Optional: Außenmodul notierten Seriennummer aus der Liste heraus
Klicken Sie beim entsprechenden Eintrag auf den Button Einstellen
Wählen Sie im MODE Dropdown TEMP+HUM aus
Deaktivieren Sie das Häkchen bei WEATHER|USE_HMDATAPT falls es gesetzt ist
Setzen Sie das Häkchen bei Zyklische Statusmeldung
Setzen Sie das Häkchen bei WEATHER|STATISTIC
Speichern Sie die Änderungen mit einem Klick auf den Button OK
Schließen Sie das Status Popup mit einem Klick auf OK
Schließen Sie das Anlernen des Geräts mit einem Klick auf Fertig beim entsprechenden Eintrag ab

4.4 Optional: Windmesser

Achtung: Der Netatmo Windmesser kann nur in Verbindung mit dem Außenmodul eingebunden werden

Für den Netatmo Windmesser muss kein eigenes CUxD Gerät angelegt werden, es muss lediglich eine Systemvariable angelegt werden. Zum Anlegen der Systemvariable folgen Sie bitte der Anleitung unter 5.4 Optional: Windmesser.

Nach der Anlage der Systemvariable werden die Daten des Windmessers zusammen mit den Daten des Innenmoduls angezeigt.

4.5 Optional: Regenmesser

Achtung: Der Netatmo Regenmesser kann nur in Verbindung mit dem Außenmodul eingebunden werden

Für den Netatmo Regenmesser muss kein eigenes CUxD Gerät angelegt werden, es muss lediglich eine Systemvariable angelegt werden. Zum Anlegen der Systemvariable folgen Sie bitte der Anleitung unter 5.5 Optional: Regenmesser.

Nach der Anlage der Systemvariable werden die Daten des Regenmessers zusammen mit den Daten des Innenmoduls angezeigt.

4.6 Optional: Erstes Zusatz Innenmodul

Suchen Sie das Gerät anhand der in 3.6 Optional: Erstes Zusatz Innenmodul notierten Seriennummer aus der Liste heraus
Klicken Sie beim entsprechenden Eintrag auf den Button Einstellen
Wählen Sie im MODE Dropdown TEMP+HUM aus
Deaktivieren Sie das Häkchen bei WEATHER|USE_HMDATAPT falls es gesetzt ist
Setzen Sie das Häkchen bei Zyklische Statusmeldung
Setzen Sie das Häkchen bei WEATHER|STATISTIC
Speichern Sie die Änderungen mit einem Klick auf den Button OK
Schließen Sie das Status Popup mit einem Klick auf OK
Schließen Sie das Anlernen des Geräts mit einem Klick auf Fertig beim entsprechenden Eintrag ab

4.7 Optional: Zweites Zusatz Innenmodul

Suchen Sie das Gerät anhand der in 3.7 Optional: Zweites Zusatz Innenmodul notierten Seriennummer aus der Liste heraus
Klicken Sie beim entsprechenden Eintrag auf den Button Einstellen
Wählen Sie im MODE Dropdown TEMP+HUM aus
Deaktivieren Sie das Häkchen bei WEATHER|USE_HMDATAPT falls es gesetzt ist
Setzen Sie das Häkchen bei Zyklische Statusmeldung
Setzen Sie das Häkchen bei WEATHER|STATISTIC
Speichern Sie die Änderungen mit einem Klick auf den Button OK
Schließen Sie das Status Popup mit einem Klick auf OK

4.8 Optional: Drittes Zusatz Innenmodul

Suchen Sie das Gerät anhand der in 3.8 Optional: Drittes Zusatz Innenmodul notierten Seriennummer aus der Liste heraus
Klicken Sie beim entsprechenden Eintrag auf den Button Einstellen
Wählen Sie im MODE Dropdown TEMP+HUM aus
Deaktivieren Sie das Häkchen bei WEATHER|USE_HMDATAPT falls es gesetzt ist
Setzen Sie das Häkchen bei Zyklische Statusmeldung
Setzen Sie das Häkchen bei WEATHER|STATISTIC
Speichern Sie die Änderungen mit einem Klick auf den Button OK
Schließen Sie das Status Popup mit einem Klick auf OK
Schließen Sie das Anlernen des Geräts mit einem Klick auf Fertig beim entsprechenden Eintrag ab

4.9 CUxD Zentrale

Suchen Sie das Gerät anhand der in 3.9 CUxD Zetrale notierten Seriennummer aus der Liste heraus
Klicken Sie beim entsprechenden Eintrag auf den Button Einstellen
Geben Sie bei KEY|CMD_SHORT tclsh /usr/local/addons/netatmo/netatmo_new.tcl -clientid <ihre_netatmo_clientid> -clientsecret <ihr_netatmo_clientsecret> -username <ihr_netatmo_account_user> -password -deviceid <ihre_netatmo_innenmodul_id> -moduleid <ihre_netatmo_aussenmodul_id> -windid <ihre_netatmo_windmodul_id> -rainid <ihre_netatmo_regenmodul_id> -z1moduleid <ihre_netatmo_zusatzmodul1_id> -z2moduleid <ihre_netatmo_zusatzmodul2_id> -z3moduleid <ihre_netatmo_zusatzmodul3_id> ein
Passen Sie die Platzhalter mit Ihren Daten an, die moduleid, rainid, windid sowie die Zusatzmoduleid sind optional
Geben Sie bei KEY|CMD_LONG tclsh /usr/local/addons/netatmo/netatmo_new.tcl -clientid <ihre_netatmo_clientid> -clientsecret <ihr_netatmo_clientsecret> -username <ihr_netatmo_account_user> -password -deviceid <ihre_netatmo_innenmodul_id> -moduleid <ihre_netatmo_aussenmodul_id> -windid <ihre_netatmo_windmodul_id> -rainid <ihre_netatmo_regenmodul_id> -z1moduleid <ihre_netatmo_zusatzmodul1_id> -z2moduleid <ihre_netatmo_zusatzmodul2_id> -z3moduleid <ihre_netatmo_zusatzmodul3_id> ein
Passen Sie die Platzhalter mit Ihren Daten an, die moduleid, rainid, windid sowie die Zusatzmoduleid sind optional
Speichern Sie die Änderungen mit einem Klick auf den Button OK
Schließen Sie das Status Popup mit einem Klick auf OK
Schließen Sie das Anlernen des Geräts mit einem Klick auf Fertig beim entsprechenden Eintrag ab

5. Systemvariablen anlegen

5.1 Wechseln Sie zu den Systemvariablen

Klicken Sie auf Einstellungen -> Systemvariable

5.2 Main Modul

5.2.1 CO2

Klicken Sie auf den Button Neu
Geben Sie als Name CO2 ein
Optional: Geben Sie eine Beschreibung ein
Wählen Sie im Varablentyp Dropdown Zahl aus
Geben Sie beim Wertebereich als Minimalwert 0 ein
Geben Sie beim Wertebereich als Maximalwert 10000 ein
Geben Sie als Maßeinheit ppm ein
Wählen Sie bei Kanalzuordnung mit aus
Wählen Sie in der Liste das Gerät Netatmo Innen mit einem Klick auf den Eintrag aus
Speichern Sie die Änderungen mit einem Klick auf den Button OK

5.2.2 Luftdruck

Klicken Sie auf den Button Neu
Geben Sie als Name Luftdruck ein
Optional: Geben Sie eine Beschreibung ein
Wählen Sie im Varablentyp Dropdown Zahl aus
Geben Sie beim Wertebereich als Minimalwert 0 ein
Geben Sie beim Wertebereich als Maximalwert 2000 ein
Geben Sie als Maßeinheit mb ein
Wählen Sie bei Kanalzuordnung mit aus
Wählen Sie in der Liste das Gerät Netatmo Innen mit einem Klick auf den Eintrag aus
Speichern Sie die Änderungen mit einem Klick auf den Button OK

5.2.3 Sonometer

Klicken Sie auf den Button Neu
Geben Sie als Name Sonometer ein
Optional: Geben Sie eine Beschreibung ein
Wählen Sie im Varablentyp Dropdown Zahl aus
Geben Sie beim Wertebereich als Minimalwert 0 ein
Geben Sie beim Wertebereich als Maximalwert 200 ein
Geben Sie als Maßeinheit dB ein
Wählen Sie bei Kanalzuordnung mit aus
Wählen Sie in der Liste das Gerät Netatmo Innen mit einem Klick auf den Eintrag aus
Speichern Sie die Änderungen mit einem Klick auf den Button OK

5.3 Optional: Außenmodul

5.4 Optional: Windmesser

Achtung: Der Netatmo Windmesser kann nur in Verbindung mit dem Außenmodul eingebunden werden

5.4.1 Windrichtung

Klicken Sie auf den Button Neu
Geben Sie als Name Windrichtung ein
Optional: Geben Sie eine Beschreibung ein
Wählen Sie im Varablentyp Dropdown Zahl aus
Geben Sie beim Wertebereich als Minimalwert 0 ein
Geben Sie beim Wertebereich als Maximalwert 1000 ein
Geben Sie als Maßeinheit ° ein
Wählen Sie bei Kanalzuordnung mit aus
Wählen Sie in der Liste das Gerät Netatmo Außen mit einem Klick auf den Eintrag aus
Speichern Sie die Änderungen mit einem Klick auf den Button OK

5.4.2 Windstaerke

Klicken Sie auf den Button Neu
Geben Sie als Name Windstaerke ein
Optional: Geben Sie eine Beschreibung ein
Wählen Sie im Varablentyp Dropdown Zahl aus
Geben Sie beim Wertebereich als Minimalwert 0 ein
Geben Sie beim Wertebereich als Maximalwert 1000 ein
Geben Sie als Maßeinheit km/h ein
Wählen Sie bei Kanalzuordnung mit aus
Wählen Sie in der Liste das Gerät Netatmo Außen mit einem Klick auf den Eintrag aus
Speichern Sie die Änderungen mit einem Klick auf den Button OK

5.4.3 Gustangle

Klicken Sie auf den Button Neu
Geben Sie als Name Gustangle ein
Optional: Geben Sie eine Beschreibung ein
Wählen Sie im Varablentyp Dropdown Zahl aus
Geben Sie beim Wertebereich als Minimalwert 0 ein
Geben Sie beim Wertebereich als Maximalwert 1000 ein
Geben Sie als Maßeinheit ° ein
Wählen Sie bei Kanalzuordnung mit aus
Wählen Sie in der Liste das Gerät Netatmo Außen mit einem Klick auf den Eintrag aus
Speichern Sie die Änderungen mit einem Klick auf den Button OK

5.4.4 Guststaerke

Klicken Sie auf den Button Neu
Geben Sie als Name Guststaerke ein
Optional: Geben Sie eine Beschreibung ein
Wählen Sie im Varablentyp Dropdown Zahl aus
Geben Sie beim Wertebereich als Minimalwert 0 ein
Geben Sie beim Wertebereich als Maximalwert 1000 ein
Geben Sie als Maßeinheit km/h ein
Wählen Sie bei Kanalzuordnung mit aus
Wählen Sie in der Liste das Gerät Netatmo Außen mit einem Klick auf den Eintrag aus
Speichern Sie die Änderungen mit einem Klick auf den Button OK

5.5 Optional: Regenmesser