Shelly Plus Plug IT Przewodnik Po Interfejsie WWW

Shelly Plus Plug IT web interface guide

Przegląd

Urządzenia Shelly udostępniają lokalny interfejs WWW, który pozwala sterować i konfigurować urządzenia przez standardową przeglądarkę 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 WWW nie jest potrzebne połączenie z internetem ani Shelly Cloud - jedynym wymogiem jest, aby Twoja przeglądarka znajdowała się w tej samej sieci Wi‑Fi co Twoje urządzenie Shelly.

Dostęp do interfejsu WWW

Aby uzyskać dostęp do interfejsu WWW:

  1. Połącz swoje urządzenie z siecią Wi‑Fi o nazwie (SSID) w formacie: "DeviceName-XXXXXXXXXX", gdzie ‚DeviceName’ to nazwa urządzenia, które chcesz połączyć, a 'XXXXXXXXXX' oznacza unikalne połączenie liter i cyfr, stanowiące identyfikator urządzenia.

  2. Po nawiązaniu połączenia z Access Point / AP urządzenia (sieć Wi‑Fi opisana w kroku 1), dostęp do interfejsu WWW uzyskuje się przez wpisanie uniwersalnego adresu IP dla wszystkich urządzeń Shelly 192.168.33.1 w przeglądarce.

Jesteś teraz w interfejsie WWW swojego urządzenia.

Łączenie urządzenia z siecią Wi‑Fi

Niektóre ustawienia widoczne w interfejsie WWW są dostępne tylko wtedy, gdy urządzenie jest połączone z internetem. Aby to zrobić, wykonaj następujące kroki:

  1. W interfejsie WWW przejdź do Settings>Wi-Fi.

  2. Wpisz lub wybierz preferowaną sieć Wi‑Fi, a następnie wpisz jej hasło. Alternatywnie możesz połączyć się z otwartą siecią, zaznaczając pole wyboru zezwalające na łączenie z otwartymi sieciami Wi‑Fi. Dodatkowo zaleca się ustawienie statycznego adresu IP.

  3. Poczekaj kilka sekund, aby urządzenie mogło spróbować połączyć się z podaną siecią Wi‑Fi. Jeśli wpisane hasło jest nieprawidłowe, lub sieć Wi‑Fi ma niewystarczającą siłę lub stabilność, w interfejsie WWW 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 nad ustawieniami Wi‑Fi. Skopiuj i wklej ten link do przeglądarki.

Jesteś teraz w interfejsie WWW urządzenia połączonego z internetem. Następnym razem, gdy będziesz potrzebować dostępu do interfejsu WWW, 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ż zapewnia to stały dostęp pod tym adresem.

Zrozumienie układu

Interfejs WWW 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 części - nazwy Twojego urządzenia po lewej oraz kilku ikon po prawej, które pokazują główne cechy sieciowe i łączności urządzenia. Ikony mogą obejmować funkcje takie jak Wi‑Fi, Bluetooth, MQTT i inne, oraz ikonę pokazującą dostępność nowych aktualizacji firmware. Najedzenie kursorem myszki na ikonę wyświetli dodatkowe informacje. Legenda z opisem każdej ikony znajduje się w przewodniku interfejsu WWW dla każdego urządzenia. Pamiętaj, że poszczególne przewodniki opisują tylko funkcje łączności dostępne dla danego urządzenia.

Na dole ekranu od lewej do prawej znajdują się: nazwa modelu urządzenia, jego ID, wersja interfejsu WWW, 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 WWW nie zawierają wszystkich tych elementów.

Główne menu

W wersji desktopowej główne menu znajduje się po lewej stronie, natomiast na urządzeniach mobilnych wygląda jak menu typu hamburger z ikoną trzech poziomych linii ułożonych jedna nad drugą. Menu zawiera różne pozycje, w zależności od urządzenia, a kliknięcie pozycji przenosi na inną stronę. Możesz też powrócić do strony głównej, klikając Home.

Główna zawartość

Klikając element z głównego menu, możesz poruszać się po interfejsie WWW. 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 WWW wyświetlane u góry każdej strony przewodnika (tam, gdzie jest zrzut ekranu) przedstawiają najnowszą wersję. Mogą więc wyglądać nieco inaczej niż najnowsza wersja i niekoniecznie odzwierciedlają wygląd interfejsu każdego urządzenia.

Główne Menu

