PV-Ertragsprogrnose

Über das solar_forecast-Modul kann eine PV-Ertragsprognose konfiguriert und ausgelesen werden.

warp1

Auf dieser Hardware nicht unterstützt!

warp2

solar_forecast/config

Die Konfiguration der PV-Ertragsprognose.

Beispiel

HTTP (curl)

# $HOST z.B. warp2-AbCd

Lesen

curl http://$HOST/solar_forecast/config

{
    "enable": true,
    "api_url": "https://api.forecast.solar/",
    "cert_id": -1
}

Schreiben

curl http://$HOST/solar_forecast/config -d '{
    "enable": true,
    "api_url": "https://api.forecast.solar/",
    "cert_id": -1
}'

MQTT (mosquitto)

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

Lesen

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

{
    "enable": true,
    "api_url": "https://api.forecast.solar/",
    "cert_id": -1
}

Schreiben

Mit MQTT auf $PREFIX/solar_forecast/config_update

mosquitto_pub -h $BROKER -t $PREFIX/solar_forecast/config_update -m '{
    "enable": true,
    "api_url": "https://api.forecast.solar/",
    "cert_id": -1
}'

Name	Bedeutung
enable bool	Gibt an, ob die PV-Ertragsprognose verwendet werden soll.
api_url string	Endpoint-URL des Servers für dynamische Strompreise.
cert_id int	ID des CA-Zertifikats, dass zur Prüfung des Zertifikats des RADIUS-Servers genutzt wird. Siehe certs/state.

solar_forecast/state

Der Zustand der PV-Ertragsprognose.

Beispiel

HTTP (curl)

# $HOST z.B. warp2-AbCd

Lesen

curl http://$HOST/solar_forecast/state

MQTT (mosquitto)

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

Lesen

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

{
    "rate_limit": 12,
    "rate_remaining": 7,
    "next_api_call": 28899847
}

Name	Bedeutung
rate_limit int	Gibt an wie viele API-Aufrufe alle zwei Stunden getätigt werden dürfen.
rate_remaining int	Gibt an wie viele API-Aufrufe im aktuellen Zeitfenster getätigt wurden.
next_api_call int	Gibt an wann der nächste API-Aufruf getätigt wird.

solar_forecast/planes/X/state

Status der PV-Flächen

Beispiel

HTTP (curl)

# $HOST z.B. warp2-AbCd

Lesen

curl http://$HOST/solar_forecast/planes/X/state

MQTT (mosquitto)

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

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/solar_forecast/planes/X/state

{
    "last_sync": 28899727,
    "last_check": 28899727,
    "next_check": 28899847,
    "place": "Helleforthstraße 22, 33758 Schloß Holte-Stukenbrock, Germany"
}

Name	Bedeutung
last_sync int	Ein Unix-Timestamp in Minuten, der angibt wann die PV-Ertragsprognose das letzte Mal aktualisiert wurden.
last_check int	Ein Unix-Timestamp in Minuten, der angibt wann die PV-Ertragsprognose das letzte Mal abgefragt wurden.
next_check int	Ein Unix-Timestamp in Minuten, der angibt wann die PV-Ertragsprognose das nächste Mal abgefragt werden.
place string	Ort der konfigurierten PV-Fläche.

solar_forecast/planes/X/config

Beispiel

HTTP (curl)

# $HOST z.B. warp2-AbCd

Lesen

curl http://$HOST/solar_forecast/planes/X/config

{
    "enable": true,
    "name": "Haus OS",
    "lat": 518847,
    "long": 86225,
    "dec": 25,
    "az": -43,
    "wp": 4725
}

Schreiben

curl http://$HOST/solar_forecast/planes/X/config -d '{
    "enable": true,
    "name": "Haus OS",
    "lat": 518847,
    "long": 86225,
    "dec": 25,
    "az": -43,
    "wp": 4725
}'

MQTT (mosquitto)

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

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/solar_forecast/planes/X/config

{
    "enable": true,
    "name": "Haus OS",
    "lat": 518847,
    "long": 86225,
    "dec": 25,
    "az": -43,
    "wp": 4725
}

Schreiben

Mit MQTT auf $PREFIX/solar_forecast/planes/X/config_update

mosquitto_pub -h $BROKER -t $PREFIX/solar_forecast/planes/X/config_update -m '{
    "enable": true,
    "name": "Haus OS",
    "lat": 518847,
    "long": 86225,
    "dec": 25,
    "az": -43,
    "wp": 4725
}'

