Identyfikatory (WATERGATE) #

Identyfikatory WATERGATE umożliwiają integrację systemu DOMIQ z inteligentnymi zaworami Watergate Sonic. Pozwalają zdalnie sterować dopływem wody, monitorować jej zużycie oraz reagować na nieprawidłowości zgłaszane przez urządzenie.

Integracja jest dostępna wyłącznie dla modułu DOMIQ Base 2.0 i wymaga odpowiedniej licencji.

O tym jak włączyć integrację dowiesz się z tego rozdziału: Rozdział 9.17. Integracje (Watergate Sonic – zawór wody)

Poniższa tabela przedstawia dostępne identyfikatory oraz obsługiwane przez nie funkcje. Szczegółowe opisy i przykłady znajdują się w dalszej części rozdziału.

Format identyfikatora: WATERGATE.<nazwa>.<parametr>

Fragment <nazwa> oznacza nazwę urządzenia zdefiniowaną podczas konfiguracji integracji, a <parametr> – nazwę odczytywanej informacji lub funkcji. W przykładach zastosowano nazwę valve_1. Zastąp ją nazwą własnego urządzenia, bez nawiasów.

Legenda: znak + oznacza obsługiwaną funkcję, a – jej brak. Stan udostępnia bieżącą wartość do odczytu. Zdarzenia przekazują informacje o zmianach wartości lub zdarzeniach zgłaszanych przez urządzenie. Komenda umożliwia wysłanie polecenia do zaworu.

Nazwę zdarzenia tworzy się przez dodanie prefiksu E. do identyfikatora, a nazwę komendy – przez dodanie prefiksu C.. Prefiksy stosuj wyłącznie tam, gdzie tabela wskazuje obsługę danej funkcji.

Kanały dostępne wyłącznie jako zdarzenia nie są kanałami odczytu bieżącego stanu. Dotyczy to grup error.*, event.* i report.*. Jeżeli odebrane dane mają być później prezentowane w interfejsie, zapamiętaj je w zmiennych użytkownika, np. zmiennych MEM.

Przykłady: wartości liczbowe poniżej są poglądowe. Pokazują zawartość pola Dane zdarzenia, a nie zalecane limity ani warunki progowe.

1. WATERGATE.<nazwa>.state #

Identyfikator umożliwia sprawdzenie, czy zawór jest otwarty, oraz zdalne otwieranie i zamykanie dopływu wody. Zmiana stanu zaworu generuje zdarzenie.

Komendy sterujące #

Poniższe komendy możesz przypisać do przycisków w zakładce Remote lub dodać jako akcje zdarzeń i timerów.

Otwarcie zaworu

Nazwa: C.WATERGATE.valve_1.state
Wartość: open

Zamknięcie zaworu

Nazwa: C.WATERGATE.valve_1.state
Wartość: close

Zdarzenie na zmianę stanu #

Kanał: E.WATERGATE.valve_1.state
Dane: close

Zawór został zamknięty.

2. WATERGATE.<nazwa>.locate #

Komenda umożliwia rozpoczęcie lub zakończenie funkcji lokalizacji urządzenia.

Komendy sterujące #

Rozpoczęcie lokalizacji urządzenia

Nazwa: C.WATERGATE.valve_1.locate
Wartość: start

Zakończenie lokalizacji urządzenia

Nazwa: C.WATERGATE.valve_1.locate
Wartość: stop

3. WATERGATE.<nazwa>.flowing #

Identyfikator informuje, czy przez zawór aktualnie przepływa woda. Udostępnia bieżący stan oraz zdarzenia o jego zmianie.

Zdarzenie na zmianę stanu #

Kanał: E.WATERGATE.valve_1.flowing
Dane: 1

Urządzenie zgłosiło przepływ wody przez zawór.

4. WATERGATE.<nazwa>.meter.volume.total #

Identyfikator informuje o całkowitej objętości wody, która przepłynęła przez urządzenie. Wartość jest wyrażana w metrach sześciennych.

Zdarzenie na zmianę stanu #

Kanał: E.WATERGATE.valve_1.meter.volume.total
Dane: 125.5

