RichPear HOME DOCS Začít

Senzory

Compensation

Compensation vytváří nový senzor z hodnoty jiného senzoru nebo atributu a aplikuje na ni korekci podle zadaných datových bodů.

Začít nastaveníZpět na integrace
Doména
compensation
Kategorie
senzory, utility
Komunikace
výpočet z existující entity
Nastavení
configuration.yaml
Výstup
kompenzovaný senzor
UI

Ukázka v RichPear Home

Screenshoty ukazují české rozhraní RichPear Home při vyhledání integrace a při prvním bezpečném kroku nastavení.

Vyhledání Compensation v katalogu integrací.
RichPear Home u Compensation ukazuje ruční konfiguraci v souboru configuration.yaml.
01

Co integrace přidá

Integrace vezme stav nebo atribut zdrojové entity a podle zadaných dvojic hodnot spočítá kompenzovanou hodnotu. Výchozí je lineární korekce; volitelně lze nastavit vyšší stupeň polynomu.

Výstupní entita ukládá také informace o zdroji a koeficientech. Hodí se pro kalibraci senzorů, převod rozsahu nebo opravu nelineární odchylky.

Kontrolní témata

  1. Povinný je zdrojový senzor a seznam data_points.
  2. Počet bodů musí odpovídat stupni polynomu plus jeden.
  3. Lze kompenzovat stav entity nebo konkrétní atribut.
  4. Volby lower_limit a upper_limit omezí výsledek mimo rozsah kalibračních bodů.
02

Příprava před přidáním

Naměřte si dvojice hodnot ve tvaru původní hodnota → správná hodnota. U lineární korekce potřebujete alespoň dva body, u kvadratické alespoň tři.

Rozmyslete jednotku, přesnost a zda má výstup dostat device class nebo state class pro dlouhodobé statistiky.

Korekci používejte jen tam, kde znáte skutečnou chybu měření. Špatně zvolené body mohou výsledek zhoršit.
03

Nastavení v RichPear Home

Přidejte konfiguraci do configuration.yaml a restartujte RichPear Home. Každý záznam pod compensation: vytvoří samostatný senzor.

compensation:
  teplota_kalibrovana:
    source: sensor.teplota_surova
    unit_of_measurement: '°C'
    precision: 1
    data_points:
      - [20.0, 20.6]
      - [25.0, 25.4]
04

Kontrola entit a funkcí

Porovnejte zdrojovou a kompenzovanou hodnotu u několika reálných měření. Ověřte, že jednotka, zaokrouhlení a historie odpovídají očekávání.

Pokud používáte limity, vyzkoušejte chování u hodnot mimo kalibrační rozsah.

Po nastavení

  1. Pojmenujte výstup tak, aby bylo jasné, že jde o kalibrovanou hodnotu.
  2. Zdrojový senzor nemažte, dokud ověření neskončí.
  3. Uložte si kalibrační body mimo YAML pro budoucí kontrolu.
  4. Po změně zdrojové entity zkontrolujte výpočet znovu.
05

Použití v automatizacích

V automatizacích používejte kompenzovaný senzor až po ověření proti reálnému měření. Pro kritické řízení přidejte toleranci a hysterezi.

Zdrojový i výstupní senzor se mohou krátce lišit při startu systému; automatizace by měly počítat s neznámým nebo nedostupným stavem.

06

Provoz a údržba

Po výměně čidla nebo změně jeho umístění znovu proveďte kalibraci. Staré kalibrační body nemusí platit.

U senzorů používaných pro statistiky ověřte, že se po změně jednotky nerozbije historie.

07

Řešení problémů

Když výstup nevznikne nebo má nesmyslné hodnoty, ověřte existenci zdrojové entity, typ hodnoty, počet datových bodů, stupeň polynomu, jednotku a odsazení YAML.

Potom otevřete Nastavení → Systém → Logy a hledejte chyby podle domény compensation. Integraci neodstraňujte jako první krok; nejdřív ověřte přístup, síť, konfiguraci a poslední úspěšnou aktualizaci.