Name	Bedeutung
enable bool	Aktiviert die PV-Fläche.
name string	Anzeige der PV-Fläche.
lat int (°/10000)	Breitengrad (z.B. 51,8847°)
long int (°/10000)	Längengrad (z.B. 8,6225°)
dec int (°)	Neigung (0° horizontal bis 90° vertikal)
az int (°)	Azimut (-180° = Norden, -90° = Osten, 0° = Süden, 90° = Westen, 180° = Norden)
wp int (Wp)	Peak-Leistung der PV-Fläche.

solar_forecast/planes/X/forecast

Beispiel

HTTP (curl)

# $HOST z.B. warp2-AbCd

Lesen

curl http://$HOST/solar_forecast/planes/X/forecast

MQTT (mosquitto)

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

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/solar_forecast/planes/X/forecast

{
    "first_date": 28899240,
    "resolution": 1,
    "forecast": [
        0, 0, 0, 0, 0, 0, 0, 0,
        0, 62, 270, 365, 405, 389, 326, 224,
        131, 0, 0, 0, 0, 0, 0, 0,
        0, 0, 0, 0, 0, 0, 0, 0,
        0, 166, 781, 1097, 1197, 1093, 864, 549,
        288, 0, 0, 0, 0, 0, 0, 0
    ]
}

Name	Bedeutung
first_date int	Ein Unix-Timestamp in Minuten, der angibt zu welchem Zeitpunkt die erste PV-Ertragsprognose im forecast-Array gilt.
resolution int	Auflösung der PV-Ertragsprognose im forecast-Array. 0 - 15 Minuten 1 - 60 Minuten
forecast int[49] (Wh)	Array von PV-Ertragsprognose-Werten für maximal zwei Tage. Das erste Element des Arrays ist für den Zeitpunkt first_date und die Auflösung legt fest wie weit die Elemente zueinander zeitlich versetzt sind.

warp3

solar_forecast/config

Die Konfiguration der PV-Ertragsprognose.

Beispiel

HTTP (curl)

# $HOST z.B. warp3-AbCd

Lesen

curl http://$HOST/solar_forecast/config

{
    "enable": true,
    "api_url": "https://api.forecast.solar/",
    "cert_id": -1
}

Schreiben

curl http://$HOST/solar_forecast/config -d '{
    "enable": true,
    "api_url": "https://api.forecast.solar/",
    "cert_id": -1
}'

MQTT (mosquitto)

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

Lesen

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

{
    "enable": true,
    "api_url": "https://api.forecast.solar/",
    "cert_id": -1
}

Schreiben

Mit MQTT auf $PREFIX/solar_forecast/config_update

mosquitto_pub -h $BROKER -t $PREFIX/solar_forecast/config_update -m '{
    "enable": true,
    "api_url": "https://api.forecast.solar/",
    "cert_id": -1
}'

Name	Bedeutung
enable bool	Gibt an, ob die PV-Ertragsprognose verwendet werden soll.
api_url string	Endpoint-URL des Servers für dynamische Strompreise.
cert_id int	ID des CA-Zertifikats, dass zur Prüfung des Zertifikats des RADIUS-Servers genutzt wird. Siehe certs/state.

solar_forecast/state

Der Zustand der PV-Ertragsprognose.

Beispiel

HTTP (curl)

# $HOST z.B. warp3-AbCd

Lesen

curl http://$HOST/solar_forecast/state

MQTT (mosquitto)

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

Lesen

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

{
    "rate_limit": 12,
    "rate_remaining": 7,
    "next_api_call": 28899847
}

Name	Bedeutung
rate_limit int	Gibt an wie viele API-Aufrufe alle zwei Stunden getätigt werden dürfen.
rate_remaining int	Gibt an wie viele API-Aufrufe im aktuellen Zeitfenster getätigt wurden.
next_api_call int	Gibt an wann der nächste API-Aufruf getätigt wird.

solar_forecast/planes/X/state

Status der PV-Flächen

Beispiel

HTTP (curl)

# $HOST z.B. warp3-AbCd

Lesen

curl http://$HOST/solar_forecast/planes/X/state

MQTT (mosquitto)

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

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/solar_forecast/planes/X/state

{
    "last_sync": 28899727,
    "last_check": 28899727,
    "next_check": 28899847,
    "place": "Helleforthstraße 22, 33758 Schloß Holte-Stukenbrock, Germany"
}

