Pierwsze uruchomienie#

Przy pierwszym uruchomieniu vCLU przeprowadzi Cię przez kreator konfiguracji (wizard). Cały proces zajmuje 2-3 minuty.

Uruchomienie kreatora#

Otwórz przeglądarkę i przejdź do:

http://<IP>:8080

Serwer sprawdza, czy konfiguracja została już ukończona (IsSetupComplete). Jeśli nie – automatycznie przekierowuje na /wizard.

Krok 1 – Typ urządzenia#

Wybierz tryb pracy vCLU:

Typ	Serial	Opis
Gate	5200*	Smart Home Gateway – tryb bridge, bez modułów I/O. Służy jako brama między Grenton a MQTT/HomeKit.
CLU	2210*	Standardowy CLU z modułami I/O. Emuluje fizyczny Grenton CLU – widoczny w Object Manager, obsługuje moduły wyjść/wejść.
Standalone	–	Bez integracji Grenton. Czysty tryb MQTT/HomeKit/MCP – do pracy z urządzeniami Zigbee, Tasmota, Shelly bez potrzeby parowania z OM.

Tryb CLU jest najczęstszym wyborem, jeśli chcesz zintegrować vCLU z istniejącą instalacją Grenton. Tryb Standalone jest najlepszy, jeśli budujesz system od zera bez kontrolerów Grenton.

Krok 2 – Moduły (tylko tryb CLU)#

W trybie CLU możesz dodać wirtualne moduły I/O, które będą widoczne w Object Manager:

Typ modułu	Wyjścia DOUT	Wejścia DIN	HW Type
DOUT8T	8	8	0x1e
RELAY4	4	–	0x15
DIN8	–	8	0x14

Każdy dodany moduł otrzymuje automatycznie wygenerowany numer seryjny i unikalne identyfikatory obiektów I/O (np. DOU5048, DIN3271).

Moduły wirtualne nie sterują fizycznym sprzętem, ale są w pełni funkcjonalne w systemie – emitują zdarzenia, działają z expose(), pojawiają się w Home Assistant i HomeKit. Do sterowania prawdziwymi przekaźnikami na Raspberry Pi użyj GPIO (patrz GPIO).

W trybie Gate i Standalone ten krok jest pomijany.

Krok 3 – Klucze i PIN#

Konfiguracja szyfrowania komunikacji z Grenton Object Manager:

Klucze AES-128 – para kluczy do szyfrowania pakietów UDP między vCLU a OM
PIN – 8-znakowy kod do parowania vCLU z Object Manager

Jeśli pozostawisz pola puste, klucze i PIN zostaną wygenerowane automatycznie z kryptograficznie bezpiecznego generatora (crypto/rand). Wygenerowane wartości zostaną wyświetlone w podsumowaniu.

Jeśli chcesz sparować vCLU z istniejącą instalacją Grenton, wpisz klucze z konfiguracji OM.

Krok 4 – Zabezpieczenia#

Ustawienie hasła do panelu webowego:

Minimalna długość: 8 znaków
Hasło jest hashowane algorytmem bcrypt przed zapisem
Hasło jest obowiązkowe – nie można pominąć tego kroku

Hasło chroni dostęp do panelu webowego, API i narzędzi diagnostycznych. Po ustawieniu logowanie odbywa się na stronie /login.

Krok 5 – Podsumowanie#

Przegląd wybranej konfiguracji:

Typ urządzenia i numer seryjny
Lista modułów i obiektów I/O
Klucze szyfrowania i PIN (jeśli dotyczy)
Status zabezpieczeń

Po zatwierdzeniu vCLU generuje pliki konfiguracyjne:

.vclu.json – główna konfiguracja (moduły, klucze, ustawienia)
config.txt – konfiguracja TFBus odczytywana przez OM (TFTP)
CONFIG.JSON – lista modułów z typami sprzętowymi

Po zakończeniu kreatora#

System uruchamia się z nową konfiguracją. Panel webowy jest dostępny pod adresem:

http://<IP>:8080

Strona główna (/status) wyświetla dashboard z informacjami o systemie:

Status usługi i czas pracy
Lista urządzeń i ich stan
Metryki systemowe

Co dalej?#

W zależności od wybranego trybu:

CLU / Gate – uruchom Object Manager i wykonaj discovery, aby sparować vCLU z instalacją Grenton
Standalone – skonfiguruj integracje MQTT w pliku user.lua (patrz Moduły)

Ponowne uruchomienie kreatora#

Kreator uruchamia się tylko raz – przy pierwszym starcie. Aby go uruchomić ponownie, usuń plik konfiguracyjny:

rm /opt/vclu/data/.vclu.json
sudo systemctl restart vclu

Po restarcie vCLU znów przekieruje na /wizard.