---
title: "Protocol de integrare (AMX, Lutron, Crestron, Control4, Clipsal)"
description: "Integrați TapHome cu AMX, Lutron, Crestron și Control4 prin protocolul ASCII pe RS485 sau TCP/IP. Include lista completă a comenzilor."
url: "https://taphome.com/ro/docs/expose-devices/integration-protocol/"
language: ro
lastmod: 2026-10-08
generator: hugo
ai:
  topics: ["integration-protocol","device-exposure","ascii-protocol","system-integration","rs485-communication","tcp-ip-communication"]
  questions: ["Ce comenzi sunt disponibile în protocolul de integrare TapHome?","Cum configurez în TapHome interfața protocolului de integrare pentru a expune dispozitive?","Ce straturi de comunicație acceptă protocolul de integrare (RS485, TCP, UDP)?","Care este formatul comenzii pentru controlul jaluzelelor, dimmerelor sau termostatelor prin protocolul de integrare?","Când folosesc monitorizarea automată PUSHALL și când interogarea periodică GET?","Ce înseamnă codurile de eroare (0-7) și valorile apăsării butonului (1-4) în protocolul de integrare?","Cum pot depana comunicația RS485 sau TCP cu HTerm sau Putty?"]
---

# Protocol de integrare (AMX, Lutron, Crestron, Control4, Clipsal)

Sistemul TapHome se poate integra cu alte sisteme printr-un protocol de integrare ASCII simplu. Astfel, alte sisteme pot obține informații despre dispozitivele TapHome și le pot controla.

Ultima actualizare: 2026-10-08

Sistemul TapHome se poate integra cu alte sisteme printr-un protocol de integrare ASCII simplu. Astfel, alte sisteme pot obține informații despre dispozitivele TapHome și le pot controla.

## Straturi de comunicație acceptate

- **RS485**
- **TCP/IP**
- **UDP/IP**

## Descrierea protocolului

Protocolul acceptă următoarele comenzi:

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

> [!WARNING]
> Fiecare comandă trebuie terminată cu caracterele CRLF (0x0D 0x0A, \r\n).

## Comanda HELP

Comanda `HELP` afișează informații de bază despre comenzile acceptate.

`HEADER [ON/OFF]` activează sau dezactivează informațiile de antet.

`LIST` afișează toate dispozitivele expuse.

`GET [ID]` returnează valorile dispozitivului cu ID-ul indicat.

`SET [ID ST VAL1 .. VALN]` setează pentru dispozitivul cu ID-ul indicat starea ST și valorile VAL1 până la VALN.

`ACTION [ID NUM VAL]` execută pe dispozitivul cu ID-ul indicat acțiunea cu numărul NUM și valoarea VAL.

`PUSHALL [ON/OFF]` activează sau dezactivează trimiterea automată a modificărilor tuturor dispozitivelor.

## Comanda HEADER

Comanda `HEADER` comută între două formate posibile de ieșire a datelor. Dacă antetul este ON, împreună cu datele se trimit și informații descriptive. Dacă antetul este OFF, se trimit doar datele.

`HEADER` fără parametri returnează starea actuală a antetului (ON sau OFF).

`HEADER ON` activează informațiile de antet.

`HEADER OFF` dezactivează informațiile de antet.

## Comanda LIST

Comanda `LIST` afișează toate dispozitivele expuse.

> Se afișează următoarele informații:

Device ID este ID-ul numeric al dispozitivului.

Device Type este descrierea în format text a tipului de dispozitiv (Blind, Switch, ...).

Device Name este numele dispozitivului setat în sistemul TapHome.

Device Status este starea dispozitivului în format text.

Exemplu de ieșire a comenzii `LIST`:

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

## Comanda GET

Comanda `GET` necesită un singur parametru: ID-ul dispozitivului. Returnează starea și valorile dispozitivului sub formă de numere.

Exemplu de ieșire a comenzii `GET 137`

```
ID:137,DeviceStatus:0,BlindsLevel:41,BlindsSlope:41
```

Exemplu cu antetul dezactivat:

```
137,0,41,41
```

## Comanda SET

Comanda `SET` necesită cel puțin trei parametri. Primul este ID-ul dispozitivului, urmează noua stare a dispozitivului și apoi cel puțin o valoare de setat. La dispozitivele cu mai multe valori trebuie trimise toate valorile; de exemplu, jaluzeaua necesită ambii parametri: nivelul nou și unghiul nou.

Exemplu de ieșire a comenzii `SET 137 0 35 80`, mai întâi cu antet și apoi fără antet:

```
ID:137,DeviceStatus:0,BlindsLevel:35,BlindsSlope:80
137,0,35,80
```

## Comanda ACTION

Comanda `ACTION` execută o acțiune pe dispozitivul cu ID-ul indicat, cu valoarea trimisă. Acțiunile sunt definite doar pentru jaluzele. Pentru jaluzele există trei numere de acțiune:

0 oprirea jaluzelei

1 ajustarea nivelului față de poziția actuală cu +-valoare

2 ajustarea unghiului jaluzelei față de poziția actuală cu +-valoare

