PV-Ertragsprogrnose

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

`solar_forecast/config`

Die Konfiguration der PV-Ertragsprognose.

Beispiel

HTTP (curl)
MQTT (mosquitto)

# $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
}'

# $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)
MQTT (mosquitto)

# $HOST z.B. warp-AbCd

Lesen

curl http://$HOST/solar_forecast/state

# $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)
MQTT (mosquitto)

# $HOST z.B. warp-AbCd

Lesen

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

# $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)
MQTT (mosquitto)

# $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
}'

# $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)
MQTT (mosquitto)

# $HOST z.B. warp-AbCd

Lesen

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

# $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

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.

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.

`solar_forecast/config`

Die Konfiguration der PV-Ertragsprognose.

Beispiel

HTTP (curl)
MQTT (mosquitto)

# $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
}'

# $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)
MQTT (mosquitto)

# $HOST z.B. warp2-AbCd

Lesen

curl http://$HOST/solar_forecast/state

# $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)
MQTT (mosquitto)

# $HOST z.B. warp2-AbCd

Lesen

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

# $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)
MQTT (mosquitto)

# $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
}'

# $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)
MQTT (mosquitto)

# $HOST z.B. warp2-AbCd

Lesen

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

# $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

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.

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)

`solar_forecast/config`

Die Konfiguration der PV-Ertragsprognose.

Beispiel

HTTP (curl)
MQTT (mosquitto)

# $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
}'

# $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)
MQTT (mosquitto)

# $HOST z.B. warp3-AbCd

Lesen

curl http://$HOST/solar_forecast/state

# $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)
MQTT (mosquitto)

# $HOST z.B. warp3-AbCd

Lesen

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

# $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)
MQTT (mosquitto)

# $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
}'

# $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)
MQTT (mosquitto)

# $HOST z.B. warp3-AbCd

Lesen

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

# $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

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.

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)

`solar_forecast/config`

Die Konfiguration der PV-Ertragsprognose.

Beispiel

HTTP (curl)
MQTT (mosquitto)

# $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
}'

# $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)
MQTT (mosquitto)

# $HOST z.B. wem-AbCd

Lesen

curl http://$HOST/solar_forecast/state

# $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)
MQTT (mosquitto)

# $HOST z.B. wem-AbCd

Lesen

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

# $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)
MQTT (mosquitto)

# $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
}'

# $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)
MQTT (mosquitto)

# $HOST z.B. wem-AbCd

Lesen

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

# $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

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.

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)

`solar_forecast/config`

Die Konfiguration der PV-Ertragsprognose.

Beispiel

HTTP (curl)
MQTT (mosquitto)

# $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
}'

# $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)
MQTT (mosquitto)

# $HOST z.B. wem2-AbCd

Lesen

curl http://$HOST/solar_forecast/state

# $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)
MQTT (mosquitto)

# $HOST z.B. wem2-AbCd

Lesen

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

# $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)
MQTT (mosquitto)

# $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
}'

# $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)
MQTT (mosquitto)

# $HOST z.B. wem2-AbCd

Lesen

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

# $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

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.

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)

`solar_forecast/config`

Die Konfiguration der PV-Ertragsprognose.

Beispiel

HTTP (curl)
MQTT (mosquitto)

# $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
}'

# $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)
MQTT (mosquitto)

# $HOST z.B. warp-AbCd

Lesen

curl http://$HOST/solar_forecast/state

# $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)
MQTT (mosquitto)

# $HOST z.B. warp-AbCd

Lesen

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

# $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)
MQTT (mosquitto)

# $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
}'

# $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)
MQTT (mosquitto)

# $HOST z.B. warp-AbCd

Lesen

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

# $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

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.

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)

solar_forecast/config​

Lesen​

Schreiben​

Lesen​

Schreiben​

solar_forecast/state​

Lesen​

Lesen​

solar_forecast/planes/X/state​

Lesen​

Lesen​

solar_forecast/planes/X/config​

Lesen​

Schreiben​

Lesen​

Schreiben​

solar_forecast/planes/X/forecast​

Lesen​

Lesen​

solar_forecast/config​

Lesen​

Schreiben​

Lesen​

Schreiben​

solar_forecast/state​

Lesen​

Lesen​

solar_forecast/planes/X/state​

Lesen​

Lesen​

solar_forecast/planes/X/config​

Lesen​

Schreiben​

Lesen​

Schreiben​

solar_forecast/planes/X/forecast​

Lesen​

Lesen​

solar_forecast/config​

Lesen​

Schreiben​

Lesen​

Schreiben​

solar_forecast/state​

Lesen​

Lesen​

solar_forecast/planes/X/state​

Lesen​

Lesen​

solar_forecast/planes/X/config​

Lesen​

Schreiben​

Lesen​

Schreiben​

solar_forecast/planes/X/forecast​

Lesen​

Lesen​

solar_forecast/config​

Lesen​

Schreiben​

Lesen​

Schreiben​

solar_forecast/state​

Lesen​

Lesen​

solar_forecast/planes/X/state​

Lesen​

Lesen​

solar_forecast/planes/X/config​

Lesen​

Schreiben​

Lesen​

Schreiben​

solar_forecast/planes/X/forecast​

Lesen​

Lesen​

solar_forecast/config​

Lesen​

Schreiben​

Lesen​

`solar_forecast/config`

Lesen

Schreiben

Lesen

Schreiben

`solar_forecast/state`

Lesen

Lesen

`solar_forecast/planes/X/state`

Lesen

Lesen

`solar_forecast/planes/X/config`

Lesen

Schreiben

Lesen

Schreiben

`solar_forecast/planes/X/forecast`

Lesen

Lesen

`solar_forecast/config`

Lesen

Schreiben

Lesen

Schreiben

`solar_forecast/state`

Lesen

Lesen

`solar_forecast/planes/X/state`

Lesen

Lesen

`solar_forecast/planes/X/config`

Lesen

Schreiben

Lesen

Schreiben

`solar_forecast/planes/X/forecast`

Lesen

Lesen

`solar_forecast/config`

Lesen

Schreiben

Lesen

Schreiben

`solar_forecast/state`

Lesen

Lesen

`solar_forecast/planes/X/state`

Lesen

Lesen

`solar_forecast/planes/X/config`

Lesen

Schreiben

Lesen

Schreiben

`solar_forecast/planes/X/forecast`

Lesen

Lesen

`solar_forecast/config`

Lesen

Schreiben

Lesen

Schreiben

`solar_forecast/state`

Lesen

Lesen

`solar_forecast/planes/X/state`

Lesen

Lesen

`solar_forecast/planes/X/config`

Lesen

Schreiben

Lesen

Schreiben

`solar_forecast/planes/X/forecast`

Lesen

Lesen

`solar_forecast/config`

Lesen

Schreiben

Lesen