Całkowita objętość wody zarejestrowana przez urządzenie zmieniła się na 125,5 m³.

5. WATERGATE.<nazwa>.meter.duration.total #

Identyfikator informuje o łącznym czasie przepływu wody przez urządzenie. Wartość jest wyrażana w sekundach.

Zdarzenie na zmianę stanu #

Kanał: E.WATERGATE.valve_1.meter.duration.total
Dane: 3600

Łączny czas przepływu wody zmienił się na 3600 sekund.

6. WATERGATE.<nazwa>.pressure #

Identyfikator informuje o aktualnym ciśnieniu wody w instalacji oraz o zmianach tej wartości. Wartość jest wyrażana w barach.

Zdarzenie na zmianę stanu #

Kanał: E.WATERGATE.valve_1.pressure
Dane: 3.2

Ciśnienie wody zmieniło się na 3,2 bar.

7. WATERGATE.<nazwa>.temperature #

Identyfikator informuje o aktualnej temperaturze wody oraz o zmianach tej wartości. Wartość jest wyrażana w stopniach Celsjusza.

Zdarzenie na zmianę stanu #

Kanał: E.WATERGATE.valve_1.temperature
Dane: 20.5

Temperatura wody zmieniła się na 20,5°C.

8. WATERGATE.<nazwa>.flow #

Identyfikator informuje o aktualnej intensywności przepływu wody oraz o zmianach tej wartości. Wartość jest wyrażana w litrach na minutę.

Zdarzenie na zmianę stanu #

Kanał: E.WATERGATE.valve_1.flow
Dane: 6.5

Intensywność przepływu wody zmieniła się na 6,5 l/min.

9. WATERGATE.<nazwa>.supply #

Identyfikator informuje o źródle zasilania urządzenia oraz o jego zmianach.

Zdarzenie na zmianę stanu #

Kanał: E.WATERGATE.valve_1.supply
Dane: battery

Urządzenie zgłosiło zasilanie z baterii.

10. WATERGATE.<nazwa>.battery_voltage #

Identyfikator informuje o aktualnym napięciu baterii urządzenia oraz o zmianach tej wartości. Wartość jest wyrażana w woltach.

Zdarzenie na zmianę stanu #

Kanał: E.WATERGATE.valve_1.battery_voltage
Dane: 3.6

Napięcie baterii zmieniło się na 3,6 V.

11. WATERGATE.<nazwa>.auto_shut_off.duration #

Identyfikator umożliwia odczyt maksymalnego dopuszczalnego czasu przepływu, po którym zawór zostanie automatycznie zamknięty. Wartość jest wyrażana w minutach. Kanał nie udostępnia komendy zmieniającej ten limit.

Zdarzenie na zmianę stanu #

Kanał: E.WATERGATE.valve_1.auto_shut_off.duration
Dane: 10

Urządzenie zgłosiło zmianę limitu czasu przepływu na 10 minut.

12. WATERGATE.<nazwa>.auto_shut_off.volume #

Identyfikator umożliwia odczyt maksymalnej dopuszczalnej objętości przepływu, po której zawór zostanie automatycznie zamknięty. Wartość jest wyrażana w litrach. Kanał nie udostępnia komendy zmieniającej ten limit.

Zdarzenie na zmianę stanu #

Kanał: E.WATERGATE.valve_1.auto_shut_off.volume
Dane: 50

Urządzenie zgłosiło zmianę limitu objętości przepływu na 50 litrów.

13. WATERGATE.<nazwa>.fw #

Identyfikator umożliwia odczyt wersji oprogramowania urządzenia.

Wyświetlanie wartości #

W polu Kanał kontrolki prezentującej tekst wpisz WATERGATE.valve_1.fw. Wartość możesz również odczytać w zakładce Stan konfiguratora.

14. WATERGATE.<nazwa>.sn #

Identyfikator umożliwia odczyt numeru seryjnego urządzenia.

Wyświetlanie wartości #

W polu Kanał kontrolki prezentującej tekst wpisz WATERGATE.valve_1.sn. Wartość możesz również odczytać w zakładce Stan konfiguratora.

15. WATERGATE.<nazwa>.uptime #

