Při přidávání KNX IP integrace budete po zadání IP adresy vašeho IP rozhraní vyzváni k návštěvě webové stránky pro nahrání konfigurace. Projektový CSV export z KNX nelze přímo použít ke konfiguraci Rithum Switch. Místo toho musí být konfigurační data poskytnuta ve specifickém formátu YAML, aby bylo možné konfiguraci předat do přepínače.

Text ve formátu YAML je třeba zkopírovat/vložit do formuláře na webové stránce a poté stisknout "Load Configuration" (Nahrát konfiguraci).


Formát konfigurace

Pokud je pro vás YAML nový, přečtěte si prosím nejprve toto: Co je YAML?

Základní příklad konfigurace je následující. Poznámka: Jakýkoli text za znakem # je komentář a je ignorován.


YAML

---
version: 1.0
connection:
  type: UDP
zones:
  zone1:
    name: Demo Room
    commands:
      cmd1:
        name: Scene 1
        group_address: 0/0/1
        type: scene_number
        value: 1
      cmd2:
        name: Scene 2
        group_address: 0/0/1
        type: scene_number
        value: 2
      cmd3:
        name: Scene 3
        group_address: 0/0/1
        type: scene_number
        value: 3
      cmd4:
        name: Turn On
        group_address: 0/0/2
        value: on
      cmd5:
        name: Scene 5 
        group_address: 0/0/1
        type: scene_number # For scene recall, use scene_number
        value: 5
      cmd6:
        name: Boolean Example # For boolean e.g. switch, omit type
        group_address: 0/1/0
        value: on # Boolean supports true/false, on/off, or yes/no
      cmd7:
        name: Binary/Dimming Ex. # For binary e.g. dimming omit type
        group_address: 0/1/2
        value: 255 # Range of 0-255
      cmd8:
        name: Percent Example
        group_address: 0/1/8
        type: percent # Percent type
        value: 25 # Range of 0-100
      cmd9:
        name: Temp Example
        group_address: 0/2/0
        type: temperature # Temperature type
        value: 21
    lights:
      light1:
        name: Dimmer 1
        group_address_switch: 0/1/0
        group_address_switch_state: 0/1/1
        group_address_brightness: 0/1/3
        group_address_brightness_state: 0/1/4
      light2:
        name: Dimmer 2
        group_address_switch: 0/1/5
        group_address_switch_state: 0/1/6
        group_address_brightness: 0/1/8
        group_address_brightness_state: 0/1/9
temperature_feed:
  group_address: 0/2/0

Popis polí

version

  • Musí být přítomna a nastavena na 1.0.

connection

  • Volitelný objekt obsahující detaily IP připojení.

  • type: Povinné, UDP nebo TCP v závislosti na protokolu používaném vaším IP rozhraním.

  • Poznámka: Pokud objekt connection není zahrnut, připojení se standardně nastaví na TCP.

zones

  • Kolekce objektů zón, kde každá má jedinečné ID (v příkladu zone1).

  • name: Povinné, textový řetězec pro štítek, který se zobrazí pro zónu/místnost/oblast.

  • commands: Volitelné, kolekce objektů příkazů s jedinečnými ID (v příkladu cmd1, cmd2 atd.). Tyto příkazy umožňují zápis jakékoli hodnoty na specifikovanou skupinovou adresu. Tyto příkazy lze poté vybrat pro použití ve scénových tlačítkách, pro gesta podržení (hold gestures) nebo pro akce topení Rithum Stat.

    • name: Povinné, textový řetězec pro hlavní štítek zobrazený na scénovém tlačítku.

    • group_address: Povinné, KNX skupinová adresa, na kterou se má hodnota zapsat.

    • type: Volitelné, v závislosti na hodnotě, která se má zapsat.

    • value: Povinné, hodnota, která se má zapsat.

    • Pro DPT-1 (boolean), např. spínač: vynechejte type a použijte jakoukoli platnou YAML boolean hodnotu pro value – true/false, on/off, nebo yes/no.

    • Pro DPT-2 & DPT-3 (binary), např. ovládání stmívání: vynechejte type a použijte požadovanou celočíselnou binární hodnotu pro value, tj. 0-255.

    • Pro ostatní typy DPT by měl být specifikován název typu pro type, např. percent, temperature nebo scene_number s odpovídající platnou hodnotou pro value. Kompletní reference platných typů hodnot je k dispozici zde: Reference typů hodnot DPT (KNX DPT Value Types).

  • lights: Volitelné, kolekce objektů světel s jedinečnými ID (v příkladu light1). Tyto objekty reprezentují každý světelný okruh v zóně. Zónu obsahující světla lze vybrat pro zahrnutí na obrazovku 'Levels' (Úrovně). Ovládání na obrazovce 'Levels' pro danou zónu lze poté použít k ovládání všech světel v zóně nebo jej rozšířit pro ovládání jednotlivých světel. Také akce "Turn On" (Zapnout), "Turn Off" (Vypnout) a "Toggle" (Přepnout) pro všechna světla v zóně budou k dispozici pro použití jako scénová tlačítka. "Toggle All" (Přepnout vše) lze také vybrat pro gesto 'podržení' (hold) na pohotovostní obrazovce.

    • name: Povinné, štítek pro zobrazení na obrazovce 'Levels'.

    • group_address_switch: Povinné, skupinová adresa pro zapnutí/vypnutí světla.

    • group_address_switch_state: Povinné, skupinová adresa pro zpětnou vazbu o stavu zapnutí/vypnutí světla.

    • group_address_brightness: Volitelné, skupinová adresa pro nastavení jasu světla.

    • group_address_brightness_state: Volitelné*, skupinová adresa pro zpětnou vazbu o jasu světla. (*Povinné, pokud je specifikováno group_address_brightness).

temperature_feed

  • Tento volitelný objekt má jediné pole, group_address, které lze použít k určení skupinové adresy, na kterou bude Rithum Switch posílat aktuální údaje o teplotě (ve °C).

  • Poznámka: Objekt temperature_feed je na nejvyšší úrovni datové struktury, není spojen s žádnou konkrétní zónou.

Řešení problémů a úpravy

Pokud je po stisknutí "Load Configuration" nahlášena chyba, zkopírujte a vložte konfigurační data do validačního nástroje, jako je YAMLint, který zkontroluje případné syntaktické nebo formátovací chyby. YAML Viewer také zobrazí vaši konfiguraci jako stromové zobrazení, což může být užitečné pro identifikaci chyb.


Úprava konfigurace V menu 'Settings' přejděte na 'Integrations', vyberte KNX IP integraci a stiskněte 'Edit'. Stiskněte fajfku (tick), pokud je IP adresa stejná. Poté budete znovu vyzváni k návštěvě webové stránky pro nahrání konfigurace, kde lze proces vložení YAML konfiguračních dat opakovat. Stiskněte 'Skip' (Přeskočit) pro přeskočení nahrazení stávající konfigurace, pokud je to potřeba.


Jednoduchý příklad konfiguračních dat je připojen k tomuto článku (soubor example_config.yml), který lze použít jako výchozí šablonu.


Doporučení

  • Uložte konfigurační data do souboru pro budoucí použití/modifikaci.

  • Pro úpravu YAML dat použijte editor prostého textu, jako je Sublime Text nebo Visual Studio Code.

  • Pro minimalizaci zbytečné komunikace konfigurujte pouze ty světelné zóny, které jsou pro každý přepínač vyžadovány, místo konfigurace všech přepínačů se všemi dostupnými zónami.