Encje Zdarzeń

Wejścia cyfrowe używane w sterowniku, prezentowane jako encja Zdarzeń (Event) w Home Assistant. Działa tylko z Home Assistant w wersji 2023.8 i nowszych! Encja Zdarzeń wysyła wiadomość MQTT dla akcji pojedynczego, podwójnego, potrójnego, długiego naciśnięcia, jak i sekwencje akcji.

Konfiguracja w aplikacji webowej

Zalecany sposób konfiguracji.

Przykładowa konfiguracja webui

Widok umożliwiający podgląd zdefiniowanych encji zdarzeń, podgląd przypisanych do nich akcji, jak i dodanie nowych encji zdarzeń. Dodatkowo umożliwia ich eksport i import.

Ustawienia podstawowe

Pojedyncze / Podwójne / Potrójne / Długie

Typ akcji - Otwiera listę zdefiniowanych akcji (dostępna tutaj). W zależności od wybranego typu akcji zmianie podlegają dostępne opcje. Ich lista w tabelach ponizej.

Akcja Output:

Akcja Cover:

Akcja Cover Over Mqtt:

Akcja Mqtt:

Dla akcji Output Over Mqtt:

Dla akcji Remote Output:

Dla akcji Remote Cover:

Sekwencje

Widok sekwencji umozłiwia wykonanie analogicznych akcji jak w przypadku poprzednich (pojedyncze, podwójne etc.). W przypadku sekwencji, po zaznaczeniu opcji MQTT - Sekwencja zostanie wysłana w mqtt

Ustawienia Zaawansowane

Edytor yaml

Przykładowa konfiguracja

event:
  - boneio_input: in_29
    name: Przycisk w kuchni
    actions:
      single:
        - action: output
          boneio_output: OUT_01
          action_output: toggle

Zmienne konfiguracyjne:

• name (string) - Nazwa wyświetlana w Home Assistant.

• boneio_input (Opcjonalne, string) - Odniesienie do predefiniowanej konfiguracji wejścia (np. in_01, in_02).

• area (Opcjonalne, string) - Odniesienie do ID obszaru zdefiniowanego w sekcji areas. Tworzy pod-urządzenie powiązane z głównym urządzeniem BoneIO.

• id (Opcjonalne, string) - Identyfikator techniczny używany w tematach MQTT i akcjach.

  • Jeśli boneio_input jest ustawiony: id jest opcjonalny (domyślnie przyjmuje wartość boneio_input)
  • Jeśli boneio_input NIE jest ustawiony: id jest WYMAGANY
  • Jeśli oba są ustawione: id nadpisuje boneio_input jako identyfikator

• Dostępne tylko gdy sekcja boneio: jest skonfigurowana. Używane jako domyślne ID, jeśli pole id nie jest określone.

• pin (Opcjonalne, string) - ID pinu GPIO na płytce Beaglebone, np. P9_33. Nie jest potrzebne przy użyciu boneio_input.

• gpio_mode (Opcjonalne, string, domyślnie: gpio, dozwolone_wartości: ['gpio', 'gpio_pu', 'gpio_pd', 'gpio_input']) - Jak uruchomić to GPIO. gpio oznacza domyślny tryb gpio. gpio_pu = gpio pull up, gpio_pd = gpio pull down, gpio_input - do sprawdzenia.

• clear_message (Opcjonalne, boolean, domyślnie: False) - Decyduje, czy po wywołaniu zwrotnym (callback) naciśnięcia/puszczenia wysłać pustą wiadomość do MQTT. Tak samo, jak robi to Zigbee2Mqtt w akcjach przycisków. Do wersji 0.6.x domyślnie było to 'true'.

• bounce_time (Opcjonalne, timeperiod, domyślnie: 30ms) - Czas "odbicia" (debounce) dla GPIO w milisekundach. Tylko do zaawansowanego użytku.

