diff --git a/.nojekyll b/.nojekyll new file mode 100644 index 0000000..e69de29 diff --git a/404.html b/404.html new file mode 100644 index 0000000..7265490 --- /dev/null +++ b/404.html @@ -0,0 +1,789 @@ + + + +
+ + + + + + + + + + + + + + +In the adjustments, you can set your temperatures or enable/disable the calibration of your thermostats. +You can set these settings for a specific time, but also specify that they only apply on certain days or only when a specific schedule is active. The time is a mandatory field.
+Modifier | +Values | +Example | +Description | +
---|---|---|---|
🕔 Time | +HH:MM | +21:30 | +The time when the adjustment should take place. | +
📆 Days | +Mon, Tue, Wed, Thu, Fri, Sat, Sun | +['Mon','Fri'] | +Filter if the adjustment should only take place on certain days. | +
🗓️ Scheduler | +friendly name | +Heating Schedule | +Filter if the adjustment should only be set when a specific schedule is active. | +
🛋️ Comfort | +0-100 | +24 | +Modifier that changes the comfort temperature to a different value at the specified time. | +
🌱 Eco | +0-100 | +17 | +Modifier that changes the eco temperature to a different value at the specified time. | +
🧭 Calibration | +on/off | +on | +Modifier that can turn the calibration on or off. | +
Some thermostats only react to certain temperature differences. For example, with some thermostats, the target temperature must be 1°C higher than the room temperature.
+Target temperature | +Room temperature | +heating | +
---|---|---|
21° | +20° | +no | +
21° | +20.5 | +no | +
21° | +19.5° | +yes | +
Normal behavior without Aggressive Mode
+To counteract this, you can deliberately choose the target temperature to be higher or lower to cause heating or closing of the valve. You can dynamically implement this behavior with the Aggressive Mode.
+packet-beta
+ title Example: Target temperature = 20°, Range = 0.2°, Offset = 2°
+ 0-13: "Below the range: target temperature + offset"
+ 14-17: "Range: 19.8°-20.2°"
+ 18-31: "Above the range: target temperature - offset"
+You can set a range around your target temperature within which the actual temperature is set. This means: If the room temperature is within this range, the normal target temperature is set. However, if it is higher or lower, an offset is added.
+The offset indicates how many degrees are added to make your thermostat start heating. This is then added to the target temperature if the room temperature is outside the range you defined.
+Remember that the target temperature is modified and no longer corresponds to the actual target temperature.
+If your thermostat is calibrated natively, i.e., via a special entity, the Aggressive Mode can also be modulated to the calibration. This has the advantage that your thermostat always displays the correct target temperature. However, the locally measured temperature may then differ.
+ + + + + + + + + + + + + + + + + + +The away mode lowers the temperature if comfort is set and you briefly leave the house or room. You have several options for this.
+The offset that is subtracted from the current comfort temperature if the away mode is triggered. 0 means off.
+If this option is activated, the away mode is activated as soon as the active schedule is on but no one is at home. If the schedule is off and no one is at home, the eco temperature is set as usual.
+If someone is at home but no presence is detected, the away mode is activated.
+Presence | +Person | +Presence Schedule | +Mode | +
---|---|---|---|
Detected | +home | +not set | +Comfort | +
Not Detected | +home | +not set | +Away Mode | +
- | +not home | +no matter | +Eco | +
Detected | +home | +on | +Comfort | +
Not Detected | +home | +on | +Away Mode | +
Detected | +home | +off | +Eco | +
Not Detected | +home | +off | +Eco | +
If you want to ignore persons for the away mode enable this option.
+Presence | +Presence Schedule | +Mode | +
---|---|---|
Detected | +not set | +Comfort | +
Not Detected | +not set | +Eco | +
Detected | +on | +Comfort | +
Not Detected | +on | +Away Mode | +
Detected | +off | +Eco | +
Not Detected | +off | +Eco | +
If you have specified a room thermometer and your thermostats support native calibration, it is automatically active. Here you can fine-tune the calibration.
+To prevent your calibration from being triggered too frequently, you can set a timeout here. This time is a minimum interval between two calibration calls.
+This setting does not apply to Danfoss, Popp & Hive thermostats, as they need to be triggered more frequently to prevent the calibration value from being lost.
+To prevent calibration from being triggered by the slightest temperature change, you can specify a minimum distance here that must lie between the old calibration value and the new one for the calibration to be triggered.
+Room Temperature | +Thermostat Temperature | +Difference | +Calibration Delta | +Calibration | +
---|---|---|---|---|
20° | +20.5° | +0.5° | +1° | +No | +
20° | +21° | +1° | +1° | +Yes | +
Your thermostat usually has an entity for calibration. You can find this in the device overview in Home Assistant. All entities are named according to a specific schema. To ensure the automation selects the correct entity, you must specify the correct keyword here.
+Possible Entity ID | +Suggested Keyword | +
---|---|
number.room_thermostat_local_temperature_calibration | +local_temperature_calibration | +
number.room_thermostat_external_calibration | +external_calibration | +
number.room_thermostat_temperature_offset | +offset | +
Usually, the step size, i.e., the minimum adjustment of your calibration entities, is automatically determined. However, there are exceptions where the entity only accepts whole or smaller values than specified. Here you can override the automatic detection. Please pay attention to the Home Assistant log if this causes errors.
+If your thermostat does not support native calibration, you can enable Generic Calibration. In this case, the offset is added to the target temperature of your thermostat.
+Your thermostat will no longer display the actual temperature but a corrected one.
+Room Temperature | +Thermostat Temperature | +Difference | +Target Temperature | +Calibrated Target Temperature | +
---|---|---|---|---|
20° | +22° | +2° | +20° | +22° | +
22° | +20° | +2° | +20° | +18° | +
If the calculated offset is too high for you, you can limit it with this option.
+ + + + + + + + + + + + + + + + + + +Usually, the valves of your thermostats are always 100% open, except the target temperature is reached. To prevent your thermostat from behaving like a relay, i.e., only opening and closing, you can dynamically influence the valve position here.
+Your thermostat must support this and the respective integration must provide an entity for the valve opening.
+The positioning mode determines when and how much the valve is closed or opened. This depends on your rooms, the heating surface, the flow temperature, etc.
+Regular | +Optimisitc | +Pessimistic | +
---|---|---|
This is the default setting and should be chosen if the radiators and flow temperature are ideally matched to your room. | +Here the valve closes faster at the beginning because your radiators still have enough heat to heat the room or the flow temperature for the said room is set too high. | +Here the valve closes faster at the beginning because your radiators still have enough heat to heat the room or the flow temperature for the said room is set too high. | +
+
+ |
+
+
+ |
+
+
+ |
+
Here you can specify when the automation should modulate the valve opening depending on your target temperature. +In the graphs shown above, the target temperature is 20°. Modulation starts at 16°. So, a Positioning Temperature Difference of 4° is set here.
+The Step Size indicates the steps in which modulation occurs. The smaller the value, the more precise but also more frequent the valve position adjustment. You can choose from 5%, 10%, or 20%.
+If you have strong temperature fluctuations or have set a small Step Size, you can reduce the frequency of adjustments by setting a timeout here that must elapse between two adjustments before the automation adjusts the valve position again.
+Your thermostat must support valve positioning. If this is the case, you can find the respective entity in the overview of your thermostat. +Open the settings for the entity and look at the Entity ID. The keyword must partially match the Entity ID.
+Possible Entity ID | +Suggested Keyword | +
---|---|
number.room_thermostat_links_valve_opening_degree | +valve_opening_degree | +
The party mode activates the comfort mode and thus overrides schedules or presence sensors. Here you can use binary entities or timers. +If you append a number to the end of the friendly name, it will be interpreted as a temperature and set accordingly. +When the windows are opened, the thermostats are still turned off or down.
+Type | +Example | +
---|---|
binary_sensor | +binary_sensor.party | +
input_boolean | +input_boolean.party | +
timer | +timer.party | +
NOTE
+If you name your entity like Party Mode 25 the target temperature is set to 25° if the entity is enabled / running.
+Force Max temperature sets all thermostats to their maximum. Even if the windows are open, the thermostats remain at the highest level. +This function is to be used, for example, during the maintenance of the central heating system.
+This setting suppresses the comfort mode and sets the eco mode. The window detection still works.
+The restoration of temperatures is realized through temporary scenes. Some thermostats have problems with this method and do not return to the previous setting. +In this case this option can be activated. The temperature is determined by the automation but may differ from the previous one if the thermostat was manually adjusted.
+ + + + + + + + + + + + + + + + + + +Persons are used as triggers to set the comfort temperature. If one of the defined persons is at home, the comfort temperature is set. +For example, if schedules or presence sensors are also defined, they are evaluated together with the persons in a logic.
+An overview explaining the logic will follow later in the documentation.
+Here you specify the persons who usually occupy the room to be heated.
+Sometimes you just need to be in the apartment briefly without heating. Therefore, a time tolerance can be specified for how long a person must be at home before the heating starts.
+Sometimes you just leave the house for a few minutes. To avoid unnecessarily draining the batteries of the thermostats, you can prevent setting the eco temperature by also setting a time tolerance here.
+If you have guests in the house but you are not at home, you can specify a boolean entity here that you can manually trigger. Even if you do not use the person integration, you can specify a boolean entity here that has its own logic to simulate persons being at home.
+ + + + + + + + + + + + + + + + + + +With presence detection, you can set the comfort temperature if presence or movement is detected. Furthermore, you can also integrate your own binary sensors and use them as presence sensors.
+An overview explaining the logic will follow later in the documentation.
+Here you can specify your presence entity. This can be an input boolean or a binary sensor.
+Some presence sensors need to be debounced since they are triggering too often. Have a look in the Helpful Snippet Section.
+Mit einem Präsenz Schedule kannst du zeitliche Bereiche festlegen, an denen die Präsenzerkennung zum tragen kommen darf.
+ +To prevent the comfort temperature from being set if you only briefly enter the room, you can set a time tolerance here. The sensor must continuously detect presence for this period for the comfort temperature to be set.
+To prevent the eco temperature from being set immediately when you briefly leave the room, you can set a period here during which no presence must be detected for the temperature to fall back to the eco temperature.
+ + + + + + + + + + + + + + + + + + +You can setup home assistants proximity integration and provide the generated device here. Combined with a specified ditance and the travel direction comfort heating can be triggered.
+Mode | +Distance | +Direction | +
---|---|---|
Comfort | +within the distance | +arrived | +
+ | + | towards | +
Eco | +outside the distance | +- | +
+ | within the distance | +away_from | +
+ | + | stationary | +
Specify your proximity entity here.
+The duration a person must be at home or moving within the distance to your home for the comfort temperature to be set.
+The maximum distance that persons can be from your home for the comfort temperature to be set.
+ + + + + + + + + + + + + + + + + + +Mit Schedules kannst du einen einfachen Heizplan erstellen mit dem du zwischen der Eco und der Comfort Temperatur wechseln kannst. Weiterhin kannst du mit den Heating Adjustments und auch mit Personen Einfluss auf das Verhalten und auf die Temperaturen nehmen.
+An overview explaining the logic will follow later in the documentation.
+Here you can add your schedules. Schedules are helpers that you can easily create in your Home Assistant.
+ +You can set as many schedules as you like. To select a schedule, you can do it by providing a Schedule Selector.
+Here you can specify an entity that determines the selection of the active schedule. If you only have one schedule, you can ignore this point. +If you want to switch between two schedules, a binary entity is sufficient. However, you can also specify entities whose status is a number, thus activating the respective scheduler. Entities that hold text as status are also possible. The value is then matched with the friendly name of the respective schedule. It only needs to partially match.
+Type | +Possible Values | +Example | +Description | +
---|---|---|---|
binary_sensor | +on, off | +on | +Selects the 2nd of max two schedules | +
input_boolean | +on, off | +off | +Selects the 1st of max two schedules | +
input_text | +custom text, integers | +Holiday | +Selects the first schedule that contains the word Holiday in its friendly name | +
input_number | +integers | +3 | +Selects the 3rd schedule | +
input_select | +custom text, integers | +Workday Schedule | +Selects the first schedule that contains the Workday Schedule in its friendly name | +
If your heating schedule is off or nobody triggers your presence sensor the automation sets the eco temperature. Enable this option to turn off the climates instead.
+If the automation detects open windows or the winter mode is turned off the automation sets the thermostats to off. Enable this option to set the eco temperature instead.
+If Fahrenheit is your unit enable this option.
+Experimental
+This feature is still untested. If you experience any issues, please let me know.
+Enable this option to reset your temperature entities after a switch between eco and comfort temperature.
+sequenceDiagram
+ autonumber
+ ECO->>COMFORT: Eco Temperature Reset
+ COMFORT-->>ECO: Comfort Temperature Reset
+If the room temperature hits the target temperature your climates get turned off. For HVAC Mode Cool the room temperature must be lower or equal before the climates get turned off.
+If you want to synchronize a manually set temperature with your other thermostats or temperature entities, you can activate this option.
+Experimental
+This feature has several side effects. It's not recommended to enable this option in a combination with generic calibration or aggressive mode.
+The comfort temperature is the temperature that is set when you might be at home or your presence sensor is triggered or your heating schedule is on. +This temperature setting serves as a fallback temperature. If a static temperature is sufficient for you and you do not want to adjust it further via the UI, this setting is sufficient. +However, temporal temperature adjustments can be made via the adjustments.
+The eco temperature is the temperature that is set when you are not at home, for example, or your schedule does not prescribe heating to the comfort temperature. +This temperature setting serves as a fallback temperature. If a static temperature is sufficient for you and you do not want to adjust it further via the UI, this setting is sufficient. +However, temporal temperature adjustments can be made via the adjustments.
+If you want to control the comfort temperature via the UI, you can specify an input number helper here. This overrides the static comfort temperature.
+If you want to control the eco temperature via the UI, you can specify an input number helper here. This overrides the static eco temperature.
+ + + + + + + + + + + + + + + + + + +In the first step, you need to specify your thermostats or the climate entities that your new AHC automation should control.
+Here you select the manual heating mode of your thermostats so that AHC can take full control. Usually, the manual HVAC mode is heat. However, for some thermostats this mode also stands for the boost mode and another mode like auto must be selected.
+The sensor of your room temperature is useful for many features: It ensures the accurate calibration of your thermostats and can be used for functions that are described in other sections here.
+ + + + + + + + + + + + + + + + + + +To ensure your thermostats deactivate or lower the temperature when your doors or windows are open, you need to add your contact sensors here.
+Thermostats that do not support the off mode are automatically set to their minimum temperature.
+Füge hier deine Türen und Fenster hinzu, auf die deine Automation reagieren soll.
+Here you can set a time that your windows or doors must be open before your thermostats are lowered. This prevents the thermostats from lowering just because you briefly open the door, for example, to leave the house.
+If your window briefly slams shut due to the wind or you want to wait a while until your room acclimatizes, you can set a duration here that the window must be closed before your thermostats are reset to their original state.
+If you only want to lower your thermostats slightly when the window is open, for example, to save battery or because it is so cold that the pipes might freeze, you can set a temperature here that will be applied in this case.
+ + + + + + + + + + + + + + + + + + +