O NasBlogKontakt

Wejścia binarne

Wejścia cyfrowe używane w sterowniku, prezentowane jako Czujnik binarny (Binary sensor) w Home Assistant. Wysyłają one wiadomości MQTT dla akcji pressed (naciśnięto), released (puszczono).

Konfiguracja w aplikacji webowej

Zalecany sposób konfiguracji.

Przykładowa konfiguracja webui

Widok menu Czujniki binarne

Widok umożliwiający podgląd zdefiniowanych wejść binarnych, podgląd przypisanych do nich akcji, jak i dodanie nowych wejść binarnych. Dodatkowo umożliwia ich eksport i import.

Ustawienia Podstawowe

Widok menu Czujniki binarne

Nazwa opcjiOpis
Nazwa WyświetlanaNazwa z jaką wejscie będzie wyswietlane w webui sterownika, mqtt, HA.
Wejście boneIOWybór fizycznego wejścia sterownika.
Obszar/PokójWybór odpowiedniego obszaru.
Czas odbiciaDefiniujemy czas pomiędzy kolejnymi wywołaniami akcji.
Klasa UrządzeniaDefiniuje typ urzadzenia jakim wyjście będzie się identyfikować w HA.
Pokaż w Home AssistantUmożliwia ukrycie wejścia w HA.
OdwróconyZaznaczenie spowoduje "odwrócenie" stanu czujnika.
Wyslij stan początkowyZaznaczenie spowoduje wysłanie stanu czujnika przy starcie aplikacji (przydatne w przypadku kontaktronu)
Wyczyść wiadomość po przetworzeniuWłaściwość action jest czyszczona natychmiast po wysłaniu komunikatu, aby wymusić zmianę stanu sensora i umożliwić ponowne wyzwalanie automatyzacji w Home Assistant.

Akcje Naciśnięcia / Akcje Puszczenia

Widok menu Czujniki binarne

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:
Nazwa opcjiOpis
OutputWybór konkretnego wyjścia.
Akcja WyjściaTyp wykonywanej akcji np. najpopularniejszy Toggle (Przełącz).
Akcja Cover:
Nazwa opcjiOpis
RoletaWybór konkretnej rolety.
Akcja RoletyTyp wykonywanej akcji np. najpopularniejszy Toggle (Przełącz).
Akcja Cover Over Mqtt:
Nazwa opcjiOpis
RoletaWybór konkretnej rolety.
RoletaTyp wykonywanej akcji np. najpopularniejszy Toggle (Przełącz).
ID boneIOID sterownika boneIO w którym chcemy wykonać akcje.
ID Rolety (pin)ID wybranego przez nas Coveru.
Akcja RoletyTyp wykonywanej akcji np. najpopularniejszy Toggle (Przełącz).
Akcja Mqtt:
Nazwa opcjiOpis
Topic MQTTAdres tematu MQTT.
Wiadomość MQTTWiadomość MQTT którą ma wykonać akcja.
Dla akcji Output Over Mqtt:
Nazwa opcjiOpis
boneIO IDID sterownika boneIO w którym chcemy wykonać akcje.
ID Output (pin)ID wybranego przez nas Wyjścia.
Akcja WyjściaTyp wykonywanej akcji np. najpopularniejszy Toggle (Przełącz).
Dla akcji Remote Output:
Nazwa opcjiOpis
Zdalne UrządzenieNazwa zdalnego urzadzenia którego dotyczy akcja
ID WyjściaID wyjścia którego dotyczy akcja
Akcja WyjściaTyp wykonywanej akcji np. najpopularniejszy Toggle (Przełącz).
Dla akcji Remote Cover:
Nazwa opcjiOpis
Zdalne UrządzenieNazwa zdalnego urzadzenia którego dotyczy akcja
ID RoletyID rolety której dotyczy akcja
Akcja RoletyTyp wykonywanej akcji np. najpopularniejszy Toggle (Przełącz).

Edytor yaml

Przykładowa konfiguracja

Przykładowa konfiguracja
    - name: IN_01
      boneio_input: IN_01
      actions:
        pressed:
          - action: output
            boneio_output: OUT_01

Zmienne konfiguracyjne:

  • name Zdefiniowana przez nas nazwa wejścia w MQTT i Home Assistant.

  • boneio_input (Opcjonalne, string, domyślnie) - Nazwa wejścia sterownika boneIO. Użyj znaku podkreślenia dla spacji.

  • pin (Wymagane, string) - ID pinu GPIO na płytce Beaglebone, np. P9_33.

  • actions (Opcjonalne, dictionary) - słownik predefiniowanych akcji ([pressed, released]).

  • 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.

  • bounce_time (Opcjonalne, timeperiod, domyślnie: 120 ms) - Czas "odbicia" (debounce) dla GPIO przed wywołaniem zwrotnym. Użyj, jeśli domyślna wartość nie działa dla Ciebie. Ustawienie zbyt wysokiej wartości może zakłócić działanie zdarzeń typu "klik" dla rodzaju switch.

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

  • device_class (Opcjonalne, string, dozwolone_wartości: ['battery', 'battery_charging', 'carbon_monoxide', 'cold', 'connectivity', 'door', 'garage_door', 'gas', 'heat', 'light', 'lock', 'moisture', 'motion', 'moving', 'occupancy', 'opening', 'plug', 'power', 'presence', 'problem', 'running', 'safety', 'smoke', 'sound', 'tamper', 'vibration', 'window']) - 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.

  • initial_send (Opcjonalne, boolean, domyślnie: False) - Jeśli ustawione na true, początkowy status czujnika binarnego zostanie wysłany do MQTT podczas uruchamiania aplikacji.

  • kind (Opcjonalne, string, domyślnie: switch, dozwolone_wartości: ['switch', 'sensor']) - Typ urządzenia do wysłania do Home Assistant. Ten rodzaj wskazuje, jakich akcji możesz użyć.

Akcje

  • pressed (Opcjonalne, list): lista akcji do wykonania, jeśli czujnik jest naciśnięty.
  • released (Opcjonalne, list): lista akcji do wykonania, jeśli czujnik jest puszczony.

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!
  • pin (Opcjonalne, string) - ID pinu wyjściowego, na którym ma zostać wykonana akcja. Używaj tylko z typem akcji output lub cover.
  • 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.