Seria Black

Witaj w dokumentacji boneIO Black!

Na tej stronie znajdziesz przewodniki krok po kroku oraz instrukcje dotyczące, podłączenia a także konfiguracji Twojego sterownika boneIO Black! Cała dokumentacja podzielona jest na 2 segmenty, część poświęcona sprzetowi - znajdziesz tam wszystko co niezbędne aby zainstalować urządzenie w rozdzielni, następnie podłączyć wejścia, wyjścia i wszystkie magistrale.

Dokumentacja sprzętowa

Dokumentacja sprzętowa różni się w zależności od wybranego przez Ciebie sterownika. O ile wszystkie wejścia, ich sposób połączenia, jak i wbudowane magistrale są tożsame dla wszystkich urządzeń serii Black. Tak konfiguracja wyjść i to jak je podłączamy jest specyficzne dla konkretnego modelu.

Dlatego podzieliliśmy tą część w zależności od produktu, na:

• Black 32x10A,
• Black 24x16A,
• Black Cover,
• Black Cover Mix,

Dokumentacja aplikacji

Twoje urządzenie jest dostarczane z preinstalowaną aplikacją boneIO. Aplika boneIO Black, jest taka sama niezależnie od wersji sterownika - różni się jedynie domyślną konfiguracją. Będziesz musiał ją dostosować do swoich indywidualnych wymagań. Poniżej znajdziesz opis co znajdziesz w naszej aplikacji od wersji 1.x.x a Samą dokumentacje aplikacji znajdziesz w części Aplikacja Black.

🎉 Black App

Webowy interfejs konfiguracji

Kompletnie przeprojektowany interfejs webowy z pełnymi możliwościami zarządzania konfiguracją:

• Wizualny edytor konfiguracji - Konfiguruj wszystkie encje (wyjścia, rolety, zdarzenia, czujniki binarne) przez intuicyjny interfejs webowy
• Walidacja w czasie rzeczywistym - Natychmiastowa informacja zwrotna o błędach konfiguracji z walidacją schematu
• Podgląd na żywo - Zobacz zmiany natychmiast bez ręcznej edycji plików
• Wsparcie wielu języków - Pełne tłumaczenia polskie i angielskie

Zarządzanie systemem

• System auto-aktualizacji - Automatyczne aktualizacje z wydań GitHub z instalacją jednym kliknięciem
• Przywracanie ustawień fabrycznych - Reset do domyślnej konfiguracji dla różnych typów urządzeń (24x16, 32x10, cover, cover_mix)
• Kopie zapasowe konfiguracji - Automatyczne tworzenie kopii zapasowej przed resetem fabrycznym z możliwością przywracania
• Restart systemu - Restart aplikacji bezpośrednio z interfejsu webowego z potwierdzeniem

Konfiguracja zdarzeń

• Typy zdarzeń kliknięcia - Nowe opcje zdarzeń kliknięcia: single, double, long, release
• Pola okresu czasu - Ulepszona obsługa okresów czasu (np. double_click_duration: 220ms)
• Usuwanie wartości domyślnych - Pola pasujące do wartości domyślnych schematu nie są już zapisywane do YAML

Ulepszone wsparcie rolet

• Żaluzje weneckie - Pełne wsparcie dla żaluzji weneckich z kontrolą nachylenia lameli
• Wybór platformy - Wybór między platformami time_based, venetian lub previous
• Czas nachylenia - Konfigurowalny czas nachylenia lameli dla żaluzji weneckich
• Wizualna kontrola nachylenia - Dedykowany suwak nachylenia w interfejsie użytkownika

Konfiguracja rolet

• Pole platformy - Domyślna wartość zmieniona z previous na time_based
• Wybór wyjścia - Ulepszona lista rozwijana z grupowaniem według obszarów i walidacją
• Zapobieganie duplikatom - Nie można wybrać tego samego wyjścia dla przekaźnika otwierania i zamykania

🔄 Ulepszenia techniczne

Backend

• Serializacja TimePeriod - Naprawiono serializację JSON aby zwracać stringi (np. "220ms") zamiast obiektów
• Ładowanie konfiguracji - Użycie surowych danych YAML aby zachować formaty stringów
• Bezpieczeństwo pliku stanu - Najpierw zapis do pliku tymczasowego, następnie atomowe przemianowanie
• Ulepszenia loggera - Lepsze logowanie do debugowania i rozwiązywania problemów
• Ochrona systemu plików - Dodano zabezpieczenie przed przepełnieniem systemu plików aby zapobiec awariom systemu

Frontend

• Refaktoryzacja komponentów React - Ulepszona struktura i możliwość ponownego użycia komponentów
• OutputSelectDropdown - Nowy komponent wielokrotnego użytku z filtrowaniem i logiką wykluczania
• SimpleTimePeriodInput - Dedykowany komponent do konfiguracji okresów czasu
• Walidacja formularzy - Ulepszona walidacja z lepszymi komunikatami błędów
• Aktualizacje pakietów - Zaktualizowano wszystkie zależności frontend

Integracja

• Home Assistant 2024.12+ - Pełna kompatybilność z najnowszym Home Assistant
• Ulepszenia MQTT - Lepsza obsługa połączenia MQTT
• Wirtualny czujnik energii - Wsparcie dla nowego wirtualnego czujnika energii

📦 Nowe funkcje

Integracja Node-RED

• Dodano widok Node-RED w interfejsie webowym
• Konfiguracja proxy dla dostępu do Node-RED

Proxy Nginx

• Konfigurowalny port proxy nginx
• Lepsze wsparcie dla reverse proxy

Narzędzia diagnostyczne

• Czujniki przeniesione do sekcji diagnostycznej w Home Assistant
• Ulepszone możliwości rozwiązywania problemów
• Lepsze komunikaty błędów i logowanie

Obraz systemu Debian 13

• Gotowy obraz Debian 13 - Dostępny prekonfigurowany obraz systemu dla łatwej instalacji
• Uproszczony proces konfiguracji dla nowych użytkowników
• Wszystkie zależności preinstalowane i skonfigurowane

🔐 Bezpieczeństwo i stabilność

• Ulepszona obsługa błędów w całej aplikacji
• Lepsza walidacja danych wejściowych użytkownika
• Bezpieczniejsze operacje na plikach z atomowymi zapisami
• Kopia zapasowa konfiguracji przed destrukcyjnymi operacjami