• double_click_duration (Opcjonalne, timeperiod, domyślnie: 220ms) - Okno czasowe w milisekundach do wykrycia podwójnego kliknięcia. Jeśli drugie kliknięcie nastąpi w tym czasie, zostanie wykryte jako podwójne kliknięcie.

• long_press_duration (Opcjonalne, timeperiod, domyślnie: 400ms) - Czas w milisekundach do wykrycia długiego naciśnięcia. Jeśli przycisk jest przytrzymany dłużej niż ten czas, zostanie wykryty jako długie naciśnięcie.

• show_in_ha (Opcjonalne, boolean, domyślnie: True) - Wyślij wiadomość autodetekcji (autodiscovery) do Home Assistant.

• device_class (Opcjonalne, string, domyślnie: button, dozwolone_wartości: ["button", "doorbell", "motion"]) - Typ urządzenia, który ma być widoczny w Home Assistant.

• inverted (Opcjonalne, boolean, domyślnie: False) - Odwraca wartość wejścia czujnika wyświetlaną w MQTT.

• actions (Opcjonalne, dictionary) - słownik predefiniowanych akcji ([single, double, long]).

Zmienne konfiguracyjne, które można pominąć, jeśli używasz konfiguracji boneio: i boneio_input::

• pin (Wymagane, string) - ID pinu GPIO na płytce Beaglebone, np. P9_33.
• gpio_mode (Opcjonalne, string, domyślnie: gpio, dozwolone_wartości: ['gpio', 'gpio_pu', 'gpio_pd', 'gpio_input']) - Jak uruchomić to GPIO. gpio oznacza domyślny tryb gpio. gpio_pu = gpio pull up, gpio_pd = gpio pull down, gpio_input - do sprawdzenia.

Akcje

• single (Opcjonalne, list): lista akcji do wykonania, jeśli przełącznik jest naciśnięty pojedynczo.
• double (Opcjonalne, list): lista akcji do wykonania, jeśli przełącznik jest naciśnięty podwójnie.
• long (Opcjonalne, list): lista akcji do wykonania, jeśli przełącznik jest naciśnięty długo.

Zmienne akcji dla listy akcji

• action (Opcjonalne, string, domyślnie: output, dozwolone_wartości: ['mqtt', 'output', 'cover']) - typ akcji. 'Output' (wyjście) i 'cover' (roleta) oznaczają, że polecenie jest wysyłane bezpośrednio do przekaźnika wyjściowego lub rolety. Ten tryb nie wymaga sieci do działania. 'Mqtt' oznacza, że dodatkowa akcja jest wysyłana do MQTT. Na przykład, możesz bezpośrednio sterować drugim boneIO!
• boneio_output (Opcjonalne, string) - Odniesienie do ID wyjścia, na którym ma zostać wykonana akcja. Używaj z typem akcji output. Zalecane zamiast przestarzałego pola pin.
• boneio_cover (Opcjonalne, string) - Odniesienie do ID rolety, na której ma zostać wykonana akcja. Używaj z typem akcji cover. Zalecane zamiast przestarzałego pola pin.
• pin (Przestarzałe, string) - Starsze pole dla ID wyjścia/rolety. Używaj boneio_output lub boneio_cover zamiast tego.
• topic (Opcjonalne, string) - temat (topic) do użycia, jeśli wybrano akcję mqtt.
• action_cover (Opcjonalne, string, dozwolone_wartości: ['toggle', 'open', 'close', 'stop', 'toggle_open', 'toggle_close']) - akcja do wykonania dla typu akcji cover. toggle to przełączanie między otwarciem/zamknięciem. toggle_open oznacza akcje między otwarciem/zatrzymaniem, toggle_close oznacza akcje między zamknięciem/zatrzymaniem.
• action_output (Opcjonalne, string, dozwolone_wartości: ['toggle', 'on', 'off']) - akcja do wykonania dla typu akcji output.
• action_mqtt_msg (Opcjonalne, string) - wiadomość do wysłania na temat MQTT, jeśli akcją jest mqtt.