Name	Bedeutung
last_sync int	Ein Unix-Timestamp in Minuten, der angibt wann die PV-Ertragsprognose das letzte Mal aktualisiert wurden.
last_check int	Ein Unix-Timestamp in Minuten, der angibt wann die PV-Ertragsprognose das letzte Mal abgefragt wurden.
next_check int	Ein Unix-Timestamp in Minuten, der angibt wann die PV-Ertragsprognose das nächste Mal abgefragt werden.
place string	Ort der konfigurierten PV-Fläche.

solar_forecast/planes/X/config

Beispiel

HTTP (curl)

# $HOST z.B. warp3-AbCd

Lesen

curl http://$HOST/solar_forecast/planes/X/config

{
    "enable": true,
    "name": "Haus OS",
    "lat": 518847,
    "long": 86225,
    "dec": 25,
    "az": -43,
    "wp": 4725
}

Schreiben

curl http://$HOST/solar_forecast/planes/X/config -d '{
    "enable": true,
    "name": "Haus OS",
    "lat": 518847,
    "long": 86225,
    "dec": 25,
    "az": -43,
    "wp": 4725
}'

MQTT (mosquitto)

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

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/solar_forecast/planes/X/config

{
    "enable": true,
    "name": "Haus OS",
    "lat": 518847,
    "long": 86225,
    "dec": 25,
    "az": -43,
    "wp": 4725
}

Schreiben

Mit MQTT auf $PREFIX/solar_forecast/planes/X/config_update

mosquitto_pub -h $BROKER -t $PREFIX/solar_forecast/planes/X/config_update -m '{
    "enable": true,
    "name": "Haus OS",
    "lat": 518847,
    "long": 86225,
    "dec": 25,
    "az": -43,
    "wp": 4725
}'

Name	Bedeutung
enable bool	Aktiviert die PV-Fläche.
name string	Anzeige der PV-Fläche.
lat int (°/10000)	Breitengrad (z.B. 51,8847°)
long int (°/10000)	Längengrad (z.B. 8,6225°)
dec int (°)	Neigung (0° horizontal bis 90° vertikal)
az int (°)	Azimut (-180° = Norden, -90° = Osten, 0° = Süden, 90° = Westen, 180° = Norden)
wp int (Wp)	Peak-Leistung der PV-Fläche.

solar_forecast/planes/X/forecast

Beispiel

HTTP (curl)

# $HOST z.B. warp3-AbCd

Lesen

curl http://$HOST/solar_forecast/planes/X/forecast

MQTT (mosquitto)

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

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/solar_forecast/planes/X/forecast

{
    "first_date": 28899240,
    "resolution": 1,
    "forecast": [
        0, 0, 0, 0, 0, 0, 0, 0,
        0, 62, 270, 365, 405, 389, 326, 224,
        131, 0, 0, 0, 0, 0, 0, 0,
        0, 0, 0, 0, 0, 0, 0, 0,
        0, 166, 781, 1097, 1197, 1093, 864, 549,
        288, 0, 0, 0, 0, 0, 0, 0
    ]
}

Name	Bedeutung
first_date int	Ein Unix-Timestamp in Minuten, der angibt zu welchem Zeitpunkt die erste PV-Ertragsprognose im forecast-Array gilt.
resolution int	Auflösung der PV-Ertragsprognose im forecast-Array. 0 - 15 Minuten 1 - 60 Minuten
forecast int[49] (Wh)	Array von PV-Ertragsprognose-Werten für maximal zwei Tage. Das erste Element des Arrays ist für den Zeitpunkt first_date und die Auflösung legt fest wie weit die Elemente zueinander zeitlich versetzt sind.

wem

solar_forecast/config

Die Konfiguration der PV-Ertragsprognose.

Beispiel

HTTP (curl)

# $HOST z.B. wem-AbCd

Lesen

curl http://$HOST/solar_forecast/config

{
    "enable": true,
    "api_url": "https://api.forecast.solar/",
    "cert_id": -1
}

Schreiben

curl http://$HOST/solar_forecast/config -d '{
    "enable": true,
    "api_url": "https://api.forecast.solar/",
    "cert_id": -1
}'

MQTT (mosquitto)

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

Lesen

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

{
    "enable": true,
    "api_url": "https://api.forecast.solar/",
    "cert_id": -1
}

Schreiben

