Căutare
MENU
  • Expresii / Limbajul scriptului
  • Utilizatori și permisiuni
  • Backup, restaurare backup, resetare la setările din fabrică
  • Software release notes
  • Protocol de integrare (AMX, Lutron, Crestron, Control4, Clipsal)

    Sistemul TapHome este capabil să se integreze cu alte sisteme printr-un protocol simplu de integrare ASCII. Aceasta permite altor sisteme să obțină informații și să controleze dispozitivele TapHome.

    Straturi de comunicare acceptate

    • RS485
      • TCP / IP
      • UDP / IP

    Descrierea protocolului

    Protocolul acceptă următoarele comenzi:

    AJUTOR, LISTA, OBȚINERE, SETARE, ACȚIUNE, ÎNTREȚ, AUTOSEND

    Fiecare comandă trebuie terminată cu caractere CRLF (0x0D 0x0A, \r \n ).

      

    Comandați HELP

    Comanda HELP <\r> <\n> va afișa informații de bază despre comenzile acceptate.

    HEADER [ON / OFF] activează sau dezactivează informațiile despre antet. <\r> <\n> LIST afișează toate dispozitivele expuse. <\r> <\n> GET [ID] obține dispozitivul cu valori ID. <\r> <\n> SET [ID ST VAL1 .. VALN] setează dispozitivul cu starea ID ST și valorile VAL1 la VALN. <\r> <\n> ACȚIUNE [ID NUM VAL] Efectuați pe dispozitiv cu numărul de acțiune ID NUM cu valoarea VAL. <\r> <\n> Comutatorul PUSHALL [PORNIT / OPRIT] împingeți toate dispozitivele pe schimb sau pornire. <\r> <\n>

    Comanda HEADER

    Comanda HEADER <\r> <\n> comută între două ieșiri de date posibile. Dacă antetul este PORNIT, sunt trimise informații despre descriere împreună cu datele. În cazul în care antetul este dezactivat, sunt trimise numai date.

    HEADER fără parametri trimite informații despre starea reală a comutatorului.

    HEADER ON va activa informațiile despre header.

    HEADER OFF va dezactiva informațiile despre header.

    Comandă LISTA

    Command LIST afișează toate dispozitivele expuse.

    Sunt afișate următoarele informații:

    ID-ul dispozitivului este ID-ul numeric al dispozitivului.

    Tipul dispozitivului este descrierea textului tipului de dispozitiv (Blind, Switch, ...).

    Nume dispozitiv așa cum este setat în sistemul TapHome.

    Stare dispozitiv ca informație text

    LIST <\r> <\n> exemplu de ieșire comandă:

    ID: 137, Tip: Blind, Nume: Virtual blind, Stare: OK <\r> <\n> ID: 51, Tip: Comutator, Nume: Comutator Ex, Stare: OK <\r> <\n> ID: 2, Tip: MultiValueSwitch, Nume: Încălzire și răcire, Stare: OK <\r> <\n> ID: 205, Tip: PushButton, Nume: Buton, Stare: OK <\r> <\n> ID: 242, Tip: Dimmer, Nume: Ieșire analogică, Stare: OK <\r> <\n> ID: 68, Tip: Termostat, Nume: Termostat 1, Stare: Necunoscut Eroare <\r> <\n> ID: 145, Tip: Variabilă, Nume: KNXVariabilă, Stare: OK <\r> <\n> ID: 143, Tip: Variabilă, Nume: azimut solar, Stare: OK <\r> <\n>

    Comandă GET

    Comanda GET are nevoie de un singur parametru - ID-ul dispozitivului. Returnează starea și valorile dispozitivului ca numere.

    Exemplu de ieșire a comenzii GET 137 <\r> <\n>

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

    Exemplu când antetul este dezactivat:

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

    Comanda SET

    Comanda SET are nevoie de cel puțin trei parametri. Mai întâi este ID-ul dispozitivului, apoi starea dispozitivului nou care trebuie setată și apoi cel puțin o valoare care trebuie setată. Pentru dispozitivele cu mai multe valori ar trebui să urmeze toate valorile - de exemplu, blind-ul necesită trimiterea ambilor parametri - nivel nou și unghi nou.

    Exemplu de ieșire a comenzii SET 137 0 35 80 <\r> <\n> cu și apoi fără informații despre antet:

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

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

    Comandă ACȚIUNE

    Acțiunea de comandă va executa acțiunea pe ID-ul dispozitivului cu valoarea de trimitere. Acțiunile sunt definite numai pentru jaluzele. Există trei acțiuni pentru blinduri:

    0 oprire orb

    1 reglați nivelul de la poziția reală + -valor

    2 reglați unghiul orb din poziția reală + -valor

    Exemplu de ieșire a comenzii ACTION 137 1 -20 <\r> <\n> : ID: 137, AdjustBlindsLevel: -20 <\r> <\n>

    Comandați PUSHALL

    Comanda PUSHALL va permite trimiterea tuturor modificărilor dispozitivelor. Informațiile sunt trimise în același format ca răspuns la comanda GET. Vă rugăm să rețineți că, atunci când este utilizat pe linia RS485, poate exista un conflict pe bus care rezolvă nepotrivirea datelor. Deci, vă sugerăm să utilizați această comandă numai în liniile full duplex / cum ar fi RS232 sau RS422. Este posibil să îl porniți și pe linia RS485 în sistemele în care nu se vor folosi comenzi SET sau comenzi ACTION - acest lucru înseamnă doar în sistemele de monitorizare. În liniile RS485 în care sunt necesare comenzi SET și ACTION, vă sugerăm să utilizați pooling periodic prin comanda GET în loc de monitorizare automată.

    Mod adresă

    Când este setat un ID de interfață unic, este posibil să utilizați toate comenzile în modul adresă. În acest mod, antetul adresei continuă comanda în sine. Anteturile de adresă sunt secvență! InterfaceID: unde InterfaceID este setat în configurația interfeței. Fiecare linie de răspuns este, de asemenea, continuată cu același antet. Numai interfața cu adresa corectă va răspunde - adresarea incorectă nu poate fi recunoscută prin răspuns.

    Exemplu de cerere mod adresă cu comandă! 2: LIST <\r> :

    klad_adresa;

    Pentru expunerea dispozitivelor în protocolul de integrare, mergeți mai întâi la Expunerea dispozitivelor și alegeți Adăugați o interfață nouă . Din interfețele oferite alegeți unul dintre Protocolul de integrare RS485, Protocolul de integrare TCP sau Protocolul de integrare UDP :

    După adăugarea interfeței în funcție de tip, completați alți parametri. Setați un ID de interfață unic pentru fiecare interfață dacă doriți să utilizați modul de adresă.

    Alegeți terminalul pentru comunicare și completați parametrii de comunicare pentru RS485. Setați toți parametrii liniei seriale conform cerințelor clientului conectat.

    Setați portul TCP al interfeței slave:

    Setați portul UDP al interfeței slave:

    Apoi utilizați Adăugare dispozitiv pentru a adăuga dispozitivele dvs. în dispozitivele expuse:

    Alegeți dispozitivul din lista dispozitivelor oferite. Rețineți că dispozitivele adăugate deja sunt umbrite.

    După adăugarea dispozitivului, este afișat în lista dispozitivelor pentru interfața protocolului de integrare:

    Faceți clic pe dispozitiv pentru a afișa informații despre acesta, pentru a modifica automat ID-ul dispozitivului generat sau pentru a șterge dispozitivul de pe dispozitivele expuse.

    Dispozitive acceptate

    Următoarele dispozitive sunt acum acceptate pentru expunerea în protocolul de integrare:

    Termostat, comutator, comutator multi-valoare, buton, contact Reed, ieșire dimmer / analog, variabilă, orb, lumină RGB.

    Tip de dispozitiv

    Scrieți comenzi

    Citiți comenzile

    Termostat

    SET < DEVICE_ID > < EROARE > < TTT.T >

    De exemplu, "SET 1 0 24.5" Setează termostatul cu ID = 1 la nici o eroare, setează punctul 24,5ºC

    OBȚINEȚI < DEVICE_ID > Răspuns: Set point | Temperatura | Umiditate

    De exemplu, „OBȚINE 1”

    Intrerupator

    SET < DEVICE_ID > < EROARE > < 0/1 >

    De exemplu, "SET 1 0 1" Activează comutatorul cu ID = 1. Nicio stare de eroare.

    OBȚINEȚI < DEVICE_ID >

    Răspuns: Starea comutatorului (0 sau 1)

    Comutator multi-valoare

    SET < DEVICE_ID > < EROARE > < MM >

    De exemplu, "SET 1 0 3" Setează comutatorul cu mai multe valori cu ID = 1 la valoarea 3. Fără stare de eroare.

    OBȚINEȚI < DEVICE_ID >

    Răspuns: valoare

    Apasa butonul

    SET < DEVICE_ID > < EROARE > < BUTTON_PRESSED >

    De exemplu, "SET 1 0 1" Simulează apăsarea scurtă a butonului cu ID = 1. Nicio stare de eroare.

    OBȚINEȚI < DEVICE_ID >

    Răspuns: BUTTON_PRESSED (1 .. 4)

    Contact Reed

    (error) 

    nu este disponibil

    OBȚINEȚI < DEVICE_ID >

    Răspuns: Stare (0 sau 1)

    Dimmer / ieșire analogică

    SET < DEVICE_ID > < EROARE > < DDD.D >

    De exemplu, "SET 1 0 55,5" Setează reglajul mai scăzut cu ID = 1 la valoarea de 55,5%. Nicio stare de eroare.

    OBȚINEȚI < DEVICE_ID >

    Răspuns: Valoare ieșire analogică (DDD.D)

    Variabil

    SET < DEVICE_ID > < EROARE > < VVV.V >

    De exemplu, "SET 1 0 1234,5" Setează variabila cu ID = 1 la valoarea 1234,5. Nicio stare de eroare.

    OBȚINEȚI < DEVICE_ID >

    Răspuns: valoare variabilă (VVV.V)

    RGB Light

    SET < DEVICE_ID > < EROARE > < HHH > < SSS > < BBB >

    De exemplu, "SET 1 0 180 100 50" Setează lumina RGB cu ID = 1 la culoare cyan, saturație completă, 50% friabilitate. Nicio stare de eroare.

    OBȚINEȚI < DEVICE_ID >

    Răspuns: Hue | Saturație | Luminozitate

    Orb

    SET < DEVICE_ID > < EROARE > < LLL > < AAA >

    LLL ... Blinds level AAA ... Unghiul lamelelor

    De exemplu „SET 1 0 100 50 Setează orb cu ID = 1 până la nivelul 100%, cu unghi de lamele de 50%.

    ACȚIUNE < DEVICE_ID > 1 < +/- > LLL

    De exemplu, "SET 1 1 -10" Mută orb cu 10% în sus

    ACȚIUNE < DEVICE_ID > 2 < +/- > AAA

    De exemplu, "SET 1 2 +25" Setați unghiul lamelelor la + 25% (direcția în jos).

    ACȚIUNE < DEVICE_ID > 0 Opriți jaluzelele

    GET <DEVICE_ID>

    Response: Level | Angle

    Grup de orbi

    La fel ca Blind, fără suport pentru Acțiunea 0 (Stop).


    Slide, grup de diapozitive

    (error) 

    nu sunt acceptate

    (error) 

    nu sunt acceptate

    Alarmă, contor electric, grup de diapozitive, senzor de luminozitate, contor de impulsuri

    (error) 

    nu sunt acceptate

    (error) 

    nu sunt acceptate




    IDENTIFICATORUL DISPOZITIVULUI

    Alocate incremental fiecărui dispozitiv din lista de dispozitive expuse. Poate fi schimbat manual la orice valoare.

    EROARE

    0 ... OK 1 ... Baterie descărcată 2 ... Baterie critică 3 ... Avariat 4 ... Eroare de comunicare 5 ... Eroare necunoscută 6 ... Eroare de autorizare 7 ... Eroare de configurare

    BUTON APĂSAT

    1 ... Apăsați scurt 2 ... Apăsați lung 3 ... Apăsați dublu 4 ... Apăsați triplu


    Debugging RS485 communication

    Pentru conexiunile RS485, este posibil să conectați adaptorul USB RS485 la computer. Cererile și răspunsurile vor fi vizibile în aplicația consolă.

    Convertor standard USB la RS485

    http://sk.farnell.com/ftdi/usb-rs485-we-1800-bt/cable-usb-rs485-serial-converter/dp/1740357 Notă: acest convertor nu este izolat galvanic, deci ar trebui să conectați GND al convertorului cu GND de Core .

    Software terminal pentru Windows


    Cum se setează terminalul HTerm

    1. Setați proprietățile corecte ale conexiunii pentru a se potrivi cu setările din interfața TapHome Integration Protocol. (Rețineți că rata de transmisie implicită este 9600)

      1. Setați linia nouă la caracterul LF
      2. Setați Send on enter: CR-LF
      3. Tastați comanda (de exemplu, „HELP”)
      4. Citiți răspunsul

      Notă: Dacă doriți să vedeți modificări ale dispozitivelor TapHome în consolă, utilizați comanda „PUSHALL ON”.

    Pentru depanarea comunicării TCP este posibil să se utilizeze terminalul de chit (https://putty.org/). Vă rugăm să utilizați următoarele setări pentru conexiunea TCP:

    Mai întâi setați tipul de conexiune la Raw, apoi completați adresa IP a Core și setul de porturi în setările protocolului de integrare TCP expuse.