Hľadaj
MENU
  • Výrazy / Skriptovací jazyk
  • Používatelia a povolenia
  • Záloha, obnova zálohy, reset na továrenské nastavenia
  • Software release notes
  • Integračný protokol (AMX, Lutron, Crestron, Control4, Clipsal)

    Systém TapHome je schopný sa integrovať s inými systémami prostredníctvom jednoduchého integračného protokolu ASCII. To umožňuje iným systémom získavať informácie a ovládať zariadenia TapHome.

    Podporované komunikačné vrstvy

    • RS485
    • TCP/IP
    • UDP/IP

    Popis protokolu

    Protokol podporuje nasledujúce príkazy:

    POMOC, ZOZNAM, ZÍSKAJTE, ZLOŽTE, AKCIU, ZÁHLAVIE, AUTOSEND

    Každý príkaz musí byť ukončený znakmi CRLF (0x0D 0x0A, \r \n ).

      

    Príkaz HELP

    Príkaz HELP <\r> <\n> zobrazí základné informácie o podporovaných príkazoch.

    ZÁHLAVIE [ON / OFF] zapína alebo vypína informácie záhlavia. <\r> <\n>
    LIST zobrazuje všetky exponované zariadenia. <\r> <\n>
    ZÍSKAJTE [ID] zariadenie s hodnotami ID. <\r> <\n>
    SET [ID ST VAL1 .. VALN] nastaví zariadenie s ID stavom ST a hodnotami VAL1 na VALN. <\r> <\n>
    AKCIA [ID NUM VAL] Vykonajte na zariadení s číslom akcie ID NUM s hodnotou VAL. <\r> <\n>
    Prepínač PUSHALL [ZAP/VYP] zapína alebo vypína všetky zariadenia. <\r> <\n>

    Príkaz HEADER

    Príkaz ZÁHLAVIE <\r> <\n> prepína medzi dvoma možnými dátovými výstupmi. Ak je Záhlavie ZAPNUTÉ, sú spolu s údajmi odosielané opisné informácie. Ak je záhlavie vypnuté, odosielajú sa iba údaje.

    ZÁHLAVIE bez parametrov posiela informácie o aktuálnom stave prepnutia.

    ZÁHLAVIE ZAP zapne informácie záhlavia.

    ZÁHLAVIE VYP vypne informácie záhlavia.

    Príkaz LIST

    Príkaz LIST zobrazuje všetky odkryté zariadenia.

    Zobrazujú sa nasledujúce informácie:

    ID zariadenia je číselné ID zariadenia.

    Device Type je textový popis typu zariadenia (Blind, Switch, ...).

    Názov zariadenia nastavený v systéme TapHome.

    Stav zariadenia ako textové informácie

    LIST <\r> <\n> : príkladu výstupu príkazu

    ID: 137, Typ: žalúzie, meno: virtuálny žalúzie, stav: OK <\r> <\n>
    ID: 51, Typ: Prepínač, Meno: Ex Prepínač, Stav: OK <\r> <\n>
    ID: 2, Typ: MultiValueSwitch, Meno: Kúrenie a chladenie, Stav: OK <\r> <\n>
    ID: 205, Typ: Tlačidlo, Názov: Tlačidlo, Stav: OK <\r> <\n>
    ID: 242, Typ: Stmievač, Meno: Analógový výstup, Stav: OK <\r> <\n>
    ID: 68, Typ: termostat, meno: termostat 1, stav: neznámeError <\r> <\n>
    ID: 145, Typ: Premenná, Meno: KNXVariabilný, Stav: OK <\r> <\n>
    ID: 143, Typ: Premenná, Meno: Slnko azimut, Stav: OK <\r> <\n>

    Príkaz GET

    Príkaz GET potrebuje jeden parameter - ID zariadenia. Vracia stav a hodnoty zariadenia ako čísla.

    Príklad výstupu príkazu GET 137 <\r> <\n>

    ID: 137, DeviceStatus: 0, BlindsLevel: 41, BlindsSlope: 41 <\r> <\n>

    Príklad, keď je záhlavie vypnutá:

    137,0,41,41 <\r> <\n>

    Príkaz SET

    Príkaz SET potrebuje najmenej tri parametre. Najprv je to ID zariadenia, potom nový stav zariadenia, ktorý sa má nastaviť a potom aspoň jedna hodnota, ktorá sa má nastaviť. V prípade zariadení s viac ako jednou hodnotou by mali nasledovať všetky hodnoty - napríklad žalúzie vyžadujú zaslanie oboch parametrov - novú úroveň a nový uhol.

    Príklad výstupu príkazu SET 137 0 35 80 <\r> <\n> s informáciami o hlavičkách a bez nich:

    ID: 137, DeviceStatus: 0, BlindsLevel: 35, BlindsSlope: 80 <\r> <\n>

    137,0,35,80 <\r> <\n>

    Príkaz AKCIA

    Príkazová akcia vykoná akciu na ID zariadenia s hodnotou odoslania. Akcie sú definované iba pre žalúzie. Existujú tri akcie pre žalúzie:

    0 žalúzia - stop

    1 nastavenie úrovne od skutočnej polohy + hodnota

    2 nastavte uhol žalúzie od skutočnej polohy + hodnota

    Príklad výstupu príkazu ACTION 137 1 -20 <\r> <\n> : ID: 137, AdjustBlindsLevel: -20 <\r> <\n>

    Príkaz PUSHALL

    Príkaz PUSHALL umožní odosielanie všetkých zmien zariadení. Informácie sa odosielajú v rovnakom formáte ako odpoveď na príkaz GET. Upozorňujeme, že pri použití na linke RS485 môže dôjsť ku konfliktu na zbernici, ktorý spôsobí nesúlad údajov. Preto odporúčame použiť tento príkaz iba v úplných duplexných riadkoch / ako RS232 alebo RS422. Je možné ho zapnúť aj na linke RS485 v systémoch, kde sa nebudú používať žiadne príkazy SET alebo ACTION - to znamená iba v monitorovacích systémoch. Na linkách RS485, kde sa vyžadujú príkazy SET a ACTION, odporúčame namiesto automatického monitorovania používať periodické združovanie prostredníctvom príkazu GET.

    Režim adries

    Ak je nastavené jedinečné ID rozhrania, je možné použiť celý príkaz v režime adresy. V tomto režime hlavička adresy vykonáva samotný príkaz. Hlavičky adries sú postupnosti! InterfaceID: kde je InterfaceID nastavené v konfigurácii rozhrania. Každý riadok s odpoveďou potom pokračuje rovnakou hlavičkou. Odpovie iba rozhranie so správnou adresou - nesprávne odpovede nemožno rozpoznať odpoveďou.

    Príklad požiadavky na režim adries s príkazom !2: LIST <\r> :

    klad_adresa;

    Slave Core - Vystavenie zariadení

    Ak chcete vystaviť zariadenia v integračnom protokole, najprv prejdite na Vystaviť zariadenia a vyberte Pridať nové rozhranie . Z ponúkaných rozhraní vyberte jeden z integračného protokolu RS485, integračného protokolu TCP alebo integračného protokolu UDP :

    Po pridaní rozhrania podľa typu vyplňte ďalšie parametre. Ak chcete použiť režim adresy, nastavte jedinečné ID rozhrania pre každé rozhranie.

    Vyberte terminál pre komunikáciu a vyplňte komunikačné parametre pre RS485. Nastavte všetky parametre sériovej linky podľa požiadaviek pripojeného klienta.

    Nastaviť TCP port podriadeného rozhrania:

    Nastaviť UDP port podriadeného rozhrania:

    Potom pomocou Pridať zariadenie pridajte svoje zariadenia do exponovaných zariadení:

    Vyberte zariadenie zo zoznamu ponúkaných zariadení. Upozorňujeme, že už pridané zariadenia sú zatienené.

    Po pridaní zariadenia sa zobrazí v zozname zariadení pre rozhranie integračného protokolu:

    Kliknutím na zariadenie zobrazíte informácie o ňom, zmeníte automaticky vygenerované ID zariadenia alebo odstránite zariadenie z exponovaných zariadení.

    Podporované zariadenia

    Nasledujúce zariadenia sú teraz podporované pri vystavovaní v integračnom protokole:

    Termostat, spínač, spínač s viacerými hodnotami, tlačidlo, stavový kontakt, stmievač / analógový výstup, variabilný, žalúzie, RGB svetlo.

    Typ zariadenia

    Písanie príkazov

    Čítanie príkazov

    Termostat

    SET < DEVICE_ID > < ERROR > < TTT.T >

    Napr. „SET 1 0 24,5“
    Nastaví termostat s ID = 1 na žiadnu chybu, nastavená hodnota 24,5 ° C

    GET < DEVICE_ID > Odpoveď: Nastavená hodnota | Teplota | Vlhkosť vzduchu

    Napríklad „GET 1“

    Prepínač

    SET < DEVICE_ID > < ERROR > < 0/1 >

    Napr. „SET 1 0 1“
    Zapne spínač s ID = 1. Žiadny chybový stav.

    GET < DEVICE_ID >

    Odpoveď: Stav prepínača (0 alebo 1)

    Prepínač s viacerými hodnotami

    SET < DEVICE_ID > < ERROR > < MM >

    Napr. „SET 1 0 3“
    Nastaví prepínač s viacerými hodnotami s ID = 1 na hodnotu 3. Bez chybového stavu.

    GET < DEVICE_ID >

    Odpoveď: Hodnota

    Stlačte tlačidlo

    SET < DEVICE_ID > < ERROR > < BUTTON_PRESSED >

    Napr. „SET 1 0 1“
    Simuluje krátke stlačenie tlačidla s ID = 1. Žiadny chybový stav.

    GET < DEVICE_ID >

    Odpoveď: stlačené tlačidlo (1 .. 4)

    Stavový kontakt

    (error) 

    nie je k dispozícií

    GET < DEVICE_ID >

    Odpoveď: Stav (0 alebo 1)

    Stmievač / analógový výstup

    SET < DEVICE_ID > < ERROR > < DDD.D >

    Napr. „SET 1 0 55,5“
    Nastavuje stmievač s ID = 1 na hodnotu 55,5%. Žiadny chybový stav.

    GET < DEVICE_ID >

    Odpoveď: Hodnota analógového výstupu (DDD.D)

    Premenná

    SET < DEVICE_ID > < ERROR > < VVV.V >

    Napr. „SET 1 0 1234,5“
    Nastaví premennú s ID = 1 na hodnotu 1234.5. Žiadny chybový stav.

    GET < DEVICE_ID >

    Odpoveď: Premenná hodnota (VVV.V)

    RGB svetlo

    SET < DEVICE_ID > < ERROR > < HHH > < SSS > < BBB >

    Napr. „SET 1 0 180 100 50“
    Nastavuje svetlo RGB s ID = 1 na azúrovú farbu, plné nasýtenie, 50% jas. Žiadny chybový stav.

    GET < DEVICE_ID >

    Odpoveď: Odtieň | Nasýtenie | Jas

    Žalúzie

    SET < DEVICE_ID > < ERROR > < LLL > < AAA >

    LLL ... Úroveň žalúzií
    AAA ... Uhol lamiel

    Napr. „SET 1 0 100 50
    Nstaví žalúzie s ID = 1 na úroveň 100%, s 50% uhlom lamiel.

    ACTION < DEVICE_ID > 1 < +/- > LLL

    Napr. „SET 1 1 -10“
    Posúva sa o 10% nahor

    ACTION < DEVICE_ID > 2 < +/- > AAA

    Napr. „SET 1 2 +25“
    Uhol lamiel nastavte na + 25% (smer dole).

    ACTION < DEVICE_ID > 0
    Zastaviť žalúzie

    Skupina žalúzii

    Rovnaké ako -Žalúzie-, bez podpory pre Akciu 0 (Stop).


    Roleta, Skupina roliet

    (error) 

    nie je podporované

    (error) 

    nie je podporované

    Alarm, Elektromer, Skupina roliet, Senzor jasu, Počítadlo impulzov

    (error) 

    nie je podporované

    (error) 

    nie je podporované




    ID ZARIADENIE

    Postupne priradené ku každému zariadeniu v zozname vystavených zariadení. Možno ručne zmeniť na ľubovoľnú hodnotu.

    CHYBA

    0 ... OK
    1 ... Slabá batéria
    2 ... Kritický stav batérie
    3 ... Poškodené
    4 ... Chyba komunikácie
    5 ... Neznáma chyba
    6 ... Chyba autorizácie
    7 ... Chyba konfigurácie

    TLAČIDLO STLAČENÉ

    1 ... Krátke stlačenie
    2 ... Dlhé stlačenie
    3 ... Dvakrát stlačte
    4 ... Trikrát stlačte


    Debugging RS485 communication

    Pre pripojenia RS485 je možné k počítaču pripojiť adaptér USB RS485. Požiadavky a odpovede budú viditeľné v aplikácii konzoly.

    Štandardný prevodník USB na RS485

    http://sk.farnell.com/ftdi/usb-rs485-we-1800-bt/cable-usb-rs485-serial-converter/dp/1740357
    Poznámka: Tento prevodník nie je galvanicky izolovaný, preto by ste mali spojiť GND konvertor s GND Core.

    Terminálový softvér pre Windows


    Ako nastaviť terminál HTerm

    1. V rozhraní TapHome Integration Protocol nastavte správne vlastnosti pripojenia. (Upozorňujeme, že predvolená prenosová rýchlosť je 9600)
    2. Nastavte nový riadok na znak LF
    3. Nastaviť Send on enter: CR-LF
    4. Napíšte príkaz (napr. „POMOC“)
    5. Prečítajte si odpoveď

    Poznámka: Ak chcete vidieť zmeny zariadení TapHome v konzole, použite príkaz „PUSHALL ON“.

    Na ladenie TCP komunikácie je možné použiť terminál putty (https://putty.org/). Na pripojenie TCP použite nasledujúce nastavenia:

    Najprv nastavte typ pripojenia na Raw, potom vyplňte IP adresu Core a portu nastavenú v nastaveniach exponovaného protokolu TCP Integration.