Mit MQTT auf $PREFIX/solar_forecast/config_update

mosquitto_pub -h $BROKER -t $PREFIX/solar_forecast/config_update -m '{
    "enable": true,
    "api_url": "https://api.forecast.solar/",
    "cert_id": -1
}'

Name	Bedeutung
enable bool	Gibt an, ob die PV-Ertragsprognose verwendet werden soll.
api_url string	Endpoint-URL des Servers für dynamische Strompreise.
cert_id int	ID des CA-Zertifikats, dass zur Prüfung des Zertifikats des RADIUS-Servers genutzt wird. Siehe certs/state.

solar_forecast/state

Der Zustand der PV-Ertragsprognose.

Beispiel

HTTP (curl)

# $HOST z.B. wem-AbCd

Lesen

curl http://$HOST/solar_forecast/state

MQTT (mosquitto)

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

Lesen

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

{
    "rate_limit": 12,
    "rate_remaining": 7,
    "next_api_call": 28899847
}

Name	Bedeutung
rate_limit int	Gibt an wie viele API-Aufrufe alle zwei Stunden getätigt werden dürfen.
rate_remaining int	Gibt an wie viele API-Aufrufe im aktuellen Zeitfenster getätigt wurden.
next_api_call int	Gibt an wann der nächste API-Aufruf getätigt wird.

solar_forecast/planes/X/state

Status der PV-Flächen

Beispiel

HTTP (curl)

# $HOST z.B. wem-AbCd

Lesen

curl http://$HOST/solar_forecast/planes/X/state

MQTT (mosquitto)

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

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/solar_forecast/planes/X/state

{
    "last_sync": 28899727,
    "last_check": 28899727,
    "next_check": 28899847,
    "place": "Helleforthstraße 22, 33758 Schloß Holte-Stukenbrock, Germany"
}

Name	Bedeutung
last_sync int	Ein Unix-Timestamp in Minuten, der angibt wann die PV-Ertragsprognose das letzte Mal aktualisiert wurden.
last_check int	Ein Unix-Timestamp in Minuten, der angibt wann die PV-Ertragsprognose das letzte Mal abgefragt wurden.
next_check int	Ein Unix-Timestamp in Minuten, der angibt wann die PV-Ertragsprognose das nächste Mal abgefragt werden.
place string	Ort der konfigurierten PV-Fläche.

solar_forecast/planes/X/config

Beispiel

HTTP (curl)

# $HOST z.B. wem-AbCd

Lesen

curl http://$HOST/solar_forecast/planes/X/config

{
    "enable": true,
    "name": "Haus OS",
    "lat": 518847,
    "long": 86225,
    "dec": 25,
    "az": -43,
    "wp": 4725
}

Schreiben

curl http://$HOST/solar_forecast/planes/X/config -d '{
    "enable": true,
    "name": "Haus OS",
    "lat": 518847,
    "long": 86225,
    "dec": 25,
    "az": -43,
    "wp": 4725
}'

MQTT (mosquitto)

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

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/solar_forecast/planes/X/config

{
    "enable": true,
    "name": "Haus OS",
    "lat": 518847,
    "long": 86225,
    "dec": 25,
    "az": -43,
    "wp": 4725
}

Schreiben

Mit MQTT auf $PREFIX/solar_forecast/planes/X/config_update

mosquitto_pub -h $BROKER -t $PREFIX/solar_forecast/planes/X/config_update -m '{
    "enable": true,
    "name": "Haus OS",
    "lat": 518847,
    "long": 86225,
    "dec": 25,
    "az": -43,
    "wp": 4725
}'

Name	Bedeutung
enable bool	Aktiviert die PV-Fläche.
name string	Anzeige der PV-Fläche.
lat int (°/10000)	Breitengrad (z.B. 51,8847°)
long int (°/10000)	Längengrad (z.B. 8,6225°)
dec int (°)	Neigung (0° horizontal bis 90° vertikal)
az int (°)	Azimut (-180° = Norden, -90° = Osten, 0° = Süden, 90° = Westen, 180° = Norden)
wp int (Wp)	Peak-Leistung der PV-Fläche.

solar_forecast/planes/X/forecast

Beispiel

HTTP (curl)

# $HOST z.B. wem-AbCd

Lesen

curl http://$HOST/solar_forecast/planes/X/forecast

MQTT (mosquitto)

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

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/solar_forecast/planes/X/forecast