Poniżej znajdują się wyjaśnienia każdej pozycji w głównym menu, w tym tego, co jest wizualizowane jako główna zawartość po kliknięciu różnych ustawień. Krótkie wprowadzenie ikon w nagłówku, specyficznych dla tego urządzenia, jest również przedstawione w opisie strony Home. Pamiętaj, że nagłówek jest obecny na wszystkich ekranach, nie tylko na stronie głównej.

Strona główna

W interfejsie WWW zobaczysz pięć ikon w nagłówku, w tym ikonę AP, Wi‑Fi, Bluetooth, Cloud i MQTT. Oto co oznaczają różne kolory statusu:

  • AP ikona :

    • Szary: tryb AP jest wyłączony.

    • Niebieski: tryb AP jest włączony.

  • Wi‑Fi ikona :

    • Szary: połączenie Wi‑Fi jest wyłączone.

    • Biały: połączenie Wi‑Fi jest włączone, ale nie nawiązane.

    • Niebieski: urządzenie jest połączone z Wi‑Fi.

  • Bluetooth ikona :

    • Szary: połączenie jest wyłączone.

    • Niebieski: połączenie jest włączone.

  • Cloud ikona :

    • Szary: połączenie z Shelly Cloud jest wyłączone.

    • Biały: połączenie z Shelly Cloud jest włączone, ale nie nawiązane.

    • Niebieski: urządzenie jest połączone z Shelly Cloud.

  • MQTT ikona :

    • Szary: MQTT jest wyłączone.

    • Niebieski: MQTT jest włączone.

package.png
  • Aktualizacja firmware ikona:

    • Niebieski: dostępna jest nowa stabilna wersja firmware dla Twojego urządzenia.

    • Nie pojawia się: Firmware urządzenia jest aktualny.

websocket.svg

  • Połączenie Websocket ikona:

    • Niebieski: Websocket połączony.

    • Szary: Websocket nie jest połączony.

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ę wyzwalaną przy włączeniu zasilania urządzenia, a w drugiej zobaczysz aktualne stany ochronne i ich wartości. Klikając jedną z nich możesz łatwo zmienić je bezpośrednio z tego menu lub z odpowiednich ustawień, opisanych poniżej razem z pozostałymi ustawieniami.

Ustawienia wyjścia

Nazwa

Nadaj nazwę/przemianuj wyjście.

Akcja przy włączeniu zasilania

Ustaw akcję, którą urządzenie wykona przy włączeniu zasilania. Możesz wyłączyć to ustawienie lub wybrać Restore last aby przywrócić ostatnią wykonaną akcję urządzenia. Dodatkowo możesz wybrać Match Input, która steruje urządzeniem zgodnie ze stanem włącznika lub przycisku podłączonego do niego.

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.

Ochrony

  • Przekroczenie mocy 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 wzrośnie powyżej określonej wartości, 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 urządzenia - twórz nowe akcje, edytuj istniejące lub usuwaj je. Podczas tworzenia akcji musisz określić warunek, po spełnieniu którego 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

Funkcja ta wymaga działającego połączenia z Internetem, aby urządzenie mogło zsynchronizować czas. Pozwala tworzyć, przeglądać, edytować i usuwać harmonogramy.

Istnieją dwa typy harmonogramów: Basic i Advanced.

