Hľadaj
MENU

Integračný protokol (AMX, Lutron, Crestron, Control4, Clipsal)

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

Podporované komunikačné vrstvy

  • RS485
  • TCP/IP
  • UDP/IP

Popis protokolu

Protokol podporuje nasledovné príkazy:

HELP, LIST, GET, SET, ACTION, HEADER, AUTOSEND

Príkaz HELP

Príkaz HELP zobrazí základné informácie o podporovaných príkazoch.

HEADER [ON/OFF] switch header information on or off.<\n>
LIST display all exposed devices.<\n>
GET [ID] get device with ID values.<\n>
SET [ID ST VAL1 .. VALN] set device with ID status ST and values VAL1 to VALN.<\n>
ACTION [ID NUM VAL] Perform on device with ID action number NUM with value VAL.<\n>
PUSHALL [ON/OFF] switch push all devices change on or off.<\n>

Príkaz HEADER

Príkaz HEADER prepína medzi dvoma možnými dátovými výstupmi. Ak je hlavička zapnutá, vysielajú sa spolu s údajmi informácie o opise. Ak je hlavička vypnutá, odosielajú sa iba údaje.

HEADER bez parametrov odosiela informácie o aktuálnom stave spínača.

HEADER ON zapne Header informáciu.

HEADER OFF vypne Header informáciu.

Príkaz LIST

Command LIST zobrazí všetky vystavené zariadenia.

Zobrazené sú nasledujúce informácie:

Device ID is numerical device ID.

Device Type is text description of device type (Blind, Switch, ...).

Device Name as set in TapHome system.

Device Status as text information

Príklad príkazu LIST:

ID:137,Type:Blind,Name:Virtual blind,Status:OK<\n>
ID:51,Type:Switch,Name:Ex Switch,Status:OK<\n>
ID:2,Type:MultiValueSwitch,Name:Heating & Cooling,Status:OK<\n>
ID:205,Type:PushButton,Name:Push button,Status:OK<\n>
ID:242,Type:Dimmer,Name:Analog output,Status:OK<\n>
ID:68,Type:Thermostat,Name:Thermostat 1,Status:UnknownError<\n>
ID:145,Type:Variable,Name:KNXVariable,Status:OK<\n>
ID:143,Type:Variable,Name:Sun azimuth,Status:OK<\n>

Príkaz GET

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

Príklad výstupu príkazu GET 137:

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

Príklad, keď header je off:

137,0,41,41<\n>

Príkaz SET

Príkaz SET vyžaduje aspoň tri parametre. Najprv je ID zariadenia, potom sa nastaví nový stav zariadenia a potom sa nastaví aspoň jedna hodnota. Pre zariadenia s viac ako jednou hodnotou by mali nasledovať všetky hodnoty - napríklad blind vyžadujú oba parametre na odoslanie - nová úroveň a nový uhol.

Príklad výstupu príkazu SET 137 0 35 80 s informáciami o hlavičke a bez nej:

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

137,0,35,80<\n>

Príkaz ACTION

Akcia príkazu vykoná akciu na ID zariadenia s hodnotou odoslania. Akcie sú definované iba pre žalúzie. Existujú tri čísla akcií pre blindy:

0 blind stop

1 adjust level from actual position +-value.

2 adjust blind angle from actual position +-value

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

Príkaz PUSHALL

Príkaz PUSHALL umožní odosielať všetky zmeny zariadení. Informácie sa odosielajú v rovnakom formáte ako odpoveď na príkaz GET. Upozorňujeme, že keď sa používa na linke RS485, môže dôjsť k konfliktu na zbernici, ktorá vyrieši nesúlad údajov. Preto odporúčame použiť tento príkaz iba v plne duplexných linkách / ako napríklad RS232 alebo RS422. Je možné ho zapnúť aj na linke RS485 v systémoch, kde sa nepoužijú žiadne príkazy SET alebo ACTION - to znamená iba v monitorovacích systémoch. V riadkoch RS485, kde sú potrebné príkazy SET a ACTION, odporúčame použiť periodické združovanie pomocou príkazu GET namiesto automatického monitorovania.

Address mode

Keď je nastavené jedinečné ID rozhrania, je možné použiť celý príkaz v režime adresy. V tomto režime záhlavie adresy pokračuje v samotnom príkaze. Hlavičky adresy sú sekvencie! InterfaceID: kde rozhranie ID je nastavené v konfigurácii rozhrania. Každá riadok odpovede je rovnako ako pokračovanie s rovnakou hlavičkou. Zodpovedá iba rozhranie so správnou adresou - nesprávne adresovanie nie je možné rozpoznať odpoveďou.

Príklad príkazu režimu adresy pomocou príkazu! 2: LIST:

!2:ID:2,Type:Switch,Name:Ex Switch,Status:OK<\n>
!2:ID:3,Type:MultiValueSwitch,Name:Heating & Cooling,Status:OK<\n>
!2:ID:4,Type:PushButton,Name:Push button,Status:OK<\n>
!2:ID:5,Type:Dimmer,Name:Analog output,Status:OK<\n>
!2:ID:6,Type:Thermostat,Name:Thermostat 1,Status:OK<\n>
!2:ID:7,Type:Variable,Name:KNXVariable,Status:OK<\n>
!2:ID:8,Type:Variable,Name:Sun azimuth,Status:OK<\n>
!2:ID:11,Type:Blind,Name:Virtual blind,Status:OK<\n>

Vystavenie zariadení v Integration protokole

Ak chcete zobraziť zariadenia v integračnom protokole, najprv prejdite na prístroje Expose a vyberte Pridať nové rozhranie. Z ponúkaných rozhraní vyberte jeden z integračných protokolov RS485, integračný protokol TCP alebo integračný protokol UDP:

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

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.

Nastavte TCP port rozhrania slave:

Nastavte UDP port rozhrania slave:

Potom použite "pridať zariadenie" na pridanie zariadení do vystavených zariadení:

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

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 generované ID zariadenia alebo odstránite zariadenie z exponovaných zariadení.

Podporované zariadenia

Nasledujúce zariadenia sú aktuálne podporované pre vystavenie v integračnom protokole:

Termostat, prepínač, viachodnotový prepínač, tlačidlo, stavový kontakt, stmievač / analógový výstup, premenná, žalúzie.


Debugging RS485 communication

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

Standard USB to RS485 konverter: http://sk.farnell.com/ftdi/usb-rs485-we-1800-bt/cable-usb-rs485-serial-converter/dp/1740357

Terminal software pre Windows: http://www.der-hammer.info/terminal/