{
    "first_date": 28899240,
    "resolution": 1,
    "forecast": [
        0, 0, 0, 0, 0, 0, 0, 0,
        0, 62, 270, 365, 405, 389, 326, 224,
        131, 0, 0, 0, 0, 0, 0, 0,
        0, 0, 0, 0, 0, 0, 0, 0,
        0, 166, 781, 1097, 1197, 1093, 864, 549,
        288, 0, 0, 0, 0, 0, 0, 0
    ]
}

Name	Bedeutung
first_date int	Ein Unix-Timestamp in Minuten, der angibt zu welchem Zeitpunkt die erste PV-Ertragsprognose im forecast-Array gilt.
resolution int	Auflösung der PV-Ertragsprognose im forecast-Array. 0 - 15 Minuten 1 - 60 Minuten
forecast int[49] (Wh)	Array von PV-Ertragsprognose-Werten für maximal zwei Tage. Das erste Element des Arrays ist für den Zeitpunkt first_date und die Auflösung legt fest wie weit die Elemente zueinander zeitlich versetzt sind.

wem2

solar_forecast/config

Die Konfiguration der PV-Ertragsprognose.

Beispiel

HTTP (curl)

# $HOST z.B. wem2-AbCd

Lesen

curl http://$HOST/solar_forecast/config

{
    "enable": true,
    "api_url": "https://api.forecast.solar/",
    "cert_id": -1
}

Schreiben

curl http://$HOST/solar_forecast/config -d '{
    "enable": true,
    "api_url": "https://api.forecast.solar/",
    "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/solar_forecast/config

{
    "enable": true,
    "api_url": "https://api.forecast.solar/",
    "cert_id": -1
}

Schreiben

Mit MQTT auf $PREFIX/solar_forecast/config_update

mosquitto_pub -h $BROKER -t $PREFIX/solar_forecast/config_update -m '{
    "enable": true,
    "api_url": "https://api.forecast.solar/",
    "cert_id": -1
}'

Name	Bedeutung
enable bool	Gibt an, ob die PV-Ertragsprognose verwendet werden soll.
api_url string	Endpoint-URL des Servers für dynamische Strompreise.
cert_id int	ID des CA-Zertifikats, dass zur Prüfung des Zertifikats des RADIUS-Servers genutzt wird. Siehe certs/state.

solar_forecast/state

Der Zustand der PV-Ertragsprognose.

Beispiel

HTTP (curl)

# $HOST z.B. wem2-AbCd

Lesen

curl http://$HOST/solar_forecast/state

MQTT (mosquitto)

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

Lesen

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

{
    "rate_limit": 12,
    "rate_remaining": 7,
    "next_api_call": 28899847
}

Name	Bedeutung
rate_limit int	Gibt an wie viele API-Aufrufe alle zwei Stunden getätigt werden dürfen.
rate_remaining int	Gibt an wie viele API-Aufrufe im aktuellen Zeitfenster getätigt wurden.
next_api_call int	Gibt an wann der nächste API-Aufruf getätigt wird.

solar_forecast/planes/X/state

Status der PV-Flächen

Beispiel

HTTP (curl)

# $HOST z.B. wem2-AbCd

Lesen

curl http://$HOST/solar_forecast/planes/X/state

MQTT (mosquitto)

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

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/solar_forecast/planes/X/state

{
    "last_sync": 28899727,
    "last_check": 28899727,
    "next_check": 28899847,
    "place": "Helleforthstraße 22, 33758 Schloß Holte-Stukenbrock, Germany"
}

Name	Bedeutung
last_sync int	Ein Unix-Timestamp in Minuten, der angibt wann die PV-Ertragsprognose das letzte Mal aktualisiert wurden.
last_check int	Ein Unix-Timestamp in Minuten, der angibt wann die PV-Ertragsprognose das letzte Mal abgefragt wurden.
next_check int	Ein Unix-Timestamp in Minuten, der angibt wann die PV-Ertragsprognose das nächste Mal abgefragt werden.
place string	Ort der konfigurierten PV-Fläche.

solar_forecast/planes/X/config

Beispiel

HTTP (curl)

# $HOST z.B. wem2-AbCd

Lesen

curl http://$HOST/solar_forecast/planes/X/config

{
    "enable": true,
    "name": "Haus OS",
    "lat": 518847,
    "long": 86225,
    "dec": 25,
    "az": -43,
    "wp": 4725
}

Schreiben

