Firmata

Co integrace přidá

Firmata can be used to add analog and digital inputs and outputs to RichPear Home.

V RichPear Home počítejte hlavně s oblastmi: binární senzory, DIY, světla, senzory, spínače. Skutečný rozsah entit se řídí konkrétním zařízením, účtem, firmwarem, verzí služby a oprávněním.

Firmata can be used to add analog and digital inputs and outputs to RichPear Home.

The Firmata protocol is a standard protocol for microcontrollers.

There is currently support for the following device types within RichPear Home:

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

Před přidáním si připravte IP adresu, název hostitele, lokální síť, firewall a stabilní DHCP rezervaci. U zařízení, která ovládají fyzický stav domácnosti, si předem rozmyslete bezpečné názvy a oblasti.

RichPear Home se v domácí síti běžně otevírá na http://rphome.local:8123. Pokud tato adresa v dané síti neodpoví, použijte http://IP-ADRESA:8123.

Nastavení v RichPear Home

Tato integrace se nastavuje ručně v konfiguraci. Doplňte požadované položky, restartujte RichPear Home a potom ověřte integraci v Nastavení → Zařízení a služby.

# Example firmata configuration.yaml entry firmata : - serial_port : /dev/serial/by-id/usb-Teensyduino_USB_Serial_358320-if00 serial_baud_rate : 57600 switches : - name : my_light pin_mode : OUTPUT pin : 4 negate : true - name : my_other_output pin_mode : OUTPUT pin : 5 initial : true - name : my_light2 pin_mode : OUTPUT pin : A6 initial : true negate : true lights : - name : my_dimmable_light pin_mode : PWM pin : 6 - name : my_subset_light pin_mode : PWM pin : 10 initial : 0 minimum : 127 maximum : 200 - name : my_inverted_light pin_mode : PWM pin : 11 minimum : 255 maximum : 0 binary_sensors : - name : my_motion pin_mode : INPUT pin : 2 - name : my_door pin_mode : PULLUP pin : 3 negate : true - name : my_other_door pin_mode : INPUT pin : 16 # A2 negate : true sensors : - name : my_sensor pin : A0 pin_mode : ANALOG differential : 40

Po uložení počkejte na první načtení dat. Některé entity vzniknou hned, jiné až po prvním dotazu, probuzení zařízení, dokončení autorizace nebo restartu služby.

Kontrola entit a funkcí

U světel ověřte jas, barvu, efekty a stav po výpadku napájení. U senzorů ověřte jednotky, četnost aktualizace, historii a případné výpadky hodnot.

Otevřete detail integrace, projděte zařízení a přiřaďte je do správných oblastí. U senzorů sledujte jednotku a historii, u ovládacích entit ručně vyzkoušejte bezpečný stav.

Použití v automatizacích

Začněte jednoduchou scénou nebo upozorněním, potom přidejte podmínky pro čas, přítomnost a ruční režim.

Pokud integrace nabízí akce nebo služby, spusťte je nejdřív ručně v bezpečném kontextu a až potom je vložte do automatizace.

Provoz a údržba

Po změně účtu, tokenu, firmware, sítě nebo konfigurace zkontrolujte detail integrace, názvy entit, dashboardy a navazující automatizace.

U cloudových služeb sledujte limity API a platnost autorizace. U lokálních zařízení pravidelně kontrolujte dostupnost v síti, kvalitu spojení, stav baterií a čas poslední aktualizace.

Řešení problémů

Když integrace nefunguje podle očekávání, ověřte IP adresu, port, DNS, mDNS, VLAN, firewall a dostupnost zařízení ze stejné sítě, syntaxi konfigurace, odsazení, restart a chyby v logu po startu. Potom otevřete Nastavení → Systém → Logy a hledejte chyby podle domény firmata.

Integraci neodstraňujte jako první krok. Nejdřív ověřte přístupové údaje, síťovou dostupnost, podporovaný model, logy a poslední úspěšnou aktualizaci.