Aby utworzyć basic harmonogram:

  • Wybierz dzień/dni tygodnia.

  • Wybierz typ przedziału czasowego: czas, wschód słońca lub zachód słońca.

  • Ustaw czas dla określonych dni:

    • Czas: Kliknij przycisk góra/dół lub wpisz liczbę, aby ustawić godzinę i minuty.

    • Zachód/Wschód słońca: Urządzenie Shelly może włączać/wyłączać się (lub wykonywać 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ć godziny i minuty.

Aby utworzyć advanced harmonogram:

Funkcja zaawansowanego harmonogramu używa cron do wykonywania zadań w ramach pojedynczego harmonogramu, zamiast używania kilku podstawowych harmonogramów.

Tworzenie zaawansowanego harmonogramu różni się od tworzenia podstawowego harmonogramu ze względu na menu When to execute.

Zachęca ono do wybrania jednej lub wielu wartości, zakresu wartości lub kroku między wartościami (Wybierz jedną z trzech opcji klikając Select, Range lub Step dla każdej wartości) dla:

  • Sekundy (0-59)

  • Minuty (0-59)

  • Godziny (0-23)

  • Dni (1-31)

  • Miesiące (JAN-DEC)

  • Dni tygodnia (SUN-SAT)

Aby utworzyć harmonogram wykonujący się co sekundę/minutę/godzinę/dzień/miesiąc/dzień tygodnia, wystarczy zaznaczyć pole poniżej wartości w odpowiedniej sekcji (sekundy, minuty, godziny, dni, miesiące lub dni tygodnia). 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 oraz wybranie wschodu lub zachodu spowoduje, że harmonogram wykona się dokładnie o wschodzie lub zachodzie słońca. Zmiana wartości godzin i minut utworzy przesunięcie, więc wpisanie wartości ujemnych spowoduje wykonanie harmonogramu dokładnie [ustawione godziny i/lub minuty] przed wschodem/zachodem słońca, natomiast wpisanie wartości dodatnich spowoduje wykonanie [ustawione godziny i/lub minuty] po wschodzie/zachodzie słońca. Nie można wpisać wartości dodatniej dla jednego (godzin/minut) i ujemnej dla drugiego.

Następnie po prostu określ akcję, którą chcesz, aby urządzenie wykonało w sekcji Do what . Kliknij Save po zakończeniu, aby zapisać nowy harmonogram.

W menu Harmonogramy możesz przeglądać wszystkie harmonogramy. Możesz wybrać widok podstawowy lub zaawansowany czasu dla każdego z nich. Widok podstawowy pokazuje godzinę i dni, w których harmonogram występuje, natomiast widok zaawansowany wyświetla tekst na karcie harmonogramu informujący o konieczności kliknięcia w celu uzyskania dodatkowych informacji.

W obu widokach akcje wyświetlane są u góry. Jeśli jest więcej niż trzy akcje, są one wyświetlane jako +n, gdzie n to liczba pozostałych akcji niepokazanych bezpośrednio. Aby włączyć/wyłączyć harmonogram, użyj przycisku przełącznika po prawej.

Timery

Pozwalają automatycznie zarządzać zasilaniem. Możesz używać:

  • Auto on: Po wyłączeniu, wyjście przekaźnikowe zostanie automatycznie włączone po zdefiniowanym czasie (w sekundach).

  • Auto off: Po włączeniu, wyjście przekaźnikowe zostanie automatycznie wyłączone po zdefiniowanym czasie (w sekundach).

Ustawienia

Ustawienia sieci

  • Access Point - Skonfiguruj AP urządzenia, w tym włączanie/wyłączanie (za pomocą przełącznika) oraz ustawienie hasła. Punkt dostępu urządzenia domyślnie jest siecią otwartą. SSID jest unikalne i nie może być zmienione.

  • Wi‑Fi - Zarejestruj urządzenie Shelly do połączenia z maksymalnie 2 różnymi sieciami Wi‑Fi.

    Albo wpisz (poprzez pole tekstowe), albo wybierz sieć Wi‑Fi klikając ikonę chevron (strzałkę), aby przeglądać dostępne sieci. Można wybrać sieć otwartą oraz ustawić statyczny adres IP.

    Włącz Wi‑Fi 1, lub Wi‑Fi 2, lub oba jednocześnie (używając przełącznika obok każdej opcji). 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 pojawienie się okienka z pytaniem, czy chcesz kontynuować.

  • Bluetooth - Wyłącz/włącz Bluetooth, przełączając przełącznik. 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 na czas i utraciło połączenie. Po przywróceniu połączenia żądanie zostanie wysłane ponownie.

  • Cloud - Połączenie Twojego Shelly z chmurą pozwala na zdalne sterowanie oraz otrzymywanie powiadomień i aktualizacji o Twoich urządzeniach. Domyślnie ta opcja jest włączona. Jeśli wyłączysz obsługę chmury dla urządzenia, 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łączając przycisk. Zmiana tych ustawień spowoduje restart urządzenia. Istnieją też inne ustawienia, takie jak RPC status notifications over MQTT (które umożliwia komunikację z urządzeniem przez powiadomienia RPC) oraz Generic status update over MQTT (aby uzyskać ogólną aktualizację statusu), które można włączyć/wyłączyć, przesuwając odpowiednie przełączniki po prawej. Możesz także włączyć SSL i wpisać swój serwer, 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 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 i z rozwijanego menu pod SSL Connectivity wybierz *, ca.pem lub user_ca.pem.

  • Wzmacniacz zasięgu - 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 wzmacniaczem zasięgu jest połączone z routerem Wi‑Fi i Internetem, wszystkie urządzenia podłączone do niego są również 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 podłączonych - ile ich jest, a także 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.

  • Restart - Po kliknięciu przycisku Reboot zostaniesz zapytany, czy na pewno chcesz zrestartować urządzenie. Kliknij OK aby zrestartować urządzenie oraz Cancel aby anulować restart.

  • Przywracanie ustawień fabrycznych - Klikając przycisk Reset wszystkie ustawienia urządzenia zostaną przywrócone do wartości domyślnych. Wszelkie dokonane zmiany zostaną cofnięte. Możesz potwierdzić chęć przywrócenia ustawień fabrycznych, klikając OK w wyskakującym okienku lub Cancel aby anulować.

  • Lokalizacja i strefa czasowa - Twoja strefa czasowa i lokalizacja będą wykrywane automatycznie, ale możesz zmienić je ręcznie w tym ustawieniu, wybierając strefę czasową z rozwijanego menu i wpisując szerokość oraz długość geograficzną. Jest też przycisk Auto detect location, który spowoduje ponowne automatyczne wykrycie lokalizacji przez urządzenie, 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, jeśli czas nie jest zsynchronizowany.

  • Uwierzytelnianie - Jeśli włączysz uwierzytelnianie, zostaniesz poproszony o wpisanie hasła, którego następnie użyjesz do dostępu do interfejsu WWW urządzenia. Po włączeniu, aby je wyłączyć, kliknij przełącznik i wpisz swoje 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. Istnieje również opcja wgrania własnego firmware, jednak wgrywanie niestandardowego firmware nieodwracalnie unieważnia gwarancję urządzenia.

  • Certyfikat użytkownika (Konfiguracja TLS) - Prześlij niestandardowy urząd certyfikujący, certyfikat klienta i klucz klienta, przeciągając i upuszczając pliki lub przeglądając pliki klikając odpowiedni przycisk. Kliknij Upload aby przesłać pliki oraz Clear aby usunąć pliki, których nie chcesz wysyłać.

  • Tryb Eco - Zmniejsz zużycie energii przez urządzenie poprzez obniżenie częstotliwości CPU i aktywności modemu podczas Trybu 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 debugowanie Mqtt, Websocket i Udp. Aby włączyć dowolne z nich, kliknij przełącznik obok konkretnego ustawienia. Dla debugowania Udp zostaniesz również poproszony o wpisanie Udp address.

Skrypty

To urządzenie posiada możliwości skryptowe. Możesz ich użyć do dostosowania i rozszerzenia funkcjonalności urządzenia według indywidualnych potrzeb 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 WWW, po przejściu do menu Scripts zobaczysz istniejące skrypty, a jeśli ich nie masz, możesz utworzyć nowy lub otworzyć bibliotekę, aby sprawdzić dostępne zasoby. Obok każdego skryptu zobaczysz jego status (czy działa, czy jest zatrzymany) oraz przełącznik pozwalający uruchomić skrypt przy starcie. Jeśli skrypt zawiera błędy, ostatni zapisany błąd będzie wyświetlany pod nazwą skryptu.

W trybie edycji skryptu zobaczysz konsolę poniżej oraz ewentualne pojawiające się błędy. Nad polem z kodem znajdują się opcje Save, Start/Stop lub Delete skryptu. Możesz też uzyskać dostęp do Snippets i Docs klikając odpowiednie etykiety.

Zaawansowane ustawienia

Po kliknięciu strzałki obok tego ustawienia rozwiną się zaawansowane ustawienia. Zostaną one opisane 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 Cię o wprowadzenie klucza (do 42 znaków) i wartości (do 253 znaków). Pod polem tekstowym dla wartości zobaczysz aktualny typ wartości. Domyślnie typ wartości to Number, ale wpisanie tekstu spowoduje zmianę typu 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 dostarczy więcej informacji o działaniu KVS w urządzeniach Shelly.

Diagnostyka

Z tego ustawienia możesz pobrać logi debugowania. Włączanie logów debug bez powodu nie jest zalecane, ponieważ spowolni urządzenie i przyczyni się do zużycia pamięci flash. Jeśli zdecydujesz się je włączyć, możesz również pobrać poprzednie i bieżące logi. Pamiętaj, że opuszczenie tej strony spowoduje zresetowanie loggera i danych logów.

HTTP ping

Wpisz URL w przeznaczonym polu tekstowym, aby wysłać żądanie HTTP z urządzenia. Interfejs WWW poinformuje Cię, czy żądanie zakończyło się sukcesem, czy niepowodzeniem.

Klienci urządzenia

Wyświetl urządzenia podłączone do Twojego urządzenia i pogrupowane w odpowiednie kategorie. Dla większości urządzeń dostępne są dwie opcje:

  • Klienci Bluetooth - urządzenia podłączone do Twojego urządzenia 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.