curl http://$HOST/solar_forecast/planes/X/config -d '{
    "enable": true,
    "name": "Haus OS",
    "lat": 518847,
    "long": 86225,
    "dec": 25,
    "az": -43,
    "wp": 4725
}'

MQTT (mosquitto)

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

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/solar_forecast/planes/X/config

{
    "enable": true,
    "name": "Haus OS",
    "lat": 518847,
    "long": 86225,
    "dec": 25,
    "az": -43,
    "wp": 4725
}

Schreiben

Mit MQTT auf $PREFIX/solar_forecast/planes/X/config_update

mosquitto_pub -h $BROKER -t $PREFIX/solar_forecast/planes/X/config_update -m '{
    "enable": true,
    "name": "Haus OS",
    "lat": 518847,
    "long": 86225,
    "dec": 25,
    "az": -43,
    "wp": 4725
}'

Name	Bedeutung
enable bool	Aktiviert die PV-Fläche.
name string	Anzeige der PV-Fläche.
lat int (°/10000)	Breitengrad (z.B. 51,8847°)
long int (°/10000)	Längengrad (z.B. 8,6225°)
dec int (°)	Neigung (0° horizontal bis 90° vertikal)
az int (°)	Azimut (-180° = Norden, -90° = Osten, 0° = Süden, 90° = Westen, 180° = Norden)
wp int (Wp)	Peak-Leistung der PV-Fläche.

solar_forecast/planes/X/forecast

Beispiel

HTTP (curl)

# $HOST z.B. wem2-AbCd

Lesen

curl http://$HOST/solar_forecast/planes/X/forecast

MQTT (mosquitto)

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

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/solar_forecast/planes/X/forecast

{
    "first_date": 28899240,
    "resolution": 1,
    "forecast": [
        0, 0, 0, 0, 0, 0, 0, 0,
        0, 62, 270, 365, 405, 389, 326, 224,
        131, 0, 0, 0, 0, 0, 0, 0,
        0, 0, 0, 0, 0, 0, 0, 0,
        0, 166, 781, 1097, 1197, 1093, 864, 549,
        288, 0, 0, 0, 0, 0, 0, 0
    ]
}

Name	Bedeutung
first_date int	Ein Unix-Timestamp in Minuten, der angibt zu welchem Zeitpunkt die erste PV-Ertragsprognose im forecast-Array gilt.
resolution int	Auflösung der PV-Ertragsprognose im forecast-Array. 0 - 15 Minuten 1 - 60 Minuten
forecast int[49] (Wh)	Array von PV-Ertragsprognose-Werten für maximal zwei Tage. Das erste Element des Arrays ist für den Zeitpunkt first_date und die Auflösung legt fest wie weit die Elemente zueinander zeitlich versetzt sind.

any

solar_forecast/config

Die Konfiguration der PV-Ertragsprognose.

Beispiel

HTTP (curl)

# $HOST z.B. warp-AbCd

Lesen

curl http://$HOST/solar_forecast/config

{
    "enable": true,
    "api_url": "https://api.forecast.solar/",
    "cert_id": -1
}

Schreiben

curl http://$HOST/solar_forecast/config -d '{
    "enable": true,
    "api_url": "https://api.forecast.solar/",
    "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/solar_forecast/config

{
    "enable": true,
    "api_url": "https://api.forecast.solar/",
    "cert_id": -1
}

Schreiben

Mit MQTT auf $PREFIX/solar_forecast/config_update

mosquitto_pub -h $BROKER -t $PREFIX/solar_forecast/config_update -m '{
    "enable": true,
    "api_url": "https://api.forecast.solar/",
    "cert_id": -1
}'

Name	Bedeutung
enable bool	Gibt an, ob die PV-Ertragsprognose verwendet werden soll.
api_url string	Endpoint-URL des Servers für dynamische Strompreise.
cert_id int	ID des CA-Zertifikats, dass zur Prüfung des Zertifikats des RADIUS-Servers genutzt wird. Siehe certs/state.

solar_forecast/state

Der Zustand der PV-Ertragsprognose.

Beispiel

HTTP (curl)

# $HOST z.B. warp-AbCd

Lesen

curl http://$HOST/solar_forecast/state

MQTT (mosquitto)

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

Lesen

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

{
    "rate_limit": 12,
    "rate_remaining": 7,
    "next_api_call": 28899847
}

