Do czego służy integracja
Web Master odczytuje stan centrali i opraw przez lokalne HTTP API zgodne z adapterem EZ2, schemat ges-v2. Interfejs udostępnia dane do nadzoru. Uruchamianie testów opisuje osobno Modbus IP.
Przygotuj połączenie
- Podłącz centralę i komputer integratora do sieci, w której mogą się komunikować.
- Zanotuj adres IP centrali. Zapewnij stały adres lub rezerwację DHCP.
- W ustawieniach lokalnego API centrali włącz udostępnianie danych opraw. Wyłączona opcja powoduje HTTP 403 dla listy i diagnostyki opraw.
- Otwórz adres centrali w przeglądarce. Następnie sprawdź
/data/systeminfo.phpi/lumlist.php. - W Web Master wybierz integrację EZ2 i wprowadź adres centrali, zgodnie z konfiguracją Twojego Web Mastera.
- Zaimportuj listę, porównaj liczbę urządzeń i lokalizacje z centralą. Dodaj opisy kodów błędów według
/data/errorcodes.php.
Adres 192.168.1.50 w przykładach zastąp adresem swojej centrali. Usługi udostępniaj w zaufanej sieci nadzorczej. Ten interfejs lokalny nie wymaga tokenu; nie wystawiaj go bezpośrednio do Internetu.
Jakie dane pobiera Web Master
| Żądanie GET | Format | Zastosowanie |
|---|---|---|
/data/systeminfo.php |
JSON | Stan systemu, liczniki, schemat danych |
/lumlist.php |
TSV, 10 kolumn | Inwentaryzacja i statusy opraw |
/data/errorcodes.php |
JSON | Słownik opisów błędów |
/data/luminaire.php?id=196618 |
JSON | Diagnostyka jednej oprawy, w tym NVG |
Pełne przykłady i obsługę HTTP znajdziesz w API — odczyt danych.
Identyfikacja urządzeń
ID oprawy wylicza się jako kanał × 65536 + adres fizyczny. Kanały: 1 = BUS1, 2 = BUS2, 3 = AirBus. Fizyczny adres 10 daje odpowiednio 65546, 131082 i 196618. Pole adresse zapisuj w całości; nie ograniczaj go do 16 bitów.
Po przejściu ze starszej integracji używającej samych adresów fizycznych wykonaj ponowną synchronizację inwentarza. Usuń stare rekordy zgodnie z procedurą Web Mastera, aby uniknąć zdublowanych opraw. Przeniesienie oprawy do innego kanału zmienia jej ID.
Kolumny listy opraw
| Kolumna | Interpretacja |
|---|---|
| adresse | Unikalne ID kanał/adres |
| geraetetyp | AW, PIKTO, KOMBI, NVG lub UNKNOWN |
| gruppe | Numer grupy zapisany w centrali |
| ueberwachung | 1 = nadzorowana, 0 = indywidualnie wyłączona z nadzoru |
| schaltungsart | DS = praca jasna, BS = praca ciemna; może być pusta |
| betriebszeit | LTM_1H / LTM_2H / LTM_3H / LTM_8H; może być pusta |
| letzte_testdauer | Puste, gdy zmierzony czas ostatniego testu jest niedostępny |
| fehlercode | Cztery znaki szesnastkowe |
| ortstext | Opis lokalizacji |
| aktualisiert_am | Puste, gdy czas ostatniej aktualizacji jest niedostępny |
Nie zastępuj pustych pól zerem ani aktualną datą. Ustawiony czas autonomii nie jest pomiarem czasu ostatniego testu. Dla NVG tryb jest podawany tylko wtedy, gdy oba wyjścia mają ten sam tryb; przy utracie komunikacji tryb i autonomia pozostają puste.
Sprawdzenie przed odbiorem
- Liczba i ID opraw zgadzają się z centralą.
- Ten sam adres na BUS1, BUS2 i AirBus tworzy trzy różne rekordy.
- Typ i lokalizacja są rozpoznawane, a kody Fxxx mają czytelne opisy.
- Zasymulowana awaria LED, baterii i komunikacji jest poprawnie prezentowana.
- Brak odpowiedzi HTTP jest pokazywany jako brak aktualnych danych.
- Stany testu, blokady i wyszukiwania są odróżniane od sprawności instalacji.
Lokalny symulator pomaga sprawdzić integrację. Odbiór wymaga próby na rzeczywistej centrali i docelowym Web Masterze. Zobacz programy i materiały do pobrania.