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

| Nazwa opcji | Opis |
|---|---|
| Nazwa Wyświetlana | Nazwa z jaką wejscie będzie wyswietlane w webui sterownika, mqtt, HA. |
| Wejście boneIO | Wybór fizycznego wejścia sterownika. |
| Obszar/Pokój | Wybór odpowiedniego obszaru. |
| Czas odbicia | Definiujemy czas pomiędzy kolejnymi wywołaniami akcji. |
| Klasa Urządzenia | Definiuje typ urzadzenia jakim wyjście będzie się identyfikować w HA. |
| Pokaż w Home Assistant | Umożliwia ukrycie wejścia w HA. |
| Odwrócony | Zaznaczenie spowoduje "odwrócenie" stanu czujnika. |
| Wyslij stan początkowy | Zaznaczenie spowoduje wysłanie stanu czujnika przy starcie aplikacji (przydatne w przypadku kontaktronu) |
| Wyczyść wiadomość po przetworzeniu | Wł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

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 opcji | Opis |
|---|---|
| Output | Wybór konkretnego wyjścia. |
| Akcja Wyjścia | Typ wykonywanej akcji np. najpopularniejszy Toggle (Przełącz). |
Akcja Cover:
| Nazwa opcji | Opis |
|---|---|
| Roleta | Wybór konkretnej rolety. |
| Akcja Rolety | Typ wykonywanej akcji np. najpopularniejszy Toggle (Przełącz). |
Akcja Cover Over Mqtt:
| Nazwa opcji | Opis |
|---|---|
| Roleta | Wybór konkretnej rolety. |
| Roleta | Typ wykonywanej akcji np. najpopularniejszy Toggle (Przełącz). |
| ID boneIO | ID sterownika boneIO w którym chcemy wykonać akcje. |
| ID Rolety (pin) | ID wybranego przez nas Coveru. |
| Akcja Rolety | Typ wykonywanej akcji np. najpopularniejszy Toggle (Przełącz). |
Akcja Mqtt:
| Nazwa opcji | Opis |
|---|---|
| Topic MQTT | Adres tematu MQTT. |
| Wiadomość MQTT | Wiadomość MQTT którą ma wykonać akcja. |
Dla akcji Output Over Mqtt:
| Nazwa opcji | Opis |
|---|---|
| boneIO ID | ID sterownika boneIO w którym chcemy wykonać akcje. |
| ID Output (pin) | ID wybranego przez nas Wyjścia. |
| Akcja Wyjścia | Typ wykonywanej akcji np. najpopularniejszy Toggle (Przełącz). |
Dla akcji Remote Output:
| Nazwa opcji | Opis |
|---|---|
| Zdalne Urządzenie | Nazwa zdalnego urzadzenia którego dotyczy akcja |
| ID Wyjścia | ID wyjścia którego dotyczy akcja |
| Akcja Wyjścia | Typ wykonywanej akcji np. najpopularniejszy Toggle (Przełącz). |
Dla akcji Remote Cover:
| Nazwa opcji | Opis |
|---|---|
| Zdalne Urządzenie | Nazwa zdalnego urzadzenia którego dotyczy akcja |
| ID Rolety | ID rolety której dotyczy akcja |
| Akcja Rolety | Typ wykonywanej akcji np. najpopularniejszy Toggle (Przełącz). |
Edytor yaml
Przykładowa konfiguracja
- name: IN_01
boneio_input: IN_01
actions:
pressed:
- action: output
boneio_output: OUT_01Zmienne 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
outputlubcover. - 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 akcjicover.toggleto przełączanie między otwarciem/zamknięciem.toggle_openoznacza akcje między otwarciem/zatrzymaniem,toggle_closeoznacza akcje między zamknięciem/zatrzymaniem. - action_output (Opcjonalne, string, dozwolone_wartości:
['toggle', 'on', 'off']) - akcja do wykonania dla typu akcjioutput. - action_mqtt_msg (Opcjonalne, string) - wiadomość do wysłania na temat MQTT, jeśli akcją jest
mqtt.