Name	Bedeutung
rate_limit int	Gibt an wie viele API-Aufrufe alle zwei Stunden getätigt werden dürfen.
rate_remaining int	Gibt an wie viele API-Aufrufe im aktuellen Zeitfenster getätigt wurden.
next_api_call int	Gibt an wann der nächste API-Aufruf getätigt wird.

solar_forecast/planes/X/state

Status der PV-Flächen

Beispiel

HTTP (curl)

# $HOST z.B. warp-AbCd

Lesen

curl http://$HOST/solar_forecast/planes/X/state

MQTT (mosquitto)

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

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/solar_forecast/planes/X/state

{
    "last_sync": 28899727,
    "last_check": 28899727,
    "next_check": 28899847,
    "place": "Helleforthstraße 22, 33758 Schloß Holte-Stukenbrock, Germany"
}

Name	Bedeutung
last_sync int	Ein Unix-Timestamp in Minuten, der angibt wann die PV-Ertragsprognose das letzte Mal aktualisiert wurden.
last_check int	Ein Unix-Timestamp in Minuten, der angibt wann die PV-Ertragsprognose das letzte Mal abgefragt wurden.
next_check int	Ein Unix-Timestamp in Minuten, der angibt wann die PV-Ertragsprognose das nächste Mal abgefragt werden.
place string	Ort der konfigurierten PV-Fläche.

solar_forecast/planes/X/config

Beispiel

HTTP (curl)

# $HOST z.B. warp-AbCd

Lesen

curl http://$HOST/solar_forecast/planes/X/config

{
    "enable": true,
    "name": "Haus OS",
    "lat": 518847,
    "long": 86225,
    "dec": 25,
    "az": -43,
    "wp": 4725
}

Schreiben

curl http://$HOST/solar_forecast/planes/X/config -d '{
    "enable": true,
    "name": "Haus OS",
    "lat": 518847,
    "long": 86225,
    "dec": 25,
    "az": -43,
    "wp": 4725
}'

MQTT (mosquitto)

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

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/solar_forecast/planes/X/config

{
    "enable": true,
    "name": "Haus OS",
    "lat": 518847,
    "long": 86225,
    "dec": 25,
    "az": -43,
    "wp": 4725
}

Schreiben

Mit MQTT auf $PREFIX/solar_forecast/planes/X/config_update

mosquitto_pub -h $BROKER -t $PREFIX/solar_forecast/planes/X/config_update -m '{
    "enable": true,
    "name": "Haus OS",
    "lat": 518847,
    "long": 86225,
    "dec": 25,
    "az": -43,
    "wp": 4725
}'

Name	Bedeutung
enable bool	Aktiviert die PV-Fläche.
name string	Anzeige der PV-Fläche.
lat int (°/10000)	Breitengrad (z.B. 51,8847°)
long int (°/10000)	Längengrad (z.B. 8,6225°)
dec int (°)	Neigung (0° horizontal bis 90° vertikal)
az int (°)	Azimut (-180° = Norden, -90° = Osten, 0° = Süden, 90° = Westen, 180° = Norden)
wp int (Wp)	Peak-Leistung der PV-Fläche.

solar_forecast/planes/X/forecast

Beispiel

HTTP (curl)

# $HOST z.B. warp-AbCd

Lesen

curl http://$HOST/solar_forecast/planes/X/forecast

MQTT (mosquitto)

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

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/solar_forecast/planes/X/forecast

{
    "first_date": 28899240,
    "resolution": 1,
    "forecast": [
        0, 0, 0, 0, 0, 0, 0, 0,
        0, 62, 270, 365, 405, 389, 326, 224,
        131, 0, 0, 0, 0, 0, 0, 0,
        0, 0, 0, 0, 0, 0, 0, 0,
        0, 166, 781, 1097, 1197, 1093, 864, 549,
        288, 0, 0, 0, 0, 0, 0, 0
    ]
}

Name	Bedeutung
first_date int	Ein Unix-Timestamp in Minuten, der angibt zu welchem Zeitpunkt die erste PV-Ertragsprognose im forecast-Array gilt.
resolution int	Auflösung der PV-Ertragsprognose im forecast-Array. 0 - 15 Minuten 1 - 60 Minuten
forecast int[49] (Wh)	Array von PV-Ertragsprognose-Werten für maximal zwei Tage. Das erste Element des Arrays ist für den Zeitpunkt first_date und die Auflösung legt fest wie weit die Elemente zueinander zeitlich versetzt sind.