Außentemperatur

Über das temperatures-Modul können Außentemperaturvorhersagen konfiguriert und ausgelesen werden. Die Tagesmitteltemperatur wird vom Heizungsmodul für die Temperatur-Heizkurve verwendet.

warp1

Auf dieser Hardware nicht unterstützt!

warp2

Auf dieser Hardware nicht unterstützt!

warp3

Auf dieser Hardware nicht unterstützt!

wem

Auf dieser Hardware nicht unterstützt!

wem2

temperatures/config

Die Konfiguration der Außentemperatur.

Beispiel

HTTP (curl)

# $HOST z.B. wem2-AbCd

Lesen

curl http://$HOST/temperatures/config

{
    "enable": true,
    "source": 0,
    "api_url": "https://api.open-meteo.com/",
    "lat": 518846,
    "long": 86251,
    "cert_id": -1
}

Schreiben

curl http://$HOST/temperatures/config -d '{
    "enable": true,
    "source": 0,
    "api_url": "https://api.open-meteo.com/",
    "lat": 518846,
    "long": 86251,
    "cert_id": -1
}'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. wem2/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/temperatures/config

{
    "enable": true,
    "source": 0,
    "api_url": "https://api.open-meteo.com/",
    "lat": 518846,
    "long": 86251,
    "cert_id": -1
}

Schreiben

Mit MQTT auf $PREFIX/temperatures/config_update

mosquitto_pub -h $BROKER -t $PREFIX/temperatures/config_update -m '{
    "enable": true,
    "source": 0,
    "api_url": "https://api.open-meteo.com/",
    "lat": 518846,
    "long": 86251,
    "cert_id": -1
}'

Name	Beschreibung
enable bool	Gibt an, ob die Temperaturvorhersage aktiviert ist.
source int	Quelle der Temperaturdaten. 0 - Wetterdienst 1 - Push
api_url string	Endpoint-URL des Wetterdienst-Servers.
lat int (°/10000)	Breitengrad (z.B. 51.8846°)
long int (°/10000)	Längengrad (z.B. 8.6251°)
cert_id int	ID des CA-Zertifikats, das zur Prüfung des Zertifikats des Wetterdienst-Servers genutzt wird. Siehe certs/state.

temperatures/state

Der Zustand der Außentemperatur.

Beispiel

HTTP (curl)

# $HOST z.B. wem2-AbCd

Lesen

curl http://$HOST/temperatures/state

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. wem2/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/temperatures/state

{
    "last_sync": 28899840,
    "last_check": 28899840,
    "next_check": 28900200,
    "current": 185,
    "today_min": 95,
    "today_max": 225,
    "today_avg": 160,
    "tomorrow_min": 80,
    "tomorrow_max": 210,
    "tomorrow_avg": 145
}

Name	Beschreibung
last_sync int	Ein Unix-Timestamp in Minuten, der angibt, wann die Temperaturdaten das letzte Mal erfolgreich aktualisiert wurden.
last_check int	Ein Unix-Timestamp in Minuten, der angibt, wann die Temperaturdaten das letzte Mal abgefragt wurden.
next_check int	Ein Unix-Timestamp in Minuten, der angibt, wann die Temperaturdaten das nächste Mal abgefragt werden.
current int	Aktuelle Außentemperatur in Zehntel °C. 0x7FFF falls nicht verfügbar.
today_min int	Minimale Tagestemperatur für heute in Zehntel °C. 0x7FFF falls nicht verfügbar.
today_max int	Maximale Tagestemperatur für heute in Zehntel °C. 0x7FFF falls nicht verfügbar.
today_avg int	Tagesmitteltemperatur für heute in Zehntel °C. 0x7FFF falls nicht verfügbar.
tomorrow_min int	Minimale Tagestemperatur für morgen in Zehntel °C. 0x7FFF falls nicht verfügbar.
tomorrow_max int	Maximale Tagestemperatur für morgen in Zehntel °C. 0x7FFF falls nicht verfügbar.
tomorrow_avg int	Tagesmitteltemperatur für morgen in Zehntel °C. 0x7FFF falls nicht verfügbar.

temperatures/temperatures

Stündliche Temperaturvorhersage.

Beispiel

HTTP (curl)

# $HOST z.B. wem2-AbCd

Lesen

curl http://$HOST/temperatures/temperatures

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. wem2/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/temperatures/temperatures

