Przejdź do treści

Automatyzacja

Lista automatyzacji

Na ekranie wydrukowana zostanie lista nazwa automatyzacji.

gateway-controller automation ls

Drukowanie automatyzacji

gateway-controller automation print

Utworzenie/aktualizacja automatyzacji

Przed utworzeniem automatyzacji należy stworzyć plik konfiguracyjny w formacie YAML, w którym opisane zostaną reguły automatyzacji. 

gateway-controller automation create config.yaml

Usunięcie automatyzacji

Aby usunąć automatyzację należy podać jej nazwę.

gateway-controller automation rm $NAZWA$

Plik opisujący reguły automatyzacji

Plik opisujący reguły automatyzacji powinien zostać zapisany w formacie YAML. Plik może zawierać więcej niż jeden dokument.

Przykładowy plik składa się z dwóch dokumentów. Każdy dokument opisuję jedną automatyzację.

---
name: turn on
trigger:
  - remote:
      zwave: [2,1]
      key: 1
  - taptap:
      zwave: [6,1]
      count: 1
action:
  - switch_on:
      zwave: [3,1]
  - switch_on:
      zwave: [4,1]
---
name: turn off
trigger:
  - remote:
      zwave: [2,1]
      key: 2
  - taptap:
      zwave: [6,1]
      count: 2
action:
  - switch_off:
      zwave: [3,1]
  - switch_off:
      zwave: [4,1]

Automatyzacja składa się z trzech części:

  • nazwy - name
  • sekcji wyzwalaczy - trigger
  • sekcji akcji - action

Nazwa

Nazwa służy do identyfikacji automatyzacji przez użytkownika.

Sekcja wyzwalaczy

Sekcja wyzwalaczy to lista reguł, z których spełnienie przynajmniej jednej spowoduje wyzwolenie automatyzacji.

Wyzwalacz remote

Reguła pozwala reagować na naciśnięcie przycisku na pilocie czy kontrolerze scen.

Reguła składa się z dwóch pól:

Przykład: 

remote:
  zwave: [2,1]
  key: 1

Przykład z liczbą naciśnięć:

remote:
  zwave: [2,1]
  key: 1
  count: 2

Wyzwalacz taptap

Reguła pozwala reagować na uderzenie rejestrowane przez urządzenie TapTap.

Reguła składa się z dwóch pól:

Przykład:

taptap:
  zwave: [3,1]
  count: 2

Wyzwalacz openclose

Reguła pozwala reagować na zmiany czujnika otwarcia/zamknięcia.

Reguła składa się z dwóch pól:

Dozwolone wartości stanu czujnika

  • stan otwarcia - open
  • stan zamknięcia - closed

Przykład dla stanu otwarcia:

openclose:
  zwave: [3,1]
  state: open

Przykład dla stanu zamknięcia:

openclose:
  zwave: [3,1]
  state: closed

Sekcja akcji

Sekcja akcji to lista operacji, które zostaną wykonane jest nastąpi wyzwolenie automatyzacji.

Akcja switch_on

Akcja pozwala włączyć urządzenie, które posiada funkcję switch.

Akcja składa się z jednego pola:

Przykład:

switch_on:
  zwave: [4,1]

Akcja switch_off

Akcja pozwala wyłączyć urządzenie, które posiada funkcję switch.

Akcja składa się z jednego pola:

Przykład:

switch_off:
  zwave: [4,1]

Akcja set_color

Akcja pozwala zmianę koloru urządzenia, które posiada funkcję color.

Akcja składa się z kilku pól:

  • metadanych urządzenia
  • intensywność ciepłego białego - warm_white
  • intensywność zimnego białego - cold_white
  • kolor w formacie RGB - rgb

Przykłady:

set_color:
  zwave: [4,1]
  warm_white: 100

set_color:
  zwave: [4,1]
  cold_white: 255

set_color:
  zwave: [4,1]
  rgb: ff00fa

Metadane urządzenia

Metadane urządzenia służą do określenia, którego urządzenia dotyczy dana reguła lub akcja.

Obsługiwane typu metadanych:

  • Z-Wave - zwave
  • etykieta - alias

Metadane Z-Wave

Metadane urządzenia Z-Wave podajemy jako dwuelementową tablicę. Pierwszy element tablicy określa numer węzła, a drugi numer punktu końcowego.

Przykład:

zwave: [4,1]

Metadane etykiety

Metadane etykiety podajemy jako nazwę, którą dodaliśmy do rejestru etykiet.

Przykład:

alias: czajnik