balmli/no.almli.thermostat

Virtual thermostat and humidity app for Athom Homey

Virtual thermostat and humidity app

Device: VThermo

Add a virtual thermostat to a zone with a temperature sensor and it will turn on / off heaters in the same zone. The virtual thermostat will start operating when the target temperature has been set.

Use a door/window sensor in the same zone to automatically turn off the heater on a contact alarm. This can be enabled with the 'Turn off if contact alarm' - checkbox in 'Advanced settings'.

Master thermostat

The virtual thermostat can be used as a 'master thermostat'. As a master thermostat it will update the target temperature of other thermostats. Not only other VThermo - termostats, but standard phyical thermostats as well.

In Advanced settings, you can choose zones to control:

• same zone
• sub zones, just one level down
• all sub zones, all levels down

Select 'Update other thermostats' to update other thermostats and 'Update other VThermos' to update other virtual thermostats.

Temperature sensors

You can select the temperature sensors the virtual thermostat will take into consideration when calculation its temperature.

In Advanced settings, you can choose the types of temperature sensors: standard, other thermostats, other VThermo - thermostats and other devices with a temperature capability.

You can use temperature sensors from the same zone, from the parent zone, and from the sub zones.

Triggers

• Turned on
• Turned off
• The target temperature changed
• The temperature became greater than X °C
• The temperature became less than X °C
• The temperature changed
• Heating turned off
• Heating turned on

Conditions

• Is switched on / off
• Thermostat is active / idle

Actions

• Turn on
• Turn off
• Toggle on / off
• Set the target temperature
• Enable / disable 'Invert switch'
• Update temperature to X °C
• Update target temperature min, max and step
• Update target temperature offset
• Enable / disable target temperature update

Device: VHumidity

Add a virtual humidity controller to a zone with a humidity sensor and it will turn on / off fans in the same zone.

Fans will turn on if the humidity is larger than the target humidity, and off if less than the target humidity. For humidifiers the logic can be inverted, by selecting the 'Invert for humidifier' - checkbox in 'Advanced settings'.

Triggers

• Turn on
• Turn off
• Toggle on / off
• The humidity became greater than X
• The humidity became less than X
• The humidity changed
• Humidity device turned off
• Humidity device turned on
• Target humidity changed

Conditions

• Is switched on / off
• Humidity has decreased more than X % points last Y minutes
• Humidity has increased more than X % points last Y minutes
• Humidity device is active/idle

Actions

• Turn on
• Turn off
• Toggle on / off
• Set the target humidity

Details about Advanced settings

Temperature

• Temperature calculation method: select between 'Average', 'Minimum', 'Maximum', 'Newest' or 'Manual'. Manual is used when updating the temperature with a flow, e.g. from a temperature sensor in another zone.
• Validate temperatures: to only accept temperatures in the validate min / max range. This can be used if the temperature sensor reports invalid temperatures, eg. 0 or 100 °C.
• Minimum validate temperature (°C): temperatures below this value will not be used when calculating the temperature.
• Maximum validate temperature (°C): temperatures above this value will not be used when calculating the temperature.
• Ignore old measurements: to ignore old measurements, set a value larger than 0. A value of eg. 7200 will ignore meaurements older than 2 hours (7200 seconds). Only used for Average, Minimum and Maximum, and when there are two or more sensors.

Temperature sensors in the same zone

Select which temperature sensors to be used from the same zone as the virtual thermostat.

• standard temperature sensors
• other thermostats
• other devices with a temperature capability

Temperature sensors from the parent zone

Select temperature sensors from the parent zone of the virtual thermostat:

• standard temperature sensors
• other thermostats
• other VThermo - thermostats
• other devices with a temperature capability

Temperature sensors from sub zones (one level)

Select temperature sensors from the sub zones of the virtual thermostat, just one level down.

• standard temperature sensors
• other thermostats
• other VThermo - thermostats
• other devices with a temperature capability

Control devices in the same zone

• Heaters: uncheck this if controlling heaters in the same zone is not desired.
• Thermostats: check this to control thermostats in the same zone. This is achieved by setting the target temperature above / below the measured temperature.

Control devices in sub zones (one level)

• Heaters: check this to control heaters in sub zones (one level down)
• Thermostats: check this to control thermostats in sub zones (one level down). This is achieved by setting the target temperature above / below the measured temperature.

Target temperature

• Target temperature offset (°C): offset when the target temperature is updated from a master VThermo - thermostat.
• Target temperature update enabled: uncheck to disable being updated from a master VThermo - thermostat.
• Minimum target temperature (°C): minimum value for the target temperature between -10 °C and 150 °C.
• Maximum target temperature (°C): maximum value for the target temperature between -10 °C and 150 °C.
• Target temperature step (°C): select between step of 0.25 °C and 0.50 °C for the target temperature.

Target temperature in the same zone

• From other thermostat: check this to update target temperature on this VThermo from another thermostat in the same zone.
• Update other thermostats: check this to update the target temperature of other thermostats in the same zone.

Target temperature to sub zones (one level)

• Update other VThermos: check this to update the target temperature of other VThermo - thermostats in sub zones (one level down).
• Update other thermostats: check this to update the target temperature of other thermostats in sub zones (one level down).

