Przegląd
Urządzenia Shelly udostępniają lokalny interfejs webowy, który pozwala sterować i konfigurować urządzenia za pomocą standardowej przeglądarki na komputerze lub urządzeniu mobilnym. Dzięki niemu możesz włączać i wyłączać podłączone urządzenia, ustawiać harmonogramy oraz konfigurować akcje wykonywane po spełnieniu określonych warunków.
Zwróć uwagę, że do korzystania z lokalnego interfejsu webowego nie jest wymagane połączenie z Internetem ani Shelly Cloud — jedynym warunkiem jest, aby Twoja przeglądarka znajdowała się w tej samej sieci Wi‑Fi co urządzenie Shelly.
Dostęp do interfejsu webowego
Aby uzyskać dostęp do interfejsu webowego:
Podłącz urządzenie do sieci Wi‑Fi o nazwie (SSID) w formacie: "DeviceName-XXXXXXXXXX", gdzie 'DeviceName' to nazwa urządzenia, które chcesz podłączyć, a 'XXXXXXXXXX' to unikalna kombinacja liter i cyfr stanowiąca identyfikator urządzenia.
Po nawiązaniu połączenia z punktem dostępowym urządzenia Access Point / AP (sieć Wi‑Fi opisana w kroku 1), dostęp do interfejsu webowego uzyskuje się przez wpisanie uniwersalnego adresu IP dla wszystkich urządzeń Shelly 192.168.33.1 w przeglądarce.
Jesteś teraz w interfejsie webowym swojego urządzenia.
Podłączanie urządzenia do sieci Wi‑Fi
Część ustawień widocznych w interfejsie webowym jest dostępna tylko wtedy, gdy urządzenie jest podłączone do internetu. Aby to zrobić, wykonaj następujące kroki:
W interfejsie webowym przejdź do Settings>Wi-Fi.
Wpisz lub wybierz preferowaną sieć Wi‑Fi, a następnie podaj jej hasło. Alternatywnie możesz połączyć się z siecią otwartą, zaznaczając pole wyboru pozwalające na łączenie się z otwartymi sieciami Wi‑Fi. Dodatkowo zaleca się ustawienie statycznego adresu IP.
Poczekaj kilka sekund, aż urządzenie spróbuje połączyć się z podaną siecią Wi‑Fi. Jeśli wpisane hasło jest nieprawidłowe albo sieć Wi‑Fi ma zbyt słaby lub niestabilny sygnał, w interfejsie webowym pojawi się komunikat informujący o braku połączenia. Po pomyślnym połączeniu z Wi‑Fi powyżej ustawień Wi‑Fi pojawi się link zawierający nowy adres IP. Skopiuj i wklej ten link do przeglądarki.
Jesteś teraz w interfejsie webowym urządzenia połączonego z internetem. Następnym razem, gdy będziesz chciał uzyskać dostęp do interfejsu webowego, wystarczy połączyć się z tą samą siecią Wi‑Fi co urządzenie i wpisać nowy adres IP uzyskany w kroku 3. Zalecane jest ustawienie statycznego adresu IP, ponieważ gwarantuje to stały dostęp pod tym adresem.
Zrozumienie układu
Interfejs webowy można podzielić na cztery główne sekcje — nagłówek, stopkę, główne menu i główną zawartość.
Nagłówek
Nagłówek składa się z dwóch elementów — nazwy urządzenia po lewej oraz kilku ikon po prawej, które pokazują główne funkcje sieciowe i łączności urządzenia. Ikony mogą obejmować funkcje takie jak Wi‑Fi, Bluetooth, MQTT i inne, a także ikonę informującą o dostępności nowych aktualizacji firmware. Najedzenie kursorem myszy na ikonę wyświetli dodatkowe informacje. Legenda z opisem znaczenia każdej ikony znajduje się w przewodniku interfejsu webowego dla każdego urządzenia. Zwróć uwagę, że indywidualne przewodniki opisują tylko funkcje łączności dostępne dla danego modelu urządzenia.
Stopka
Na dole ekranu, od lewej do prawej, znajdują się: nazwa modelu urządzenia, jego ID, wersja interfejsu webowego, wersja firmware urządzenia oraz aktualny czas. Jeśli czas nie jest zsynchronizowany, otrzymasz powiadomienie u góry ekranu, a niektóre harmonogramy i akcje mogą działać nieprawidłowo. W niektórych starszych wersjach interfejsu webowego nie wszystkie te elementy są obecne.
Główne menu
W wersji desktopowej główne menu znajduje się po lewej stronie, natomiast na urządzeniach mobilnych wygląda jak menu hamburgerowe z ikoną trzech poziomych linii. Menu zawiera różne pozycje zależnie od urządzenia, a kliknięcie elementu przenosi na inną stronę. Możesz też wrócić do strony głównej, klikając Home.
Główna zawartość
Klikając element w głównym menu, możesz poruszać się po interfejsie webowym. Wszystko, co widoczne na ekranie z wyłączeniem nagłówka, stopki i głównego menu, stanowi główną zawartość.
*Zwróć uwagę, że nie wszystkie zrzuty ekranu interfejsu webowego wyświetlane na górze każdej strony przewodnika (tam, gdzie zrzut ekranu jest dostępny) przedstawiają najnowszą wersję. W związku z tym mogą wyglądać nieco inaczej niż najnowsza wersja i nie muszą odzwierciedlać wyglądu interfejsu webowego dla każdego urządzenia.
Menu główne
Poniżej znajdują się wyjaśnienia poszczególnych ustawień w głównym menu, w tym tego, co jest wyświetlane jako główna zawartość po kliknięciu różnych ustawień. Krótkie wprowadzenie ikon w nagłówku, specyficzne dla tego urządzenia, znajduje się również w opisie strony Home. Uwaga: nagłówek jest widoczny na wszystkich ekranach, nie tylko na stronie głównej.
Strona główna
W interfejsie webowym w nagłówku zobaczysz sześć ikon, w tym jedną dla AP, Wi‑Fi, Bluetooth, Cloud i połączenia MQTT. Oto co oznaczają różne kolory statusu:
 |
