Black Series

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

Web Configuration Interface

Completely redesigned web interface with full configuration management capabilities:

• Visual configuration editor - Configure all entities (outputs, covers, events, binary sensors) through an intuitive web interface
• Real-time validation - Instant feedback on configuration errors with schema validation
• Live preview - See changes instantly without manual file editing
• Multi-language support - Full Polish and English translations

System Management

• Auto-update system - Automatic updates from GitHub releases with one-click installation
• Factory reset - Reset to default configuration for various device types (24x16, 32x10, cover, cover_mix)
• Configuration backups - Automatic backup creation before factory reset with restore capability
• System restart - Application restart directly from the web interface with confirmation

Event Configuration

• Click event types - New click event options: single, double, long, release
• Time period fields - Improved handling of time periods (e.g., double_click_duration: 220ms)
• Removing default values - Fields matching default schema values are no longer saved to YAML

Improved Cover Support

• Venetian blinds - Full support for Venetian blinds with tilt control
• Platform selection - Choice between time_based, venetian, or previous platforms
• Tilt time - Configurable tilt time for Venetian blinds
• Visual tilt control - Dedicated tilt slider in the user interface

Cover Configuration

• Platform field - Default value changed from previous to time_based
• Output selection - Improved dropdown list with grouping by areas and validation
• Duplicate prevention - The same output cannot be selected for the opening and closing relays

🔄 Technical Improvements

Backend

• TimePeriod serialization - Fixed JSON serialization to return strings (e.g., "220ms") instead of objects
• Configuration loading - Use of raw YAML data to preserve string formats
• State file security - Write to a temporary file first, then atomic rename
• Logger improvements - Better logging for debugging and troubleshooting
• File system protection - Added filesystem overflow protection to prevent system crashes

Frontend

• React components refactoring - Improved structure and reusability of components
• OutputSelectDropdown - New reusable component with filtering and exclusion logic
• SimpleTimePeriodInput - Dedicated component for configuring time periods
• Form validation - Improved validation with better error messages
• Package updates - Updated all frontend dependencies

Integration

• Home Assistant 2024.12+ - Full compatibility with the latest Home Assistant
• MQTT improvements - Better handling of the MQTT connection
• Virtual energy sensor - Support for the new virtual energy sensor

📦 New Features

Node-RED Integration

• Added Node-RED view in the web interface
• Proxy configuration for Node-RED access

Nginx Proxy

• Configurable Nginx proxy port
• Better support for reverse proxy

Diagnostic Tools

• Sensors moved to the diagnostic section in Home Assistant
• Improved troubleshooting capabilities
• Better error messages and logging

Debian 13 System Image

• Ready Debian 13 image - Pre-configured system image available for easy installation
• Simplified setup process for new users
• All dependencies pre-installed and configured

🔐 Security and Stability

• Improved error handling throughout the application
• Better user input validation
• Safer file operations with atomic writes
• Configuration backup before destructive operations