Better Heat Activator

PL Bardziej konfigurowalny Heat Activator. 
EN More customizable Heat Activator.

PL

Współdziała tylko z Heat Controllerami z zewnętrznymi czujnikami temperatury. 

Wymagane parametry:

• stoveId - id urządzenia sterującego piecem (włącznik)
• minBreaksNumber - minimalna liczba urządzeń na których musi być wykryta potrzeba ciepła, aby włączyć piec (wybierając np. 10 termostatów można wpisać wartość 2, aby pojedynczy termostat nie mógł włączyć pieca)
• deviceIds - lista id termostatów, oddzielone przecinkami (np. 11,22,33,41,123)
• turnOffMarigin i turnOnMarigin (sugerowane wartości to odpowiednio 0 i 1, można wpisywać wartości ułamkowe - np. 0.1 i 0.7):
  • zadanaTemperatura + turnOffMarigin <= actualTemperature - wtedy zostanie uznane, że ciepło nie jest wymagane
  • zadanaTemperatura - turnOnMarigin >= actualTemperature - wtedy zostanie uznane, że ciepło jest wymagane
  • w pozostałych przypadkach decyduje parametr heatRequired
• extThermId i extTempTreshold - jeśli jest podane extThermId (identyfikator zewnętrznego czujnika temperatury), to jeśli temperatura jest powyżej temperatury extTempTreshold to piec nie włączy się (np. jeśli na zewnątrz jest 25 stopni, to inne sprawdzanie temperatur i zapotrzebowania na ciepło nie będzie sprawdzane)
• opWindowsIgnore - jeśli wartość to TAK, to w przypadku, gdy na danej głowicy zostanie wykryte otwarcie okna, to taka głowica nie będzie mogła spowodować włączenia pieca
• offThermoIgnore - jeśli wartość to TAK, to w przypadku, gdy tryb danej głowicy to "OFF", to taka głowica nie będzie mogła spowodować włączenia pieca
• minBetweChanges - liczba minut, między kolejnymi przełączeniami stanu pieca

Oznacza to, że jeśli temperatura jest w przedziale -turnOnMarigin do +turnOffMarigin względem zadanej, to decyduje parametr heatRequired. Jeśli jednak jest za zimno - to bez względu na ten parametr i tak zostanie włączony piec, jeśli zaś za ciepło (lub w przypadku wpisania 0 w turnOffMarigin - temperatura zostanie osiągnięta) - ten termostat zostanie potraktowany jako niepotrzebujący ciepła. 

 

Uwagi: 

• quickApp nie posiada żadnych walidacji - wpisanie wartości ujemnych w pola turnOffMarigin i turnOfMarigin spowoduje prawdopodobnie dziwne zachowywanie się aplikacji
• pozostawiam kod otwarty, jeśli jednak ktoś zechce go zmieniać, to warto wysłać również do mnie zmianę - spróbuję tutaj ją nanieść 
• quickApp publikuję w wersji "jaka jest" - z możliwymi błędami
• w krótkim podsumowaniu na widoku są wyświetlone informacje o wszystkich wybranych termostatach. Składa się ona z kilku kolejnych części:
  • + / !!
    • + - termostat nie potrzebuje włączonego pieca
    • !! - termostat potrzebuje włączonego pieca
  • 22.2/22.0 - temperatura realna / temperatura zadana
  • nazwa termostatu
  • (off) / (> delta) / (< delta) / (heat) / (okno) / (100%) - ostateczny powód decyzji o zapotrzebowaniu na ciepło
    • off - (aby się pojawił, musi być ustawione offThermoIgnore) - termostat wyłączony, więc nie potrzebuje ciepła
    • > delta - temperatura wyższa o więcej niż delta od zadanej, więc nie ma potrzeby ciepła
    • < delta - temperatura niższa o więcej niż delta od zadanej, więc nie jest zapotrzebowanie ciepła
    • heat - termostat zgłasza zapotrzebowanie na ciepło (i znajduje się w przedziale, w którym to ten parametr decyduje)
    • okno - (aby się pojawił, musi być ustawione opWindowsIgnore) - termostat wykrył otwarte okno, więc nie zgłasza zapotrzebowania na ciepło
    • 100% - termostat działa na 100%, więc potrzebuje (każdej ilości) ciepła
  • [różne stany] - stany, które zostały wykryte i uwzględnione przy podejmowaniu decyzji (np. [heat 100%] oznacza, że głowica zgłasza zapotrzebowanie na ciepło oraz jest włączona na maksymale grzanie)

