Przegląd
Urządzenia Shelly udostępniają lokalny interfejs webowy, który pozwala kontrolować i konfigurować urządzenia za pomocą standardowej przeglądarki na komputerze lub urządzeniu mobilnym. Dzięki niemu możesz włączać lub wyłączać podłączone urządzenia, ustawiać harmonogramy oraz konfigurować akcje do wykonania, gdy spełnione zostaną określone warunki.
Zauważ, że do korzystania z lokalnego interfejsu webowego nie potrzebujesz połączenia z internetem ani Shelly Cloud — jedynym wymaganiem jest, aby Twoja przeglądarka znajdowała się w tej samej sieci Wi‑Fi co Twoje 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 połączyć, a 'XXXXXXXXXX' to unikalna kombinacja liter i cyfr stanowiąca identyfikator urządzenia.
Po nawiązaniu połączenia z trybem Access Point / AP (sieć Wi‑Fi wspomniana w kroku 1), dostęp do interfejsu webowego uzyskuje się, wpisując uniwersalny adres IP dla wszystkich urządzeń Shelly 192.168.33.1 w swojej przeglądarce.
Jesteś teraz w interfejsie webowym swojego urządzenia.
Łączenie urządzenia z siecią Wi‑Fi
Niektóre ustawienia widoczne w interfejsie webowym są dostępne tylko wtedy, gdy urządzenie jest połączone z internetem. 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 wprowadź jej hasło. Alternatywnie możesz połączyć się z siecią otwartą, zaznaczając pole wyboru umożliwiające łączenie z otwartymi sieciami Wi‑Fi. Dodatkowo zaleca się ustawienie statycznego adresu IP.
Poczekaj kilka sekund, aby urządzenie spróbowało połączyć się z podaną siecią Wi‑Fi. Jeśli wprowadzone hasło jest nieprawidłowe lub sieć Wi‑Fi ma zbyt słaby lub niestabilny sygnał, w interfejsie webowym pojawi się komunikat informujący, że nie udało się nawiązać połączenia. Po pomyślnym połączeniu z Wi‑Fi pojawi się link zawierający nowy adres IP jako tekst powyżej ustawień Wi‑Fi. Skopiuj i wklej ten link do przeglądarki.
Jesteś teraz w interfejsie webowym urządzenia podłączonego do internetu. Następnym razem, gdy będziesz chciał uzyskać dostęp do interfejsu webowego, po prostu połącz się z tą samą siecią Wi‑Fi co urządzenie i wpisz nowy adres IP uzyskany w kroku 3. Zalecane jest ustawienie statycznego adresu IP, ponieważ zapewnia 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 te mogą obejmować funkcje takie jak Wi‑Fi, Bluetooth, MQTT i inne, a także ikonę informującą o dostępnych aktualizacjach firmware. Najedzenie kursorem myszy na ikonę wyświetli dodatkowe informacje. Legendę z opisem każdej ikony znajdziesz w przewodniku interfejsu webowego dla danego urządzenia. Pamiętaj, że poszczególne przewodniki opisują tylko funkcje łączności dostępne dla konkretnego 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. Niektóre wcześniejsze wersje interfejsu webowego nie zawierały wszystkich tych elementów.
Główne menu
W wersji desktopowej główne menu znajduje się po lewej stronie, natomiast na urządzeniu mobilnym wygląda jak menu hamburgerowe z ikoną trzech poziomych linii. Menu zawiera różne pozycje, w zależności od urządzenia, a kliknięcie elementu przenosi do innej strony. Możesz też za jego pomocą 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 widzisz na ekranie z wyłączeniem nagłówka, stopki i głównego menu, jest uważane za główną zawartość.
*Uwaga: nie wszystkie zrzuty ekranu interfejsu webowego wyświetlane u góry każdej strony przewodnika (tam, gdzie znajduje się zrzut) przedstawiają najnowszą wersję. Mogą więc wyglądać nieco inaczej niż aktualna wersja i niekoniecznie odzwierciedlają wygląd interfejsu dla każdego urządzenia.
Menu główne
Poniżej znajdują się wyjaśnienia każdej opcji 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. Pamiętaj, że nagłówek jest obecny na wszystkich ekranach, nie tylko na stronie Home.
Strona główna
W interfejsie webowym zobaczysz pięć ikon w nagłówku, w tym ikony dla AP, Wi‑Fi, Bluetooth, Cloud i połączenia MQTT. Oto, co oznaczają różne kolory statusu:
 |
|
 |
|
 |