Target temperature to sub zones (all levels)

• Update other VThermos: check this to update the target temperature of other VThermo - thermostats in all sub zones (all levels down).
• Update other thermostats: check this to update the target temperature of other thermostats in all sub zones (all levels down).

Contact and motion alarms

• Turn off if contact alarm: check this to turn off heaters if there is a contact alarm in the same zone as the virtual thermostat.
• Turn on if motion alarm: check this to turn on heaters if there is a motion alarm in the same zone as the virtual thermostat.

General settings

• Hysteresis: to avoid that the thermostat will turn on and off too often, the hysteresis value must be greater than zero. Example: with a value of 0.5, and a target temperature of 20.0 °C, the thermostat will switch on if below 20.0 - 0.5, and off if above 20.0 + 0.5.
• Invert switch: check this and the thermostat will switch on if above the target, and switch off if below the target.
• On / off enabled: uncheck this to disable the thermostat On / Off - switch.

Timing

• Delay in milliseconds between switching devices: if this value is set to a number larger than zero, it will add a delay between switching each devices on / off. This might help

Feedback:

Please report issues at the issues section on Github.

Release Notes:

1.10.4

• Fixes for Homey Pro 2023

1.10.3

• Fixes for Homey Pro 2023

1.10.2

• Fixes for Homey Pro 2023

1.10.1

• Fixes for homey-api and Homey Pro 2023

1.10.0

• Updated to homey-api

1.9.2

• Avoid black screen in mobile app for 'Heating turned off' trigger

1.9.1

• Added option to ignore measurements older than X seconds

1.9.0

• Added option to ignore temperature measurements older than X seconds

1.8.5

• Fixed switching for fans in VHumidity

1.8.4

• Changes to "virtual class" must be taken into account

1.8.3

• Fixed manual setting of temperature
• Fixed brand color

1.8.2

• Added option to control physical thermostats

1.8.1

• Fixed VHumidity Humidity has increased/decreased conditions

1.8.0

• Added option to validate temperatures
• Stability improvements
• Migrated to SDK3

1.7.0

• Added flow to manually update the temperature, e.g. from a temperature sensor in another zone

1.6.0

• Added setting and action to update 'Target temperature update enabled'
• Added setting to turn on if motion alarm in the same zone

1.5.1

• Min. and max. target temperatures can be updated between -10 °C and +150 °C

1.5.0

• Min. and max. target temperatures can be updated between -10 °C and +60 °C
• Added flow to update 'Target temperature min, max and step'
• Added flow to update 'Target temperature offset'

1.4.0

• Added setting to change step for target temperature
• Added flow to update 'Invert switch'

1.3.8

• Skip values from unavailable devices

1.3.7

• Updated community id

1.3.6

• Fix to refresh devices on app updates

1.3.5

• Fix to refresh devices on a fixed interval

1.3.4

• Fixed bug in 'On / off enabled'

1.3.3

• Fixed change log.

1.3.2

• Fixed initialization bug.

1.3.1

• Added support to control heaters in sub zones (one level down).

1.2.3

• Added 'Newest' as calculation method for temperature and humidity.
• Handle adding several devices at the same time.
• Updated Athom api.

1.2.2

• Fixed refresh bug in VHumidity.

1.2.1

• Allow update both from and to another thermostat.

1.2.0

• Added support for master thermostats, e.g. update target temperatures on other thermostats.
• Added support for temperatures from other zones.
• Added calculation methods for temperature and humidity (average, minimum, maximum).
• Reduced memory consumption.

1.1.21

• Added setting to disable switching devices off.
• Added on / off capability for VHumidity.
• Added view for the target humidity for VHumidity.

1.1.20

• Updated Athom api.

1.1.19

• Avoid triggers firing two times.

1.1.18

• Update temperature and humidity even if the target has not been set.

1.1.17

• You can set a delay after each device has been switched on / off.
• Thermostats can be used as temperature sensors.

1.1.16

• Fixes to avoid timeouts.

1.1.15

• Timeout fixes.

1.1.14

• VThermo: Added an option to invert switching.

1.1.13

• Updated Athom api.
• Fix timeouts, issue #23.

1.1.11

• Updated Athom api.
• VThermo: added option to turn off if contact alarm.

1.1.10

• VHumidity: Added condition 'Humidity has increased more than [x] % points last [y] minutes'
• VHumidity: Added condition 'Humidity has decreased more than [x] % points last [y] minutes'
• Updated athom-api
• VThermo: only trigger on/off if on/off has changed.
• VHumidity: only trigger on/off if on/off has changed.

1.1.7

• Bugfix, ref. issue #18

1.1.5

• Updated athom-api
• Possible to turn on / off directly from the app (quick-toggle, device must be reinstalled)

1.1.4

• VHumidity: Added an option to support humidifiers.

1.1.3

• Added tests
• Minor bug fixes

1.1.2

• Support switching virtual devices (heaters and fans).
• Catch errors when switching heaters and fans on or off.

1.1.1

• Fix if zero (0) degrees.

1.1.0

• Added VHumidity device

1.0.1

• Changed min. temperature from 5 to 1 deg.

1.0.0

• Stable for app store