Rozdział 12.14. – Identyfikatory (Komunikacja sieciowa)

Identyfikatory opisane w tym podrozdziale umożliwiają wysyłanie danych z użyciem protokołów TCP, UDP oraz HTTP.

1. TCP #

Identyfikator TCP przeznaczony jest do integracji systemu DOMIQ z innymi urządzeniami wykorzystując protokół TCP jako protokół transportowy. Służy do tego komenda TCP.send. Dzięki niej możliwe jest np. sterowanie telewizorami, amplitunerami, projektorami itp.

Dane przesyłane są w formie tekstowej. Jeżeli dana integracja wymaga znaku nowej linii, wówczas należy w danych na zakończenie dodać „\r\n” (CRLF).

1. Poniższe przykłady przedstawiają definicję komend w przypadku użycia ich jako akcji w zdarzeniach/timerach lub poleceniu przypisanym do elementu Przycisk w zakładce Remote.
   
   • Wywołanie apletu bez dodatkowych parametrów
     Na potrzeby przykładu załóżmy, że aplet ma nazwę test
     Nazwa: C.TCP.send.192.168.10.100:1234
     Wartość: hello world
Wysłanie na na IP 192.168.10.100 i port 1234 tekstu hello world.

2. UDP #

Identyfikator UDP działa analogicznie do TCP z tą róznicą, że protokołem transportowym jest protokół UDP.

1. Poniższe przykłady przedstawiają definicję komend w przypadku użycia ich jako akcji w zdarzeniach/timerach lub poleceniu przypisanym do elementu Przycisk w zakładce Remote.
   
   • Wywołanie apletu bez dodatkowych parametrów
     Na potrzeby przykładu załóżmy, że aplet ma nazwę test
     Nazwa: C.UDP.send.192.168.10.100:1234
     Wartość: hello world
Wysłanie na na IP 192.168.10.100 i port 1234 tekstu hello world.

3. HTTP.get #

Komenda HTTP.get służy do wysyłania żadań HTTP z użyciem metody GET. Komenda nie przetwarza odpowiedzi
zwracanej przez serwer (natychmiast po wysłaniu żądania zamykane jest połączenie). Jeżeli jest wymagane przetwarzanie odpowiedzi, wówczas żądania należy wysyłać z użyciem modułu TCP opisanego w rozdziale Logika.

1. Poniższe przykłady przedstawiają definicję komend w przypadku użycia ich jako akcji w zdarzeniach/timerach lub poleceniu przypisanym do elementu Przycisk w zakładce Remote.
   Na potrzeby przykładu załóżmy, że żądanie HTTP ma nast. URL: http://www.example.com/get/data
   
   • Żądanie bez dodatkowych parametrów
     Nazwa: C.HTTP.get
     Wartość: http://www.example.com/get/data
     Wysłanie żądania na adres http://www.example.com/get/data
     
     Drugi przykład jest bardziej realny – przedstawia sposób na autoresetowanie modułu Base np. w
     efekcie wywołania timera.
     Nazwa: C.HTTP.get
     Wartość: http://admin:admin@192.168.10.102/call/reboot
     Dane uwierzytelniające i adres IP należy zastąpić danymi dostosowanymi do Twojej instalacji.
     
   • Żądanie z dodatkowymi parametrami
     Nazwa: C.HTTP.get
     Wartość: http://www.example.com/get/data?param1=value1&param2=value2
     Wysłanie żądania na adres http://www.example.com/get/data z użyciem dodatkowych parametrów:
     param1=value1&param2=value2