Identyfikator informuje o czasie działania urządzenia oraz o zmianach tej wartości. Wartość jest wyrażana w sekundach.

Zdarzenie na zmianę stanu #

Kanał: E.WATERGATE.valve_1.uptime
Dane: 7200

Zgłoszony czas działania urządzenia zmienił się na 7200 sekund.

16. WATERGATE.<nazwa>.error.flow #

Identyfikator zdarzenia informuje o wykryciu nieprawidłowości przepływu wody. Nie udostępnia bieżącego stanu ani komendy sterującej.

Przykład obsługi zdarzenia #

Kanał: E.WATERGATE.valve_1.error.flow

W polu Dane ustaw wartość lub wzorzec odpowiadający informacji o błędzie faktycznie przekazywanej przez urządzenie. Opis kanału nie określa konkretnego kodu błędu.

Zdarzenie można wykorzystać do uruchomienia powiadomienia lub wysłania komendy zamknięcia zaworu.

17. WATERGATE.<nazwa>.error.pressure #

Identyfikator zdarzenia informuje o niewłaściwym ciśnieniu wody. Nie udostępnia bieżącego stanu ani komendy sterującej.

Przykład obsługi zdarzenia #

Kanał: E.WATERGATE.valve_1.error.pressure

W polu Dane ustaw wartość lub wzorzec odpowiadający informacji o błędzie faktycznie przekazywanej przez urządzenie. Opis kanału nie określa konkretnego kodu błędu.

Zdarzenie można wykorzystać do uruchomienia automatyzacji informującej o nieprawidłowym ciśnieniu w instalacji.

18. WATERGATE.<nazwa>.error.temperature #

Identyfikator zdarzenia informuje o niewłaściwej temperaturze wody. Nie udostępnia bieżącego stanu ani komendy sterującej.

Przykład obsługi zdarzenia #

Kanał: E.WATERGATE.valve_1.error.temperature

W polu Dane ustaw wartość lub wzorzec odpowiadający informacji o błędzie faktycznie przekazywanej przez urządzenie. Opis kanału nie określa konkretnego kodu błędu.

Zdarzenie można wykorzystać do uruchomienia automatyzacji informującej o nieprawidłowej temperaturze wody.

19. WATERGATE.<nazwa>.event.volume #

Identyfikator zdarzenia przekazuje objętość wody, która przepłynęła podczas danego zdarzenia przepływu. Wartość jest wyrażana w litrach.

Przykład obsługi zdarzenia #

Kanał: E.WATERGATE.valve_1.event.volume
Dane: 20.5

Odebrano informację o objętości 20,5 litra dotyczącej danego zdarzenia przepływu.

20. WATERGATE.<nazwa>.event.duration #

Identyfikator zdarzenia przekazuje czas trwania danego zdarzenia przepływu. Wartość jest wyrażana w sekundach.

Przykład obsługi zdarzenia #

Kanał: E.WATERGATE.valve_1.event.duration
Dane: 120

Odebrano informację o czasie trwania zdarzenia przepływu wynoszącym 120 sekund.

21. WATERGATE.<nazwa>.report.type #

Identyfikator zdarzenia informuje o przyczynie automatycznego zamknięcia zaworu: przekroczeniu dopuszczalnej objętości lub czasu przepływu.

Przykład obsługi zdarzenia #

Kanał: E.WATERGATE.valve_1.report.type
Dane: volume_threshold

Zawór został automatycznie zamknięty z powodu przekroczenia limitu objętości wody.

Aby zareagować na przekroczenie dopuszczalnego czasu przepływu, utwórz drugie zdarzenie:

Kanał: E.WATERGATE.valve_1.report.type
Dane: duration_threshold

22. WATERGATE.<nazwa>.report.volume #

Identyfikator zdarzenia przekazuje objętość wody zarejestrowaną przy automatycznym zamknięciu zaworu. Wartość jest wyrażana w litrach.

Przykład obsługi zdarzenia #

Kanał: E.WATERGATE.valve_1.report.volume
Dane: 50

Raport automatycznego zamknięcia zaworu zawiera informację o objętości 50 litrów.

23. WATERGATE.<nazwa>.report.duration #

