Hľadaj
MENU

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 ZÁHLAVIE

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> :

! 2: ID: 2, Typ: Prepínač, Meno: Ex Prepínač, Stav: OK <\r> <\n>
! 2: ID: 3, Typ: MultiValueSwitch, Meno: Kúrenie a chladenie, Stav: OK <\r> <\n>
! 2: ID: 4, Typ: Tlačidlo, Názov: Tlačidlo, Stav: OK <\r> <\n>
! 2: ID: 5, Typ: Stmievač, Meno: Analógový výstup, Stav: OK <\r> <\n>
! 2: ID: 6, Typ: termostat, názov: termostat 1, stav: OK <\r> <\n>
! 2: ID: 7, Typ: Premenná, Meno: KNXVariabilný, Stav: OK <\r> <\n>
! 2: ID: 8, Typ: Premenná, Meno: Slnko azimut, Stav: OK <\r> <\n>
! 2: ID: 11, Typ: Žalúzie, Meno: Virtuálne žalúzie, Stav: OK <\r> <\n>

Odkryté zariadenia v integračnom protokole

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

GET < DEVICE_ID >

Odpoveď: Úroveň uhol

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.