boneIO Black v1.0.0 - Informacje o aplikacji

Wstęp

To jest główne wydanie z istotnymi ulepszeniami interfejsu webowego, zarządzania konfiguracją i ogólnej stabilności. Na tytułowej stronie znajdziesz najważniejsze informacje o aplikacji, jak i przewodnik po dokumentacji. Dokumentacja została stworzona tak aby wykonywać ją krok po kroku. Rozpoczynając od działu Instalacja, poprzez Konfiguracje, Obsługę a kończąc na Zaawansowanych funkcjach. Po zapoznaniu się z nią będziesz w stanie samodzielnie skonfigurować i obsługiwac sterownik.

🎉 Główne funkcje w v1.0.x

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

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

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

📝 Dokumentacja

• Zaktualizowane przykłady konfiguracji dla wszystkich typów urządzeń
• Ulepszona pomoc inline i podpowiedzi
• Lepsze komunikaty błędów z praktycznymi sugestiami

Jak używać?

Sprawdź nasze strony produktowe, znajdziesz tam podstawowe wskazówki dotyczące nowej aplikacji! W przyszłości zamierzamy ulepszyć dokumentację o ważne kwestie, takie jak NodeRED itp.

Konfiguracja

Zalecana metoda konfiguracji: Interfejs Webowy (Web UI)

Najprostszym sposobem na skonfigurowanie boneIO Black jest interfejs webowy dostępny pod adresem https://adres-ip-twojego-urzadzenia:8443. Interfejs webowy zapewnia:

• Wizualny edytor konfiguracji z walidacją w czasie rzeczywistym
• Automatyczną walidację schematu
• Podgląd zmian na żywo
• Obsługę wielu języków (angielski/polski)

W razie potrzeby możesz również ręcznie edytować pliki konfiguracyjne YAML. Wszystkie pliki konfiguracyjne znajdują się w katalogu ~/boneio/.

Różne

Wyjścia

Wejścia

Czujniki