Identyfikator zdarzenia przekazuje czas przepływu zarejestrowany przy automatycznym zamknięciu zaworu. Wartość jest wyrażana w sekundach.

Przykład obsługi zdarzenia #

Kanał: E.WATERGATE.valve_1.report.duration
Dane: 600

Raport automatycznego zamknięcia zaworu zawiera informację o czasie przepływu wynoszącym 600 sekund.

24. WATERGATE.<nazwa>.report.timestamp #

Identyfikator zdarzenia przekazuje znacznik czasu automatycznego zamknięcia zaworu. Format wartości zależy od danych przekazywanych przez urządzenie.

Przykład obsługi zdarzenia #

Kanał: E.WATERGATE.valve_1.report.timestamp

Pole Dane dopasuj do formatu znacznika czasu przekazywanego przez urządzenie. Odebraną wartość możesz wykorzystać w logice systemu lub zapisać do późniejszej prezentacji.

Przykłady zastosowania #

1. Sterowanie i podgląd instalacji wodnej w aplikacji DOMIQ Remote #

W zakładce Remote utwórz sekcję „Instalacja wodna”. Do sterowania zaworem możesz użyć elementu Przełącznik z etykietą „Główny zawór wody”. Przypisz kanał stanu WATERGATE.valve_1.state i skonfiguruj wartości open – zawór otwarty oraz close – zawór zamknięty.

Polecenie otwarcia zaworu ma nazwę C.WATERGATE.valve_1.state i wartość open. Polecenie zamknięcia ma tę samą nazwę i wartość close. Możesz także przypisać te komendy do dwóch osobnych przycisków „Otwórz wodę” i „Zamknij wodę”.

Do prezentacji parametrów instalacji dodaj kontrolki wyświetlające wartości:

2. Zamknięcie zaworu po zgłoszeniu błędu przepływu #

W zakładce Zdarzenia dodaj regułę reagującą na informację o błędzie przepływu:

Kanał: E.WATERGATE.valve_1.error.flow

W polu Dane ustaw wartość lub wzorzec odpowiadający zgłoszeniu błędu faktycznie przekazywanemu przez urządzenie. W sekcji Akcje dodaj komendę:

Nazwa: C.WATERGATE.valve_1.state
Wartość: close

Po odebraniu zdarzenia spełniającego ustawione warunki DOMIQ wyśle polecenie zamknięcia zaworu.

3. Zamknięcie zaworu podczas nieobecności domowników #

W regule uruchamianej po aktywowaniu trybu „Poza domem” dodaj w sekcji Akcje komendę:

Nazwa: C.WATERGATE.valve_1.state
Wartość: close

Jeżeli scenariusz powrotu ma przywracać dopływ wody, użyj komendy:

Nazwa: C.WATERGATE.valve_1.state
Wartość: open

Automatyczne otwarcie zaworu powinno następować wyłącznie wtedy, gdy nie występuje aktywny alarm ani inne zagrożenie.

4. Reakcja na automatyczne zamknięcie zaworu #

Urządzenie może automatycznie zamknąć zawór po przekroczeniu skonfigurowanego limitu objętości lub czasu przepływu. DOMIQ może zareagować na raport przyczyny zamknięcia, np. uruchamiając powiadomienie.

Przekroczenie limitu objętości wody

Kanał: E.WATERGATE.valve_1.report.type
Dane: volume_threshold

Przekroczenie limitu czasu przepływu

Kanał: E.WATERGATE.valve_1.report.type
Dane: duration_threshold

W obu przypadkach zdefiniuj odpowiednie komendy w sekcji Akcje. Parametry auto_shut_off.duration i auto_shut_off.volume umożliwiają odczyt limitów; w opisanej integracji nie służą do ich zmiany.

Dodatkowe informacje raportu są przekazywane kanałami zdarzeń:

Aby wyświetlać ostatnie odebrane wartości raportu w interfejsie użytkownika, zapisz je w zmiennych użytkownika i przypisz te zmienne do kontrolek. Nie przypisuj w tym celu identyfikatorów WATERGATE.valve_1.report.* jako kanałów stanu — ta grupa udostępnia wyłącznie zdarzenia.