{
    "first_date": 28899360,
    "temperatures": [125, 120, 115, 110, 105, 100, 95, 100, 115, 135, 155, 175, 195, 210, 220, 225, 220, 210, 195, 180, 165, 155, 145, 140, 130, 125, 120, 115, 110, 105, 100, 95, 100, 120, 140, 160, 180, 195, 205, 210, 205, 195, 180, 165, 150, 140, 130, 120]
}

Name	Beschreibung
first_date int	Ein Unix-Timestamp in Minuten, der angibt, zu welchem Zeitpunkt der erste Temperaturwert im temperatures-Array gilt.
temperatures int[..]	Array von Temperaturwerten in Zehntel °C. Das erste Element des Arrays gilt für den Zeitpunkt first_date, jedes weitere Element für die jeweils nächste Stunde.

temperatures/temperatures_update

Aktualisiert die Temperaturvorhersage über die API. Funktioniert nur wenn die source auf Push (1) gesetzt ist.

http

mqtt

Löst eine einmalige Aktion aus. Nachrichten, die über den Broker retained wurden, werden ignoriert.

Beispiel

HTTP (curl)

# $HOST z.B. wem2-AbCd

Schreiben

curl http://$HOST/temperatures/temperatures_update -d '{
    "first_date": 28899360,
    "temperatures": [125, 120, 115, 110, 105, 100, 95, 100, 115, 135, 155, 175, 195, 210, 220, 225, 220, 210, 195, 180, 165, 155, 145, 140, 130, 125, 120, 115, 110, 105, 100, 95, 100, 120, 140, 160, 180, 195, 205, 210, 205, 195, 180, 165, 150, 140, 130, 120]
}'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. wem2/AbCd

Schreiben

mosquitto_pub -h $BROKER -t $PREFIX/temperatures/temperatures_update -m '{
    "first_date": 28899360,
    "temperatures": [125, 120, 115, 110, 105, 100, 95, 100, 115, 135, 155, 175, 195, 210, 220, 225, 220, 210, 195, 180, 165, 155, 145, 140, 130, 125, 120, 115, 110, 105, 100, 95, 100, 120, 140, 160, 180, 195, 205, 210, 205, 195, 180, 165, 150, 140, 130, 120]
}'

Name	Beschreibung
first_date int	Ein Unix-Timestamp in Minuten, der angibt, zu welchem Zeitpunkt der erste Temperaturwert im temperatures-Array gilt.
temperatures int[..]	Array von Temperaturwerten in Zehntel °C. Das erste Element des Arrays gilt für den Zeitpunkt first_date, jedes weitere Element für die jeweils nächste Stunde.

any

temperatures/config

Die Konfiguration der Außentemperatur.

Beispiel

HTTP (curl)

# $HOST z.B. warp-AbCd

Lesen

curl http://$HOST/temperatures/config

{
    "enable": true,
    "source": 0,
    "api_url": "https://api.open-meteo.com/",
    "lat": 518846,
    "long": 86251,
    "cert_id": -1
}

Schreiben

curl http://$HOST/temperatures/config -d '{
    "enable": true,
    "source": 0,
    "api_url": "https://api.open-meteo.com/",
    "lat": 518846,
    "long": 86251,
    "cert_id": -1
}'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/temperatures/config

{
    "enable": true,
    "source": 0,
    "api_url": "https://api.open-meteo.com/",
    "lat": 518846,
    "long": 86251,
    "cert_id": -1
}

Schreiben

Mit MQTT auf $PREFIX/temperatures/config_update

mosquitto_pub -h $BROKER -t $PREFIX/temperatures/config_update -m '{
    "enable": true,
    "source": 0,
    "api_url": "https://api.open-meteo.com/",
    "lat": 518846,
    "long": 86251,
    "cert_id": -1
}'

Name	Beschreibung
enable bool	Gibt an, ob die Temperaturvorhersage aktiviert ist.
source int	Quelle der Temperaturdaten. 0 - Wetterdienst 1 - Push
api_url string	Endpoint-URL des Wetterdienst-Servers.
lat int (°/10000)	Breitengrad (z.B. 51.8846°)
long int (°/10000)	Längengrad (z.B. 8.6251°)
cert_id int	ID des CA-Zertifikats, das zur Prüfung des Zertifikats des Wetterdienst-Servers genutzt wird. Siehe certs/state.

temperatures/state

Der Zustand der Außentemperatur.

Beispiel

HTTP (curl)

# $HOST z.B. warp-AbCd

Lesen

curl http://$HOST/temperatures/state

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/temperatures/state