|
 |
|
 |
|
 |
|
|
|
|
Zobaczysz przycisk przełącznika, który może włączać lub wyłączać urządzenie. Jest on oznaczony jako output, ale możesz zmienić jego nazwę w ustawieniach.
Poniżej znajdują się dwie sekcje — Last triggered by i Over Protections. W pierwszej zobaczysz akcję wykonywaną po włączeniu zasilania urządzenia, a w drugiej zobaczysz aktualne zabezpieczenia przeciążeniowe i ich wartości. Klikając jedną z nich możesz łatwo zmienić je bezpośrednio z tego menu lub w odpowiednich ustawieniach, opisanych poniżej wraz z pozostałymi ustawieniami.
Ustawienia wyjścia
Nazwa
Nazwa/zmiana nazwy wyjścia.
Akcja przy włączeniu zasilania
Ustaw akcję, którą urządzenie ma wykonać po włączeniu zasilania. Możesz wyłączyć to ustawienie lub wybrać Restore last aby przywrócić ostatnią wykonaną akcję. Dodatkowo możesz wybrać Match Input, które steruje urządzeniem zgodnie ze stanem przełącznika lub przycisku do niego podłączonego.
Typ urządzenia
Wybierz typ urządzenia, do którego podłączone jest Twoje urządzenie, z listy zawierającej General, Relay, Lights, Socket, Heating, oraz Entertainment.
Zabezpieczenia
Maksymalna moc (w watach) - Skonfiguruj przekaźnik Shelly tak, aby wyłączał się, gdy zużycie mocy osiągnie określoną wartość. Maksymalna dozwolona wartość mocy jest równa maksymalnemu prądowi razy maksymalne napięcie.
Przepięcie (w woltach) - Jeśli napięcie zasilania przekroczy określoną wartość, kanał zostanie wyłączony.
Przeciążenie prądowe (w amperach) - Jeśli prąd zasilania przekroczy określoną wartość, kanał zostanie wyłączony.
Akcje
Skonfiguruj akcje dla swojego urządzenia — utwórz nowe akcje, edytuj istniejące lub usuwaj akcje. Podczas tworzenia akcji musisz określić warunek, przy którym akcja zostanie wykonana. Możesz także ustawić czas trwania akcji oraz URL, który zostanie wywołany, gdy warunek akcji zostanie spełniony.
Harmonogramy
Ta funkcja 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.
Są dwa rodzaje harmonogramów: Basic i Advanced.
Aby utworzyć harmonogram basic:
Wybierz dzień/dni tygodnia.
Wybierz typ przedziału czasowego: time, sunrise lub sunset.
-
Ustaw czas dla wybranych dni:
Czas: Kliknij przycisk góra/dół lub wpisz liczbę, aby ustawić godzinę i minuty.
Sunset/Sunrise: Urządzenie Shelly może włączać/wyłączać się (lub wykonać określoną akcję) automatycznie o wschodzie/zachodzie słońca lub o określonym czasie przed lub po wschodzie/zachodzie słońca. Kliknij przycisk góra/dół lub wpisz liczbę, aby ustawić godzinę i minuty.
Aby utworzyć harmonogram advanced:
Funkcja zaawansowanego harmonogramu używa cron do wykonywania zadań jednym harmonogramem zamiast korzystać z kilku podstawowych harmonogramów.
Tworzenie zaawansowanego harmonogramu różni się od tworzenia podstawowego ze względu na menu When to execute.
Prosi ono o wybranie jednej lub wielu wartości, zakresu wartości lub kroku między wartościami (wybierz jedną z trzech, klikając przycisk Select, Range lub Step 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 wykonywany co sekundę/minutę/godzinę/dzień/miesiąc/dzień tygodnia, po prostu zaznacz pole pod wartościami 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 i wybranie sunrise lub sunset sprawi, że harmonogram wystąpi dokładnie o wschodzie lub zachodzie słońca. Zmiana wartości godzin i minut utworzy przesunięcie — wprowadzenie wartości ujemnych spowoduje wykonanie harmonogramu [ustawione godziny i/lub minuty] przed wschodem/zachodem słońca, natomiast wartości dodatnie spowodują wykonanie harmonogramu [ustawione godziny i/lub minuty] po wschodzie/zachodzie słońca. Nie można wprowadzić wartości dodatniej dla jednego (godziny/minuty) i ujemnej dla drugiego.
Następnie określ, jaką akcję ma wykonać urządzenie w sekcji Do what . Kliknij Save po zakończeniu, aby zapisać nowy harmonogram.
W menu Harmonogramy możesz przeglądać wszystkie swoje harmonogramy. Możesz wybrać ich wyświetlanie w trybie podstawowym lub zaawansowanym. Widok podstawowy pokazuje godzinę i dni, w których harmonogram występuje, natomiast widok zaawansowany wyświetla tekst w karcie Harmonogram, informujący, aby kliknąć ją po więcej informacji.
Oba widoki pokazują akcje powyżej. Jeśli jest więcej niż trzy akcje, wyświetlane są jako +n, gdzie n to liczba niewyświetlonych akcji. Aby włączyć/wyłączyć harmonogram, użyj przycisku przełącznika 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
Ustawienia sieci
Access Point - Skonfiguruj AP urządzenia, w tym włączanie/wyłączanie (za pomocą przełącznika) i ustawianie hasła. Punkt dostępowy urządzenia domyślnie jest siecią otwartą. SSID jest unikalny i nie można go zmienić.
-
Wi‑Fi - Zarejestruj urządzenie Shelly, aby łączyło się z maksymalnie 2 różnymi sieciami Wi‑Fi.
Wpisz (poprzez pole tekstowe) lub wybierz sieć Wi‑Fi, klikając ikonę strzałki (chevron), aby przeglądać wszystkie dostępne sieci. Można wybrać sieć otwartą oraz ustawić statyczny adres IP.
Włącz Wi‑Fi 1, Wi‑Fi 2 lub oba jednocześnie (za pomocą przełącznika obok każdego z nich). Jeśli Wi‑Fi 1 i Wi‑Fi 2 są włączone, a urządzenie Shelly rozłączy się z jednej 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 — informuje, że urządzenie nie odpowiada w czasie i utraciło połączenie. Po przywróceniu połączenia żądanie zostanie wysłane ponownie.
Cloud - Połączenie urządzenia Shelly z chmurą umożliwia sterowanie zdalne oraz otrzymywanie powiadomień i aktualizacji o urządzeniach. Domyślnie chmura jest włączona. Jeśli wyłączysz obsługę chmury dla urządzenia, stracisz dostęp do urządzenia spoza jego lokalnej sieci!
MQTT - Skonfiguruj urządzenie Shelly do wykonywania akcji przez MQTT. Domyślnie MQTT jest wyłączone, ale można je włączyć przełącznikiem. Zmiana tych ustawień spowoduje restart urządzenia. Istnieją inne ustawienia, takie jak RPC status notifications over MQTT (które umożliwiają komunikację z urządzeniem poprzez powiadomienia RPC) oraz Generic status update over MQTT (aby otrzymywać ogólną aktualizację statusu), które możesz włączyć/wyłączyć za pomocą przełączników po prawej. Możesz także włączyć SSL i wpisać swój serwer, nazwę użytkownika oraz hasło, ale pamiętaj, że włączenie SSL pogorszy żywotność baterii i najprawdopodobniej skróci ją nawet o połowę.
Outbound Websocket - Określa, czy kanał HTTP tworzy 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 swojej usługi w polu tekstowym, a z menu rozwijanego 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 repeaterem jest połączone z routerem Wi‑Fi i Internetem, wszystkie urządzenia do niego podłączone również są połączone z routerem i Internetem.
Nawet jeśli urządzenie Shelly nie jest połączone z routerem Wi‑Fi, wszystkie urządzenia do niego podłączone mogą nadal komunikować się z nim i między sobą. Poniżej znajdują się informacje o klientach AP — ile ich jest oraz ich konfiguracja IP, adres MAC oraz wewnętrzne i zewnętrzne adresy IP.
Ustawienia urządzenia
Nazwa urządzenia (info) - Zobacz ID urządzenia, sieć Wi‑Fi, z którą jest połączone, oraz Wi‑Fi RSSI.
Uruchom ponownie - Po kliknięciu Reboot zostaniesz zapytany, czy na pewno chcesz zrestartować urządzenie. Kliknij OK aby zrestartować urządzenie i Cancel jeśli nie chcesz go restartować.
Przywracanie ustawień fabrycznych - Kliknięcie przycisku Reset spowoduje przywrócenie wszystkich ustawień urządzenia do wartości domyślnych. Wprowadzone zmiany zostaną cofnięte. Potwierdź reset fabryczny, klikając OK w wyskakującym okienku, lub Cancel aby anulować reset.
Lokalizacja i strefa czasowa - Twoja strefa czasowa i lokalizacja zostaną wykryte automatycznie, ale możesz je zmienić ręcznie w tym ustawieniu, wybierając strefę czasową z menu rozwijanego i wpisując swoją szerokość i długość geograficzną. Jest też przycisk Auto detect location, który ponownie uruchomi automatyczne wykrywanie lokalizacji, jeśli poprzednie wykrycie się nie powiodło.
Jeśli czas urządzenia nie jest zsynchronizowany z aktualnym czasem, harmonogramy i akcje mogą nie działać prawidłowo. Pojawi się komunikat informujący, że czas nie jest zsynchronizowany.
Uwierzytelnianie - 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 wpisz hasło uwierzytelniające, 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 również opcja wgrania własnego firmware, jednak wgrywanie niestandardowego oprogramowania fabrycznie anuluje gwarancję urządzenia.
Certyfikat użytkownika (Konfiguracja TLS) - Prześlij niestandardowe CA, certyfikat klienta i klucz klienta, przeciągając i upuszczając plik(i) lub przeglądając pliki za pomocą przycisku. Kliknij Upload aby wysłać pliki, oraz Clear aby usunąć pliki, które nie chcesz przesyłać.
Tryb Eco - Zmniejsz zużycie energii przez urządzenie, obniżając częstotliwość CPU i aktywność modemu w Trybie Eco. Aby włączyć to ustawienie, kliknij przełącznik obok Enable eco mode a następnie kliknij przycisk Apply aby zapisać zmiany.
Debug - To ustawienie obejmuje debug Mqtt, Websocket i Udp. Aby włączyć którykolwiek z nich, kliknij przełącznik obok odpowiedniego ustawienia. Dla debugu Udp zostaniesz również poproszony o wpisanie Udp address.
Skrypty
To urządzenie oferuje możliwości skryptowania. Możesz ich używać do dostosowywania i rozszerzania 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 usług, takich jak prognozy pogody. Skrypt to program napisany w podzbiorze JavaScript.
W interfejsie webowym, w menu Scripts zobaczysz istniejące skrypty, a jeśli nie masz żadnych, możesz utworzyć nowy lub otworzyć bibliotekę, aby sprawdzić dostępne skrypty. Obok każdego skryptu zobaczysz jego status (czy działa, czy jest zatrzymany) oraz przełącznik umożliwiający uruchamianie skryptu przy starcie. Jeśli Twój skrypt ma błędy, ostatni zapisany błąd będzie wyświetlany pod nazwą skryptu.
W widoku edycji skryptu zobaczysz konsolę poniżej oraz 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.
Ustawienia zaawansowane
Po kliknięciu strzałki obok tego ustawienia rozwiną się ustawienia zaawansowane. Są one wyjaśnione poniżej.
KVS
KVS oznacza Key-Value Storage i jest rodzajem bazy danych nierelacyjnej, która działa przez przechowywanie danych metodą klucz-wartość. W jednym urządzeniu możesz przechować do 50 par klucz-wartość. Po kliknięciu przycisku Add value przejdziesz do ekranu tworzenia wartości, który poprosi o wprowadzenie klucza (do 42 znaków) i wartości (do 253 znaków). Pod polem tekstowym wartości zobaczysz bieżący typ wartości. Domyślnie typ wartości to Number, ale po wpisaniu tekstu typ zmieni się na String. Aby zapisać klucz, po prostu 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 dostarczy więcej informacji o działaniu KVS w urządzeniach Shelly.
Diagnostyka
Z tego ustawienia możesz pobrać logi debugowania. Włączenie logowania debug bez przyczyny nie jest zalecane, ponieważ spowolni urządzenie i przyspieszy zużycie pamięci flash. Jeśli zdecydujesz się je włączyć, możesz także pobrać poprzednie i bieżące logi. Uwaga: opuszczenie tej strony zresetuje logger i dane logów.
Ping HTTP
Wpisz URL w wyznaczonym polu tekstowym, aby wysłać żądanie HTTP z urządzenia. Interfejs webowy poinformuje Cię, czy żądanie zakończyło się powodzeniem, czy niepowodzeniem.
Klienci urządzenia
Zobacz urządzenia podłączone do Twojego urządzenia, pogrupowane w odpowiednie kategorie. Dla większości urządzeń istnieją dwie opcje:
Klienci Bluetooth - urządzenia połączone z Twoim urządzeniem przez Bluetooth.
Klienci AP - urządzenia podłączone do punktu dostępowego Twojego urządzenia.
W tym menu będziesz mógł zobaczyć informacje o klientach.