Wersje:

• 1.4 - tylko i wyłącznie poprawki co do wyglądu quickAppa
  
  

EN

Works only with Heat Controllers equipped with external temperature sensors.

 

Required parameters:

• stoveId - ID of the stove controller device (switch).
• minBreaksNumber - The minimum number of devices that must detect a need for heat to turn on the stove (e.g., when selecting 10 thermostats, you can set this value to 2, so that a single thermostat cannot turn on the stove).
• deviceIds - A list of thermostat IDs, separated by commas (e.g., 11,22,33,41,123).
• turnOffMargin and turnOnMargin (suggested values are 0 and 1 respectively, fractional values are allowed, e.g., 0.1 and 0.7):
  • setTemperature + turnOffMargin <= actualTemperature: heat will be deemed unnecessary.
  • setTemperature - turnOnMargin >= actualTemperature: heat will be deemed necessary.
  • In other cases, the heatRequired parameter will decide.
• extThermId and extTempThreshold - If extThermId (ID of an external temperature sensor) is provided, and the temperature exceeds extTempThreshold, the stove will not turn on (e.g., if the outdoor temperature is 25°C, other temperature and heat demand checks will not be performed).
• opWindowsIgnore - If set to YES, when an open window is detected for a specific valve, that valve will not be able to turn on the stove.
• offThermoIgnore - If set to YES, when a valve is in "OFF" mode, that valve will not be able to turn on the stove.
• minBetweenChanges - The number of minutes between state changes of the stove.

This means that if the temperature falls within the range defined by -turnOnMargin to +turnOffMargin relative to the set temperature, the heatRequired parameter will decide. However, if it is too cold, the stove will turn on regardless of this parameter. If it is too warm (or if the turnOffMargin is set to 0 and the temperature is reached), that thermostat will be treated as not requiring heat.

 

Notes:

• The quickApp does not perform any validations—entering negative values for turnOffMargin and turnOnMargin will likely result in strange app behavior.
• I am leaving the code open; if someone wishes to modify it, it would be appreciated if they could send me the changes so I can incorporate them here.
• The quickApp is published "as is" and may contain errors.
• A brief summary is displayed on the main view, showing information about all selected thermostats. It consists of several parts:
  • + / !!
    • + - The thermostat does not require the stove to be on.
    • !! - The thermostat requires the stove to be on.
  • 22.2/22.0 - Actual temperature / set temperature.
  • Thermostat name.
  • (off) / (> delta) / (< delta) / (heat) / (window) / (100%) - The final reason for the heat demand decision:
    • off - (Requires offThermoIgnore to be set) Thermostat is off, so it does not need heat.
    • > delta - Temperature exceeds the set value by more than the delta, so heat is not needed.
    • < delta - Temperature is below the set value by more than the delta, so heat is required.
    • heat - The thermostat reports a heat demand (and falls within the range where this parameter decides).
    • okno - (Requires opWindowsIgnore to be set) The thermostat detected an open window, so it does not report heat demand.
    • 100% - The thermostat is operating at 100%, thus it requires (any amount of) heat.
  • [various states] - States that were detected and considered in the decision-making process (e.g., [heat 100%] means the valve reports a heat demand and is set to maximum heating).

Versions:

• 1.4 - Cosmetic improvements only for the quickApp interface.

 

Ikona pobrana z / Icon taken from: https://www.freepik.com/icon/hot_16383527#fromView=search&page=1&position=4&uuid=914d5a77-b8a1-4364-9b6a-1a48f08f0189