{
    "last_sync": 28899840,
    "last_check": 28899840,
    "next_check": 28900200,
    "current": 185,
    "today_min": 95,
    "today_max": 225,
    "today_avg": 160,
    "tomorrow_min": 80,
    "tomorrow_max": 210,
    "tomorrow_avg": 145
}

Name	Beschreibung
last_sync int	Ein Unix-Timestamp in Minuten, der angibt, wann die Temperaturdaten das letzte Mal erfolgreich aktualisiert wurden.
last_check int	Ein Unix-Timestamp in Minuten, der angibt, wann die Temperaturdaten das letzte Mal abgefragt wurden.
next_check int	Ein Unix-Timestamp in Minuten, der angibt, wann die Temperaturdaten das nächste Mal abgefragt werden.
current int	Aktuelle Außentemperatur in Zehntel °C. 0x7FFF falls nicht verfügbar.
today_min int	Minimale Tagestemperatur für heute in Zehntel °C. 0x7FFF falls nicht verfügbar.
today_max int	Maximale Tagestemperatur für heute in Zehntel °C. 0x7FFF falls nicht verfügbar.
today_avg int	Tagesmitteltemperatur für heute in Zehntel °C. 0x7FFF falls nicht verfügbar.
tomorrow_min int	Minimale Tagestemperatur für morgen in Zehntel °C. 0x7FFF falls nicht verfügbar.
tomorrow_max int	Maximale Tagestemperatur für morgen in Zehntel °C. 0x7FFF falls nicht verfügbar.
tomorrow_avg int	Tagesmitteltemperatur für morgen in Zehntel °C. 0x7FFF falls nicht verfügbar.

temperatures/temperatures

Stündliche Temperaturvorhersage.

Beispiel

HTTP (curl)

# $HOST z.B. warp-AbCd

Lesen

curl http://$HOST/temperatures/temperatures

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/temperatures/temperatures

{
    "first_date": 28899360,
    "temperatures": [125, 120, 115, 110, 105, 100, 95, 100, 115, 135, 155, 175, 195, 210, 220, 225, 220, 210, 195, 180, 165, 155, 145, 140, 130, 125, 120, 115, 110, 105, 100, 95, 100, 120, 140, 160, 180, 195, 205, 210, 205, 195, 180, 165, 150, 140, 130, 120]
}

Name	Beschreibung
first_date int	Ein Unix-Timestamp in Minuten, der angibt, zu welchem Zeitpunkt der erste Temperaturwert im temperatures-Array gilt.
temperatures int[..]	Array von Temperaturwerten in Zehntel °C. Das erste Element des Arrays gilt für den Zeitpunkt first_date, jedes weitere Element für die jeweils nächste Stunde.

temperatures/temperatures_update

Aktualisiert die Temperaturvorhersage über die API. Funktioniert nur wenn die source auf Push (1) gesetzt ist.

http

mqtt

Löst eine einmalige Aktion aus. Nachrichten, die über den Broker retained wurden, werden ignoriert.

Beispiel

HTTP (curl)

# $HOST z.B. warp-AbCd

Schreiben

curl http://$HOST/temperatures/temperatures_update -d '{
    "first_date": 28899360,
    "temperatures": [125, 120, 115, 110, 105, 100, 95, 100, 115, 135, 155, 175, 195, 210, 220, 225, 220, 210, 195, 180, 165, 155, 145, 140, 130, 125, 120, 115, 110, 105, 100, 95, 100, 120, 140, 160, 180, 195, 205, 210, 205, 195, 180, 165, 150, 140, 130, 120]
}'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp/AbCd

Schreiben

mosquitto_pub -h $BROKER -t $PREFIX/temperatures/temperatures_update -m '{
    "first_date": 28899360,
    "temperatures": [125, 120, 115, 110, 105, 100, 95, 100, 115, 135, 155, 175, 195, 210, 220, 225, 220, 210, 195, 180, 165, 155, 145, 140, 130, 125, 120, 115, 110, 105, 100, 95, 100, 120, 140, 160, 180, 195, 205, 210, 205, 195, 180, 165, 150, 140, 130, 120]
}'

Name	Beschreibung
first_date int	Ein Unix-Timestamp in Minuten, der angibt, zu welchem Zeitpunkt der erste Temperaturwert im temperatures-Array gilt.
temperatures int[..]	Array von Temperaturwerten in Zehntel °C. Das erste Element des Arrays gilt für den Zeitpunkt first_date, jedes weitere Element für die jeweils nächste Stunde.