Exemplu de ieșire a comenzii `ACTION 137 1 -20`:

```
ID:137,AdjustBlindsLevel:-20
```

## Comanda PUSHALL

Comanda `PUSHALL` activează trimiterea tuturor modificărilor dispozitivelor. Informațiile se trimit în același format ca răspunsul la comanda `GET`. Rețineți că pe o linie RS485 pot apărea conflicte pe magistrală, care duc la date eronate. De aceea recomandăm folosirea acestei comenzi doar pe linii full duplex, precum RS232 sau RS422. Pe linia RS485 se poate activa doar în sistemele în care nu se folosesc comenzile `SET` sau `ACTION`, adică doar în sistemele de monitorizare. Pe liniile RS485 în care sunt necesare comenzile `SET` și `ACTION`, recomandăm interogarea periodică prin comanda `GET` în locul monitorizării automate.

## Modul de adresare

Când este setat un ID unic al interfeței, toate comenzile se pot folosi în modul de adresare. În acest mod, comanda propriu-zisă este precedată de antetul de adresă. Antetul de adresă este secvența !InterfaceID:, unde InterfaceID este setat în configurația interfeței. Fiecare linie de răspuns este precedată, de asemenea, de același antet. Răspunde doar interfața cu adresa corectă; o adresare greșită nu poate fi recunoscută din răspuns.

Exemplu de cerere în modul de adresare cu comanda `!2:LIST`:

```
klad_adresa;
```

## Configurare

Pentru a expune dispozitive prin protocolul de integrare, accesați mai întâi Expun dispozitive și alegeți **Adăugați o nouă interfață**. Dintre interfețele oferite alegeți una dintre **Integration protocol RS485, Integration protocol TCP sau Integration protocol UDP**:

