aREST

Přidejte binární senzor pro pin

Pro digitální vstup použijte platformu arest pod binary_sensor. Zařízení musí vracet JSON s hodnotou return_value.

binary_sensor:
  - platform: arest
    resource: http://192.168.1.10
    pin: 8
    name: Dvere dilna

Čtěte proměnné a analogové piny

Pro číselné hodnoty použijte sensor. Můžete sledovat proměnné vystavené API nebo konkrétní piny, u analogových pinů s prefixem A.

sensor:
  - platform: arest
    resource: http://192.168.1.10
    monitored_variables:
      temperature:
        name: Teplota dilna
        unit_of_measurement: "°C"
    pins:
      A0:
        name: Analog A0

Ovládejte výstupní piny nebo funkce

Spínač může ovládat piny, volitelně s obrácenou logikou, nebo funkce vystavené aREST zařízením.

switch:
  - platform: arest
    resource: http://192.168.1.10
    pins:
      13:
        name: Rele svetlo
      11:
        name: Ventilator
        invert: true

Nepoužívejte pro rychlé změny

aREST je dotazovací integrace. Není vhodná pro velmi rychlé změny stavů, protože změna může proběhnout mezi dvěma aktualizacemi. Pro kritické vstupy použijte technologii s okamžitým push hlášením.

Struktura aREST odpovědí

Zařízení musí odpovídat REST API ve formátu, který obsahuje hodnotu return_value. RichPear Home z ní čte stav pinu, proměnnou nebo výsledek příkazu.

U analogových pinů používejte prefix A, například A0. U digitálních pinů ověřte, zda firmware vrací správně hodnoty 0 a 1.

Spínače a bezpečnost

Spínač přes aREST posílá příkazy do DIY zařízení. Před automatizací ručně ověřte, že povel mění správný výstup a že zařízení po restartu zachová bezpečný stav.

DIY zařízení dejte pevnou IP adresu a nepoužívejte ho pro kritické ovládání bez fyzické ochrany nebo záložního způsobu vypnutí.

Validace DIY zařízení

Před nasazením si v prohlížeči nebo přes curl otevřete každý endpoint a ověřte přesnou JSON odpověď. RichPear Home nemá jak opravit firmware, který vrací jiný klíč nebo nečíselnou hodnotu.

Při změně firmware si znovu projděte všechny piny a proměnné. U DIY zařízení se často změní číslování nebo názvy endpointů.