Tutorial 2: Integracja z Grenton#
Hook: Masz instalację Grenton i chcesz więcej niż daje Object Manager? vCLU pojawia się w OM jak prawdziwy kontroler — ale pod spodem ma MQTT, HomeKit, dashboardy i agenta AI. Pokażę jak połączyć oba światy.
Co zbudujemy#
Na koniec tego tutoriala:
- vCLU sparowane z Grenton OM jako Gate HTTP
- kod z OM widoczny w edytorze vCLU
- komunikacja między prawdziwym CLU a vCLU
- import obiektów z paczki diagnostycznej
Czas: ~15 minut. Wymaga: Grenton Object Manager na komputerze.
1. Kreator — Gate HTTP#
Przy instalacji (lub ponownej konfiguracji) wybierz Gate HTTP.
To najprostszy tryb integracji z Grenton. vCLU emuluje bramę HTTP — OM widzi ją jako prawdziwe urządzenie.
Trzy tryby w porównaniu:
| Tryb | Kiedy wybrać |
|---|---|
| Standalone | Bez Grenton — czysty MQTT/HomeKit/MCP |
| Gate HTTP | Masz Grenton, chcesz najprostszą integrację |
| CLU | Masz Grenton, potrzebujesz modułów I/O w OM |
PIN#
Ustaw PIN — będzie potrzebny do sparowania z OM.
2. Discovery w OM#
Otwórz Grenton Object Manager. Window → Discovery.
vCLU pojawia się na liście jako Gate HTTP z ustawionym IP.
Kliknij Connect, wpisz PIN.
OM łączy się z vCLU. Od teraz widzisz go w projekcie jak prawdziwy kontroler.
3. Pierwszy kod z OM#
W OM napisz prosty skrypt — np. logowanie tekstu:
-- w user.lua z OM:
print("Witaj z Grenton OM!")Wyślij konfigurację do vCLU (Send Configuration).
W logach vCLU zobaczysz:
[LUA] Witaj z Grenton OM!4. Edytor — co wysłał OM#
Przejdź do Editor w panelu vCLU. Dwa pliki od OM:
| Plik | Co zawiera | Edytowalny? |
|---|---|---|
om.lua | Mapa obiektów, moduły, zdarzenia | Nie — generowany przez OM |
user.lua | Twój kod z OM | Nie — nadpisywany przy sync |
Twój własny kod piszesz w modules/ — te pliki OM nie nadpisuje.
5. Komunikacja CLU ↔ vCLU#
Jeśli masz prawdziwy CLU w sieci, vCLU może wysyłać do niego komendy i odbierać zdarzenia.
-- modules/komunikacja.lua
-- Wyślij komendę do prawdziwego CLU
local lampa = CLU220000592.DOU5048
lampa:switchOn()
-- Reaguj na zmianę stanu
lampa:onChange(function()
log.info("Lampa na CLU zmieniła stan: " .. tostring(lampa:getValue()))
end)6. Import paczki diagnostycznej#
Dwa sposoby na pobranie obiektów z prawdziwego CLU:
Sposób 1 — plik OMF#
W OM: File → Export → zapisz plik .OMF.
W vCLU: OM Files → Upload → wgraj plik.
vCLU parsuje plik i generuje obiekty proxy w imports/.
Sposób 2 — sync#
W panelu vCLU użyj funkcji Sync — automatycznie pobiera konfigurację z OM.
Po imporcie obiekty remote są dostępne w kodzie:
-- Obiekty z prawdziwego CLU
local salon = CLU220000592.DOU5048
local kuchnia = CLU220000592.DOU4458
expose(salon, "switch", {name = "Salon", area = "Salon"})
expose(kuchnia, "switch", {name = "Kuchnia", area = "Kuchnia"})Co dalej?#
- Tutorial 3: MQTT + HomeKit + Home Assistant — podłącz urządzenia Grenton do Apple Home i HA
- Tutorial 4: Automatyzacje i dashboardy — pisz automatyzacje łączące Grenton z MQTT
- Tutorial 5: AI pisze kod za mnie — agent AI zarządza całym systemem