|
 |
|
 |
|
 |
|
 |
|
 |
|
|
|
|
Wyjście i wejście są wyświetlane na stronie Home, a kliknięcie ich ujawni zestaw szczegółowych ustawień opisanych poniżej.
Ustawienia wyjścia
Nazwa
Nazwa/zmień nazwę wyjścia.
Ustawienia wejścia/wyjścia
Wybierz tryb wejścia:
Button - każde naciśnięcie przycisku przełącza stan wyjścia urządzenia.
Switch - pozycja przełącznika odpowiada stanowi wyjścia urządzenia.
Analog (nie jest dostępne we wszystkich urządzeniach) - używając wejścia analogowego urządzenie określa procent jasności na podstawie procentu sygnału wejściowego.
Ustaw typ wyjścia:
Toggle Switch (Switch only) - Urządzenie będzie działać jako przełącznik bistabilny z jednym stanem dla ON i jednym dla OFF. Jeśli wejście jest w trybie Analog, urządzenie będzie podążać za stanem wejścia analogowego.
Momentary Switch (Button only) - Każde naciśnięcie przycisku przełącza stan wyjścia urządzenia. Jeśli Twój przełącznik jest ON, zmieni się na OFF, i odwrotnie.
Edge Switch (Switch only) - Każda zmiana pozycji przełącznika przełącza stan wyjścia urządzenia.
Detached Switch - Wejście zostaje odłączone (separated) od wyjścia i nie wpływa na nie. W praktyce nie będziesz mógł sterować światłem przez to wejście.
Akcja po włączeniu zasilania:
To ustawienie jest zwykle używane podczas awarii zasilania; „power on” odnosi się do momentu przywrócenia zasilania i ponownego włączenia urządzenia.
Turn ON - Po przywróceniu zasilania urządzenie włączy się.
Turn OFF - Po przywróceniu zasilania urządzenie pozostanie wyłączone.
Restore last known state of output/relay - Po przywróceniu zasilania stan wyjścia będzie taki, jaki był ostatnim razem, gdy urządzenie było włączone (przed utratą zasilania).
Current state of the switch (Toggle Switch only) - Podąża za stanem przełącznika, więc jeśli jest ustawiony na ON, urządzenie włączy się, i analogicznie gdy przełącznik jest ustawiony na OFF.
Typ zużycia
To ustawienie ma znaczenie podczas integrowania urządzenia z zewnętrznymi systemami automatyki domowej. Ma na celu określenie informacji lub konfiguracji wymaganej przez zewnętrzny system do komunikacji z urządzeniem.
Jeśli używasz zewnętrznych systemów automatyki domowej do sterowania urządzeniem, zaleca się odwołanie do ich dokumentacji lub instrukcji, aby ustalić, co należy wprowadzić w tym polu. Dokumentacja systemu zewnętrznego zazwyczaj określi wymagane parametry, poświadczenia lub inne szczegóły potrzebne do nawiązania komunikacji między tym systemem a urządzeniem Shelly.
Jeżeli jednak korzystasz z urządzenia wyłącznie z aplikacją Shelly, możesz zignorować pole External consumption type. Aplikacja nie wymaga dodatkowej konfiguracji w tym zakresie, ponieważ ma własne wbudowane mechanizmy komunikacji i sterowania urządzeniem.
Jeśli z jakiegoś powodu chcesz usunąć lub skasować zewnętrzny typ zużycia z ustawień urządzenia, możesz to zrobić, pozostawiając pole External consumption type puste i klikając przycisk Save settings. W ten sposób dezaktywujesz zewnętrzny typ zużycia i przywrócisz domyślne zachowanie urządzenia lub polegasz wyłącznie na aplikacji Shelly do sterowania i automatyzacji.
Ochrony:Overpower in watts - Skonfiguruj przekaźnik Shelly tak, aby wyłączał się, gdy pobór mocy osiągnie określoną wartość. Maksymalna dozwolona wartość mocy równa jest maksymalnemu natężeniu razy maksymalne napięcie.
Overcurrent in amperes - Jeśli prąd zasilania przekroczy określoną wartość, kanał zostanie wyłączony.
Overvoltage in volts - Jeśli napięcie zasilania przekroczy określoną wartość, kanał zostanie wyłączony.
Reset counters
Ustawia wszystkie odczyty wejść na 0.
Akcje
Skonfiguruj akcje dla urządzenia — twórz nowe akcje, edytuj istniejące lub usuwaj je. Tworząc akcje, musisz określić warunek ich uruchomienia. Możesz także ustawić czas trwania akcji oraz URL, który zostanie wywołany, gdy warunek zostanie spełniony.
Harmonogramy
Funkcja ta wymaga działającego połączenia z internetem, aby urządzenie mogło zsynchronizować czas. Umożliwia tworzenie, przeglądanie, edytowanie i usuwanie harmonogramów.
Istnieją dwa typy harmonogramów: Basic oraz Advanced.
Aby utworzyć basic harmonogram:
Wybierz dzień/dni tygodnia.
Wybierz przedział czasu: czas, wschód słońca lub zachód słońca.
-
Ustaw godzinę dla wybranych dni:
Time: Kliknij przycisk góra/dół lub wpisz liczbę, aby ustawić godzinę i minuty.
Sunset/Sunrise: Urządzenie Shelly może automatycznie włączać/wyłączać się (lub wykonać określoną akcję) o wschodzie/zachodzie słońca lub o określonym czasie przed lub po nich. Kliknij przycisk góra/dół lub wpisz liczbę, aby ustawić godziny i minuty.
Aby utworzyć advanced harmonogram:
Funkcja zaawansowanego harmonogramu używa cron do wykonywania zadań za pomocą jednego wpisu harmonogramu zamiast kilku podstawowych.
Tworzenie zaawansowanego harmonogramu różni się od tworzenia podstawowego ze względu na menu When to execute.
Pozwala ono wybrać jedną lub wiele wartości, zakres wartości lub krok między wartościami (Wybierz jedną z trzech opcji klikając Select, Range lub Step przycisk dla każdej wartości) dla:
Seconds (0-59)
Minutes (0-59)
Hours (0-23)
Days (1-31)
Months (JAN-DEC)
Weekdays (SUN-SAT)
Aby utworzyć harmonogram występujący co sekundę/minutę/godzinę/dzień/miesiąc/dzień tygodnia, po prostu zaznacz pole poniżej wartości w odpowiedniej sekcji (seconds, minutes, hours, days, months lub weekdays). Dodatkowo możesz użyć przesunięcia względem wschodu/zachodu słońca, zaznaczając pole obok tej opcji. Spowoduje to wyświetlenie nowego menu z godzinami i minutami. Pozostawienie godzin i minut bez zmian i wybranie wschodu lub zachodu słońca spowoduje wystąpienie harmonogramu dokładnie o wschodzie/zachodzie. Zmiana wartości godzin i minut stworzy przesunięcie, więc wpisanie wartości ujemnej spowoduje wystąpienie harmonogramu [ustawione godziny i/lub minuty] przed wschodem/zachodem, natomiast wpisanie wartości dodatniej — [ustawione godziny i/lub minuty] po wschodzie/zachodzie. Nie można wprowadzić wartości dodatniej dla jednej (godziny/minuty) i ujemnej dla drugiej.
Następnie określ działanie, które urządzenie ma wykonać w sekcji Do what . Kliknij Save aby zapisać nowy harmonogram.
W menu Schedules możesz przeglądać wszystkie harmonogramy. Możesz wyświetlać każdy z nich w trybie podstawowym lub zaawansowanym. Podstawowy tryb pokazuje godzinę i dni, w których harmonogram występuje, podczas gdy zaawansowany pokazuje tekst w karcie harmonogramu informujący, że należy kliknąć dla uzyskania szczegółów.
Oba widoki wyświetlają akcje powyżej. Jeśli jest więcej niż trzy akcje, są wyświetlane jako +n, gdzie n to liczba pozostałych, niewyświetlonych akcji. Aby włączyć/wyłączyć harmonogram, użyj przycisku toggle po prawej.
Timery
Pozwalają automatycznie zarządzać zasilaniem. Możesz użyć:
Auto on: Po wyłączeniu, wyjście przekaźnika zostanie automatycznie włączone po zdefiniowanym okresie czasu (w sekundach).
Auto off: Po włączeniu, wyjście przekaźnika zostanie automatycznie wyłączone po zdefiniowanym okresie czasu (w sekundach).
Ustawienia wejścia
Nazwa
Nazwa/zmień nazwę wejścia.
Enable
Włącz/wyłącz wejście, zaznaczając/odznaczając pole.
Ustawienia wejścia/wyjścia
Wybierz tryb wejścia:
Button - każde naciśnięcie przycisku przełącza stan wyjścia urządzenia.
Switch - pozycja przełącznika odpowiada stanowi wyjścia urządzenia.
Analog (nie jest dostępne we wszystkich urządzeniach) - używając wejścia analogowego urządzenie określa procent jasności na podstawie procentu sygnału wejściowego.
Ustaw typ wyjścia:
Toggle Switch (Switch only) - Urządzenie będzie działać jako przełącznik bistabilny z jednym stanem dla ON i jednym dla OFF. Jeśli wejście jest w trybie Analog, urządzenie będzie podążać za stanem wejścia analogowego.
Momentary Switch (Button only) - Każde naciśnięcie przycisku przełącza stan wyjścia urządzenia. Jeśli Twój przełącznik jest ON, zmieni się na OFF, i odwrotnie.
Edge Switch (Switch only) - Każda zmiana pozycji przełącznika przełącza stan wyjścia urządzenia.
Detached Switch - Wejście zostaje odłączone od wyjścia i nie wpływa na nie. W praktyce nie będziesz mógł sterować światłem przez to wejście.
Akcja po włączeniu zasilania:
To ustawienie jest zwykle używane podczas awarii zasilania; „power on” odnosi się do momentu przywrócenia zasilania i ponownego włączenia urządzenia.
Turn ON - Po przywróceniu zasilania urządzenie włączy się.
Turn OFF - Po przywróceniu zasilania urządzenie pozostanie wyłączone.
Restore last known state of output/relay - Po przywróceniu zasilania stan wyjścia będzie taki, jaki był ostatnim razem, gdy urządzenie było włączone (przed utratą zasilania).
Current state of the switch (Toggle Switch only) - Podąża za stanem przełącznika, więc jeśli jest ustawiony na ON, urządzenie włączy się, i analogicznie gdy przełącznik jest ustawiony na OFF.
Invert
To ustawienie pozwala odwrócić logikę sygnału wejściowego, skutecznie zmieniając zachowanie urządzenia na odwrotne. Domyślnie, gdy sygnał wejściowy jest ON, urządzenie włącza się. Gdy sygnał wejściowy jest OFF, urządzenie wyłącza się.
Jeśli jednak włączysz ustawienie "Invert Input", zdarzy się odwrotnie: gdy sygnał wejściowy jest ON, urządzenie wyłączy się, a gdy sygnał wejściowy jest OFF, urządzenie włączy się. To ustawienie może być przydatne, gdy konieczne jest odwrócenie zachowania urządzenia.
Reset fabryczny
Włączenie tego ustawienia pozwoli na przywrócenie urządzenia do ustawień fabrycznych z poziomu wejścia, nie tylko przez aplikację lub interfejs webowy.
Ustawienia
Ustawienia sieciowe
Access Point - Skonfiguruj AP urządzenia, w tym włączanie/wyłączanie (przy użyciu przełącznika) oraz ustawienie hasła. Punkt dostępowy urządzenia jest domyślnie siecią otwartą. SSID jest unikalny i nie może zostać zmieniony.
-
Wi‑Fi - Zarejestruj urządzenie Shelly, aby łączyło się z maksymalnie 2 różnymi sieciami Wi‑Fi.
Wpisz (ręcznie w polu tekstowym) lub wybierz sieć Wi‑Fi klikając ikonę strzałki, aby przeglądać dostępne sieci. Można wybrać sieć otwartą i ustawić statyczny adres IP.
Włącz Wi‑Fi 1, lub Wi‑Fi 2, lub oba jednocześnie (przy użyciu przełącznika obok każdego z nich). Jeśli Wi‑Fi 1 i Wi‑Fi 2 są włączone i urządzenie Shelly rozłączy się z jedną siecią, połączy się z drugą. Możliwe jest włączenie Wi‑Fi dopiero po ustawieniu nazwy sieci (SSID). Jeśli urządzenie nie ma innych dostępnych połączeń (AP, Bluetooth, Ethernet (jeśli dotyczy), lub drugiej sieci Wi‑Fi), próba wyłączenia Wi‑Fi spowoduje wyświetlenie okienka z pytaniem, czy chcesz kontynuować.
Bluetooth - Wyłącz/włącz Bluetooth przełącznikiem. Domyślne ustawienie Bluetooth w urządzeniu jest włączone.
Łączność
Uwaga dotycząca komunikacji RPC: Gdy wywołanie RPC nie zostanie wykonane, pojawia się baner informujący, że urządzenie nie odpowiada w czasie i utraciło połączenie. Po przywróceniu połączenia żądanie zostanie wysłane ponownie.
Cloud - Podłączenie Shelly do chmury umożliwia zdalne sterowanie oraz odbieranie powiadomień i aktualizacji dotyczących urządzeń. Domyślnie chmura jest włączona. Jeśli wyłączysz obsługę chmury, stracisz możliwość połączenia z urządzeniem spoza jego lokalnej sieci!
MQTT - Skonfiguruj urządzenie Shelly do wykonywania akcji przez MQTT. Domyślnie MQTT jest wyłączone, ale możesz je włączyć przełącznikiem. Zmiana tych ustawień spowoduje restart urządzenia. Dostępne są także inne ustawienia, takie jak RPC status notifications over MQTT (umożliwiające komunikację z urządzeniem poprzez powiadomienia RPC) oraz Generic status update over MQTT (dla ogólnej aktualizacji stanu), które możesz włączać/wyłączać przełącznikami po prawej. Możesz także włączyć SSL i wpisać adres serwera, nazwę użytkownika i hasło, ale pamiętaj, że włączenie SSL skróci żywotność baterii i najprawdopodobniej zmniejszy ją o połowę.
Outbound Websocket - Określa, czy kanał HTTP generuje wyjątek I/O, gdy połączenie przychodzące zostanie zamknięte podczas gdy servlet nadal z niego korzysta. Domyślnie to ustawienie jest wyłączone. Aby je włączyć, kliknij przełącznik obok Enable. Wpisz adres usługi w polu tekstowym, a z rozwijanego menu pod SSL Connectivity wybierz *, ca.pem lub user_ca.pem.
Range extender - Włączenie funkcji Range extender tworzy hotspot, do którego możesz podłączać urządzenia Wi‑Fi. Jeśli urządzenie Shelly z włączonym range extenderem jest połączone z routerem Wi‑Fi i Internetem, wszystkie urządzenia do niego podłączone również będą połączone z routerem i Internetem.
Nawet jeśli urządzenie Shelly nie jest połączone z routerem Wi‑Fi, wszystkie podłączone do niego urządzenia mogą nadal komunikować się z nim i między sobą. Poniżej znajduje się informacja o klientach AP — ile ich jest oraz ich konfiguracja IP, adres MAC oraz wewnętrzne i zewnętrzne adresy IP.
-
RPC over UDP - Komunikuj się z urządzeniem i wysyłaj żądania przez Remote Procedure Call (RPC) za pomocą serwera User Datagram Protocol (UDP). Może to być przydatne do zdalnego sterowania i monitorowania urządzenia bez potrzeby dedykowanego serwera lub stałego połączenia.
Aby korzystać z tego ustawienia, musisz wpisać port nasłuchiwania i adres docelowy serwera UDP. Port nasłuchiwania to numer portu, na którym urządzenie będzie nasłuchiwać przychodzących żądań, natomiast adres docelowy to adres IP serwera, do którego będą wysyłane żądania.
Po wprowadzeniu wymaganych informacji możesz używać protokołu RPC over UDP do wysyłania żądań do urządzenia i odbierania odpowiedzi.
Ustawienia urządzenia
Nazwa urządzenia (info) - Zobacz ID urządzenia, sieć Wi‑Fi, z którą jest połączone, oraz Wi‑Fi RSSI.
Reboot - Po kliknięciu przycisku Reboot zostaniesz zapytany, czy na pewno chcesz zrestartować urządzenie. Kliknij OK aby zrestartować urządzenie i Cancel jeśli nie chcesz restartu.
Factory reset - Kliknięcie przycisku Reset spowoduje przywrócenie ustawień urządzenia do wartości fabrycznych. Wszystkie dokonane zmiany zostaną cofnięte. Możesz potwierdzić reset klikając OK w okienku, lub Cancel aby anulować reset.
Location and timezone - Twoja strefa czasowa i lokalizacja zostaną wykryte automatycznie, ale możesz je zmienić ręcznie, wybierając strefę czasową z rozwijanego menu oraz wpisując szerokość i długość geograficzną. Jest też przycisk Auto detect location, który ponownie umożliwi automatyczne wykrycie lokalizacji, jeśli poprzednia próba się nie powiodła.
Jeśli czas urządzenia nie jest zsynchronizowany z aktualnym czasem, harmonogramy i akcje mogą działać nieprawidłowo. Pojawi się komunikat informujący o braku synchronizacji czasu.
Authentication - Jeśli włączysz uwierzytelnianie, zostaniesz poproszony o wpisanie hasła, którego będziesz używać do dostępu do interfejsu webowego urządzenia. Po włączeniu, aby je wyłączyć, kliknij przełącznik i wprowadź hasło, gdy zostaniesz o to poproszony.
Firmware - W tym ustawieniu możesz zobaczyć ID urządzenia, wersję firmware, build ID oraz web build ID. Użyj przycisku Copy nad ID firmware lub web build ID, aby skopiować zawartość do schowka. Możesz także zobaczyć dostępne nowe wersje, sprawdzić aktualizacje i łatwo zaktualizować urządzenie. Jest też opcja przesłania własnego firmware, jednak wgrywanie niestandardowego firmware nieodwracalnie pozbawia urządzenie gwarancji.
User certificate (TLS Configuration) - Prześlij niestandardowy urząd certyfikatu, certyfikat klienta i klucz klienta przez przeciągnięcie i upuszczenie plików lub przeglądanie plików klikając odpowiedni przycisk. Kliknij Upload aby przesłać pliki i Clear aby usunąć pliki, których nie chcesz przesyłać.
Eco mode - Zmniejsz zużycie energii przez obniżenie częstotliwości CPU i aktywności modemu w trybie Eco. Aby włączyć to ustawienie, przestaw przełącznik obok Enable eco mode i kliknij przycisk Apply aby zapisać zmiany.
Debug - To ustawienie obejmuje debug Mqtt, Websocket i Udp. Aby włączyć którykolwiek z nich, przestaw przełącznik obok konkretnego ustawienia. Dla Udp debug zostaniesz również poproszony o wpisanie Udp address.
Scripts
To urządzenie posiada możliwości skryptowania. Możesz ich używać do dostosowania i rozszerzenia funkcjonalności urządzenia zgodnie z potrzebami użytkownika. Skrypty mogą uwzględniać stan urządzenia, komunikować się z innymi urządzeniami lub pobierać dane z zewnętrznych serwisów, np. prognoz pogody. Skrypt to program napisany w podzbiorze JavaScript.
W interfejsie webowym, przechodząc do menu Scripts, zobaczysz istniejące skrypty, lub jeśli nie masz żadnych — możesz stworzyć nowy albo otworzyć bibliotekę, aby sprawdzić dostępne skrypty. Obok każdego skryptu zobaczysz jego status (uruchomiony lub zatrzymany) oraz przełącznik pozwalający uruchomić skrypt przy starcie. Jeśli skrypt ma błędy, ostatni zapisany błąd zostanie wyświetlony pod nazwą skryptu.
W widoku edycji skryptu zobaczysz konsolę poniżej oraz wszelkie pojawiające się błędy. Nad polem z kodem znajdują się opcje Save, Start/Stop, oraz Delete skryptu. Możesz także uzyskać dostęp do Snippets i Docs klikając odpowiednie etykiety.
Komponenty
Tworzenie komponentu
Ustawienie Components pozwala użytkownikowi tworzyć Dynamic Components, które początkowo nie istnieją w urządzeniu. Komponenty wirtualne, typ dynamicznego komponentu, służą do przechowywania lub przesyłania danych między skryptami lub uruchomieniami oraz do wyświetlania funkcji skryptu na stronie głównej. Komponenty mogą być grupowane; tylko grupy i komponenty w ich obrębie będą wyświetlane na stronie głównej. Komponenty nieprzynależne do grupy nie będą wizualizowane tam. Liczba komponentów i grup komponentów na urządzenie jest ograniczona.
Aby utworzyć komponent:
Kliknij przycisk Create new obok User-defined components.
Wybierz typ komponentu, który chcesz utworzyć — Boolean, Number, Text, Enum lub Button. Po utworzeniu każdy typ komponentu ma pola Name, View i Custom Icon URL które należy wypełnić. Pole Custom Icon URL nie jest wymagane, ale może służyć do dostosowania wyglądu komponentów na stronie głównej. Możesz zmienić nazwę lub usunąć komponent oraz tworzyć dla niego akcje, używając przycisków obok każdego komponentu.
Różne typy komponentów mogą mieć dodatkowe pola specyficzne dla ich typu. Są one opisane poniżej
Typ komponentu Boolean przechowuje wartość true/false i ma dwa różne tytuły, które użytkownik może wpisać w zależności od tego, czy wartość jest prawdziwa, czy fałszywa, a także dwie oddzielne ikony. Menu rozwijane dla wartości domyślnej będzie zawierać różne stany Twojego urządzenia. Opcje widoku to Hidden, Toggle i Label. Widok Toggle wyświetla przycisk przełączający, więc wartość komponentu zmienia się przy każdym użyciu. Widok Label pokazuje tytuł odpowiadający wartości komponentu.
Typ komponentu Number przechowuje wartości między -999999999999999 a 999999999999999. Wartość domyślna powinna mieścić się w tym zakresie. Możesz także zmienić jednostkę i krok. Opcje widoku to Hidden, Field, Slider, Progress bar i Label. Widok Field pokazuje pole wejściowe, widok Label wyświetla wartość, widok Progress bar wizualnie przedstawia postęp, a widok Slider wyświetla suwak do interakcji.
Typ komponentu Text przechowuje łańcuch o długości do 255 znaków. Opcje widoku to Hidden, Field, Label i Image. Widok Field pokazuje pole wejściowe, widok Label wyświetla tytuł, a widok Image wymaga wartości URL, której używa do wyświetlenia obrazu.
Typ komponentu Enum przechowuje grupę nazwanych stałych. Opcje widoku to Hidden, Dropdown, i Label. Jeśli wybierzesz widok Label, komponent domyślnie wyświetli tytuł, ale jeśli zostanie określony obraz, on będzie miał priorytet i zostanie pokazany.
Typ komponentu Button zapewnia symulowane wirtualne wejście, które pozwala użytkownikom wchodzić w interakcję z interfejsem poprzez rejestrowanie kliknięć. Wysyła powiadomienia przez podłączone kanały i może być używany do uruchamiania automatyzacji oraz aktywowania webhooków. Ma dwie opcje widoku — Button, który wyświetla komponent jako przycisk na stronie głównej, oraz Hidden.
Jeśli komponent ma ustawiony widok Hidden nie będzie wyświetlany na stronie głównej. W przeciwnym razie grupy komponentów pojawią się poniżej wejść i/lub wyjść urządzenia i pokażą należące do nich komponenty.
Tworzenie grupy komponentów
Aby utworzyć grupę:
Kliknij + obok User-defined groups, a przejdziesz do menu tworzenia grupy.
Wprowadź nazwę grupy.
Wybierz pożądane komponenty, które chcesz umieścić w tej grupie.
Edycja menu grup odbywa się przez ikonę ołówka obok + i pozwala zmieniać kolejność grup, używając strzałek do góry i w dół, aby przesuwać grupy.
Akcje komponentów
Menu Akcje jest teraz zorganizowane według typu komponentu. Możesz tworzyć akcje dla komponentów i będą one pogrupowane w wymienione pięć kategorii.
Skryptowanie
Komponenty mogą być używane w skryptach i programowane tak, aby zmieniały wartości w zależności od warunku. Aby odwołać się do komponentu w skrypcie, musisz użyć jego ID. ID komponentów zaczynają się od 200 i są ograniczone do 299. Identyfikator komponentu zobaczysz w menu Components.
Komponenty BTHome
Komponenty BTHome pozwalają tworzyć wirtualne/dynamiczne komponenty powiązane z rzeczywistymi urządzeniami wysyłającymi pakiety BTHome, takimi jak urządzenia Shelly BLU. Aby używać komponentów BTHome, najpierw trzeba nawiązać poprawne połączenie Bluetooth. Pojawi się komunikat informujący, czy obserwator Bluetooth jest wyłączony, oraz przycisk do jego włączenia i restartu urządzenia.
Po nawiązaniu połączenia, aby dodać urządzenie BTHome (Bluetooth), kliknij znak + obok BTHome components. Urządzenie przeskanuje dostępne urządzenia Bluetooth, ale możesz kliknąć przycisk Scan aby zeskanować ponownie. Znalezione urządzenia pojawią się pod tym przyciskiem. Aby urządzenie zostało znalezione podczas skanu, musi być w trybie pairing mode, który osiąga się przytrzymując przycisk urządzenia. Inną opcją dodania urządzenia jest użycie adresu MAC. Aby to zrobić, kliknij Add device by MAC address i wpisz adres MAC urządzenia, które chcesz dodać.
Aby dodać czujniki, kliknij Configure obok wybranego urządzenia Bluetooth. Na tym ekranie możesz nadać nazwę urządzeniu BTHome, dodać klucz szyfrowania oraz wpisać Custom Icon URL aby spersonalizować wygląd komponentu BTHome na stronie głównej. Klucz szyfrowania służy do odszyfrowywania pakietów i można go uzyskać za pomocą aplikacji Shelly BLU Debug .
Poniżej pola klucza szyfrowania znajdują się obsługiwane czujniki, które możesz dodać, klikając znak + obok tych, które chcesz dodać. Po dodaniu obok czujnika pojawi się ikona ołówka, pozwalająca edytować jego nazwę, dodać Custom Icon URL lub użyć ikony kosza, aby usunąć czujnik.
Aby zapisać komponent BTHome, kliknij Save settings. Aby usunąć komponent, kliknij ikonę kosza nad polami tekstowymi.
Aby edytować komponent BTHome, kliknij ikonę koła zębatego. Zostaniesz przeniesiony do jego ustawień, które są tym samym ekranem, który widzisz podczas dodawania komponentu.
KNX
KNX jest znormalizowanym protokołem komunikacyjnym dla automatyki budynkowej. Służy do sterowania i zarządzania różnymi aspektami systemów budynku, w tym oświetleniem, ogrzewaniem, wentylacją, bezpieczeństwem, zarządzaniem energią i innymi. KNX pozwala różnym urządzeniom i systemom od różnych producentów komunikować się ze sobą przez wspólną sieć.
Ogólne
Aby używać KNX, kliknij pole wyboru obok Enable. Następnie wpisz unikalny adres indywidualny dla Twojego urządzenia w sieci KNX.
W Multicast settings wpisz adres IP (oznaczony jako Address) grupy multicast, w której chcesz, aby urządzenie komunikowało się. Adresy mieszczą się w zakresie od 224.0.0.0 do 239.255.255.255. Ustawienie Port określa numer portu tej grupy multicast, na którym odbywa się komunikacja. Razem definiują cel wiadomości multicast w sieci.
Wejścia
W zależności od urządzenia w tym menu będzie dostępna różna liczba wejść. Dla każdego wejścia wybierz Input state, który może być Switch, Button, lub specjalnie dla urządzeń ściemniających - Single-button dimming lub Dual-button dimming.
Poniżej, w zależności od wcześniej wybranego stanu wejścia, zobaczysz jeden lub więcej obiektów oraz tekst po prawej stronie obiektu identyfikujący jego rozmiar i typ danych. Dla różnych trybów wejść są to:
Switch - Ma jeden obiekt zwany Switch object, o rozmiarze 1-bit i DPT (Data Point Type) 1.001, co oznacza typ przełącznika z dwoma stanami — włącz/wyłącz (1/0). Możesz dodać do trzech obiektów Switch używając przycisku Add .
Button - Najpierw wybierz funkcję przycisku — ON, OFF lub Toggle. Stan wejścia Button ma dwa obiekty — Single-push oraz Feedback. Możesz dodać do trzech obiektów Single-push za pomocą przycisku Add i jeden obiekt Feedback. Oba są typu Switch, o rozmiarze 1-bit i DPT 1.001, co oznacza przełącznik z dwoma stanami — włącz/wyłącz (1/0). Obiekt Feedback może być tym samym co Single-push lub można wpisać inny adres, odznaczając ustawienie Same as Single-push object i wpisując nowy adres.
Single-button dimming - Najpierw wybierz krok ściemniania, w zakresie od full dimming do 1/64 dimming. Zmienia to prędkość ściemniania. Pełne ściemnianie będzie najszybsze, ponieważ ściemni od 0 do 100% z ustawioną prędkością, natomiast 1/64 ściemniania będzie ściemniać 1/64 pełnego zakresu w tym samym czasie. Ten tryb wejścia ma trzy obiekty — Single-push, Long-push i Feedback. Możesz dodać do trzech obiektów Single-push i Long-push używając przycisku Add , i jeden obiekt Feedback, który może być tym samym co Single-push lub można wpisać inny adres, odznaczając Same as Single-push object i wpisując nowy adres. Obiekty Single-push i Feedback są typu Switch, o rozmiarze 1-bit i DPT 1.001 (włącz/wyłącz). Obiekt Long-push służy do sterowania ściemnianiem, ma rozmiar 4-bit i DPT 3.007. Obiekt Control Dimming składa się z dwóch wartości — jednej wskazującej zwiększenie (1) lub zmniejszenie (0) oraz jednej odpowiadającej krokowi.
Dual-button dimming - Najpierw wybierz krok ściemniania w zakresie od full dimming do 1/64 dimming. Zmienia to prędkość ściemniania. Następnie wybierz kierunek ściemniania — w górę/włącz lub w dół/wyłącz. Ten stan wejścia ma dwa obiekty — Single-push i Long-push. Możesz dodać do trzech obiektów Single-push i Long-push używając przycisku Add . Obiekt Single-push jest typu Switch, o rozmiarze 1-bit i DPT 1.001 (włącz/wyłącz). Obiekt Long-push jest do sterowania ściemnianiem, ma rozmiar 4-bit i DPT 3.007. Obiekt Control Dimming składa się z dwóch wartości — jednej wskazującej zwiększenie (1) lub zmniejszenie (0) oraz jednej odpowiadającej krokowi.
Wyjścia
Menu wyjść jest podzielone na trzy sekcje — Commands, Feedbacks i Measurements. Dla każdego typu obiektu w Commands możesz mieć do pięciu obiektów. Oto typy obiektów w każdej sekcji:
Commands:
Switch object - Ma rozmiar 1-bit i DPT 1.001, co oznacza typ przełącznika z dwoma stanami — włącz/wyłącz (1/0).
Feedbacks:
Feedback object - Ma rozmiar 1-bit i DPT 1.001, co oznacza przełącznik z dwoma stanami — włącz/wyłącz (1/0). Obiekt Feedback służy do raportowania stanu urządzenia.
Measurements (Te typy obiektów mają rozmiar 4‑byte):
Voltage object - Ma DPT 14.027, co oznacza obiekt Electric potential typu Double z trzema wartościami.
Current object - Ma DPT 14.019, co oznacza obiekt Electric current typu Double z trzema wartościami.
Active power object - Ma DPT 14.056, co oznacza obiekt Power typu Double z trzema wartościami.
Active energy object - Ma DPT 13.010, co oznacza obiekt Active energy typu long, mierzony w watogodzinach.
W zależności od urządzenia możesz mieć dodatkowe typy obiektów w sekcjach, takie jak:
Commands:
Relative dimming object - Ma rozmiar 4-bit i DPT 3.007, co oznacza obiekt Control Dimming składający się z dwóch wartości — jednej wskazującej zwiększenie (1) lub zmniejszenie (0) oraz jednej odpowiadającej krokowi.
Absolute dimming object - Ma rozmiar 1 bajta i DPT 5.001, co oznacza obiekt Scaling zawierający wartość od 1 do 100 reprezentującą procent.
Measurements (Te typy obiektów mają rozmiar 4‑byte):
Generated energy object - Ma DPT 13.010, co oznacza obiekt Active energy typu long, mierzony w watogodzinach.
Ustawienia zaawansowane
Po kliknięciu strzałki obok tego ustawienia rozwinięte zostaną ustawienia zaawansowane. Są one opisane poniżej.
KVS
KVS oznacza Key-Value Storage i jest rodzajem bazy danych nierelacyjnej, która przechowuje dane metodą klucz-wartość. W jednym urządzeniu można przechować do 50 par klucz-wartość. Po kliknięciu przycisku Add value zostaniesz przeniesiony do ekranu tworzenia wartości, gdzie zostaniesz poproszony o wpisanie klucza (do 42 znaków) i wartości (do 253 znaków). Pod polem wartości zobaczysz aktualny typ wartości. Domyślnie typ wartości to Number, ale wpisując tekst typ zmieni się na String. Aby zapisać klucz, kliknij przycisk Save. Aby edytować istniejącą wartość, kliknij ją. Aby usunąć parę klucz‑wartość, kliknij przycisk Delete który pojawi się poniżej podczas edycji klucza. Kliknięcie znaku zapytania obok nazwy ustawienia przeniesie Cię do dokumentacji API, która zawiera dalsze informacje o tym, jak działa KVS w urządzeniach Shelly.
Diagnostyka
Z tego ustawienia możesz pobrać logi debugowania. Włączenie logowania debug bez uzasadnionej potrzeby nie jest zalecane, ponieważ spowolni urządzenie i powoduje zużycie pamięci flash. Jeśli mimo to włączysz logi, możesz pobrać poprzednie i bieżące logi. Uwaga: opuszczenie tej strony zresetuje logger i dane logów.
HTTP ping
Wpisz URL w wyznaczonym polu tekstowym, aby urządzenie wysłało do niego żądanie HTTP. Interfejs webowy poinformuje, czy żądanie zakończyło się sukcesem, czy niepowodzeniem.
Klienci urządzenia
Zobacz urządzenia podłączone do Twojego urządzenia i posortowane w odpowiednie kategorie. Dla większości urządzeń dostępne są dwie opcje:
Bluetooth clients - urządzenia podłączone do Twojego urządzenia przez Bluetooth.
AP clients - urządzenia podłączone do punktu dostępowego (Access Point) Twojego urządzenia.
W tym menu będziesz mógł zobaczyć informacje o klientach.