RichPear HOME DOCS Začít

Integrace RichPear Home

ADS

ADS propojí RichPear Home s Beckhoff automatizačními zařízeními běžícími na TwinCAT přes rozhraní Automation Device Specification. Integrace je určena pro lokální PLC komunikaci a nastavuje se v configuration.yaml, ne přes průvodce v UI.

Začít konfiguraciZpět na audit
Doména
ads
Nastavení
configuration.yaml
Komunikace
local-push
Kvalita
legacy
01

Připravte údaje z TwinCAT

Před konfigurací potřebujete znát AMS NetId zařízení, ADS port a případně IP adresu ADS zařízení. Dokumentace RichPear Home uvádí, že port je typicky 801 nebo 851; přesná hodnota ale závisí na TwinCAT/AMS serveru, ke kterému se připojujete.

Pokud ip_address v konfiguraci nevyplníte, integrace použije první čtyři bajty z hodnoty device. U vzdálených PLC je obvykle přehlednější IP adresu uvést explicitně.

Co zkontrolovat předem

  1. AMS NetId: hodnota pro položku device, například 127.0.0.1.1.1.
  2. ADS port: číslo portu AMS serveru na zařízení, například 801 nebo 851.
  3. IP adresa: volitelná položka ip_address, pokud ji nechcete odvozovat z AMS NetId.
  4. Názvy proměnných: proměnné PLC pro senzory, spínače, světla, kryty, selecty nebo ventily.
02

Ověřte, že ADS není UI průvodce

V RichPear Home otevřete Nastavení → Zařízení a služby → Přidat integraci a vyhledejte ADS. RichPear Home integraci zobrazí, ale po otevření jasně potvrdí, že ji nelze přidat přes uživatelské rozhraní.

To odpovídá aktuální dokumentaci: ADS se zapíná ručním zápisem do configuration.yaml a po změně je potřeba restart služby RichPear Home.

ADS je v seznamu značek vidět, ale nejde o běžný průvodce nastavením.
03

Počítejte s ruční konfigurací

Po výběru ADS RichPear Home zobrazí upozornění, že integraci můžete přidat jen zápisem do configuration.yaml. Pokud spravujete instalaci sami, upravte konfiguraci v souboru a proveďte kontrolu konfigurace před restartem. U spravované instalace předejte níže uvedené hodnoty správci systému.

Ověřený český dialog: ADS vyžaduje konfiguraci v souboru.
04

Přidejte ADS hub do konfigurace

Základní část konfigurace definuje spojení s ADS zařízením. Položky device a port jsou povinné, ip_address je volitelná.

Základní příklad

ads:
  device: "127.0.0.1.1.1"
  port: 801
  ip_address: 192.0.2.20
05

Nakonfigurujte jen proměnné, které opravdu používáte

ADS nevytváří entity sám od sebe. Po nastavení hubu přidáváte jednotlivé platformy podle proměnných PLC. Každá platforma pracuje s názvem proměnné v adsvar; u TwinCAT2 se pro globální proměnné používá úvodní tečka, například .myvariable, zatímco u TwinCAT3 dokumentace uvádí tvar GBL.myvariable.

Podporované platformy

  1. Binary sensor: čte boolean proměnnou, volitelně s názvem a device_class.
  2. Light: ovládá boolean proměnnou zapnutí a volitelně jas nebo teplotu chromatičnosti v Kelvinech.
  3. Sensor: čte číselné typy včetně BOOL, BYTE, INT, UINT, DINT, UDINT, REAL a LREAL; factor slouží pro pevné desetinné hodnoty.
  4. Switch: přepíná boolean proměnnou.
  5. Cover: používá proměnnou stavu, kde true znamená zavřeno, a volitelné proměnné pro otevřít, zavřít, stop a pozici.
  6. Select: pracuje s ENUM/int proměnnou; doporučené jsou explicitní hodnoty začínající od 0.
  7. Valve: ovládá boolean proměnnou ventilu.
06

Ukázky platformových zápisů

Níže uvedené příklady drží strukturu dokumentace integrace. Názvy proměnných nahraďte skutečnými proměnnými ve vašem PLC projektu.

Senzor a spínač

sensor:
  - platform: ads
    adsvar: GVL.temperature
    unit_of_measurement: "°C"
    adstype: int
    factor: 10

switch:
  - platform: ads
    adsvar: .global_bool
    name: "PLC provoz"
07

Použijte akci pro zápis do PLC opatrně

Integrace registruje akci ads.write_data_by_name, která zapíše hodnotu do proměnné na ADS zařízení. Vyžaduje adsvar, adstype a value. Podporované typy pro zápis jsou bool, byte, dint, int, udint a uint.

Zápis do PLC proměnné může reálně změnit stav technologie. Nejdřív testujte na bezpečné proměnné nebo v odstaveném režimu zařízení a teprve potom akci používejte v automatizacích.

Příklad dat akce

action: ads.write_data_by_name
data:
  adsvar: ".myvariable"
  adstype: "int"
  value: 123
URL

Lokální adresa systému

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.