Outside Temperature

The temperatures module allows configuration and reading of outdoor temperature forecasts. The daily average temperature is used by the heating module for the temperature heating curve.

warp1

Not supported on this hardware!

warp2

Not supported on this hardware!

warp3

Not supported on this hardware!

wem

Not supported on this hardware!

wem2

temperatures/config

The outside temperature configuration.

Example

HTTP (curl)

# $HOST e.g. wem2-AbCd

Read

curl http://$HOST/temperatures/config

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

Write

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 e.g. my_mosquitto.localdomain
# $PREFIX e.g. wem2/AbCd

Read

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
}

Write

With MQTT on $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	Description
enable bool	Indicates whether the temperature forecast is enabled.
source int	Source of the temperature data. 0 - Weather service 1 - Push
api_url string	Endpoint URL of the weather service server.
lat int (°/10000)	Latitude (e.g., 51.8846°)
long int (°/10000)	Longitude (e.g., 8.6251°)
cert_id int	ID of the CA certificate used to verify the certificate of the weather service server. See certs/state.

temperatures/state

The outside temperature state.

Example

HTTP (curl)

# $HOST e.g. wem2-AbCd

Read

curl http://$HOST/temperatures/state

MQTT (mosquitto)

# $BROKER e.g. my_mosquitto.localdomain
# $PREFIX e.g. wem2/AbCd

Read

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	Description
last_sync int	A Unix timestamp in minutes indicating when the temperature data was last successfully updated.
last_check int	A Unix timestamp in minutes indicating when the temperature data was last queried.
next_check int	A Unix timestamp in minutes indicating when the temperature data will be queried next.
current int	Current outdoor temperature in tenths of °C. 0x7FFF if not available.
today_min int	Minimum daily temperature for today in tenths of °C. 0x7FFF if not available.
today_max int	Maximum daily temperature for today in tenths of °C. 0x7FFF if not available.
today_avg int	Daily average temperature for today in tenths of °C. 0x7FFF if not available.
tomorrow_min int	Minimum daily temperature for tomorrow in tenths of °C. 0x7FFF if not available.
tomorrow_max int	Maximum daily temperature for tomorrow in tenths of °C. 0x7FFF if not available.
tomorrow_avg int	Daily average temperature for tomorrow in tenths of °C. 0x7FFF if not available.

temperatures/temperatures

Hourly temperature forecast.

Example

HTTP (curl)

# $HOST e.g. wem2-AbCd

Read

curl http://$HOST/temperatures/temperatures

MQTT (mosquitto)

# $BROKER e.g. my_mosquitto.localdomain
# $PREFIX e.g. wem2/AbCd

Read

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	Description
first_date int	A Unix timestamp in minutes indicating the time for which the first temperature value in the temperatures array is valid.
temperatures int[..]	Array of temperature values in tenths of °C. The first element of the array is for the time first_date, each subsequent element for the next hour.

temperatures/temperatures_update

Updates the temperature forecast via the API. Only works when the source is set to Push (1).

http

mqtt

Triggers a one-time action. Messages retained via the broker are ignored.

Example

HTTP (curl)

# $HOST e.g. wem2-AbCd

Write

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 e.g. my_mosquitto.localdomain
# $PREFIX e.g. wem2/AbCd

Write

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	Description
first_date int	A Unix timestamp in minutes indicating the time for which the first temperature value in the temperatures array is valid.
temperatures int[..]	Array of temperature values in tenths of °C. The first element of the array is for the time first_date, each subsequent element for the next hour.

any

temperatures/config

The outside temperature configuration.

Example

HTTP (curl)

# $HOST e.g. warp-AbCd

Read

curl http://$HOST/temperatures/config

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

Write

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 e.g. my_mosquitto.localdomain
# $PREFIX e.g. warp/AbCd

Read

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
}

Write

With MQTT on $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	Description
enable bool	Indicates whether the temperature forecast is enabled.
source int	Source of the temperature data. 0 - Weather service 1 - Push
api_url string	Endpoint URL of the weather service server.
lat int (°/10000)	Latitude (e.g., 51.8846°)
long int (°/10000)	Longitude (e.g., 8.6251°)
cert_id int	ID of the CA certificate used to verify the certificate of the weather service server. See certs/state.

temperatures/state

The outside temperature state.

Example

HTTP (curl)

# $HOST e.g. warp-AbCd

Read

curl http://$HOST/temperatures/state

MQTT (mosquitto)

# $BROKER e.g. my_mosquitto.localdomain
# $PREFIX e.g. warp/AbCd

Read

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	Description
last_sync int	A Unix timestamp in minutes indicating when the temperature data was last successfully updated.
last_check int	A Unix timestamp in minutes indicating when the temperature data was last queried.
next_check int	A Unix timestamp in minutes indicating when the temperature data will be queried next.
current int	Current outdoor temperature in tenths of °C. 0x7FFF if not available.
today_min int	Minimum daily temperature for today in tenths of °C. 0x7FFF if not available.
today_max int	Maximum daily temperature for today in tenths of °C. 0x7FFF if not available.
today_avg int	Daily average temperature for today in tenths of °C. 0x7FFF if not available.
tomorrow_min int	Minimum daily temperature for tomorrow in tenths of °C. 0x7FFF if not available.
tomorrow_max int	Maximum daily temperature for tomorrow in tenths of °C. 0x7FFF if not available.
tomorrow_avg int	Daily average temperature for tomorrow in tenths of °C. 0x7FFF if not available.

temperatures/temperatures

Hourly temperature forecast.

Example

HTTP (curl)

# $HOST e.g. warp-AbCd

Read

curl http://$HOST/temperatures/temperatures

MQTT (mosquitto)

# $BROKER e.g. my_mosquitto.localdomain
# $PREFIX e.g. warp/AbCd

Read

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	Description
first_date int	A Unix timestamp in minutes indicating the time for which the first temperature value in the temperatures array is valid.
temperatures int[..]	Array of temperature values in tenths of °C. The first element of the array is for the time first_date, each subsequent element for the next hour.

temperatures/temperatures_update

Updates the temperature forecast via the API. Only works when the source is set to Push (1).

http

mqtt

Triggers a one-time action. Messages retained via the broker are ignored.

Example

HTTP (curl)

# $HOST e.g. warp-AbCd

Write

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 e.g. my_mosquitto.localdomain
# $PREFIX e.g. warp/AbCd

Write

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	Description
first_date int	A Unix timestamp in minutes indicating the time for which the first temperature value in the temperatures array is valid.
temperatures int[..]	Array of temperature values in tenths of °C. The first element of the array is for the time first_date, each subsequent element for the next hour.