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. Za jego pomocą możesz włączać i wyłączać urządzenia podłączone do twojego urządzenia, ustawiać harmonogramy oraz konfigurować akcje wykonywane po spełnieniu określonych warunków.
Zauważ, że do korzystania z lokalnego interfejsu webowego nie jest wymagane połączenie z internetem ani Shelly Cloud — jedynym wymogiem jest, by twoja przeglądarka była 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 połączyć, a 'XXXXXXXXXX' to unikalna kombinacja liter i cyfr stanowiąca identyfikator urządzenia.
Po nawiązaniu połączenia z Access Point / AP urządzenia (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.
Teraz znajdujesz się 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 podaj jej hasło. Alternatywnie możesz połączyć się z siecią otwartą, zaznaczając pole wyboru zezwalające na łączenie z otwartymi sieciami Wi‑Fi. Zalecane jest także 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 jest zbyt słaba lub niestabilna, w interfejsie webowym pojawi się komunikat informujący, że połączenie nie mogło zostać nawiązane. Po pomyślnym połączeniu z Wi‑Fi pojawi się link zawierający nowy adres IP jako tekst nad ustawieniami Wi‑Fi. Skopiuj i wklej ten link w przeglądarce.
Teraz znajdujesz się w interfejsie webowym urządzenia podłączonego do internetu. Następnym razem, gdy będziesz potrzebować dostępu 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ż 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ępnych aktualizacjach firmware. Najedź kursorem na ikonę, aby uzyskać dodatkowe informacje. Legendę z objaśnieniem każdej ikony znajdziesz w przewodniku po interfejsie webowym danego urządzenia. Uwaga: 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 na górze ekranu, a niektóre harmonogramy i akcje mogą nie działać poprawnie. Niektóre wcześniejsze wersje interfejsu webowego nie zawierają wszystkich tych elementów.
Główne menu
Wersja na komputerze ma główne menu po lewej stronie, natomiast na urządzeniu mobilnym wygląda ono 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 Cię na inną stronę. Możesz także wrócić do strony głównej, klikając Home.
Główna zawartość
Klikając element w głównym menu, możesz nawigować po interfejsie webowym. Wszystko, co widzisz na ekranie z wyłączeniem nagłówka, stopki i głównego menu, jest traktowane jako główna zawartość.
*Uwaga: nie wszystkie zrzuty ekranu interfejsu webowego wyświetlane na górze każdej strony przewodnika (tam, gdzie znajduje się zrzut ekranu) przedstawiają najnowszą wersję. Mogą wyglądać nieco inaczej niż najnowsza wersja i nie odzwierciedlać wyglądu interfejsu wszystkich urządzeń.
Główne Menu
Poniżej znajdują się wyjaśnienia poszczególnych ustawień w głównym menu, w tym to, co jest wyświetlane jako główna zawartość po kliknięciu różnych ustawień. Krótkie wprowadzenie do ikon w nagłówku, specyficznych dla tego urządzenia, znajduje się również w opisie strony Home. Nagłówek jest widoczny na wszystkich ekranach, nie tylko na stronie głównej.
Strona główna
W interfejsie webowym zobaczysz pięć ikon w nagłówku, w tym ikony dla AP, Wi‑Fi, Bluetooth, Cloud i MQTT. Oto co oznaczają różne kolory statusu:
 |
|
 |
|
 |
|
 |
|
 |
|
 |
|
|
|
|
Zobaczysz cztery wejścia i ich stan (ON lub OFF). Klikając jedno z nich, możesz łatwo uzyskać dostęp do dodatkowych ustawień związanych z każdym z wejść.
Ustawienia - ustawienia wejścia
Nazwa
Nadaj nazwę/przemianuj wejście.
Tryb wejścia
Wybierz jedną z następujących opcji:
Przycisk - każde naciśnięcie przycisku przełącza stan wyjścia urządzenia.
Przełącznik - pozycja przełącznika odpowiada stanowi wyjścia urządzenia.
To ustawienie może być w niektórych urządzeniach oznaczone jako „Switch mode”.
Invert
To ustawienie pozwala odwrócić logikę sygnału wejściowego, skutecznie zmieniając zachowanie urządzenia na przeciwnie. 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", nastąpi odwrotność. 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 w sytuacjach, gdy zachowanie urządzenia musi zostać odwrócone.
Przywracanie ustawień fabrycznych z wejścia
Umożliwienie przywrócenia ustawień fabrycznych poprzez wejście.
Akcje
Skonfiguruj akcje dla urządzenia — twórz nowe akcje, edytuj istniejące lub usuwaj akcje. Tworząc akcje, musisz określić warunek, przy którym akcja ma się wykonać. Możesz też ustawić czas trwania akcji oraz URL, który zostanie wywołany po spełnieniu warunku akcji.
Add-on
Po włączeniu i dodaniu dodatku oraz jego czujników zobaczysz wszystkie informacje w tym ustawieniu. Aby dokładnie dowiedzieć się, jak skonfigurować go przez interfejs webowy i jak poruszać się po jego ustawieniach, przeczytaj Shelly Plus Add-on web interface guide.
Ustawienia
Ustawienia sieciowe
Access Point - Skonfiguruj AP urządzenia, w tym włączanie/wyłączanie (przełącznikiem) oraz ustawienie hasła. Punkt dostępu urządzenia jest domyślnie siecią otwartą. SSID jest unikalne i nie może być zmienione.
-
Wi‑Fi - Zarejestruj urządzenie Shelly, aby połączyć 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ć dostępne sieci. Możesz wybrać sieć otwartą i także ustawić statyczny adres IP.
Włącz Wi‑Fi 1, Wi‑Fi 2 lub oba jednocześnie (przełącznikiem obok każdej z opcji). Jeśli Wi‑Fi 1 i Wi‑Fi 2 są włączone, a urządzenie Shelly rozłączy się z jednej z 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 pojawienie się okna z pytaniem, czy chcesz kontynuować.
Bluetooth - Wyłącz/włącz Bluetooth za pomocą przełącznika. 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 on, że urządzenie nie odpowiada w czasie i straciło połączenie. Po przywróceniu połączenia żądanie zostanie wysłane ponownie.
Cloud - Połączenie Shelly z chmurą pozwala na zdalne sterowanie oraz otrzymywanie powiadomień i aktualizacji o urządzeniu. Domyślnie chmura jest włączona. Jeśli wyłączysz obsługę chmury, utracisz 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żesz 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żliwia komunikację z urządzeniem poprzez powiadomienia RPC) oraz Generic status update over MQTT (by otrzymywać ogólny status), które można włączać/wyłączać przełącznikami po prawej. Możesz też włączyć SSL oraz wpisać serwer, nazwę użytkownika i hasło, ale włączenie SSL pogorszy żywotność baterii i najprawdopodobniej skróci ją 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 ustawienie to jest wyłączone. Aby je włączyć, kliknij przełącznik obok Enable. Wprowadź adres usługi w polu tekstowym i 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 repeaterem jest połączone z routerem Wi‑Fi i internetem, wszystkie urządzenia do niego podłączone również mają połączenie 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 nadal mogą się z nim komunikować i ze sobą nawzajem. 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.
Reboot - Po kliknięciu przycisku Reboot zostaniesz zapytany, czy na pewno chcesz zrestartować urządzenie. Kliknij OK aby zrestartować urządzenie lub Cancel jeśli nie chcesz restartu.
Przywracanie ustawień fabrycznych - Kliknięcie przycisku Reset spowoduje przywrócenie ustawień urządzenia do domyślnych. Wszystkie wprowadzone zmiany zostaną cofnięte. Potwierdź przywrócenie do ustawień fabrycznych, klikając OK w oknie, lub Cancel aby anulować reset.
Lokalizacja i strefa czasowa - Twoja strefa czasowa i lokalizacja będą wykrywane automatycznie, ale możesz zmienić je ręcznie wybierając strefę czasową z rozwijanego menu i wpisując szerokość oraz długość geograficzną. Jest też przycisk Auto detect location, który ponownie wymusi automatyczne wykrycie lokalizacji, jeśli poprzednie wykrycie nie powiodło się.
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 o braku synchronizacji czasu.
Uwierzytelnianie - Jeśli włączysz uwierzytelnianie, zostaniesz poproszony o wpisanie hasła, które później będzie wymagane do dostępu do interfejsu webowego urządzenia. Po włączeniu, aby je wyłączyć, kliknij przełącznik i wpisz swoje 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 identyfikatorem 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. Istnieje również opcja wgrania własnego firmware, jednak wgrywanie niestandardowego firmware trwałe unieważnia gwarancję urządzenia.
Certyfikat użytkownika (Konfiguracja TLS) - Prześlij własne CA, certyfikat klienta i klucz klienta, przeciągając i upuszczając plik(i), lub przeglądając pliki za pomocą dedykowanego przycisku. Kliknij Upload aby wgrać pliki i Clear aby usunąć pliki, których 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ć tę opcję, 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ć dowolny z tych trybów, kliknij przełącznik obok konkretnego ustawienia. Dla Udp debug zostaniesz także poproszony o wpisanie Udp address.
Jednostki - Wybierz jednostki, w których będą wyświetlane zmierzone dane.
Skrypty
To urządzenie posiada funkcje skryptowe. Możesz ich użyć do dostosowania i rozszerzenia funkcjonalności urządzenia zgodnie z potrzebami użytkownika. Skrypty mogą brać pod uwagę 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, wchodząc do menu Scripts zobaczysz istniejące skrypty lub, jeśli nie masz żadnych, możesz utworzyć nowy albo otworzyć bibliotekę, by przeglądać dostępne skrypty. Obok każdego skryptu zobaczysz jego status (czy jest uruchomiony, czy zatrzymany) oraz przełącznik pozwalający uruchomić skrypt przy starcie. Jeśli skrypt ma błędy, ostatni zapisany błąd będzie widoczny 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 lub 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 zobaczysz ustawienia zaawansowane. Zostały one opisane poniżej.
KVS
KVS oznacza Key-Value Storage i jest rodzajem bazy danych nierelacyjnej, która działa poprzez prostą metodę klucz-wartość do przechowywania danych. Na 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 musisz wprowadzić klucz (do 42 znaków) i wartość (do 253 znaków). Pod polem tekstowym dla wartości zobaczysz aktualny 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ę pod nią po wejściu w edycję klucza. Kliknięcie znaku zapytania obok nazwy ustawienia przeniesie Cię do dokumentacji API, która dostarczy dalszych informacji o tym, jak KVS działa w urządzeniach Shelly.
Diagnostyka
Z tego ustawienia możesz pobrać logi debugowania. Włączanie logowania debug bez powodu nie jest zalecane, ponieważ spowolni urządzenie i spowoduje 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.
HTTP ping
Wprowadź URL w przeznaczonym polu tekstowym, aby wysłać żądanie HTTP z urządzenia. Interfejs webowy poinformuje, czy żądanie zakończyło się sukcesem, czy niepowodzeniem.
Klienci urządzenia
Zobacz urządzenia podłączone do twojego urządzenia, pogrupowane w odpowiednie kategorie. Dla większości urządzeń są dwie opcje:
Klienci Bluetooth - urządzenia podłączone do twojego urządzenia przez Bluetooth.
Klienci AP - urządzenia podłączone do punktu dostępu (Access Point) twojego urządzenia.
W tym menu zobaczysz informacje o klientach.