Lokální Wi-Fi spínač

Ankuoo REC Switch

Ankuoo REC Switch přidá do RichPear Home lokálně ovládaný spínač pro kompatibilní Wi-Fi zásuvky a moduly. Po nastavení se každý uvedený kus zobrazuje jako samostatná entita typu switch.

Doména
recswitch
Platforma
switch
Komunikace
lokální dotazování
Nastavení
configuration.yaml
Povinné údaje
IP adresa nebo host a MAC adresa
01

Kompatibilní zařízení

Integrace je určena pro zařízení používající protokol REC Switch. Uváděné kompatibilní modely jsou Ankuoo RecSwitch MS6126, Lumitek CSW201 NEO WiFi a MALMBERGS CSW201.

Jiný Wi-Fi spínač nepřidávejte jen podle vzhledu nebo podle podobné mobilní aplikace. Potřebuje stejný lokální komunikační protokol, jinak se po restartu nevytvoří funkční entita nebo nebude reagovat na příkazy.

Tato integrace nepoužívá cloudový účet ani API klíč. Spínač ale musí být předem připojený k domácí Wi-Fi síti a dosažitelný z jednotky, na které běží RichPear Home.
02

Příprava v síti

Před úpravou konfigurace si připravte IP adresu nebo DNS jméno spínače a jeho MAC adresu. MAC adresa se používá jako jednoznačný identifikátor zařízení, proto ji opisujte včetně dvojteček.

V routeru nastavte DHCP rezervaci nebo jiný stabilní způsob adresování. Pokud spínač po restartu routeru dostane jinou IP adresu, RichPear Home ho bude dál hledat na původní adrese.

Síťová kontrola

  1. Spínač je připojený ke stejné lokální síti nebo k síti, ze které je povolená komunikace k jeho IP adrese.
  2. Firewall mezi sítěmi neblokuje lokální UDP komunikaci na portu 18530.
  3. Wi-Fi signál je stabilní i v místě, kde bude spínač trvale používaný.
03

Přidejte spínač do configuration.yaml

Integrace se nastavuje ručně v YAML konfiguraci pod sekcí switch. Povinné položky jsou platform, host a mac. Volitelná položka name určí název entity v rozhraní.

switch:
  - platform: recswitch
    host: "192.168.1.45"
    mac: "F0:FE:6B:12:34:56"
    name: "Zasuvka lampa obyvak"

Po uložení konfigurace proveďte kontrolu konfigurace a restartujte RichPear Home. Pokud přidáváte více spínačů, vložte každý jako samostatnou položku pod switch s vlastní adresou a MAC adresou.

Více spínačů

switch:
  - platform: recswitch
    host: "192.168.1.45"
    mac: "F0:FE:6B:12:34:56"
    name: "Zasuvka lampa obyvak"
  - platform: recswitch
    host: "192.168.1.46"
    mac: "F0:FE:6B:65:43:21"
    name: "Zasuvka pracovna"
Vyhledání ukáže, že spínač se přidává ruční konfigurací.
RichPear Home zde odkazuje na ruční konfiguraci v configuration.yaml.
04

Entity a dostupné akce

Pro každý nakonfigurovaný kus vznikne jedna entita typu switch. Stav entity odpovídá relé spínače: zapnuto znamená sepnutý výstup, vypnuto znamená rozepnutý výstup.

Integrace nepřidává vlastní speciální akce. V automatizacích, skriptech a dashboardech používejte běžné akce spínače: switch.turn_on, switch.turn_off a podle potřeby switch.toggle.

První kontrola po restartu

  1. Otevřete detail entity a zkontrolujte aktuální stav.
  2. Ručně zapněte a vypněte spínač v bezpečném okamžiku.
  3. Porovnejte stav v RichPear Home s fyzickým výstupem spínače.
  4. Potom entitu přejmenujte podle místnosti a připojeného spotřebiče.
05

Příklady automatizací

U zásuvek a spínacích modulů začínejte jednoduchou automatizací s jasnou podmínkou. Vyhněte se rychlému opakovanému zapínání a vypínání, hlavně u čerpadel, topení, motorů, kompresorů a dalších zátěží s rozběhovým proudem.

automation:
  - alias: "Vecerni lampa v obyvacim pokoji"
    trigger:
      - platform: time
        at: "19:00:00"
    action:
      - action: switch.turn_on
        target:
          entity_id: switch.zasuvka_lampa_obyvak
    mode: single
automation:
  - alias: "Vypnout pracovnu na noc"
    trigger:
      - platform: time
        at: "23:30:00"
    condition:
      - condition: state
        entity_id: switch.zasuvka_pracovna
        state: "on"
    action:
      - action: switch.turn_off
        target:
          entity_id: switch.zasuvka_pracovna
    mode: single
Před použitím se spotřebiči s vyšším příkonem zkontrolujte proudové limity konkrétního spínače a ponechte možnost ručního vypnutí.
06

Řešení problémů

Spínač se po restartu neobjeví: zkontrolujte odsazení YAML, název platformy recswitch, položky host a mac a potom restartujte RichPear Home znovu po úspěšné kontrole konfigurace.

Entita je nedostupná: ověřte, že spínač stále používá stejnou IP adresu, odpovídá v síti a není přesunutý do jiné VLAN nebo hostované Wi-Fi s izolací klientů.

Zapnutí nebo vypnutí funguje jen někdy: zkontrolujte sílu Wi-Fi signálu, rušení, napájení spínače a firewall pro UDP port 18530. U sítí s oddělenými segmenty může vadit blokovaná lokální UDP nebo broadcast komunikace.

Stav neodpovídá realitě: ručně změňte stav v RichPear Home a sledujte, zda se entita při dalším dotazu aktualizuje. Pokud fyzická změna proběhne mimo RichPear Home, počítejte s krátkou prodlevou do další aktualizace.

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.