![Protocoale de integrare](https://taphome.com/documentation/expose-devices/integration-protocol/integration-protocols.png)

După adăugarea interfeței, completați ceilalți parametri în funcție de tip. Dacă doriți să folosiți modul de adresare, setați un ID unic pentru fiecare interfață.

Pentru RS485 alegeți terminalul de comunicație și completați parametrii de comunicație. Setați toți parametrii liniei seriale conform cerințelor clientului conectat.

![Parametrii interfeței](https://taphome.com/documentation/expose-devices/integration-protocol/interface-parameters.png)

Setați portul TCP al interfeței slave:

![Setări TCP](https://taphome.com/documentation/expose-devices/integration-protocol/tcp-settings.png)

Setați portul UDP al interfeței slave:

![Setări UDP](https://taphome.com/documentation/expose-devices/integration-protocol/udp-settings.png)

Apoi folosiți Adaugă dispozitiv pentru a adăuga dispozitivele în lista dispozitivelor expuse:

![Adăugarea unui dispozitiv](https://taphome.com/documentation/expose-devices/integration-protocol/add-device.png)

Alegeți dispozitivul din lista oferită. Rețineți că dispozitivele deja adăugate apar estompate.

După adăugare, dispozitivul se afișează în lista dispozitivelor interfeței protocolului de integrare:

![Lista dispozitivelor](https://taphome.com/documentation/expose-devices/integration-protocol/devices-list.png)

Faceți clic pe dispozitiv pentru a afișa informațiile despre el, pentru a schimba ID-ul dispozitivului generat automat sau pentru a șterge dispozitivul din lista dispozitivelor expuse.

![Informații despre dispozitiv](https://taphome.com/documentation/expose-devices/integration-protocol/device-info.png)

## Dispozitive acceptate

În prezent, prin protocolul de integrare se pot expune următoarele dispozitive:

Termostat, Comutator, Comutator cu mai multe valori, Buton, Contact reed, Dimmer / Ieșire analogică, Variabilă, Jaluzea, Lumină RGB.

| Tip de dispozitiv | Comenzi de scriere | Comenzi de citire |
|---|---|---|
| Termostat | **SET \<DEVICE_ID\>\<ERROR\>\<TTT.T\>**<br/><br/>De ex. "SET 1 0 24.5"<br/>Setează termostatul cu ID=1 la starea fără eroare și la temperatura dorită de 24,5 °C | **GET \<DEVICE_ID\>**<br/>Răspuns: Temperatura dorită \| Temperatură \| Umiditate<br/><br/>De ex. "GET 1" |
| Comutator | **SET \<DEVICE_ID\>\<ERROR\>\<0/1\>**<br/><br/>De ex. "SET 1 0 1"<br/>Pornește comutatorul cu ID=1. Fără stare de eroare. | **GET \<DEVICE_ID\>**<br/>Răspuns: Starea comutatorului (0 sau 1) |
| Comutator cu mai multe valori | **SET \<DEVICE_ID\>\<ERROR\>\<MM\>**<br/><br/>De ex. "SET 1 0 3"<br/>Setează comutatorul cu mai multe valori cu ID=1 la valoarea 3. Fără stare de eroare. | **GET \<DEVICE_ID\>**<br/>Răspuns: Valoare |
| Buton | **SET \<DEVICE_ID\>\<ERROR\>\<BUTTON_PRESSED\>**<br/><br/>De ex. "SET 1 0 1"<br/>Simulează o apăsare simplă a butonului cu ID=1. Fără stare de eroare. | **GET \<DEVICE_ID\>**<br/>Răspuns: BUTTON_PRESSED (1 .. 4) |
| Contact reed | indisponibil | **GET \<DEVICE_ID\>**<br/>Răspuns: Stare (0 sau 1) |
| Dimmer / Ieșire analogică | **SET \<DEVICE_ID\>\<ERROR\>\<DDD.D\>**<br/><br/>De ex. "SET 1 0 55.5"<br/>Setează dimmerul cu ID=1 la valoarea 55,5%. Fără stare de eroare. | **GET \<DEVICE_ID\>**<br/>Răspuns: Valoarea ieșirii analogice (DDD.D) |
| Variabilă | **SET \<DEVICE_ID\>\<ERROR\>\<VVV.V\>**<br/><br/>De ex. "SET 1 0 1234.5"<br/>Setează variabila cu ID=1 la valoarea 1234,5. Fără stare de eroare. | **GET \<DEVICE_ID\>**<br/>Răspuns: Valoarea variabilei (VVV.V) |
| Lumină RGB | **SET \<DEVICE_ID\>\<ERROR\>\<HHH\>\<SSS\>\<BBB\>**<br/><br/>De ex. "SET 1 0 180 100 50"<br/>Setează lumina RGB cu ID=1 la culoarea cyan, saturație maximă, luminozitate 50%. Fără stare de eroare. | **GET \<DEVICE_ID\>**<br/>Răspuns: Nuanță \| Saturație \| Luminozitate |
| Jaluzea | **SET \<DEVICE_ID\>\<ERROR\>\<LLL\>\<AAA\>**<br/><br/>LLL ... Nivelul jaluzelei<br/>AAA ... Unghiul lamelelor<br/><br/>De ex. "SET 1 0 100 50"<br/>Setează jaluzeaua cu ID=1 la nivelul 100%, cu unghiul lamelelor de 50%.<br/><br/>**ACTION <DEVICE_ID> 1 <+/->LLL**<br/><br/>De ex. "ACTION 1 1 -10"<br/>Mută jaluzeaua cu 10% în sus<br/><br/>**ACTION <DEVICE_ID> 2 <+/-> AAA**<br/><br/>De ex. "ACTION 1 2 +25"<br/>Înclină lamelele cu 25% (în jos).<br/><br/>**ACTION <DEVICE_ID> 0**<br/>Oprește jaluzelele | **GET \<DEVICE_ID\>**<br/>Răspuns: Nivel \| Unghi |
| Grup de jaluzele | La fel ca Jaluzea, dar fără suport pentru Action 0 (Stop). |  |
| Slide, grup Slide | neacceptat | neacceptat |
| Alarmă, Contor electric, Senzor de luminozitate, Contor de impulsuri | neacceptat | neacceptat |

### DEVICE_ID

Se atribuie incremental fiecărui dispozitiv din lista dispozitivelor expuse. Poate fi schimbat manual la orice valoare.

### ERROR

0 ... OK

1 ... Baterie slabă

2 ... Baterie critică

3 ... Deteriorat

4 ... Eroare de comunicare

5 ... Eroare necunoscută

6 ... Eroare de autorizare

7 ... Eroare de configurare

### BUTTON PRESSED

1 ... Apăsare simplă

2 ... Apăsare lungă

3 ... Apăsare dublă

4 ... Apăsare triplă

## Depanarea comunicației RS485

La conexiunile RS485 puteți conecta la PC un adaptor USB RS485. Cererile și răspunsurile vor fi vizibile într-o aplicație de 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 are izolare galvanică, de aceea conectați GND-ul convertorului la GND-ul unității Core.

### Program de terminal pentru Windows

HTerm: http://www.der-hammer.info/terminal/

**Cum se configurează terminalul HTerm**

![Configurarea HTerm](https://taphome.com/documentation/expose-devices/integration-protocol/hterm-configuration.webp)

1. Setați proprietățile conexiunii astfel încât să corespundă setărilor din interfața protocolului de integrare TapHome. (Rețineți că baud rate-ul implicit este 9600)
2. Setați New line la caracterul LF
3. Setați Send on enter: CR-LF
4. Tastați comanda (de ex. „HELP”)
5. Citiți răspunsul

Notă: Dacă doriți să vedeți în consolă modificările dispozitivelor TapHome, folosiți comanda `PUSHALL ON`.

## Depanarea comunicației TCP

Pentru depanarea comunicației TCP puteți folosi terminalul putty (https://putty.org/). Pentru conexiunea TCP folosiți următoarele setări:

![Setări Putty](https://taphome.com/documentation/expose-devices/integration-protocol/putty-settings.webp)

Mai întâi setați Connection type la Raw, apoi completați adresa IP a unității Core și portul setat în setările interfeței expuse Integration protocol TCP.

**Consultați și** — [TapHome API](https://taphome.com/ro/docs/expose-devices/taphome-api/), [TapHome către Modbus RTU / ASCII / TCP](https://taphome.com/ro/docs/expose-devices/modbus/).
