This component is a revision of the official Home Assistant component 'Generic Thermostat' in order to have possibility to have target temperature variable according to a sensor state value.
Use HACS to install the custom component and configure it through the user interface (settings/integration) to have easy and smooth usage.
If you are for the manual method:
Just copy paste the content of the climate.programmable_thermostat/custom_components folder in your config/custom_components directory.
As example you will get the '.py' file in the following path: /config/custom_components/programmable_thermostat/climate.py.
Config flow is available, so just configure all the entities you want through the user interface.
Here below the example of manual setup of sensor and parameters to configure.
climate:
- platform: programmable_thermostat
name: room
heater:
- switch.riscaldamento_1
- switch.riscaldamento_2
cooler: switch.condizionamento
actual_temp_sensor: sensor.target_temperature
min_temp: 10
max_temp: 30
target_temp_sensor: sensor.program_temperature
tolerance: 0.3
related_climate: climate.room_2
hvac_options: 7
auto_mode: all
min_cycle_duration:
seconds: 20| Field | Value | Necessity | Comments |
|---|---|---|---|
| platform | programmable_thermostat |
Required | |
| name | Programmable Thermostat | Optional | |
| heater | Conditional | Switch that will activate/deactivate the heating system. This can be a single entity or a list of entities. At least one between heater and cooler has to be defined. |
|
| cooler | Conditional | Switch that will activate/deactivate the cooling system. This can be a single entity or a list of entities. At least one between heater and cooler has to be defined. |
|
| actual_temp_sensor | Required | Sensor of actual room temperature. | |
| min_temp | 5 | Optional | Minimum temperature manually selectable. |
| max_temp | 40 | Optional | Maximum temperature manually selectable. |
| target_temp_sensor | Required | Sensor that rapresent the desired temperature for the room. Suggestion: use my file_restore compontent or something similar. |
|
| tolerance | 0.5 | Optional | Tolerance for turn on and off the switches mode. |
| initial_hvac_mode | heat_cool, heat, cool, off |
Optional | If not set, components will restore old state after restart. I suggest to not use it. |
| related_climate | Optional | To be used if the climate object is a slave of an other one. below 'Related climate' chapter a description. | |
| hvac_options | 7 | Optional | This define which combination of manual-auto-off options you want to active. Refer to chapter below for the value. |
| auto_mode | all, heating, cooling |
Optional | This allows to limit the the heating/cooling function with HVAC mode HEAT_COOL. |
| min_cycle_duration | Optional | TIMEDELTA type. This will allow to protect devices that request a minimum type of work/rest before changing status. On this you have to define hours, minutes, seconds as son elements. |
target_temp_sensor is the Home Assistant entity_id of a sensor which state change accrodingly a specified temperature profile. This temperature profile should described the desired temperature for the room each day/hour.
target_temp_sensor must have a temperature value (number with or without decimal) as state.
Suggestion: use my file_restore custom components.
Programmed temperature will change accordingly to the one set by the target_temp_sensor when in heat_cool mode. You can still change it temporarly with the slider. Target temperature will be set, again, to the one of target_temp_sensor at its first change.
heat and cool modes are the manual mode; in this mode the planning will not be followed.
After a restart of Home Assistant, room temperature and planned room temperature will match till actual_temp_sensor will return a temperature value.
This is done to avoid possible issues with Homekit support with temperature sensor that need some time to sync with Home Assistant.
This field is used if the climate 2 climate object are related each other, for example if they used the same heater.
Set this field with the entity_id with a different climate object and this will prevent the heater/cooler to be turned off by the slavery climate if the master one is active.
For example I have 2 climate objects, one for the room and one for the boiler.
Boiler's climate is used to prevent freezing and, if the temperature is lower the the programmed one, room heater is turned on.
This means that, if the room's heater is on and boiler's heater is off, boiler will turn off the heater despite the room one.
With this master_climate field this unwanted turn off will not happen.
Note: my suggestion is to set it to both climates that are related each other.
This parameter allows you to define which mode you want to activate for that climate object. This is a number with a meaning of each single bit. Here below the table.
| bit3 - AUTOMATIC | bit2 - MANUAL | bit1 - OFF | RESULT | Meaning |
|---|---|---|---|---|
| 0 | 0 | 0 | 0 | Noting active - USELESS |
| 0 | 0 | 1 | 1 | OFF only |
| 0 | 1 | 0 | 2 | MANUAL only, you will have only heat and/or cool modes |
| 0 | 1 | 1 | 3 | MANUAL and OFF |
| 1 | 0 | 0 | 4 | AUTOMATIC only, you will have only heat_cool modes |
| 1 | 0 | 1 | 5 | AUTOMATIC and OFF |
| 1 | 1 | 0 | 6 | AUTOMATIC and MANUAL |
| 1 | 1 | 1 | 7 | DEAFAULT - Full mode, you will have active all the options. |
From version 7.6 you will be able to set heaters and coolers to the same list and you'll get the correct way of work in manual mode.
This means that heat and cool mode will work correctly with the same list, but heat_cool mode will not (otherwise you will not be able to switch the real device between the 2 modes).
My suggestion is to set hvac_options: 3 to remove the auto mode.
This component has been developed for the bigger project of building a smart thermostat using Home Assistant and way cheeper then the commercial ones. You can find more info on that here
Everything is available through HACS.
Icons made by Freepik from www.flaticon.com
